Re: DBD::Sybase and Sybase::CTlib build problems w/ 5.8.1, Solaris, gcc
[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_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
2268 PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
2269 (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, j, x
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_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 =over 4
13009
13010 =item BUGS
13011
13012 =item SEE ALSO 
13013
13014 =item AUTHOR
13015
13016 =back
13017
13018 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13019
13020 =over 4
13021
13022 =item SYNOPSIS
13023
13024 =item DESCRIPTION
13025
13026 B<test_harness>
13027
13028 =back
13029
13030 B<pod2man>
13031
13032 B<warn_if_old_packlist>
13033
13034 B<perllocal_install>
13035
13036 B<uninstall>
13037
13038 =head2 ExtUtils::Constant - generate XS code to import C header constants
13039
13040 =over 4
13041
13042 =item SYNOPSIS
13043
13044 =item DESCRIPTION
13045
13046 =item USAGE
13047
13048 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13049
13050 =item FUNCTIONS
13051
13052 =back
13053
13054 C_stringify NAME
13055
13056 perl_stringify NAME
13057
13058 constant_types
13059
13060 memEQ_clause NAME, CHECKED_AT, INDENT
13061
13062 assign INDENT, TYPE, PRE, POST, VALUE..
13063
13064 return_clause
13065
13066 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
13067
13068 params WHAT
13069
13070 dump_names
13071
13072 dogfood
13073
13074 C_constant, name, type, value, macro, default, pre, post, def_pre =item
13075 def_post, utf8
13076
13077 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13078
13079 autoload PACKAGE, VERSION, AUTOLOADER
13080
13081 WriteMakefileSnippet
13082
13083 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13084 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13085
13086 =over 4
13087
13088 =item AUTHOR
13089
13090 =back
13091
13092 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13093
13094 =over 4
13095
13096 =item SYNOPSIS
13097
13098 =item DESCRIPTION
13099
13100 =item @EXPORT
13101
13102 =item FUNCTIONS
13103
13104 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13105 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13106
13107 =item EXAMPLES
13108
13109 =item SEE ALSO
13110
13111 =item AUTHOR
13112
13113 =back
13114
13115 =head2 ExtUtils::Install - install files from here to there
13116
13117 =over 4
13118
13119 =item SYNOPSIS
13120
13121 =item DESCRIPTION
13122
13123 =over 4
13124
13125 =item Functions
13126
13127 B<install>
13128
13129 =back
13130
13131 =back
13132
13133 B<install_default> I<DISCOURAGED>
13134
13135 B<uninstall>
13136
13137 B<pm_to_blib>
13138
13139 _autosplit
13140
13141 =over 4
13142
13143 =item ENVIRONMENT
13144
13145 B<PERL_INSTALL_ROOT>
13146
13147 =item AUTHOR
13148
13149 =item LICENSE
13150
13151 =back
13152
13153 =head2 ExtUtils::Installed - Inventory management of installed modules
13154
13155 =over 4
13156
13157 =item SYNOPSIS
13158
13159 =item DESCRIPTION
13160
13161 =item USAGE
13162
13163 =item FUNCTIONS
13164
13165 new(), modules(), files(), directories(), directory_tree(), validate(),
13166 packlist(), version()
13167
13168 =item EXAMPLE
13169
13170 =item AUTHOR
13171
13172 =back
13173
13174 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13175
13176 =over 4
13177
13178 =item SYNOPSIS
13179
13180 =item DESCRIPTION
13181
13182 For static extensions, For dynamic extensions at build/link time, For
13183 dynamic extensions at load time
13184
13185 =over 4
13186
13187 =item EXTRALIBS
13188
13189 =item LDLOADLIBS and LD_RUN_PATH
13190
13191 =item BSLOADLIBS
13192
13193 =back
13194
13195 =item PORTABILITY
13196
13197 =over 4
13198
13199 =item VMS implementation
13200
13201 =item Win32 implementation
13202
13203 =back
13204
13205 =item SEE ALSO
13206
13207 =back
13208
13209 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13210
13211 =over 4
13212
13213 =item SYNOPSIS
13214
13215 =item DESCRIPTION
13216
13217 =back
13218
13219 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13220
13221 =over 4
13222
13223 =item SYNOPSIS
13224
13225 =item DESCRIPTION
13226
13227 =item Inherently Cross-Platform Methods
13228
13229 installvars
13230
13231 =back
13232
13233 os_flavor_is
13234
13235 =over 4
13236
13237 =item File::Spec wrappers
13238
13239 catfile
13240
13241 =back
13242
13243 =over 4
13244
13245 =item Thought To Be Cross-Platform Methods
13246
13247 B<split_command>
13248
13249 =back
13250
13251 B<echo>
13252
13253 init_VERSION
13254
13255 wraplist
13256
13257 manifypods
13258
13259 manifypods_target
13260
13261 makemakerdflt_target
13262
13263 special_targets
13264
13265 POD2MAN_macro
13266
13267 test_via_harness
13268
13269 test_via_script
13270
13271 libscan
13272
13273 tool_autosplit
13274
13275 all_target
13276
13277 metafile_target
13278
13279 signature_target
13280
13281 metafile_addtomanifest_target
13282
13283 signature_addtomanifest_target
13284
13285 =over 4
13286
13287 =item Abstract methods
13288
13289 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13290 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13291 platform_constants
13292
13293 =back
13294
13295 os_flavor
13296
13297 =over 4
13298
13299 =item AUTHOR
13300
13301 =back
13302
13303 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13304 ExtUtils::MakeMaker
13305
13306 =over 4
13307
13308 =item SYNOPSIS
13309
13310 =item DESCRIPTION
13311
13312 =back
13313
13314 os_flavor (o)
13315
13316 init_linker
13317
13318 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13319 ExtUtils::MakeMaker
13320
13321 =over 4
13322
13323 =item SYNOPSIS
13324
13325 =item DESCRIPTION
13326
13327 os_flavor (o)
13328
13329 =back
13330
13331 cflags (o)
13332
13333 replace_manpage_separator (o)
13334
13335 init_linker
13336
13337 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13338
13339 =over 4
13340
13341 =item SYNOPSIS
13342
13343 =item DESCRIPTION
13344
13345 =over 4
13346
13347 =item Overridden methods
13348
13349 os_flavor
13350
13351 =back
13352
13353 =back
13354
13355 B<replace_manpage_separator>
13356
13357 =over 4
13358
13359 =item AUTHOR
13360
13361 =item SEE ALSO
13362
13363 =back
13364
13365 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13366 ExtUtils::MakeMaker
13367
13368 =over 4
13369
13370 =item SYNOPSIS
13371
13372 =item DESCRIPTION
13373
13374 =back
13375
13376 maybe_command
13377
13378 guess_name
13379
13380 macify
13381
13382 patternify
13383
13384 init_main
13385
13386 init_others
13387
13388 init_platform, platform_constants
13389
13390 init_dirscan
13391
13392 init_VERSION (o)
13393
13394 special_targets (o)
13395
13396 static (o)
13397
13398 dlsyms (o)
13399
13400 dynamic (o)
13401
13402 clean (o)
13403
13404 clean_subdirs_target
13405
13406 realclean (o)
13407
13408 realclean_subdirs_target
13409
13410 rulez (o)
13411
13412 processPL (o)
13413
13414 os_flavor
13415
13416 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13417 ExtUtils::MakeMaker
13418
13419 =over 4
13420
13421 =item SYNOPSIS
13422
13423 =item DESCRIPTION
13424
13425 =back
13426
13427 os_flavor
13428
13429 init_platform (o), platform_constants
13430
13431 const_cccmd (o)
13432
13433 static_lib (o)
13434
13435 dynamic_lib (o)
13436
13437 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13438 ExtUtils::MakeMaker
13439
13440 =over 4
13441
13442 =item SYNOPSIS
13443
13444 =item DESCRIPTION
13445
13446 =item METHODS
13447
13448 init_dist (o)
13449
13450 =back
13451
13452 init_linker
13453
13454 os_flavor
13455
13456 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13457
13458 =over 4
13459
13460 =item SYNOPSIS
13461
13462 =item DESCRIPTION
13463
13464 =over 4
13465
13466 =item Overridden methods
13467
13468 os_flavor
13469
13470 =back
13471
13472 =back
13473
13474 B<replace_manpage_separator>
13475
13476 =over 4
13477
13478 =item AUTHOR
13479
13480 =item SEE ALSO
13481
13482 =back
13483
13484 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13485
13486 =over 4
13487
13488 =item SYNOPSIS
13489
13490 =item DESCRIPTION
13491
13492 =item METHODS
13493
13494 =back
13495
13496 =over 4
13497
13498 =item Methods
13499
13500 os_flavor (o)
13501
13502 =back
13503
13504 c_o (o)
13505
13506 cflags (o)
13507
13508 clean (o)
13509
13510 clean_subdirs_target
13511
13512 const_cccmd (o)
13513
13514 const_config (o)
13515
13516 const_loadlibs (o)
13517
13518 constants (o)
13519
13520 depend (o)
13521
13522 dir_target (o)
13523
13524 init_DEST
13525
13526 init_dist
13527
13528 dist (o)
13529
13530 dist_basics (o)
13531
13532 dist_ci (o)
13533
13534 dist_core (o)
13535
13536 B<dist_target>
13537
13538 B<tardist_target>
13539
13540 B<zipdist_target>
13541
13542 B<tarfile_target>
13543
13544 zipfile_target
13545
13546 uutardist_target
13547
13548 shdist_target
13549
13550 distdir
13551
13552 dist_test
13553
13554 dlsyms (o)
13555
13556 dynamic (o)
13557
13558 dynamic_bs (o)
13559
13560 dynamic_lib (o)
13561
13562 exescan
13563
13564 extliblist
13565
13566 find_perl
13567
13568 find_tests
13569
13570 =over 4
13571
13572 =item Methods to actually produce chunks of text for the Makefile
13573
13574 fixin
13575
13576 =back
13577
13578 force (o)
13579
13580 guess_name
13581
13582 has_link_code
13583
13584 init_dirscan
13585
13586 init_DIRFILESEP
13587
13588 init_main
13589
13590 init_others
13591
13592 init_INST
13593
13594 init_INSTALL
13595
13596 init_linker
13597
13598 init_lib2arch
13599
13600 init_PERL
13601
13602 init_platform (o), platform_constants (o)
13603
13604 init_PERM
13605
13606 init_xs
13607
13608 install (o)
13609
13610 installbin (o)
13611
13612 linkext (o)
13613
13614 lsdir
13615
13616 macro (o)
13617
13618 makeaperl (o)
13619
13620 makefile (o)
13621
13622 maybe_command
13623
13624 needs_linking (o)
13625
13626 nicetext
13627
13628 parse_abstract
13629
13630 parse_version
13631
13632 pasthru (o)
13633
13634 perl_script
13635
13636 perldepend (o)
13637
13638 perm_rw (o)
13639
13640 perm_rwx (o)
13641
13642 pm_to_blib
13643
13644 post_constants (o)
13645
13646 post_initialize (o)
13647
13648 postamble (o)
13649
13650 ppd
13651
13652 prefixify
13653
13654 processPL (o)
13655
13656 quote_paren
13657
13658 realclean (o)
13659
13660 realclean_subdirs_target
13661
13662 replace_manpage_separator
13663
13664 oneliner (o)
13665
13666 quote_literal
13667
13668 escape_newlines
13669
13670 max_exec_len
13671
13672 static (o)
13673
13674 static_lib (o)
13675
13676 staticmake (o)
13677
13678 subdir_x (o)
13679
13680 subdirs (o)
13681
13682 test (o)
13683
13684 test_via_harness (override)
13685
13686 test_via_script (override)
13687
13688 tools_other (o)
13689
13690 tool_xsubpp (o)
13691
13692 all_target
13693
13694 top_targets (o)
13695
13696 writedoc
13697
13698 xs_c (o)
13699
13700 xs_cpp (o)
13701
13702 xs_o (o)
13703
13704 =over 4
13705
13706 =item SEE ALSO
13707
13708 =back
13709
13710 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13711 ExtUtils::MakeMaker
13712
13713 =over 4
13714
13715 =item SYNOPSIS
13716
13717 =item DESCRIPTION
13718
13719 =over 4
13720
13721 =item Methods always loaded
13722
13723 wraplist
13724
13725 =back
13726
13727 =back
13728
13729 =over 4
13730
13731 =item Methods
13732
13733 guess_name (override)
13734
13735 =back
13736
13737 find_perl (override)
13738
13739 maybe_command (override)
13740
13741 perl_script (override)
13742
13743 replace_manpage_separator
13744
13745 init_DEST
13746
13747 init_DIRFILESEP
13748
13749 init_main (override)
13750
13751 init_others (override)
13752
13753 init_platform (override)
13754
13755 platform_constants
13756
13757 init_VERSION (override)
13758
13759 constants (override)
13760
13761 special_targets
13762
13763 cflags (override)
13764
13765 const_cccmd (override)
13766
13767 tool_sxubpp (override)
13768
13769 tools_other (override)
13770
13771 init_dist (override)
13772
13773 c_o (override)
13774
13775 xs_c (override)
13776
13777 xs_o (override)
13778
13779 dlsyms (override)
13780
13781 dynamic_lib (override)
13782
13783 dynamic_bs (override)
13784
13785 static_lib (override)
13786
13787 processPL (override)
13788
13789 installbin (override)
13790
13791 subdir_x (override)
13792
13793 clean (override)
13794
13795 clean_subdirs_target
13796
13797 realclean (override)
13798
13799 zipfile_target (o), tarfile_target (o), shdist_target (o)
13800
13801 dist_test (override)
13802
13803 install (override)
13804
13805 perldepend (override)
13806
13807 makefile (override)
13808
13809 find_tests (override)
13810
13811 test (override)
13812
13813 makeaperl (override)
13814
13815 nicetext (override)
13816
13817 prefixify (override)
13818
13819 oneliner (o)
13820
13821 B<echo> (o)
13822
13823 quote_literal
13824
13825 escape_newlines
13826
13827 max_exec_len
13828
13829 init_linker (o)
13830
13831 eliminate_macros
13832
13833 fixpath
13834
13835 os_flavor
13836
13837 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13838 ExtUtils::MakeMaker
13839
13840 =over 4
13841
13842 =item SYNOPSIS
13843
13844 =item DESCRIPTION
13845
13846 =back
13847
13848 =over 4
13849
13850 =item Overridden methods
13851
13852 B<dlsyms>
13853
13854 =back
13855
13856 replace_manpage_separator
13857
13858 B<maybe_command>
13859
13860 B<find_tests>
13861
13862 B<init_DIRFILESEP>
13863
13864 B<init_others>
13865
13866 init_platform (o), platform_constants (o)
13867
13868 special_targets (o)
13869
13870 static_lib (o)
13871
13872 dynamic_lib (o)
13873
13874 clean
13875
13876 init_linker
13877
13878 perl_script
13879
13880 xs_o (o)
13881
13882 pasthru (o)
13883
13884 oneliner (o)
13885
13886 max_exec_len
13887
13888 os_flavor
13889
13890 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13891
13892 =over 4
13893
13894 =item SYNOPSIS
13895
13896 =item DESCRIPTION
13897
13898 =over 4
13899
13900 =item Overriden methods
13901
13902 dist_test
13903
13904 =back
13905
13906 =back
13907
13908 subdir_x
13909
13910 xs_c
13911
13912 xs_cpp
13913
13914 xs_o
13915
13916 clean_subdirs_target
13917
13918 realclean_subdirs_target
13919
13920 os_flavor
13921
13922 =over 4
13923
13924 =item AUTHOR
13925
13926 =back
13927
13928 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13929
13930 =over 4
13931
13932 =item SYNOPSIS
13933
13934 =item DESCRIPTION
13935
13936 =back
13937
13938 =head2 ExtUtils::MakeMaker - Create a module Makefile
13939
13940 =over 4
13941
13942 =item SYNOPSIS
13943
13944 =item DESCRIPTION
13945
13946 =over 4
13947
13948 =item How To Write A Makefile.PL
13949
13950 =item Default Makefile Behaviour
13951
13952 =item make test
13953
13954 =item make testdb
13955
13956 =item make install
13957
13958 =item PREFIX and LIB attribute
13959
13960 =item AFS users
13961
13962 =item Static Linking of a new Perl Binary
13963
13964 =item Determination of Perl Library and Installation Locations
13965
13966 =item Which architecture dependent directory?
13967
13968 =item Using Attributes and Parameters
13969
13970 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13971 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13972 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13973 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13974 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13975 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13976 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13977 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13978 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13979 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13980 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13981 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
13982 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13983 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
13984 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13985 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13986 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
13987 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
13988
13989 =item Additional lowercase attributes
13990
13991 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
13992 test, tool_autosplit
13993
13994 =item Overriding MakeMaker Methods
13995
13996 =item The End Of Cargo Cult Programming
13997
13998 C<<MAN3PODS => ' '>>
13999
14000 =item Hintsfile support
14001
14002 =item Distribution Support
14003
14004    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14005   make distdir,   make disttest,    make tardist,    make dist,    make
14006 uutardist,    make shdist,    make zipdist,    make ci
14007
14008 =item Module Meta-Data
14009
14010 =item Disabling an extension
14011
14012 =item Other Handy Functions
14013
14014 prompt
14015
14016 =back
14017
14018 =item ENVIRONMENT
14019
14020 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14021
14022 =item SEE ALSO
14023
14024 =item AUTHORS
14025
14026 =item LICENSE
14027
14028 =back
14029
14030 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14031 MakeMaker
14032
14033 =over 4
14034
14035 =item DESCRIPTION
14036
14037 =over 4
14038
14039 =item Philosophy and History
14040
14041 Why not just use <insert other build config tool here>?, What's
14042 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14043 shell commands, easier to customize, cleaner internals, less cruft
14044
14045 =item Module Writing
14046
14047 How do I keep my $VERSION up to date without resetting it manually?, What's
14048 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14049
14050 =item XS
14051
14052 How to I prevent "object version X.XX does not match bootstrap parameter
14053 Y.YY" errors?, How do I make two or more XS files coexist in the same
14054 directory?
14055
14056 =back
14057
14058 =item PATCHING
14059
14060 =item AUTHOR
14061
14062 =item SEE ALSO
14063
14064 =back
14065
14066 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14067
14068 =over 4
14069
14070 =item SYNOPSIS
14071
14072 =item DESCRIPTION
14073
14074 =over 4
14075
14076 =item The Mantra
14077
14078 =item The Layout
14079
14080 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14081 bin/
14082
14083 =back
14084
14085 =item SEE ALSO
14086
14087 =back
14088
14089 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
14090
14091 =over 4
14092
14093 =item SYNOPSIS
14094
14095 =item DESCRIPTION
14096
14097 =back
14098
14099 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
14100
14101 =over 4
14102
14103 =item SYNOPSIS
14104
14105 =item DESCRIPTION
14106
14107 =back
14108
14109 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14110
14111 =over 4
14112
14113 =item SYNOPSIS
14114
14115 =item DESCRIPTION
14116
14117 =over 4
14118
14119 =item Functions
14120
14121 mkmanifest
14122
14123 =back
14124
14125 =back
14126
14127 manifind
14128
14129 manicheck
14130
14131 filecheck
14132
14133 fullcheck
14134
14135 skipcheck
14136
14137 maniread
14138
14139 manicopy
14140
14141 maniadd
14142
14143 =over 4
14144
14145 =item MANIFEST
14146
14147 =item MANIFEST.SKIP
14148
14149 =item EXPORT_OK
14150
14151 =item GLOBAL VARIABLES
14152
14153 =back
14154
14155 =over 4
14156
14157 =item DIAGNOSTICS
14158
14159 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14160 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14161
14162 =item ENVIRONMENT
14163
14164 B<PERL_MM_MANIFEST_DEBUG>
14165
14166 =item SEE ALSO
14167
14168 =item AUTHOR
14169
14170 =back
14171
14172 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14173
14174 =over 4
14175
14176 =item SYNOPSIS
14177
14178 =item DESCRIPTION
14179
14180 =item SEE ALSO
14181
14182 =back
14183
14184 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14185
14186 =over 4
14187
14188 =item SYNOPSIS
14189
14190 =item DESCRIPTION
14191
14192 =back
14193
14194 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14195 extension
14196
14197 =over 4
14198
14199 =item SYNOPSIS
14200
14201 =item DESCRIPTION
14202
14203 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14204
14205 =item AUTHOR
14206
14207 =item REVISION
14208
14209 =back
14210
14211 =head2 ExtUtils::Packlist - manage .packlist files
14212
14213 =over 4
14214
14215 =item SYNOPSIS
14216
14217 =item DESCRIPTION
14218
14219 =item USAGE
14220
14221 =item FUNCTIONS
14222
14223 new(), read(), write(), validate(), packlist_file()
14224
14225 =item EXAMPLE
14226
14227 =item AUTHOR
14228
14229 =back
14230
14231 =head2 ExtUtils::testlib - add blib/* directories to @INC
14232
14233 =over 4
14234
14235 =item SYNOPSIS
14236
14237 =item DESCRIPTION
14238
14239 =back
14240
14241 =head2 Fatal - replace functions with equivalents which succeed or die
14242
14243 =over 4
14244
14245 =item SYNOPSIS
14246
14247 =item DESCRIPTION
14248
14249 =item AUTHOR
14250
14251 =back
14252
14253 =head2 Fcntl - load the C Fcntl.h defines
14254
14255 =over 4
14256
14257 =item SYNOPSIS
14258
14259 =item DESCRIPTION
14260
14261 =item NOTE
14262
14263 =item EXPORTED SYMBOLS
14264
14265 =back
14266
14267 =head2 File::Basename, fileparse - split a pathname into pieces
14268
14269 =over 4
14270
14271 =item SYNOPSIS
14272
14273 =item DESCRIPTION
14274
14275 fileparse_set_fstype, fileparse
14276
14277 =item EXAMPLES
14278
14279 C<basename>, C<dirname>
14280
14281 =back
14282
14283 =head2 File::CheckTree, validate - run many filetest checks on a tree
14284
14285 =over 4
14286
14287 =item SYNOPSIS
14288
14289 =item DESCRIPTION
14290
14291 =item AUTHOR
14292
14293 =item HISTORY
14294
14295 =back
14296
14297 =head2 File::Compare - Compare files or filehandles
14298
14299 =over 4
14300
14301 =item SYNOPSIS
14302
14303 =item DESCRIPTION
14304
14305 =item RETURN
14306
14307 =item AUTHOR
14308
14309 =back
14310
14311 =head2 File::Copy - Copy files or filehandles
14312
14313 =over 4
14314
14315 =item SYNOPSIS
14316
14317 =item DESCRIPTION
14318
14319 =over 4
14320
14321 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14322
14323 rmscopy($from,$to[,$date_flag])
14324
14325 =back
14326
14327 =item RETURN
14328
14329 =item NOTES
14330
14331 =item AUTHOR
14332
14333 =back
14334
14335 =head2 File::DosGlob - DOS like globbing and then some
14336
14337 =over 4
14338
14339 =item SYNOPSIS
14340
14341 =item DESCRIPTION
14342
14343 =item NOTES
14344
14345 =item EXPORTS (by request only)
14346
14347 =item BUGS
14348
14349 =item AUTHOR
14350
14351 =item HISTORY
14352
14353 =item SEE ALSO
14354
14355 =back
14356
14357 =head2 File::Find - Traverse a directory tree.
14358
14359 =over 4
14360
14361 =item SYNOPSIS
14362
14363 =item DESCRIPTION
14364
14365 B<find>, B<finddepth>
14366
14367 =over 4
14368
14369 =item %options
14370
14371 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14372 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14373 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14374
14375 =item The wanted function
14376
14377 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14378 filename within that directory, C<$File::Find::name> is the complete
14379 pathname to the file
14380
14381 =back
14382
14383 =item WARNINGS
14384
14385 =item CAVEAT
14386
14387 $dont_use_nlink, symlinks
14388
14389 =item NOTES
14390
14391 =item HISTORY
14392
14393 =back
14394
14395 =head2 File::Glob - Perl extension for BSD glob routine
14396
14397 =over 4
14398
14399 =item SYNOPSIS
14400
14401 =item DESCRIPTION
14402
14403 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14404 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14405 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14406
14407 =item DIAGNOSTICS
14408
14409 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14410
14411 =item NOTES
14412
14413 =item AUTHOR
14414
14415 =back
14416
14417 =head2 File::Path - create or remove directory trees
14418
14419 =over 4
14420
14421 =item SYNOPSIS
14422
14423 =item DESCRIPTION
14424
14425 =item DIAGNOSTICS
14426
14427 =item AUTHORS
14428
14429 =back
14430
14431 =head2 File::Spec - portably perform operations on file names
14432
14433 =over 4
14434
14435 =item SYNOPSIS
14436
14437 =item DESCRIPTION
14438
14439 =item METHODS
14440
14441 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14442 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14443 splitdir, catpath(), abs2rel, rel2abs()
14444
14445 =item SEE ALSO
14446
14447 =item AUTHORS
14448
14449 =back
14450
14451 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14452
14453 =over 4
14454
14455 =item SYNOPSIS
14456
14457 =item DESCRIPTION
14458
14459 =back
14460
14461 canonpath
14462
14463 file_name_is_absolute
14464
14465 tmpdir (override)
14466
14467 =head2 File::Spec::Epoc - methods for Epoc file specs
14468
14469 =over 4
14470
14471 =item SYNOPSIS
14472
14473 =item DESCRIPTION
14474
14475 =item AUTHORS
14476
14477 =back
14478
14479 canonpath()
14480
14481 =over 4
14482
14483 =item SEE ALSO
14484
14485 =back
14486
14487 =head2 File::Spec::Functions - portably perform operations on file names
14488
14489 =over 4
14490
14491 =item SYNOPSIS
14492
14493 =item DESCRIPTION
14494
14495 =over 4
14496
14497 =item Exports
14498
14499 =back
14500
14501 =item SEE ALSO
14502
14503 =back
14504
14505 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14506
14507 =over 4
14508
14509 =item SYNOPSIS
14510
14511 =item DESCRIPTION
14512
14513 =item METHODS
14514
14515 canonpath
14516
14517 =back
14518
14519 catdir()
14520
14521 catfile
14522
14523 curdir
14524
14525 devnull
14526
14527 rootdir
14528
14529 tmpdir
14530
14531 updir
14532
14533 file_name_is_absolute
14534
14535 path
14536
14537 splitpath
14538
14539 splitdir
14540
14541 catpath
14542
14543 abs2rel
14544
14545 rel2abs
14546
14547 =over 4
14548
14549 =item AUTHORS
14550
14551 =item SEE ALSO
14552
14553 =back
14554
14555 =head2 File::Spec::OS2 - methods for OS/2 file specs
14556
14557 =over 4
14558
14559 =item SYNOPSIS
14560
14561 =item DESCRIPTION
14562
14563 tmpdir, splitpath
14564
14565 =back
14566
14567 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14568 modules
14569
14570 =over 4
14571
14572 =item SYNOPSIS
14573
14574 =item DESCRIPTION
14575
14576 =item METHODS
14577
14578 canonpath()
14579
14580 =back
14581
14582 catdir()
14583
14584 catfile
14585
14586 curdir
14587
14588 devnull
14589
14590 rootdir
14591
14592 tmpdir
14593
14594 updir
14595
14596 no_upwards
14597
14598 case_tolerant
14599
14600 file_name_is_absolute
14601
14602 path
14603
14604 join
14605
14606 splitpath
14607
14608 splitdir
14609
14610 catpath()
14611
14612 abs2rel
14613
14614 rel2abs()
14615
14616 =over 4
14617
14618 =item SEE ALSO
14619
14620 =back
14621
14622 =head2 File::Spec::VMS - methods for VMS file specs
14623
14624 =over 4
14625
14626 =item SYNOPSIS
14627
14628 =item DESCRIPTION
14629
14630 eliminate_macros
14631
14632 =back
14633
14634 fixpath
14635
14636 =over 4
14637
14638 =item Methods always loaded
14639
14640 canonpath (override)
14641
14642 =back
14643
14644 catdir
14645
14646 catfile
14647
14648 curdir (override)
14649
14650 devnull (override)
14651
14652 rootdir (override)
14653
14654 tmpdir (override)
14655
14656 updir (override)
14657
14658 case_tolerant (override)
14659
14660 path (override)
14661
14662 file_name_is_absolute (override)
14663
14664 splitpath (override)
14665
14666 splitdir (override)
14667
14668 catpath (override)
14669
14670 abs2rel (override)
14671
14672 rel2abs (override)
14673
14674 =over 4
14675
14676 =item SEE ALSO
14677
14678 =back
14679
14680 =head2 File::Spec::Win32 - methods for Win32 file specs
14681
14682 =over 4
14683
14684 =item SYNOPSIS
14685
14686 =item DESCRIPTION
14687
14688 devnull
14689
14690 =back
14691
14692 tmpdir
14693
14694 catfile
14695
14696 canonpath
14697
14698 splitpath
14699
14700 splitdir
14701
14702 catpath
14703
14704 =over 4
14705
14706 =item Note For File::Spec::Win32 Maintainers
14707
14708 =back
14709
14710 =over 4
14711
14712 =item SEE ALSO
14713
14714 =back
14715
14716 =head2 File::Temp - return name and handle of a temporary file safely
14717
14718 =over 4
14719
14720 =item PORTABILITY
14721
14722 =item SYNOPSIS
14723
14724 =item DESCRIPTION
14725
14726 =back
14727
14728 =over 4
14729
14730 =item OO INTERFACE
14731
14732 B<new>
14733
14734 =back
14735
14736 B<filename>
14737
14738 B<DESTROY>
14739
14740 =over 4
14741
14742 =item FUNCTIONS
14743
14744 B<tempfile>
14745
14746 =back
14747
14748 B<tempdir>
14749
14750 =over 4
14751
14752 =item MKTEMP FUNCTIONS
14753
14754 B<mkstemp>
14755
14756 =back
14757
14758 B<mkstemps>
14759
14760 B<mkdtemp>
14761
14762 B<mktemp>
14763
14764 =over 4
14765
14766 =item POSIX FUNCTIONS
14767
14768 B<tmpnam>
14769
14770 =back
14771
14772 B<tmpfile>
14773
14774 =over 4
14775
14776 =item ADDITIONAL FUNCTIONS
14777
14778 B<tempnam>
14779
14780 =back
14781
14782 =over 4
14783
14784 =item UTILITY FUNCTIONS
14785
14786 B<unlink0>
14787
14788 =back
14789
14790 B<cmpstat>
14791
14792 B<unlink1>
14793
14794 =over 4
14795
14796 =item PACKAGE VARIABLES
14797
14798 B<safe_level>, STANDARD, MEDIUM, HIGH
14799
14800 =back
14801
14802 TopSystemUID
14803
14804 =over 4
14805
14806 =item WARNING
14807
14808 =over 4
14809
14810 =item Temporary files and NFS
14811
14812 =back
14813
14814 =item HISTORY
14815
14816 =item SEE ALSO
14817
14818 =item AUTHOR
14819
14820 =back
14821
14822 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14823
14824 =over 4
14825
14826 =item SYNOPSIS
14827
14828 =item DESCRIPTION
14829
14830 =item BUGS
14831
14832 =item NOTE
14833
14834 =item AUTHOR
14835
14836 =back
14837
14838 =head2 FileCache - keep more files open than the system permits
14839
14840 =over 4
14841
14842 =item SYNOPSIS
14843
14844 =item DESCRIPTION
14845
14846 cacheout EXPR, cacheout MODE, EXPR
14847
14848 =item CAVEATS
14849
14850 =item BUGS
14851
14852 =item NOTES
14853
14854 =back
14855
14856 =head2 FileHandle - supply object methods for filehandles
14857
14858 =over 4
14859
14860 =item SYNOPSIS
14861
14862 =item DESCRIPTION
14863
14864 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14865
14866 =item SEE ALSO
14867
14868 =back
14869
14870 =head2 Filter::Simple - Simplified source filtering
14871
14872 =over 4
14873
14874 =item SYNOPSIS
14875
14876 =item DESCRIPTION
14877
14878 =over 4
14879
14880 =item The Problem
14881
14882 =item A Solution
14883
14884 =item Disabling or changing <no> behaviour
14885
14886 =item All-in-one interface
14887
14888 =item Filtering only specific components of source code
14889
14890 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14891 C<"all">
14892
14893 =item Filtering only the code parts of source code
14894
14895 Most source code ceases to be grammatically correct when it is broken up
14896 into the pieces between string literals and regexes. So the C<'code'>
14897 component filter behaves slightly differently from the other partial
14898 filters
14899 described in the previous section.
14900
14901 =item Using Filter::Simple with an explicit C<import> subroutine
14902
14903 =item Using Filter::Simple and Exporter together
14904
14905 =item How it works
14906
14907 =back
14908
14909 =item AUTHOR
14910
14911 =item COPYRIGHT
14912
14913 =back
14914
14915 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14916
14917 =over 4
14918
14919 =item SYNOPSIS
14920
14921 =item DESCRIPTION
14922
14923 =over 4
14924
14925 =item B<use Filter::Util::Call>
14926
14927 =item B<import()>
14928
14929 =item B<filter() and anonymous sub>
14930
14931 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14932
14933 =back
14934
14935 =item EXAMPLES
14936
14937 =over 4
14938
14939 =item Example 1: A simple filter.
14940
14941 =item Example 2: Using the context
14942
14943 =item Example 3: Using the context within the filter
14944
14945 =item Example 4: Using filter_del
14946
14947 =back
14948
14949 =item Filter::Simple
14950
14951 =item AUTHOR
14952
14953 =item DATE
14954
14955 =back
14956
14957 =head2 FindBin - Locate directory of original perl script
14958
14959 =over 4
14960
14961 =item SYNOPSIS
14962
14963 =item DESCRIPTION
14964
14965 =item EXPORTABLE VARIABLES
14966
14967 =item KNOWN ISSUES
14968
14969 =item KNOWN BUGS
14970
14971 =item AUTHORS
14972
14973 =item COPYRIGHT
14974
14975 =back
14976
14977 =head2 GDBM_File - Perl5 access to the gdbm library.
14978
14979 =over 4
14980
14981 =item SYNOPSIS
14982
14983 =item DESCRIPTION
14984
14985 =item AVAILABILITY
14986
14987 =item BUGS
14988
14989 =item SEE ALSO
14990
14991 =back
14992
14993 =head2 Getopt::Long - Extended processing of command line options
14994
14995 =over 4
14996
14997 =item SYNOPSIS
14998
14999 =item DESCRIPTION
15000
15001 =item Command Line Options, an Introduction
15002
15003 =item Getting Started with Getopt::Long
15004
15005 =over 4
15006
15007 =item Simple options
15008
15009 =item A little bit less simple options
15010
15011 =item Mixing command line option with other arguments
15012
15013 =item Options with values
15014
15015 =item Options with multiple values
15016
15017 =item Options with hash values
15018
15019 =item User-defined subroutines to handle options
15020
15021 =item Options with multiple names
15022
15023 =item Case and abbreviations
15024
15025 =item Summary of Option Specifications
15026
15027 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15028 + [ I<desttype> ]
15029
15030 =back
15031
15032 =item Advanced Possibilities
15033
15034 =over 4
15035
15036 =item Object oriented interface
15037
15038 =item Thread Safety
15039
15040 =item Documentation and help texts
15041
15042 =item Storing options in a hash
15043
15044 =item Bundling
15045
15046 =item The lonesome dash
15047
15048 =item Argument callback
15049
15050 =back
15051
15052 =item Configuring Getopt::Long
15053
15054 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15055 require_order, permute, bundling (default: disabled), bundling_override
15056 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15057 (default: disabled), auto_version (default:disabled), auto_help
15058 (default:disabled), pass_through (default: disabled), prefix,
15059 prefix_pattern, debug (default: disabled)
15060
15061 =item Exportable Methods
15062
15063 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15064
15065 =item Return values and Errors
15066
15067 =item Legacy
15068
15069 =over 4
15070
15071 =item Default destinations
15072
15073 =item Alternative option starters
15074
15075 =item Configuration variables
15076
15077 =back
15078
15079 =item Trouble Shooting
15080
15081 =over 4
15082
15083 =item GetOptions does not return a false result when an option is not
15084 supplied
15085
15086 =item GetOptions does not split the command line correctly
15087
15088 =item Undefined subroutine &main::GetOptions called
15089
15090 =item How do I put a "-?" option into a Getopt::Long?
15091
15092 =back
15093
15094 =item AUTHOR
15095
15096 =item COPYRIGHT AND DISCLAIMER
15097
15098 =back
15099
15100 =head2 Getopt::Std, getopt - Process single-character switches with switch
15101 clustering
15102
15103 =over 4
15104
15105 =item SYNOPSIS
15106
15107 =item DESCRIPTION
15108
15109 =item C<--help> and C<--version>
15110
15111 =back
15112
15113 =head2 Hash::Util - A selection of general-utility hash subroutines
15114
15115 =over 4
15116
15117 =item SYNOPSIS
15118
15119 =item DESCRIPTION
15120
15121 =over 4
15122
15123 =item Restricted hashes
15124
15125 lock_keys, unlock_keys
15126
15127 =back
15128
15129 =back
15130
15131 lock_value, unlock_value
15132
15133 B<lock_hash>, B<unlock_hash>
15134
15135 B<hash_seed>
15136
15137 =over 4
15138
15139 =item CAVEATS
15140
15141 =item AUTHOR
15142
15143 =item SEE ALSO
15144
15145 =back
15146
15147 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15148 locale
15149
15150 =over 4
15151
15152 =item SYNOPSIS
15153
15154 =item DESCRIPTION
15155
15156 =back
15157
15158 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15159 tags
15160
15161 =over 4
15162
15163 =item SYNOPSIS
15164
15165 =item DESCRIPTION
15166
15167 =back
15168
15169 the function is_language_tag($lang1)
15170
15171 the function extract_language_tags($whatever)
15172
15173 the function same_language_tag($lang1, $lang2)
15174
15175 the function similarity_language_tag($lang1, $lang2)
15176
15177 the function is_dialect_of($lang1, $lang2)
15178
15179 the function super_languages($lang1)
15180
15181 the function locale2language_tag($locale_identifier)
15182
15183 the function encode_language_tag($lang1)
15184
15185 the function alternate_language_tags($lang1)
15186
15187 the function @langs = panic_languages(@accept_languages)
15188
15189 =over 4
15190
15191 =item ABOUT LOWERCASING
15192
15193 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15194
15195 =item SEE ALSO
15196
15197 =item COPYRIGHT
15198
15199 =item AUTHOR
15200
15201 =back
15202
15203 =head2 I18N::LangTags::List -- tags and names for human languages
15204
15205 =over 4
15206
15207 =item SYNOPSIS
15208
15209 =item DESCRIPTION
15210
15211 =item ABOUT LANGUAGE TAGS
15212
15213 =item LIST OF LANGUAGES
15214
15215 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15216 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15217 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15218 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15219 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15220 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15221 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15222 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15223 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15224 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15225 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15226 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15227 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15228 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15229 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15230 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15231 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15232 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15233 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15234 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15235 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15236 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15237 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15238 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15239 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15240 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15241 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15242 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15243 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15244 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15245 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15246 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15247 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15248 English, {enm} : Old English (1100-1500), {ang} : Old English
15249 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15250 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15251 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
15252 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
15253 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
15254 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
15255 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
15256 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
15257 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
15258 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
15259 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
15260 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
15261 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
15262 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
15263 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
15264 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
15265 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
15266 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
15267 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
15268 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
15269 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
15270 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
15271 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
15272 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
15273 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
15274 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
15275 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
15276 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
15277 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
15278 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
15279 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15280 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15281 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15282 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15283 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15284 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15285 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15286 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15287 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15288 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15289 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15290 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15291 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15292 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15293 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15294 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15295 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15296 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15297 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15298 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15299 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15300 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15301 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15302 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15303 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15304 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15305 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15306 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15307 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15308 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15309 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15310 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15311 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15312 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15313 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15314 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15315 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15316 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15317 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15318 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15319 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15320 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15321 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15322 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15323 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15324 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15325 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15326 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15327 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15328 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15329 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15330 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15331 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15332 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15333 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15334 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15335 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15336 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15337 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15338 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15339 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15340 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15341 {zun} : Zuni
15342
15343 =item SEE ALSO
15344
15345 =item COPYRIGHT AND DISCLAIMER
15346
15347 =item AUTHOR
15348
15349 =back
15350
15351 =head2 I18N::Langinfo - query locale information
15352
15353 =over 4
15354
15355 =item SYNOPSIS
15356
15357 =item DESCRIPTION
15358
15359 =over 4
15360
15361 =item EXPORT
15362
15363 =back
15364
15365 =item SEE ALSO
15366
15367 =item AUTHOR
15368
15369 =item COPYRIGHT AND LICENSE
15370
15371 =back
15372
15373 =head2 IO - load various IO modules
15374
15375 =over 4
15376
15377 =item SYNOPSIS
15378
15379 =item DESCRIPTION
15380
15381 =item DEPRECATED
15382
15383 =back
15384
15385 =head2 IO::Dir - supply object methods for directory handles
15386
15387 =over 4
15388
15389 =item SYNOPSIS
15390
15391 =item DESCRIPTION
15392
15393 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15394 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15395
15396 =item SEE ALSO
15397
15398 =item AUTHOR
15399
15400 =item COPYRIGHT
15401
15402 =back
15403
15404 =head2 IO::File - supply object methods for filehandles
15405
15406 =over 4
15407
15408 =item SYNOPSIS
15409
15410 =item DESCRIPTION
15411
15412 =item CONSTRUCTOR
15413
15414 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15415
15416 =item METHODS
15417
15418 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15419
15420 =item SEE ALSO
15421
15422 =item HISTORY
15423
15424 =back
15425
15426 =head2 IO::Handle - supply object methods for I/O handles
15427
15428 =over 4
15429
15430 =item SYNOPSIS
15431
15432 =item DESCRIPTION
15433
15434 =item CONSTRUCTOR
15435
15436 new (), new_from_fd ( FD, MODE )
15437
15438 =item METHODS
15439
15440 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15441 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15442 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15443 $io->blocking ( [ BOOL ] ), $io->untaint
15444
15445 =item NOTE
15446
15447 =item SEE ALSO
15448
15449 =item BUGS
15450
15451 =item HISTORY
15452
15453 =back
15454
15455 =head2 IO::Pipe - supply object methods for pipes
15456
15457 =over 4
15458
15459 =item SYNOPSIS
15460
15461 =item DESCRIPTION
15462
15463 =item CONSTRUCTOR
15464
15465 new ( [READER, WRITER] )
15466
15467 =item METHODS
15468
15469 reader ([ARGS]), writer ([ARGS]), handles ()
15470
15471 =item SEE ALSO
15472
15473 =item AUTHOR
15474
15475 =item COPYRIGHT
15476
15477 =back
15478
15479 =head2 IO::Poll - Object interface to system poll call
15480
15481 =over 4
15482
15483 =item SYNOPSIS
15484
15485 =item DESCRIPTION
15486
15487 =item METHODS
15488
15489 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15490 IO ), handles( [ EVENT_MASK ] )
15491
15492 =item SEE ALSO
15493
15494 =item AUTHOR
15495
15496 =item COPYRIGHT
15497
15498 =back
15499
15500 =head2 IO::Seekable - supply seek based methods for I/O objects
15501
15502 =over 4
15503
15504 =item SYNOPSIS
15505
15506 =item DESCRIPTION
15507
15508 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15509 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15510 $io->tell
15511
15512 =item SEE ALSO
15513
15514 =item HISTORY
15515
15516 =back
15517
15518 =head2 IO::Select - OO interface to the select system call
15519
15520 =over 4
15521
15522 =item SYNOPSIS
15523
15524 =item DESCRIPTION
15525
15526 =item CONSTRUCTOR
15527
15528 new ( [ HANDLES ] )
15529
15530 =item METHODS
15531
15532 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15533 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15534 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15535
15536 =item EXAMPLE
15537
15538 =item AUTHOR
15539
15540 =item COPYRIGHT
15541
15542 =back
15543
15544 =head2 IO::Socket - Object interface to socket communications
15545
15546 =over 4
15547
15548 =item SYNOPSIS
15549
15550 =item DESCRIPTION
15551
15552 =item CONSTRUCTOR
15553
15554 new ( [ARGS] )
15555
15556 =item METHODS
15557
15558 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15559 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15560
15561 =item SEE ALSO
15562
15563 =item AUTHOR
15564
15565 =item COPYRIGHT
15566
15567 =back
15568
15569 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15570
15571 =over 4
15572
15573 =item SYNOPSIS
15574
15575 =item DESCRIPTION
15576
15577 =item CONSTRUCTOR
15578
15579 new ( [ARGS] )
15580
15581 =over 4
15582
15583 =item METHODS
15584
15585 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15586 ()
15587
15588 =back
15589
15590 =item SEE ALSO
15591
15592 =item AUTHOR
15593
15594 =item COPYRIGHT
15595
15596 =back
15597
15598 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15599
15600 =over 4
15601
15602 =item SYNOPSIS
15603
15604 =item DESCRIPTION
15605
15606 =item CONSTRUCTOR
15607
15608 new ( [ARGS] )
15609
15610 =item METHODS
15611
15612 hostpath(), peerpath()
15613
15614 =item SEE ALSO
15615
15616 =item AUTHOR
15617
15618 =item COPYRIGHT
15619
15620 =back
15621
15622 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15623 handles
15624
15625 =over 4
15626
15627 =item SYNOPSIS
15628
15629 =item DESCRIPTION
15630
15631 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15632 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15633
15634 =item SEE ALSO
15635
15636 =item AUTHOR
15637
15638 =item COPYRIGHT
15639
15640 =back
15641
15642 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15643
15644 =over 4
15645
15646 =item SYNOPSIS
15647
15648 =item DESCRIPTION
15649
15650 =item CONSTRUCTOR
15651
15652 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15653
15654 =item METHODS
15655
15656 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15657
15658 =item SEE ALSO
15659
15660 =item HISTORY
15661
15662 =back
15663
15664 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15665 handles
15666
15667 =over 4
15668
15669 =item SYNOPSIS
15670
15671 =item DESCRIPTION
15672
15673 =item CONSTRUCTOR
15674
15675 new (), new_from_fd ( FD, MODE )
15676
15677 =item METHODS
15678
15679 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15680 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15681 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15682 $io->blocking ( [ BOOL ] ), $io->untaint
15683
15684 =item NOTE
15685
15686 =item SEE ALSO
15687
15688 =item BUGS
15689
15690 =item HISTORY
15691
15692 =back
15693
15694 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15695
15696 =over 4
15697
15698 =item SYNOPSIS
15699
15700 =item DESCRIPTION
15701
15702 =item CONSTRUCTOR
15703
15704 new ( [READER, WRITER] )
15705
15706 =item METHODS
15707
15708 reader ([ARGS]), writer ([ARGS]), handles ()
15709
15710 =item SEE ALSO
15711
15712 =item AUTHOR
15713
15714 =item COPYRIGHT
15715
15716 =back
15717
15718 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15719
15720 =over 4
15721
15722 =item SYNOPSIS
15723
15724 =item DESCRIPTION
15725
15726 =item METHODS
15727
15728 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15729 IO ), handles( [ EVENT_MASK ] )
15730
15731 =item SEE ALSO
15732
15733 =item AUTHOR
15734
15735 =item COPYRIGHT
15736
15737 =back
15738
15739 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15740 I/O objects
15741
15742 =over 4
15743
15744 =item SYNOPSIS
15745
15746 =item DESCRIPTION
15747
15748 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15749 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15750 $io->tell
15751
15752 =item SEE ALSO
15753
15754 =item HISTORY
15755
15756 =back
15757
15758 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15759 call
15760
15761 =over 4
15762
15763 =item SYNOPSIS
15764
15765 =item DESCRIPTION
15766
15767 =item CONSTRUCTOR
15768
15769 new ( [ HANDLES ] )
15770
15771 =item METHODS
15772
15773 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15774 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15775 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15776
15777 =item EXAMPLE
15778
15779 =item AUTHOR
15780
15781 =item COPYRIGHT
15782
15783 =back
15784
15785 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15786 communications
15787
15788 =over 4
15789
15790 =item SYNOPSIS
15791
15792 =item DESCRIPTION
15793
15794 =item CONSTRUCTOR
15795
15796 new ( [ARGS] )
15797
15798 =item METHODS
15799
15800 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15801 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15802
15803 =item SEE ALSO
15804
15805 =item AUTHOR
15806
15807 =item COPYRIGHT
15808
15809 =back
15810
15811 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15812 AF_INET domain sockets
15813
15814 =over 4
15815
15816 =item SYNOPSIS
15817
15818 =item DESCRIPTION
15819
15820 =item CONSTRUCTOR
15821
15822 new ( [ARGS] )
15823
15824 =over 4
15825
15826 =item METHODS
15827
15828 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15829 ()
15830
15831 =back
15832
15833 =item SEE ALSO
15834
15835 =item AUTHOR
15836
15837 =item COPYRIGHT
15838
15839 =back
15840
15841 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15842 AF_UNIX domain sockets
15843
15844 =over 4
15845
15846 =item SYNOPSIS
15847
15848 =item DESCRIPTION
15849
15850 =item CONSTRUCTOR
15851
15852 new ( [ARGS] )
15853
15854 =item METHODS
15855
15856 hostpath(), peerpath()
15857
15858 =item SEE ALSO
15859
15860 =item AUTHOR
15861
15862 =item COPYRIGHT
15863
15864 =back
15865
15866 =head2 IPC::Msg - SysV Msg IPC object class
15867
15868 =over 4
15869
15870 =item SYNOPSIS
15871
15872 =item DESCRIPTION
15873
15874 =item METHODS
15875
15876 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15877 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15878 FLAGS ] ), stat
15879
15880 =item SEE ALSO
15881
15882 =item AUTHOR
15883
15884 =item COPYRIGHT
15885
15886 =back
15887
15888 =head2 IPC::Open2, open2 - open a process for both reading and writing
15889
15890 =over 4
15891
15892 =item SYNOPSIS
15893
15894 =item DESCRIPTION
15895
15896 =item WARNING 
15897
15898 =item SEE ALSO
15899
15900 =back
15901
15902 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15903 handling
15904
15905 =over 4
15906
15907 =item SYNOPSIS
15908
15909 =item DESCRIPTION
15910
15911 =item WARNING
15912
15913 =back
15914
15915 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15916
15917 =over 4
15918
15919 =item SYNOPSIS
15920
15921 =item DESCRIPTION
15922
15923 =item METHODS
15924
15925 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15926 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15927 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15928 , VALUE ), stat
15929
15930 =item SEE ALSO
15931
15932 =item AUTHOR
15933
15934 =item COPYRIGHT
15935
15936 =back
15937
15938 =head2 IPC::SysV - SysV IPC constants
15939
15940 =over 4
15941
15942 =item SYNOPSIS
15943
15944 =item DESCRIPTION
15945
15946 ftok( PATH, ID )
15947
15948 =item SEE ALSO
15949
15950 =item AUTHORS
15951
15952 =item COPYRIGHT
15953
15954 =back
15955
15956 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15957
15958 =over 4
15959
15960 =item SYNOPSIS
15961
15962 =item DESCRIPTION
15963
15964 =item METHODS
15965
15966 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15967 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15968 FLAGS ] ), stat
15969
15970 =item SEE ALSO
15971
15972 =item AUTHOR
15973
15974 =item COPYRIGHT
15975
15976 =back
15977
15978 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15979 class
15980
15981 =over 4
15982
15983 =item SYNOPSIS
15984
15985 =item DESCRIPTION
15986
15987 =item METHODS
15988
15989 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15990 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15991 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15992 , VALUE ), stat
15993
15994 =item SEE ALSO
15995
15996 =item AUTHOR
15997
15998 =item COPYRIGHT
15999
16000 =back
16001
16002 =head2 List::Util - A selection of general-utility list subroutines
16003
16004 =over 4
16005
16006 =item SYNOPSIS
16007
16008 =item DESCRIPTION
16009
16010 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16011 BLOCK LIST, shuffle LIST, sum LIST
16012
16013 =item KNOWN BUGS
16014
16015 =item SUGGESTED ADDITIONS
16016
16017 =item COPYRIGHT
16018
16019 =back
16020
16021 =head2 List::Utilib::List::Util, List::Util - A selection of
16022 general-utility list subroutines
16023
16024 =over 4
16025
16026 =item SYNOPSIS
16027
16028 =item DESCRIPTION
16029
16030 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16031 BLOCK LIST, shuffle LIST, sum LIST
16032
16033 =item KNOWN BUGS
16034
16035 =item SUGGESTED ADDITIONS
16036
16037 =item COPYRIGHT
16038
16039 =back
16040
16041 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16042 general-utility scalar subroutines
16043
16044 =over 4
16045
16046 =item SYNOPSIS
16047
16048 =item DESCRIPTION
16049
16050 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16051 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16052 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16053
16054 =item KNOWN BUGS
16055
16056 =item COPYRIGHT
16057
16058 =item BLATANT PLUG
16059
16060 =back
16061
16062 =head2 Locale::Constants - constants for Locale codes
16063
16064 =over 4
16065
16066 =item SYNOPSIS
16067
16068 =item DESCRIPTION
16069
16070 =item KNOWN BUGS AND LIMITATIONS
16071
16072 =item SEE ALSO
16073
16074 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16075
16076 =item AUTHOR
16077
16078 =item COPYRIGHT
16079
16080 =back
16081
16082 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16083
16084 =over 4
16085
16086 =item SYNOPSIS
16087
16088 =item DESCRIPTION
16089
16090 B<alpha-2>, B<alpha-3>, B<numeric>
16091
16092 =item CONVERSION ROUTINES
16093
16094 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16095 country_code2code( CODE, CODESET, CODESET )
16096
16097 =item QUERY ROUTINES
16098
16099 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16100
16101 =item SEMI-PRIVATE ROUTINES
16102
16103 =over 4
16104
16105 =item alias_code
16106
16107 =item rename_country
16108
16109 =back
16110
16111 =item EXAMPLES
16112
16113 =item DOMAIN NAMES
16114
16115 =item KNOWN BUGS AND LIMITATIONS
16116
16117 =item SEE ALSO
16118
16119 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16120 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16121 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16122 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16123
16124 =item AUTHOR
16125
16126 =item COPYRIGHT
16127
16128 =back
16129
16130 =head2 Locale::Currency - ISO three letter codes for currency
16131 identification (ISO 4217)
16132
16133 =over 4
16134
16135 =item SYNOPSIS
16136
16137 =item DESCRIPTION
16138
16139 XTS, XXX
16140
16141 =item CONVERSION ROUTINES
16142
16143 code2currency(), currency2code()
16144
16145 =item QUERY ROUTINES
16146
16147 C<all_currency_codes()>, C<all_currency_names()>
16148
16149 =item EXAMPLES
16150
16151 =item KNOWN BUGS AND LIMITATIONS
16152
16153 =item SEE ALSO
16154
16155 Locale::Country, Locale::Script, ISO 4217:1995,
16156 http://www.bsi-global.com/iso4217currency
16157
16158 =item AUTHOR
16159
16160 =item COPYRIGHT
16161
16162 =back
16163
16164 =head2 Locale::Language - ISO two letter codes for language identification
16165 (ISO 639)
16166
16167 =over 4
16168
16169 =item SYNOPSIS
16170
16171 =item DESCRIPTION
16172
16173 =item CONVERSION ROUTINES
16174
16175 code2language(), language2code()
16176
16177 =item QUERY ROUTINES
16178
16179 C<all_language_codes()>, C<all_language_names()>
16180
16181 =item EXAMPLES
16182
16183 =item KNOWN BUGS AND LIMITATIONS
16184
16185 =item SEE ALSO
16186
16187 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16188 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16189
16190 =item AUTHOR
16191
16192 =item COPYRIGHT
16193
16194 =back
16195
16196 =head2 Locale::Maketext - framework for localization
16197
16198 =over 4
16199
16200 =item SYNOPSIS
16201
16202 =item DESCRIPTION
16203
16204 =item QUICK OVERVIEW
16205
16206 =item METHODS
16207
16208 =over 4
16209
16210 =item Construction Methods
16211
16212 =item The "maketext" Method
16213
16214 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16215
16216 =item Utility Methods
16217
16218 $language->quant($number, $singular), $language->quant($number, $singular,
16219 $plural), $language->quant($number, $singular, $plural, $negative),
16220 $language->numf($number), $language->sprintf($format, @items),
16221 $language->language_tag(), $language->encoding()
16222
16223 =item Language Handle Attributes and Internals
16224
16225 =back
16226
16227 =item LANGUAGE CLASS HIERARCHIES
16228
16229 =item ENTRIES IN EACH LEXICON
16230
16231 =item BRACKET NOTATION
16232
16233 =item AUTO LEXICONS
16234
16235 =item CONTROLLING LOOKUP FAILURE
16236
16237 =item HOW TO USE MAKETEXT
16238
16239 =item SEE ALSO
16240
16241 =item COPYRIGHT AND DISCLAIMER
16242
16243 =item AUTHOR
16244
16245 =back
16246
16247 =head2 Locale::Maketext::TPJ13 -- article about software localization
16248
16249 =over 4
16250
16251 =item SYNOPSIS
16252
16253 =item DESCRIPTION
16254
16255 =item Localization and Perl: gettext breaks, Maketext fixes
16256
16257 =over 4
16258
16259 =item A Localization Horror Story: It Could Happen To You
16260
16261 =item The Linguistic View
16262
16263 =item Breaking gettext
16264
16265 =item Replacing gettext
16266
16267 =item Buzzwords: Abstraction and Encapsulation
16268
16269 =item Buzzword: Isomorphism
16270
16271 =item Buzzword: Inheritance
16272
16273 =item Buzzword: Concision
16274
16275 =item The Devil in the Details
16276
16277 =item The Proof in the Pudding: Localizing Web Sites
16278
16279 =item References
16280
16281 =back
16282
16283 =back
16284
16285 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16286
16287 =over 4
16288
16289 =item SYNOPSIS
16290
16291 =item DESCRIPTION
16292
16293 B<alpha-2>, B<alpha-3>, B<numeric>
16294
16295 =over 4
16296
16297 =item SPECIAL CODES
16298
16299 =back
16300
16301 =item CONVERSION ROUTINES
16302
16303 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16304 script_code2code( CODE, CODESET, CODESET )
16305
16306 =item QUERY ROUTINES
16307
16308 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16309
16310 =item EXAMPLES
16311
16312 =item KNOWN BUGS AND LIMITATIONS
16313
16314 =item SEE ALSO
16315
16316 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16317 http://www.evertype.com/standards/iso15924/
16318
16319 =item AUTHOR
16320
16321 =item COPYRIGHT
16322
16323 =back
16324
16325 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16326
16327 =over 4
16328
16329 =item SYNOPSIS
16330
16331 =item DESCRIPTION
16332
16333 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16334
16335 =item DIAGNOSTICS
16336
16337 Premature end of base64 data, Premature padding of base64 data
16338
16339 =item EXAMPLES
16340
16341 =item COPYRIGHT
16342
16343 =item SEE ALSO
16344
16345 =back
16346
16347 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16348 of quoted-printable strings
16349
16350 =over 4
16351
16352 =item SYNOPSIS
16353
16354 =item DESCRIPTION
16355
16356 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16357
16358 =item COPYRIGHT
16359
16360 =item SEE ALSO
16361
16362 =back
16363
16364 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16365 strings
16366
16367 =over 4
16368
16369 =item SYNOPSIS
16370
16371 =item DESCRIPTION
16372
16373 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16374
16375 =item COPYRIGHT
16376
16377 =item SEE ALSO
16378
16379 =back
16380
16381 =head2 Math::BigFloat - Arbitrary size floating point math package
16382
16383 =over 4
16384
16385 =item SYNOPSIS
16386
16387 =item DESCRIPTION
16388
16389 =over 4
16390
16391 =item Canonical notation
16392
16393 =item Output
16394
16395 =item C<mantissa()>, C<exponent()> and C<parts()>
16396
16397 =item Accuracy vs. Precision
16398
16399 =item Rounding
16400
16401 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16402 ), fround  ( -$scale ) and fround ( 0 )
16403
16404 =back
16405
16406 =item EXAMPLES
16407
16408   # not ready yet
16409
16410 =item Autocreating constants
16411
16412 =over 4
16413
16414 =item Math library
16415
16416 =item Using Math::BigInt::Lite
16417
16418 =back
16419
16420 =item BUGS
16421
16422 =item CAVEATS
16423
16424 stringify, bstr(), bdiv, Modifying and =, bpow
16425
16426 =item SEE ALSO
16427
16428 =item LICENSE
16429
16430 =item AUTHORS
16431
16432 =back
16433
16434 =head2 Math::BigInt - Arbitrary size integer math package
16435
16436 =over 4
16437
16438 =item SYNOPSIS
16439
16440 =item DESCRIPTION
16441
16442 Input, Output
16443
16444 =item METHODS
16445
16446 =over 4
16447
16448 =item config
16449
16450 =item accuracy
16451
16452 =item precision
16453
16454 =item brsft
16455
16456 =item new
16457
16458 =item bnan
16459
16460 =item bzero
16461
16462 =item binf
16463
16464 =item bone
16465
16466 =item is_one()/is_zero()/is_nan()/is_inf()
16467
16468 =item is_positive()/is_negative()
16469
16470         $x->is_positive();              # true if >= 0
16471         $x->is_negative();              # true if <  0
16472
16473 =item is_odd()/is_even()/is_int()
16474
16475 =item bcmp
16476
16477 =item bacmp
16478
16479 =item sign
16480
16481 =item bcmp
16482
16483 =item bneg
16484
16485 =item babs
16486
16487 =item bnorm
16488
16489 =item bnot
16490
16491 =item binc
16492
16493 =item bdec
16494
16495 =item badd
16496
16497 =item bsub
16498
16499 =item bmul
16500
16501 =item bdiv
16502
16503 =item bmod
16504
16505 =item bmodinv
16506
16507 =item bmodpow
16508
16509 =item bpow
16510
16511 =item blsft
16512
16513 =item brsft
16514
16515 =item band
16516
16517 =item bior
16518
16519 =item bxor
16520
16521 =item bnot
16522
16523 =item bsqrt
16524
16525 =item bfac
16526
16527 =item round
16528
16529 =item bround
16530
16531 =item bfround
16532
16533 =item bfloor
16534
16535 =item bceil
16536
16537 =item bgcd
16538
16539 =item blcm
16540
16541 =item exponent
16542
16543 =item mantissa
16544
16545 =item parts
16546
16547 =item copy
16548
16549 =item as_number
16550
16551 =item bsstr
16552
16553 =item as_hex
16554
16555 =item as_bin
16556
16557 =back
16558
16559 =item ACCURACY and PRECISION
16560
16561 =over 4
16562
16563 =item Precision P
16564
16565 =item Accuracy A
16566
16567 =item Fallback F
16568
16569 =item Rounding mode R
16570
16571 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16572 (significant digits), Setting/Accessing, Creating numbers, Usage,
16573 Precedence, Overriding globals, Local settings, Rounding, Default values,
16574 Remarks
16575
16576 =back
16577
16578 =item INTERNALS
16579
16580 =over 4
16581
16582 =item MATH LIBRARY
16583
16584 =item SIGN
16585
16586 =item mantissa(), exponent() and parts()
16587
16588 =back
16589
16590 =item EXAMPLES
16591
16592   use Math::BigInt;
16593
16594 =item Autocreating constants
16595
16596 =item PERFORMANCE
16597
16598 =over 4
16599
16600 =item Alternative math libraries
16601
16602 =item SUBCLASSING
16603
16604 =back
16605
16606 =item Subclassing Math::BigInt
16607
16608 =item UPGRADING
16609
16610 =over 4
16611
16612 =item Auto-upgrade
16613
16614 bsqrt(), div(), blog()
16615
16616 =back
16617
16618 =item BUGS
16619
16620 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16621 5.6.0
16622
16623 =item CAVEATS
16624
16625 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16626 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16627 types, bsqrt(), brsft()
16628
16629 =item LICENSE
16630
16631 =item SEE ALSO
16632
16633 =item AUTHORS
16634
16635 =back
16636
16637 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16638
16639 =over 4
16640
16641 =item SYNOPSIS
16642
16643 =item DESCRIPTION
16644
16645 =item STORAGE
16646
16647 =item METHODS
16648
16649 =item WRAP YOUR OWN
16650
16651 =item LICENSE
16652
16653 This program is free software; you may redistribute it and/or modify it
16654 under
16655 the same terms as Perl itself. 
16656
16657 =item AUTHORS
16658
16659 =item SEE ALSO
16660
16661 =back
16662
16663 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16664 scalars
16665
16666 =over 4
16667
16668 =item SYNOPSIS
16669
16670 =item DESCRIPTION
16671
16672 =item LICENSE
16673
16674 This program is free software; you may redistribute it and/or modify it
16675 under
16676 the same terms as Perl itself. 
16677
16678 =item AUTHOR
16679
16680 =item SEE ALSO
16681
16682 =back
16683
16684 =head2 Math::BigRat - arbitrarily big rationals
16685
16686 =over 4
16687
16688 =item SYNOPSIS
16689
16690 =item DESCRIPTION
16691
16692 =over 4
16693
16694 =item MATH LIBRARY
16695
16696 =back
16697
16698 =item METHODS
16699
16700 =over 4
16701
16702 =item new()
16703
16704 =item numerator()
16705
16706 =item denominator()
16707
16708         $d = $x->denominator();
16709
16710 =item parts()
16711
16712 =item as_number()
16713
16714 =item bfac()
16715
16716 =item blog()
16717
16718 =item bround()/round()/bfround()
16719
16720 =item bmod()
16721
16722 =item is_one()
16723
16724 =item is_zero()
16725
16726 =item is_positive()
16727
16728 =item is_negative()
16729
16730 =item is_int()
16731
16732 =item is_odd()
16733
16734 =item is_even()
16735
16736 =item bceil()
16737
16738 =item bfloor()
16739
16740         $x->bfloor();
16741
16742 =item config
16743
16744 =back
16745
16746 =item BUGS
16747
16748 inf handling (partial), NaN handling (partial), rounding (not implemented
16749 except for bceil/bfloor), $x ** $y where $y is not an integer
16750
16751 =item LICENSE
16752
16753 =item SEE ALSO
16754
16755 =item AUTHORS
16756
16757 =back
16758
16759 =head2 Math::Complex - complex numbers and associated mathematical
16760 functions
16761
16762 =over 4
16763
16764 =item SYNOPSIS
16765
16766 =item DESCRIPTION
16767
16768 =item OPERATIONS
16769
16770 =item CREATION
16771
16772 =item STRINGIFICATION
16773
16774 =over 4
16775
16776 =item CHANGED IN PERL 5.6
16777
16778 =back
16779
16780 =item USAGE
16781
16782 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16783
16784 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16785
16786 =item BUGS
16787
16788 =item AUTHORS
16789
16790 =back
16791
16792 =head2 Math::Trig - trigonometric functions
16793
16794 =over 4
16795
16796 =item SYNOPSIS
16797
16798 =item DESCRIPTION
16799
16800 =item TRIGONOMETRIC FUNCTIONS
16801
16802 B<tan>
16803
16804 =over 4
16805
16806 =item ERRORS DUE TO DIVISION BY ZERO
16807
16808 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16809
16810 =back
16811
16812 =item PLANE ANGLE CONVERSIONS
16813
16814 =item RADIAL COORDINATE CONVERSIONS
16815
16816 =over 4
16817
16818 =item COORDINATE SYSTEMS
16819
16820 =item 3-D ANGLE CONVERSIONS
16821
16822 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16823 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16824
16825 =back
16826
16827 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16828
16829 =item EXAMPLES
16830
16831 =over 4
16832
16833 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16834
16835 =back
16836
16837 =item BUGS
16838
16839 =item AUTHORS
16840
16841 =back
16842
16843 =head2 Memoize - Make functions faster by trading space for time
16844
16845 =over 4
16846
16847 =item SYNOPSIS
16848
16849 =item DESCRIPTION
16850
16851 =item DETAILS
16852
16853 =item OPTIONS
16854
16855 =over 4
16856
16857 =item INSTALL
16858
16859 =item NORMALIZER
16860
16861 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16862
16863 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16864
16865 =back
16866
16867 =item OTHER FACILITIES
16868
16869 =over 4
16870
16871 =item C<unmemoize>
16872
16873 =item C<flush_cache>
16874
16875 =back
16876
16877 =item CAVEATS
16878
16879 =item PERSISTENT CACHE SUPPORT
16880
16881 =item EXPIRATION SUPPORT
16882
16883 =item BUGS
16884
16885 =item MAILING LIST
16886
16887 =item AUTHOR
16888
16889 =item COPYRIGHT AND LICENSE
16890
16891 =item THANK YOU
16892
16893 =back
16894
16895 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16896 Storable use
16897
16898 =over 4
16899
16900 =item DESCRIPTION
16901
16902 =back
16903
16904 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16905 memoized values
16906
16907 =over 4
16908
16909 =item SYNOPSIS
16910
16911 =item DESCRIPTION
16912
16913 =item INTERFACE
16914
16915  TIEHASH,  EXISTS,  STORE
16916
16917 =item ALTERNATIVES
16918
16919 =item CAVEATS
16920
16921 =item AUTHOR
16922
16923 =item SEE ALSO
16924
16925 =back
16926
16927 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16928
16929 =over 4
16930
16931 =item DESCRIPTION
16932
16933 =back
16934
16935 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16936
16937 =over 4
16938
16939 =item DESCRIPTION
16940
16941 =back
16942
16943 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16944 Storable use
16945
16946 =over 4
16947
16948 =item DESCRIPTION
16949
16950 =back
16951
16952 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16953 Storable use
16954
16955 =over 4
16956
16957 =item DESCRIPTION
16958
16959 =back
16960
16961 =head2 Memoize::Storable - store Memoized data in Storable database
16962
16963 =over 4
16964
16965 =item DESCRIPTION
16966
16967 =back
16968
16969 =head2 NDBM_File - Tied access to ndbm files
16970
16971 =over 4
16972
16973 =item SYNOPSIS
16974
16975 =item DESCRIPTION
16976
16977 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16978
16979 =item DIAGNOSTICS
16980
16981 =over 4
16982
16983 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16984
16985 =back
16986
16987 =item BUGS AND WARNINGS
16988
16989 =back
16990
16991 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
16992 redispatch
16993
16994 =over 4
16995
16996 =item SYNOPSIS
16997
16998 =item DESCRIPTION
16999
17000 =over 4
17001
17002 =item Enforcing redispatch
17003
17004 =item Avoiding repetitions
17005
17006 =item Invoking all versions of a method with a single call
17007
17008 =item Using C<EVERY> methods
17009
17010 =back
17011
17012 =item AUTHOR
17013
17014 =item BUGS AND IRRITATIONS
17015
17016 =item COPYRIGHT
17017
17018 =back
17019
17020 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17021
17022 =over 4
17023
17024 =item SYNOPSIS
17025
17026 =item DESCRIPTION
17027
17028 =item USER METHODS
17029
17030 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17031 dataend ()
17032
17033 =item CLASS METHODS
17034
17035 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17036 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17037 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17038
17039 =item EXPORTS
17040
17041 =item AUTHOR
17042
17043 =item COPYRIGHT
17044
17045 =back
17046
17047 =head2 Net::Config - Local configuration data for libnet
17048
17049 =over 4
17050
17051 =item SYNOPSYS
17052
17053 =item DESCRIPTION
17054
17055 =item METHODS
17056
17057 requires_firewall HOST
17058
17059 =item NetConfig VALUES
17060
17061 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17062 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17063 ftp_int_pasive, local_netmask, test_hosts, test_exists
17064
17065 =back
17066
17067 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17068 and domain
17069
17070 =over 4
17071
17072 =item SYNOPSIS
17073
17074 =item DESCRIPTION
17075
17076 hostfqdn (), hostname (), hostdomain ()
17077
17078 =item AUTHOR
17079
17080 =item COPYRIGHT
17081
17082 =back
17083
17084 =head2 Net::FTP - FTP Client class
17085
17086 =over 4
17087
17088 =item SYNOPSIS
17089
17090 =item DESCRIPTION
17091
17092 =item OVERVIEW
17093
17094 =item CONSTRUCTOR
17095
17096 new (HOST [,OPTIONS])
17097
17098 =item METHODS
17099
17100 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17101 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17102 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17103 RECURSE ]), mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [,
17104 RECORD_SIZE] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]]
17105 ), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [,
17106 REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (),
17107 mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash (
17108 [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [
17109 DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port (
17110 [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
17111 pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
17112 NON_PASV_SERVER ), abort (), quit ()
17113
17114 =over 4
17115
17116 =item Methods for the adventurous
17117
17118 quot (CMD [,ARGS])
17119
17120 =back
17121
17122 =item THE dataconn CLASS
17123
17124 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17125 bytes_read (), abort (), close ()
17126
17127 =item UNIMPLEMENTED
17128
17129 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17130
17131 =item REPORTING BUGS
17132
17133 =item AUTHOR
17134
17135 =item SEE ALSO
17136
17137 =item USE EXAMPLES
17138
17139 http://www.csh.rit.edu/~adam/Progs/
17140
17141 =item CREDITS
17142
17143 =item COPYRIGHT
17144
17145 =back
17146
17147 =head2 Net::NNTP - NNTP Client class
17148
17149 =over 4
17150
17151 =item SYNOPSIS
17152
17153 =item DESCRIPTION
17154
17155 =item CONSTRUCTOR
17156
17157 new ( [ HOST ] [, OPTIONS ])
17158
17159 =item METHODS
17160
17161 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17162 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17163 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17164 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17165 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17166 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17167 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17168
17169 =over 4
17170
17171 =item Extension methods
17172
17173 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17174 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17175 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17176 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17177 GROUP ] ), reader
17178
17179 =back
17180
17181 =item UNSUPPORTED
17182
17183 =item DEFINITIONS
17184
17185 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17186
17187 =item SEE ALSO
17188
17189 =item AUTHOR
17190
17191 =item COPYRIGHT
17192
17193 =back
17194
17195 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17196
17197 =over 4
17198
17199 =item SYNOPSIS
17200
17201 =item DESCRIPTION
17202
17203 =item CONSTRUCTOR
17204
17205 new ( [ HOST, ] [ OPTIONS ] )
17206
17207 =item METHODS
17208
17209 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
17210 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
17211 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
17212 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
17213
17214 =item NOTES
17215
17216 =item SEE ALSO
17217
17218 =item AUTHOR
17219
17220 =item COPYRIGHT
17221
17222 =back
17223
17224 =head2 Net::Ping - check a remote host for reachability
17225
17226 =over 4
17227
17228 =item SYNOPSIS
17229
17230 =item DESCRIPTION
17231
17232 =over 4
17233
17234 =item Functions
17235
17236 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
17237 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
17238 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
17239 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
17240 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
17241 [, $timeout]);
17242
17243 =back
17244
17245 =item NOTES
17246
17247 =item INSTALL
17248
17249 =item BUGS
17250
17251 =item AUTHORS
17252
17253 =item COPYRIGHT
17254
17255 =back
17256
17257 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
17258
17259 =over 4
17260
17261 =item SYNOPSIS
17262
17263 =item DESCRIPTION
17264
17265 =item EXAMPLES
17266
17267 =item CONSTRUCTOR
17268
17269 new Net::SMTP [ HOST, ] [ OPTIONS ]
17270
17271 =item METHODS
17272
17273 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
17274 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
17275 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
17276 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
17277 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
17278 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
17279 quit ()
17280
17281 =item ADDRESSES
17282
17283 =item SEE ALSO
17284
17285 =item AUTHOR
17286
17287 =item COPYRIGHT
17288
17289 =back
17290
17291 =head2 Net::Time - time and daytime network client interface
17292
17293 =over 4
17294
17295 =item SYNOPSIS
17296
17297 =item DESCRIPTION
17298
17299 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17300 PROTOCOL [, TIMEOUT]]])
17301
17302 =item AUTHOR
17303
17304 =item COPYRIGHT
17305
17306 =back
17307
17308 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17309 functions
17310
17311 =over 4
17312
17313 =item SYNOPSIS
17314
17315 =item DESCRIPTION
17316
17317 =item EXAMPLES
17318
17319 =item NOTE
17320
17321 =item AUTHOR
17322
17323 =back
17324
17325 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17326
17327 =over 4
17328
17329 =item DESCRIPTION
17330
17331 =over 4
17332
17333 =item Where to get this document
17334
17335 =item How to contribute to this document
17336
17337 =back
17338
17339 =item Author and Copyright Information
17340
17341 =over 4
17342
17343 =item Disclaimer
17344
17345 =back
17346
17347 =item Obtaining and installing libnet
17348
17349 =over 4
17350
17351 =item What is libnet ?
17352
17353 =item Which version of perl do I need ?
17354
17355 =item What other modules do I need ?
17356
17357 =item What machines support libnet ?
17358
17359 =item Where can I get the latest libnet release
17360
17361 =back
17362
17363 =item Using Net::FTP
17364
17365 =over 4
17366
17367 =item How do I download files from an FTP server ?
17368
17369 =item How do I transfer files in binary mode ?
17370
17371 =item How can I get the size of a file on a remote FTP server ?
17372
17373 =item How can I get the modification time of a file on a remote FTP server
17374 ?
17375
17376 =item How can I change the permissions of a file on a remote server ?
17377
17378 =item Can I do a reget operation like the ftp command ?
17379
17380 =item How do I get a directory listing from an FTP server ?
17381
17382 =item Changing directory to "" does not fail ?
17383
17384 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17385
17386 =item I am behind an FTP proxy firewall, but cannot access machines outside
17387 ?
17388
17389 =item My ftp proxy firewall does not listen on port 21
17390
17391 =item Is it possible to change the file permissions of a file on an FTP
17392 server ?
17393
17394 =item I have seen scripts call a method message, but cannot find it
17395 documented ?
17396
17397 =item Why does Net::FTP not implement mput and mget methods
17398
17399 =back
17400
17401 =item Using Net::SMTP
17402
17403 =over 4
17404
17405 =item Why can't the part of an Email address after the @ be used as the
17406 hostname ?
17407
17408 =item Why does Net::SMTP not do DNS MX lookups ?
17409
17410 =item The verify method always returns true ?
17411
17412 =back
17413
17414 =item Debugging scripts
17415
17416 =over 4
17417
17418 =item How can I debug my scripts that use Net::* modules ?
17419
17420 =back
17421
17422 =item AUTHOR AND COPYRIGHT
17423
17424 =back
17425
17426 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17427 functions
17428
17429 =over 4
17430
17431 =item SYNOPSIS
17432
17433 =item DESCRIPTION
17434
17435 =item EXAMPLES
17436
17437 =item NOTE
17438
17439 =item AUTHOR
17440
17441 =back
17442
17443 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17444 functions
17445
17446 =over 4
17447
17448 =item SYNOPSIS
17449
17450 =item DESCRIPTION
17451
17452 =item NOTE
17453
17454 =item AUTHOR
17455
17456 =back
17457
17458 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17459 functions
17460
17461 =over 4
17462
17463 =item SYNOPSIS
17464
17465 =item DESCRIPTION
17466
17467 =item EXAMPLES
17468
17469 =item NOTE
17470
17471 =item AUTHOR
17472
17473 =back
17474
17475 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17476
17477 =over 4
17478
17479 =item SYNOPSIS
17480
17481 =item DESCRIPTION
17482
17483 =item THE .netrc FILE
17484
17485 machine name, default, login name, password string, account string, macdef
17486 name
17487
17488 =item CONSTRUCTOR
17489
17490 lookup ( MACHINE [, LOGIN ])
17491
17492 =item METHODS
17493
17494 login (), password (), account (), lpa ()
17495
17496 =item AUTHOR
17497
17498 =item SEE ALSO
17499
17500 =item COPYRIGHT
17501
17502 =back
17503
17504 =head2 O - Generic interface to Perl Compiler backends
17505
17506 =over 4
17507
17508 =item SYNOPSIS
17509
17510 =item DESCRIPTION
17511
17512 =item CONVENTIONS
17513
17514 =item IMPLEMENTATION
17515
17516 =item BUGS
17517
17518 =item AUTHOR
17519
17520 =back
17521
17522 =head2 ODBM_File - Tied access to odbm files
17523
17524 =over 4
17525
17526 =item SYNOPSIS
17527
17528 =item DESCRIPTION
17529
17530 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17531
17532 =item DIAGNOSTICS
17533
17534 =over 4
17535
17536 =item C<odbm store returned -1, errno 22, key "..." at ...>
17537
17538 =back
17539
17540 =item BUGS AND WARNINGS
17541
17542 =back
17543
17544 =head2 Opcode - Disable named opcodes when compiling perl code
17545
17546 =over 4
17547
17548 =item SYNOPSIS
17549
17550 =item DESCRIPTION
17551
17552 =item NOTE
17553
17554 =item WARNING
17555
17556 =item Operator Names and Operator Lists
17557
17558 an operator name (opname), an operator tag name (optag), a negated opname
17559 or optag, an operator set (opset)
17560
17561 =item Opcode Functions
17562
17563 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17564 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17565 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17566 opdump (PAT)
17567
17568 =item Manipulating Opsets
17569
17570 =item TO DO (maybe)
17571
17572 =back
17573
17574 =over 4
17575
17576 =item Predefined Opcode Tags
17577
17578 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17579 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17580 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17581 :dangerous
17582
17583 =item SEE ALSO
17584
17585 =item AUTHORS
17586
17587 =back
17588
17589 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17590 compartments
17591
17592 =over 4
17593
17594 =item SYNOPSIS
17595
17596 =item DESCRIPTION
17597
17598 a new namespace, an operator mask
17599
17600 =item WARNING
17601
17602 =over 4
17603
17604 =item RECENT CHANGES
17605
17606 =item Methods in class Safe
17607
17608 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17609 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17610 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17611 root (NAMESPACE), mask (MASK)
17612
17613 =item Some Safety Issues
17614
17615 Memory, CPU, Snooping, Signals, State Changes
17616
17617 =item AUTHOR
17618
17619 =back
17620
17621 =back
17622
17623 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17624 compiling
17625
17626 =over 4
17627
17628 =item SYNOPSIS  
17629
17630 =item DESCRIPTION
17631
17632 =item SEE ALSO
17633
17634 =back
17635
17636 =head2 POSIX - Perl interface to IEEE Std 1003.1
17637
17638 =over 4
17639
17640 =item SYNOPSIS
17641
17642 =item DESCRIPTION
17643
17644 =item NOTE
17645
17646 =item CAVEATS 
17647
17648 =item FUNCTIONS
17649
17650 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17651 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17652 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17653 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17654 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17655 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17656 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17657 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17658 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17659 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17660 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17661 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17662 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17663 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17664 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17665 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17666 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17667 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17668 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17669 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17670 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17671 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17672 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17673 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17674 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17675 wctomb, write
17676
17677 =item CLASSES
17678
17679 =over 4
17680
17681 =item POSIX::SigAction
17682
17683 new, handler, mask, flags, safe
17684
17685 =item POSIX::SigSet
17686
17687 new, addset, delset, emptyset, fillset, ismember
17688
17689 =item POSIX::Termios
17690
17691 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17692 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17693 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17694 field values, c_cflag field values, c_iflag field values, c_lflag field
17695 values, c_oflag field values
17696
17697 =back
17698
17699 =item PATHNAME CONSTANTS
17700
17701 Constants
17702
17703 =item POSIX CONSTANTS
17704
17705 Constants
17706
17707 =item SYSTEM CONFIGURATION
17708
17709 Constants
17710
17711 =item ERRNO
17712
17713 Constants
17714
17715 =item FCNTL
17716
17717 Constants
17718
17719 =item FLOAT
17720
17721 Constants
17722
17723 =item LIMITS
17724
17725 Constants
17726
17727 =item LOCALE
17728
17729 Constants
17730
17731 =item MATH
17732
17733 Constants
17734
17735 =item SIGNAL
17736
17737 Constants
17738
17739 =item STAT
17740
17741 Constants, Macros
17742
17743 =item STDLIB
17744
17745 Constants
17746
17747 =item STDIO
17748
17749 Constants
17750
17751 =item TIME
17752
17753 Constants
17754
17755 =item UNISTD
17756
17757 Constants
17758
17759 =item WAIT
17760
17761 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17762 WTERMSIG, WIFSTOPPED, WSTOPSIG
17763
17764 =back
17765
17766 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17767 name space
17768
17769 =over 4
17770
17771 =item SYNOPSIS
17772
17773 =item DESCRIPTION
17774
17775 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
17776
17777 =over 4
17778
17779 =item Custom Layers
17780
17781 :encoding, :via
17782
17783 =item Alternatives to raw
17784
17785 =item Defaults and how to override them
17786
17787 =item Querying the layers of filehandles
17788
17789 =back
17790
17791 =item AUTHOR
17792
17793 =item SEE ALSO
17794
17795 =back
17796
17797 =head2 PerlIO::encoding - encoding layer
17798
17799 =over 4
17800
17801 =item SYNOPSIS
17802
17803 =item DESCRIPTION
17804
17805 =item SEE ALSO
17806
17807 =back
17808
17809 =head2 PerlIO::scalar - in-memory IO, scalar IO
17810
17811 =over 4
17812
17813 =item SYNOPSIS
17814
17815 =item DESCRIPTION
17816
17817 =item IMPLEMENTATION NOTE
17818
17819 =back
17820
17821 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17822
17823 =over 4
17824
17825 =item SYNOPSIS
17826
17827 =item DESCRIPTION
17828
17829 =item EXPECTED METHODS
17830
17831 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17832 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
17833 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
17834 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
17835 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
17836 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
17837 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
17838 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
17839
17840 =item EXAMPLES
17841
17842 =over 4
17843
17844 =item Example - a Hexadecimal Handle
17845
17846 =back
17847
17848 =back
17849
17850 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17851
17852 =over 4
17853
17854 =item SYNOPSIS
17855
17856 =item DESCRIPTION
17857
17858 =item SEE ALSO
17859
17860 =item ACKNOWLEDGEMENTS
17861
17862 =item COPYRIGHT
17863
17864 =back
17865
17866 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17867
17868 =over 4
17869
17870 =item SYNOPSIS
17871
17872 =item OPTIONS/ARGUMENTS
17873
17874 =over 4
17875
17876 =item podchecker()
17877
17878 B<-warnings> =E<gt> I<val>
17879
17880 =back
17881
17882 =item DESCRIPTION
17883
17884 =item DIAGNOSTICS
17885
17886 =over 4
17887
17888 =item Errors
17889
17890 empty =headn, =over on line I<N> without closing =back, =item without
17891 previous =over, =back without previous =over, No argument for =begin, =end
17892 without =begin, Nested =begin's, =for without formatter specification,
17893 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17894 interior-sequence "I<SEQ>", nested commands
17895 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17896 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17897 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17898 after =back
17899
17900 =item Warnings
17901
17902 multiple occurrence of link target I<name>, line containing nothing but
17903 whitespace in paragraph, file does not start with =head, previous =item has
17904 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17905 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17906 items in =over, No argument for =item, empty section in previous paragraph,
17907 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17908 level
17909
17910 =item Hyperlinks
17911
17912 ignoring leading/trailing whitespace in link, (section) in '$page'
17913 deprecated, alternative text/node '%s' contains non-escaped | or /
17914
17915 =back
17916
17917 =item RETURN VALUE
17918
17919 =item EXAMPLES
17920
17921 =item INTERFACE
17922
17923 =back
17924
17925 C<Pod::Checker-E<gt>new( %options )>
17926
17927 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17928 @args )>
17929
17930 C<$checker-E<gt>num_errors()>
17931
17932 C<$checker-E<gt>num_warnings()>
17933
17934 C<$checker-E<gt>name()>
17935
17936 C<$checker-E<gt>node()>
17937
17938 C<$checker-E<gt>idx()>
17939
17940 C<$checker-E<gt>hyperlink()>
17941
17942 =over 4
17943
17944 =item AUTHOR
17945
17946 =back
17947
17948 =head2 Pod::Find - find POD documents in directory trees
17949
17950 =over 4
17951
17952 =item SYNOPSIS
17953
17954 =item DESCRIPTION
17955
17956 =back
17957
17958 =over 4
17959
17960 =item C<pod_find( { %opts } , @directories )>
17961
17962 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17963 1>
17964
17965 =back
17966
17967 =over 4
17968
17969 =item C<simplify_name( $str )>
17970
17971 =back
17972
17973 =over 4
17974
17975 =item C<pod_where( { %opts }, $pod )>
17976
17977 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17978 1>
17979
17980 =back
17981
17982 =over 4
17983
17984 =item C<contains_pod( $file , $verbose )>
17985
17986 =back
17987
17988 =over 4
17989
17990 =item AUTHOR
17991
17992 =item SEE ALSO
17993
17994 =back
17995
17996 =head2 Pod::Html - module to convert pod files to HTML
17997
17998 =over 4
17999
18000 =item SYNOPSIS
18001
18002 =item DESCRIPTION
18003
18004 =item ARGUMENTS
18005
18006 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
18007 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
18008 title, verbose
18009
18010 =item EXAMPLE
18011
18012 =item ENVIRONMENT
18013
18014 =item AUTHOR
18015
18016 =item SEE ALSO
18017
18018 =item COPYRIGHT
18019
18020 =back
18021
18022 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18023 commands, etc.
18024
18025 =over 4
18026
18027 =item SYNOPSIS
18028
18029 =item REQUIRES
18030
18031 =item EXPORTS
18032
18033 =item DESCRIPTION
18034
18035 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18036 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18037
18038 =back
18039
18040 =over 4
18041
18042 =item B<Pod::InputSource>
18043
18044 =back
18045
18046 =over 4
18047
18048 =item B<new()>
18049
18050 =back
18051
18052 =over 4
18053
18054 =item B<name()>
18055
18056 =back
18057
18058 =over 4
18059
18060 =item B<handle()>
18061
18062 =back
18063
18064 =over 4
18065
18066 =item B<was_cutting()>
18067
18068 =back
18069
18070 =over 4
18071
18072 =item B<Pod::Paragraph>
18073
18074 =back
18075
18076 =over 4
18077
18078 =item Pod::Paragraph-E<gt>B<new()>
18079
18080 =back
18081
18082 =over 4
18083
18084 =item $pod_para-E<gt>B<cmd_name()>
18085
18086 =back
18087
18088 =over 4
18089
18090 =item $pod_para-E<gt>B<text()>
18091
18092 =back
18093
18094 =over 4
18095
18096 =item $pod_para-E<gt>B<raw_text()>
18097
18098 =back
18099
18100 =over 4
18101
18102 =item $pod_para-E<gt>B<cmd_prefix()>
18103
18104 =back
18105
18106 =over 4
18107
18108 =item $pod_para-E<gt>B<cmd_separator()>
18109
18110 =back
18111
18112 =over 4
18113
18114 =item $pod_para-E<gt>B<parse_tree()>
18115
18116 =back
18117
18118 =over 4
18119
18120 =item $pod_para-E<gt>B<file_line()>
18121
18122 =back
18123
18124 =over 4
18125
18126 =item B<Pod::InteriorSequence>
18127
18128 =back
18129
18130 =over 4
18131
18132 =item Pod::InteriorSequence-E<gt>B<new()>
18133
18134 =back
18135
18136 =over 4
18137
18138 =item $pod_seq-E<gt>B<cmd_name()>
18139
18140 =back
18141
18142 =over 4
18143
18144 =item $pod_seq-E<gt>B<prepend()>
18145
18146 =back
18147
18148 =over 4
18149
18150 =item $pod_seq-E<gt>B<append()>
18151
18152 =back
18153
18154 =over 4
18155
18156 =item $pod_seq-E<gt>B<nested()>
18157
18158 =back
18159
18160 =over 4
18161
18162 =item $pod_seq-E<gt>B<raw_text()>
18163
18164 =back
18165
18166 =over 4
18167
18168 =item $pod_seq-E<gt>B<left_delimiter()>
18169
18170 =back
18171
18172 =over 4
18173
18174 =item $pod_seq-E<gt>B<right_delimiter()>
18175
18176 =back
18177
18178 =over 4
18179
18180 =item $pod_seq-E<gt>B<parse_tree()>
18181
18182 =back
18183
18184 =over 4
18185
18186 =item $pod_seq-E<gt>B<file_line()>
18187
18188 =back
18189
18190 =over 4
18191
18192 =item Pod::InteriorSequence::B<DESTROY()>
18193
18194 =back
18195
18196 =over 4
18197
18198 =item B<Pod::ParseTree>
18199
18200 =back
18201
18202 =over 4
18203
18204 =item Pod::ParseTree-E<gt>B<new()>
18205
18206 =back
18207
18208 =over 4
18209
18210 =item $ptree-E<gt>B<top()>
18211
18212 =back
18213
18214 =over 4
18215
18216 =item $ptree-E<gt>B<children()>
18217
18218 =back
18219
18220 =over 4
18221
18222 =item $ptree-E<gt>B<prepend()>
18223
18224 =back
18225
18226 =over 4
18227
18228 =item $ptree-E<gt>B<append()>
18229
18230 =back
18231
18232 =over 4
18233
18234 =item $ptree-E<gt>B<raw_text()>
18235
18236 =back
18237
18238 =over 4
18239
18240 =item Pod::ParseTree::B<DESTROY()>
18241
18242 =back
18243
18244 =over 4
18245
18246 =item SEE ALSO
18247
18248 =item AUTHOR
18249
18250 =back
18251
18252 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
18253
18254 =over 4
18255
18256 =item SYNOPSIS
18257
18258 =item DESCRIPTION
18259
18260 =back
18261
18262 =over 4
18263
18264 =item OBJECT METHODS
18265
18266 C<initialize>
18267
18268 =back
18269
18270 =over 4
18271
18272 =item Data Accessors
18273
18274 B<AddPreamble>
18275
18276 =back
18277
18278 B<AddPostamble>
18279
18280 B<Head1Level>
18281
18282 B<Label>
18283
18284 B<LevelNoNum>
18285
18286 B<MakeIndex>
18287
18288 B<ReplaceNAMEwithSection>
18289
18290 B<StartWithNewPage>
18291
18292 B<TableOfContents>
18293
18294 B<UniqueLabels>
18295
18296 B<UserPreamble>
18297
18298 B<UserPostamble>
18299
18300 B<Lists>
18301
18302 =over 4
18303
18304 =item Subclassed methods
18305
18306 =back
18307
18308 B<begin_pod>
18309
18310 B<end_pod>
18311
18312 B<command>
18313
18314 B<verbatim>
18315
18316 B<textblock>
18317
18318 B<interior_sequence>
18319
18320 =over 4
18321
18322 =item List Methods
18323
18324 B<begin_list>
18325
18326 =back
18327
18328 B<end_list>
18329
18330 B<add_item>
18331
18332 =over 4
18333
18334 =item Methods for headings
18335
18336 B<head>
18337
18338 =back
18339
18340 =over 4
18341
18342 =item Internal methods
18343
18344 B<_output>
18345
18346 =back
18347
18348 B<_replace_special_chars>
18349
18350 B<_replace_special_chars_late>
18351
18352 B<_create_label>
18353
18354 B<_create_index>
18355
18356 B<_clean_latex_commands>
18357
18358 B<_split_delimited>
18359
18360 =over 4
18361
18362 =item NOTES
18363
18364 =item SEE ALSO
18365
18366 =item AUTHORS
18367
18368 =item COPYRIGHT
18369
18370 =item REVISION
18371
18372 =back
18373
18374 =head2 Pod::Man - Convert POD data to formatted *roff input
18375
18376 =over 4
18377
18378 =item SYNOPSIS
18379
18380 =item DESCRIPTION
18381
18382 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18383 release, section
18384
18385 =item DIAGNOSTICS
18386
18387 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18388 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18389 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18390 =back
18391
18392 =item BUGS
18393
18394 =item CAVEATS
18395
18396 =item SEE ALSO
18397
18398 =item AUTHOR
18399
18400 =item COPYRIGHT AND LICENSE
18401
18402 =back
18403
18404 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18405
18406 =over 4
18407
18408 =item SYNOPSIS
18409
18410 =item DESCRIPTION
18411
18412 =item SEE ALSO
18413
18414 =item AUTHOR
18415
18416 =item COPYRIGHT AND LICENSE
18417
18418 =back
18419
18420 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18421
18422 =over 4
18423
18424 =item SYNOPSIS
18425
18426 =item DESCRIPTION
18427
18428 =back
18429
18430 =over 4
18431
18432 =item Pod::List
18433
18434 Pod::List-E<gt>new()
18435
18436 =back
18437
18438 $list-E<gt>file()
18439
18440 $list-E<gt>start()
18441
18442 $list-E<gt>indent()
18443
18444 $list-E<gt>type()
18445
18446 $list-E<gt>rx()
18447
18448 $list-E<gt>item()
18449
18450 $list-E<gt>parent()
18451
18452 $list-E<gt>tag()
18453
18454 =over 4
18455
18456 =item Pod::Hyperlink
18457
18458 Pod::Hyperlink-E<gt>new()
18459
18460 =back
18461
18462 $link-E<gt>parse($string)
18463
18464 $link-E<gt>markup($string)
18465
18466 $link-E<gt>text()
18467
18468 $link-E<gt>warning()
18469
18470 $link-E<gt>file(), $link-E<gt>line()
18471
18472 $link-E<gt>page()
18473
18474 $link-E<gt>node()
18475
18476 $link-E<gt>alttext()
18477
18478 $link-E<gt>type()
18479
18480 $link-E<gt>link()
18481
18482 =over 4
18483
18484 =item Pod::Cache
18485
18486 Pod::Cache-E<gt>new()
18487
18488 =back
18489
18490 $cache-E<gt>item()
18491
18492 $cache-E<gt>find_page($name)
18493
18494 =over 4
18495
18496 =item Pod::Cache::Item
18497
18498 Pod::Cache::Item-E<gt>new()
18499
18500 =back
18501
18502 $cacheitem-E<gt>page()
18503
18504 $cacheitem-E<gt>description()
18505
18506 $cacheitem-E<gt>path()
18507
18508 $cacheitem-E<gt>file()
18509
18510 $cacheitem-E<gt>nodes()
18511
18512 $cacheitem-E<gt>find_node($name)
18513
18514 $cacheitem-E<gt>idx()
18515
18516 =over 4
18517
18518 =item AUTHOR
18519
18520 =item SEE ALSO
18521
18522 =back
18523
18524 =head2 Pod::Parser - base class for creating POD filters and translators
18525
18526 =over 4
18527
18528 =item SYNOPSIS
18529
18530 =item REQUIRES
18531
18532 =item EXPORTS
18533
18534 =item DESCRIPTION
18535
18536 =item QUICK OVERVIEW
18537
18538 =item PARSING OPTIONS
18539
18540 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18541 B<-warnings> (default: unset)
18542
18543 =back
18544
18545 =over 4
18546
18547 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18548
18549 =back
18550
18551 =over 4
18552
18553 =item B<command()>
18554
18555 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18556
18557 =back
18558
18559 =over 4
18560
18561 =item B<verbatim()>
18562
18563 C<$text>, C<$line_num>, C<$pod_para>
18564
18565 =back
18566
18567 =over 4
18568
18569 =item B<textblock()>
18570
18571 C<$text>, C<$line_num>, C<$pod_para>
18572
18573 =back
18574
18575 =over 4
18576
18577 =item B<interior_sequence()>
18578
18579 =back
18580
18581 =over 4
18582
18583 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18584
18585 =back
18586
18587 =over 4
18588
18589 =item B<new()>
18590
18591 =back
18592
18593 =over 4
18594
18595 =item B<initialize()>
18596
18597 =back
18598
18599 =over 4
18600
18601 =item B<begin_pod()>
18602
18603 =back
18604
18605 =over 4
18606
18607 =item B<begin_input()>
18608
18609 =back
18610
18611 =over 4
18612
18613 =item B<end_input()>
18614
18615 =back
18616
18617 =over 4
18618
18619 =item B<end_pod()>
18620
18621 =back
18622
18623 =over 4
18624
18625 =item B<preprocess_line()>
18626
18627 =back
18628
18629 =over 4
18630
18631 =item B<preprocess_paragraph()>
18632
18633 =back
18634
18635 =over 4
18636
18637 =item METHODS FOR PARSING AND PROCESSING
18638
18639 =back
18640
18641 =over 4
18642
18643 =item B<parse_text()>
18644
18645 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18646 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18647 I<code-ref>|I<method-name>
18648
18649 =back
18650
18651 =over 4
18652
18653 =item B<interpolate()>
18654
18655 =back
18656
18657 =over 4
18658
18659 =item B<parse_paragraph()>
18660
18661 =back
18662
18663 =over 4
18664
18665 =item B<parse_from_filehandle()>
18666
18667 =back
18668
18669 =over 4
18670
18671 =item B<parse_from_file()>
18672
18673 =back
18674
18675 =over 4
18676
18677 =item ACCESSOR METHODS
18678
18679 =back
18680
18681 =over 4
18682
18683 =item B<errorsub()>
18684
18685 =back
18686
18687 =over 4
18688
18689 =item B<cutting()>
18690
18691 =back
18692
18693 =over 4
18694
18695 =item B<parseopts()>
18696
18697 =back
18698
18699 =over 4
18700
18701 =item B<output_file()>
18702
18703 =back
18704
18705 =over 4
18706
18707 =item B<output_handle()>
18708
18709 =back
18710
18711 =over 4
18712
18713 =item B<input_file()>
18714
18715 =back
18716
18717 =over 4
18718
18719 =item B<input_handle()>
18720
18721 =back
18722
18723 =over 4
18724
18725 =item B<input_streams()>
18726
18727 =back
18728
18729 =over 4
18730
18731 =item B<top_stream()>
18732
18733 =back
18734
18735 =over 4
18736
18737 =item PRIVATE METHODS AND DATA
18738
18739 =back
18740
18741 =over 4
18742
18743 =item B<_push_input_stream()>
18744
18745 =back
18746
18747 =over 4
18748
18749 =item B<_pop_input_stream()>
18750
18751 =back
18752
18753 =over 4
18754
18755 =item TREE-BASED PARSING
18756
18757 =item SEE ALSO
18758
18759 =item AUTHOR
18760
18761 =back
18762
18763 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18764
18765 =over 4
18766
18767 =item SYNOPSIS
18768
18769 =item DESCRIPTION
18770
18771 =item SEE ALSO
18772
18773 =item COPYRIGHT AND DISCLAIMERS
18774
18775 =item AUTHOR
18776
18777 =back
18778
18779 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18780
18781 =over 4
18782
18783 =item SYNOPSIS
18784
18785 =item DESCRIPTION
18786
18787 =item CAVEAT
18788
18789 =item SEE ALSO
18790
18791 =item COPYRIGHT AND DISCLAIMERS
18792
18793 =item AUTHOR
18794
18795 =back
18796
18797 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18798
18799 =over 4
18800
18801 =item SYNOPSIS
18802
18803 =item DESCRIPTION
18804
18805 =item CAVEAT
18806
18807 =item SEE ALSO
18808
18809 =item COPYRIGHT AND DISCLAIMERS
18810
18811 =item AUTHOR
18812
18813 =back
18814
18815 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18816
18817 =over 4
18818
18819 =item SYNOPSIS
18820
18821 =item DESCRIPTION
18822
18823 =item SEE ALSO
18824
18825 =item COPYRIGHT AND DISCLAIMERS
18826
18827 =item AUTHOR
18828
18829 =back
18830
18831 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18832
18833 =over 4
18834
18835 =item SYNOPSIS
18836
18837 =item DESCRIPTION
18838
18839 =item SEE ALSO
18840
18841 =item COPYRIGHT AND DISCLAIMERS
18842
18843 =item AUTHOR
18844
18845 =back
18846
18847 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18848
18849 =over 4
18850
18851 =item SYNOPSIS
18852
18853 =item DESCRIPTION
18854
18855 =item CAVEAT
18856
18857 =item SEE ALSO
18858
18859 =item COPYRIGHT AND DISCLAIMERS
18860
18861 =item AUTHOR
18862
18863 =back
18864
18865 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18866
18867 =over 4
18868
18869 =item SYNOPSIS
18870
18871 =item DESCRIPTION
18872
18873 =item SEE ALSO
18874
18875 =item AUTHOR
18876
18877 =back
18878
18879 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18880
18881 =over 4
18882
18883 =item SYNOPSIS
18884
18885 =item DESCRIPTION
18886
18887 =item SEE ALSO
18888
18889 =item COPYRIGHT AND DISCLAIMERS
18890
18891 =item AUTHOR
18892
18893 =back
18894
18895 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18896
18897 =over 4
18898
18899 =item SYNOPSIS
18900
18901 =item DESCRIPTION
18902
18903 alt, indent, loose, sentence, width
18904
18905 =item DIAGNOSTICS
18906
18907 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18908 Unknown sequence: %s, Unmatched =back
18909
18910 =item RESTRICTIONS
18911
18912 =item NOTES
18913
18914 =item SEE ALSO
18915
18916 =item AUTHOR
18917
18918 =back
18919
18920 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18921
18922 =over 4
18923
18924 =item SYNOPSIS
18925
18926 =item DESCRIPTION
18927
18928 =over 4
18929
18930 =item EXPORT
18931
18932 =back
18933
18934 =item AUTHOR
18935
18936 =item SEE ALSO
18937
18938 =back
18939
18940 =head2 Pod::Select, podselect() - extract selected sections of POD from
18941 input
18942
18943 =over 4
18944
18945 =item SYNOPSIS
18946
18947 =item REQUIRES
18948
18949 =item EXPORTS
18950
18951 =item DESCRIPTION
18952
18953 =item SECTION SPECIFICATIONS
18954
18955 =item RANGE SPECIFICATIONS
18956
18957 =back
18958
18959 =over 4
18960
18961 =item OBJECT METHODS
18962
18963 =back
18964
18965 =over 4
18966
18967 =item B<curr_headings()>
18968
18969 =back
18970
18971 =over 4
18972
18973 =item B<select()>
18974
18975 =back
18976
18977 =over 4
18978
18979 =item B<add_selection()>
18980
18981 =back
18982
18983 =over 4
18984
18985 =item B<clear_selections()>
18986
18987 =back
18988
18989 =over 4
18990
18991 =item B<match_section()>
18992
18993 =back
18994
18995 =over 4
18996
18997 =item B<is_selected()>
18998
18999 =back
19000
19001 =over 4
19002
19003 =item EXPORTED FUNCTIONS
19004
19005 =back
19006
19007 =over 4
19008
19009 =item B<podselect()>
19010
19011 B<-output>, B<-sections>, B<-ranges>
19012
19013 =back
19014
19015 =over 4
19016
19017 =item PRIVATE METHODS AND DATA
19018
19019 =back
19020
19021 =over 4
19022
19023 =item B<_compile_section_spec()>
19024
19025 =back
19026
19027 =over 4
19028
19029 =item $self->{_SECTION_HEADINGS}
19030
19031 =back
19032
19033 =over 4
19034
19035 =item $self->{_SELECTED_SECTIONS}
19036
19037 =back
19038
19039 =over 4
19040
19041 =item SEE ALSO
19042
19043 =item AUTHOR
19044
19045 =back
19046
19047 =head2 Pod::Text - Convert POD data to formatted ASCII text
19048
19049 =over 4
19050
19051 =item SYNOPSIS
19052
19053 =item DESCRIPTION
19054
19055 alt, code, indent, loose, margin, quotes, sentence, width
19056
19057 =item DIAGNOSTICS
19058
19059 Bizarre space in item, Item called without tag, Can't open %s for reading:
19060 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19061 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19062 Unmatched =back
19063
19064 =item RESTRICTIONS
19065
19066 =item NOTES
19067
19068 =item SEE ALSO
19069
19070 =item AUTHOR
19071
19072 =item COPYRIGHT AND LICENSE
19073
19074 =back
19075
19076 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19077
19078 =over 4
19079
19080 =item SYNOPSIS
19081
19082 =item DESCRIPTION
19083
19084 =item BUGS
19085
19086 =item SEE ALSO
19087
19088 =item AUTHOR
19089
19090 =item COPYRIGHT AND LICENSE
19091
19092 =back
19093
19094 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19095 text
19096
19097 =over 4
19098
19099 =item SYNOPSIS
19100
19101 =item DESCRIPTION
19102
19103 =item BUGS
19104
19105 =item SEE ALSO
19106
19107 =item AUTHOR
19108
19109 =item COPYRIGHT AND LICENSE
19110
19111 =back
19112
19113 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19114 escapes
19115
19116 =over 4
19117
19118 =item SYNOPSIS
19119
19120 =item DESCRIPTION
19121
19122 =item NOTES
19123
19124 =item SEE ALSO
19125
19126 =item AUTHOR
19127
19128 =item COPYRIGHT AND LICENSE
19129
19130 =back
19131
19132 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19133 documentation
19134
19135 =over 4
19136
19137 =item SYNOPSIS
19138
19139 =item ARGUMENTS
19140
19141 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
19142 C<-pathlist>
19143
19144 =item DESCRIPTION
19145
19146 =item EXAMPLES
19147
19148 =over 4
19149
19150 =item Recommended Use
19151
19152 =back
19153
19154 =item CAVEATS
19155
19156 =item AUTHOR
19157
19158 =item ACKNOWLEDGEMENTS
19159
19160 =back
19161
19162 =head2 SDBM_File - Tied access to sdbm files
19163
19164 =over 4
19165
19166 =item SYNOPSIS
19167
19168 =item DESCRIPTION
19169
19170 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19171
19172 =item DIAGNOSTICS
19173
19174 =over 4
19175
19176 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19177
19178 =back
19179
19180 =item BUGS AND WARNINGS
19181
19182 =back
19183
19184 =head2 Safe - Compile and execute code in restricted compartments
19185
19186 =over 4
19187
19188 =item SYNOPSIS
19189
19190 =item DESCRIPTION
19191
19192 a new namespace, an operator mask
19193
19194 =item WARNING
19195
19196 =over 4
19197
19198 =item RECENT CHANGES
19199
19200 =item Methods in class Safe
19201
19202 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
19203 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
19204 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
19205 root (NAMESPACE), mask (MASK)
19206
19207 =item Some Safety Issues
19208
19209 Memory, CPU, Snooping, Signals, State Changes
19210
19211 =item AUTHOR
19212
19213 =back
19214
19215 =back
19216
19217 =head2 Scalar::Util - A selection of general-utility scalar subroutines
19218
19219 =over 4
19220
19221 =item SYNOPSIS
19222
19223 =item DESCRIPTION
19224
19225 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
19226 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
19227 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
19228
19229 =item KNOWN BUGS
19230
19231 =item COPYRIGHT
19232
19233 =item BLATANT PLUG
19234
19235 =back
19236
19237 =head2 Search::Dict, look - search for key in dictionary file
19238
19239 =over 4
19240
19241 =item SYNOPSIS
19242
19243 =item DESCRIPTION
19244
19245 =back
19246
19247 =head2 SelectSaver - save and restore selected file handle
19248
19249 =over 4
19250
19251 =item SYNOPSIS
19252
19253 =item DESCRIPTION
19254
19255 =back
19256
19257 =head2 SelfLoader - load functions only on demand
19258
19259 =over 4
19260
19261 =item SYNOPSIS
19262
19263 =item DESCRIPTION
19264
19265 =over 4
19266
19267 =item The __DATA__ token
19268
19269 =item SelfLoader autoloading
19270
19271 =item Autoloading and package lexicals
19272
19273 =item SelfLoader and AutoLoader
19274
19275 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
19276
19277 =item Classes and inherited methods.
19278
19279 =back
19280
19281 =item Multiple packages and fully qualified subroutine names
19282
19283 =back
19284
19285 =head2 Shell - run shell commands transparently within perl
19286
19287 =over 4
19288
19289 =item SYNOPSIS
19290
19291 =item DESCRIPTION
19292
19293 =over 4
19294
19295 =item OBJECT ORIENTED SYNTAX
19296
19297 =back
19298
19299 =item AUTHOR
19300
19301 =back
19302
19303 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19304 socket.h defines and structure manipulators 
19305
19306 =over 4
19307
19308 =item SYNOPSIS
19309
19310 =item DESCRIPTION
19311
19312 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19313 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19314 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19315 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19316 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19317
19318 =back
19319
19320 =head2 Storable - persistence for Perl data structures
19321
19322 =over 4
19323
19324 =item SYNOPSIS
19325
19326 =item DESCRIPTION
19327
19328 =item MEMORY STORE
19329
19330 =item ADVISORY LOCKING
19331
19332 =item SPEED
19333
19334 =item CANONICAL REPRESENTATION
19335
19336 =item CODE REFERENCES
19337
19338 =item FORWARD COMPATIBILITY
19339
19340 utf8 data, restricted hashes, files from future versions of Storable
19341
19342 =item ERROR REPORTING
19343
19344 =item WIZARDS ONLY
19345
19346 =over 4
19347
19348 =item Hooks
19349
19350 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19351 I<serialized>, ..
19352
19353 =item Predicates
19354
19355 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19356 C<Storable::is_retrieving>
19357
19358 =item Recursion
19359
19360 =item Deep Cloning
19361
19362 =back
19363
19364 =item Storable magic
19365
19366 =item EXAMPLES
19367
19368 =item WARNING
19369
19370 =item BUGS
19371
19372 =over 4
19373
19374 =item 64 bit data in perl 5.6.0 and 5.6.1
19375
19376 =back
19377
19378 =item CREDITS
19379
19380 =item AUTHOR
19381
19382 =item SEE ALSO
19383
19384 =back
19385
19386 =head2 Switch - A switch statement for Perl
19387
19388 =over 4
19389
19390 =item VERSION
19391
19392 =item SYNOPSIS
19393
19394 =item BACKGROUND
19395
19396 =item DESCRIPTION
19397
19398 =over 4
19399
19400 =item Allowing fall-through
19401
19402 =item Automating fall-through
19403
19404 =item Alternative syntax
19405
19406 =item Higher-order Operations
19407
19408 =back
19409
19410 =item DEPENDENCIES
19411
19412 =item AUTHOR
19413
19414 =item BUGS
19415
19416 =item LIMITATION
19417
19418 =item COPYRIGHT
19419
19420 =back
19421
19422 =head2 Symbol - manipulate Perl symbols and their names
19423
19424 =over 4
19425
19426 =item SYNOPSIS
19427
19428 =item DESCRIPTION
19429
19430 =item BUGS
19431
19432 =back
19433
19434 =head2 Sys::Hostname - Try every conceivable way to get hostname
19435
19436 =over 4
19437
19438 =item SYNOPSIS
19439
19440 =item DESCRIPTION
19441
19442 =item AUTHOR
19443
19444 =back
19445
19446 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19447 interface to the UNIX syslog(3) calls
19448
19449 =over 4
19450
19451 =item SYNOPSIS
19452
19453 =item DESCRIPTION
19454
19455 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19456 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19457 in 5.004_02), closelog
19458
19459 =item EXAMPLES
19460
19461 =item SEE ALSO
19462
19463 =item AUTHOR
19464
19465 =back
19466
19467 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19468 Perl interface to the UNIX syslog(3) calls
19469
19470 =over 4
19471
19472 =item SYNOPSIS
19473
19474 =item DESCRIPTION
19475
19476 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19477 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19478 in 5.004_02), closelog
19479
19480 =item EXAMPLES
19481
19482 =item SEE ALSO
19483
19484 =item AUTHOR
19485
19486 =back
19487
19488 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19489
19490 =over 4
19491
19492 =item SYNOPSIS
19493
19494 =item DESCRIPTION
19495
19496 =item DIAGNOSTICS
19497
19498 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19499 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19500 comma allowed after filehandle, No name for escape sequence %s
19501
19502 =item ENVIRONMENT
19503
19504 ANSI_COLORS_DISABLED
19505
19506 =item RESTRICTIONS
19507
19508 =item NOTES
19509
19510 =item SEE ALSO
19511
19512 =item AUTHORS
19513
19514 =item COPYRIGHT AND LICENSE
19515
19516 =back
19517
19518 =head2 Term::Cap - Perl termcap interface
19519
19520 =over 4
19521
19522 =item SYNOPSIS
19523
19524 =item DESCRIPTION
19525
19526 =over 4
19527
19528 =item METHODS
19529
19530 =back
19531
19532 =back
19533
19534 B<Tgetent>, OSPEED, TERM
19535
19536 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19537
19538 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19539
19540 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19541
19542 B<Trequire>
19543
19544 =over 4
19545
19546 =item EXAMPLES
19547
19548 =item COPYRIGHT AND LICENSE
19549
19550 =item AUTHOR
19551
19552 =item SEE ALSO
19553
19554 =back
19555
19556 =head2 Term::Complete - Perl word completion module
19557
19558 =over 4
19559
19560 =item SYNOPSIS
19561
19562 =item DESCRIPTION
19563
19564 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19565
19566 =item DIAGNOSTICS
19567
19568 =item BUGS
19569
19570 =item AUTHOR
19571
19572 =back
19573
19574 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19575 If no real package is found, substitutes stubs instead of basic functions.
19576
19577 =over 4
19578
19579 =item SYNOPSIS
19580
19581 =item DESCRIPTION
19582
19583 =item Minimal set of supported functions
19584
19585 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19586 C<findConsole>, Attribs, C<Features>
19587
19588 =item Additional supported functions
19589
19590 C<tkRunning>, C<ornaments>, C<newTTY>
19591
19592 =item EXPORTS
19593
19594 =item ENVIRONMENT
19595
19596 =item CAVEATS
19597
19598 =back
19599
19600 =head2 Test - provides a simple framework for writing test scripts
19601
19602 =over 4
19603
19604 =item SYNOPSIS
19605
19606 =item DESCRIPTION
19607
19608 =item QUICK START GUIDE
19609
19610 =over 4
19611
19612 =item Functions
19613
19614 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19615 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19616
19617 =back
19618
19619 =back
19620
19621 B<_to_value>
19622
19623 C<ok(...)>
19624
19625 C<skip(I<skip_if_true>, I<args...>)>
19626
19627 =over 4
19628
19629 =item TEST TYPES
19630
19631 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19632
19633 =item ONFAIL
19634
19635 =item BUGS and CAVEATS
19636
19637 =item NOTE
19638
19639 =item SEE ALSO
19640
19641 =item AUTHOR
19642
19643 =back
19644
19645 =head2 Test::Builder - Backend for building test libraries
19646
19647 =over 4
19648
19649 =item SYNOPSIS
19650
19651 =item DESCRIPTION
19652
19653 =over 4
19654
19655 =item Construction
19656
19657 B<new>
19658
19659 =back
19660
19661 =back
19662
19663 =over 4
19664
19665 =item Setting up tests
19666
19667 B<exported_to>
19668
19669 =back
19670
19671 B<plan>
19672
19673 B<expected_tests>
19674
19675 B<no_plan>
19676
19677 B<has_plan>
19678
19679 B<skip_all>
19680
19681 =over 4
19682
19683 =item Running tests
19684
19685 B<ok>
19686
19687 =back
19688
19689 B<is_eq>, B<is_num>
19690
19691 B<isnt_eq>, B<isnt_num>
19692
19693 B<like>, B<unlike>
19694
19695 B<maybe_regex>
19696
19697 B<cmp_ok>
19698
19699 B<BAILOUT>
19700
19701 B<skip>
19702
19703 B<todo_skip>
19704
19705 B<skip_rest>
19706
19707 =over 4
19708
19709 =item Test style
19710
19711 B<level>
19712
19713 =back
19714
19715 B<use_numbers>
19716
19717 B<no_header>, B<no_ending>
19718
19719 =over 4
19720
19721 =item Output
19722
19723 B<diag>
19724
19725 =back
19726
19727 B<_print>
19728
19729 B<output>, B<failure_output>, B<todo_output>
19730
19731 =over 4
19732
19733 =item Test Status and Info
19734
19735 B<current_test>
19736
19737 =back
19738
19739 B<summary>
19740
19741 B<details>
19742
19743 B<todo>
19744
19745 B<caller>
19746
19747 B<_sanity_check>
19748
19749 B<_whoa>
19750
19751 B<_my_exit>
19752
19753 =over 4
19754
19755 =item THREADS
19756
19757 =item EXAMPLES
19758
19759 =item SEE ALSO
19760
19761 =item AUTHORS
19762
19763 =item COPYRIGHT
19764
19765 =back
19766
19767 =head2 Test::Harness - run perl standard test scripts with statistics
19768
19769 =over 4
19770
19771 =item SYNOPSIS
19772
19773 =item DESCRIPTION
19774
19775 =over 4
19776
19777 =item The test script output
19778
19779 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19780 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19781 else>
19782
19783 =item Taint mode
19784
19785 =item Configuration variables.
19786
19787 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19788
19789 =item Failure
19790
19791 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19792 Failed>
19793
19794 =item Functions
19795
19796 B<runtests>
19797
19798 =back
19799
19800 =back
19801
19802 B<_all_ok>
19803
19804 B<_globdir>
19805
19806 B<_run_all_tests>
19807
19808 B<_mk_leader>
19809
19810 B<_leader_width>
19811
19812 =over 4
19813
19814 =item EXPORT
19815
19816 =item DIAGNOSTICS
19817
19818 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19819 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19820 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19821 %s>, C<FAILED--Further testing stopped: %s>
19822
19823 =item ENVIRONMENT
19824
19825 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19826 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19827 C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19828
19829 =item EXAMPLE
19830
19831 =item SEE ALSO
19832
19833 =item AUTHORS
19834
19835 =item LICENSE
19836
19837 =item TODO
19838
19839 =item BUGS
19840
19841 =back
19842
19843 =head2 Test::Harness::Assert - simple assert
19844
19845 =over 4
19846
19847 =item SYNOPSIS
19848
19849 =item DESCRIPTION
19850
19851 =over 4
19852
19853 =item Functions
19854
19855 B<assert>
19856
19857 =back
19858
19859 =back
19860
19861 =over 4
19862
19863 =item AUTHOR
19864
19865 =item SEE ALSO
19866
19867 =back
19868
19869 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19870
19871 =over 4
19872
19873 =item SYNOPSIS
19874
19875 =item DESCRIPTION
19876
19877 =back
19878
19879 =head2 Test::Harness::Straps - detailed analysis of test results
19880
19881 =over 4
19882
19883 =item SYNOPSIS
19884
19885 =item DESCRIPTION
19886
19887 =item Construction
19888
19889 =over 4
19890
19891 =item C<new>
19892
19893 =back
19894
19895 =back
19896
19897 =over 4
19898
19899 =item C<_init>
19900
19901 =back
19902
19903 =over 4
19904
19905 =item Analysis
19906
19907 =over 4
19908
19909 =item C<analyze>
19910
19911 =back
19912
19913 =back
19914
19915 =over 4
19916
19917 =item C<analyze_fh>
19918
19919 =back
19920
19921 =over 4
19922
19923 =item C<analyze_file>
19924
19925 =back
19926
19927 =over 4
19928
19929 =item C<_switches>
19930
19931 =back
19932
19933 =over 4
19934
19935 =item C<_INC2PERL5LIB>
19936
19937 =back
19938
19939 =over 4
19940
19941 =item C<_filtered_INC>
19942
19943 =back
19944
19945 =over 4
19946
19947 =item C<_restore_PERL5LIB>
19948
19949 =back
19950
19951 =over 4
19952
19953 =item Parsing
19954
19955 =over 4
19956
19957 =item C<_is_comment>
19958
19959 =back
19960
19961 =back
19962
19963 =over 4
19964
19965 =item C<_is_header>
19966
19967 =back
19968
19969 =over 4
19970
19971 =item C<_is_test>
19972
19973 =back
19974
19975 =over 4
19976
19977 =item C<_is_bail_out>
19978
19979 =back
19980
19981 =over 4
19982
19983 =item C<_reset_file_state>
19984
19985 =back
19986
19987 =over 4
19988
19989 =item Results
19990
19991 =over 4
19992
19993 =item C<_detailize>
19994
19995 =back
19996
19997 =back
19998
19999 =over 4
20000
20001 =item EXAMPLES
20002
20003 =item AUTHOR
20004
20005 =item SEE ALSO
20006
20007 =back
20008
20009 =head2 Test::More - yet another framework for writing test scripts
20010
20011 =over 4
20012
20013 =item SYNOPSIS
20014
20015 =item DESCRIPTION
20016
20017 =over 4
20018
20019 =item I love it when a plan comes together
20020
20021 =back
20022
20023 =back
20024
20025 =over 4
20026
20027 =item Test names
20028
20029 =item I'm ok, you're not ok.
20030
20031 B<ok>
20032
20033 =back
20034
20035 B<is>, B<isnt>
20036
20037 B<like>
20038
20039 B<unlike>
20040
20041 B<cmp_ok>
20042
20043 B<can_ok>
20044
20045 B<isa_ok>
20046
20047 B<pass>, B<fail>
20048
20049 =over 4
20050
20051 =item Diagnostics
20052
20053 B<diag>
20054
20055 =back
20056
20057 =over 4
20058
20059 =item Module tests
20060
20061 B<use_ok>
20062
20063 =back
20064
20065 B<require_ok>
20066
20067 =over 4
20068
20069 =item Conditional tests
20070
20071 B<SKIP: BLOCK>
20072
20073 =back
20074
20075 B<TODO: BLOCK>, B<todo_skip>
20076
20077 When do I use SKIP vs. TODO?
20078
20079 =over 4
20080
20081 =item Comparison functions
20082
20083 B<is_deeply>
20084
20085 =back
20086
20087 B<eq_array>
20088
20089 B<eq_hash>
20090
20091 B<eq_set>
20092
20093 =over 4
20094
20095 =item Extending and Embedding Test::More
20096
20097 B<builder>
20098
20099 =back
20100
20101 =over 4
20102
20103 =item NOTES
20104
20105 =item BUGS and CAVEATS
20106
20107 Making your own ok(), The eq_* family has some caveats, Test::Harness
20108 upgrades
20109
20110 =item HISTORY
20111
20112 =item SEE ALSO
20113
20114 =item AUTHORS
20115
20116 =item COPYRIGHT
20117
20118 =back
20119
20120 =head2 Test::Simple - Basic utilities for writing tests.
20121
20122 =over 4
20123
20124 =item SYNOPSIS
20125
20126 =item DESCRIPTION
20127
20128 B<ok>
20129
20130 =back
20131
20132 =over 4
20133
20134 =item EXAMPLE
20135
20136 =item CAVEATS
20137
20138 =item NOTES
20139
20140 =item HISTORY
20141
20142 =item SEE ALSO
20143
20144 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
20145 L<Test::Harness>
20146
20147 =item AUTHORS
20148
20149 =item COPYRIGHT
20150
20151 =back
20152
20153 =head2 Test::Tutorial - A tutorial about writing really basic tests
20154
20155 =over 4
20156
20157 =item DESCRIPTION
20158
20159 =over 4
20160
20161 =item Nuts and bolts of testing.
20162
20163 =item Where to start?
20164
20165 =item Names
20166
20167 =item Test the manual
20168
20169 =item Sometimes the tests are wrong
20170
20171 =item Testing lots of values
20172
20173 =item Informative names
20174
20175 =item Skipping tests
20176
20177 =item Todo tests
20178
20179 =item Testing with taint mode.
20180
20181 =back
20182
20183 =item FOOTNOTES
20184
20185 =item AUTHORS
20186
20187 =item COPYRIGHT
20188
20189 =back
20190
20191 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
20192
20193 =over 4
20194
20195 =item SYNOPSIS
20196
20197 =item DESCRIPTION
20198
20199 =item EXAMPLE
20200
20201 =back
20202
20203 =head2 Text::Balanced - Extract delimited text sequences from strings.
20204
20205 =over 4
20206
20207 =item SYNOPSIS
20208
20209 =item DESCRIPTION
20210
20211 =over 4
20212
20213 =item General behaviour in list contexts
20214
20215 [0], [1], [2]
20216
20217 =item General behaviour in scalar and void contexts
20218
20219 =item A note about prefixes
20220
20221 =item C<extract_delimited>
20222
20223 =item C<extract_bracketed>
20224
20225 =item C<extract_variable>
20226
20227 [0], [1], [2]
20228
20229 =item C<extract_tagged>
20230
20231 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
20232 [0], [1], [2], [3], [4], [5]
20233
20234 =item C<gen_extract_tagged>
20235
20236 =item C<extract_quotelike>
20237
20238 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
20239
20240 =item C<extract_quotelike> and "here documents"
20241
20242 [0], [1], [2], [3], [4], [5], [6], [7..10]
20243
20244 =item C<extract_codeblock>
20245
20246 =item C<extract_multiple>
20247
20248 =item C<gen_delimited_pat>
20249
20250 =back
20251
20252 =item DIAGNOSTICS
20253
20254  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
20255 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
20256 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
20257 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
20258 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
20259 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
20260 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
20261 after dereferencer>, C<Did not find expected opening bracket at %s>,
20262 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
20263 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
20264 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
20265 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
20266 tag>
20267
20268 =item AUTHOR
20269
20270 =item BUGS AND IRRITATIONS
20271
20272 =item COPYRIGHT
20273
20274 =back
20275
20276 =head2 Text::ParseWords - parse text into an array of tokens or array of
20277 arrays
20278
20279 =over 4
20280
20281 =item SYNOPSIS
20282
20283 =item DESCRIPTION
20284
20285 =item EXAMPLES
20286
20287 =item AUTHORS
20288
20289 =back
20290
20291 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20292 by Knuth
20293
20294 =over 4
20295
20296 =item SYNOPSIS
20297
20298 =item DESCRIPTION
20299
20300 =item EXAMPLES
20301
20302 =item LIMITATIONS
20303
20304 =item AUTHOR
20305
20306 =back
20307
20308 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20309 unexpand(1)
20310
20311 =over 4
20312
20313 =item SYNOPSIS
20314
20315 =item DESCRIPTION
20316
20317 =item BUGS
20318
20319 =item AUTHOR
20320
20321 =back
20322
20323 =head2 Text::Wrap - line wrapping to form simple paragraphs
20324
20325 =over 4
20326
20327 =item SYNOPSIS 
20328
20329 =item DESCRIPTION
20330
20331 =item OVERRIDES
20332
20333 =item EXAMPLE
20334
20335 =item AUTHOR
20336
20337 =back
20338
20339 =head2 Thread - manipulate threads in Perl (for old code only)
20340
20341 =over 4
20342
20343 =item CAVEAT
20344
20345 =item SYNOPSIS
20346
20347 =item DESCRIPTION
20348
20349 =item FUNCTIONS
20350
20351 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20352 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20353 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20354
20355 =item METHODS
20356
20357 join, eval, detach, equal, tid, flags, done
20358
20359 =item LIMITATIONS
20360
20361 =item SEE ALSO
20362
20363 =back
20364
20365 =head2 Thread::Queue - thread-safe queues
20366
20367 =over 4
20368
20369 =item SYNOPSIS
20370
20371 =item DESCRIPTION
20372
20373 =item FUNCTIONS AND METHODS
20374
20375 new, enqueue LIST, dequeue, dequeue_nb, pending
20376
20377 =item SEE ALSO
20378
20379 =back
20380
20381 =head2 Thread::Semaphore - thread-safe semaphores
20382
20383 =over 4
20384
20385 =item SYNOPSIS
20386
20387 =item DESCRIPTION
20388
20389 =item FUNCTIONS AND METHODS
20390
20391 new, new NUMBER, down, down NUMBER, up, up NUMBER
20392
20393 =back
20394
20395 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20396 (for old code)
20397
20398 =over 4
20399
20400 =item CAVEAT
20401
20402 =item SYNOPSIS
20403
20404 =item DESCRIPTION
20405
20406 =item BUGS
20407
20408 =back
20409
20410 =head2 Thread::Specific - thread-specific keys
20411
20412 =over 4
20413
20414 =item SYNOPSIS
20415
20416 =item DESCRIPTION
20417
20418 =back
20419
20420 =head2 Tie::Array - base class for tied arrays
20421
20422 =over 4
20423
20424 =item SYNOPSIS
20425
20426 =item DESCRIPTION
20427
20428 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20429 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20430 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20431 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20432
20433 =item CAVEATS
20434
20435 =item AUTHOR
20436
20437 =back
20438
20439 =head2 Tie::File - Access the lines of a disk file via a Perl array
20440
20441 =over 4
20442
20443 =item SYNOPSIS
20444
20445 =item DESCRIPTION
20446
20447 =over 4
20448
20449 =item C<recsep>
20450
20451 =item C<autochomp>
20452
20453 =item C<mode>
20454
20455 =item C<memory>
20456
20457 =item C<dw_size>
20458
20459 =item Option Format
20460
20461 =back
20462
20463 =item Public Methods
20464
20465 =over 4
20466
20467 =item C<flock>
20468
20469 =item C<autochomp>
20470
20471 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20472
20473 =item C<offset>
20474
20475 =back
20476
20477 =item Tying to an already-opened filehandle
20478
20479 =item Deferred Writing
20480
20481 =over 4
20482
20483 =item Autodeferring
20484
20485 =back
20486
20487 =item CONCURRENT ACCESS TO FILES
20488
20489 =item CAVEATS
20490
20491 =item SUBCLASSING
20492
20493 =item WHAT ABOUT C<DB_File>?
20494
20495 =item AUTHOR
20496
20497 =item LICENSE
20498
20499 =item WARRANTY
20500
20501 =item THANKS
20502
20503 =item TODO
20504
20505 =back
20506
20507 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20508 handles
20509
20510 =over 4
20511
20512 =item SYNOPSIS
20513
20514 =item DESCRIPTION
20515
20516 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20517 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20518 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20519 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20520
20521 =item MORE INFORMATION
20522
20523 =item COMPATIBILITY
20524
20525 =back
20526
20527 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20528 tied hashes
20529
20530 =over 4
20531
20532 =item SYNOPSIS
20533
20534 =item DESCRIPTION
20535
20536 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20537 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20538
20539 =item Inheriting from B<Tie::StdHash>
20540
20541 =item Inheriting from B<Tie::ExtraHash>
20542
20543 =item C<UNTIE> and C<DESTROY>
20544
20545 =item MORE INFORMATION
20546
20547 =back
20548
20549 =head2 Tie::Memoize - add data to hash when needed
20550
20551 =over 4
20552
20553 =item SYNOPSIS
20554
20555 =item DESCRIPTION
20556
20557 =item Inheriting from B<Tie::Memoize>
20558
20559 =item EXAMPLE
20560
20561 =item BUGS
20562
20563 =item AUTHOR
20564
20565 =back
20566
20567 =head2 Tie::RefHash - use references as hash keys
20568
20569 =over 4
20570
20571 =item SYNOPSIS
20572
20573 =item DESCRIPTION
20574
20575 =item EXAMPLE
20576
20577 =item AUTHOR
20578
20579 =item VERSION
20580
20581 =item SEE ALSO
20582
20583 =back
20584
20585 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20586 scalars
20587
20588 =over 4
20589
20590 =item SYNOPSIS
20591
20592 =item DESCRIPTION
20593
20594 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20595
20596 =item MORE INFORMATION
20597
20598 =back
20599
20600 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20601
20602 =over 4
20603
20604 =item SYNOPSIS
20605
20606 =item DESCRIPTION
20607
20608 =item CAVEATS
20609
20610 =back
20611
20612 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20613 timers
20614
20615 =over 4
20616
20617 =item SYNOPSIS
20618
20619 =item DESCRIPTION
20620
20621 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20622 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20623 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
20624 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
20625 $which )
20626
20627 =item EXAMPLES
20628
20629 =item C API
20630
20631 =item DIAGNOSTICS
20632
20633 =over 4
20634
20635 =item negative time not invented yet
20636
20637 =item internal error: useconds < 0 (unsigned ... signed ...)
20638
20639 =back
20640
20641 =item CAVEATS
20642
20643 =item AUTHORS
20644
20645 =item COPYRIGHT AND LICENSE
20646
20647 =back
20648
20649 =head2 Time::Local - efficiently compute time from local and GMT time
20650
20651 =over 4
20652
20653 =item SYNOPSIS
20654
20655 =item DESCRIPTION
20656
20657 =item IMPLEMENTATION
20658
20659 =item BUGS
20660
20661 =item SUPPORT
20662
20663 =item AUTHOR
20664
20665 =back
20666
20667 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20668 function
20669
20670 =over 4
20671
20672 =item SYNOPSIS
20673
20674 =item DESCRIPTION
20675
20676 =item NOTE
20677
20678 =item AUTHOR
20679
20680 =back
20681
20682 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20683 function
20684
20685 =over 4
20686
20687 =item SYNOPSIS
20688
20689 =item DESCRIPTION
20690
20691 =item NOTE
20692
20693 =item AUTHOR
20694
20695 =back
20696
20697 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20698
20699 =over 4
20700
20701 =item SYNOPSIS
20702
20703 =item DESCRIPTION
20704
20705 =item AUTHOR
20706
20707 =back
20708
20709 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20710
20711 =over 4
20712
20713 =item SYNOPSIS
20714
20715 =item DESCRIPTION
20716
20717 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20718 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20719 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20720
20721 =item EXPORTS
20722
20723 =back
20724
20725 =head2 Unicode::Collate - Unicode Collation Algorithm
20726
20727 =over 4
20728
20729 =item SYNOPSIS
20730
20731 =item DESCRIPTION
20732
20733 =over 4
20734
20735 =item Constructor and Tailoring
20736
20737 UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
20738 normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
20739 undefName, undefChar, katakana_before_hiragana, upper_before_lower
20740
20741 =item Methods for Collation
20742
20743 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20744 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20745 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20746 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20747 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20748 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20749 $Collator-E<gt>viewSortKey($string)>
20750
20751 =item Methods for Searching
20752
20753 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20754 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20755 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20756 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20757 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20758 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20759 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20760
20761 =item Other Methods
20762
20763 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
20764 Base_Unicode_Version
20765
20766 =item EXPORT
20767
20768 =item CAVEAT
20769
20770 =item Conformance Test
20771
20772 =back
20773
20774 =item AUTHOR
20775
20776 =item SEE ALSO
20777
20778 http://www.unicode.org/reports/tr10/,
20779 http://www.unicode.org/reports/tr10/allkeys.txt,
20780 http://www.unicode.org/reports/tr10/CollationTest.html
20781 http://www.unicode.org/reports/tr10/CollationTest.zip,
20782 http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
20783
20784 =back
20785
20786 =head2 Unicode::Normalize - Unicode Normalization Forms
20787
20788 =over 4
20789
20790 =item SYNOPSIS
20791
20792 =item DESCRIPTION
20793
20794 =over 4
20795
20796 =item Normalization Forms
20797
20798 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20799 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20800 C<$normalized_string = normalize($form_name, $string)>
20801
20802 =item Decomposition and Composition
20803
20804 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20805 decompose($string, $useCompatMapping)>, C<$reordered_string  =
20806 reorder($string)>, C<$composed_string   = compose($string)>
20807
20808 =item Quick Check
20809
20810 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20811 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20812 check($form_name, $string)>
20813
20814 =item Character Data
20815
20816 C<$canonical_decomposed = getCanon($codepoint)>,
20817 C<$compatibility_decomposed = getCompat($codepoint)>,
20818 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20819 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20820 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20821 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20822 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20823
20824 =item EXPORT
20825
20826 =back
20827
20828 =item AUTHOR
20829
20830 =item SEE ALSO
20831
20832 http://www.unicode.org/unicode/reports/tr15/,
20833 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
20834
20835 =back
20836
20837 =head2 Unicode::UCD - Unicode character database
20838
20839 =over 4
20840
20841 =item SYNOPSIS
20842
20843 =item DESCRIPTION
20844
20845 =back
20846
20847 =over 4
20848
20849 =item charinfo
20850
20851 =back
20852
20853 =over 4
20854
20855 =item charblock
20856
20857 =back
20858
20859 =over 4
20860
20861 =item charscript
20862
20863 =back
20864
20865 =over 4
20866
20867 =item charblocks
20868
20869 =back
20870
20871 =over 4
20872
20873 =item charscripts
20874
20875 =back
20876
20877 =over 4
20878
20879 =item Blocks versus Scripts
20880
20881 =item Matching Scripts and Blocks
20882
20883 =item Code Point Arguments
20884
20885 =item charinrange
20886
20887 =back
20888
20889 =over 4
20890
20891 =item compexcl
20892
20893 =back
20894
20895 =over 4
20896
20897 =item casefold
20898
20899 =back
20900
20901 =over 4
20902
20903 =item casespec
20904
20905 =back
20906
20907 =over 4
20908
20909 =item Unicode::UCD::UnicodeVersion
20910
20911 =back
20912
20913 =over 4
20914
20915 =item Implementation Note
20916
20917 =back
20918
20919 =over 4
20920
20921 =item BUGS
20922
20923 =item AUTHOR
20924
20925 =back
20926
20927 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20928 functions
20929
20930 =over 4
20931
20932 =item SYNOPSIS
20933
20934 =item DESCRIPTION
20935
20936 =item NOTE
20937
20938 =item AUTHOR
20939
20940 =back
20941
20942 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20943 functions
20944
20945 =over 4
20946
20947 =item SYNOPSIS
20948
20949 =item DESCRIPTION
20950
20951 =over 4
20952
20953 =item System Specifics
20954
20955 =back
20956
20957 =item NOTE
20958
20959 =item AUTHOR
20960
20961 =item HISTORY
20962
20963 March 18th, 2000
20964
20965 =back
20966
20967 =head2 Win32 - Interfaces to some Win32 API Functions
20968
20969 =over 4
20970
20971 =item DESCRIPTION
20972
20973 =over 4
20974
20975 =item Alphabetical Listing of Win32 Functions
20976
20977 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20978 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20979 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20980 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20981 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20982 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20983 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20984 Win32::GetOSVersion(), Win32::GetOSName(),
20985 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20986 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20987 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20988 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20989 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20990 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20991 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20992 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20993 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
20994 Win32::UnregisterServer(LIBRARYNAME)
20995
20996 =back
20997
20998 =back
20999
21000 =head2 XSLoader - Dynamically load C libraries into Perl code
21001
21002 =over 4
21003
21004 =item SYNOPSIS
21005
21006 =item DESCRIPTION
21007
21008 =over 4
21009
21010 =item Migration from C<DynaLoader>
21011
21012 =item Backward compatible boilerplate
21013
21014 =back
21015
21016 =item Order of initialization: early load()
21017
21018 =over 4
21019
21020 =item The most hairy case
21021
21022 =back
21023
21024 =item LIMITATIONS
21025
21026 =item AUTHOR
21027
21028 =back
21029
21030 =head1 AUXILIARY DOCUMENTATION
21031
21032 Here should be listed all the extra programs' documentation, but they
21033 don't all have manual pages yet:
21034
21035 =over 4
21036
21037 =item a2p
21038
21039 =item c2ph
21040
21041 =item dprofpp
21042
21043 =item h2ph
21044
21045 =item h2xs
21046
21047 =item perlbug
21048
21049 =item perldoc
21050
21051 =item pl2pm
21052
21053 =item pod2html
21054
21055 =item pod2man
21056
21057 =item s2p
21058
21059 =item splain
21060
21061 =item xsubpp
21062
21063 =back
21064
21065 =head1 AUTHOR
21066
21067 Larry Wall <F<larry@wall.org>>, with the help of oodles
21068 of other folks.
21069