Update perl591delta. Include a small to-do list in it.
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
1
2 # !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
3 # This file is autogenerated by buildtoc from all the other pods.
4 # Edit those files and run buildtoc --build-toc to effect changes.
5
6 =head1 NAME
7
8 perltoc - perl documentation table of contents
9
10 =head1 DESCRIPTION
11
12 This page provides a brief table of contents for the rest of the Perl
13 documentation set.  It is meant to be scanned quickly or grepped
14 through to locate the proper section you're looking for.
15
16 =head1 BASIC DOCUMENTATION
17
18 =head2 perl - Practical Extraction and Report Language
19
20 =over 4
21
22 =item SYNOPSIS
23
24 =over 4
25
26 =item Overview
27
28 =item Tutorials
29
30 =item Reference Manual
31
32 =item Internals and C Language Interface
33
34 =item Miscellaneous
35
36 =item Language-Specific
37
38 =item Platform-Specific
39
40 =back
41
42 =item DESCRIPTION
43
44 =item AVAILABILITY
45
46 =item ENVIRONMENT
47
48 =item AUTHOR
49
50 =item FILES
51
52 =item SEE ALSO
53
54 =item DIAGNOSTICS
55
56 =item BUGS
57
58 =item NOTES
59
60 =back
61
62 =head2 perlintro -- a brief introduction and overview of Perl
63
64 =over 4
65
66 =item DESCRIPTION
67
68 =over 4
69
70 =item What is Perl?
71
72 =item Running Perl programs
73
74 =item Basic syntax overview
75
76 =item Perl variable types
77
78 Scalars, Arrays, Hashes
79
80 =item Variable scoping
81
82 =item Conditional and looping constructs
83
84 if, while, for, foreach
85
86 =item Builtin operators and functions
87
88 Arithmetic, Numeric comparison, String comparison, Boolean logic,
89 Miscellaneous
90
91 =item Files and I/O
92
93 =item Regular expressions
94
95 Simple matching, Simple substitution, More complex regular expressions,
96 Parentheses for capturing, Other regexp features
97
98 =item Writing subroutines
99
100 =item OO Perl
101
102 =item Using Perl modules
103
104 =back
105
106 =item AUTHOR
107
108 =back
109
110 =head2 perlreftut - Mark's very short tutorial about references
111
112 =over 4
113
114 =item DESCRIPTION
115
116 =item Who Needs Complicated Data Structures?
117
118 =item The Solution
119
120 =item Syntax
121
122 =over 4
123
124 =item Making References
125
126 =item Using References
127
128 =item An Example
129
130 =item Arrow Rule
131
132 =back
133
134 =item Solution
135
136 =item The Rest
137
138 =item Summary
139
140 =item Credits
141
142 =over 4
143
144 =item Distribution Conditions
145
146 =back
147
148 =back
149
150 =head2 perldsc - Perl Data Structures Cookbook
151
152 =over 4
153
154 =item DESCRIPTION
155
156 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
157 more elaborate constructs
158
159 =item REFERENCES
160
161 =item COMMON MISTAKES
162
163 =item CAVEAT ON PRECEDENCE
164
165 =item WHY YOU SHOULD ALWAYS C<use strict>
166
167 =item DEBUGGING
168
169 =item CODE EXAMPLES
170
171 =item ARRAYS OF ARRAYS
172
173 =over 4
174
175 =item Declaration of an ARRAY OF ARRAYS
176
177 =item Generation of an ARRAY OF ARRAYS
178
179 =item Access and Printing of an ARRAY OF ARRAYS
180
181 =back
182
183 =item HASHES OF ARRAYS
184
185 =over 4
186
187 =item Declaration of a HASH OF ARRAYS
188
189 =item Generation of a HASH OF ARRAYS
190
191 =item Access and Printing of a HASH OF ARRAYS
192
193 =back
194
195 =item ARRAYS OF HASHES
196
197 =over 4
198
199 =item Declaration of an ARRAY OF HASHES
200
201 =item Generation of an ARRAY OF HASHES
202
203 =item Access and Printing of an ARRAY OF HASHES
204
205 =back
206
207 =item HASHES OF HASHES
208
209 =over 4
210
211 =item Declaration of a HASH OF HASHES
212
213 =item Generation of a HASH OF HASHES
214
215 =item Access and Printing of a HASH OF HASHES
216
217 =back
218
219 =item MORE ELABORATE RECORDS
220
221 =over 4
222
223 =item Declaration of MORE ELABORATE RECORDS
224
225 =item Declaration of a HASH OF COMPLEX RECORDS
226
227 =item Generation of a HASH OF COMPLEX RECORDS
228
229 =back
230
231 =item Database Ties
232
233 =item SEE ALSO
234
235 =item AUTHOR
236
237 =back
238
239 =head2 perllol - Manipulating Arrays of Arrays in Perl
240
241 =over 4
242
243 =item DESCRIPTION
244
245 =over 4
246
247 =item Declaration and Access of Arrays of Arrays
248
249 =item Growing Your Own
250
251 =item Access and Printing
252
253 =item Slices
254
255 =back
256
257 =item SEE ALSO
258
259 =item AUTHOR
260
261 =back
262
263 =head2 perlrequick - Perl regular expressions quick start
264
265 =over 4
266
267 =item DESCRIPTION
268
269 =item The Guide
270
271 =over 4
272
273 =item Simple word matching
274
275 =item Using character classes
276
277 =item Matching this or that
278
279 =item Grouping things and hierarchical matching
280
281 =item Extracting matches
282
283 =item Matching repetitions
284
285 =item More matching
286
287 =item Search and replace
288
289 =item The split operator
290
291 =back
292
293 =item BUGS
294
295 =item SEE ALSO
296
297 =item AUTHOR AND COPYRIGHT
298
299 =over 4
300
301 =item Acknowledgments
302
303 =back
304
305 =back
306
307 =head2 perlretut - Perl regular expressions tutorial
308
309 =over 4
310
311 =item DESCRIPTION
312
313 =item Part 1: The basics
314
315 =over 4
316
317 =item Simple word matching
318
319 =item Using character classes
320
321 =item Matching this or that
322
323 =item Grouping things and hierarchical matching
324
325 =item Extracting matches
326
327 =item Matching repetitions
328
329 =item Building a regexp
330
331 =item Using regular expressions in Perl
332
333 =back
334
335 =item Part 2: Power tools
336
337 =over 4
338
339 =item More on characters, strings, and character classes
340
341 =item Compiling and saving regular expressions
342
343 =item Embedding comments and modifiers in a regular expression
344
345 =item Non-capturing groupings
346
347 =item Looking ahead and looking behind
348
349 =item Using independent subexpressions to prevent backtracking
350
351 =item Conditional expressions
352
353 =item A bit of magic: executing Perl code in a regular expression
354
355 =item Pragmas and debugging
356
357 =back
358
359 =item BUGS
360
361 =item SEE ALSO
362
363 =item AUTHOR AND COPYRIGHT
364
365 =over 4
366
367 =item Acknowledgments
368
369 =back
370
371 =back
372
373 =head2 perlboot - Beginner's Object-Oriented Tutorial
374
375 =over 4
376
377 =item DESCRIPTION
378
379 =over 4
380
381 =item If we could talk to the animals...
382
383 =item Introducing the method invocation arrow
384
385 =item Invoking a barnyard
386
387 =item The extra parameter of method invocation
388
389 =item Calling a second method to simplify things
390
391 =item Inheriting the windpipes
392
393 =item A few notes about @ISA
394
395 =item Overriding the methods
396
397 =item Starting the search from a different place
398
399 =item The SUPER way of doing things
400
401 =item Where we're at so far...
402
403 =item A horse is a horse, of course of course -- or is it?
404
405 =item Invoking an instance method
406
407 =item Accessing the instance data
408
409 =item How to build a horse
410
411 =item Inheriting the constructor
412
413 =item Making a method work with either classes or instances
414
415 =item Adding parameters to a method
416
417 =item More interesting instances
418
419 =item A horse of a different color
420
421 =item Summary
422
423 =back
424
425 =item SEE ALSO
426
427 =item COPYRIGHT
428
429 =back
430
431 =head2 perltoot - Tom's object-oriented tutorial for perl
432
433 =over 4
434
435 =item DESCRIPTION
436
437 =item Creating a Class
438
439 =over 4
440
441 =item Object Representation
442
443 =item Class Interface
444
445 =item Constructors and Instance Methods
446
447 =item Planning for the Future: Better Constructors
448
449 =item Destructors
450
451 =item Other Object Methods
452
453 =back
454
455 =item Class Data
456
457 =over 4
458
459 =item Accessing Class Data
460
461 =item Debugging Methods
462
463 =item Class Destructors
464
465 =item Documenting the Interface
466
467 =back
468
469 =item Aggregation
470
471 =item Inheritance
472
473 =over 4
474
475 =item Overridden Methods
476
477 =item Multiple Inheritance
478
479 =item UNIVERSAL: The Root of All Objects
480
481 =back
482
483 =item Alternate Object Representations
484
485 =over 4
486
487 =item Arrays as Objects
488
489 =item Closures as Objects
490
491 =back
492
493 =item AUTOLOAD: Proxy Methods
494
495 =over 4
496
497 =item Autoloaded Data Methods
498
499 =item Inherited Autoloaded Data Methods
500
501 =back
502
503 =item Metaclassical Tools
504
505 =over 4
506
507 =item Class::Struct
508
509 =item Data Members as Variables
510
511 =back
512
513 =item NOTES
514
515 =over 4
516
517 =item Object Terminology
518
519 =back
520
521 =item SEE ALSO
522
523 =item AUTHOR AND COPYRIGHT
524
525 =item COPYRIGHT
526
527 =over 4
528
529 =item Acknowledgments
530
531 =back
532
533 =back
534
535 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
536
537 =over 4
538
539 =item DESCRIPTION
540
541 =item Class Data in a Can
542
543 =item Class Data as Package Variables
544
545 =over 4
546
547 =item Putting All Your Eggs in One Basket
548
549 =item Inheritance Concerns
550
551 =item The Eponymous Meta-Object
552
553 =item Indirect References to Class Data
554
555 =item Monadic Classes
556
557 =item Translucent Attributes
558
559 =back
560
561 =item Class Data as Lexical Variables
562
563 =over 4
564
565 =item Privacy and Responsibility 
566
567 =item File-Scoped Lexicals
568
569 =item More Inheritance Concerns
570
571 =item Locking the Door and Throwing Away the Key
572
573 =item Translucency Revisited
574
575 =back
576
577 =item NOTES
578
579 =item SEE ALSO
580
581 =item AUTHOR AND COPYRIGHT
582
583 =item ACKNOWLEDGEMENTS
584
585 =item HISTORY
586
587 =back
588
589 =head2 perlbot - Bag'o Object Tricks (the BOT)
590
591 =over 4
592
593 =item DESCRIPTION
594
595 =item OO SCALING TIPS
596
597 =item INSTANCE VARIABLES
598
599 =item SCALAR INSTANCE VARIABLES
600
601 =item INSTANCE VARIABLE INHERITANCE
602
603 =item OBJECT RELATIONSHIPS
604
605 =item OVERRIDING SUPERCLASS METHODS
606
607 =item USING RELATIONSHIP WITH SDBM
608
609 =item THINKING OF CODE REUSE
610
611 =item CLASS CONTEXT AND THE OBJECT
612
613 =item INHERITING A CONSTRUCTOR
614
615 =item DELEGATION
616
617 =item SEE ALSO
618
619 =back
620
621 =head2 perlstyle - Perl style guide
622
623 =over 4
624
625 =item DESCRIPTION
626
627 =back
628
629 =head2 perlcheat - Perl 5 Cheat Sheet
630
631 =over 4
632
633 =item DESCRIPTION
634
635 =over 4
636
637 =item The sheet
638
639 =back
640
641 =item ACKNOWLEDGEMENTS
642
643 =item AUTHOR
644
645 =item SEE ALSO
646
647 =back
648
649 =head2 perltrap - Perl traps for the unwary
650
651 =over 4
652
653 =item DESCRIPTION
654
655 =over 4
656
657 =item Awk Traps
658
659 =item C/C++ Traps
660
661 =item Sed Traps
662
663 =item Shell Traps
664
665 =item Perl Traps
666
667 =item Perl4 to Perl5 Traps
668
669 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
670 Traps, General data type traps, Context Traps - scalar, list contexts,
671 Precedence Traps, General Regular Expression Traps using s///, etc,
672 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
673
674 =item Discontinuance, Deprecation, and BugFix traps
675
676 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
677 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
678 Discontinuance, Deprecation, Discontinuance, Discontinuance
679
680 =item Parsing Traps
681
682 Parsing, Parsing, Parsing, Parsing, Parsing
683
684 =item Numerical Traps
685
686 Numerical, Numerical, Numerical, Bitwise string ops
687
688 =item General data type traps
689
690 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
691 (Constants), (Scalars), (Variable Suicide)
692
693 =item Context Traps - scalar, list contexts
694
695 (list context), (scalar context), (scalar context), (list, builtin)
696
697 =item Precedence Traps
698
699 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
700 Precedence
701
702 =item General Regular Expression Traps using s///, etc.
703
704 Regular Expression, Regular Expression, Regular Expression, Regular
705 Expression, Regular Expression, Regular Expression, Regular Expression,
706 Regular Expression, Regular Expression
707
708 =item Subroutine, Signal, Sorting Traps
709
710 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
711
712 =item OS Traps
713
714 (SysV), (SysV)
715
716 =item Interpolation Traps
717
718 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
719 Interpolation, Interpolation, Interpolation, Interpolation
720
721 =item DBM Traps
722
723 DBM, DBM
724
725 =item Unclassified Traps
726
727 C<require>/C<do> trap using returned value, C<split> on empty string with
728 LIMIT specified
729
730 =back
731
732 =back
733
734 =head2 perldebtut - Perl debugging tutorial
735
736 =over 4
737
738 =item DESCRIPTION
739
740 =item use strict
741
742 =item Looking at data and -w and v
743
744 =item help
745
746 =item Stepping through code
747
748 =item Placeholder for a, w, t, T
749
750 =item REGULAR EXPRESSIONS
751
752 =item OUTPUT TIPS
753
754 =item CGI
755
756 =item GUIs
757
758 =item SUMMARY
759
760 =item SEE ALSO
761
762 =item AUTHOR
763
764 =item CONTRIBUTORS
765
766 =back
767
768 =head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31
769 17:37:17 $)
770
771 =over 4
772
773 =item DESCRIPTION
774
775 =over 4
776
777 =item Where to get the perlfaq
778
779 =item How to contribute to the perlfaq
780
781 =item What will happen if you mail your Perl programming problems to the
782 authors
783
784 =back
785
786 =item Credits
787
788 =item Author and Copyright Information
789
790 =over 4
791
792 =item Bundled Distributions
793
794 =item Disclaimer
795
796 =back
797
798 =item Table of Contents
799
800 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
801 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
802 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
803 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
804 Interaction, perlfaq9 - Networking
805
806 =item The Questions
807
808 =over 4
809
810 =item L<perlfaq1>: General Questions About Perl
811
812 =item L<perlfaq2>: Obtaining and Learning about Perl
813
814 =item L<perlfaq3>: Programming Tools
815
816 =item L<perlfaq4>: Data Manipulation
817
818 =item L<perlfaq5>: Files and Formats
819
820 =item L<perlfaq6>: Regular Expressions
821
822 =item L<perlfaq7>: General Perl Language Issues
823
824 =item L<perlfaq8>: System Interaction
825
826 =item L<perlfaq9>: Networking
827
828 =back
829
830 =back
831
832 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date:
833 2003/11/23 08:02:29 $)
834
835 =over 4
836
837 =item DESCRIPTION
838
839 =over 4
840
841 =item What is Perl?
842
843 =item Who supports Perl?  Who develops it?  Why is it free?
844
845 =item Which version of Perl should I use?
846
847 =item What are perl4 and perl5?
848
849 =item What is Ponie?
850
851 =item What is perl6?
852
853 =item How stable is Perl?
854
855 =item Is Perl difficult to learn?
856
857 =item How does Perl compare with other languages like Java, Python, REXX,
858 Scheme, or Tcl?
859
860 =item Can I do [task] in Perl?
861
862 =item When shouldn't I program in Perl?
863
864 =item What's the difference between "perl" and "Perl"?
865
866 =item Is it a Perl program or a Perl script?
867
868 =item What is a JAPH?
869
870 =item Where can I get a list of Larry Wall witticisms?
871
872 =item How can I convince my sysadmin/supervisor/employees to use version
873 5/5.6.1/Perl instead of some other language?
874
875 =back
876
877 =item AUTHOR AND COPYRIGHT
878
879 =back
880
881 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.25 $,
882 $Date: 2003/10/16 04:57:38 $)
883
884 =over 4
885
886 =item DESCRIPTION
887
888 =over 4
889
890 =item What machines support Perl?  Where do I get it?
891
892 =item How can I get a binary version of Perl?
893
894 =item I don't have a C compiler on my system.  How can I compile perl?
895
896 =item I copied the Perl binary from one machine to another, but scripts
897 don't work.
898
899 =item I grabbed the sources and tried to compile but gdbm/dynamic
900 loading/malloc/linking/... failed.  How do I make it work?
901
902 =item What modules and extensions are available for Perl?  What is CPAN? 
903 What does CPAN/src/... mean?
904
905 =item Is there an ISO or ANSI certified version of Perl?
906
907 =item Where can I get information on Perl?
908
909 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
910
911 =item Where should I post source code?
912
913 =item Perl Books
914
915 References, Tutorials, Task-Oriented, Special Topics
916
917 =item Perl in Magazines
918
919 =item Perl on the Net: FTP and WWW Access
920
921 =item What mailing lists are there for Perl?
922
923 =item Archives of comp.lang.perl.misc
924
925 =item Where can I buy a commercial version of Perl?
926
927 =item Where do I send bug reports?
928
929 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
930
931 =back
932
933 =item AUTHOR AND COPYRIGHT
934
935 =back
936
937 =head2 perlfaq3 - Programming Tools ($Revision: 1.37 $, $Date: 2003/11/24
938 19:55:50 $)
939
940 =over 4
941
942 =item DESCRIPTION
943
944 =over 4
945
946 =item How do I do (anything)?
947
948 =item How can I use Perl interactively?
949
950 =item Is there a Perl shell?
951
952 =item How do I find which modules are installed on my system?
953
954 =item How do I debug my Perl programs?
955
956 =item How do I profile my Perl programs?
957
958 =item How do I cross-reference my Perl programs?
959
960 =item Is there a pretty-printer (formatter) for Perl?
961
962 =item Is there a ctags for Perl?
963
964 =item Is there an IDE or Windows Perl Editor?
965
966 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
967 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
968 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
969
970 =item Where can I get Perl macros for vi?
971
972 =item Where can I get perl-mode for emacs?
973
974 =item How can I use curses with Perl?
975
976 =item How can I use X or Tk with Perl?
977
978 =item How can I generate simple menus without using CGI or Tk?
979
980 =item How can I make my Perl program run faster?
981
982 =item How can I make my Perl program take less memory?
983
984 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
985 stringification, Pass by reference, Tie large variables to disk
986
987 =item Is it safe to return a reference to local or lexical data?
988
989 =item How can I free an array or hash so my program shrinks?
990
991 =item How can I make my CGI script more efficient?
992
993 =item How can I hide the source for my Perl program?
994
995 =item How can I compile my Perl program into byte code or C?
996
997 =item How can I compile Perl into Java?
998
999 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1000
1001 =item Can I write useful Perl programs on the command line?
1002
1003 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1004
1005 =item Where can I learn about CGI or Web programming in Perl?
1006
1007 =item Where can I learn about object-oriented Perl programming?
1008
1009 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
1010
1011 =item I've read perlembed, perlguts, etc., but I can't embed perl in
1012 my C program; what am I doing wrong?
1013
1014 =item When I tried to run my script, I got this message. What does it mean?
1015
1016 =item What's MakeMaker?
1017
1018 =back
1019
1020 =item AUTHOR AND COPYRIGHT
1021
1022 =back
1023
1024 =head2 perlfaq4 - Data Manipulation ($Revision: 1.54 $, $Date: 2003/11/30
1025 00:50:08 $)
1026
1027 =over 4
1028
1029 =item DESCRIPTION
1030
1031 =item Data: Numbers
1032
1033 =over 4
1034
1035 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1036 numbers I should be getting (eg, 19.95)?
1037
1038 =item Why is int() broken?
1039
1040 =item Why isn't my octal data interpreted correctly?
1041
1042 =item Does Perl have a round() function?  What about ceil() and floor()? 
1043 Trig functions?
1044
1045 =item How do I convert between numeric representations/bases/radixes?
1046
1047 How do I convert hexadecimal into decimal, How do I convert from decimal to
1048 hexadecimal, How do I convert from octal to decimal, How do I convert from
1049 decimal to octal, How do I convert from binary to decimal, How do I convert
1050 from decimal to binary
1051
1052 =item Why doesn't & work the way I want it to?
1053
1054 =item How do I multiply matrices?
1055
1056 =item How do I perform an operation on a series of integers?
1057
1058 =item How can I output Roman numerals?
1059
1060 =item Why aren't my random numbers random?
1061
1062 =item How do I get a random number between X and Y?
1063
1064 =back
1065
1066 =item Data: Dates
1067
1068 =over 4
1069
1070 =item How do I find the day or week of the year?
1071
1072 =item How do I find the current century or millennium?
1073
1074 =item How can I compare two dates and find the difference?
1075
1076 =item How can I take a string and turn it into epoch seconds?
1077
1078 =item How can I find the Julian Day?
1079
1080 =item How do I find yesterday's date?
1081
1082 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1083
1084 =back
1085
1086 =item Data: Strings
1087
1088 =over 4
1089
1090 =item How do I validate input?
1091
1092 =item How do I unescape a string?
1093
1094 =item How do I remove consecutive pairs of characters?
1095
1096 =item How do I expand function calls in a string?
1097
1098 =item How do I find matching/nesting anything?
1099
1100 =item How do I reverse a string?
1101
1102 =item How do I expand tabs in a string?
1103
1104 =item How do I reformat a paragraph?
1105
1106 =item How can I access or change N characters of a string?
1107
1108 =item How do I change the Nth occurrence of something?
1109
1110 =item How can I count the number of occurrences of a substring within a
1111 string?
1112
1113 =item How do I capitalize all the words on one line?
1114
1115 =item How can I split a [character] delimited string except when inside
1116 [character]?
1117
1118 =item How do I strip blank space from the beginning/end of a string?
1119
1120 =item How do I pad a string with blanks or pad a number with zeroes?
1121
1122 =item How do I extract selected columns from a string?
1123
1124 =item How do I find the soundex value of a string?
1125
1126 =item How can I expand variables in text strings?
1127
1128 =item What's wrong with always quoting "$vars"?
1129
1130 =item Why don't my E<lt>E<lt>HERE documents work?
1131
1132 There must be no space after the E<lt>E<lt> part, There (probably) should
1133 be a semicolon at the end, You can't (easily) have any space in front of
1134 the tag
1135
1136 =back
1137
1138 =item Data: Arrays
1139
1140 =over 4
1141
1142 =item What is the difference between a list and an array?
1143
1144 =item What is the difference between $array[1] and @array[1]?
1145
1146 =item How can I remove duplicate elements from a list or array?
1147
1148 a), b), c), d), e)
1149
1150 =item How can I tell whether a certain element is contained in a list or
1151 array?
1152
1153 =item How do I compute the difference of two arrays?  How do I compute the
1154 intersection of two arrays?
1155
1156 =item How do I test whether two arrays or hashes are equal?
1157
1158 =item How do I find the first array element for which a condition is true?
1159
1160 =item How do I handle linked lists?
1161
1162 =item How do I handle circular lists?
1163
1164 =item How do I shuffle an array randomly?
1165
1166 =item How do I process/modify each element of an array?
1167
1168 =item How do I select a random element from an array?
1169
1170 =item How do I permute N elements of a list?
1171
1172 =item How do I sort an array by (anything)?
1173
1174 =item How do I manipulate arrays of bits?
1175
1176 =item Why does defined() return true on empty arrays and hashes?
1177
1178 =back
1179
1180 =item Data: Hashes (Associative Arrays)
1181
1182 =over 4
1183
1184 =item How do I process an entire hash?
1185
1186 =item What happens if I add or remove keys from a hash while iterating over
1187 it?
1188
1189 =item How do I look up a hash element by value?
1190
1191 =item How can I know how many entries are in a hash?
1192
1193 =item How do I sort a hash (optionally by value instead of key)?
1194
1195 =item How can I always keep my hash sorted?
1196
1197 =item What's the difference between "delete" and "undef" with hashes?
1198
1199 =item Why don't my tied hashes make the defined/exists distinction?
1200
1201 =item How do I reset an each() operation part-way through?
1202
1203 =item How can I get the unique keys from two hashes?
1204
1205 =item How can I store a multidimensional array in a DBM file?
1206
1207 =item How can I make my hash remember the order I put elements into it?
1208
1209 =item Why does passing a subroutine an undefined element in a hash create
1210 it?
1211
1212 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1213 array of hashes or arrays?
1214
1215 =item How can I use a reference as a hash key?
1216
1217 =back
1218
1219 =item Data: Misc
1220
1221 =over 4
1222
1223 =item How do I handle binary data correctly?
1224
1225 =item How do I determine whether a scalar is a number/whole/integer/float?
1226
1227 =item How do I keep persistent data across program calls?
1228
1229 =item How do I print out or copy a recursive data structure?
1230
1231 =item How do I define methods for every class/object?
1232
1233 =item How do I verify a credit card checksum?
1234
1235 =item How do I pack arrays of doubles or floats for XS code?
1236
1237 =back
1238
1239 =item AUTHOR AND COPYRIGHT
1240
1241 =back
1242
1243 =head2 perlfaq5 - Files and Formats ($Revision: 1.30 $, $Date: 2003/11/23
1244 08:07:46 $)
1245
1246 =over 4
1247
1248 =item DESCRIPTION
1249
1250 =over 4
1251
1252 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1253
1254 =item How do I change one line in a file/delete a line in a file/insert a
1255 line in the middle of a file/append to the beginning of a file?
1256
1257 =item How do I count the number of lines in a file?
1258
1259 =item How can I use Perl's C<-i> option from within a program?
1260
1261 =item How do I make a temporary file name?
1262
1263 =item How can I manipulate fixed-record-length files?
1264
1265 =item How can I make a filehandle local to a subroutine?  How do I pass
1266 filehandles between subroutines?  How do I make an array of filehandles?
1267
1268 =item How can I use a filehandle indirectly?
1269
1270 =item How can I set up a footer format to be used with write()?
1271
1272 =item How can I write() into a string?
1273
1274 =item How can I output my numbers with commas added?
1275
1276 =item How can I translate tildes (~) in a filename?
1277
1278 =item How come when I open a file read-write it wipes it out?
1279
1280 =item Why do I sometimes get an "Argument list too long" when I use
1281 E<lt>*E<gt>?
1282
1283 =item Is there a leak/bug in glob()?
1284
1285 =item How can I open a file with a leading ">" or trailing blanks?
1286
1287 =item How can I reliably rename a file?
1288
1289 =item How can I lock a file?
1290
1291 =item Why can't I just open(FH, "E<gt>file.lock")?
1292
1293 =item I still don't get locking.  I just want to increment the number in
1294 the file.  How can I do this?
1295
1296 =item All I want to do is append a small amount of text to the end of a
1297 file.  Do I still have to use locking?
1298
1299 =item How do I randomly update a binary file?
1300
1301 =item How do I get a file's timestamp in perl?
1302
1303 =item How do I set a file's timestamp in perl?
1304
1305 =item How do I print to more than one file at once?
1306
1307 =item How can I read in an entire file all at once?
1308
1309 =item How can I read in a file by paragraphs?
1310
1311 =item How can I read a single character from a file?  From the keyboard?
1312
1313 =item How can I tell whether there's a character waiting on a filehandle?
1314
1315 =item How do I do a C<tail -f> in perl?
1316
1317 =item How do I dup() a filehandle in Perl?
1318
1319 =item How do I close a file descriptor by number?
1320
1321 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1322 `C:\temp\foo.exe` work?
1323
1324 =item Why doesn't glob("*.*") get all the files?
1325
1326 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1327 protected files?  Isn't this a bug in Perl?
1328
1329 =item How do I select a random line from a file?
1330
1331 =item Why do I get weird spaces when I print an array of lines?
1332
1333 =back
1334
1335 =item AUTHOR AND COPYRIGHT
1336
1337 =back
1338
1339 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
1340 20:05:28 $)
1341
1342 =over 4
1343
1344 =item DESCRIPTION
1345
1346 =over 4
1347
1348 =item How can I hope to use regular expressions without creating illegible
1349 and unmaintainable code?
1350
1351 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1352
1353 =item I'm having trouble matching over more than one line.  What's wrong?
1354
1355 =item How can I pull out lines between two patterns that are themselves on
1356 different lines?
1357
1358 =item I put a regular expression into $/ but it didn't work. What's wrong?
1359
1360 =item How do I substitute case insensitively on the LHS while preserving
1361 case on the RHS?
1362
1363 =item How can I make C<\w> match national character sets?
1364
1365 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1366
1367 =item How can I quote a variable to use in a regex?
1368
1369 =item What is C</o> really for?
1370
1371 =item How do I use a regular expression to strip C style comments from a
1372 file?
1373
1374 =item Can I use Perl regular expressions to match balanced text?
1375
1376 =item What does it mean that regexes are greedy?  How can I get around it?
1377
1378 =item How do I process each word on each line?
1379
1380 =item How can I print out a word-frequency or line-frequency summary?
1381
1382 =item How can I do approximate matching?
1383
1384 =item How do I efficiently match many regular expressions at once?
1385
1386 =item Why don't word-boundary searches with C<\b> work for me?
1387
1388 =item Why does using $&, $`, or $' slow my program down?
1389
1390 =item What good is C<\G> in a regular expression?
1391
1392 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1393
1394 =item What's wrong with using grep in a void context?
1395
1396 =item How can I match strings with multibyte characters?
1397
1398 =item How do I match a pattern that is supplied by the user?
1399
1400 =back
1401
1402 =item AUTHOR AND COPYRIGHT
1403
1404 =back
1405
1406 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
1407 2003/07/24 02:17:21 $)
1408
1409 =over 4
1410
1411 =item DESCRIPTION
1412
1413 =over 4
1414
1415 =item Can I get a BNF/yacc/RE for the Perl language?
1416
1417 =item What are all these $@%&* punctuation signs, and how do I know when to
1418 use them?
1419
1420 =item Do I always/never have to quote my strings or use semicolons and
1421 commas?
1422
1423 =item How do I skip some return values?
1424
1425 =item How do I temporarily block warnings?
1426
1427 =item What's an extension?
1428
1429 =item Why do Perl operators have different precedence than C operators?
1430
1431 =item How do I declare/create a structure?
1432
1433 =item How do I create a module?
1434
1435 =item How do I create a class?
1436
1437 =item How can I tell if a variable is tainted?
1438
1439 =item What's a closure?
1440
1441 =item What is variable suicide and how can I prevent it?
1442
1443 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1444 Regex}?
1445
1446 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1447 Passing Methods
1448
1449 =item How do I create a static variable?
1450
1451 =item What's the difference between dynamic and lexical (static) scoping? 
1452 Between local() and my()?
1453
1454 =item How can I access a dynamic variable while a similarly named lexical
1455 is in scope?
1456
1457 =item What's the difference between deep and shallow binding?
1458
1459 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1460
1461 =item How do I redefine a builtin function, operator, or method?
1462
1463 =item What's the difference between calling a function as &foo and foo()?
1464
1465 =item How do I create a switch or case statement?
1466
1467 =item How can I catch accesses to undefined variables, functions, or
1468 methods?
1469
1470 =item Why can't a method included in this same file be found?
1471
1472 =item How can I find out my current package?
1473
1474 =item How can I comment out a large block of perl code?
1475
1476 =item How do I clear a package?
1477
1478 =item How can I use a variable as a variable name?
1479
1480 =item What does "bad interpreter" mean?
1481
1482 =back
1483
1484 =item AUTHOR AND COPYRIGHT
1485
1486 =back
1487
1488 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
1489 17:44:04 $)
1490
1491 =over 4
1492
1493 =item DESCRIPTION
1494
1495 =over 4
1496
1497 =item How do I find out which operating system I'm running under?
1498
1499 =item How come exec() doesn't return?
1500
1501 =item How do I do fancy stuff with the keyboard/screen/mouse?
1502
1503 Keyboard, Screen, Mouse
1504
1505 =item How do I print something out in color?
1506
1507 =item How do I read just one key without waiting for a return key?
1508
1509 =item How do I check whether input is ready on the keyboard?
1510
1511 =item How do I clear the screen?
1512
1513 =item How do I get the screen size?
1514
1515 =item How do I ask the user for a password?
1516
1517 =item How do I read and write the serial port?
1518
1519 lockfiles, open mode, end of line, flushing output, non-blocking input
1520
1521 =item How do I decode encrypted password files?
1522
1523 =item How do I start a process in the background?
1524
1525 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1526
1527 =item How do I trap control characters/signals?
1528
1529 =item How do I modify the shadow password file on a Unix system?
1530
1531 =item How do I set the time and date?
1532
1533 =item How can I sleep() or alarm() for under a second?
1534
1535 =item How can I measure time under a second?
1536
1537 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1538
1539 =item Why doesn't my sockets program work under System V (Solaris)?  What
1540 does the error message "Protocol not supported" mean?
1541
1542 =item How can I call my system's unique C functions from Perl?
1543
1544 =item Where do I get the include files to do ioctl() or syscall()?
1545
1546 =item Why do setuid perl scripts complain about kernel problems?
1547
1548 =item How can I open a pipe both to and from a command?
1549
1550 =item Why can't I get the output of a command with system()?
1551
1552 =item How can I capture STDERR from an external command?
1553
1554 =item Why doesn't open() return an error when a pipe open fails?
1555
1556 =item What's wrong with using backticks in a void context?
1557
1558 =item How can I call backticks without shell processing?
1559
1560 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1561 ^Z on MS-DOS)?
1562
1563 =item How can I convert my shell script to perl?
1564
1565 =item Can I use perl to run a telnet or ftp session?
1566
1567 =item How can I write expect in Perl?
1568
1569 =item Is there a way to hide perl's command line from programs such as
1570 "ps"?
1571
1572 =item I {changed directory, modified my environment} in a perl script.  How
1573 come the change disappeared when I exited the script?  How do I get my
1574 changes to be visible?
1575
1576 Unix
1577
1578 =item How do I close a process's filehandle without waiting for it to
1579 complete?
1580
1581 =item How do I fork a daemon process?
1582
1583 =item How do I find out if I'm running interactively or not?
1584
1585 =item How do I timeout a slow event?
1586
1587 =item How do I set CPU limits?
1588
1589 =item How do I avoid zombies on a Unix system?
1590
1591 =item How do I use an SQL database?
1592
1593 =item How do I make a system() exit on control-C?
1594
1595 =item How do I open a file without blocking?
1596
1597 =item How do I install a module from CPAN?
1598
1599 =item What's the difference between require and use?
1600
1601 =item How do I keep my own module/library directory?
1602
1603 =item How do I add the directory my program lives in to the module/library
1604 search path?
1605
1606 =item How do I add a directory to my include path (@INC) at runtime?
1607
1608 =item What is socket.ph and where do I get it?
1609
1610 =back
1611
1612 =item AUTHOR AND COPYRIGHT
1613
1614 =back
1615
1616 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
1617 $)
1618
1619 =over 4
1620
1621 =item DESCRIPTION
1622
1623 =over 4
1624
1625 =item What is the correct form of response from a CGI script?
1626
1627 =item My CGI script runs from the command line but not the browser.  (500
1628 Server Error)
1629
1630 =item How can I get better error messages from a CGI program?
1631
1632 =item How do I remove HTML from a string?
1633
1634 =item How do I extract URLs?
1635
1636 =item How do I download a file from the user's machine?  How do I open a
1637 file on another machine?
1638
1639 =item How do I make a pop-up menu in HTML?
1640
1641 =item How do I fetch an HTML file?
1642
1643 =item How do I automate an HTML form submission?
1644
1645 =item How do I decode or create those %-encodings on the web?
1646
1647 =item How do I redirect to another page?
1648
1649 =item How do I put a password on my web pages?
1650
1651 =item How do I edit my .htpasswd and .htgroup files with Perl?
1652
1653 =item How do I make sure users can't enter values into a form that cause my
1654 CGI script to do bad things?
1655
1656 =item How do I parse a mail header?
1657
1658 =item How do I decode a CGI form?
1659
1660 =item How do I check a valid mail address?
1661
1662 =item How do I decode a MIME/BASE64 string?
1663
1664 =item How do I return the user's mail address?
1665
1666 =item How do I send mail?
1667
1668 =item How do I use MIME to make an attachment to a mail message?
1669
1670 =item How do I read mail?
1671
1672 =item How do I find out my hostname/domainname/IP address?
1673
1674 =item How do I fetch a news article or the active newsgroups?
1675
1676 =item How do I fetch/put an FTP file?
1677
1678 =item How can I do RPC in Perl?
1679
1680 =back
1681
1682 =item AUTHOR AND COPYRIGHT
1683
1684 =back
1685
1686 =head2 perlsyn - Perl syntax
1687
1688 =over 4
1689
1690 =item DESCRIPTION
1691
1692 =over 4
1693
1694 =item Declarations
1695
1696 =item Comments
1697
1698 =item Simple Statements
1699
1700 =item Truth and Falsehood
1701
1702 =item Statement Modifiers
1703
1704 =item Compound Statements
1705
1706 =item Loop Control
1707
1708 =item For Loops
1709
1710 =item Foreach Loops
1711
1712 =item Basic BLOCKs and Switch Statements
1713
1714 =item Goto
1715
1716 =item PODs: Embedded Documentation
1717
1718 =item Plain Old Comments (Not!)
1719
1720 =back
1721
1722 =back
1723
1724 =head2 perldata - Perl data types
1725
1726 =over 4
1727
1728 =item DESCRIPTION
1729
1730 =over 4
1731
1732 =item Variable names
1733
1734 =item Context
1735
1736 =item Scalar values
1737
1738 =item Scalar value constructors
1739
1740 =item List value constructors
1741
1742 =item Subscripts
1743
1744 =item Slices
1745
1746 =item Typeglobs and Filehandles
1747
1748 =back
1749
1750 =item SEE ALSO
1751
1752 =back
1753
1754 =head2 perlop - Perl operators and precedence
1755
1756 =over 4
1757
1758 =item DESCRIPTION
1759
1760 =over 4
1761
1762 =item Operator Precedence and Associativity
1763
1764 =item Terms and List Operators (Leftward)
1765
1766 =item The Arrow Operator
1767
1768 =item Auto-increment and Auto-decrement
1769
1770 =item Exponentiation
1771
1772 =item Symbolic Unary Operators
1773
1774 =item Binding Operators
1775
1776 =item Multiplicative Operators
1777
1778 =item Additive Operators
1779
1780 =item Shift Operators
1781
1782 =item Named Unary Operators
1783
1784 =item Relational Operators
1785
1786 =item Equality Operators
1787
1788 =item Bitwise And
1789
1790 =item Bitwise Or and Exclusive Or
1791
1792 =item C-style Logical And
1793
1794 =item C-style Logical Or
1795
1796 =item C-style Logical Defined-Or
1797
1798 =item Range Operators
1799
1800 =item Conditional Operator
1801
1802 =item Assignment Operators
1803
1804 =item Comma Operator
1805
1806 =item List Operators (Rightward)
1807
1808 =item Logical Not
1809
1810 =item Logical And
1811
1812 =item Logical or, Defined or, and Exclusive Or
1813
1814 =item C Operators Missing From Perl
1815
1816 unary &, unary *, (TYPE)
1817
1818 =item Quote and Quote-like Operators
1819
1820 =item Regexp Quote-Like Operators
1821
1822 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1823 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1824 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1825 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1826
1827 =item Gory details of parsing quoted constructs
1828
1829 Finding the end, Removal of backslashes before delimiters, Interpolation,
1830 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1831 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1832 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1833 regular expressions
1834
1835 =item I/O Operators
1836
1837 =item Constant Folding
1838
1839 =item Bitwise String Operators
1840
1841 =item Integer Arithmetic
1842
1843 =item Floating-point Arithmetic
1844
1845 =item Bigger Numbers
1846
1847 =back
1848
1849 =back
1850
1851 =head2 perlsub - Perl subroutines
1852
1853 =over 4
1854
1855 =item SYNOPSIS
1856
1857 =item DESCRIPTION
1858
1859 =over 4
1860
1861 =item Private Variables via my()
1862
1863 =item Persistent Private Variables
1864
1865 =item Temporary Values via local()
1866
1867 =item Lvalue subroutines
1868
1869 Lvalue subroutines are EXPERIMENTAL
1870
1871 =item Passing Symbol Table Entries (typeglobs)
1872
1873 =item When to Still Use local()
1874
1875 =item Pass by Reference
1876
1877 =item Prototypes
1878
1879 =item Constant Functions
1880
1881 =item Overriding Built-in Functions
1882
1883 =item Autoloading
1884
1885 =item Subroutine Attributes
1886
1887 =back
1888
1889 =item SEE ALSO
1890
1891 =back
1892
1893 =head2 perlfunc - Perl builtin functions
1894
1895 =over 4
1896
1897 =item DESCRIPTION
1898
1899 =over 4
1900
1901 =item Perl Functions by Category
1902
1903 Functions for SCALARs or strings, Regular expressions and pattern matching,
1904 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1905 Functions for real %HASHes, Input and output functions, Functions for fixed
1906 length data or records, Functions for filehandles, files, or directories,
1907 Keywords related to the control flow of your perl program, Keywords related
1908 to scoping, Miscellaneous functions, Functions for processes and process
1909 groups, Keywords related to perl modules, Keywords related to classes and
1910 object-orientedness, Low-level socket functions, System V interprocess
1911 communication functions, Fetching user and group info, Fetching network
1912 info, Time-related functions, Functions new in perl5, Functions obsoleted
1913 in perl5
1914
1915 =item Portability
1916
1917 =item Alphabetical Listing of Perl Functions
1918
1919 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1920 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1921 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1922 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1923 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1924 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1925 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1926 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1927 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1928 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1929 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1930 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1931 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1932 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1933 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1934 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1935 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1936 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1937 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1938 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1939 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1940 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1941 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1942 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1943 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1944 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1945 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1946 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
1947 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
1948 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
1949 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
1950 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
1951 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
1952 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
1953 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
1954 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
1955 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1956 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1957 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1958 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1959 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1960 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1961 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1962 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
1963 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
1964 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
1965 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
1966 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
1967 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1968 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1969 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1970 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1971 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1972 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1973 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1974 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1975 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1976 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1977 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1978 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1979 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1980 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1981 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1982 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen
1983 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1984 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1985 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1986 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1987 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1988 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1989 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1990 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1991 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1992 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1993 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1994 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1995
1996 =back
1997
1998 =back
1999
2000 =head2 perlopentut - tutorial on opening things in Perl
2001
2002 =over 4
2003
2004 =item DESCRIPTION
2005
2006 =item Open E<agrave> la shell
2007
2008 =over 4
2009
2010 =item Simple Opens
2011
2012 =item Indirect Filehandles
2013
2014 =item Pipe Opens
2015
2016 =item The Minus File
2017
2018 =item Mixing Reads and Writes
2019
2020 =item Filters 
2021
2022 =back
2023
2024 =item Open E<agrave> la C
2025
2026 =over 4
2027
2028 =item Permissions E<agrave> la mode
2029
2030 =back
2031
2032 =item Obscure Open Tricks
2033
2034 =over 4
2035
2036 =item Re-Opening Files (dups)
2037
2038 =item Dispelling the Dweomer
2039
2040 =item Paths as Opens
2041
2042 =item Single Argument Open
2043
2044 =item Playing with STDIN and STDOUT
2045
2046 =back
2047
2048 =item Other I/O Issues
2049
2050 =over 4
2051
2052 =item Opening Non-File Files
2053
2054 =item Opening Named Pipes
2055
2056 =item Opening Sockets
2057
2058 =item Binary Files
2059
2060 =item File Locking
2061
2062 =item IO Layers
2063
2064 =back
2065
2066 =item SEE ALSO 
2067
2068 =item AUTHOR and COPYRIGHT
2069
2070 =item HISTORY
2071
2072 =back
2073
2074 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2075
2076 =over 4
2077
2078 =item DESCRIPTION
2079
2080 =item The Basic Principle
2081
2082 =item Packing Text
2083
2084 =item Packing Numbers
2085
2086 =over 4
2087
2088 =item Integers
2089
2090 =item Unpacking a Stack Frame
2091
2092 =item How to Eat an Egg on a Net
2093
2094 =item Floating point Numbers
2095
2096 =back
2097
2098 =item Exotic Templates
2099
2100 =over 4
2101
2102 =item Bit Strings
2103
2104 =item Uuencoding
2105
2106 =item Doing Sums
2107
2108 =item  Unicode
2109
2110 =item Another Portable Binary Encoding
2111
2112 =back
2113
2114 =item Template Grouping
2115
2116 =item Lengths and Widths
2117
2118 =over 4
2119
2120 =item String Lengths
2121
2122 =item Dynamic Templates
2123
2124 =item Counting Repetitions
2125
2126 =back
2127
2128 =item Packing and Unpacking C Structures
2129
2130 =over 4
2131
2132 =item The Alignment Pit
2133
2134 =item Alignment, Take 2
2135
2136 =item Alignment, Take 3
2137
2138 =item Pointers for How to Use Them
2139
2140 =back
2141
2142 =item Pack Recipes
2143
2144 =item Funnies Section
2145
2146 =item Authors
2147
2148 =back
2149
2150 =head2 perlpod - the Plain Old Documentation format
2151
2152 =over 4
2153
2154 =item DESCRIPTION
2155
2156 =over 4
2157
2158 =item Ordinary Paragraph
2159
2160 =item Verbatim Paragraph
2161
2162 =item Command Paragraph
2163
2164 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2165 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2166 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2167 I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
2168 I<encodingname>>
2169
2170 =item Formatting Codes
2171
2172 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2173 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2174 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2175 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2176 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2177 (zero-effect) formatting code
2178
2179 =item The Intent
2180
2181 =item Embedding Pods in Perl Modules
2182
2183 =item Hints for Writing Pod
2184
2185 =back
2186
2187 =item SEE ALSO
2188
2189 =item AUTHOR
2190
2191 =back
2192
2193 =head2 perlpodspec - Plain Old Documentation: format specification and
2194 notes
2195
2196 =over 4
2197
2198 =item DESCRIPTION
2199
2200 =item Pod Definitions
2201
2202 =item Pod Commands
2203
2204 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2205 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2206 "=encoding encodingname"
2207
2208 =item Pod Formatting Codes
2209
2210 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2211 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2212 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2213 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2214 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2215 contains non-breaking spaces
2216
2217 =item Notes on Implementing Pod Processors
2218
2219 =item About LE<lt>...E<gt> Codes
2220
2221 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2222
2223 =item About =over...=back Regions
2224
2225 =item About Data Paragraphs and "=begin/=end" Regions
2226
2227 =item SEE ALSO
2228
2229 =item AUTHOR
2230
2231 =back
2232
2233 =head2 perlrun - how to execute the Perl interpreter
2234
2235 =over 4
2236
2237 =item SYNOPSIS
2238
2239 =item DESCRIPTION
2240
2241 =over 4
2242
2243 =item #! and quoting on non-Unix systems
2244
2245 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2246
2247 =item Location of Perl
2248
2249 =item Command Switches
2250
2251 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2252 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
2253 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
2254 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
2255 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2256 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2257 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
2258 B<-X>, B<-x> I<directory>
2259
2260 =back
2261
2262 =item ENVIRONMENT
2263
2264 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2265 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2266 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
2267 PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
2268 PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
2269 PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
2270
2271 =back
2272
2273 =head2 perldiag - various Perl diagnostics
2274
2275 =over 4
2276
2277 =item DESCRIPTION
2278
2279 =back
2280
2281 =head2 perllexwarn - Perl Lexical Warnings
2282
2283 =over 4
2284
2285 =item DESCRIPTION
2286
2287 =over 4
2288
2289 =item Default Warnings and Optional Warnings
2290
2291 =item What's wrong with B<-w> and C<$^W>
2292
2293 =item Controlling Warnings from the Command Line
2294
2295 B<-w>, B<-W>, B<-X>
2296
2297 =item Backward Compatibility
2298
2299 =item Category Hierarchy
2300
2301 =item Fatal Warnings
2302
2303 =item Reporting Warnings from a Module
2304
2305 =back
2306
2307 =item TODO
2308
2309 =item SEE ALSO
2310
2311 =item AUTHOR
2312
2313 =back
2314
2315 =head2 perldebug - Perl debugging
2316
2317 =over 4
2318
2319 =item DESCRIPTION
2320
2321 =item The Perl Debugger
2322
2323 =over 4
2324
2325 =item Debugger Commands
2326
2327 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2328 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2329 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2330 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2331 subname [condition], b postpone subname [condition], b load filename, b
2332 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2333 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2334 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2335 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2336 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2337 [manpage]
2338
2339 =item Configurable Options
2340
2341 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2342 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2343 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2344 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2345 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2346 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2347 C<NonStop>
2348
2349 =item Debugger input/output
2350
2351 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2352 listing
2353
2354 =item Debugging compile-time statements
2355
2356 =item Debugger Customization
2357
2358 =item Readline Support
2359
2360 =item Editor Support for Debugging
2361
2362 =item The Perl Profiler
2363
2364 =back
2365
2366 =item Debugging regular expressions
2367
2368 =item Debugging memory usage
2369
2370 =item SEE ALSO
2371
2372 =item BUGS
2373
2374 =back
2375
2376 =head2 perlvar - Perl predefined variables
2377
2378 =over 4
2379
2380 =item DESCRIPTION
2381
2382 =over 4
2383
2384 =item Predefined Names
2385
2386 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2387 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2388 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2389 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2390 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2391 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2392 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2393 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2394 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2395 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2396 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2397 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2398 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2399 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2400 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2401 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2402 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2403 IO::Handle->format_line_break_characters EXPR,
2404 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2405 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2406 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2407 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2408 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2409 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2410 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2411 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2412 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2413 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2414 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2415 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2416 $SIG{expr}
2417
2418 =item Error Indicators
2419
2420 =item Technical Note on the Syntax of Variable Names
2421
2422 =back
2423
2424 =item BUGS
2425
2426 =back
2427
2428 =head2 perlre - Perl regular expressions
2429
2430 =over 4
2431
2432 =item DESCRIPTION
2433
2434 i, m, s, x
2435
2436 =over 4
2437
2438 =item Regular Expressions
2439
2440 [1], [2], [3], cntrl, graph, print, punct, xdigit
2441
2442 =item Extended Patterns
2443
2444 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2445 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2446 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2447 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2448
2449 =item Backtracking
2450
2451 =item Version 8 Regular Expressions
2452
2453 =item Warning on \1 vs $1
2454
2455 =item Repeated patterns matching zero-length substring
2456
2457 =item Combining pieces together
2458
2459 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2460 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2461 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2462 C<(?(condition)yes-pattern|no-pattern)>
2463
2464 =item Creating custom RE engines
2465
2466 =back
2467
2468 =item BUGS
2469
2470 =item SEE ALSO
2471
2472 =back
2473
2474 =head2 perlreref - Perl Regular Expressions Reference
2475
2476 =over 4
2477
2478 =item DESCRIPTION
2479
2480 =over 4
2481
2482 =item OPERATORS
2483
2484 =item SYNTAX
2485
2486 =item ESCAPE SEQUENCES
2487
2488 =item CHARACTER CLASSES
2489
2490 =item ANCHORS
2491
2492 =item QUANTIFIERS
2493
2494 =item EXTENDED CONSTRUCTS
2495
2496 =item VARIABLES
2497
2498 =item FUNCTIONS
2499
2500 =item TERMINOLOGY
2501
2502 =back
2503
2504 =item AUTHOR
2505
2506 =item SEE ALSO
2507
2508 =item THANKS
2509
2510 =back
2511
2512 =head2 perlref - Perl references and nested data structures
2513
2514 =over 4
2515
2516 =item NOTE
2517
2518 =item DESCRIPTION
2519
2520 =over 4
2521
2522 =item Making References
2523
2524 =item Using References
2525
2526 =item Symbolic references
2527
2528 =item Not-so-symbolic references
2529
2530 =item Pseudo-hashes: Using an array as a hash
2531
2532 =item Function Templates
2533
2534 =back
2535
2536 =item WARNING
2537
2538 =item SEE ALSO
2539
2540 =back
2541
2542 =head2 perlform - Perl formats
2543
2544 =over 4
2545
2546 =item DESCRIPTION
2547
2548 =over 4
2549
2550 =item Text Fields
2551
2552 =item Numeric Fields
2553
2554 =item The Field @* for Variable Width Multi-Line Text
2555
2556 =item The Field ^* for Variable Width One-line-at-a-time Text
2557
2558 =item Specifying Values
2559
2560 =item Using Fill Mode
2561
2562 =item Suppressing Lines Where All Fields Are Void
2563
2564 =item Repeating Format Lines
2565
2566 =item Top of Form Processing
2567
2568 =item Format Variables
2569
2570 =back
2571
2572 =item NOTES
2573
2574 =over 4
2575
2576 =item Footers
2577
2578 =item Accessing Formatting Internals
2579
2580 =back
2581
2582 =item WARNINGS
2583
2584 =back
2585
2586 =head2 perlobj - Perl objects
2587
2588 =over 4
2589
2590 =item DESCRIPTION
2591
2592 =over 4
2593
2594 =item An Object is Simply a Reference
2595
2596 =item A Class is Simply a Package
2597
2598 =item A Method is Simply a Subroutine
2599
2600 =item Method Invocation
2601
2602 =item Indirect Object Syntax
2603
2604 =item Default UNIVERSAL methods
2605
2606 isa(CLASS), can(METHOD), VERSION( [NEED] )
2607
2608 =item Destructors
2609
2610 =item Summary
2611
2612 =item Two-Phased Garbage Collection
2613
2614 =back
2615
2616 =item SEE ALSO
2617
2618 =back
2619
2620 =head2 perltie - how to hide an object class in a simple variable
2621
2622 =over 4
2623
2624 =item SYNOPSIS
2625
2626 =item DESCRIPTION
2627
2628 =over 4
2629
2630 =item Tying Scalars
2631
2632 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2633 DESTROY this
2634
2635 =item Tying Arrays
2636
2637 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2638 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2639 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2640 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2641 this
2642
2643 =item Tying Hashes
2644
2645 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2646 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2647 this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
2648
2649 =item Tying FileHandles
2650
2651 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2652 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2653 DESTROY this
2654
2655 =item UNTIE this
2656
2657 =item The C<untie> Gotcha
2658
2659 =back
2660
2661 =item SEE ALSO
2662
2663 =item BUGS
2664
2665 =item AUTHOR
2666
2667 =back
2668
2669 =head2 perldbmfilter - Perl DBM Filters
2670
2671 =over 4
2672
2673 =item SYNOPSIS
2674
2675 =item DESCRIPTION
2676
2677 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2678 B<filter_fetch_value>
2679
2680 =over 4
2681
2682 =item The Filter
2683
2684 =item An Example -- the NULL termination problem.
2685
2686 =item Another Example -- Key is a C int.
2687
2688 =back
2689
2690 =item SEE ALSO
2691
2692 =item AUTHOR
2693
2694 =back
2695
2696 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2697 safe subprocesses, sockets, and semaphores)
2698
2699 =over 4
2700
2701 =item DESCRIPTION
2702
2703 =item Signals
2704
2705 =over 4
2706
2707 =item Handling the SIGHUP Signal in Daemons
2708
2709 =back
2710
2711 =item Named Pipes
2712
2713 =over 4
2714
2715 =item Deferred Signals (Safe Signals)
2716
2717 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2718 "faults", Signals triggered by operating system state
2719
2720 =back
2721
2722 =item Using open() for IPC
2723
2724 =over 4
2725
2726 =item Filehandles
2727
2728 =item Background Processes
2729
2730 =item Complete Dissociation of Child from Parent
2731
2732 =item Safe Pipe Opens
2733
2734 =item Bidirectional Communication with Another Process
2735
2736 =item Bidirectional Communication with Yourself
2737
2738 =back
2739
2740 =item Sockets: Client/Server Communication
2741
2742 =over 4
2743
2744 =item Internet Line Terminators
2745
2746 =item Internet TCP Clients and Servers
2747
2748 =item Unix-Domain TCP Clients and Servers
2749
2750 =back
2751
2752 =item TCP Clients with IO::Socket
2753
2754 =over 4
2755
2756 =item A Simple Client
2757
2758 C<Proto>, C<PeerAddr>, C<PeerPort>
2759
2760 =item A Webget Client
2761
2762 =item Interactive Client with IO::Socket
2763
2764 =back
2765
2766 =item TCP Servers with IO::Socket
2767
2768 Proto, LocalPort, Listen, Reuse
2769
2770 =item UDP: Message Passing
2771
2772 =item SysV IPC
2773
2774 =item NOTES
2775
2776 =item BUGS
2777
2778 =item AUTHOR
2779
2780 =item SEE ALSO
2781
2782 =back
2783
2784 =head2 perlfork - Perl's fork() emulation
2785
2786 =over 4
2787
2788 =item SYNOPSIS
2789
2790 =item DESCRIPTION
2791
2792 =over 4
2793
2794 =item Behavior of other Perl features in forked pseudo-processes
2795
2796 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2797 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2798 files, directories and network sockets
2799
2800 =item Resource limits
2801
2802 =item Killing the parent process
2803
2804 =item Lifetime of the parent process and pseudo-processes
2805
2806 =item CAVEATS AND LIMITATIONS
2807
2808 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2809 Global state maintained by XSUBs, Interpreter embedded in larger
2810 application, Thread-safety of extensions
2811
2812 =back
2813
2814 =item BUGS
2815
2816 =item AUTHOR
2817
2818 =item SEE ALSO
2819
2820 =back
2821
2822 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2823
2824 =over 4
2825
2826 =item SYNOPSIS
2827
2828 =item DESCRIPTION
2829
2830 =item Storing numbers
2831
2832 =item Numeric operators and numeric conversions
2833
2834 =item Flavors of Perl numeric operations
2835
2836 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2837 mathematical operators, Bitwise operators, Bitwise operators during C<use
2838 integer>, Operators which expect an integer, Operators which expect a
2839 string
2840
2841 =item AUTHOR
2842
2843 =item SEE ALSO
2844
2845 =back
2846
2847 =head2 perlthrtut - tutorial on threads in Perl
2848
2849 =over 4
2850
2851 =item DESCRIPTION
2852
2853 =item Status
2854
2855 =item What Is A Thread Anyway?
2856
2857 =item Threaded Program Models
2858
2859 =over 4
2860
2861 =item Boss/Worker
2862
2863 =item Work Crew
2864
2865 =item Pipeline
2866
2867 =back
2868
2869 =item What kind of threads are Perl threads?
2870
2871 =item Thread-Safe Modules
2872
2873 =item Thread Basics
2874
2875 =over 4
2876
2877 =item Basic Thread Support
2878
2879 =item A Note about the Examples
2880
2881 =item Creating Threads
2882
2883 =item Waiting For A Thread To Exit
2884
2885 =item Ignoring A Thread
2886
2887 =back
2888
2889 =item Threads And Data
2890
2891 =over 4
2892
2893 =item Shared And Unshared Data
2894
2895 =item Thread Pitfalls: Races
2896
2897 =back
2898
2899 =item Synchronization and control
2900
2901 =over 4
2902
2903 =item Controlling access: lock()
2904
2905 =item A Thread Pitfall: Deadlocks
2906
2907 =item Queues: Passing Data Around
2908
2909 =item Semaphores: Synchronizing Data Access
2910
2911 =item Basic semaphores
2912
2913 =item Advanced Semaphores
2914
2915 =item cond_wait() and cond_signal()
2916
2917 =item Giving up control
2918
2919 =back
2920
2921 =item General Thread Utility Routines
2922
2923 =over 4
2924
2925 =item What Thread Am I In?
2926
2927 =item Thread IDs
2928
2929 =item Are These Threads The Same?
2930
2931 =item What Threads Are Running?
2932
2933 =back
2934
2935 =item A Complete Example
2936
2937 =item Different implementations of threads
2938
2939 =item Performance considerations
2940
2941 =item Process-scope Changes
2942
2943 =item Thread-Safety of System Libraries
2944
2945 =item Conclusion
2946
2947 =item Bibliography
2948
2949 =over 4
2950
2951 =item Introductory Texts
2952
2953 =item OS-Related References
2954
2955 =item Other References
2956
2957 =back
2958
2959 =item Acknowledgements
2960
2961 =item AUTHOR
2962
2963 =item Copyrights
2964
2965 =back
2966
2967 =head2 perlothrtut - old tutorial on threads in Perl
2968
2969 =over 4
2970
2971 =item DESCRIPTION
2972
2973 =item What Is A Thread Anyway?
2974
2975 =item Threaded Program Models
2976
2977 =over 4
2978
2979 =item Boss/Worker
2980
2981 =item Work Crew
2982
2983 =item Pipeline
2984
2985 =back
2986
2987 =item Native threads
2988
2989 =item What kind of threads are perl threads?
2990
2991 =item Threadsafe Modules
2992
2993 =item Thread Basics
2994
2995 =over 4
2996
2997 =item Basic Thread Support
2998
2999 =item Creating Threads
3000
3001 =item Giving up control
3002
3003 =item Waiting For A Thread To Exit
3004
3005 =item Errors In Threads
3006
3007 =item Ignoring A Thread
3008
3009 =back
3010
3011 =item Threads And Data
3012
3013 =over 4
3014
3015 =item Shared And Unshared Data
3016
3017 =item Thread Pitfall: Races
3018
3019 =item Controlling access: lock()
3020
3021 =item Thread Pitfall: Deadlocks
3022
3023 =item Queues: Passing Data Around
3024
3025 =back
3026
3027 =item Threads And Code
3028
3029 =over 4
3030
3031 =item Semaphores: Synchronizing Data Access
3032
3033 Basic semaphores, Advanced Semaphores
3034
3035 =item Attributes: Restricting Access To Subroutines
3036
3037 =item Subroutine Locks
3038
3039 =item Methods
3040
3041 =item Locking A Subroutine
3042
3043 =back
3044
3045 =item General Thread Utility Routines
3046
3047 =over 4
3048
3049 =item What Thread Am I In?
3050
3051 =item Thread IDs
3052
3053 =item Are These Threads The Same?
3054
3055 =item What Threads Are Running?
3056
3057 =back
3058
3059 =item A Complete Example
3060
3061 =item Conclusion
3062
3063 =item Bibliography
3064
3065 =over 4
3066
3067 =item Introductory Texts
3068
3069 =item OS-Related References
3070
3071 =item Other References
3072
3073 =back
3074
3075 =item Acknowledgements
3076
3077 =item AUTHOR
3078
3079 =item Copyrights
3080
3081 =back
3082
3083 =head2 perlport - Writing portable Perl
3084
3085 =over 4
3086
3087 =item DESCRIPTION
3088
3089 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3090 portable
3091
3092 =item ISSUES
3093
3094 =over 4
3095
3096 =item Newlines
3097
3098 =item Numbers endianness and Width
3099
3100 =item Files and Filesystems
3101
3102 =item System Interaction
3103
3104 =item Command names versus file pathnames
3105
3106 =item Networking
3107
3108 =item Interprocess Communication (IPC)
3109
3110 =item External Subroutines (XS)
3111
3112 =item Standard Modules
3113
3114 =item Time and Date
3115
3116 =item Character sets and character encoding
3117
3118 =item Internationalisation
3119
3120 =item System Resources
3121
3122 =item Security
3123
3124 =item Style
3125
3126 =back
3127
3128 =item CPAN Testers
3129
3130 Mailing list: cpan-testers@perl.org, Testing results:
3131 http://testers.cpan.org/
3132
3133 =item PLATFORMS
3134
3135 =over 4
3136
3137 =item Unix
3138
3139 =item DOS and Derivatives
3140
3141 =item S<Mac OS>
3142
3143 =item VMS
3144
3145 =item VOS
3146
3147 =item EBCDIC Platforms
3148
3149 =item Acorn RISC OS
3150
3151 =item Other perls
3152
3153 =back
3154
3155 =item FUNCTION IMPLEMENTATIONS
3156
3157 =over 4
3158
3159 =item Alphabetical Listing of Perl Functions
3160
3161 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3162 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3163 HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
3164 FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
3165 getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
3166 getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
3167 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
3168 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
3169 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3170 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3171 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3172 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3173 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3174 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3175 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3176 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3177 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3178 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3179 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3180 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3181 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3182 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3183 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3184 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3185 wait, waitpid PID,FLAGS
3186
3187 =back
3188
3189 =item CHANGES
3190
3191 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3192 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3193 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3194 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3195 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3196 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3197
3198 =item Supported Platforms
3199
3200 =item SEE ALSO
3201
3202 =item AUTHORS / CONTRIBUTORS
3203
3204 =back
3205
3206 =head2 perllocale - Perl locale handling (internationalization and
3207 localization)
3208
3209 =over 4
3210
3211 =item DESCRIPTION
3212
3213 =item PREPARING TO USE LOCALES
3214
3215 =item USING LOCALES
3216
3217 =over 4
3218
3219 =item The use locale pragma
3220
3221 =item The setlocale function
3222
3223 =item Finding locales
3224
3225 =item LOCALE PROBLEMS
3226
3227 =item Temporarily fixing locale problems
3228
3229 =item Permanently fixing locale problems
3230
3231 =item Permanently fixing your system's locale configuration
3232
3233 =item Fixing system locale configuration
3234
3235 =item The localeconv function
3236
3237 =item I18N::Langinfo
3238
3239 =back
3240
3241 =item LOCALE CATEGORIES
3242
3243 =over 4
3244
3245 =item Category LC_COLLATE: Collation
3246
3247 =item Category LC_CTYPE: Character Types
3248
3249 =item Category LC_NUMERIC: Numeric Formatting
3250
3251 =item Category LC_MONETARY: Formatting of monetary amounts
3252
3253 =item LC_TIME
3254
3255 =item Other categories
3256
3257 =back
3258
3259 =item SECURITY
3260
3261 =item ENVIRONMENT
3262
3263 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3264 LC_NUMERIC, LC_TIME, LANG
3265
3266 =item NOTES
3267
3268 =over 4
3269
3270 =item Backward compatibility
3271
3272 =item I18N:Collate obsolete
3273
3274 =item Sort speed and memory use impacts
3275
3276 =item write() and LC_NUMERIC
3277
3278 =item Freely available locale definitions
3279
3280 =item I18n and l10n
3281
3282 =item An imperfect standard
3283
3284 =back
3285
3286 =item Unicode and UTF-8
3287
3288 =item BUGS
3289
3290 =over 4
3291
3292 =item Broken systems
3293
3294 =back
3295
3296 =item SEE ALSO
3297
3298 =item HISTORY
3299
3300 =back
3301
3302 =head2 perluniintro - Perl Unicode introduction
3303
3304 =over 4
3305
3306 =item DESCRIPTION
3307
3308 =over 4
3309
3310 =item Unicode
3311
3312 =item Perl's Unicode Support
3313
3314 =item Perl's Unicode Model
3315
3316 =item Unicode and EBCDIC
3317
3318 =item Creating Unicode
3319
3320 =item Handling Unicode
3321
3322 =item Legacy Encodings
3323
3324 =item Unicode I/O
3325
3326 =item Displaying Unicode As Text
3327
3328 =item Special Cases
3329
3330 =item Advanced Topics
3331
3332 =item Miscellaneous
3333
3334 =item Questions With Answers
3335
3336 =item Hexadecimal Notation
3337
3338 =item Further Resources
3339
3340 =back
3341
3342 =item UNICODE IN OLDER PERLS
3343
3344 =item SEE ALSO
3345
3346 =item ACKNOWLEDGMENTS
3347
3348 =item AUTHOR, COPYRIGHT, AND LICENSE
3349
3350 =back
3351
3352 =head2 perlunicode - Unicode support in Perl
3353
3354 =over 4
3355
3356 =item DESCRIPTION
3357
3358 =over 4
3359
3360 =item Important Caveats
3361
3362 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3363 enable UTF-8/UTF-EBCDIC in scripts, C<use encoding> needed to upgrade
3364 non-Latin-1 byte strings
3365
3366 =item Byte and Character Semantics
3367
3368 =item Effects of Character Semantics
3369
3370 =item Scripts
3371
3372 =item Blocks
3373
3374 =item User-Defined Character Properties
3375
3376 =item Character Encodings for Input and Output
3377
3378 =item Unicode Regular Expression Support Level
3379
3380 =item Unicode Encodings
3381
3382 =item Security Implications of Unicode
3383
3384 =item Unicode in Perl on EBCDIC
3385
3386 =item Locales
3387
3388 =item When Unicode Does Not Happen
3389
3390 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3391
3392 =item Using Unicode in XS
3393
3394 =back
3395
3396 =item BUGS
3397
3398 =over 4
3399
3400 =item Interaction with Locales
3401
3402 =item Interaction with Extensions
3403
3404 =item Speed
3405
3406 =item Porting code from perl-5.6.X
3407
3408 =back
3409
3410 =item SEE ALSO
3411
3412 =back
3413
3414 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3415
3416 =over 4
3417
3418 =item DESCRIPTION
3419
3420 =item COMMON CHARACTER CODE SETS
3421
3422 =over 4
3423
3424 =item ASCII
3425
3426 =item ISO 8859
3427
3428 =item Latin 1 (ISO 8859-1)
3429
3430 =item EBCDIC
3431
3432 =item 13 variant characters
3433
3434 =item 0037
3435
3436 =item 1047
3437
3438 =item POSIX-BC
3439
3440 =item Unicode code points versus EBCDIC code points
3441
3442 =item Remaining Perl Unicode problems in EBCDIC
3443
3444 =item Unicode and UTF
3445
3446 =item Using Encode
3447
3448 =back
3449
3450 =item SINGLE OCTET TABLES
3451
3452 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3453
3454 =item IDENTIFYING CHARACTER CODE SETS
3455
3456 =item CONVERSIONS
3457
3458 =over 4
3459
3460 =item tr///
3461
3462 =item iconv
3463
3464 =item C RTL
3465
3466 =back
3467
3468 =item OPERATOR DIFFERENCES
3469
3470 =item FUNCTION DIFFERENCES
3471
3472 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3473
3474 =item REGULAR EXPRESSION DIFFERENCES
3475
3476 =item SOCKETS
3477
3478 =item SORTING
3479
3480 =over 4
3481
3482 =item Ignore ASCII vs. EBCDIC sort differences.
3483
3484 =item MONO CASE then sort data.
3485
3486 =item Convert, sort data, then re convert.
3487
3488 =item Perform sorting on one type of machine only.
3489
3490 =back
3491
3492 =item TRANSFORMATION FORMATS
3493
3494 =over 4
3495
3496 =item URL decoding and encoding
3497
3498 =item uu encoding and decoding
3499
3500 =item Quoted-Printable encoding and decoding
3501
3502 =item Caesarian ciphers
3503
3504 =back
3505
3506 =item Hashing order and checksums
3507
3508 =item I18N AND L10N
3509
3510 =item MULTI OCTET CHARACTER SETS
3511
3512 =item OS ISSUES
3513
3514 =over 4
3515
3516 =item OS/400
3517
3518 PASE, IFS access
3519
3520 =item OS/390, z/OS
3521
3522 chcp, dataset access, OS/390, z/OS iconv, locales
3523
3524 =item VM/ESA?
3525
3526 =item POSIX-BC?
3527
3528 =back
3529
3530 =item BUGS
3531
3532 =item SEE ALSO
3533
3534 =item REFERENCES
3535
3536 =item HISTORY
3537
3538 =item AUTHOR
3539
3540 =back
3541
3542 =head2 perlsec - Perl security
3543
3544 =over 4
3545
3546 =item DESCRIPTION
3547
3548 =over 4
3549
3550 =item Laundering and Detecting Tainted Data
3551
3552 =item Switches On the "#!" Line
3553
3554 =item Taint mode and @INC
3555
3556 =item Cleaning Up Your Path
3557
3558 =item Security Bugs
3559
3560 =item Protecting Your Programs
3561
3562 =item Unicode
3563
3564 =item Algorithmic Complexity Attacks
3565
3566 =back
3567
3568 =item SEE ALSO
3569
3570 =back
3571
3572 =head2 perlmod - Perl modules (packages and symbol tables)
3573
3574 =over 4
3575
3576 =item DESCRIPTION
3577
3578 =over 4
3579
3580 =item Packages
3581
3582 =item Symbol Tables
3583
3584 =item BEGIN, CHECK, INIT and END
3585
3586 =item Perl Classes
3587
3588 =item Perl Modules
3589
3590 =item Making your module threadsafe
3591
3592 =back
3593
3594 =item SEE ALSO
3595
3596 =back
3597
3598 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3599
3600 =over 4
3601
3602 =item THE PERL MODULE LIBRARY
3603
3604 =over 4
3605
3606 =item Pragmatic Modules
3607
3608 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3609 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3610 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3611 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3612 vmsish, warnings, warnings::register
3613
3614 =item Standard Modules
3615
3616 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3617 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3618 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3619 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3620 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3621 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3622 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
3623 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
3624 Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias,
3625 Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ,
3626 Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding,
3627 Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
3628 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
3629 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
3630 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
3631 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
3632 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
3633 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
3634 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
3635 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3636 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3637 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3638 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3639 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3640 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3641 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3642 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3643 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3644 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3645 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3646 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3647 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3648 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3649 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3650 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3651 Locale::Currency, Locale::Language, Locale::Maketext,
3652 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3653 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3654 Math::BigInt::Calc, Math::BigRat, Math::Complex, Math::Trig, Memoize,
3655 Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile,
3656 Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File,
3657 Memoize::Storable, NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain,
3658 Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, Net::SMTP,
3659 Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, Net::protoent,
3660 Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, PerlIO::encoding,
3661 PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker,
3662 Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX,
3663 Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3664 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3665 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3666 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3667 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3668 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3669 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3670 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3671 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3672 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3673 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3674 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3675 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3676 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3677 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3678 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3679 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3680 XSLoader
3681
3682 =item Extension Modules
3683
3684 =back
3685
3686 =item CPAN
3687
3688 =over 4
3689
3690 =item Africa
3691
3692 South Africa
3693
3694 =item Asia
3695
3696 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3697 Arabia, Singapore, South Korea, Taiwan, Thailand
3698
3699 =item Central America
3700
3701 Costa Rica
3702
3703 =item Europe
3704
3705 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3706 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3707 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3708 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3709 Turkey, Ukraine, United Kingdom
3710
3711 =item North America
3712
3713 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3714 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3715 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3716 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3717 Virginia, Washington, Wisconsin
3718
3719 =item Oceania
3720
3721 Australia, New Zealand, United States
3722
3723 =item South America
3724
3725 Argentina, Brazil, Chile
3726
3727 =item RSYNC Mirrors
3728
3729 =back
3730
3731 =item Modules: Creation, Use, and Abuse
3732
3733 =over 4
3734
3735 =item Guidelines for Module Creation
3736
3737 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3738
3739 =item Guidelines for Reusing Application Code
3740
3741 =back
3742
3743 =item NOTE
3744
3745 =back
3746
3747 =head2 perlmodstyle - Perl module style guide
3748
3749 =over 4
3750
3751 =item INTRODUCTION
3752
3753 =item QUICK CHECKLIST
3754
3755 =over 4
3756
3757 =item Before you start
3758
3759 =item The API
3760
3761 =item Stability
3762
3763 =item Documentation
3764
3765 =item Release considerations
3766
3767 =back
3768
3769 =item BEFORE YOU START WRITING A MODULE
3770
3771 =over 4
3772
3773 =item Has it been done before?
3774
3775 =item Do one thing and do it well
3776
3777 =item What's in a name?
3778
3779 =back
3780
3781 =item DESIGNING AND WRITING YOUR MODULE
3782
3783 =over 4
3784
3785 =item To OO or not to OO?
3786
3787 =item Designing your API
3788
3789 Write simple routines to do simple things, Separate functionality from
3790 output, Provide sensible shortcuts and defaults, Naming conventions,
3791 Parameter passing
3792
3793 =item Strictness and warnings
3794
3795 =item Backwards compatibility
3796
3797 =item Error handling and messages
3798
3799 =back
3800
3801 =item DOCUMENTING YOUR MODULE
3802
3803 =over 4
3804
3805 =item POD
3806
3807 =item README, INSTALL, release notes, changelogs
3808
3809 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3810 perl Build test, perl Build install
3811
3812 =back
3813
3814 =item RELEASE CONSIDERATIONS
3815
3816 =over 4
3817
3818 =item Version numbering
3819
3820 =item Pre-requisites
3821
3822 =item Testing
3823
3824 =item Packaging
3825
3826 =item Licensing
3827
3828 =back
3829
3830 =item COMMON PITFALLS
3831
3832 =over 4
3833
3834 =item Reinventing the wheel
3835
3836 =item Trying to do too much
3837
3838 =item Inappropriate documentation
3839
3840 =back
3841
3842 =item SEE ALSO
3843
3844 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3845 Testing tools, http://pause.perl.org/, Any good book on software
3846 engineering
3847
3848 =item AUTHOR
3849
3850 =back
3851
3852 =head2 perlmodinstall - Installing CPAN Modules
3853
3854 =over 4
3855
3856 =item DESCRIPTION
3857
3858 =over 4
3859
3860 =item PREAMBLE
3861
3862 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3863 module (sometimes unnecessary), B<INSTALL> the module
3864
3865 =back
3866
3867 =item PORTABILITY
3868
3869 =item HEY
3870
3871 =item AUTHOR
3872
3873 =item COPYRIGHT
3874
3875 =back
3876
3877 =head2 perlnewmod - preparing a new module for distribution
3878
3879 =over 4
3880
3881 =item DESCRIPTION
3882
3883 =over 4
3884
3885 =item Warning
3886
3887 =item What should I make into a module?
3888
3889 =item Step-by-step: Preparing the ground
3890
3891 Look around, Check it's new, Discuss the need, Choose a name, Check again
3892
3893 =item Step-by-step: Making the module
3894
3895 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
3896 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
3897 documentation|perlpod>, Write tests, Write the README
3898
3899 =item Step-by-step: Distributing your module
3900
3901 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3902 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3903
3904 =back
3905
3906 =item AUTHOR
3907
3908 =item SEE ALSO
3909
3910 =back
3911
3912 =head2 perlutil - utilities packaged with the Perl distribution
3913
3914 =over 4
3915
3916 =item DESCRIPTION
3917
3918 =over 4
3919
3920 =item DOCUMENTATION
3921
3922 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3923 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3924 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3925 L<roffitall|roffitall>
3926
3927 =item CONVERTORS
3928
3929 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3930
3931 =item Administration
3932
3933 L<libnetcfg|libnetcfg>
3934
3935 =item Development
3936
3937 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3938 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3939
3940 =item SEE ALSO
3941
3942 =back
3943
3944 =back
3945
3946 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3947
3948 =over 4
3949
3950 =item DESCRIPTION
3951
3952 =over 4
3953
3954 =item Layout
3955
3956 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3957
3958 =back
3959
3960 =item Using The Back Ends
3961
3962 =over 4
3963
3964 =item The Cross Referencing Back End
3965
3966 i, &, s, r
3967
3968 =item The Decompiling Back End
3969
3970 =item The Lint Back End
3971
3972 =item The Simple C Back End
3973
3974 =item The Bytecode Back End
3975
3976 =item The Optimized C Back End
3977
3978 =back
3979
3980 =item Module List for the Compiler Suite
3981
3982 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3983 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3984 B::Stackobj, B::Stash, B::Terse, B::Xref
3985
3986 =item KNOWN PROBLEMS
3987
3988 =item AUTHOR
3989
3990 =back
3991
3992 =head2 perlfilter - Source Filters
3993
3994 =over 4
3995
3996 =item DESCRIPTION
3997
3998 =item CONCEPTS
3999
4000 =item USING FILTERS
4001
4002 =item WRITING A SOURCE FILTER
4003
4004 =item WRITING A SOURCE FILTER IN C
4005
4006 B<Decryption Filters>
4007
4008 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4009
4010 =item WRITING A SOURCE FILTER IN PERL
4011
4012 =item USING CONTEXT: THE DEBUG FILTER
4013
4014 =item CONCLUSION
4015
4016 =item THINGS TO LOOK OUT FOR
4017
4018 Some Filters Clobber the C<DATA> Handle
4019
4020 =item REQUIREMENTS
4021
4022 =item AUTHOR
4023
4024 =item Copyrights
4025
4026 =back
4027
4028 =head2 perlembed - how to embed perl in your C program
4029
4030 =over 4
4031
4032 =item DESCRIPTION
4033
4034 =over 4
4035
4036 =item PREAMBLE
4037
4038 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4039 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4040
4041 =item ROADMAP
4042
4043 =item Compiling your C program
4044
4045 =item Adding a Perl interpreter to your C program
4046
4047 =item Calling a Perl subroutine from your C program
4048
4049 =item Evaluating a Perl statement from your C program
4050
4051 =item Performing Perl pattern matches and substitutions from your C program
4052
4053 =item Fiddling with the Perl stack from your C program
4054
4055 =item Maintaining a persistent interpreter
4056
4057 =item Execution of END blocks
4058
4059 =item Maintaining multiple interpreter instances
4060
4061 =item Using Perl modules, which themselves use C libraries, from your C
4062 program
4063
4064 =back
4065
4066 =item Embedding Perl under Win32
4067
4068 =item Hiding Perl_
4069
4070 =item MORAL
4071
4072 =item AUTHOR
4073
4074 =item COPYRIGHT
4075
4076 =back
4077
4078 =head2 perldebguts - Guts of Perl debugging 
4079
4080 =over 4
4081
4082 =item DESCRIPTION
4083
4084 =item Debugger Internals
4085
4086 =over 4
4087
4088 =item Writing Your Own Debugger
4089
4090 =back
4091
4092 =item Frame Listing Output Examples
4093
4094 =item Debugging regular expressions
4095
4096 =over 4
4097
4098 =item Compile-time output
4099
4100 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4101 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4102 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4103 C<anchored(TYPE)>
4104
4105 =item Types of nodes
4106
4107 =item Run-time output
4108
4109 =back
4110
4111 =item Debugging Perl memory usage
4112
4113 =over 4
4114
4115 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4116
4117 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4118 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4119 6144>
4120
4121 =item Example of using B<-DL> switch
4122
4123 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4124
4125 =item B<-DL> details
4126
4127 C<!!!>, C<!!>, C<!>
4128
4129 =item Limitations of B<-DL> statistics
4130
4131 =back
4132
4133 =item SEE ALSO
4134
4135 =back
4136
4137 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4138
4139 =over 4
4140
4141 =item DESCRIPTION
4142
4143 =item SPECIAL NOTES
4144
4145 =over 4
4146
4147 =item make
4148
4149 =item Version caveat
4150
4151 =item Dynamic Loading versus Static Loading
4152
4153 =back
4154
4155 =item TUTORIAL
4156
4157 =over 4
4158
4159 =item EXAMPLE 1
4160
4161 =item EXAMPLE 2
4162
4163 =item What has gone on?
4164
4165 =item Writing good test scripts
4166
4167 =item EXAMPLE 3
4168
4169 =item What's new here?
4170
4171 =item Input and Output Parameters
4172
4173 =item The XSUBPP Program
4174
4175 =item The TYPEMAP file
4176
4177 =item Warning about Output Arguments
4178
4179 =item EXAMPLE 4
4180
4181 =item What has happened here?
4182
4183 =item Anatomy of .xs file
4184
4185 =item Getting the fat out of XSUBs
4186
4187 =item More about XSUB arguments
4188
4189 =item The Argument Stack
4190
4191 =item Extending your Extension
4192
4193 =item Documenting your Extension
4194
4195 =item Installing your Extension
4196
4197 =item EXAMPLE 5
4198
4199 =item New Things in this Example
4200
4201 =item EXAMPLE 6
4202
4203 =item New Things in this Example
4204
4205 =item EXAMPLE 7 (Coming Soon)
4206
4207 =item EXAMPLE 8 (Coming Soon)
4208
4209 =item EXAMPLE 9 Passing open files to XSes
4210
4211 =item Troubleshooting these Examples
4212
4213 =back
4214
4215 =item See also
4216
4217 =item Author
4218
4219 =over 4
4220
4221 =item Last Changed
4222
4223 =back
4224
4225 =back
4226
4227 =head2 perlxs - XS language reference manual
4228
4229 =over 4
4230
4231 =item DESCRIPTION
4232
4233 =over 4
4234
4235 =item Introduction
4236
4237 =item On The Road
4238
4239 =item The Anatomy of an XSUB
4240
4241 =item The Argument Stack
4242
4243 =item The RETVAL Variable
4244
4245 =item The MODULE Keyword
4246
4247 =item The PACKAGE Keyword
4248
4249 =item The PREFIX Keyword
4250
4251 =item The OUTPUT: Keyword
4252
4253 =item The NO_OUTPUT Keyword
4254
4255 =item The CODE: Keyword
4256
4257 =item The INIT: Keyword
4258
4259 =item The NO_INIT Keyword
4260
4261 =item Initializing Function Parameters
4262
4263 =item Default Parameter Values
4264
4265 =item The PREINIT: Keyword
4266
4267 =item The SCOPE: Keyword
4268
4269 =item The INPUT: Keyword
4270
4271 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4272
4273 =item The C<length(NAME)> Keyword
4274
4275 =item Variable-length Parameter Lists
4276
4277 =item The C_ARGS: Keyword
4278
4279 =item The PPCODE: Keyword
4280
4281 =item Returning Undef And Empty Lists
4282
4283 =item The REQUIRE: Keyword
4284
4285 =item The CLEANUP: Keyword
4286
4287 =item The POSTCALL: Keyword
4288
4289 =item The BOOT: Keyword
4290
4291 =item The VERSIONCHECK: Keyword
4292
4293 =item The PROTOTYPES: Keyword
4294
4295 =item The PROTOTYPE: Keyword
4296
4297 =item The ALIAS: Keyword
4298
4299 =item The OVERLOAD: Keyword
4300
4301 =item The FALLBACK: Keyword
4302
4303 =item The INTERFACE: Keyword
4304
4305 =item The INTERFACE_MACRO: Keyword
4306
4307 =item The INCLUDE: Keyword
4308
4309 =item The CASE: Keyword
4310
4311 =item The & Unary Operator
4312
4313 =item Inserting POD, Comments and C Preprocessor Directives
4314
4315 =item Using XS With C++
4316
4317 =item Interface Strategy
4318
4319 =item Perl Objects And C Structures
4320
4321 =item The Typemap
4322
4323 =item Safely Storing Static Data in XS
4324
4325 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4326
4327 =back
4328
4329 =item EXAMPLES
4330
4331 =item XS VERSION
4332
4333 =item AUTHOR
4334
4335 =back
4336
4337 =head2 perlclib - Internal replacements for standard C library functions
4338
4339 =over 4
4340
4341 =item DESCRIPTION
4342
4343 =over 4
4344
4345 =item Conventions
4346
4347 C<t>, C<p>, C<n>, C<s>
4348
4349 =item File Operations
4350
4351 =item File Input and Output
4352
4353 =item File Positioning
4354
4355 =item Memory Management and String Handling
4356
4357 =item Character Class Tests
4358
4359 =item F<stdlib.h> functions
4360
4361 =item Miscellaneous functions
4362
4363 =back
4364
4365 =item SEE ALSO
4366
4367 =back
4368
4369 =head2 perlguts - Introduction to the Perl API
4370
4371 =over 4
4372
4373 =item DESCRIPTION
4374
4375 =item Variables
4376
4377 =over 4
4378
4379 =item Datatypes
4380
4381 =item What is an "IV"?
4382
4383 =item Working with SVs
4384
4385 =item Offsets
4386
4387 =item What's Really Stored in an SV?
4388
4389 =item Working with AVs
4390
4391 =item Working with HVs
4392
4393 =item Hash API Extensions
4394
4395 =item AVs, HVs and undefined values
4396
4397 =item References
4398
4399 =item Blessed References and Class Objects
4400
4401 =item Creating New Variables
4402
4403 GV_ADDMULTI, GV_ADDWARN
4404
4405 =item Reference Counts and Mortality
4406
4407 =item Stashes and Globs
4408
4409 =item Double-Typed SVs
4410
4411 =item Magic Variables
4412
4413 =item Assigning Magic
4414
4415 =item Magic Virtual Tables
4416
4417 =item Finding Magic
4418
4419 =item Understanding the Magic of Tied Hashes and Arrays
4420
4421 =item Localizing changes
4422
4423 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4424 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4425 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4426 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4427 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4428 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4429 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4430 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4431 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4432 save_hptr(HV **hptr)>
4433
4434 =back
4435
4436 =item Subroutines
4437
4438 =over 4
4439
4440 =item XSUBs and the Argument Stack
4441
4442 =item Calling Perl Routines from within C Programs
4443
4444 =item Memory Allocation
4445
4446 =item PerlIO
4447
4448 =item Putting a C value on Perl stack
4449
4450 =item Scratchpads
4451
4452 =item Scratchpads and recursion
4453
4454 =back
4455
4456 =item Compiled code
4457
4458 =over 4
4459
4460 =item Code tree
4461
4462 =item Examining the tree
4463
4464 =item Compile pass 1: check routines
4465
4466 =item Compile pass 1a: constant folding
4467
4468 =item Compile pass 2: context propagation
4469
4470 =item Compile pass 3: peephole optimization
4471
4472 =item Pluggable runops
4473
4474 =back
4475
4476 =item Examining internal data structures with the C<dump> functions
4477
4478 =item How multiple interpreters and concurrency are supported
4479
4480 =over 4
4481
4482 =item Background and PERL_IMPLICIT_CONTEXT
4483
4484 =item So what happened to dTHR?
4485
4486 =item How do I use all this in extensions?
4487
4488 =item Should I do anything special if I call perl from multiple threads?
4489
4490 =item Future Plans and PERL_IMPLICIT_SYS
4491
4492 =back
4493
4494 =item Internal Functions
4495
4496 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4497
4498 =over 4
4499
4500 =item Formatted Printing of IVs, UVs, and NVs
4501
4502 =item Pointer-To-Integer and Integer-To-Pointer
4503
4504 =item Source Documentation
4505
4506 =back
4507
4508 =item Unicode Support
4509
4510 =over 4
4511
4512 =item What B<is> Unicode, anyway?
4513
4514 =item How can I recognise a UTF-8 string?
4515
4516 =item How does UTF-8 represent Unicode characters?
4517
4518 =item How does Perl store UTF-8 strings?
4519
4520 =item How do I convert a string to UTF-8?
4521
4522 =item Is there anything else I need to know?
4523
4524 =back
4525
4526 =item Custom Operators
4527
4528 =item AUTHORS
4529
4530 =item SEE ALSO
4531
4532 =back
4533
4534 =head2 perlcall - Perl calling conventions from C
4535
4536 =over 4
4537
4538 =item DESCRIPTION
4539
4540 An Error Handler, An Event Driven Program
4541
4542 =item THE CALL_ FUNCTIONS
4543
4544 call_sv, call_pv, call_method, call_argv
4545
4546 =item FLAG VALUES
4547
4548 =over 4
4549
4550 =item  G_VOID
4551
4552 =item  G_SCALAR
4553
4554 =item G_ARRAY
4555
4556 =item G_DISCARD
4557
4558 =item G_NOARGS
4559
4560 =item G_EVAL
4561
4562 =item G_KEEPERR
4563
4564 =item Determining the Context
4565
4566 =back
4567
4568 =item KNOWN PROBLEMS
4569
4570 =item EXAMPLES
4571
4572 =over 4
4573
4574 =item No Parameters, Nothing returned
4575
4576 =item Passing Parameters
4577
4578 =item Returning a Scalar
4579
4580 =item Returning a list of values
4581
4582 =item Returning a list in a scalar context
4583
4584 =item Returning Data from Perl via the parameter list
4585
4586 =item Using G_EVAL
4587
4588 =item Using G_KEEPERR
4589
4590 =item Using call_sv
4591
4592 =item Using call_argv
4593
4594 =item Using call_method
4595
4596 =item Using GIMME_V
4597
4598 =item Using Perl to dispose of temporaries
4599
4600 =item Strategies for storing Callback Context Information
4601
4602 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4603 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4604 callback
4605
4606 =item Alternate Stack Manipulation
4607
4608 =item Creating and calling an anonymous subroutine in C
4609
4610 =back
4611
4612 =item SEE ALSO
4613
4614 =item AUTHOR
4615
4616 =item DATE
4617
4618 =back
4619
4620 =head2 perlapi - autogenerated documentation for the perl public API
4621
4622 =over 4
4623
4624 =item DESCRIPTION
4625
4626 =item "Gimme" Values
4627
4628 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4629
4630 =item Array Manipulation Functions
4631
4632 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4633 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4634 get_av, newAV, Nullav, sortsv
4635
4636 =item Callback Functions
4637
4638 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4639 FREETMPS, LEAVE, SAVETMPS
4640
4641 =item Character classes
4642
4643 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4644
4645 =item Cloning an interpreter
4646
4647 perl_clone
4648
4649 =item CV Manipulation Functions
4650
4651 CvSTASH, get_cv, Nullcv
4652
4653 =item Embedding Functions
4654
4655 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4656 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4657
4658 =item Functions in file pp_pack.c
4659
4660 packlist, pack_cat, unpackstring, unpack_str
4661
4662 =item Global Variables
4663
4664 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4665
4666 =item GV Functions
4667
4668 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4669 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4670
4671 =item Handy Values
4672
4673 HEf_SVKEY, Nullch, Nullsv
4674
4675 =item Hash Manipulation Functions
4676
4677 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4678 HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders, hv_delete,
4679 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4680 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4681 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
4682 hv_undef, newHV, Nullhv
4683
4684 =item Magical Functions
4685
4686 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4687 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4688 SvSetSV, SvSetSV_nosteal, SvSHARE
4689
4690 =item Memory Management
4691
4692 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4693 savepv, savepvn, savesharedpv, StructCopy, Zero
4694
4695 =item Miscellaneous Functions
4696
4697 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4698 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4699 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
4700
4701 =item Numeric functions
4702
4703 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4704 scan_hex, scan_oct
4705
4706 =item Optree Manipulation Functions
4707
4708 cv_const_sv, newCONSTSUB, newXS
4709
4710 =item Pad Data Structures
4711
4712 pad_sv
4713
4714 =item Stack Manipulation Macros
4715
4716 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4717 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4718 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4719 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4720 XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF,
4721 XST_mYES
4722
4723 =item SV Flags
4724
4725 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4726
4727 =item SV Manipulation Functions
4728
4729 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4730 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4731 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4732 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4733 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
4734 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4735 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4736 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4737 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4738 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4739 SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
4740 SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
4741 SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8,
4742 SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool,
4743 sv_2cv, sv_2io, sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte,
4744 sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen,
4745 sv_2uv_flags, sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg,
4746 sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv,
4747 sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale,
4748 sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4749 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4750 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4751 sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, sv_pos_u2b,
4752 sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force,
4753 sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype,
4754 sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg,
4755 sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
4756 sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
4757 sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv,
4758 sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted,
4759 sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade,
4760 sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
4761 sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4762
4763 =item Unicode Support
4764
4765 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4766 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4767 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4768 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4769 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4770 uvuni_to_utf8_flags
4771
4772 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4773
4774 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4775 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4776
4777 =item Warning and Dieing
4778
4779 croak, warn
4780
4781 =item AUTHORS
4782
4783 =item SEE ALSO
4784
4785 =back
4786
4787 =head2 perlintern - autogenerated documentation of purely B<internal>
4788                  Perl functions
4789
4790 =over 4
4791
4792 =item DESCRIPTION
4793
4794 =item CV reference counts and CvOUTSIDE
4795
4796 CvWEAKOUTSIDE
4797
4798 =item Functions in file pad.h
4799
4800 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4801 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4802 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4803 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4804 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4805
4806 =item Functions in file pp_ctl.c
4807
4808 find_runcv
4809
4810 =item Global Variables
4811
4812 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4813 PL_rs
4814
4815 =item GV Functions
4816
4817 is_gv_magical
4818
4819 =item IO Functions
4820
4821 start_glob
4822
4823 =item Pad Data Structures
4824
4825 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4826 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4827 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4828 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4829
4830 =item Stack Manipulation Macros
4831
4832 djSP, LVRET
4833
4834 =item SV Manipulation Functions
4835
4836 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4837
4838 =item AUTHORS
4839
4840 =item SEE ALSO
4841
4842 =back
4843
4844 =head2 perliol - C API for Perl's implementation of IO in Layers.
4845
4846 =over 4
4847
4848 =item SYNOPSIS
4849
4850 =item DESCRIPTION
4851
4852 =over 4
4853
4854 =item History and Background
4855
4856 =item Basic Structure
4857
4858 =item Layers vs Disciplines
4859
4860 =item Data Structures
4861
4862 =item Functions and Attributes
4863
4864 =item Per-instance Data
4865
4866 =item Layers in action.
4867
4868 =item Per-instance flag bits
4869
4870 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4871 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4872 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4873 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4874
4875 =item Methods in Detail
4876
4877 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4878 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4879 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4880 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4881 Set_ptrcnt
4882
4883 =item Utilities
4884
4885 =item Implementing PerlIO Layers
4886
4887 C implementations, Perl implementations
4888
4889 =item Core Layers
4890
4891 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4892
4893 =item Extension Layers
4894
4895 ":encoding", ":scalar", ":via"
4896
4897 =back
4898
4899 =item TODO
4900
4901 =back
4902
4903 =head2 perlapio - perl's IO abstraction interface.
4904
4905 =over 4
4906
4907 =item SYNOPSIS
4908
4909 =item DESCRIPTION
4910
4911 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4912 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4913 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4914 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4915 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4916 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4917 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4918 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4919 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4920 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4921 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4922
4923 =over 4
4924
4925 =item Co-existence with stdio
4926
4927 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4928 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4929
4930 =item "Fast gets" Functions
4931
4932 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4933 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4934 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4935 B<PerlIO_get_bufsiz(f)>
4936
4937 =item Other Functions
4938
4939 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4940 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4941
4942 =back
4943
4944 =back
4945
4946 =head2 perlhack - How to hack at the Perl internals
4947
4948 =over 4
4949
4950 =item DESCRIPTION
4951
4952 Does concept match the general goals of Perl?, Where is the
4953 implementation?, Backwards compatibility, Could it be a module instead?, Is
4954 the feature generic enough?, Does it potentially introduce new bugs?, Does
4955 it preclude other desirable features?, Is the implementation robust?, Is
4956 the implementation generic enough to be portable?, Is the implementation
4957 tested?, Is there enough documentation?, Is there another way to do it?,
4958 Does it create too much work?, Patches speak louder than words
4959
4960 =over 4
4961
4962 =item Keeping in sync
4963
4964 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4965 NFS, rsync'ing the patches
4966
4967 =item Why rsync the source tree
4968
4969 It's easier to rsync the source tree, It's more reliable
4970
4971 =item Why rsync the patches
4972
4973 It's easier to rsync the patches, It's a good reference, Finding a start
4974 point, Finding how to fix a bug, Finding the source of misbehaviour
4975
4976 =item Perlbug administration
4977
4978 =item Submitting patches
4979
4980 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4981 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4982
4983 =item Finding Your Way Around
4984
4985 Core modules, Tests, Documentation, Configure, Interpreter
4986
4987 =item Elements of the interpreter
4988
4989 Startup, Parsing, Optimization, Running
4990
4991 =item Internal Variable Types
4992
4993 =item Op Trees
4994
4995 =item Stacks
4996
4997 Argument stack, Mark stack, Save stack
4998
4999 =item Millions of Macros
5000
5001 =item The .i Targets
5002
5003 =item Poking at Perl
5004
5005 =item Using a source-level debugger
5006
5007 run [args], break function_name, break source.c:xxx, step, next, continue,
5008 finish, 'enter', print
5009
5010 =item gdb macro support
5011
5012 =item Dumping Perl Data Structures
5013
5014 =item Patching
5015
5016 =item Patching a core module
5017
5018 =item Adding a new function to the core
5019
5020 =item Writing a test
5021
5022 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5023 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5024 t/cmd t/run t/io t/op, t/lib ext lib
5025
5026 =item Special Make Test Targets
5027
5028 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5029 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5030 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5031 check.utf8, test_harness
5032
5033 =item Running tests by hand
5034
5035 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5036
5037 =back
5038
5039 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5040
5041 =over 4
5042
5043 =item Rational Software's Purify
5044
5045 =item Purify on Unix
5046
5047 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5048
5049 =item Purify on NT
5050
5051 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5052
5053 =item valgrind
5054
5055 =item Compaq's/Digital's/HP's Third Degree
5056
5057 =item PERL_DESTRUCT_LEVEL
5058
5059 =item Profiling
5060
5061 =item Gprof Profiling
5062
5063 -a, -b, -e routine, -f routine, -s, -z
5064
5065 =item GCC gcov Profiling
5066
5067 =item Pixie Profiling
5068
5069 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5070 -z[ero]
5071
5072 =item Miscellaneous tricks
5073
5074 =item CONCLUSION
5075
5076 I<The Road goes ever on and on, down from the door where it began.>
5077
5078 =back
5079
5080 =item AUTHOR
5081
5082 =back
5083
5084 =head2 perlbook - Perl book information
5085
5086 =over 4
5087
5088 =item DESCRIPTION
5089
5090 =back
5091
5092 =head2 perltodo - Perl TO-DO List
5093
5094 =over 4
5095
5096 =item DESCRIPTION
5097
5098 =item To do during 5.6.x
5099
5100 =over 4
5101
5102 =item Support for I/O disciplines
5103
5104 =item Autoload bytes.pm
5105
5106 =item Make "\u{XXXX}" et al work
5107
5108 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
5109
5110 =item Overloadable regex assertions
5111
5112 =item Unicode
5113
5114 =item Work out exit/die semantics for threads
5115
5116 =item Better support for nonpreemptive threading systems like GNU pth
5117
5118 =item Typed lexicals for compiler
5119
5120 =item Compiler workarounds for Win32
5121
5122 =item AUTOLOADing in the compiler
5123
5124 =item Fixing comppadlist when compiling
5125
5126 =item Cleaning up exported namespace
5127
5128 =item Complete signal handling
5129
5130 =item Out-of-source builds
5131
5132 =item POSIX realtime support
5133
5134 =item UNIX98 support
5135
5136 =item IPv6 Support
5137
5138 =item Long double conversion
5139
5140 =item Locales
5141
5142 =item Arithmetic on non-Arabic numerals
5143
5144 =item POSIX Unicode character classes
5145
5146 =item Factoring out common suffices/prefices in regexps (trie optimization)
5147
5148 =item Security audit shipped utilities
5149
5150 =item Sort out the uid-setting mess
5151
5152 =item Custom opcodes
5153
5154 =item DLL Versioning
5155
5156 =item Introduce @( and @)
5157
5158 =item Floating point handling
5159
5160 =item IV/UV preservation
5161
5162 =item Replace pod2html with something using Pod::Parser
5163
5164 =item Automate module testing on CPAN
5165
5166 =item sendmsg and recvmsg
5167
5168 =item Rewrite perlre documentation
5169
5170 =item Convert example code to IO::Handle filehandles
5171
5172 =item Document Win32 choices
5173
5174 =item Check new modules
5175
5176 =item Make roffitall find pods and libs itself
5177
5178 =back
5179
5180 =item To do at some point
5181
5182 =over 4
5183
5184 =item Remove regular expression recursion
5185
5186 =item Memory leaks after failed eval
5187
5188 =item bitfields in pack
5189
5190 =item Cross compilation
5191
5192 =item Perl preprocessor / macros
5193
5194 =item Perl lexer in Perl
5195
5196 =item Using POSIX calls internally
5197
5198 =item -i rename file when changed
5199
5200 =item All ARGV input should act like E<lt>E<gt>
5201
5202 =item Support for rerunning debugger
5203
5204 =item Test Suite for the Debugger
5205
5206 =item my sub foo { }
5207
5208 =item One-pass global destruction
5209
5210 =item Rewrite regexp parser
5211
5212 =item Cache recently used regexps
5213
5214 =item Cross-compilation support
5215
5216 =item Bit-shifting bitvectors
5217
5218 =item debugger pragma
5219
5220 =item use less pragma
5221
5222 =item switch structures
5223
5224 =item Cache eval tree
5225
5226 =item rcatmaybe
5227
5228 =item Shrink opcode tables
5229
5230 =item Optimize away @_
5231
5232 =item Prototypes versus indirect objects
5233
5234 =item Install HTML
5235
5236 =item Prototype method calls
5237
5238 =item Return context prototype declarations
5239
5240 =item magic_setisa
5241
5242 =item Garbage collection
5243
5244 =item IO tutorial
5245
5246 =item Rewrite perldoc
5247
5248 =item Install .3p manpages
5249
5250 =item Unicode tutorial
5251
5252 =item Update POSIX.pm for 1003.1-2
5253
5254 =item Retargetable installation
5255
5256 =item POSIX emulation on non-POSIX systems
5257
5258 =item Rename Win32 headers
5259
5260 =item Finish off lvalue functions
5261
5262 =item Update sprintf documentation
5263
5264 =item Use fchown/fchmod internally
5265
5266 =item Make v-strings overloaded objects
5267
5268 =item Allow restricted hash assignment
5269
5270 =item Should overload be inheritable?
5271
5272 =item Taint rethink
5273
5274 =item Perform correctly when XSUBs call subroutines that exit via
5275 goto(LABEL) and friends
5276
5277 =back
5278
5279 =item Vague ideas
5280
5281 =over 4
5282
5283 =item ref() in list context
5284
5285 =item Make tr/// return histogram of characters in list context
5286
5287 =item Compile to real threaded code
5288
5289 =item Structured types
5290
5291 =item Modifiable $1 et al.
5292
5293 =item Procedural interfaces for IO::*, etc.
5294
5295 =item RPC modules
5296
5297 =item Attach/detach debugger from running program
5298
5299 =item GUI::Native
5300
5301 =item foreach(reverse ...)
5302
5303 =item Constant function cache
5304
5305 =item Approximate regular expression matching
5306
5307 =back
5308
5309 =item Ongoing
5310
5311 =over 4
5312
5313 =item Update guts documentation
5314
5315 =item Add more tests
5316
5317 =item Update auxiliary tools
5318
5319 =item Create debugging macros
5320
5321 =item truncate to the people
5322
5323 =item Unicode in Filenames
5324
5325 =back
5326
5327 =item Unicode in %ENV
5328
5329 =item Recently done things
5330
5331 =over 4
5332
5333 =item Alternative RE syntax module
5334
5335 =item Safe signal handling
5336
5337 =item Tie Modules
5338
5339 =item gettimeofday
5340
5341 =item setitimer and getimiter
5342
5343 =item Testing __DIE__ hook
5344
5345 =item CPP equivalent in Perl
5346
5347 =item Explicit switch statements
5348
5349 =item autocroak
5350
5351 =item UTF/EBCDIC
5352
5353 =item UTF Regexes
5354
5355 =item perlcc to produce executable
5356
5357 =item END blocks saved in compiled output
5358
5359 =item Secure temporary file module
5360
5361 =item Integrate Time::HiRes
5362
5363 =item Turn Cwd into XS
5364
5365 =item Mmap for input
5366
5367 =item Byte to/from UTF-8 and UTF-8 to/from local conversion
5368
5369 =item Add sockatmark support
5370
5371 =item Mailing list archives
5372
5373 =item Bug tracking
5374
5375 =item Integrate MacPerl
5376
5377 =item Web "nerve center" for Perl
5378
5379 =item Regular expression tutorial
5380
5381 =item Debugging Tutorial
5382
5383 =item Integrate new modules
5384
5385 =item Integrate profiler
5386
5387 =item Y2K error detection
5388
5389 =item Regular expression debugger
5390
5391 =item POD checker
5392
5393 =item "Dynamic" lexicals
5394
5395 =item Cache precompiled modules
5396
5397 =back
5398
5399 =item Deprecated Wishes
5400
5401 =over 4
5402
5403 =item Loop control on do{}
5404
5405 =item Lexically scoped typeglobs
5406
5407 =item format BOTTOM
5408
5409 =item report HANDLE
5410
5411 =item Generalised want()/caller())
5412
5413 =item Named prototypes
5414
5415 =item Built-in globbing
5416
5417 =item Regression tests for suidperl
5418
5419 =item Cached hash values
5420
5421 =item Add compression modules
5422
5423 =item Reorganise documentation into tutorials/references
5424
5425 =item Remove distinction between functions and operators
5426
5427 =item Make XS easier to use
5428
5429 =item Make embedding easier to use
5430
5431 =item man for perl
5432
5433 =item my $Package::variable
5434
5435 =item "or" tests defined, not truth
5436
5437 =item "class"-based lexicals
5438
5439 =item byteperl
5440
5441 =item Lazy evaluation / tail recursion removal
5442
5443 =item Make "use utf8" the default
5444
5445 =item Unicode collation and normalization
5446
5447 =item pack/unpack tutorial
5448
5449 =back
5450
5451 =back
5452
5453 =head2 perldoc - Look up Perl documentation in Pod format.
5454
5455 =over 4
5456
5457 =item SYNOPSIS
5458
5459 =item DESCRIPTION
5460
5461 =item OPTIONS
5462
5463 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5464 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5465 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5466 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5467 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5468 B<-V>
5469
5470 =item SECURITY
5471
5472 =item ENVIRONMENT
5473
5474 =item AUTHOR
5475
5476 =back
5477
5478 =head2 perlhist - the Perl history records
5479
5480 =over 4
5481
5482 =item DESCRIPTION
5483
5484 =item INTRODUCTION
5485
5486 =item THE KEEPERS OF THE PUMPKIN
5487
5488 =over 4
5489
5490 =item PUMPKIN?
5491
5492 =back
5493
5494 =item THE RECORDS
5495
5496 =over 4
5497
5498 =item SELECTED RELEASE SIZES
5499
5500 =item SELECTED PATCH SIZES
5501
5502 =back
5503
5504 =item THE KEEPERS OF THE RECORDS
5505
5506 =back
5507
5508 =head2 perl591delta, perldelta - what is new for perl v5.9.1
5509
5510 =over 4
5511
5512 =item DESCRIPTION
5513
5514 =item Incompatible Changes
5515
5516 =item Core Enhancements
5517
5518 =over 4
5519
5520 =item Lexical C<$_>
5521
5522 =item Tied hashes in scalar context
5523
5524 =item Formats
5525
5526 =item The C<:unique> attribute is only meaningful for globals
5527
5528 =item Stacked filetest operators
5529
5530 =back
5531
5532 =item Modules and Pragmata
5533
5534 Carp, Exporter, FindBin, List::Util, threads::shared
5535
5536 =item Utility Changes
5537
5538 =item Documentation
5539
5540 =item Performance Enhancements
5541
5542 =item Installation and Configuration Improvements
5543
5544 =item Selected Bug Fixes
5545
5546 =over 4
5547
5548 =item UTF8 bugs
5549
5550 =item Threading bugs
5551
5552 =item More bugs
5553
5554 =back
5555
5556 =item New or Changed Diagnostics
5557
5558 =item Changed Internals
5559
5560 =item Configuration and Building
5561
5562 =item New Tests
5563
5564 =item Known Problems
5565
5566 =item Platform Specific Problems
5567
5568 =item Reporting Bugs
5569
5570 =item SEE ALSO
5571
5572 =back
5573
5574 =head2 perl590delta, perldelta - what is new for perl v5.9.0
5575
5576 =over 4
5577
5578 =item DESCRIPTION
5579
5580 =item Incompatible Changes
5581
5582 =over 4
5583
5584 =item Hash Randomisation
5585
5586 =item UTF-8 On Filehandles No Longer Activated By Locale
5587
5588 =item Single-number v-strings are no longer v-strings before "=>"
5589
5590 =item (Win32) The -C Switch Has Been Repurposed
5591
5592 =item (Win32) The /d Switch Of cmd.exe
5593
5594 =item The C<$*> variable has been removed
5595
5596 =back
5597
5598 =item Core Enhancements
5599
5600 =over 4
5601
5602 =item Assertions
5603
5604 =item Defined-or operators
5605
5606 =item UTF-8 no longer default under UTF-8 locales
5607
5608 =item Unsafe signals again available
5609
5610 =item Tied Arrays with Negative Array Indices
5611
5612 =item local ${$x}
5613
5614 =item Unicode Character Database 4.0.0
5615
5616 =item Miscellaneous Enhancements
5617
5618 =back
5619
5620 =item Modules and Pragmata
5621
5622 =over 4
5623
5624 =item Updated Modules And Pragmata
5625
5626 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5627 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5628 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5629 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5630 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5631 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5632 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5633 Win32::GetOSVersion
5634
5635 =back
5636
5637 =item Utility Changes
5638
5639 =item New Documentation
5640
5641 =item Performance Enhancements
5642
5643 =item Installation and Configuration Improvements
5644
5645 =over 4
5646
5647 =item Platform-specific enhancements
5648
5649 =back
5650
5651 =item Selected Bug Fixes
5652
5653 =over 4
5654
5655 =item Closures, eval and lexicals
5656
5657 =item Generic fixes
5658
5659 =item Platform-specific fixes
5660
5661 =back
5662
5663 =item New or Changed Diagnostics
5664
5665 =over 4
5666
5667 =item Changed "A thread exited while %d threads were running"
5668
5669 =item Removed "Attempt to clear a restricted hash"
5670
5671 =item New "Illegal declaration of anonymous subroutine"
5672
5673 =item Changed "Invalid range "%s" in transliteration operator"
5674
5675 =item New "Missing control char name in \c"
5676
5677 =item New "Newline in left-justified string for %s"
5678
5679 =item New "Possible precedence problem on bitwise %c operator"
5680
5681 =item New "read() on %s filehandle %s"
5682
5683 =item New "Tied variable freed while still in use"
5684
5685 =item New "To%s: illegal mapping '%s'"
5686
5687 =item New "Use of freed value in iteration"
5688
5689 =back
5690
5691 =item Changed Internals
5692
5693 =item New Tests
5694
5695 =item Known Problems
5696
5697 =over 4
5698
5699 =item Tied hashes in scalar context
5700
5701 =item Net::Ping 450_service and 510_ping_udp failures
5702
5703 =item B::C
5704
5705 =back
5706
5707 =item Platform Specific Problems
5708
5709 =over 4
5710
5711 =item EBCDIC Platforms
5712
5713 =item Cygwin 1.5 problems
5714
5715 =item HP-UX: HP cc warnings about sendfile and sendpath
5716
5717 =item IRIX: t/uni/tr_7jis.t falsely failing
5718
5719 =item Mac OS X: no usemymalloc
5720
5721 =item Tru64: No threaded builds with GNU cc (gcc)
5722
5723 =item Win32: sysopen, sysread, syswrite
5724
5725 =back
5726
5727 =item TODO
5728
5729 =item Reporting Bugs
5730
5731 =item SEE ALSO
5732
5733 =back
5734
5735 =head2 perl583delta - what is new for perl v5.8.3
5736
5737 =over 4
5738
5739 =item DESCRIPTION
5740
5741 =item Incompatible Changes
5742
5743 =item Core Enhancements
5744
5745 =item Modules and Pragmata
5746
5747 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
5748 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
5749 Unicode::Normalize, Test::Harness, threads::shared
5750
5751 =item Utility Changes
5752
5753 =item New Documentation
5754
5755 =item Installation and Configuration Improvements
5756
5757 =item Selected Bug Fixes
5758
5759 =item New or Changed Diagnostics
5760
5761 =item Changed Internals
5762
5763 =item Configuration and Building
5764
5765 =item Platform Specific Problems
5766
5767 =item Known Problems
5768
5769 =item Future Directions
5770
5771 =item Obituary
5772
5773 =item Reporting Bugs
5774
5775 =item SEE ALSO
5776
5777 =back
5778
5779 =head2 perl582delta - what is new for perl v5.8.2
5780
5781 =over 4
5782
5783 =item DESCRIPTION
5784
5785 =item Incompatible Changes
5786
5787 =item Core Enhancements
5788
5789 =over 4
5790
5791 =item Hash Randomisation
5792
5793 =item Threading
5794
5795 =back
5796
5797 =item Modules and Pragmata
5798
5799 =over 4
5800
5801 =item Updated Modules And Pragmata
5802
5803 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
5804 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
5805 Unicode::Normalize, UNIVERSAL
5806
5807 =back
5808
5809 =item Selected Bug Fixes
5810
5811 =item Changed Internals
5812
5813 =item Platform Specific Problems
5814
5815 =item Future Directions
5816
5817 =item Reporting Bugs
5818
5819 =item SEE ALSO
5820
5821 =back
5822
5823 =head2 perl581delta - what is new for perl v5.8.1
5824
5825 =over 4
5826
5827 =item DESCRIPTION
5828
5829 =item Incompatible Changes
5830
5831 =over 4
5832
5833 =item Hash Randomisation
5834
5835 =item UTF-8 On Filehandles No Longer Activated By Locale
5836
5837 =item Single-number v-strings are no longer v-strings before "=>"
5838
5839 =item (Win32) The -C Switch Has Been Repurposed
5840
5841 =item (Win32) The /d Switch Of cmd.exe
5842
5843 =back
5844
5845 =item Core Enhancements
5846
5847 =over 4
5848
5849 =item UTF-8 no longer default under UTF-8 locales
5850
5851 =item Unsafe signals again available
5852
5853 =item Tied Arrays with Negative Array Indices
5854
5855 =item local ${$x}
5856
5857 =item Unicode Character Database 4.0.0
5858
5859 =item Deprecation Warnings
5860
5861 =item Miscellaneous Enhancements
5862
5863 =back
5864
5865 =item Modules and Pragmata
5866
5867 =over 4
5868
5869 =item Updated Modules And Pragmata
5870
5871 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5872 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5873 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5874 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5875 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5876 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5877 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5878 Win32::GetOSVersion
5879
5880 =back
5881
5882 =item Utility Changes
5883
5884 =item New Documentation
5885
5886 =item Installation and Configuration Improvements
5887
5888 =over 4
5889
5890 =item Platform-specific enhancements
5891
5892 =back
5893
5894 =item Selected Bug Fixes
5895
5896 =over 4
5897
5898 =item Closures, eval and lexicals
5899
5900 =item Generic fixes
5901
5902 =item Platform-specific fixes
5903
5904 =back
5905
5906 =item New or Changed Diagnostics
5907
5908 =over 4
5909
5910 =item Changed "A thread exited while %d threads were running"
5911
5912 =item Removed "Attempt to clear a restricted hash"
5913
5914 =item New "Illegal declaration of anonymous subroutine"
5915
5916 =item Changed "Invalid range "%s" in transliteration operator"
5917
5918 =item New "Missing control char name in \c"
5919
5920 =item New "Newline in left-justified string for %s"
5921
5922 =item New "Possible precedence problem on bitwise %c operator"
5923
5924 =item New "Pseudo-hashes are deprecated"
5925
5926 =item New "read() on %s filehandle %s"
5927
5928 =item New "5.005 threads are deprecated"
5929
5930 =item New "Tied variable freed while still in use"
5931
5932 =item New "To%s: illegal mapping '%s'"
5933
5934 =item New "Use of freed value in iteration"
5935
5936 =back
5937
5938 =item Changed Internals
5939
5940 =item New Tests
5941
5942 =item Known Problems
5943
5944 =over 4
5945
5946 =item Tied hashes in scalar context
5947
5948 =item Net::Ping 450_service and 510_ping_udp failures
5949
5950 =item B::C
5951
5952 =back
5953
5954 =item Platform Specific Problems
5955
5956 =over 4
5957
5958 =item EBCDIC Platforms
5959
5960 =item Cygwin 1.5 problems
5961
5962 =item HP-UX: HP cc warnings about sendfile and sendpath
5963
5964 =item IRIX: t/uni/tr_7jis.t falsely failing
5965
5966 =item Mac OS X: no usemymalloc
5967
5968 =item Tru64: No threaded builds with GNU cc (gcc)
5969
5970 =item Win32: sysopen, sysread, syswrite
5971
5972 =back
5973
5974 =item Future Directions
5975
5976 =item Reporting Bugs
5977
5978 =item SEE ALSO
5979
5980 =back
5981
5982 =head2 perl58delta - what is new for perl v5.8.0
5983
5984 =over 4
5985
5986 =item DESCRIPTION
5987
5988 =item Highlights In 5.8.0
5989
5990 =item Incompatible Changes
5991
5992 =over 4
5993
5994 =item Binary Incompatibility
5995
5996 =item 64-bit platforms and malloc
5997
5998 =item AIX Dynaloading
5999
6000 =item Attributes for C<my> variables now handled at run-time
6001
6002 =item Socket Extension Dynamic in VMS
6003
6004 =item IEEE-format Floating Point Default on OpenVMS Alpha
6005
6006 =item New Unicode Semantics (no more C<use utf8>, almost)
6007
6008 =item New Unicode Properties
6009
6010 =item REF(...) Instead Of SCALAR(...)
6011
6012 =item pack/unpack D/F recycled
6013
6014 =item glob() now returns filenames in alphabetical order
6015
6016 =item Deprecations
6017
6018 =back
6019
6020 =item Core Enhancements
6021
6022 =over 4
6023
6024 =item Unicode Overhaul
6025
6026 =item PerlIO is Now The Default
6027
6028 =item ithreads
6029
6030 =item Restricted Hashes
6031
6032 =item Safe Signals
6033
6034 =item Understanding of Numbers
6035
6036 =item Arrays now always interpolate into double-quoted strings [561]
6037
6038 =item Miscellaneous Changes
6039
6040 =back
6041
6042 =item Modules and Pragmata
6043
6044 =over 4
6045
6046 =item New Modules and Pragmata
6047
6048 =item Updated And Improved Modules and Pragmata
6049
6050 =back
6051
6052 =item Utility Changes
6053
6054 =item New Documentation
6055
6056 =item Performance Enhancements
6057
6058 =item Installation and Configuration Improvements
6059
6060 =over 4
6061
6062 =item Generic Improvements
6063
6064 =item New Or Improved Platforms
6065
6066 =back
6067
6068 =item Selected Bug Fixes
6069
6070 =over 4
6071
6072 =item Platform Specific Changes and Fixes
6073
6074 =back
6075
6076 =item New or Changed Diagnostics
6077
6078 =item Changed Internals
6079
6080 =item Security Vulnerability Closed [561]
6081
6082 =item New Tests
6083
6084 =item Known Problems
6085
6086 =over 4
6087
6088 =item The Compiler Suite Is Still Very Experimental
6089
6090 =item Localising Tied Arrays and Hashes Is Broken
6091
6092 =item Building Extensions Can Fail Because Of Largefiles
6093
6094 =item Modifying $_ Inside for(..)
6095
6096 =item mod_perl 1.26 Doesn't Build With Threaded Perl
6097
6098 =item lib/ftmp-security tests warn 'system possibly insecure'
6099
6100 =item libwww-perl (LWP) fails base/date #51
6101
6102 =item PDL failing some tests
6103
6104 =item Perl_get_sv
6105
6106 =item Self-tying Problems
6107
6108 =item ext/threads/t/libc
6109
6110 =item Failure of Thread (5.005-style) tests
6111
6112 =item Timing problems
6113
6114 =item Tied/Magical Array/Hash Elements Do Not Autovivify
6115
6116 =item Unicode in package/class and subroutine names does not work
6117
6118 =back
6119
6120 =item Platform Specific Problems
6121
6122 =over 4
6123
6124 =item AIX
6125
6126 =item Alpha systems with old gccs fail several tests
6127
6128 =item AmigaOS
6129
6130 =item BeOS
6131
6132 =item Cygwin "unable to remap"
6133
6134 =item Cygwin ndbm tests fail on FAT
6135
6136 =item DJGPP Failures
6137
6138 =item FreeBSD built with ithreads coredumps reading large directories
6139
6140 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
6141
6142 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
6143
6144 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6145
6146 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
6147
6148 =item Linux With Sfio Fails op/misc Test 48
6149
6150 =item Mac OS X
6151
6152 =item Mac OS X dyld undefined symbols
6153
6154 =item OS/2 Test Failures
6155
6156 =item op/sprintf tests 91, 129, and 130
6157
6158 =item SCO
6159
6160 =item Solaris 2.5
6161
6162 =item Solaris x86 Fails Tests With -Duse64bitint
6163
6164 =item SUPER-UX (NEC SX)
6165
6166 =item Term::ReadKey not working on Win32
6167
6168 =item UNICOS/mk
6169
6170 =item UTS
6171
6172 =item VOS (Stratus)
6173
6174 =item VMS
6175
6176 =item Win32
6177
6178 =item XML::Parser not working
6179
6180 =item z/OS (OS/390)
6181
6182 =item Unicode Support on EBCDIC Still Spotty
6183
6184 =item Seen In Perl 5.7 But Gone Now
6185
6186 =back
6187
6188 =item Reporting Bugs
6189
6190 =item SEE ALSO
6191
6192 =item HISTORY
6193
6194 =back
6195
6196 =head2 perl573delta - what's new for perl v5.7.3
6197
6198 =over 4
6199
6200 =item DESCRIPTION
6201
6202 =item Changes
6203
6204 =item Reporting Bugs
6205
6206 =item SEE ALSO
6207
6208 =item HISTORY
6209
6210 =back
6211
6212 =head2 perl572delta - what's new for perl v5.7.2
6213
6214 =over 4
6215
6216 =item DESCRIPTION
6217
6218 =item Security Vulnerability Closed
6219
6220 =item Incompatible Changes
6221
6222 =over 4
6223
6224 =item 64-bit platforms and malloc
6225
6226 =item AIX Dynaloading
6227
6228 =item Socket Extension Dynamic in VMS
6229
6230 =item Different Definition of the Unicode Character Classes \p{In...}
6231
6232 =item Deprecations
6233
6234 =back
6235
6236 =item Core Enhancements
6237
6238 =item Modules and Pragmata
6239
6240 =over 4
6241
6242 =item New Modules and Distributions
6243
6244 =item Updated And Improved Modules and Pragmata
6245
6246 =back
6247
6248 =item Utility Changes
6249
6250 =item New Documentation
6251
6252 =item Installation and Configuration Improvements
6253
6254 =over 4
6255
6256 =item New Or Improved Platforms
6257
6258 =item Generic Improvements
6259
6260 =back
6261
6262 =item Selected Bug Fixes
6263
6264 =over 4
6265
6266 =item Platform Specific Changes and Fixes
6267
6268 =back
6269
6270 =item New or Changed Diagnostics
6271
6272 =item Source Code Enhancements
6273
6274 =over 4
6275
6276 =item MAGIC constants
6277
6278 =item Better commented code
6279
6280 =item Regex pre-/post-compilation items matched up
6281
6282 =item gcc -Wall
6283
6284 =back
6285
6286 =item New Tests
6287
6288 =item Known Problems
6289
6290 =over 4
6291
6292 =item AIX
6293
6294 =item Amiga Perl Invoking Mystery
6295
6296 =item lib/ftmp-security tests warn 'system possibly insecure'
6297
6298 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6299
6300 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6301
6302 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6303
6304 =item Linux With Sfio Fails op/misc Test 48
6305
6306 =item OS/390
6307
6308 =item op/sprintf tests 129 and 130
6309
6310 =item  Failure of Thread tests
6311
6312 =item UNICOS
6313
6314 =item UTS
6315
6316 =item VMS
6317
6318 =item Win32
6319
6320 =item Localising a Tied Variable Leaks Memory
6321
6322 =item Self-tying of Arrays and Hashes Is Forbidden
6323
6324 =item Variable Attributes are not Currently Usable for Tieing
6325
6326 =item Building Extensions Can Fail Because Of Largefiles
6327
6328 =item The Compiler Suite Is Still Experimental
6329
6330 =item The Long Double Support is Still Experimental
6331
6332 =back
6333
6334 =item Reporting Bugs
6335
6336 =item SEE ALSO
6337
6338 =item HISTORY
6339
6340 =back
6341
6342 =head2 perl571delta - what's new for perl v5.7.1
6343
6344 =over 4
6345
6346 =item DESCRIPTION
6347
6348 =item Security Vulnerability Closed
6349
6350 =item Incompatible Changes
6351
6352 =item Core Enhancements
6353
6354 =over 4
6355
6356 =item AUTOLOAD Is Now Lvaluable
6357
6358 =item PerlIO is Now The Default
6359
6360 =item Signals Are Now Safe
6361
6362 =back
6363
6364 =item Modules and Pragmata
6365
6366 =over 4
6367
6368 =item New Modules
6369
6370 =item Updated And Improved Modules and Pragmata
6371
6372 =back
6373
6374 =item Performance Enhancements
6375
6376 =item Utility Changes
6377
6378 =item New Documentation
6379
6380 =over 4
6381
6382 =item perlclib
6383
6384 =item perliol
6385
6386 =item README.aix
6387
6388 =item README.bs2000
6389
6390 =item README.macos
6391
6392 =item README.mpeix
6393
6394 =item README.solaris
6395
6396 =item README.vos
6397
6398 =item Porting/repository.pod
6399
6400 =back
6401
6402 =item Installation and Configuration Improvements
6403
6404 =over 4
6405
6406 =item New Or Improved Platforms
6407
6408 =item Generic Improvements
6409
6410 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6411 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6412 d_strtoq, d_u32align, d_ualarm, d_usleep
6413
6414 =back
6415
6416 =item Selected Bug Fixes
6417
6418 =over 4
6419
6420 =item Platform Specific Changes and Fixes
6421
6422 =back
6423
6424 =item New or Changed Diagnostics
6425
6426 =item Changed Internals
6427
6428 =item New Tests
6429
6430 =item Known Problems
6431
6432 =over 4
6433
6434 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6435
6436 =item lib/ftmp-security tests warn 'system possibly insecure'
6437
6438 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6439
6440 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6441
6442 =item lib/b test 19
6443
6444 =item Linux With Sfio Fails op/misc Test 48
6445
6446 =item sigaction test 13 in VMS
6447
6448 =item sprintf tests 129 and 130
6449
6450 =item  Failure of Thread tests
6451
6452 =item Localising a Tied Variable Leaks Memory
6453
6454 =item Self-tying of Arrays and Hashes Is Forbidden
6455
6456 =item Building Extensions Can Fail Because Of Largefiles
6457
6458 =item The Compiler Suite Is Still Experimental
6459
6460 =back
6461
6462 =item Reporting Bugs
6463
6464 =item SEE ALSO
6465
6466 =item HISTORY
6467
6468 =back
6469
6470 =head2 perl570delta - what's new for perl v5.7.0
6471
6472 =over 4
6473
6474 =item DESCRIPTION
6475
6476 =item Security Vulnerability Closed
6477
6478 =item Incompatible Changes
6479
6480 =item Core Enhancements
6481
6482 =item Modules and Pragmata
6483
6484 =over 4
6485
6486 =item New Modules
6487
6488 =item Updated And Improved Modules and Pragmata
6489
6490 =back
6491
6492 =item Utility Changes
6493
6494 =item New Documentation
6495
6496 =item Performance Enhancements
6497
6498 =item Installation and Configuration Improvements
6499
6500 =over 4
6501
6502 =item Generic Improvements
6503
6504 =back
6505
6506 =item Selected Bug Fixes
6507
6508 =over 4
6509
6510 =item Platform Specific Changes and Fixes
6511
6512 =back
6513
6514 =item New or Changed Diagnostics
6515
6516 =item Changed Internals
6517
6518 =item Known Problems
6519
6520 =over 4
6521
6522 =item Unicode Support Still Far From Perfect
6523
6524 =item EBCDIC Still A Lost Platform
6525
6526 =item Building Extensions Can Fail Because Of Largefiles
6527
6528 =item ftmp-security tests warn 'system possibly insecure'
6529
6530 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6531
6532 =item Long Doubles Still Don't Work In Solaris
6533
6534 =item Linux With Sfio Fails op/misc Test 48
6535
6536 =item Storable tests fail in some platforms
6537
6538 =item Threads Are Still Experimental
6539
6540 =item The Compiler Suite Is Still Experimental
6541
6542 =back
6543
6544 =item Reporting Bugs
6545
6546 =item SEE ALSO
6547
6548 =item HISTORY
6549
6550 =back
6551
6552 =head2 perl561delta - what's new for perl v5.6.x
6553
6554 =over 4
6555
6556 =item DESCRIPTION
6557
6558 =item Summary of changes between 5.6.0 and 5.6.1
6559
6560 =over 4
6561
6562 =item Security Issues
6563
6564 =item Core bug fixes
6565
6566 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6567 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6568 references to special variables, Lexical warnings, Spurious warnings and
6569 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6570 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6571 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6572 Module;>, Tests
6573
6574 =item Core features
6575
6576 =item Configuration issues
6577
6578 =item Documentation
6579
6580 =item Bundled modules
6581
6582 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6583 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6584 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6585 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6586
6587 =item Platform-specific improvements
6588
6589 NCR MP-RAS, NonStop-UX
6590
6591 =back
6592
6593 =item Core Enhancements
6594
6595 =over 4
6596
6597 =item Interpreter cloning, threads, and concurrency
6598
6599 =item Lexically scoped warning categories
6600
6601 =item Unicode and UTF-8 support
6602
6603 =item Support for interpolating named characters
6604
6605 =item "our" declarations
6606
6607 =item Support for strings represented as a vector of ordinals
6608
6609 =item Improved Perl version numbering system
6610
6611 =item New syntax for declaring subroutine attributes
6612
6613 =item File and directory handles can be autovivified
6614
6615 =item open() with more than two arguments
6616
6617 =item 64-bit support
6618
6619 =item Large file support
6620
6621 =item Long doubles
6622
6623 =item "more bits"
6624
6625 =item Enhanced support for sort() subroutines
6626
6627 =item C<sort $coderef @foo> allowed
6628
6629 =item File globbing implemented internally
6630
6631 =item Support for CHECK blocks
6632
6633 =item POSIX character class syntax [: :] supported
6634
6635 =item Better pseudo-random number generator
6636
6637 =item Improved C<qw//> operator
6638
6639 =item Better worst-case behavior of hashes
6640
6641 =item pack() format 'Z' supported
6642
6643 =item pack() format modifier '!' supported
6644
6645 =item pack() and unpack() support counted strings
6646
6647 =item Comments in pack() templates
6648
6649 =item Weak references
6650
6651 =item Binary numbers supported
6652
6653 =item Lvalue subroutines
6654
6655 =item Some arrows may be omitted in calls through references
6656
6657 =item Boolean assignment operators are legal lvalues
6658
6659 =item exists() is supported on subroutine names
6660
6661 =item exists() and delete() are supported on array elements
6662
6663 =item Pseudo-hashes work better
6664
6665 =item Automatic flushing of output buffers
6666
6667 =item Better diagnostics on meaningless filehandle operations
6668
6669 =item Where possible, buffered data discarded from duped input filehandle
6670
6671 =item eof() has the same old magic as <>
6672
6673 =item binmode() can be used to set :crlf and :raw modes
6674
6675 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6676
6677 =item system(), backticks and pipe open now reflect exec() failure
6678
6679 =item Improved diagnostics
6680
6681 =item Diagnostics follow STDERR
6682
6683 =item More consistent close-on-exec behavior
6684
6685 =item syswrite() ease-of-use
6686
6687 =item Better syntax checks on parenthesized unary operators
6688
6689 =item Bit operators support full native integer width
6690
6691 =item Improved security features
6692
6693 =item More functional bareword prototype (*)
6694
6695 =item C<require> and C<do> may be overridden
6696
6697 =item $^X variables may now have names longer than one character
6698
6699 =item New variable $^C reflects C<-c> switch
6700
6701 =item New variable $^V contains Perl version as a string
6702
6703 =item Optional Y2K warnings
6704
6705 =item Arrays now always interpolate into double-quoted strings
6706
6707 =back
6708
6709 =item Modules and Pragmata
6710
6711 =over 4
6712
6713 =item Modules
6714
6715 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6716 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6717 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6718 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6719 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6720 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6721 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6722 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6723
6724 =item Pragmata
6725
6726 =back
6727
6728 =item Utility Changes
6729
6730 =over 4
6731
6732 =item dprofpp
6733
6734 =item find2perl
6735
6736 =item h2xs
6737
6738 =item perlcc
6739
6740 =item perldoc
6741
6742 =item The Perl Debugger
6743
6744 =back
6745
6746 =item Improved Documentation
6747
6748 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6749 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6750 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6751 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6752
6753 =item Performance enhancements
6754
6755 =over 4
6756
6757 =item Simple sort() using { $a <=> $b } and the like are optimized
6758
6759 =item Optimized assignments to lexical variables
6760
6761 =item Faster subroutine calls
6762
6763 =item delete(), each(), values() and hash iteration are faster
6764
6765 =back
6766
6767 =item Installation and Configuration Improvements
6768
6769 =over 4
6770
6771 =item -Dusethreads means something different
6772
6773 =item New Configure flags
6774
6775 =item Threadedness and 64-bitness now more daring
6776
6777 =item Long Doubles
6778
6779 =item -Dusemorebits
6780
6781 =item -Duselargefiles
6782
6783 =item installusrbinperl
6784
6785 =item SOCKS support
6786
6787 =item C<-A> flag
6788
6789 =item Enhanced Installation Directories
6790
6791 =item gcc automatically tried if 'cc' does not seem to be working
6792
6793 =back
6794
6795 =item Platform specific changes
6796
6797 =over 4
6798
6799 =item Supported platforms
6800
6801 =item DOS
6802
6803 =item OS390 (OpenEdition MVS)
6804
6805 =item VMS
6806
6807 =item Win32
6808
6809 =back
6810
6811 =item Significant bug fixes
6812
6813 =over 4
6814
6815 =item <HANDLE> on empty files
6816
6817 =item C<eval '...'> improvements
6818
6819 =item All compilation errors are true errors
6820
6821 =item Implicitly closed filehandles are safer
6822
6823 =item Behavior of list slices is more consistent
6824
6825 =item C<(\$)> prototype and C<$foo{a}>
6826
6827 =item C<goto &sub> and AUTOLOAD
6828
6829 =item C<-bareword> allowed under C<use integer>
6830
6831 =item Failures in DESTROY()
6832
6833 =item Locale bugs fixed
6834
6835 =item Memory leaks
6836
6837 =item Spurious subroutine stubs after failed subroutine calls
6838
6839 =item Taint failures under C<-U>
6840
6841 =item END blocks and the C<-c> switch
6842
6843 =item Potential to leak DATA filehandles
6844
6845 =back
6846
6847 =item New or Changed Diagnostics
6848
6849 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6850 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6851 / cannot take a count, / must be followed by a, A or Z, / must be followed
6852 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6853 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6854 passed through, /%s/ should probably be written as "%s", %s() called too
6855 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6856 argument is not a HASH or ARRAY element or slice, %s argument is not a
6857 subroutine name, %s package attribute may clash with future reserved word:
6858 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6859 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6860 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6861 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6862 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6863 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6864 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6865 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6866 weaken a nonreference, Character class [:%s:] unknown, Character class
6867 syntax [%s] belongs inside character classes, Constant is not %s reference,
6868 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6869 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6870 "local" instead of "our"?), Document contains no data, entering effective
6871 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6872 output, flock() on closed filehandle %s, Global symbol "%s" requires
6873 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6874 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6875 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6876 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6877 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6878 separator character %s in attribute list, Invalid separator character %s in
6879 subroutine attribute list, leaving effective %s failed, Lvalue subs
6880 returning %s not implemented yet, Method %s not permitted, Missing
6881 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6882 No %s specified for -%c, No package name allowed for variable %s in "our",
6883 No space allowed after -%c, no UTC offset information; assuming local time
6884 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6885 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6886 around "%s" list, Possible unintended interpolation of %s in string,
6887 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6888 instead, Premature end of script headers, Repeat count in pack overflows,
6889 Repeat count in unpack overflows, realloc() of freed memory ignored,
6890 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6891 zero-length expression, switching effective %s is not implemented, This
6892 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6893 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6894 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6895 escape \\%c passed through, Unterminated attribute parameter in attribute
6896 list, Unterminated attribute list, Unterminated attribute parameter in
6897 subroutine attribute list, Unterminated subroutine attribute list, Value of
6898 CLI symbol "%s" too long, Version number must be a constant number
6899
6900 =item New tests
6901
6902 =item Incompatible Changes
6903
6904 =over 4
6905
6906 =item Perl Source Incompatibilities
6907
6908 CHECK is a new keyword, Treatment of list slices of undef has changed,
6909 Format of $English::PERL_VERSION is different, Literals of the form
6910 C<1.2.3> parse differently, Possibly changed pseudo-random number
6911 generator, Hashing function for hash keys has changed, C<undef> fails on
6912 read only values, Close-on-exec bit may be set on pipe and socket handles,
6913 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6914 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6915 Text of some diagnostic output has changed, C<%@> has been removed,
6916 Parenthesized not() behaves like a list operator, Semantics of bareword
6917 prototype C<(*)> have changed, Semantics of bit operators may have changed
6918 on 64-bit platforms, More builtins taint their results
6919
6920 =item C Source Incompatibilities
6921
6922 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6923
6924 =item Compatible C Source API Changes
6925
6926 C<PATCHLEVEL> is now C<PERL_VERSION>
6927
6928 =item Binary Incompatibilities
6929
6930 =back
6931
6932 =item Known Problems
6933
6934 =over 4
6935
6936 =item Localizing a tied hash element may leak memory
6937
6938 =item Known test failures
6939
6940 =item EBCDIC platforms not fully supported
6941
6942 =item UNICOS/mk CC failures during Configure run
6943
6944 =item Arrow operator and arrays
6945
6946 =item Experimental features
6947
6948 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6949 pseudo-hash data type, The Compiler suite, Internal implementation of file
6950 globbing, The DB module, The regular expression code constructs:
6951
6952 =back
6953
6954 =item Obsolete Diagnostics
6955
6956 Character class syntax [: :] is reserved for future extensions, Ill-formed
6957 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6958 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6959 to mean "${$}<digit>" is deprecated
6960
6961 =item Reporting Bugs
6962
6963 =item SEE ALSO
6964
6965 =item HISTORY
6966
6967 =back
6968
6969 =head2 perl56delta - what's new for perl v5.6.0
6970
6971 =over 4
6972
6973 =item DESCRIPTION
6974
6975 =item Core Enhancements
6976
6977 =over 4
6978
6979 =item Interpreter cloning, threads, and concurrency
6980
6981 =item Lexically scoped warning categories
6982
6983 =item Unicode and UTF-8 support
6984
6985 =item Support for interpolating named characters
6986
6987 =item "our" declarations
6988
6989 =item Support for strings represented as a vector of ordinals
6990
6991 =item Improved Perl version numbering system
6992
6993 =item New syntax for declaring subroutine attributes
6994
6995 =item File and directory handles can be autovivified
6996
6997 =item open() with more than two arguments
6998
6999 =item 64-bit support
7000
7001 =item Large file support
7002
7003 =item Long doubles
7004
7005 =item "more bits"
7006
7007 =item Enhanced support for sort() subroutines
7008
7009 =item C<sort $coderef @foo> allowed
7010
7011 =item File globbing implemented internally
7012
7013 =item Support for CHECK blocks
7014
7015 =item POSIX character class syntax [: :] supported
7016
7017 =item Better pseudo-random number generator
7018
7019 =item Improved C<qw//> operator
7020
7021 =item Better worst-case behavior of hashes
7022
7023 =item pack() format 'Z' supported
7024
7025 =item pack() format modifier '!' supported
7026
7027 =item pack() and unpack() support counted strings
7028
7029 =item Comments in pack() templates
7030
7031 =item Weak references
7032
7033 =item Binary numbers supported
7034
7035 =item Lvalue subroutines
7036
7037 =item Some arrows may be omitted in calls through references
7038
7039 =item Boolean assignment operators are legal lvalues
7040
7041 =item exists() is supported on subroutine names
7042
7043 =item exists() and delete() are supported on array elements
7044
7045 =item Pseudo-hashes work better
7046
7047 =item Automatic flushing of output buffers
7048
7049 =item Better diagnostics on meaningless filehandle operations
7050
7051 =item Where possible, buffered data discarded from duped input filehandle
7052
7053 =item eof() has the same old magic as <>
7054
7055 =item binmode() can be used to set :crlf and :raw modes
7056
7057 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7058
7059 =item system(), backticks and pipe open now reflect exec() failure
7060
7061 =item Improved diagnostics
7062
7063 =item Diagnostics follow STDERR
7064
7065 =item More consistent close-on-exec behavior
7066
7067 =item syswrite() ease-of-use
7068
7069 =item Better syntax checks on parenthesized unary operators
7070
7071 =item Bit operators support full native integer width
7072
7073 =item Improved security features
7074
7075 =item More functional bareword prototype (*)
7076
7077 =item C<require> and C<do> may be overridden
7078
7079 =item $^X variables may now have names longer than one character
7080
7081 =item New variable $^C reflects C<-c> switch
7082
7083 =item New variable $^V contains Perl version as a string
7084
7085 =item Optional Y2K warnings
7086
7087 =item Arrays now always interpolate into double-quoted strings
7088
7089 =back
7090
7091 =item Modules and Pragmata
7092
7093 =over 4
7094
7095 =item Modules
7096
7097 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7098 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7099 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7100 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7101 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7102 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7103 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7104 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7105
7106 =item Pragmata
7107
7108 =back
7109
7110 =item Utility Changes
7111
7112 =over 4
7113
7114 =item dprofpp
7115
7116 =item find2perl
7117
7118 =item h2xs
7119
7120 =item perlcc
7121
7122 =item perldoc
7123
7124 =item The Perl Debugger
7125
7126 =back
7127
7128 =item Improved Documentation
7129
7130 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7131 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7132 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7133 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7134
7135 =item Performance enhancements
7136
7137 =over 4
7138
7139 =item Simple sort() using { $a <=> $b } and the like are optimized
7140
7141 =item Optimized assignments to lexical variables
7142
7143 =item Faster subroutine calls
7144
7145 =item delete(), each(), values() and hash iteration are faster
7146
7147 =back
7148
7149 =item Installation and Configuration Improvements
7150
7151 =over 4
7152
7153 =item -Dusethreads means something different
7154
7155 =item New Configure flags
7156
7157 =item Threadedness and 64-bitness now more daring
7158
7159 =item Long Doubles
7160
7161 =item -Dusemorebits
7162
7163 =item -Duselargefiles
7164
7165 =item installusrbinperl
7166
7167 =item SOCKS support
7168
7169 =item C<-A> flag
7170
7171 =item Enhanced Installation Directories
7172
7173 =back
7174
7175 =item Platform specific changes
7176
7177 =over 4
7178
7179 =item Supported platforms
7180
7181 =item DOS
7182
7183 =item OS390 (OpenEdition MVS)
7184
7185 =item VMS
7186
7187 =item Win32
7188
7189 =back
7190
7191 =item Significant bug fixes
7192
7193 =over 4
7194
7195 =item <HANDLE> on empty files
7196
7197 =item C<eval '...'> improvements
7198
7199 =item All compilation errors are true errors
7200
7201 =item Implicitly closed filehandles are safer
7202
7203 =item Behavior of list slices is more consistent
7204
7205 =item C<(\$)> prototype and C<$foo{a}>
7206
7207 =item C<goto &sub> and AUTOLOAD
7208
7209 =item C<-bareword> allowed under C<use integer>
7210
7211 =item Failures in DESTROY()
7212
7213 =item Locale bugs fixed
7214
7215 =item Memory leaks
7216
7217 =item Spurious subroutine stubs after failed subroutine calls
7218
7219 =item Taint failures under C<-U>
7220
7221 =item END blocks and the C<-c> switch
7222
7223 =item Potential to leak DATA filehandles
7224
7225 =back
7226
7227 =item New or Changed Diagnostics
7228
7229 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7230 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7231 / cannot take a count, / must be followed by a, A or Z, / must be followed
7232 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7233 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7234 passed through, /%s/ should probably be written as "%s", %s() called too
7235 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7236 argument is not a HASH or ARRAY element or slice, %s argument is not a
7237 subroutine name, %s package attribute may clash with future reserved word:
7238 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7239 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7240 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7241 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7242 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7243 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7244 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7245 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7246 weaken a nonreference, Character class [:%s:] unknown, Character class
7247 syntax [%s] belongs inside character classes, Constant is not %s reference,
7248 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7249 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7250 "local" instead of "our"?), Document contains no data, entering effective
7251 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7252 output, flock() on closed filehandle %s, Global symbol "%s" requires
7253 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7254 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7255 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7256 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7257 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7258 separator character %s in attribute list, Invalid separator character %s in
7259 subroutine attribute list, leaving effective %s failed, Lvalue subs
7260 returning %s not implemented yet, Method %s not permitted, Missing
7261 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7262 No %s specified for -%c, No package name allowed for variable %s in "our",
7263 No space allowed after -%c, no UTC offset information; assuming local time
7264 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7265 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7266 around "%s" list, Possible unintended interpolation of %s in string,
7267 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7268 instead, Premature end of script headers, Repeat count in pack overflows,
7269 Repeat count in unpack overflows, realloc() of freed memory ignored,
7270 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7271 zero-length expression, switching effective %s is not implemented, This
7272 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7273 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7274 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7275 escape \\%c passed through, Unterminated attribute parameter in attribute
7276 list, Unterminated attribute list, Unterminated attribute parameter in
7277 subroutine attribute list, Unterminated subroutine attribute list, Value of
7278 CLI symbol "%s" too long, Version number must be a constant number
7279
7280 =item New tests
7281
7282 =item Incompatible Changes
7283
7284 =over 4
7285
7286 =item Perl Source Incompatibilities
7287
7288 CHECK is a new keyword, Treatment of list slices of undef has changed,
7289 Format of $English::PERL_VERSION is different, Literals of the form
7290 C<1.2.3> parse differently, Possibly changed pseudo-random number
7291 generator, Hashing function for hash keys has changed, C<undef> fails on
7292 read only values, Close-on-exec bit may be set on pipe and socket handles,
7293 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7294 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7295 Text of some diagnostic output has changed, C<%@> has been removed,
7296 Parenthesized not() behaves like a list operator, Semantics of bareword
7297 prototype C<(*)> have changed, Semantics of bit operators may have changed
7298 on 64-bit platforms, More builtins taint their results
7299
7300 =item C Source Incompatibilities
7301
7302 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7303
7304 =item Compatible C Source API Changes
7305
7306 C<PATCHLEVEL> is now C<PERL_VERSION>
7307
7308 =item Binary Incompatibilities
7309
7310 =back
7311
7312 =item Known Problems
7313
7314 =over 4
7315
7316 =item Thread test failures
7317
7318 =item EBCDIC platforms not supported
7319
7320 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7321
7322 =item NEXTSTEP 3.3 POSIX test failure
7323
7324 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7325 gcc
7326
7327 =item UNICOS/mk CC failures during Configure run
7328
7329 =item Arrow operator and arrays
7330
7331 =item Experimental features
7332
7333 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7334 pseudo-hash data type, The Compiler suite, Internal implementation of file
7335 globbing, The DB module, The regular expression code constructs:
7336
7337 =back
7338
7339 =item Obsolete Diagnostics
7340
7341 Character class syntax [: :] is reserved for future extensions, Ill-formed
7342 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7343 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7344 to mean "${$}<digit>" is deprecated
7345
7346 =item Reporting Bugs
7347
7348 =item SEE ALSO
7349
7350 =item HISTORY
7351
7352 =back
7353
7354 =head2 perl5005delta - what's new for perl5.005
7355
7356 =over 4
7357
7358 =item DESCRIPTION
7359
7360 =item About the new versioning system
7361
7362 =item Incompatible Changes
7363
7364 =over 4
7365
7366 =item WARNING:  This version is not binary compatible with Perl 5.004.
7367
7368 =item Default installation structure has changed
7369
7370 =item Perl Source Compatibility
7371
7372 =item C Source Compatibility
7373
7374 =item Binary Compatibility
7375
7376 =item Security fixes may affect compatibility
7377
7378 =item Relaxed new mandatory warnings introduced in 5.004
7379
7380 =item Licensing
7381
7382 =back
7383
7384 =item Core Changes
7385
7386 =over 4
7387
7388 =item Threads
7389
7390 =item Compiler
7391
7392 =item Regular Expressions
7393
7394 Many new and improved optimizations, Many bug fixes, New regular expression
7395 constructs, New operator for precompiled regular expressions, Other
7396 improvements, Incompatible changes
7397
7398 =item   Improved malloc()
7399
7400 =item Quicksort is internally implemented
7401
7402 =item Reliable signals
7403
7404 =item Reliable stack pointers
7405
7406 =item More generous treatment of carriage returns
7407
7408 =item Memory leaks
7409
7410 =item Better support for multiple interpreters
7411
7412 =item Behavior of local() on array and hash elements is now well-defined
7413
7414 =item C<%!> is transparently tied to the L<Errno> module
7415
7416 =item Pseudo-hashes are supported
7417
7418 =item C<EXPR foreach EXPR> is supported
7419
7420 =item Keywords can be globally overridden
7421
7422 =item C<$^E> is meaningful on Win32
7423
7424 =item C<foreach (1..1000000)> optimized
7425
7426 =item C<Foo::> can be used as implicitly quoted package name
7427
7428 =item C<exists $Foo::{Bar::}> tests existence of a package
7429
7430 =item Better locale support
7431
7432 =item Experimental support for 64-bit platforms
7433
7434 =item prototype() returns useful results on builtins
7435
7436 =item Extended support for exception handling
7437
7438 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7439
7440 =item All C<printf> format conversions are handled internally
7441
7442 =item New C<INIT> keyword
7443
7444 =item New C<lock> keyword
7445
7446 =item New C<qr//> operator
7447
7448 =item C<our> is now a reserved word
7449
7450 =item Tied arrays are now fully supported
7451
7452 =item Tied handles support is better
7453
7454 =item 4th argument to substr
7455
7456 =item Negative LENGTH argument to splice
7457
7458 =item Magic lvalues are now more magical
7459
7460 =item <> now reads in records
7461
7462 =back
7463
7464 =item Supported Platforms
7465
7466 =over 4
7467
7468 =item New Platforms
7469
7470 =item Changes in existing support
7471
7472 =back
7473
7474 =item Modules and Pragmata
7475
7476 =over 4
7477
7478 =item New Modules
7479
7480 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7481 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7482 Thread, attrs, fields, re
7483
7484 =item Changes in existing modules
7485
7486 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7487 MakeMaker, CPAN, Cwd
7488
7489 =back
7490
7491 =item Utility Changes
7492
7493 =item Documentation Changes
7494
7495 =item New Diagnostics
7496
7497 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7498 while coercing array into hash, Bareword "%s" refers to nonexistent
7499 package, Can't call method "%s" on an undefined value, Can't check
7500 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7501 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7502 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7503 for "%s", Character class syntax [. .] is reserved for future extensions,
7504 Character class syntax [: :] is reserved for future extensions, Character
7505 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7506 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7507 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7508 package main), Illegal hex digit ignored, No such array field, No such
7509 field "%s" in variable %s of type %s, Out of memory during ridiculously
7510 large request, Range iterator outside integer range, Recursive inheritance
7511 detected while looking for method '%s' %s, Reference found where even-sized
7512 list expected, Undefined value assigned to typeglob, Use of reserved word
7513 "%s" is deprecated, perl: warning: Setting locale failed
7514
7515 =item Obsolete Diagnostics
7516
7517 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7518 temporary file, regexp too big
7519
7520 =item Configuration Changes
7521
7522 =item BUGS
7523
7524 =item SEE ALSO
7525
7526 =item HISTORY
7527
7528 =back
7529
7530 =head2 perl5004delta - what's new for perl5.004
7531
7532 =over 4
7533
7534 =item DESCRIPTION
7535
7536 =item Supported Environments
7537
7538 =item Core Changes
7539
7540 =over 4
7541
7542 =item List assignment to %ENV works
7543
7544 =item Change to "Can't locate Foo.pm in @INC" error
7545
7546 =item Compilation option: Binary compatibility with 5.003
7547
7548 =item $PERL5OPT environment variable
7549
7550 =item Limitations on B<-M>, B<-m>, and B<-T> options
7551
7552 =item More precise warnings
7553
7554 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7555
7556 =item Previously deprecated %OVERLOAD is no longer usable
7557
7558 =item Subroutine arguments created only when they're modified
7559
7560 =item Group vector changeable with C<$)>
7561
7562 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7563
7564 =item Fixed localization of $<digit>, $&, etc.
7565
7566 =item No resetting of $. on implicit close
7567
7568 =item C<wantarray> may return undef
7569
7570 =item C<eval EXPR> determines value of EXPR in scalar context
7571
7572 =item Changes to tainting checks
7573
7574 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7575 spawning if tainted $TERM doesn't look like a terminal name
7576
7577 =item New Opcode module and revised Safe module
7578
7579 =item Embedding improvements
7580
7581 =item Internal change: FileHandle class based on IO::* classes
7582
7583 =item Internal change: PerlIO abstraction interface
7584
7585 =item New and changed syntax
7586
7587 $coderef->(PARAMS)
7588
7589 =item New and changed builtin constants
7590
7591 __PACKAGE__
7592
7593 =item New and changed builtin variables
7594
7595 $^E, $^H, $^M
7596
7597 =item New and changed builtin functions
7598
7599 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7600 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7601 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7602 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7603 nested C<sub{}> closures work now, formats work right on changing lexicals
7604
7605 =item New builtin methods
7606
7607 isa(CLASS), can(METHOD), VERSION( [NEED] )
7608
7609 =item TIEHANDLE now supported
7610
7611 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7612 LIST, READLINE this, GETC this, DESTROY this
7613
7614 =item Malloc enhancements
7615
7616 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7617
7618 =item Miscellaneous efficiency enhancements
7619
7620 =back
7621
7622 =item Support for More Operating Systems
7623
7624 =over 4
7625
7626 =item Win32
7627
7628 =item Plan 9
7629
7630 =item QNX
7631
7632 =item AmigaOS
7633
7634 =back
7635
7636 =item Pragmata
7637
7638 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7639 constant NAME => VALUE, use locale, use ops, use vmsish
7640
7641 =item Modules
7642
7643 =over 4
7644
7645 =item Required Updates
7646
7647 =item Installation directories
7648
7649 =item Module information summary
7650
7651 =item Fcntl
7652
7653 =item IO
7654
7655 =item Math::Complex
7656
7657 =item Math::Trig
7658
7659 =item DB_File
7660
7661 =item Net::Ping
7662
7663 =item Object-oriented overrides for builtin operators
7664
7665 =back
7666
7667 =item Utility Changes
7668
7669 =over 4
7670
7671 =item pod2html
7672
7673 Sends converted HTML to standard output
7674
7675 =item xsubpp
7676
7677 C<void> XSUBs now default to returning nothing
7678
7679 =back
7680
7681 =item C Language API Changes
7682
7683 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7684 manipulating hashes
7685
7686 =item Documentation Changes
7687
7688 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7689 L<perlmodlib>, L<perldebug>, L<perlsec>
7690
7691 =item New Diagnostics
7692
7693 "my" variable %s masks earlier declaration in same scope, %s argument is
7694 not a HASH element or slice, Allocation too large: %lx, Allocation too
7695 large, Applying %s to %s will act on scalar(%s), Attempt to free
7696 nonexistent shared string, Attempt to use reference as lvalue in substr,
7697 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7698 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7699 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7700 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7701 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7702 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7703 %s, Integer overflow in hex number, Integer overflow in octal number,
7704 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7705 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7706 possible typo, Null picture in formline, Offset outside string, Out of
7707 memory!, Out of memory during request for %s, panic: frexp, Possible
7708 attempt to put comments in qw() list, Possible attempt to separate words
7709 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7710 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7711 option, untie attempted while %d inner references still exist, Unrecognized
7712 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7713 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7714 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7715 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7716 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7717 long, Process terminated by SIG%s
7718
7719 =item BUGS
7720
7721 =item SEE ALSO
7722
7723 =item HISTORY
7724
7725 =back
7726
7727 =head2 perlartistic - the Perl Artistic License
7728
7729 =over 4
7730
7731 =item SYNOPSIS
7732
7733 =item DESCRIPTION
7734
7735 =item The "Artistic License"
7736
7737 =over 4
7738
7739 =item Preamble
7740
7741 =item Definitions
7742
7743 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7744 copying fee", "Freely Available"
7745
7746 =item Conditions
7747
7748 a), b), c), d), a), b), c), d)
7749
7750 =back
7751
7752 =back
7753
7754 =head2 perlgpl - the GNU General Public License, version 2
7755
7756 =over 4
7757
7758 =item SYNOPSIS
7759
7760 =back
7761
7762 =over 4
7763
7764 =item DESCRIPTION
7765
7766 =item GNU GENERAL PUBLIC LICENSE
7767
7768 =back
7769
7770 =head1 PRAGMA DOCUMENTATION
7771
7772 =head2 attrs - set/get attributes of a subroutine (deprecated)
7773
7774 =over 4
7775
7776 =item SYNOPSIS
7777
7778 =item DESCRIPTION
7779
7780 method, locked
7781
7782 =back
7783
7784 =head2 re - Perl pragma to alter regular expression behaviour
7785
7786 =over 4
7787
7788 =item SYNOPSIS
7789
7790 =item DESCRIPTION
7791
7792 =back
7793
7794 =head2 threadshared::shared, threads::shared - Perl extension for sharing
7795 data structures between threads
7796
7797 =over 4
7798
7799 =item SYNOPSIS
7800
7801 =item DESCRIPTION
7802
7803 =item EXPORT
7804
7805 =item FUNCTIONS
7806
7807 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
7808 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
7809 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
7810
7811 =item NOTES
7812
7813 =item BUGS
7814
7815 =item AUTHOR
7816
7817 =item SEE ALSO
7818
7819 =back
7820
7821 =head2 threads - Perl extension allowing use of interpreter based threads
7822 from perl
7823
7824 =over 4
7825
7826 =item SYNOPSIS
7827
7828 =item DESCRIPTION
7829
7830 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
7831 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
7832 threads->list();, async BLOCK;
7833
7834 =item WARNINGS
7835
7836 A thread exited while %d other threads were still running
7837
7838 =item TODO
7839
7840 =item BUGS
7841
7842 Parent-Child threads, Returning objects, Creating threads inside BEGIN
7843 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
7844
7845 =item AUTHOR and COPYRIGHT
7846
7847 =item SEE ALSO
7848
7849 =back
7850
7851 =head2 assertions - select assertions in blocks of code
7852
7853 =over 4
7854
7855 =item SYNOPSIS
7856
7857 =item DESCRIPTION
7858
7859 =item SEE ALSO
7860
7861 =item AUTHOR
7862
7863 =item COPYRIGHT AND LICENSE
7864
7865 =back
7866
7867 =head2 assertions::activate - activate assertions
7868
7869 =over 4
7870
7871 =item SYNOPSIS
7872
7873 =item DESCRIPTION
7874
7875 =item SEE ALSO
7876
7877 =item AUTHOR
7878
7879 =item COPYRIGHT AND LICENSE
7880
7881 =back
7882
7883 =head2 attributes - get/set subroutine or variable attributes
7884
7885 =over 4
7886
7887 =item SYNOPSIS
7888
7889 =item DESCRIPTION
7890
7891 =over 4
7892
7893 =item Built-in Attributes
7894
7895 locked, method, lvalue
7896
7897 =item Available Subroutines
7898
7899 get, reftype
7900
7901 =item Package-specific Attribute Handling
7902
7903 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
7904
7905 =item Syntax of Attribute Lists
7906
7907 =back
7908
7909 =item EXPORTS
7910
7911 =over 4
7912
7913 =item Default exports
7914
7915 =item Available exports
7916
7917 =item Export tags defined
7918
7919 =back
7920
7921 =item EXAMPLES
7922
7923 =item SEE ALSO
7924
7925 =back
7926
7927 =head2 autouse - postpone load of modules until a function is used
7928
7929 =over 4
7930
7931 =item SYNOPSIS
7932
7933 =item DESCRIPTION
7934
7935 =item WARNING
7936
7937 =item AUTHOR
7938
7939 =item SEE ALSO
7940
7941 =back
7942
7943 =head2 base - Establish IS-A relationship with base classes at compile time
7944
7945 =over 4
7946
7947 =item SYNOPSIS
7948
7949 =item DESCRIPTION
7950
7951 =item HISTORY
7952
7953 =item CAVEATS
7954
7955 =item SEE ALSO
7956
7957 =back
7958
7959 =head2 bigint - Transparent BigInteger support for Perl
7960
7961 =over 4
7962
7963 =item SYNOPSIS
7964
7965 =item DESCRIPTION
7966
7967 =over 4
7968
7969 =item OPTIONS
7970
7971 a or accuracy, p or precision, t or trace, l or lib, v or version
7972
7973 =item MATH LIBRARY
7974
7975 =item INTERNAL FORMAT
7976
7977 =item SIGN
7978
7979 =item METHODS
7980
7981 =item CAVEAT
7982
7983 =back
7984
7985 =item MODULES USED
7986
7987 =item EXAMPLES
7988
7989 =item LICENSE
7990
7991 =item SEE ALSO
7992
7993 =item AUTHORS
7994
7995 =back
7996
7997 =head2 bignum - Transparent BigNumber support for Perl
7998
7999 =over 4
8000
8001 =item SYNOPSIS
8002
8003 =item DESCRIPTION
8004
8005 =over 4
8006
8007 =item OPTIONS
8008
8009 a or accuracy, p or precision, t or trace, l or lib, v or version
8010
8011 =item METHODS
8012
8013 =item CAVEAT
8014
8015 inf(), NaN(), upgrade()
8016
8017 =item MATH LIBRARY
8018
8019 =item INTERNAL FORMAT
8020
8021 =item SIGN
8022
8023 =back
8024
8025 =item MODULES USED
8026
8027 =item EXAMPLES
8028
8029 =item LICENSE
8030
8031 =item SEE ALSO
8032
8033 =item AUTHORS
8034
8035 =back
8036
8037 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8038
8039 =over 4
8040
8041 =item SYNOPSIS
8042
8043 =item DESCRIPTION
8044
8045 =over 4
8046
8047 =item MODULES USED
8048
8049 =item MATH LIBRARY
8050
8051 =item SIGN
8052
8053 =item METHODS
8054
8055 =item CAVEAT
8056
8057 =back
8058
8059 =item EXAMPLES
8060
8061         perl -Mbigrat -le 'print sqrt(33)'
8062         perl -Mbigrat -le 'print 2*255'
8063         perl -Mbigrat -le 'print 4.5+2*255'
8064         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
8065         perl -Mbigrat -le 'print 12->is_odd()';
8066
8067 =item LICENSE
8068
8069 =item SEE ALSO
8070
8071 =item AUTHORS
8072
8073 =back
8074
8075 =head2 blib - Use MakeMaker's uninstalled version of a package
8076
8077 =over 4
8078
8079 =item SYNOPSIS
8080
8081 =item DESCRIPTION
8082
8083 =item BUGS
8084
8085 =item AUTHOR
8086
8087 =back
8088
8089 =head2 bytes - Perl pragma to force byte semantics rather than character
8090 semantics
8091
8092 =over 4
8093
8094 =item SYNOPSIS
8095
8096 =item DESCRIPTION
8097
8098 =item LIMITATIONS
8099
8100 =item SEE ALSO
8101
8102 =back
8103
8104 =head2 charnames - define character names for C<\N{named}> string literal
8105 escapes
8106
8107 =over 4
8108
8109 =item SYNOPSIS
8110
8111 =item DESCRIPTION
8112
8113 =item CUSTOM TRANSLATORS
8114
8115 =item CUSTOM ALIASES
8116
8117 =over 4
8118
8119 =item Anonymous hashes
8120
8121 =item Alias file
8122
8123 =item Alias shortcut
8124
8125 =back
8126
8127 =item charnames::viacode(code)
8128
8129 =item charnames::vianame(name)
8130
8131 =item ALIASES
8132
8133 =item ILLEGAL CHARACTERS
8134
8135 =item BUGS
8136
8137 =back
8138
8139 =head2 constant - Perl pragma to declare constants
8140
8141 =over 4
8142
8143 =item SYNOPSIS
8144
8145 =item DESCRIPTION
8146
8147 =item NOTES
8148
8149 =over 4
8150
8151 =item List constants
8152
8153 =item Defining multiple constants at once
8154
8155 =item Magic constants
8156
8157 =back
8158
8159 =item TECHNICAL NOTES
8160
8161 =item BUGS
8162
8163 =item AUTHOR
8164
8165 =item COPYRIGHT
8166
8167 =back
8168
8169 =head2 diagnostics, splain - produce verbose warning diagnostics
8170
8171 =over 4
8172
8173 =item SYNOPSIS
8174
8175 =item DESCRIPTION
8176
8177 =over 4
8178
8179 =item The C<diagnostics> Pragma
8180
8181 =item The I<splain> Program
8182
8183 =back
8184
8185 =item EXAMPLES
8186
8187 =item INTERNALS
8188
8189 =item BUGS
8190
8191 =item AUTHOR
8192
8193 =back
8194
8195 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8196
8197 =over 4
8198
8199 =item SYNOPSIS
8200
8201 =item ABSTRACT
8202
8203 =over 4
8204
8205 =item Literal Conversions
8206
8207 =item PerlIO layers for C<STD(IN|OUT)>
8208
8209 =item Implicit upgrading for byte strings
8210
8211 =back
8212
8213 =item FEATURES THAT REQUIRE 5.8.1
8214
8215 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
8216
8217 =item USAGE
8218
8219 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8220 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
8221
8222 =item The Filter Option
8223
8224 =over 4
8225
8226 =item Filter-related changes at Encode version 1.87
8227
8228 =back
8229
8230 =item CAVEATS
8231
8232 =over 4
8233
8234 =item NOT SCOPED
8235
8236 =item DO NOT MIX MULTIPLE ENCODINGS
8237
8238 =item tr/// with ranges
8239
8240 Legend of characters above
8241
8242 =back
8243
8244 =item EXAMPLE - Greekperl
8245
8246 =item KNOWN PROBLEMS
8247
8248 literals in regex that are longer than 127 bytes, EBCDIC, format
8249
8250 =item HISTORY
8251
8252 =item SEE ALSO
8253
8254 =back
8255
8256 =head2 fields - compile-time class fields
8257
8258 =over 4
8259
8260 =item SYNOPSIS
8261
8262 =item DESCRIPTION
8263
8264 new, phash
8265
8266 =item SEE ALSO
8267
8268 =back
8269
8270 =head2 filetest - Perl pragma to control the filetest permission operators
8271
8272 =over 4
8273
8274 =item SYNOPSIS
8275
8276 =item DESCRIPTION
8277
8278 =over 4
8279
8280 =item subpragma access
8281
8282 =back
8283
8284 =back
8285
8286 =head2 if - C<use> a Perl module if a condition holds
8287
8288 =over 4
8289
8290 =item SYNOPSIS
8291
8292 =item DESCRIPTION
8293
8294 =item BUGS
8295
8296 =item AUTHOR
8297
8298 =back
8299
8300 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8301 point
8302
8303 =over 4
8304
8305 =item SYNOPSIS
8306
8307 =item DESCRIPTION
8308
8309 =back
8310
8311 =head2 less - perl pragma to request less of something from the compiler
8312
8313 =over 4
8314
8315 =item SYNOPSIS
8316
8317 =item DESCRIPTION
8318
8319 =back
8320
8321 =head2 lib - manipulate @INC at compile time
8322
8323 =over 4
8324
8325 =item SYNOPSIS
8326
8327 =item DESCRIPTION
8328
8329 =over 4
8330
8331 =item Adding directories to @INC
8332
8333 =item Deleting directories from @INC
8334
8335 =item Restoring original @INC
8336
8337 =back
8338
8339 =item CAVEATS
8340
8341 =item NOTES
8342
8343 =item SEE ALSO
8344
8345 =item AUTHOR
8346
8347 =back
8348
8349 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8350 operations
8351
8352 =over 4
8353
8354 =item SYNOPSIS
8355
8356 =item DESCRIPTION
8357
8358 =back
8359
8360 =head2 open - perl pragma to set default PerlIO layers for input and output
8361
8362 =over 4
8363
8364 =item SYNOPSIS
8365
8366 =item DESCRIPTION
8367
8368 =item NONPERLIO FUNCTIONALITY
8369
8370 =item IMPLEMENTATION DETAILS
8371
8372 =item SEE ALSO
8373
8374 =back
8375
8376 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8377
8378 =over 4
8379
8380 =item SYNOPSIS  
8381
8382 =item DESCRIPTION
8383
8384 =item SEE ALSO
8385
8386 =back
8387
8388 =head2 overload - Package for overloading perl operations
8389
8390 =over 4
8391
8392 =item SYNOPSIS
8393
8394 =item DESCRIPTION
8395
8396 =over 4
8397
8398 =item Declaration of overloaded functions
8399
8400 =item Calling Conventions for Binary Operations
8401
8402 FALSE, TRUE, C<undef>
8403
8404 =item Calling Conventions for Unary Operations
8405
8406 =item Calling Conventions for Mutators
8407
8408 C<++> and C<-->, C<x=> and other assignment versions
8409
8410 =item Overloadable Operations
8411
8412 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8413 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8414 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8415
8416 =item Inheritance and overloading
8417
8418 Strings as values of C<use overload> directive, Overloading of an operation
8419 is inherited by derived classes
8420
8421 =back
8422
8423 =item SPECIAL SYMBOLS FOR C<use overload>
8424
8425 =over 4
8426
8427 =item Last Resort
8428
8429 =item Fallback
8430
8431 C<undef>, TRUE, defined, but FALSE
8432
8433 =item Copy Constructor
8434
8435 B<Example>
8436
8437 =back
8438
8439 =item MAGIC AUTOGENERATION
8440
8441 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8442 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8443 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8444 I<Copy operator>
8445
8446 =item Losing overloading
8447
8448 =item Run-time Overloading
8449
8450 =item Public functions
8451
8452 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8453
8454 =item Overloading constants
8455
8456 integer, float, binary, q, qr
8457
8458 =item IMPLEMENTATION
8459
8460 =item Metaphor clash
8461
8462 =item Cookbook
8463
8464 =over 4
8465
8466 =item Two-face scalars
8467
8468 =item Two-face references
8469
8470 =item Symbolic calculator
8471
8472 =item I<Really> symbolic calculator
8473
8474 =back
8475
8476 =item AUTHOR
8477
8478 =item DIAGNOSTICS
8479
8480 Odd number of arguments for overload::constant, `%s' is not an overloadable
8481 type, `%s' is not a code reference
8482
8483 =item BUGS
8484
8485 =back
8486
8487 =head2 sigtrap - Perl pragma to enable simple signal handling
8488
8489 =over 4
8490
8491 =item SYNOPSIS
8492
8493 =item DESCRIPTION
8494
8495 =item OPTIONS
8496
8497 =over 4
8498
8499 =item SIGNAL HANDLERS
8500
8501 B<stack-trace>, B<die>, B<handler> I<your-handler>
8502
8503 =item SIGNAL LISTS
8504
8505 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8506
8507 =item OTHER
8508
8509 B<untrapped>, B<any>, I<signal>, I<number>
8510
8511 =back
8512
8513 =item EXAMPLES
8514
8515 =back
8516
8517 =head2 sort - perl pragma to control sort() behaviour
8518
8519 =over 4
8520
8521 =item SYNOPSIS
8522
8523 =item DESCRIPTION
8524
8525 =item CAVEATS
8526
8527 =back
8528
8529 =head2 strict - Perl pragma to restrict unsafe constructs
8530
8531 =over 4
8532
8533 =item SYNOPSIS
8534
8535 =item DESCRIPTION
8536
8537 C<strict refs>, C<strict vars>, C<strict subs>
8538
8539 =item HISTORY
8540
8541 =back
8542
8543 =head2 subs - Perl pragma to predeclare sub names
8544
8545 =over 4
8546
8547 =item SYNOPSIS
8548
8549 =item DESCRIPTION
8550
8551 =back
8552
8553 =head2 threadshared, threads::shared - Perl extension for sharing data
8554 structures between threads
8555
8556 =over 4
8557
8558 =item SYNOPSIS
8559
8560 =item DESCRIPTION
8561
8562 =item EXPORT
8563
8564 =item FUNCTIONS
8565
8566 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
8567 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
8568 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
8569
8570 =item NOTES
8571
8572 =item BUGS
8573
8574 =item AUTHOR
8575
8576 =item SEE ALSO
8577
8578 =back
8579
8580 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
8581 code
8582
8583 =over 4
8584
8585 =item SYNOPSIS
8586
8587 =item DESCRIPTION
8588
8589 =over 4
8590
8591 =item Utility functions
8592
8593 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
8594 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
8595 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
8596
8597 =back
8598
8599 =item BUGS
8600
8601 =item SEE ALSO
8602
8603 =back
8604
8605 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
8606
8607 =over 4
8608
8609 =item SYNOPSIS
8610
8611 =item DESCRIPTION
8612
8613 =back
8614
8615 =head2 version - Perl extension for Version Objects
8616
8617 =over 4
8618
8619 =item SYNOPSIS
8620
8621 =item DESCRIPTION
8622
8623 =over 4
8624
8625 =item What IS a version
8626
8627 Numeric Versions, Quoted Versions
8628
8629 =item What about v-strings?
8630
8631 =item Numeric Versions
8632
8633 =item Quoted Versions
8634
8635 =item Object Methods
8636
8637 New Operator, qv(), Stringification, Numification, Comparison operators,
8638 Logical Operators
8639
8640 =item Quoting
8641
8642 =item Types of Versions Objects
8643
8644 Ordinary versions, Alpha versions
8645
8646 =item Replacement UNIVERSAL::VERSION
8647
8648 =back
8649
8650 =item EXPORT
8651
8652 =item AUTHOR
8653
8654 =item SEE ALSO
8655
8656 =back
8657
8658 =head2 vmsish - Perl pragma to control VMS-specific language features
8659
8660 =over 4
8661
8662 =item SYNOPSIS
8663
8664 =item DESCRIPTION
8665
8666 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
8667
8668 =back
8669
8670 =head2 warnings - Perl pragma to control optional warnings
8671
8672 =over 4
8673
8674 =item SYNOPSIS
8675
8676 =item DESCRIPTION
8677
8678 use warnings::register, warnings::enabled(), warnings::enabled($category),
8679 warnings::enabled($object), warnings::warn($message),
8680 warnings::warn($category, $message), warnings::warn($object, $message),
8681 warnings::warnif($message), warnings::warnif($category, $message),
8682 warnings::warnif($object, $message)
8683
8684 =back
8685
8686 =head2 warnings::register - warnings import function
8687
8688 =over 4
8689
8690 =item SYNOPSIS
8691
8692 =item DESCRIPTION
8693
8694 =back
8695
8696 =head1 MODULE DOCUMENTATION
8697
8698 =head2 AnyDBM_File - provide framework for multiple DBMs
8699
8700 =over 4
8701
8702 =item SYNOPSIS
8703
8704 =item DESCRIPTION
8705
8706 =over 4
8707
8708 =item DBM Comparisons
8709
8710 [0], [1], [2], [3]
8711
8712 =back
8713
8714 =item SEE ALSO
8715
8716 =back
8717
8718 =head2 Attribute::Handlers - Simpler definition of attribute handlers
8719
8720 =over 4
8721
8722 =item VERSION
8723
8724 =item SYNOPSIS
8725
8726 =item DESCRIPTION
8727
8728 [0], [1], [2], [3], [4], [5]
8729
8730 =over 4
8731
8732 =item Typed lexicals
8733
8734 =item Type-specific attribute handlers
8735
8736 =item Non-interpretive attribute handlers
8737
8738 =item Phase-specific attribute handlers
8739
8740 =item Attributes as C<tie> interfaces
8741
8742 =back
8743
8744 =item EXAMPLES
8745
8746 =item DIAGNOSTICS
8747
8748 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
8749 attributes>, C<Declaration of %s attribute in package %s may clash with
8750 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
8751 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
8752 be able to apply END handler>
8753
8754 =item AUTHOR
8755
8756 =item BUGS
8757
8758 =item COPYRIGHT
8759
8760 =back
8761
8762 =head2 AutoLoader - load subroutines only on demand
8763
8764 =over 4
8765
8766 =item SYNOPSIS
8767
8768 =item DESCRIPTION
8769
8770 =over 4
8771
8772 =item Subroutine Stubs
8773
8774 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
8775
8776 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
8777
8778 =item Package Lexicals
8779
8780 =item Not Using AutoLoader
8781
8782 =item B<AutoLoader> vs. B<SelfLoader>
8783
8784 =back
8785
8786 =item CAVEATS
8787
8788 =item SEE ALSO
8789
8790 =back
8791
8792 =head2 AutoSplit - split a package for autoloading
8793
8794 =over 4
8795
8796 =item SYNOPSIS
8797
8798 =item DESCRIPTION
8799
8800 $keep, $check, $modtime
8801
8802 =over 4
8803
8804 =item Multiple packages
8805
8806 =back
8807
8808 =item DIAGNOSTICS
8809
8810 =back
8811
8812 =head2 B - The Perl Compiler
8813
8814 =over 4
8815
8816 =item SYNOPSIS
8817
8818 =item DESCRIPTION
8819
8820 =item OVERVIEW
8821
8822 =item Utility Functions
8823
8824 =over 4
8825
8826 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
8827 objects
8828
8829 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
8830 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
8831
8832 =item Functions for Examining the Symbol Table
8833
8834 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
8835
8836 =item Functions Returning C<B::OP> objects or for walking op trees
8837
8838 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
8839
8840 =item Miscellaneous Utility Functions
8841
8842 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
8843 perlstring(STR), class(OBJ), threadsv_names
8844
8845 =back
8846
8847 =item OVERVIEW OF CLASSES
8848
8849 =over 4
8850
8851 =item SV-RELATED CLASSES
8852
8853 =item B::SV Methods
8854
8855 REFCNT, FLAGS, object_2svref
8856
8857 =item B::IV Methods
8858
8859 IV, IVX, UVX, int_value, needs64bits, packiv
8860
8861 =item B::NV Methods
8862
8863 NV, NVX
8864
8865 =item B::RV Methods
8866
8867 RV
8868
8869 =item B::PV Methods
8870
8871 PV, RV, PVX
8872
8873 =item B::PVMG Methods
8874
8875 MAGIC, SvSTASH
8876
8877 =item B::MAGIC Methods
8878
8879 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
8880
8881 =item B::PVLV Methods
8882
8883 TARGOFF, TARGLEN, TYPE, TARG
8884
8885 =item B::BM Methods
8886
8887 USEFUL, PREVIOUS, RARE, TABLE
8888
8889 =item B::GV Methods
8890
8891 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
8892 LINE, FILE, FILEGV, GvREFCNT, FLAGS
8893
8894 =item B::IO Methods
8895
8896 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
8897 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
8898
8899 =item B::AV Methods
8900
8901 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
8902
8903 =item B::CV Methods
8904
8905 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
8906 XSUBANY, CvFLAGS, const_sv
8907
8908 =item B::HV Methods
8909
8910 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
8911
8912 =item OP-RELATED CLASSES
8913
8914 =item B::OP Methods
8915
8916 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
8917
8918 =item B::UNOP METHOD
8919
8920 first
8921
8922 =item B::BINOP METHOD
8923
8924 last
8925
8926 =item B::LOGOP METHOD
8927
8928 other
8929
8930 =item B::LISTOP METHOD
8931
8932 children
8933
8934 =item B::PMOP Methods
8935
8936 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
8937 pmpermflags, precomp, pmoffset
8938
8939 =item B::SVOP METHOD
8940
8941 sv, gv
8942
8943 =item B::PADOP METHOD
8944
8945 padix
8946
8947 =item B::PVOP METHOD
8948
8949 pv
8950
8951 =item B::LOOP Methods
8952
8953 redoop, nextop, lastop
8954
8955 =item B::COP Methods
8956
8957 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
8958
8959 =back
8960
8961 =item AUTHOR
8962
8963 =back
8964
8965 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
8966 bytecode
8967
8968 =over 4
8969
8970 =item SYNOPSIS
8971
8972 =item DESCRIPTION
8973
8974 %insn_data, @insn_name, @optype, @specialsv_name
8975
8976 =item AUTHOR
8977
8978 =back
8979
8980 =head2 B::Assembler - Assemble Perl bytecode
8981
8982 =over 4
8983
8984 =item SYNOPSIS
8985
8986 =item DESCRIPTION
8987
8988 =item AUTHORS
8989
8990 =back
8991
8992 =head2 B::Bblock - Walk basic blocks
8993
8994 =over 4
8995
8996 =item SYNOPSIS
8997
8998 =item DESCRIPTION
8999
9000 =over 4
9001
9002 =item Functions
9003
9004 B<find_leaders>
9005
9006 =back
9007
9008 =item AUTHOR
9009
9010 =back
9011
9012 =head2 B::Bytecode - Perl compiler's bytecode backend
9013
9014 =over 4
9015
9016 =item SYNOPSIS
9017
9018 =item DESCRIPTION
9019
9020 =item EXAMPLE
9021
9022 =item OPTIONS
9023
9024 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
9025
9026 =item KNOWN BUGS
9027
9028 =item NOTICE
9029
9030 =item AUTHORS
9031
9032 =back
9033
9034 =head2 B::C - Perl compiler's C backend
9035
9036 =over 4
9037
9038 =item SYNOPSIS
9039
9040 =item DESCRIPTION
9041
9042 =item OPTIONS
9043
9044 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9045 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9046 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9047 B<-llimit>
9048
9049 =item EXAMPLES
9050
9051 =item BUGS
9052
9053 =item AUTHOR
9054
9055 =back
9056
9057 =head2 B::CC - Perl compiler's optimized C translation backend
9058
9059 =over 4
9060
9061 =item SYNOPSIS
9062
9063 =item DESCRIPTION
9064
9065 =item OPTIONS
9066
9067 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9068 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9069 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9070
9071 =item EXAMPLES
9072
9073 =item BUGS
9074
9075 =item DIFFERENCES
9076
9077 =over 4
9078
9079 =item Loops
9080
9081 =item Context of ".."
9082
9083 =item Arithmetic
9084
9085 =item Deprecated features
9086
9087 =back
9088
9089 =item AUTHOR
9090
9091 =back
9092
9093 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9094
9095 =over 4
9096
9097 =item SYNOPSIS
9098
9099 =item DESCRIPTION
9100
9101 =item EXAMPLE
9102
9103 =item OPTIONS
9104
9105 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9106 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9107 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9108
9109 =item FORMATTING SPECIFICATIONS
9110
9111 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9112 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9113 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9114 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9115 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9116 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9117 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9118 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9119
9120 =item ABBREVIATIONS
9121
9122 =over 4
9123
9124 =item OP flags abbreviations
9125
9126 =item OP class abbreviations
9127
9128 =back
9129
9130 =item Using B::Concise outside of the O framework
9131
9132 =item AUTHOR
9133
9134 =back
9135
9136 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9137
9138 =over 4
9139
9140 =item SYNOPSIS
9141
9142 =item DESCRIPTION
9143
9144 =item AUTHOR
9145
9146 =back
9147
9148 =head2 B::Deparse - Perl compiler backend to produce perl code
9149
9150 =over 4
9151
9152 =item SYNOPSIS
9153
9154 =item DESCRIPTION
9155
9156 =item OPTIONS
9157
9158 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
9159 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9160
9161 =item USING B::Deparse AS A MODULE
9162
9163 =over 4
9164
9165 =item Synopsis
9166
9167 =item Description
9168
9169 =item new
9170
9171 =item ambient_pragmas
9172
9173 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9174
9175 =item coderef2text
9176
9177 =back
9178
9179 =item BUGS
9180
9181 =item AUTHOR
9182
9183 =back
9184
9185 =head2 B::Disassembler - Disassemble Perl bytecode
9186
9187 =over 4
9188
9189 =item SYNOPSIS
9190
9191 =item DESCRIPTION
9192
9193 =item AUTHOR
9194
9195 =back
9196
9197 =head2 B::Lint - Perl lint
9198
9199 =over 4
9200
9201 =item SYNOPSIS
9202
9203 =item DESCRIPTION
9204
9205 =item OPTIONS AND LINT CHECKS
9206
9207 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
9208 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
9209 B<regexp-variables>, B<all>, B<none>
9210
9211 =item NON LINT-CHECK OPTIONS
9212
9213 B<-u Package>
9214
9215 =item BUGS
9216
9217 =item AUTHOR
9218
9219 =back
9220
9221 =head2 B::O, O - Generic interface to Perl Compiler backends
9222
9223 =over 4
9224
9225 =item SYNOPSIS
9226
9227 =item DESCRIPTION
9228
9229 =item CONVENTIONS
9230
9231 =item IMPLEMENTATION
9232
9233 =item BUGS
9234
9235 =item AUTHOR
9236
9237 =back
9238
9239 =head2 B::Showlex - Show lexical variables used in functions or files
9240
9241 =over 4
9242
9243 =item SYNOPSIS
9244
9245 =item DESCRIPTION
9246
9247 =item AUTHOR
9248
9249 =back
9250
9251 =head2 B::Stackobj - Helper module for CC backend
9252
9253 =over 4
9254
9255 =item SYNOPSIS
9256
9257 =item DESCRIPTION
9258
9259 =item AUTHOR
9260
9261 =back
9262
9263 =head2 B::Stash - show what stashes are loaded
9264
9265 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9266
9267 =over 4
9268
9269 =item SYNOPSIS
9270
9271 =item DESCRIPTION
9272
9273 =item AUTHOR
9274
9275 =back
9276
9277 =head2 B::Xref - Generates cross reference reports for Perl programs
9278
9279 =over 4
9280
9281 =item SYNOPSIS
9282
9283 =item DESCRIPTION
9284
9285 =item OPTIONS
9286
9287 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9288
9289 =item BUGS
9290
9291 =item AUTHOR
9292
9293 =back
9294
9295 =head2 Bblock, B::Bblock - Walk basic blocks
9296
9297 =over 4
9298
9299 =item SYNOPSIS
9300
9301 =item DESCRIPTION
9302
9303 =over 4
9304
9305 =item Functions
9306
9307 B<find_leaders>
9308
9309 =back
9310
9311 =item AUTHOR
9312
9313 =back
9314
9315 =head2 Benchmark - benchmark running times of Perl code
9316
9317 =over 4
9318
9319 =item SYNOPSIS
9320
9321 =item DESCRIPTION
9322
9323 =over 4
9324
9325 =item Methods
9326
9327 new, debug, iters
9328
9329 =item Standard Exports
9330
9331 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9332 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9333 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9334
9335 =item Optional Exports
9336
9337 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
9338 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9339 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9340
9341 =item :hireswallclock
9342
9343 =back
9344
9345 =item NOTES
9346
9347 =item EXAMPLES
9348
9349 =item INHERITANCE
9350
9351 =item CAVEATS
9352
9353 =item SEE ALSO
9354
9355 =item AUTHORS
9356
9357 =item MODIFICATION HISTORY
9358
9359 =back
9360
9361 =head2 ByteLoader - load byte compiled perl code
9362
9363 =over 4
9364
9365 =item SYNOPSIS
9366
9367 =item DESCRIPTION
9368
9369 =item AUTHOR
9370
9371 =item SEE ALSO
9372
9373 =back
9374
9375 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9376
9377 =over 4
9378
9379 =item SYNOPSIS
9380
9381 =item DESCRIPTION
9382
9383 =item EXAMPLE
9384
9385 =item OPTIONS
9386
9387 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
9388
9389 =item KNOWN BUGS
9390
9391 =item NOTICE
9392
9393 =item AUTHORS
9394
9395 =back
9396
9397 =head2 CGI - Simple Common Gateway Interface Class
9398
9399 =over 4
9400
9401 =item SYNOPSIS
9402
9403 =item ABSTRACT
9404
9405 =item DESCRIPTION
9406
9407 =over 4
9408
9409 =item PROGRAMMING STYLE
9410
9411 =item CALLING CGI.PM ROUTINES
9412
9413 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9414
9415 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9416
9417 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9418
9419 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9420
9421 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9422
9423 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9424
9425 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9426
9427 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9428
9429 =item DELETING A PARAMETER COMPLETELY:
9430
9431 =item DELETING ALL PARAMETERS:
9432
9433 =item DIRECT ACCESS TO THE PARAMETER LIST:
9434
9435 =item FETCHING THE PARAMETER LIST AS A HASH:
9436
9437 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9438
9439 =item RETRIEVING CGI ERRORS
9440
9441 =item USING THE FUNCTION-ORIENTED INTERFACE
9442
9443 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9444 B<:standard>, B<:all>
9445
9446 =item PRAGMAS
9447
9448 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9449 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9450 -private_tempfiles
9451
9452 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9453
9454 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9455 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9456 a </ul> tag)
9457
9458 =back
9459
9460 =item GENERATING DYNAMIC DOCUMENTS
9461
9462 =over 4
9463
9464 =item CREATING A STANDARD HTTP HEADER:
9465
9466 =item GENERATING A REDIRECTION HEADER
9467
9468 =item CREATING THE HTML DOCUMENT HEADER
9469
9470 B<Parameters:>, 4, 5, 6..
9471
9472 =item ENDING THE HTML DOCUMENT:
9473
9474 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9475
9476 =item OBTAINING THE SCRIPT'S URL
9477
9478 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9479 (B<-query_string>), B<-base>
9480
9481 =item MIXING POST AND URL PARAMETERS
9482
9483 =back
9484
9485 =item CREATING STANDARD HTML ELEMENTS:
9486
9487 =over 4
9488
9489 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9490
9491 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9492
9493 =item HTML SHORTCUTS AND LIST INTERPOLATION
9494
9495 =item NON-STANDARD HTML SHORTCUTS
9496
9497 =item AUTOESCAPING HTML
9498
9499 $escaped_string = escapeHTML("unescaped string");, $charset =
9500 charset([$charset]);, $flag = autoEscape([$flag]);
9501
9502 =item PRETTY-PRINTING HTML
9503
9504 =back
9505
9506 =item CREATING FILL-OUT FORMS:
9507
9508 =over 4
9509
9510 =item CREATING AN ISINDEX TAG
9511
9512 =item STARTING AND ENDING A FORM
9513
9514 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9515
9516 =item CREATING A TEXT FIELD
9517
9518 B<Parameters>
9519
9520 =item CREATING A BIG TEXT FIELD
9521
9522 =item CREATING A PASSWORD FIELD
9523
9524 =item CREATING A FILE UPLOAD FIELD
9525
9526 B<Parameters>
9527
9528 =item CREATING A POPUP MENU
9529
9530 =item CREATING AN OPTION GROUP
9531
9532 =item CREATING A SCROLLING LIST
9533
9534 B<Parameters:>
9535
9536 =item CREATING A GROUP OF RELATED CHECKBOXES
9537
9538 B<Parameters:>
9539
9540 =item CREATING A STANDALONE CHECKBOX
9541
9542 B<Parameters:>
9543
9544 =item CREATING A RADIO BUTTON GROUP
9545
9546 B<Parameters:>
9547
9548 =item CREATING A SUBMIT BUTTON 
9549
9550 B<Parameters:>
9551
9552 =item CREATING A RESET BUTTON
9553
9554 =item CREATING A DEFAULT BUTTON
9555
9556 =item CREATING A HIDDEN FIELD
9557
9558 B<Parameters:>
9559
9560 =item CREATING A CLICKABLE IMAGE BUTTON
9561
9562 B<Parameters:>, 3. The third option (-align, optional) is an alignment
9563 type, and may be TOP, BOTTOM or MIDDLE
9564
9565 =item CREATING A JAVASCRIPT ACTION BUTTON
9566
9567 =back
9568
9569 =item HTTP COOKIES
9570
9571 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
9572 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
9573
9574 =item WORKING WITH FRAMES
9575
9576 1. Create a <Frameset> document, 2. Specify the destination for the
9577 document in the HTTP header, 3. Specify the destination for the document in
9578 the <form> tag
9579
9580 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
9581
9582 =item DEBUGGING
9583
9584 =over 4
9585
9586 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
9587
9588 =back
9589
9590 =item FETCHING ENVIRONMENT VARIABLES
9591
9592 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
9593 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
9594 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
9595 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
9596 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
9597 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
9598
9599 =item USING NPH SCRIPTS
9600
9601 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
9602 parameters
9603
9604 =item Server Push
9605
9606 multipart_init(), multipart_start(), multipart_end(), multipart_final()
9607
9608 =item Avoiding Denial of Service Attacks
9609
9610 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
9611 basis>, B<2. Globally for all scripts>
9612
9613 =item COMPATIBILITY WITH CGI-LIB.PL
9614
9615 =item AUTHOR INFORMATION
9616
9617 =item CREDITS
9618
9619 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
9620 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
9621 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
9622 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
9623 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
9624 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
9625 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
9626 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
9627 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
9628 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
9629 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
9630 ...and many many more..
9631
9632 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
9633
9634 =item BUGS
9635
9636 =item SEE ALSO
9637
9638 =back
9639
9640 =head2 CGI::Apache - Backward compatibility module for CGI.pm
9641
9642 =over 4
9643
9644 =item SYNOPSIS
9645
9646 =item ABSTRACT
9647
9648 =item DESCRIPTION
9649
9650 =item AUTHOR INFORMATION
9651
9652 =item BUGS
9653
9654 =item SEE ALSO
9655
9656 =back
9657
9658 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
9659 other) error log
9660
9661 =over 4
9662
9663 =item SYNOPSIS
9664
9665 =item DESCRIPTION
9666
9667 =item REDIRECTING ERROR MESSAGES
9668
9669 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
9670
9671 =over 4
9672
9673 =item Changing the default message
9674
9675 =back
9676
9677 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
9678
9679 =item OVERRIDING THE NAME OF THE PROGRAM
9680
9681 =item AUTHORS
9682
9683 =item SEE ALSO
9684
9685 =back
9686
9687 =head2 CGI::Cookie - Interface to Netscape Cookies
9688
9689 =over 4
9690
9691 =item SYNOPSIS
9692
9693 =item DESCRIPTION
9694
9695 =item USING CGI::Cookie
9696
9697 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
9698
9699 =over 4
9700
9701 =item Creating New Cookies
9702
9703 =item Sending the Cookie to the Browser
9704
9705 =item Recovering Previous Cookies
9706
9707 =item Manipulating Cookies
9708
9709 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
9710
9711 =back
9712
9713 =item AUTHOR INFORMATION
9714
9715 =item BUGS
9716
9717 =item SEE ALSO
9718
9719 =back
9720
9721 =head2 CGI::Fast - CGI Interface for Fast CGI
9722
9723 =over 4
9724
9725 =item SYNOPSIS
9726
9727 =item DESCRIPTION
9728
9729 =item OTHER PIECES OF THE PUZZLE
9730
9731 =item WRITING FASTCGI PERL SCRIPTS
9732
9733 =item INSTALLING FASTCGI SCRIPTS
9734
9735 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
9736
9737 =item EXTERNAL FASTCGI SERVER INVOCATION
9738
9739 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
9740
9741 =item CAVEATS
9742
9743 =item AUTHOR INFORMATION
9744
9745 =item BUGS
9746
9747 =item SEE ALSO
9748
9749 =back
9750
9751 =head2 CGI::Pretty - module to produce nicely formatted HTML code
9752
9753 =over 4
9754
9755 =item SYNOPSIS
9756
9757 =item DESCRIPTION
9758
9759 =over 4
9760
9761 =item Tags that won't be formatted
9762
9763 =item Customizing the Indenting
9764
9765 =back
9766
9767 =item BUGS
9768
9769 =item AUTHOR
9770
9771 =item SEE ALSO
9772
9773 =back
9774
9775 =head2 CGI::Push - Simple Interface to Server Push
9776
9777 =over 4
9778
9779 =item SYNOPSIS
9780
9781 =item DESCRIPTION
9782
9783 =item USING CGI::Push
9784
9785 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
9786
9787 =over 4
9788
9789 =item Heterogeneous Pages
9790
9791 =item Changing the Page Delay on the Fly
9792
9793 =back
9794
9795 =item INSTALLING CGI::Push SCRIPTS
9796
9797 =item AUTHOR INFORMATION
9798
9799 =item BUGS
9800
9801 =item SEE ALSO
9802
9803 =back
9804
9805 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
9806
9807 =over 4
9808
9809 =item SYNOPSIS
9810
9811 =item ABSTRACT
9812
9813 =item DESCRIPTION
9814
9815 =item AUTHOR INFORMATION
9816
9817 =item BUGS
9818
9819 =item SEE ALSO
9820
9821 =back
9822
9823 =head2 CGI::Util - Internal utilities used by CGI module
9824
9825 =over 4
9826
9827 =item SYNOPSIS
9828
9829 =item DESCRIPTION
9830
9831 =item AUTHOR INFORMATION
9832
9833 =item SEE ALSO
9834
9835 =back
9836
9837 =head2 CPAN - query, download and build perl modules from CPAN sites
9838
9839 =over 4
9840
9841 =item SYNOPSIS
9842
9843 =item STATUS
9844
9845 =item DESCRIPTION
9846
9847 =over 4
9848
9849 =item Interactive Mode
9850
9851 Searching for authors, bundles, distribution files and modules, make, test,
9852 install, clean  modules or distributions, get, readme, look module or
9853 distribution, ls author, Signals
9854
9855 =item CPAN::Shell
9856
9857 =item autobundle
9858
9859 =item recompile
9860
9861 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
9862
9863 =item Programmer's interface
9864
9865 expand($type,@things), expandany(@things), Programming Examples
9866
9867 =item Methods in the other Classes
9868
9869 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
9870 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
9871 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
9872 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
9873 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
9874 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
9875 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
9876 CPAN::Bundle::readme(), CPAN::Bundle::test(),
9877 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
9878 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
9879 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
9880 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
9881 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
9882 CPAN::Distribution::look(), CPAN::Distribution::make(),
9883 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
9884 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
9885 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
9886 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
9887 CPAN::Module::clean(), CPAN::Module::cpan_file(),
9888 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
9889 CPAN::Module::description(), CPAN::Module::force($method,@args),
9890 CPAN::Module::get(), CPAN::Module::inst_file(),
9891 CPAN::Module::inst_version(), CPAN::Module::install(),
9892 CPAN::Module::look(), CPAN::Module::make(),
9893 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
9894 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
9895
9896 =item Cache Manager
9897
9898 =item Bundles
9899
9900 =item Prerequisites
9901
9902 =item Finding packages and VERSION
9903
9904 =item Debugging
9905
9906 =item Floppy, Zip, Offline Mode
9907
9908 =back
9909
9910 =item CONFIGURATION
9911
9912 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
9913 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
9914 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
9915 [unshift|push|splice] E<lt>listE<gt>>
9916
9917 =over 4
9918
9919 =item Note on urllist parameter's format
9920
9921 =item urllist parameter has CD-ROM support
9922
9923 =back
9924
9925 =item SECURITY
9926
9927 =item EXPORT
9928
9929 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
9930
9931 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
9932
9933 =over 4
9934
9935 =item Three basic types of firewalls
9936
9937 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
9938
9939 =item Configuring lynx or ncftp for going through a firewall
9940
9941 =back
9942
9943 =item FAQ
9944
9945 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
9946
9947 =item BUGS
9948
9949 =item AUTHOR
9950
9951 =item TRANSLATIONS
9952
9953 =item SEE ALSO
9954
9955 =back
9956
9957 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
9958
9959 =over 4
9960
9961 =item SYNOPSIS
9962
9963 =item DESCRIPTION
9964
9965 =back
9966
9967 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
9968 module
9969
9970 =over 4
9971
9972 =item SYNOPSIS
9973
9974 =item DESCRIPTION
9975
9976 =item  SEE ALSO
9977
9978 =back
9979
9980 =head2 Carp, carp    - warn of errors (from perspective of caller)
9981
9982 =over 4
9983
9984 =item SYNOPSIS
9985
9986 =item DESCRIPTION
9987
9988 =over 4
9989
9990 =item Forcing a Stack Trace
9991
9992 =back
9993
9994 =item BUGS
9995
9996 =back
9997
9998 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
9999
10000 =head2 Class::ISA -- report the search path for a class's ISA tree
10001
10002 =over 4
10003
10004 =item SYNOPSIS
10005
10006 =item DESCRIPTION
10007
10008 =item FUNCTIONS
10009
10010 the function Class::ISA::super_path($CLASS), the function
10011 Class::ISA::self_and_super_path($CLASS), the function
10012 Class::ISA::self_and_super_versions($CLASS)
10013
10014 =item CAUTIONARY NOTES
10015
10016 =item COPYRIGHT
10017
10018 =item AUTHOR
10019
10020 =back
10021
10022 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10023
10024 =over 4
10025
10026 =item SYNOPSIS
10027
10028 =item DESCRIPTION
10029
10030 =over 4
10031
10032 =item The C<struct()> function
10033
10034 =item Class Creation at Compile Time
10035
10036 =item Element Types and Accessor Methods
10037
10038 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10039 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10040
10041 =item Initializing with C<new>
10042
10043 =back
10044
10045 =item EXAMPLES
10046
10047 Example 1, Example 2, Example 3
10048
10049 =item Author and Modification History
10050
10051 =back
10052
10053 =head2 Config - access Perl configuration information
10054
10055 =over 4
10056
10057 =item SYNOPSIS
10058
10059 =item DESCRIPTION
10060
10061 myconfig(), config_sh(), config_re($regex), config_vars(@names)
10062
10063 =item EXAMPLE
10064
10065 =item WARNING
10066
10067 =item GLOSSARY
10068
10069 =over 4
10070
10071 =item _
10072
10073 C<_a>, C<_exe>, C<_o>
10074
10075 =item a
10076
10077 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10078 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10079 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10080 C<asctime_r_proto>, C<awk>
10081
10082 =item b
10083
10084 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10085
10086 =item c
10087
10088 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10089 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10090 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10091 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10092 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10093 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10094 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10095
10096 =item d
10097
10098 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
10099 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
10100 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
10101 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
10102 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
10103 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
10104 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
10105 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
10106 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
10107 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
10108 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
10109 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
10110 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
10111 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
10112 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
10113 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
10114 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
10115 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
10116 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
10117 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
10118 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
10119 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
10120 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
10121 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
10122 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
10123 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
10124 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
10125 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
10126 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
10127 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
10128 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
10129 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
10130 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
10131 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
10132 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
10133 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
10134 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
10135 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
10136 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
10137 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
10138 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
10139 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
10140 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
10141 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
10142 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
10143 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
10144 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
10145 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
10146 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
10147 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
10148 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
10149 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
10150 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10151 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10152 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10153 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10154 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10155 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
10156 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
10157 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
10158 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
10159 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
10160 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
10161 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
10162 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
10163 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
10164 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
10165 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
10166 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
10167 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
10168 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
10169 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
10170 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
10171 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
10172 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
10173 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
10174 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
10175 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
10176 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
10177 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
10178 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
10179 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
10180 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
10181 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
10182 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
10183 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
10184 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
10185 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10186 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10187 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10188 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10189 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10190
10191 =item e
10192
10193 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10194 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10195 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10196 C<expr>, C<extensions>, C<extras>
10197
10198 =item f
10199
10200 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10201 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10202 C<full_sed>
10203
10204 =item g
10205
10206 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
10207 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
10208 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
10209 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
10210 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
10211 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
10212 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
10213 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
10214 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
10215 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
10216
10217 =item h
10218
10219 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
10220 C<html3dir>, C<html3direxp>
10221
10222 =item i
10223
10224 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10225 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10226 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10227 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10228 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10229 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10230 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10231 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10232 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10233 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10234 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10235 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10236 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10237 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10238 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10239 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10240 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10241 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10242 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
10243 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
10244 C<installprefixexp>, C<installprivlib>, C<installscript>,
10245 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
10246 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
10247 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
10248 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
10249 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
10250 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
10251 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10252
10253 =item k
10254
10255 C<known_extensions>, C<ksh>
10256
10257 =item l
10258
10259 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10260 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10261 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10262 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10263 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10264 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10265 C<lseektype>
10266
10267 =item m
10268
10269 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10270 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10271 C<man3direxp>, C<man3ext>
10272
10273 =item M
10274
10275 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
10276 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
10277 C<myuname>
10278
10279 =item n
10280
10281 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10282 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10283 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10284 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10285 C<nvsize>, C<nvtype>
10286
10287 =item o
10288
10289 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10290 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10291
10292 =item p
10293
10294 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10295 C<perl>, C<perl_patchlevel>
10296
10297 =item P
10298
10299 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10300 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10301 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10302 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10303
10304 =item q
10305
10306 C<quadkind>, C<quadtype>
10307
10308 =item r
10309
10310 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10311 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10312 C<rmail>, C<run>, C<runnm>
10313
10314 =item s
10315
10316 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10317 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10318 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10319 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10320 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10321 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10322 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10323 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
10324 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
10325 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
10326 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
10327 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
10328 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
10329 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
10330 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
10331 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
10332 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
10333 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
10334 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
10335 C<submit>, C<subversion>, C<sysman>
10336
10337 =item t
10338
10339 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10340 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10341 C<ttyname_r_proto>
10342
10343 =item u
10344
10345 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10346 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10347 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10348 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
10349 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
10350 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
10351 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
10352 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
10353 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
10354 C<uvXUformat>
10355
10356 =item v
10357
10358 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10359 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
10360 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
10361 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
10362 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
10363 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
10364 C<versiononly>, C<vi>, C<voidflags>
10365
10366 =item x
10367
10368 C<xlibpth>, C<xs_apiversion>
10369
10370 =item y
10371
10372 C<yacc>, C<yaccflags>
10373
10374 =item z
10375
10376 C<zcat>, C<zip>
10377
10378 =back
10379
10380 =item NOTE
10381
10382 =back
10383
10384 =head2 Cwd - get pathname of current working directory
10385
10386 =over 4
10387
10388 =item SYNOPSIS
10389
10390 =item DESCRIPTION
10391
10392 =over 4
10393
10394 =item getcwd and friends
10395
10396 getcwd, cwd, fastcwd, fastgetcwd
10397
10398 =item abs_path and friends
10399
10400 abs_path, realpath, fast_abs_path
10401
10402 =item $ENV{PWD}
10403
10404 =back
10405
10406 =item NOTES
10407
10408 =item SEE ALSO
10409
10410 =back
10411
10412 =head2 DB - programmatic interface to the Perl debugging API (draft,
10413 subject to
10414 change)
10415
10416 =over 4
10417
10418 =item SYNOPSIS
10419
10420 =item DESCRIPTION
10421
10422 =over 4
10423
10424 =item Global Variables
10425
10426  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
10427 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
10428 $DB::lineno
10429
10430 =item API Methods
10431
10432 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10433 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10434
10435 =item Client Callback Methods
10436
10437 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10438 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10439 CLIENT->output(LIST)
10440
10441 =back
10442
10443 =item BUGS
10444
10445 =item AUTHOR
10446
10447 =back
10448
10449 =head2 DBM_Filter -- Filter DBM keys/values 
10450
10451 =over 4
10452
10453 =item SYNOPSIS
10454
10455 =item DESCRIPTION
10456
10457 =item What is a DBM Filter?
10458
10459 =over 4
10460
10461 =item So what's new?
10462
10463 =back
10464
10465 =item METHODS
10466
10467 =over 4
10468
10469 =item $db->Filter_Push()
10470
10471 =item $db->Filter_Key_Push()
10472
10473 =item $db->Filter_Value_Push()
10474
10475 Filter_Push, Filter_Key_Push, Filter_Value_Push
10476
10477 =item $db->Filter_Pop()
10478
10479 =item $db->Filtered()
10480
10481 =back
10482
10483 =item Writing a Filter
10484
10485 =over 4
10486
10487 =item Immediate Filters
10488
10489 =item Canned Filters
10490
10491 "name", params
10492
10493 =back
10494
10495 =item Filters Included
10496
10497 utf8, encode, compress, int32, null
10498
10499 =item NOTES
10500
10501 =over 4
10502
10503 =item Maintain Round Trip Integrity
10504
10505 =item Don't mix filtered & non-filtered data in the same database file. 
10506
10507 =back
10508
10509 =item EXAMPLE
10510
10511 =item SEE ALSO
10512
10513 =item AUTHOR
10514
10515 =back
10516
10517 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10518
10519 =over 4
10520
10521 =item SYNOPSIS
10522
10523 =item DESCRIPTION
10524
10525 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10526
10527 =over 4
10528
10529 =item Using DB_File with Berkeley DB version 2 or greater
10530
10531 =item Interface to Berkeley DB
10532
10533 =item Opening a Berkeley DB Database File
10534
10535 =item Default Parameters
10536
10537 =item In Memory Databases
10538
10539 =back
10540
10541 =item DB_HASH
10542
10543 =over 4
10544
10545 =item A Simple Example
10546
10547 =back
10548
10549 =item DB_BTREE
10550
10551 =over 4
10552
10553 =item Changing the BTREE sort order
10554
10555 =item Handling Duplicate Keys 
10556
10557 =item The get_dup() Method
10558
10559 =item The find_dup() Method
10560
10561 =item The del_dup() Method
10562
10563 =item Matching Partial Keys 
10564
10565 =back
10566
10567 =item DB_RECNO
10568
10569 =over 4
10570
10571 =item The 'bval' Option
10572
10573 =item A Simple Example
10574
10575 =item Extra RECNO Methods
10576
10577 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10578 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10579 length, elements);>
10580
10581 =item Another Example
10582
10583 =back
10584
10585 =item THE API INTERFACE
10586
10587 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10588 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10589 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10590 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10591
10592 =item DBM FILTERS
10593
10594 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10595 B<filter_fetch_value>
10596
10597 =over 4
10598
10599 =item The Filter
10600
10601 =item An Example -- the NULL termination problem.
10602
10603 =item Another Example -- Key is a C int.
10604
10605 =back
10606
10607 =item HINTS AND TIPS 
10608
10609 =over 4
10610
10611 =item Locking: The Trouble with fd
10612
10613 =item Safe ways to lock a database
10614
10615 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10616
10617 =item Sharing Databases With C Applications
10618
10619 =item The untie() Gotcha
10620
10621 =back
10622
10623 =item COMMON QUESTIONS
10624
10625 =over 4
10626
10627 =item Why is there Perl source in my database?
10628
10629 =item How do I store complex data structures with DB_File?
10630
10631 =item What does "Invalid Argument" mean?
10632
10633 =item What does "Bareword 'DB_File' not allowed" mean? 
10634
10635 =back
10636
10637 =item REFERENCES
10638
10639 =item HISTORY
10640
10641 =item BUGS
10642
10643 =item AVAILABILITY
10644
10645 =item COPYRIGHT
10646
10647 =item SEE ALSO
10648
10649 =item AUTHOR
10650
10651 =back
10652
10653 =head2 Data::Dumper - stringified perl data structures, suitable for both
10654 printing and C<eval>
10655
10656 =over 4
10657
10658 =item SYNOPSIS
10659
10660 =item DESCRIPTION
10661
10662 =over 4
10663
10664 =item Methods
10665
10666 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
10667 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
10668 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
10669 I<$OBJ>->Reset
10670
10671 =item Functions
10672
10673 Dumper(I<LIST>)
10674
10675 =item Configuration Variables or Methods
10676
10677 =item Exports
10678
10679 Dumper
10680
10681 =back
10682
10683 =item EXAMPLES
10684
10685 =item BUGS
10686
10687 =over 4
10688
10689 =item NOTE
10690
10691 =back
10692
10693 =item AUTHOR
10694
10695 =item VERSION
10696
10697 =item SEE ALSO
10698
10699 =back
10700
10701 =head2 Devel::DProf - a Perl code profiler
10702
10703 =over 4
10704
10705 =item SYNOPSIS
10706
10707 =item DESCRIPTION
10708
10709 =item PROFILE FORMAT
10710
10711 =item AUTOLOAD
10712
10713 =item ENVIRONMENT
10714
10715 =item BUGS
10716
10717 =item SEE ALSO
10718
10719 =back
10720
10721 =head2 Devel::PPPort - Perl/Pollution/Portability
10722
10723 =over 4
10724
10725 =item SYNOPSIS
10726
10727 =item DESCRIPTION
10728
10729 =over 4
10730
10731 =item WriteFile
10732
10733 =back
10734
10735 =item ppport.h
10736
10737 =item AUTHOR
10738
10739 =item SEE ALSO
10740
10741 =back
10742
10743 =head2 Devel::Peek - A data debugging tool for the XS programmer
10744
10745 =over 4
10746
10747 =item SYNOPSIS
10748
10749 =item DESCRIPTION
10750
10751 =over 4
10752
10753 =item Runtime debugging
10754
10755 =item Memory footprint debugging
10756
10757 =back
10758
10759 =item EXAMPLES
10760
10761 =over 4
10762
10763 =item A simple scalar string
10764
10765 =item A simple scalar number
10766
10767 =item A simple scalar with an extra reference
10768
10769 =item A reference to a simple scalar
10770
10771 =item A reference to an array
10772
10773 =item A reference to a hash
10774
10775 =item Dumping a large array or hash
10776
10777 =item A reference to an SV which holds a C pointer
10778
10779 =item A reference to a subroutine
10780
10781 =back
10782
10783 =item EXPORTS
10784
10785 =item BUGS
10786
10787 =item AUTHOR
10788
10789 =item SEE ALSO
10790
10791 =back
10792
10793 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
10794
10795 =over 4
10796
10797 =item SYNOPSIS
10798
10799 =item DESCRIPTION
10800
10801 =back
10802
10803 =head2 Digest - Modules that calculate message digests
10804
10805 =over 4
10806
10807 =item SYNOPSIS
10808
10809 =item DESCRIPTION
10810
10811 I<binary>, I<hex>, I<base64>
10812
10813 =item OO INTERFACE
10814
10815 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
10816 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
10817 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
10818 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
10819 $ctx->hexdigest, $ctx->b64digest
10820
10821 =item Digest speed
10822
10823 =item SEE ALSO
10824
10825 =item AUTHOR
10826
10827 =back
10828
10829 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
10830
10831 =over 4
10832
10833 =item SYNOPSIS
10834
10835 =item DESCRIPTION
10836
10837 =item FUNCTIONS
10838
10839 md5($data,...), md5_hex($data,...), md5_base64($data,...)
10840
10841 =item METHODS
10842
10843 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
10844 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
10845 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
10846
10847 =item EXAMPLES
10848
10849 =item SEE ALSO
10850
10851 =item COPYRIGHT
10852
10853 =item AUTHORS
10854
10855 =back
10856
10857 =head2 Digest::base - Digest base class
10858
10859 =over 4
10860
10861 =item SYNPOSIS
10862
10863 =item DESCRIPTION
10864
10865 =item SEE ALSO
10866
10867 =back
10868
10869 =head2 DirHandle - supply object methods for directory handles
10870
10871 =over 4
10872
10873 =item SYNOPSIS
10874
10875 =item DESCRIPTION
10876
10877 =item NOTES
10878
10879 =back
10880
10881 =head2 Dumpvalue - provides screen dump of Perl data.
10882
10883 =over 4
10884
10885 =item SYNOPSIS
10886
10887 =item DESCRIPTION
10888
10889 =over 4
10890
10891 =item Creation
10892
10893 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
10894 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
10895 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
10896 stopDbSignal
10897
10898 =item Methods
10899
10900 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
10901 compactDump, veryCompact, set, get
10902
10903 =back
10904
10905 =back
10906
10907 =head2 DynaLoader - Dynamically load C libraries into Perl code
10908
10909 =over 4
10910
10911 =item SYNOPSIS
10912
10913 =item DESCRIPTION
10914
10915 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
10916 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
10917 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
10918 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
10919 dl_install_xsub(), bootstrap()
10920
10921 =item AUTHOR
10922
10923 =back
10924
10925 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
10926 Perl code
10927
10928 =over 4
10929
10930 =item SYNOPSIS
10931
10932 =item DESCRIPTION
10933
10934 =over 4
10935
10936 =item Migration from C<DynaLoader>
10937
10938 =item Backward compatible boilerplate
10939
10940 =back
10941
10942 =item Order of initialization: early load()
10943
10944 =over 4
10945
10946 =item The most hairy case
10947
10948 =back
10949
10950 =item LIMITATIONS
10951
10952 =item AUTHOR
10953
10954 =back
10955
10956 =head2 Encode - character encodings
10957
10958 =over 4
10959
10960 =item SYNOPSIS
10961
10962 =over 4
10963
10964 =item Table of Contents
10965
10966 =back
10967
10968 =item DESCRIPTION
10969
10970 =over 4
10971
10972 =item TERMINOLOGY
10973
10974 =back
10975
10976 =item PERL ENCODING API
10977
10978 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
10979 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
10980 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
10981 CHECK]);
10982
10983 =over 4
10984
10985 =item Listing available encodings
10986
10987 =item Defining Aliases
10988
10989 =back
10990
10991 =item Encoding via PerlIO
10992
10993 =item Handling Malformed Data
10994
10995 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
10996 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
10997 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
10998 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
10999 bitmask
11000
11001 =over 4
11002
11003 =item Unimplemented fallback schemes
11004
11005 =back
11006
11007 =item Defining Encodings
11008
11009 =item The UTF-8 flag
11010
11011 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11012
11013 =over 4
11014
11015 =item Messing with Perl's Internals
11016
11017 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11018
11019 =back
11020
11021 =item SEE ALSO
11022
11023 =item MAINTAINER
11024
11025 =back
11026
11027 =head2 Encode::Alias - alias definitions to encodings
11028
11029 =over 4
11030
11031 =item SYNOPSIS
11032
11033 =item DESCRIPTION
11034
11035 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11036 reference, e.g.:
11037
11038 =over 4
11039
11040 =item Alias overloading
11041
11042 =back
11043
11044 =item SEE ALSO
11045
11046 =back
11047
11048 =head2 Encode::Byte - Single Byte Encodings
11049
11050 =over 4
11051
11052 =item SYNOPSIS
11053
11054 =item ABSTRACT
11055
11056 =item DESCRIPTION
11057
11058 =item SEE ALSO
11059
11060 =back
11061
11062 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11063
11064 =head2 Encode::CN - China-based Chinese Encodings
11065
11066 =over 4
11067
11068 =item SYNOPSIS
11069
11070 =item DESCRIPTION
11071
11072 =item NOTES
11073
11074 =item BUGS
11075
11076 =item SEE ALSO
11077
11078 =back
11079
11080 =head2 Encode::CN::HZ -- internally used by Encode::CN
11081
11082 =head2 Encode::Config -- internally used by Encode
11083
11084 =head2 Encode::EBCDIC - EBCDIC Encodings
11085
11086 =over 4
11087
11088 =item SYNOPSIS
11089
11090 =item ABSTRACT
11091
11092 =item DESCRIPTION
11093
11094 =item SEE ALSO
11095
11096 =back
11097
11098 =head2 Encode::Encoding - Encode Implementation Base Class
11099
11100 =over 4
11101
11102 =item SYNOPSIS
11103
11104 =item DESCRIPTION
11105
11106 =over 4
11107
11108 =item Methods you should implement
11109
11110 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11111 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11112
11113 =item Other methods defined in Encode::Encodings
11114
11115 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11116
11117 =item Example: Encode::ROT13
11118
11119 =back
11120
11121 =item Why the heck Encode API is different?
11122
11123 =over 4
11124
11125 =item Compiled Encodings
11126
11127 =back
11128
11129 =item SEE ALSO
11130
11131 Scheme 1, Scheme 2, Other Schemes
11132
11133 =back
11134
11135 =head2 Encode::Guess -- Guesses encoding from data
11136
11137 =over 4
11138
11139 =item SYNOPSIS
11140
11141 =item ABSTRACT
11142
11143 =item DESCRIPTION
11144
11145 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11146 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11147 guess_encoding($data, [, I<list of suspects>])
11148
11149 =item CAVEATS
11150
11151 =item TO DO
11152
11153 =item SEE ALSO
11154
11155 =back
11156
11157 =head2 Encode::JP - Japanese Encodings
11158
11159 =over 4
11160
11161 =item SYNOPSIS
11162
11163 =item ABSTRACT
11164
11165 =item DESCRIPTION
11166
11167 =item Note on ISO-2022-JP(-1)?
11168
11169 =item BUGS
11170
11171 =item SEE ALSO
11172
11173 =back
11174
11175 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11176
11177 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11178
11179 =head2 Encode::KR - Korean Encodings
11180
11181 =over 4
11182
11183 =item SYNOPSIS
11184
11185 =item DESCRIPTION
11186
11187 =item BUGS
11188
11189 =item SEE ALSO
11190
11191 =back
11192
11193 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11194
11195 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11196
11197 =over 4
11198
11199 =item SYNOPSIS
11200
11201 =item ABSTRACT
11202
11203 =item DESCRIPTION
11204
11205 =item BUGS
11206
11207 =item SEE ALSO
11208
11209 =back
11210
11211 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11212
11213 =over 4
11214
11215 =item Overview
11216
11217 =item How does it work?
11218
11219 =item Line Buffering
11220
11221 =over 4
11222
11223 =item How can I tell whether my encoding fully supports PerlIO ?
11224
11225 =back
11226
11227 =item SEE ALSO
11228
11229 =back
11230
11231 =head2 Encode::Supported -- Encodings supported by Encode
11232
11233 =over 4
11234
11235 =item DESCRIPTION
11236
11237 =over 4
11238
11239 =item Encoding Names
11240
11241 =back
11242
11243 =item Supported Encodings
11244
11245 =over 4
11246
11247 =item Built-in Encodings
11248
11249 =item Encode::Unicode -- other Unicode encodings
11250
11251 =item Encode::Byte -- Extended ASCII
11252
11253 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11254 the Cyrillic world, gsm0338 - Hentai Latin 1
11255
11256 =item CJK: Chinese, Japanese, Korean (Multibyte)
11257
11258 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11259 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11260 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11261
11262 =item Miscellaneous encodings
11263
11264 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11265
11266 =back
11267
11268 =item Unsupported encodings
11269
11270   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11271 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11272 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11273 Various Mac encodings, (Mac) Indic encodings
11274
11275 =item Encoding vs. Charset -- terminology
11276
11277 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11278
11279 =over 4
11280
11281 =item Microsoft-related naming mess
11282
11283 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11284
11285 =back
11286
11287 =item Glossary
11288
11289 character repertoire, coded character set (CCS), character encoding scheme
11290 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11291 UTF-16
11292
11293 =item See Also
11294
11295 =item References
11296
11297 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11298 RFC, UC, Unicode Glossary
11299
11300 =over 4
11301
11302 =item Other Notable Sites
11303
11304 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11305 "Introduction to i18n"
11306
11307 =item Offline sources
11308
11309 C<CJKV Information Processing> by Ken Lunde
11310
11311 =back
11312
11313 =back
11314
11315 =head2 Encode::Symbol - Symbol Encodings
11316
11317 =over 4
11318
11319 =item SYNOPSIS
11320
11321 =item ABSTRACT
11322
11323 =item DESCRIPTION
11324
11325 =item SEE ALSO
11326
11327 =back
11328
11329 =head2 Encode::TW - Taiwan-based Chinese Encodings
11330
11331 =over 4
11332
11333 =item SYNOPSIS
11334
11335 =item DESCRIPTION
11336
11337 =item NOTES
11338
11339 =item BUGS
11340
11341 =item SEE ALSO
11342
11343 =back
11344
11345 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11346
11347 =over 4
11348
11349 =item SYNOPSIS
11350
11351 =item ABSTRACT
11352
11353 L<http://www.unicode.org/glossary/> says:, Quick Reference
11354
11355 =item Size, Endianness, and BOM
11356
11357 =over 4
11358
11359 =item by size
11360
11361 =item by endianness
11362
11363 BOM as integer when fetched in network byte order
11364
11365 =back
11366
11367 =item Surrogate Pairs
11368
11369 =item SEE ALSO
11370
11371 =back
11372
11373 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
11374
11375 =over 4
11376
11377 =item SYNOPSIS
11378
11379 =item ABSTRACT
11380
11381 =item In Practice
11382
11383 =item SEE ALSO
11384
11385 =back
11386
11387 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11388 encodings
11389
11390 =over 4
11391
11392 =item SYNOPSIS
11393
11394 =item DESCRIPTION
11395
11396 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11397 reference, e.g.:
11398
11399 =over 4
11400
11401 =item Alias overloading
11402
11403 =back
11404
11405 =item SEE ALSO
11406
11407 =back
11408
11409 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
11410 Internally used by Encode::??::ISO_2022_*
11411
11412 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11413 Encode::CN
11414
11415 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11416 Encode
11417
11418 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11419 Implementation Base Class
11420
11421 =over 4
11422
11423 =item SYNOPSIS
11424
11425 =item DESCRIPTION
11426
11427 =over 4
11428
11429 =item Methods you should implement
11430
11431 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11432 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11433
11434 =item Other methods defined in Encode::Encodings
11435
11436 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11437
11438 =item Example: Encode::ROT13
11439
11440 =back
11441
11442 =item Why the heck Encode API is different?
11443
11444 =over 4
11445
11446 =item Compiled Encodings
11447
11448 =back
11449
11450 =item SEE ALSO
11451
11452 Scheme 1, Scheme 2, Other Schemes
11453
11454 =back
11455
11456 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11457 data
11458
11459 =over 4
11460
11461 =item SYNOPSIS
11462
11463 =item ABSTRACT
11464
11465 =item DESCRIPTION
11466
11467 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11468 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11469 guess_encoding($data, [, I<list of suspects>])
11470
11471 =item CAVEATS
11472
11473 =item TO DO
11474
11475 =item SEE ALSO
11476
11477 =back
11478
11479 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11480 Encode::JP::2022_JP*
11481
11482 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11483 by Encode::JP
11484
11485 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11486 used by Encode::KR
11487
11488 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11489 and 'Q' header encoding
11490
11491 =over 4
11492
11493 =item SYNOPSIS
11494
11495 =item ABSTRACT
11496
11497 =item DESCRIPTION
11498
11499 =item BUGS
11500
11501 =item SEE ALSO
11502
11503 =back
11504
11505 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11506 on Encode and PerlIO
11507
11508 =over 4
11509
11510 =item Overview
11511
11512 =item How does it work?
11513
11514 =item Line Buffering
11515
11516 =over 4
11517
11518 =item How can I tell whether my encoding fully supports PerlIO ?
11519
11520 =back
11521
11522 =item SEE ALSO
11523
11524 =back
11525
11526 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11527 supported by Encode
11528
11529 =over 4
11530
11531 =item DESCRIPTION
11532
11533 =over 4
11534
11535 =item Encoding Names
11536
11537 =back
11538
11539 =item Supported Encodings
11540
11541 =over 4
11542
11543 =item Built-in Encodings
11544
11545 =item Encode::Unicode -- other Unicode encodings
11546
11547 =item Encode::Byte -- Extended ASCII
11548
11549 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11550 the Cyrillic world, gsm0338 - Hentai Latin 1
11551
11552 =item CJK: Chinese, Japanese, Korean (Multibyte)
11553
11554 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11555 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11556 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11557
11558 =item Miscellaneous encodings
11559
11560 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11561
11562 =back
11563
11564 =item Unsupported encodings
11565
11566   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11567 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11568 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11569 Various Mac encodings, (Mac) Indic encodings
11570
11571 =item Encoding vs. Charset -- terminology
11572
11573 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11574
11575 =over 4
11576
11577 =item Microsoft-related naming mess
11578
11579 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11580
11581 =back
11582
11583 =item Glossary
11584
11585 character repertoire, coded character set (CCS), character encoding scheme
11586 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11587 UTF-16
11588
11589 =item See Also
11590
11591 =item References
11592
11593 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11594 RFC, UC, Unicode Glossary
11595
11596 =over 4
11597
11598 =item Other Notable Sites
11599
11600 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11601 "Introduction to i18n"
11602
11603 =item Offline sources
11604
11605 C<CJKV Information Processing> by Ken Lunde
11606
11607 =back
11608
11609 =back
11610
11611 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
11612 encoding
11613
11614 =over 4
11615
11616 =item SYNOPSIS
11617
11618 =item ABSTRACT
11619
11620 =item In Practice
11621
11622 =item SEE ALSO
11623
11624 =back
11625
11626 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11627
11628 =over 4
11629
11630 =item SYNOPSIS
11631
11632 =item ABSTRACT
11633
11634 =item Description
11635
11636 =over 4
11637
11638 =item Predefined Methods
11639
11640 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11641 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11642 $e-E<gt>bytes([$encoding])
11643
11644 =item Example: base64 transcoder
11645
11646 =item Operator Overloading
11647
11648 =back
11649
11650 =item SEE ALSO
11651
11652 =back
11653
11654 =head2 Encodencoding, encoding - allows you to write your script in
11655 non-ascii or non-utf8
11656
11657 =over 4
11658
11659 =item SYNOPSIS
11660
11661 =item ABSTRACT
11662
11663 =over 4
11664
11665 =item Literal Conversions
11666
11667 =item PerlIO layers for C<STD(IN|OUT)>
11668
11669 =item Implicit upgrading for byte strings
11670
11671 =back
11672
11673 =item FEATURES THAT REQUIRE 5.8.1
11674
11675 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
11676
11677 =item USAGE
11678
11679 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11680 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
11681
11682 =item The Filter Option
11683
11684 =over 4
11685
11686 =item Filter-related changes at Encode version 1.87
11687
11688 =back
11689
11690 =item CAVEATS
11691
11692 =over 4
11693
11694 =item NOT SCOPED
11695
11696 =item DO NOT MIX MULTIPLE ENCODINGS
11697
11698 =item tr/// with ranges
11699
11700 Legend of characters above
11701
11702 =back
11703
11704 =item EXAMPLE - Greekperl
11705
11706 =item KNOWN PROBLEMS
11707
11708 literals in regex that are longer than 127 bytes, EBCDIC, format
11709
11710 =item HISTORY
11711
11712 =item SEE ALSO
11713
11714 =back
11715
11716 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
11717
11718 =over 4
11719
11720 =item SYNOPSIS
11721
11722 =item ABSTRACT
11723
11724 =item Description
11725
11726 =over 4
11727
11728 =item Predefined Methods
11729
11730 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11731 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11732 $e-E<gt>bytes([$encoding])
11733
11734 =item Example: base64 transcoder
11735
11736 =item Operator Overloading
11737
11738 =back
11739
11740 =item SEE ALSO
11741
11742 =back
11743
11744 =head2 English - use nice English (or awk) names for ugly punctuation
11745 variables
11746
11747 =over 4
11748
11749 =item SYNOPSIS
11750
11751 =item DESCRIPTION
11752
11753 =item PERFORMANCE
11754
11755 =back
11756
11757 =head2 Env - perl module that imports environment variables as scalars or
11758 arrays
11759
11760 =over 4
11761
11762 =item SYNOPSIS
11763
11764 =item DESCRIPTION
11765
11766 =item LIMITATIONS
11767
11768 =item AUTHOR
11769
11770 =back
11771
11772 =head2 Errno - System errno constants
11773
11774 =over 4
11775
11776 =item SYNOPSIS
11777
11778 =item DESCRIPTION
11779
11780 =item CAVEATS
11781
11782 =item AUTHOR
11783
11784 =item COPYRIGHT
11785
11786 =back
11787
11788 =head2 Exporter - Implements default import method for modules
11789
11790 =over 4
11791
11792 =item SYNOPSIS
11793
11794 =item DESCRIPTION
11795
11796 =over 4
11797
11798 =item How to Export
11799
11800 =item Selecting What To Export
11801
11802 =item How to Import
11803
11804 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
11805
11806 =back
11807
11808 =item Advanced features
11809
11810 =over 4
11811
11812 =item Specialised Import Lists
11813
11814 =item Exporting without using Exporter's import method
11815
11816 =item Exporting without inheriting from Exporter
11817
11818 =item Module Version Checking
11819
11820 =item Managing Unknown Symbols
11821
11822 =item Tag Handling Utility Functions
11823
11824 =item Generating combined tags
11825
11826 =item C<AUTOLOAD>ed Constants
11827
11828 =back
11829
11830 =back
11831
11832 =head2 Exporter::Heavy - Exporter guts
11833
11834 =over 4
11835
11836 =item SYNOPSIS
11837
11838 =item DESCRIPTION
11839
11840 =back
11841
11842 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
11843 Makefiles etc.
11844
11845 =over 4
11846
11847 =item SYNOPSIS
11848
11849 =item DESCRIPTION
11850
11851 =back
11852
11853 cat
11854
11855 eqtime src dst
11856
11857 rm_rf files...
11858
11859 rm_f files...
11860
11861 touch files ..
11862
11863 mv source... destination
11864
11865 cp source... destination
11866
11867 chmod mode files..
11868
11869 mkpath directory..
11870
11871 test_f file
11872
11873 dos2unix
11874
11875 =over 4
11876
11877 =item BUGS
11878
11879 =item SEE ALSO 
11880
11881 =item AUTHOR
11882
11883 =back
11884
11885 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
11886
11887 =over 4
11888
11889 =item SYNOPSIS
11890
11891 =item DESCRIPTION
11892
11893 B<test_harness>
11894
11895 =back
11896
11897 B<pod2man>
11898
11899 B<warn_if_old_packlist>
11900
11901 B<perllocal_install>
11902
11903 B<uninstall>
11904
11905 =head2 ExtUtils::Constant - generate XS code to import C header constants
11906
11907 =over 4
11908
11909 =item SYNOPSIS
11910
11911 =item DESCRIPTION
11912
11913 =item USAGE
11914
11915 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
11916
11917 =item FUNCTIONS
11918
11919 =back
11920
11921 C_stringify NAME
11922
11923 perl_stringify NAME
11924
11925 constant_types
11926
11927 memEQ_clause NAME, CHECKED_AT, INDENT
11928
11929 assign INDENT, TYPE, PRE, POST, VALUE..
11930
11931 return_clause
11932
11933 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
11934
11935 params WHAT
11936
11937 dump_names
11938
11939 dogfood
11940
11941 C_constant, name, type, value, macro, default, pre, post, def_pre =item
11942 def_post, utf8
11943
11944 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
11945
11946 autoload PACKAGE, VERSION, AUTOLOADER
11947
11948 WriteMakefileSnippet
11949
11950 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
11951 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
11952
11953 =over 4
11954
11955 =item AUTHOR
11956
11957 =back
11958
11959 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
11960
11961 =over 4
11962
11963 =item SYNOPSIS
11964
11965 =item DESCRIPTION
11966
11967 =item @EXPORT
11968
11969 =item FUNCTIONS
11970
11971 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
11972 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
11973
11974 =item EXAMPLES
11975
11976 =item SEE ALSO
11977
11978 =item AUTHOR
11979
11980 =back
11981
11982 =head2 ExtUtils::Install - install files from here to there
11983
11984 =over 4
11985
11986 =item SYNOPSIS
11987
11988 =item DESCRIPTION
11989
11990 =over 4
11991
11992 =item Functions
11993
11994 B<install>
11995
11996 =back
11997
11998 =back
11999
12000 B<install_default> I<DISCOURAGED>
12001
12002 B<uninstall>
12003
12004 B<pm_to_blib>
12005
12006 _autosplit
12007
12008 =over 4
12009
12010 =item ENVIRONMENT
12011
12012 B<PERL_INSTALL_ROOT>
12013
12014 =item AUTHOR
12015
12016 =item LICENSE
12017
12018 =back
12019
12020 =head2 ExtUtils::Installed - Inventory management of installed modules
12021
12022 =over 4
12023
12024 =item SYNOPSIS
12025
12026 =item DESCRIPTION
12027
12028 =item USAGE
12029
12030 =item FUNCTIONS
12031
12032 new(), modules(), files(), directories(), directory_tree(), validate(),
12033 packlist(), version()
12034
12035 =item EXAMPLE
12036
12037 =item AUTHOR
12038
12039 =back
12040
12041 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12042
12043 =over 4
12044
12045 =item SYNOPSIS
12046
12047 =item DESCRIPTION
12048
12049 For static extensions, For dynamic extensions at build/link time, For
12050 dynamic extensions at load time
12051
12052 =over 4
12053
12054 =item EXTRALIBS
12055
12056 =item LDLOADLIBS and LD_RUN_PATH
12057
12058 =item BSLOADLIBS
12059
12060 =back
12061
12062 =item PORTABILITY
12063
12064 =over 4
12065
12066 =item VMS implementation
12067
12068 =item Win32 implementation
12069
12070 =back
12071
12072 =item SEE ALSO
12073
12074 =back
12075
12076 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12077
12078 =over 4
12079
12080 =item SYNOPSIS
12081
12082 =item DESCRIPTION
12083
12084 =back
12085
12086 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
12087
12088 =over 4
12089
12090 =item SYNOPSIS
12091
12092 =item DESCRIPTION
12093
12094 =item Inherently Cross-Platform Methods
12095
12096 installvars
12097
12098 =back
12099
12100 os_flavor_is
12101
12102 blibdirs_target (o)
12103
12104 =over 4
12105
12106 =item File::Spec wrappers
12107
12108 catfile
12109
12110 =back
12111
12112 =over 4
12113
12114 =item Thought To Be Cross-Platform Methods
12115
12116 B<split_command>
12117
12118 =back
12119
12120 B<echo>
12121
12122 init_VERSION
12123
12124 wraplist
12125
12126 manifypods
12127
12128 manifypods_target
12129
12130 makemakerdflt_target
12131
12132 special_targets
12133
12134 POD2MAN_macro
12135
12136 test_via_harness
12137
12138 test_via_script
12139
12140 libscan
12141
12142 tool_autosplit
12143
12144 all_target
12145
12146 metafile_target
12147
12148 signature_target
12149
12150 metafile_addtomanifest_target
12151
12152 signature_addtomanifest_target
12153
12154 =over 4
12155
12156 =item Abstract methods
12157
12158 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
12159 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
12160 platform_constants
12161
12162 =back
12163
12164 os_flavor
12165
12166 =over 4
12167
12168 =item AUTHOR
12169
12170 =back
12171
12172 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12173 ExtUtils::MakeMaker
12174
12175 =over 4
12176
12177 =item SYNOPSIS
12178
12179 =item DESCRIPTION
12180
12181 =back
12182
12183 os_flavor (o)
12184
12185 init_linker
12186
12187 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12188 ExtUtils::MakeMaker
12189
12190 =over 4
12191
12192 =item SYNOPSIS
12193
12194 =item DESCRIPTION
12195
12196 os_flavor (o)
12197
12198 =back
12199
12200 cflags (o)
12201
12202 replace_manpage_separator (o)
12203
12204 init_linker
12205
12206 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12207
12208 =over 4
12209
12210 =item SYNOPSIS
12211
12212 =item DESCRIPTION
12213
12214 =over 4
12215
12216 =item Overridden methods
12217
12218 os_flavor
12219
12220 =back
12221
12222 =back
12223
12224 B<replace_manpage_separator>
12225
12226 =over 4
12227
12228 =item AUTHOR
12229
12230 =item SEE ALSO
12231
12232 =back
12233
12234 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12235 ExtUtils::MakeMaker
12236
12237 =over 4
12238
12239 =item SYNOPSIS
12240
12241 =item DESCRIPTION
12242
12243 =back
12244
12245 maybe_command
12246
12247 guess_name
12248
12249 macify
12250
12251 patternify
12252
12253 init_main
12254
12255 init_others
12256
12257 init_platform, platform_constants
12258
12259 init_dirscan
12260
12261 init_VERSION (o)
12262
12263 special_targets (o)
12264
12265 static (o)
12266
12267 dlsyms (o)
12268
12269 dynamic (o)
12270
12271 clean (o)
12272
12273 clean_subdirs_target
12274
12275 realclean (o)
12276
12277 realclean_subdirs_target
12278
12279 rulez (o)
12280
12281 processPL (o)
12282
12283 os_flavor
12284
12285 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12286 ExtUtils::MakeMaker
12287
12288 =over 4
12289
12290 =item SYNOPSIS
12291
12292 =item DESCRIPTION
12293
12294 =back
12295
12296 os_flavor
12297
12298 init_platform (o), platform_constants
12299
12300 const_cccmd (o)
12301
12302 static_lib (o)
12303
12304 dynamic_lib (o)
12305
12306 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12307 ExtUtils::MakeMaker
12308
12309 =over 4
12310
12311 =item SYNOPSIS
12312
12313 =item DESCRIPTION
12314
12315 =item METHODS
12316
12317 init_dist (o)
12318
12319 =back
12320
12321 init_linker
12322
12323 os_flavor
12324
12325 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12326
12327 =over 4
12328
12329 =item SYNOPSIS
12330
12331 =item DESCRIPTION
12332
12333 =over 4
12334
12335 =item Overridden methods
12336
12337 os_flavor
12338
12339 =back
12340
12341 =back
12342
12343 B<replace_manpage_separator>
12344
12345 =over 4
12346
12347 =item AUTHOR
12348
12349 =item SEE ALSO
12350
12351 =back
12352
12353 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12354
12355 =over 4
12356
12357 =item SYNOPSIS
12358
12359 =item DESCRIPTION
12360
12361 =item METHODS
12362
12363 =back
12364
12365 =over 4
12366
12367 =item Methods
12368
12369 os_flavor (o)
12370
12371 =back
12372
12373 c_o (o)
12374
12375 cflags (o)
12376
12377 clean (o)
12378
12379 clean_subdirs_target
12380
12381 const_cccmd (o)
12382
12383 const_config (o)
12384
12385 const_loadlibs (o)
12386
12387 constants (o)
12388
12389 depend (o)
12390
12391 dir_target B<DEPRECATED>
12392
12393 init_DEST
12394
12395 init_dist
12396
12397 dist (o)
12398
12399 dist_basics (o)
12400
12401 dist_ci (o)
12402
12403 dist_core (o)
12404
12405 B<dist_target>
12406
12407 B<tardist_target>
12408
12409 B<zipdist_target>
12410
12411 B<tarfile_target>
12412
12413 zipfile_target
12414
12415 uutardist_target
12416
12417 shdist_target
12418
12419 distdir
12420
12421 dist_test
12422
12423 dlsyms (o)
12424
12425 dynamic (o)
12426
12427 dynamic_bs (o)
12428
12429 dynamic_lib (o)
12430
12431 exescan
12432
12433 extliblist
12434
12435 find_perl
12436
12437 find_tests
12438
12439 =over 4
12440
12441 =item Methods to actually produce chunks of text for the Makefile
12442
12443 fixin
12444
12445 =back
12446
12447 force (o)
12448
12449 guess_name
12450
12451 has_link_code
12452
12453 init_dirscan
12454
12455 init_DIRFILESEP
12456
12457 init_main
12458
12459 init_others
12460
12461 init_INST
12462
12463 init_INSTALL
12464
12465 init_linker
12466
12467 init_lib2arch
12468
12469 init_PERL
12470
12471 init_platform (o), platform_constants (o)
12472
12473 init_PERM
12474
12475 init_xs
12476
12477 install (o)
12478
12479 installbin (o)
12480
12481 linkext (o)
12482
12483 lsdir
12484
12485 macro (o)
12486
12487 makeaperl (o)
12488
12489 makefile (o)
12490
12491 maybe_command
12492
12493 needs_linking (o)
12494
12495 nicetext
12496
12497 parse_abstract
12498
12499 parse_version
12500
12501 pasthru (o)
12502
12503 perl_script
12504
12505 perldepend (o)
12506
12507 perm_rw (o)
12508
12509 perm_rwx (o)
12510
12511 pm_to_blib
12512
12513 post_constants (o)
12514
12515 post_initialize (o)
12516
12517 postamble (o)
12518
12519 ppd
12520
12521 prefixify
12522
12523 processPL (o)
12524
12525 quote_paren
12526
12527 realclean (o)
12528
12529 realclean_subdirs_target
12530
12531 replace_manpage_separator
12532
12533 oneliner (o)
12534
12535 quote_literal
12536
12537 escape_newlines
12538
12539 max_exec_len
12540
12541 static (o)
12542
12543 static_lib (o)
12544
12545 staticmake (o)
12546
12547 subdir_x (o)
12548
12549 subdirs (o)
12550
12551 test (o)
12552
12553 test_via_harness (override)
12554
12555 test_via_script (override)
12556
12557 tools_other (o)
12558
12559 tool_xsubpp (o)
12560
12561 all_target
12562
12563 top_targets (o)
12564
12565 writedoc
12566
12567 xs_c (o)
12568
12569 xs_cpp (o)
12570
12571 xs_o (o)
12572
12573 =over 4
12574
12575 =item SEE ALSO
12576
12577 =back
12578
12579 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12580 ExtUtils::MakeMaker
12581
12582 =over 4
12583
12584 =item SYNOPSIS
12585
12586 =item DESCRIPTION
12587
12588 =over 4
12589
12590 =item Methods always loaded
12591
12592 wraplist
12593
12594 =back
12595
12596 =back
12597
12598 =over 4
12599
12600 =item Methods
12601
12602 guess_name (override)
12603
12604 =back
12605
12606 find_perl (override)
12607
12608 maybe_command (override)
12609
12610 perl_script (override)
12611
12612 replace_manpage_separator
12613
12614 init_DEST
12615
12616 init_DIRFILESEP
12617
12618 init_main (override)
12619
12620 init_others (override)
12621
12622 init_platform (override)
12623
12624 platform_constants
12625
12626 init_VERSION (override)
12627
12628 constants (override)
12629
12630 special_targets
12631
12632 cflags (override)
12633
12634 const_cccmd (override)
12635
12636 tool_sxubpp (override)
12637
12638 tools_other (override)
12639
12640 init_dist (override)
12641
12642 c_o (override)
12643
12644 xs_c (override)
12645
12646 xs_o (override)
12647
12648 dlsyms (override)
12649
12650 dynamic_lib (override)
12651
12652 dynamic_bs (override)
12653
12654 static_lib (override)
12655
12656 processPL (override)
12657
12658 installbin (override)
12659
12660 subdir_x (override)
12661
12662 clean (override)
12663
12664 clean_subdirs_target
12665
12666 realclean (override)
12667
12668 zipfile_target (o), tarfile_target (o), shdist_target (o)
12669
12670 dist_test (override)
12671
12672 install (override)
12673
12674 perldepend (override)
12675
12676 makefile (override)
12677
12678 find_tests (override)
12679
12680 test (override)
12681
12682 makeaperl (override)
12683
12684 nicetext (override)
12685
12686 prefixify (override)
12687
12688 oneliner (o)
12689
12690 B<echo> (o)
12691
12692 quote_literal
12693
12694 escape_newlines
12695
12696 max_exec_len
12697
12698 init_linker (o)
12699
12700 eliminate_macros
12701
12702 fixpath
12703
12704 os_flavor
12705
12706 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12707 ExtUtils::MakeMaker
12708
12709 =over 4
12710
12711 =item SYNOPSIS
12712
12713 =item DESCRIPTION
12714
12715 =back
12716
12717 =over 4
12718
12719 =item Overridden methods
12720
12721 B<dlsyms>
12722
12723 =back
12724
12725 replace_manpage_separator
12726
12727 B<maybe_command>
12728
12729 B<find_tests>
12730
12731 B<init_DIRFILESEP>
12732
12733 B<init_others>
12734
12735 init_platform (o), platform_constants (o)
12736
12737 special_targets (o)
12738
12739 static_lib (o)
12740
12741 dynamic_lib (o)
12742
12743 clean
12744
12745 init_linker
12746
12747 perl_script
12748
12749 xs_o (o)
12750
12751 pasthru (o)
12752
12753 oneliner (o)
12754
12755 max_exec_len
12756
12757 os_flavor
12758
12759 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12760
12761 =over 4
12762
12763 =item SYNOPSIS
12764
12765 =item DESCRIPTION
12766
12767 =over 4
12768
12769 =item Overriden methods
12770
12771 dist_test
12772
12773 =back
12774
12775 =back
12776
12777 subdir_x
12778
12779 xs_c
12780
12781 xs_cpp
12782
12783 xs_o
12784
12785 clean_subdirs_target
12786
12787 realclean_subdirs_target
12788
12789 max_exec_len
12790
12791 os_flavor
12792
12793 =over 4
12794
12795 =item AUTHOR
12796
12797 =back
12798
12799 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12800
12801 =over 4
12802
12803 =item SYNOPSIS
12804
12805 =item DESCRIPTION
12806
12807 =back
12808
12809 =head2 ExtUtils::MakeMaker - Create a module Makefile
12810
12811 =over 4
12812
12813 =item SYNOPSIS
12814
12815 =item DESCRIPTION
12816
12817 =over 4
12818
12819 =item How To Write A Makefile.PL
12820
12821 =item Default Makefile Behaviour
12822
12823 =item make test
12824
12825 =item make testdb
12826
12827 =item make install
12828
12829 =item PREFIX and LIB attribute
12830
12831 =item AFS users
12832
12833 =item Static Linking of a new Perl Binary
12834
12835 =item Determination of Perl Library and Installation Locations
12836
12837 =item Which architecture dependent directory?
12838
12839 =item Using Attributes and Parameters
12840
12841 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12842 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
12843 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
12844 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
12845 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
12846 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
12847 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
12848 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
12849 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
12850 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
12851 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
12852 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
12853 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
12854 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
12855 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
12856 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
12857 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
12858 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
12859
12860 =item Additional lowercase attributes
12861
12862 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
12863 test, tool_autosplit
12864
12865 =item Overriding MakeMaker Methods
12866
12867 =item The End Of Cargo Cult Programming
12868
12869 C<<MAN3PODS => ' '>>
12870
12871 =item Hintsfile support
12872
12873 =item Distribution Support
12874
12875    make distcheck,    make skipcheck,    make distclean,    make manifest, 
12876   make distdir,   make disttest,    make tardist,    make dist,    make
12877 uutardist,    make shdist,    make zipdist,    make ci
12878
12879 =item Module Meta-Data
12880
12881 =item Disabling an extension
12882
12883 =item Other Handy Functions
12884
12885 prompt
12886
12887 =back
12888
12889 =item ENVIRONMENT
12890
12891 PERL_MM_OPT, PERL_MM_USE_DEFAULT
12892
12893 =item SEE ALSO
12894
12895 =item AUTHORS
12896
12897 =item LICENSE
12898
12899 =back
12900
12901 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
12902 MakeMaker
12903
12904 =over 4
12905
12906 =item DESCRIPTION
12907
12908 =over 4
12909
12910 =item Module Installation
12911
12912 How do I keep from installing man pages?, How do I use a module without
12913 installing it?
12914
12915 =item Philosophy and History
12916
12917 Why not just use <insert other build config tool here>?, What is
12918 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
12919 shell commands, easier to customize, cleaner internals, less cruft
12920
12921 =item Module Writing
12922
12923 How do I keep my $VERSION up to date without resetting it manually?, What's
12924 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
12925
12926 =item XS
12927
12928 How to I prevent "object version X.XX does not match bootstrap parameter
12929 Y.YY" errors?, How do I make two or more XS files coexist in the same
12930 directory?
12931
12932 =back
12933
12934 =item PATCHING
12935
12936 =item AUTHOR
12937
12938 =item SEE ALSO
12939
12940 =back
12941
12942 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
12943
12944 =over 4
12945
12946 =item SYNOPSIS
12947
12948 =item DESCRIPTION
12949
12950 =over 4
12951
12952 =item The Mantra
12953
12954 =item The Layout
12955
12956 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
12957 bin/
12958
12959 =back
12960
12961 =item SEE ALSO
12962
12963 =back
12964
12965 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
12966
12967 =over 4
12968
12969 =item SYNOPSIS
12970
12971 =item DESCRIPTION
12972
12973 =back
12974
12975 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
12976
12977 =over 4
12978
12979 =item SYNOPSIS
12980
12981 =item DESCRIPTION
12982
12983 =back
12984
12985 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
12986
12987 =over 4
12988
12989 =item SYNOPSIS
12990
12991 =item DESCRIPTION
12992
12993 =over 4
12994
12995 =item Functions
12996
12997 mkmanifest
12998
12999 =back
13000
13001 =back
13002
13003 manifind
13004
13005 manicheck
13006
13007 filecheck
13008
13009 fullcheck
13010
13011 skipcheck
13012
13013 maniread
13014
13015 manicopy
13016
13017 maniadd
13018
13019 =over 4
13020
13021 =item MANIFEST
13022
13023 =item MANIFEST.SKIP
13024
13025 =item EXPORT_OK
13026
13027 =item GLOBAL VARIABLES
13028
13029 =back
13030
13031 =over 4
13032
13033 =item DIAGNOSTICS
13034
13035 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13036 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13037
13038 =item ENVIRONMENT
13039
13040 B<PERL_MM_MANIFEST_DEBUG>
13041
13042 =item SEE ALSO
13043
13044 =item AUTHOR
13045
13046 =back
13047
13048 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13049
13050 =over 4
13051
13052 =item SYNOPSIS
13053
13054 =item DESCRIPTION
13055
13056 =back
13057
13058 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13059 extension
13060
13061 =over 4
13062
13063 =item SYNOPSIS
13064
13065 =item DESCRIPTION
13066
13067 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13068
13069 =item AUTHOR
13070
13071 =item REVISION
13072
13073 =back
13074
13075 =head2 ExtUtils::Packlist - manage .packlist files
13076
13077 =over 4
13078
13079 =item SYNOPSIS
13080
13081 =item DESCRIPTION
13082
13083 =item USAGE
13084
13085 =item FUNCTIONS
13086
13087 new(), read(), write(), validate(), packlist_file()
13088
13089 =item EXAMPLE
13090
13091 =item AUTHOR
13092
13093 =back
13094
13095 =head2 ExtUtils::testlib - add blib/* directories to @INC
13096
13097 =over 4
13098
13099 =item SYNOPSIS
13100
13101 =item DESCRIPTION
13102
13103 =back
13104
13105 =head2 Fatal - replace functions with equivalents which succeed or die
13106
13107 =over 4
13108
13109 =item SYNOPSIS
13110
13111 =item DESCRIPTION
13112
13113 =item AUTHOR
13114
13115 =back
13116
13117 =head2 Fcntl - load the C Fcntl.h defines
13118
13119 =over 4
13120
13121 =item SYNOPSIS
13122
13123 =item DESCRIPTION
13124
13125 =item NOTE
13126
13127 =item EXPORTED SYMBOLS
13128
13129 =back
13130
13131 =head2 File::Basename, fileparse - split a pathname into pieces
13132
13133 =over 4
13134
13135 =item SYNOPSIS
13136
13137 =item DESCRIPTION
13138
13139 fileparse_set_fstype, fileparse
13140
13141 =item EXAMPLES
13142
13143 C<basename>, C<dirname>
13144
13145 =back
13146
13147 =head2 File::CheckTree, validate - run many filetest checks on a tree
13148
13149 =over 4
13150
13151 =item SYNOPSIS
13152
13153 =item DESCRIPTION
13154
13155 =item AUTHOR
13156
13157 =item HISTORY
13158
13159 =back
13160
13161 =head2 File::Compare - Compare files or filehandles
13162
13163 =over 4
13164
13165 =item SYNOPSIS
13166
13167 =item DESCRIPTION
13168
13169 =item RETURN
13170
13171 =item AUTHOR
13172
13173 =back
13174
13175 =head2 File::Copy - Copy files or filehandles
13176
13177 =over 4
13178
13179 =item SYNOPSIS
13180
13181 =item DESCRIPTION
13182
13183 =over 4
13184
13185 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13186
13187 rmscopy($from,$to[,$date_flag])
13188
13189 =back
13190
13191 =item RETURN
13192
13193 =item NOTES
13194
13195 =item AUTHOR
13196
13197 =back
13198
13199 =head2 File::DosGlob - DOS like globbing and then some
13200
13201 =over 4
13202
13203 =item SYNOPSIS
13204
13205 =item DESCRIPTION
13206
13207 =item NOTES
13208
13209 =item EXPORTS (by request only)
13210
13211 =item BUGS
13212
13213 =item AUTHOR
13214
13215 =item HISTORY
13216
13217 =item SEE ALSO
13218
13219 =back
13220
13221 =head2 File::Find - Traverse a directory tree.
13222
13223 =over 4
13224
13225 =item SYNOPSIS
13226
13227 =item DESCRIPTION
13228
13229 B<find>, B<finddepth>
13230
13231 =over 4
13232
13233 =item %options
13234
13235 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13236 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13237 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13238
13239 =item The wanted function
13240
13241 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13242 filename within that directory, C<$File::Find::name> is the complete
13243 pathname to the file
13244
13245 =back
13246
13247 =item WARNINGS
13248
13249 =item CAVEAT
13250
13251 $dont_use_nlink, symlinks
13252
13253 =item NOTES
13254
13255 =item BUGS AND CAVEATS
13256
13257 =item HISTORY
13258
13259 =back
13260
13261 =head2 File::Glob - Perl extension for BSD glob routine
13262
13263 =over 4
13264
13265 =item SYNOPSIS
13266
13267 =item DESCRIPTION
13268
13269 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13270 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13271 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13272
13273 =item DIAGNOSTICS
13274
13275 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13276
13277 =item NOTES
13278
13279 =item AUTHOR
13280
13281 =back
13282
13283 =head2 File::Path - create or remove directory trees
13284
13285 =over 4
13286
13287 =item SYNOPSIS
13288
13289 =item DESCRIPTION
13290
13291 =item DIAGNOSTICS
13292
13293 =item AUTHORS
13294
13295 =back
13296
13297 =head2 File::Spec - portably perform operations on file names
13298
13299 =over 4
13300
13301 =item SYNOPSIS
13302
13303 =item DESCRIPTION
13304
13305 =item METHODS
13306
13307 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13308 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13309 splitdir, catpath(), abs2rel, rel2abs()
13310
13311 =item SEE ALSO
13312
13313 =item AUTHORS
13314
13315 =back
13316
13317 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13318
13319 =over 4
13320
13321 =item SYNOPSIS
13322
13323 =item DESCRIPTION
13324
13325 =back
13326
13327 canonpath
13328
13329 file_name_is_absolute
13330
13331 tmpdir (override)
13332
13333 =head2 File::Spec::Epoc - methods for Epoc file specs
13334
13335 =over 4
13336
13337 =item SYNOPSIS
13338
13339 =item DESCRIPTION
13340
13341 =item AUTHORS
13342
13343 =back
13344
13345 canonpath()
13346
13347 =over 4
13348
13349 =item SEE ALSO
13350
13351 =back
13352
13353 =head2 File::Spec::Functions - portably perform operations on file names
13354
13355 =over 4
13356
13357 =item SYNOPSIS
13358
13359 =item DESCRIPTION
13360
13361 =over 4
13362
13363 =item Exports
13364
13365 =back
13366
13367 =item SEE ALSO
13368
13369 =back
13370
13371 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13372
13373 =over 4
13374
13375 =item SYNOPSIS
13376
13377 =item DESCRIPTION
13378
13379 =item METHODS
13380
13381 canonpath
13382
13383 =back
13384
13385 catdir()
13386
13387 catfile
13388
13389 curdir
13390
13391 devnull
13392
13393 rootdir
13394
13395 tmpdir
13396
13397 updir
13398
13399 file_name_is_absolute
13400
13401 path
13402
13403 splitpath
13404
13405 splitdir
13406
13407 catpath
13408
13409 abs2rel
13410
13411 rel2abs
13412
13413 =over 4
13414
13415 =item AUTHORS
13416
13417 =item SEE ALSO
13418
13419 =back
13420
13421 =head2 File::Spec::OS2 - methods for OS/2 file specs
13422
13423 =over 4
13424
13425 =item SYNOPSIS
13426
13427 =item DESCRIPTION
13428
13429 tmpdir, splitpath
13430
13431 =back
13432
13433 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13434 modules
13435
13436 =over 4
13437
13438 =item SYNOPSIS
13439
13440 =item DESCRIPTION
13441
13442 =item METHODS
13443
13444 canonpath()
13445
13446 =back
13447
13448 catdir()
13449
13450 catfile
13451
13452 curdir
13453
13454 devnull
13455
13456 rootdir
13457
13458 tmpdir
13459
13460 updir
13461
13462 no_upwards
13463
13464 case_tolerant
13465
13466 file_name_is_absolute
13467
13468 path
13469
13470 join
13471
13472 splitpath
13473
13474 splitdir
13475
13476 catpath()
13477
13478 abs2rel
13479
13480 rel2abs()
13481
13482 =over 4
13483
13484 =item SEE ALSO
13485
13486 =back
13487
13488 =head2 File::Spec::VMS - methods for VMS file specs
13489
13490 =over 4
13491
13492 =item SYNOPSIS
13493
13494 =item DESCRIPTION
13495
13496 eliminate_macros
13497
13498 =back
13499
13500 fixpath
13501
13502 =over 4
13503
13504 =item Methods always loaded
13505
13506 canonpath (override)
13507
13508 =back
13509
13510 catdir
13511
13512 catfile
13513
13514 curdir (override)
13515
13516 devnull (override)
13517
13518 rootdir (override)
13519
13520 tmpdir (override)
13521
13522 updir (override)
13523
13524 case_tolerant (override)
13525
13526 path (override)
13527
13528 file_name_is_absolute (override)
13529
13530 splitpath (override)
13531
13532 splitdir (override)
13533
13534 catpath (override)
13535
13536 abs2rel (override)
13537
13538 rel2abs (override)
13539
13540 =over 4
13541
13542 =item SEE ALSO
13543
13544 =back
13545
13546 =head2 File::Spec::Win32 - methods for Win32 file specs
13547
13548 =over 4
13549
13550 =item SYNOPSIS
13551
13552 =item DESCRIPTION
13553
13554 devnull
13555
13556 =back
13557
13558 tmpdir
13559
13560 catfile
13561
13562 canonpath
13563
13564 splitpath
13565
13566 splitdir
13567
13568 catpath
13569
13570 =over 4
13571
13572 =item Note For File::Spec::Win32 Maintainers
13573
13574 =back
13575
13576 =over 4
13577
13578 =item SEE ALSO
13579
13580 =back
13581
13582 =head2 File::Temp - return name and handle of a temporary file safely
13583
13584 =over 4
13585
13586 =item PORTABILITY
13587
13588 =item SYNOPSIS
13589
13590 =item DESCRIPTION
13591
13592 =back
13593
13594 =over 4
13595
13596 =item OO INTERFACE
13597
13598 B<new>
13599
13600 =back
13601
13602 B<filename>
13603
13604 B<DESTROY>
13605
13606 =over 4
13607
13608 =item FUNCTIONS
13609
13610 B<tempfile>
13611
13612 =back
13613
13614 B<tempdir>
13615
13616 =over 4
13617
13618 =item MKTEMP FUNCTIONS
13619
13620 B<mkstemp>
13621
13622 =back
13623
13624 B<mkstemps>
13625
13626 B<mkdtemp>
13627
13628 B<mktemp>
13629
13630 =over 4
13631
13632 =item POSIX FUNCTIONS
13633
13634 B<tmpnam>
13635
13636 =back
13637
13638 B<tmpfile>
13639
13640 =over 4
13641
13642 =item ADDITIONAL FUNCTIONS
13643
13644 B<tempnam>
13645
13646 =back
13647
13648 =over 4
13649
13650 =item UTILITY FUNCTIONS
13651
13652 B<unlink0>
13653
13654 =back
13655
13656 B<cmpstat>
13657
13658 B<unlink1>
13659
13660 =over 4
13661
13662 =item PACKAGE VARIABLES
13663
13664 B<safe_level>, STANDARD, MEDIUM, HIGH
13665
13666 =back
13667
13668 TopSystemUID
13669
13670 =over 4
13671
13672 =item WARNING
13673
13674 =over 4
13675
13676 =item Temporary files and NFS
13677
13678 =back
13679
13680 =item HISTORY
13681
13682 =item SEE ALSO
13683
13684 =item AUTHOR
13685
13686 =back
13687
13688 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13689
13690 =over 4
13691
13692 =item SYNOPSIS
13693
13694 =item DESCRIPTION
13695
13696 =item BUGS
13697
13698 =item NOTE
13699
13700 =item AUTHOR
13701
13702 =back
13703
13704 =head2 FileCache - keep more files open than the system permits
13705
13706 =over 4
13707
13708 =item SYNOPSIS
13709
13710 =item DESCRIPTION
13711
13712 cacheout EXPR, cacheout MODE, EXPR
13713
13714 =item CAVEATS
13715
13716 =item BUGS
13717
13718 =item NOTES
13719
13720 =back
13721
13722 =head2 FileHandle - supply object methods for filehandles
13723
13724 =over 4
13725
13726 =item SYNOPSIS
13727
13728 =item DESCRIPTION
13729
13730 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13731
13732 =item SEE ALSO
13733
13734 =back
13735
13736 =head2 Filter::Simple - Simplified source filtering
13737
13738 =over 4
13739
13740 =item SYNOPSIS
13741
13742 =item DESCRIPTION
13743
13744 =over 4
13745
13746 =item The Problem
13747
13748 =item A Solution
13749
13750 =item Disabling or changing <no> behaviour
13751
13752 =item All-in-one interface
13753
13754 =item Filtering only specific components of source code
13755
13756 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13757 C<"all">
13758
13759 =item Filtering only the code parts of source code
13760
13761 Most source code ceases to be grammatically correct when it is broken up
13762 into the pieces between string literals and regexes. So the C<'code'>
13763 component filter behaves slightly differently from the other partial
13764 filters
13765 described in the previous section.
13766
13767 =item Using Filter::Simple with an explicit C<import> subroutine
13768
13769 =item Using Filter::Simple and Exporter together
13770
13771 =item How it works
13772
13773 =back
13774
13775 =item AUTHOR
13776
13777 =item COPYRIGHT
13778
13779 =back
13780
13781 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13782
13783 =over 4
13784
13785 =item SYNOPSIS
13786
13787 =item DESCRIPTION
13788
13789 =over 4
13790
13791 =item B<use Filter::Util::Call>
13792
13793 =item B<import()>
13794
13795 =item B<filter() and anonymous sub>
13796
13797 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13798
13799 =back
13800
13801 =item EXAMPLES
13802
13803 =over 4
13804
13805 =item Example 1: A simple filter.
13806
13807 =item Example 2: Using the context
13808
13809 =item Example 3: Using the context within the filter
13810
13811 =item Example 4: Using filter_del
13812
13813 =back
13814
13815 =item Filter::Simple
13816
13817 =item AUTHOR
13818
13819 =item DATE
13820
13821 =back
13822
13823 =head2 FindBin - Locate directory of original perl script
13824
13825 =over 4
13826
13827 =item SYNOPSIS
13828
13829 =item DESCRIPTION
13830
13831 =item EXPORTABLE VARIABLES
13832
13833 =item KNOWN ISSUES
13834
13835 =item KNOWN BUGS
13836
13837 =item AUTHORS
13838
13839 =item COPYRIGHT
13840
13841 =back
13842
13843 =head2 GDBM_File - Perl5 access to the gdbm library.
13844
13845 =over 4
13846
13847 =item SYNOPSIS
13848
13849 =item DESCRIPTION
13850
13851 =item AVAILABILITY
13852
13853 =item BUGS
13854
13855 =item SEE ALSO
13856
13857 =back
13858
13859 =head2 Getopt::Long - Extended processing of command line options
13860
13861 =over 4
13862
13863 =item SYNOPSIS
13864
13865 =item DESCRIPTION
13866
13867 =item Command Line Options, an Introduction
13868
13869 =item Getting Started with Getopt::Long
13870
13871 =over 4
13872
13873 =item Simple options
13874
13875 =item A little bit less simple options
13876
13877 =item Mixing command line option with other arguments
13878
13879 =item Options with values
13880
13881 =item Options with multiple values
13882
13883 =item Options with hash values
13884
13885 =item User-defined subroutines to handle options
13886
13887 =item Options with multiple names
13888
13889 =item Case and abbreviations
13890
13891 =item Summary of Option Specifications
13892
13893 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13894 + [ I<desttype> ]
13895
13896 =back
13897
13898 =item Advanced Possibilities
13899
13900 =over 4
13901
13902 =item Object oriented interface
13903
13904 =item Thread Safety
13905
13906 =item Documentation and help texts
13907
13908 =item Storing options in a hash
13909
13910 =item Bundling
13911
13912 =item The lonesome dash
13913
13914 =item Argument callback
13915
13916 =back
13917
13918 =item Configuring Getopt::Long
13919
13920 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13921 require_order, permute, bundling (default: disabled), bundling_override
13922 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13923 (default: disabled), auto_version (default:disabled), auto_help
13924 (default:disabled), pass_through (default: disabled), prefix,
13925 prefix_pattern, debug (default: disabled)
13926
13927 =item Exportable Methods
13928
13929 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
13930
13931 =item Return values and Errors
13932
13933 =item Legacy
13934
13935 =over 4
13936
13937 =item Default destinations
13938
13939 =item Alternative option starters
13940
13941 =item Configuration variables
13942
13943 =back
13944
13945 =item Trouble Shooting
13946
13947 =over 4
13948
13949 =item GetOptions does not return a false result when an option is not
13950 supplied
13951
13952 =item GetOptions does not split the command line correctly
13953
13954 =item Undefined subroutine &main::GetOptions called
13955
13956 =item How do I put a "-?" option into a Getopt::Long?
13957
13958 =back
13959
13960 =item AUTHOR
13961
13962 =item COPYRIGHT AND DISCLAIMER
13963
13964 =back
13965
13966 =head2 Getopt::Std, getopt, getopts - Process single-character switches
13967 with switch clustering
13968
13969 =over 4
13970
13971 =item SYNOPSIS
13972
13973 =item DESCRIPTION
13974
13975 =item C<--help> and C<--version>
13976
13977 =back
13978
13979 =head2 Hash::Util - A selection of general-utility hash subroutines
13980
13981 =over 4
13982
13983 =item SYNOPSIS
13984
13985 =item DESCRIPTION
13986
13987 =over 4
13988
13989 =item Restricted hashes
13990
13991 lock_keys, unlock_keys
13992
13993 =back
13994
13995 =back
13996
13997 lock_value, unlock_value
13998
13999 B<lock_hash>, B<unlock_hash>
14000
14001 B<hash_seed>
14002
14003 =over 4
14004
14005 =item CAVEATS
14006
14007 =item AUTHOR
14008
14009 =item SEE ALSO
14010
14011 =back
14012
14013 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14014 locale
14015
14016 =over 4
14017
14018 =item SYNOPSIS
14019
14020 =item DESCRIPTION
14021
14022 =back
14023
14024 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14025 tags
14026
14027 =over 4
14028
14029 =item SYNOPSIS
14030
14031 =item DESCRIPTION
14032
14033 =back
14034
14035 the function is_language_tag($lang1)
14036
14037 the function extract_language_tags($whatever)
14038
14039 the function same_language_tag($lang1, $lang2)
14040
14041 the function similarity_language_tag($lang1, $lang2)
14042
14043 the function is_dialect_of($lang1, $lang2)
14044
14045 the function super_languages($lang1)
14046
14047 the function locale2language_tag($locale_identifier)
14048
14049 the function encode_language_tag($lang1)
14050
14051 the function alternate_language_tags($lang1)
14052
14053 the function @langs = panic_languages(@accept_languages)
14054
14055 =over 4
14056
14057 =item ABOUT LOWERCASING
14058
14059 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14060
14061 =item SEE ALSO
14062
14063 =item COPYRIGHT
14064
14065 =item AUTHOR
14066
14067 =back
14068
14069 =head2 I18N::LangTags::List -- tags and names for human languages
14070
14071 =over 4
14072
14073 =item SYNOPSIS
14074
14075 =item DESCRIPTION
14076
14077 =item ABOUT LANGUAGE TAGS
14078
14079 =item LIST OF LANGUAGES
14080
14081 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
14082 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
14083 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
14084 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
14085 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
14086 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
14087 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
14088 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
14089 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
14090 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
14091 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
14092 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
14093 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
14094 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
14095 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
14096 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
14097 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
14098 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
14099 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
14100 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
14101 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
14102 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
14103 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
14104 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
14105 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
14106 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
14107 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
14108 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
14109 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
14110 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
14111 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
14112 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
14113 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
14114 English, {enm} : Old English (1100-1500), {ang} : Old English
14115 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
14116 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
14117 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
14118 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
14119 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
14120 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
14121 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
14122 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
14123 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
14124 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
14125 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
14126 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
14127 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14128 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14129 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
14130 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
14131 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
14132 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
14133 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
14134 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
14135 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
14136 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
14137 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
14138 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
14139 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
14140 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
14141 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
14142 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
14143 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
14144 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
14145 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
14146 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
14147 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
14148 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
14149 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
14150 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
14151 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
14152 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
14153 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
14154 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
14155 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
14156 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
14157 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
14158 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
14159 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
14160 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
14161 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14162 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14163 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
14164 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
14165 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
14166 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
14167 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14168 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14169 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14170 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14171 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14172 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14173 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14174 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14175 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14176 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14177 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
14178 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
14179 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
14180 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
14181 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
14182 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
14183 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
14184 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
14185 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
14186 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
14187 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
14188 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
14189 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
14190 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
14191 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
14192 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
14193 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
14194 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
14195 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
14196 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
14197 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
14198 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
14199 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
14200 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
14201 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
14202 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
14203 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
14204 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
14205 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
14206 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
14207 {zun} : Zuni
14208
14209 =item SEE ALSO
14210
14211 =item COPYRIGHT AND DISCLAIMER
14212
14213 =item AUTHOR
14214
14215 =back
14216
14217 =head2 I18N::Langinfo - query locale information
14218
14219 =over 4
14220
14221 =item SYNOPSIS
14222
14223 =item DESCRIPTION
14224
14225 =over 4
14226
14227 =item EXPORT
14228
14229 =back
14230
14231 =item SEE ALSO
14232
14233 =item AUTHOR
14234
14235 =item COPYRIGHT AND LICENSE
14236
14237 =back
14238
14239 =head2 IO - load various IO modules
14240
14241 =over 4
14242
14243 =item SYNOPSIS
14244
14245 =item DESCRIPTION
14246
14247 =item DEPRECATED
14248
14249 =back
14250
14251 =head2 IO::Dir - supply object methods for directory handles
14252
14253 =over 4
14254
14255 =item SYNOPSIS
14256
14257 =item DESCRIPTION
14258
14259 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14260 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
14261
14262 =item SEE ALSO
14263
14264 =item AUTHOR
14265
14266 =item COPYRIGHT
14267
14268 =back
14269
14270 =head2 IO::File - supply object methods for filehandles
14271
14272 =over 4
14273
14274 =item SYNOPSIS
14275
14276 =item DESCRIPTION
14277
14278 =item CONSTRUCTOR
14279
14280 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14281
14282 =item METHODS
14283
14284 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
14285
14286 =item SEE ALSO
14287
14288 =item HISTORY
14289
14290 =back
14291
14292 =head2 IO::Handle - supply object methods for I/O handles
14293
14294 =over 4
14295
14296 =item SYNOPSIS
14297
14298 =item DESCRIPTION
14299
14300 =item CONSTRUCTOR
14301
14302 new (), new_from_fd ( FD, MODE )
14303
14304 =item METHODS
14305
14306 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14307 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14308 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14309 $io->blocking ( [ BOOL ] ), $io->untaint
14310
14311 =item NOTE
14312
14313 =item SEE ALSO
14314
14315 =item BUGS
14316
14317 =item HISTORY
14318
14319 =back
14320
14321 =head2 IO::Pipe - supply object methods for pipes
14322
14323 =over 4
14324
14325 =item SYNOPSIS
14326
14327 =item DESCRIPTION
14328
14329 =item CONSTRUCTOR
14330
14331 new ( [READER, WRITER] )
14332
14333 =item METHODS
14334
14335 reader ([ARGS]), writer ([ARGS]), handles ()
14336
14337 =item SEE ALSO
14338
14339 =item AUTHOR
14340
14341 =item COPYRIGHT
14342
14343 =back
14344
14345 =head2 IO::Poll - Object interface to system poll call
14346
14347 =over 4
14348
14349 =item SYNOPSIS
14350
14351 =item DESCRIPTION
14352
14353 =item METHODS
14354
14355 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14356 IO ), handles( [ EVENT_MASK ] )
14357
14358 =item SEE ALSO
14359
14360 =item AUTHOR
14361
14362 =item COPYRIGHT
14363
14364 =back
14365
14366 =head2 IO::Seekable - supply seek based methods for I/O objects
14367
14368 =over 4
14369
14370 =item SYNOPSIS
14371
14372 =item DESCRIPTION
14373
14374 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14375 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14376 $io->tell
14377
14378 =item SEE ALSO
14379
14380 =item HISTORY
14381
14382 =back
14383
14384 =head2 IO::Select - OO interface to the select system call
14385
14386 =over 4
14387
14388 =item SYNOPSIS
14389
14390 =item DESCRIPTION
14391
14392 =item CONSTRUCTOR
14393
14394 new ( [ HANDLES ] )
14395
14396 =item METHODS
14397
14398 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14399 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14400 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
14401
14402 =item EXAMPLE
14403
14404 =item AUTHOR
14405
14406 =item COPYRIGHT
14407
14408 =back
14409
14410 =head2 IO::Socket - Object interface to socket communications
14411
14412 =over 4
14413
14414 =item SYNOPSIS
14415
14416 =item DESCRIPTION
14417
14418 =item CONSTRUCTOR
14419
14420 new ( [ARGS] )
14421
14422 =item METHODS
14423
14424 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14425 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14426
14427 =item SEE ALSO
14428
14429 =item AUTHOR
14430
14431 =item COPYRIGHT
14432
14433 =back
14434
14435 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14436
14437 =over 4
14438
14439 =item SYNOPSIS
14440
14441 =item DESCRIPTION
14442
14443 =item CONSTRUCTOR
14444
14445 new ( [ARGS] )
14446
14447 =over 4
14448
14449 =item METHODS
14450
14451 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14452 ()
14453
14454 =back
14455
14456 =item SEE ALSO
14457
14458 =item AUTHOR
14459
14460 =item COPYRIGHT
14461
14462 =back
14463
14464 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14465
14466 =over 4
14467
14468 =item SYNOPSIS
14469
14470 =item DESCRIPTION
14471
14472 =item CONSTRUCTOR
14473
14474 new ( [ARGS] )
14475
14476 =item METHODS
14477
14478 hostpath(), peerpath()
14479
14480 =item SEE ALSO
14481
14482 =item AUTHOR
14483
14484 =item COPYRIGHT
14485
14486 =back
14487
14488 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14489 handles
14490
14491 =over 4
14492
14493 =item SYNOPSIS
14494
14495 =item DESCRIPTION
14496
14497 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14498 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
14499
14500 =item SEE ALSO
14501
14502 =item AUTHOR
14503
14504 =item COPYRIGHT
14505
14506 =back
14507
14508 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14509
14510 =over 4
14511
14512 =item SYNOPSIS
14513
14514 =item DESCRIPTION
14515
14516 =item CONSTRUCTOR
14517
14518 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14519
14520 =item METHODS
14521
14522 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
14523
14524 =item SEE ALSO
14525
14526 =item HISTORY
14527
14528 =back
14529
14530 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14531 handles
14532
14533 =over 4
14534
14535 =item SYNOPSIS
14536
14537 =item DESCRIPTION
14538
14539 =item CONSTRUCTOR
14540
14541 new (), new_from_fd ( FD, MODE )
14542
14543 =item METHODS
14544
14545 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14546 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14547 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14548 $io->blocking ( [ BOOL ] ), $io->untaint
14549
14550 =item NOTE
14551
14552 =item SEE ALSO
14553
14554 =item BUGS
14555
14556 =item HISTORY
14557
14558 =back
14559
14560 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14561
14562 =over 4
14563
14564 =item SYNOPSIS
14565
14566 =item DESCRIPTION
14567
14568 =item CONSTRUCTOR
14569
14570 new ( [READER, WRITER] )
14571
14572 =item METHODS
14573
14574 reader ([ARGS]), writer ([ARGS]), handles ()
14575
14576 =item SEE ALSO
14577
14578 =item AUTHOR
14579
14580 =item COPYRIGHT
14581
14582 =back
14583
14584 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14585
14586 =over 4
14587
14588 =item SYNOPSIS
14589
14590 =item DESCRIPTION
14591
14592 =item METHODS
14593
14594 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14595 IO ), handles( [ EVENT_MASK ] )
14596
14597 =item SEE ALSO
14598
14599 =item AUTHOR
14600
14601 =item COPYRIGHT
14602
14603 =back
14604
14605 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14606 I/O objects
14607
14608 =over 4
14609
14610 =item SYNOPSIS
14611
14612 =item DESCRIPTION
14613
14614 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14615 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14616 $io->tell
14617
14618 =item SEE ALSO
14619
14620 =item HISTORY
14621
14622 =back
14623
14624 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14625 call
14626
14627 =over 4
14628
14629 =item SYNOPSIS
14630
14631 =item DESCRIPTION
14632
14633 =item CONSTRUCTOR
14634
14635 new ( [ HANDLES ] )
14636
14637 =item METHODS
14638
14639 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14640 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14641 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
14642
14643 =item EXAMPLE
14644
14645 =item AUTHOR
14646
14647 =item COPYRIGHT
14648
14649 =back
14650
14651 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14652 communications
14653
14654 =over 4
14655
14656 =item SYNOPSIS
14657
14658 =item DESCRIPTION
14659
14660 =item CONSTRUCTOR
14661
14662 new ( [ARGS] )
14663
14664 =item METHODS
14665
14666 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14667 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14668
14669 =item SEE ALSO
14670
14671 =item AUTHOR
14672
14673 =item COPYRIGHT
14674
14675 =back
14676
14677 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14678 AF_INET domain sockets
14679
14680 =over 4
14681
14682 =item SYNOPSIS
14683
14684 =item DESCRIPTION
14685
14686 =item CONSTRUCTOR
14687
14688 new ( [ARGS] )
14689
14690 =over 4
14691
14692 =item METHODS
14693
14694 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14695 ()
14696
14697 =back
14698
14699 =item SEE ALSO
14700
14701 =item AUTHOR
14702
14703 =item COPYRIGHT
14704
14705 =back
14706
14707 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14708 AF_UNIX domain sockets
14709
14710 =over 4
14711
14712 =item SYNOPSIS
14713
14714 =item DESCRIPTION
14715
14716 =item CONSTRUCTOR
14717
14718 new ( [ARGS] )
14719
14720 =item METHODS
14721
14722 hostpath(), peerpath()
14723
14724 =item SEE ALSO
14725
14726 =item AUTHOR
14727
14728 =item COPYRIGHT
14729
14730 =back
14731
14732 =head2 IPC::Msg - SysV Msg IPC object class
14733
14734 =over 4
14735
14736 =item SYNOPSIS
14737
14738 =item DESCRIPTION
14739
14740 =item METHODS
14741
14742 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14743 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14744 FLAGS ] ), stat
14745
14746 =item SEE ALSO
14747
14748 =item AUTHOR
14749
14750 =item COPYRIGHT
14751
14752 =back
14753
14754 =head2 IPC::Open2, open2 - open a process for both reading and writing
14755
14756 =over 4
14757
14758 =item SYNOPSIS
14759
14760 =item DESCRIPTION
14761
14762 =item WARNING 
14763
14764 =item SEE ALSO
14765
14766 =back
14767
14768 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14769 handling
14770
14771 =over 4
14772
14773 =item SYNOPSIS
14774
14775 =item DESCRIPTION
14776
14777 =item WARNING
14778
14779 =back
14780
14781 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14782
14783 =over 4
14784
14785 =item SYNOPSIS
14786
14787 =item DESCRIPTION
14788
14789 =item METHODS
14790
14791 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14792 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14793 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14794 , VALUE ), stat
14795
14796 =item SEE ALSO
14797
14798 =item AUTHOR
14799
14800 =item COPYRIGHT
14801
14802 =back
14803
14804 =head2 IPC::SysV - SysV IPC constants
14805
14806 =over 4
14807
14808 =item SYNOPSIS
14809
14810 =item DESCRIPTION
14811
14812 ftok( PATH, ID )
14813
14814 =item SEE ALSO
14815
14816 =item AUTHORS
14817
14818 =item COPYRIGHT
14819
14820 =back
14821
14822 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14823
14824 =over 4
14825
14826 =item SYNOPSIS
14827
14828 =item DESCRIPTION
14829
14830 =item METHODS
14831
14832 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14833 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14834 FLAGS ] ), stat
14835
14836 =item SEE ALSO
14837
14838 =item AUTHOR
14839
14840 =item COPYRIGHT
14841
14842 =back
14843
14844 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14845 class
14846
14847 =over 4
14848
14849 =item SYNOPSIS
14850
14851 =item DESCRIPTION
14852
14853 =item METHODS
14854
14855 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14856 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14857 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14858 , VALUE ), stat
14859
14860 =item SEE ALSO
14861
14862 =item AUTHOR
14863
14864 =item COPYRIGHT
14865
14866 =back
14867
14868 =head2 List::Util - A selection of general-utility list subroutines
14869
14870 =over 4
14871
14872 =item SYNOPSIS
14873
14874 =item DESCRIPTION
14875
14876 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14877 BLOCK LIST, shuffle LIST, sum LIST
14878
14879 =item KNOWN BUGS
14880
14881 =item SUGGESTED ADDITIONS
14882
14883 =item COPYRIGHT
14884
14885 =back
14886
14887 =head2 List::Utilib::List::Util, List::Util - A selection of
14888 general-utility list subroutines
14889
14890 =over 4
14891
14892 =item SYNOPSIS
14893
14894 =item DESCRIPTION
14895
14896 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14897 BLOCK LIST, shuffle LIST, sum LIST
14898
14899 =item KNOWN BUGS
14900
14901 =item SUGGESTED ADDITIONS
14902
14903 =item COPYRIGHT
14904
14905 =back
14906
14907 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14908 general-utility scalar subroutines
14909
14910 =over 4
14911
14912 =item SYNOPSIS
14913
14914 =item DESCRIPTION
14915
14916 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
14917 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
14918 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
14919
14920 =item KNOWN BUGS
14921
14922 =item COPYRIGHT
14923
14924 =item BLATANT PLUG
14925
14926 =back
14927
14928 =head2 Locale::Constants - constants for Locale codes
14929
14930 =over 4
14931
14932 =item SYNOPSIS
14933
14934 =item DESCRIPTION
14935
14936 =item KNOWN BUGS AND LIMITATIONS
14937
14938 =item SEE ALSO
14939
14940 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14941
14942 =item AUTHOR
14943
14944 =item COPYRIGHT
14945
14946 =back
14947
14948 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14949
14950 =over 4
14951
14952 =item SYNOPSIS
14953
14954 =item DESCRIPTION
14955
14956 B<alpha-2>, B<alpha-3>, B<numeric>
14957
14958 =item CONVERSION ROUTINES
14959
14960 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14961 country_code2code( CODE, CODESET, CODESET )
14962
14963 =item QUERY ROUTINES
14964
14965 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14966
14967 =item SEMI-PRIVATE ROUTINES
14968
14969 =over 4
14970
14971 =item alias_code
14972
14973 =item rename_country
14974
14975 =back
14976
14977 =item EXAMPLES
14978
14979 =item DOMAIN NAMES
14980
14981 =item KNOWN BUGS AND LIMITATIONS
14982
14983 =item SEE ALSO
14984
14985 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14986 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14987 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14988 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
14989
14990 =item AUTHOR
14991
14992 =item COPYRIGHT
14993
14994 =back
14995
14996 =head2 Locale::Currency - ISO three letter codes for currency
14997 identification (ISO 4217)
14998
14999 =over 4
15000
15001 =item SYNOPSIS
15002
15003 =item DESCRIPTION
15004
15005 XTS, XXX
15006
15007 =item CONVERSION ROUTINES
15008
15009 code2currency(), currency2code()
15010
15011 =item QUERY ROUTINES
15012
15013 C<all_currency_codes()>, C<all_currency_names()>
15014
15015 =item EXAMPLES
15016
15017 =item KNOWN BUGS AND LIMITATIONS
15018
15019 =item SEE ALSO
15020
15021 Locale::Country, Locale::Script, ISO 4217:1995,
15022 http://www.bsi-global.com/iso4217currency
15023
15024 =item AUTHOR
15025
15026 =item COPYRIGHT
15027
15028 =back
15029
15030 =head2 Locale::Language - ISO two letter codes for language identification
15031 (ISO 639)
15032
15033 =over 4
15034
15035 =item SYNOPSIS
15036
15037 =item DESCRIPTION
15038
15039 =item CONVERSION ROUTINES
15040
15041 code2language(), language2code()
15042
15043 =item QUERY ROUTINES
15044
15045 C<all_language_codes()>, C<all_language_names()>
15046
15047 =item EXAMPLES
15048
15049 =item KNOWN BUGS AND LIMITATIONS
15050
15051 =item SEE ALSO
15052
15053 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15054 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15055
15056 =item AUTHOR
15057
15058 =item COPYRIGHT
15059
15060 =back
15061
15062 =head2 Locale::Maketext - framework for localization
15063
15064 =over 4
15065
15066 =item SYNOPSIS
15067
15068 =item DESCRIPTION
15069
15070 =item QUICK OVERVIEW
15071
15072 =item METHODS
15073
15074 =over 4
15075
15076 =item Construction Methods
15077
15078 =item The "maketext" Method
15079
15080 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15081
15082 =item Utility Methods
15083
15084 $language->quant($number, $singular), $language->quant($number, $singular,
15085 $plural), $language->quant($number, $singular, $plural, $negative),
15086 $language->numf($number), $language->sprintf($format, @items),
15087 $language->language_tag(), $language->encoding()
15088
15089 =item Language Handle Attributes and Internals
15090
15091 =back
15092
15093 =item LANGUAGE CLASS HIERARCHIES
15094
15095 =item ENTRIES IN EACH LEXICON
15096
15097 =item BRACKET NOTATION
15098
15099 =item AUTO LEXICONS
15100
15101 =item CONTROLLING LOOKUP FAILURE
15102
15103 =item HOW TO USE MAKETEXT
15104
15105 =item SEE ALSO
15106
15107 =item COPYRIGHT AND DISCLAIMER
15108
15109 =item AUTHOR
15110
15111 =back
15112
15113 =head2 Locale::Maketext::TPJ13 -- article about software localization
15114
15115 =over 4
15116
15117 =item SYNOPSIS
15118
15119 =item DESCRIPTION
15120
15121 =item Localization and Perl: gettext breaks, Maketext fixes
15122
15123 =over 4
15124
15125 =item A Localization Horror Story: It Could Happen To You
15126
15127 =item The Linguistic View
15128
15129 =item Breaking gettext
15130
15131 =item Replacing gettext
15132
15133 =item Buzzwords: Abstraction and Encapsulation
15134
15135 =item Buzzword: Isomorphism
15136
15137 =item Buzzword: Inheritance
15138
15139 =item Buzzword: Concision
15140
15141 =item The Devil in the Details
15142
15143 =item The Proof in the Pudding: Localizing Web Sites
15144
15145 =item References
15146
15147 =back
15148
15149 =back
15150
15151 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15152
15153 =over 4
15154
15155 =item SYNOPSIS
15156
15157 =item DESCRIPTION
15158
15159 B<alpha-2>, B<alpha-3>, B<numeric>
15160
15161 =over 4
15162
15163 =item SPECIAL CODES
15164
15165 =back
15166
15167 =item CONVERSION ROUTINES
15168
15169 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15170 script_code2code( CODE, CODESET, CODESET )
15171
15172 =item QUERY ROUTINES
15173
15174 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15175
15176 =item EXAMPLES
15177
15178 =item KNOWN BUGS AND LIMITATIONS
15179
15180 =item SEE ALSO
15181
15182 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15183 http://www.evertype.com/standards/iso15924/
15184
15185 =item AUTHOR
15186
15187 =item COPYRIGHT
15188
15189 =back
15190
15191 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15192
15193 =over 4
15194
15195 =item SYNOPSIS
15196
15197 =item DESCRIPTION
15198
15199 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
15200
15201 =item DIAGNOSTICS
15202
15203 Premature end of base64 data, Premature padding of base64 data
15204
15205 =item EXAMPLES
15206
15207 =item COPYRIGHT
15208
15209 =item SEE ALSO
15210
15211 =back
15212
15213 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15214 of quoted-printable strings
15215
15216 =over 4
15217
15218 =item SYNOPSIS
15219
15220 =item DESCRIPTION
15221
15222 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
15223
15224 =item COPYRIGHT
15225
15226 =item SEE ALSO
15227
15228 =back
15229
15230 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15231 strings
15232
15233 =over 4
15234
15235 =item SYNOPSIS
15236
15237 =item DESCRIPTION
15238
15239 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
15240
15241 =item COPYRIGHT
15242
15243 =item SEE ALSO
15244
15245 =back
15246
15247 =head2 Math::BigFloat - Arbitrary size floating point math package
15248
15249 =over 4
15250
15251 =item SYNOPSIS
15252
15253 =item DESCRIPTION
15254
15255 =over 4
15256
15257 =item Canonical notation
15258
15259 =item Output
15260
15261 =item C<mantissa()>, C<exponent()> and C<parts()>
15262
15263 =item Accuracy vs. Precision
15264
15265 =item Rounding
15266
15267 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15268 ), fround  ( -$scale ) and fround ( 0 )
15269
15270 =back
15271
15272 =item EXAMPLES
15273
15274   # not ready yet
15275
15276 =item Autocreating constants
15277
15278 =over 4
15279
15280 =item Math library
15281
15282 =item Using Math::BigInt::Lite
15283
15284 =back
15285
15286 =item BUGS
15287
15288 =item CAVEATS
15289
15290 stringify, bstr(), bdiv, Modifying and =, bpow
15291
15292 =item SEE ALSO
15293
15294 =item LICENSE
15295
15296 =item AUTHORS
15297
15298 =back
15299
15300 =head2 Math::BigInt - Arbitrary size integer math package
15301
15302 =over 4
15303
15304 =item SYNOPSIS
15305
15306 =item DESCRIPTION
15307
15308 Input, Output
15309
15310 =item METHODS
15311
15312 =over 4
15313
15314 =item config
15315
15316 =item accuracy
15317
15318 =item precision
15319
15320 =item brsft
15321
15322 =item new
15323
15324 =item bnan
15325
15326 =item bzero
15327
15328 =item binf
15329
15330 =item bone
15331
15332 =item is_one()/is_zero()/is_nan()/is_inf()
15333
15334 =item is_pos()/is_neg()
15335
15336         $x->is_pos();                   # true if >= 0
15337         $x->is_neg();                   # true if <  0
15338
15339 =item is_odd()/is_even()/is_int()
15340
15341 =item bcmp
15342
15343 =item bacmp
15344
15345 =item sign
15346
15347 =item digit
15348
15349 =item bneg
15350
15351 =item babs
15352
15353 =item bnorm
15354
15355 =item bnot
15356
15357 =item binc
15358
15359 =item bdec
15360
15361 =item badd
15362
15363 =item bsub
15364
15365 =item bmul
15366
15367 =item bdiv
15368
15369 =item bmod
15370
15371 =item bmodinv
15372
15373 =item bmodpow
15374
15375 =item bpow
15376
15377 =item blsft
15378
15379 =item brsft
15380
15381 =item band
15382
15383 =item bior
15384
15385 =item bxor
15386
15387 =item bnot
15388
15389 =item bsqrt
15390
15391 =item bfac
15392
15393 =item round
15394
15395 =item bround
15396
15397 =item bfround
15398
15399 =item bfloor
15400
15401 =item bceil
15402
15403 =item bgcd
15404
15405 =item blcm
15406
15407 =item exponent
15408
15409 =item mantissa
15410
15411 =item parts
15412
15413 =item copy
15414
15415 =item as_int
15416
15417 =item bsstr
15418
15419 =item as_hex
15420
15421 =item as_bin
15422
15423 =back
15424
15425 =item ACCURACY and PRECISION
15426
15427 =over 4
15428
15429 =item Precision P
15430
15431 =item Accuracy A
15432
15433 =item Fallback F
15434
15435 =item Rounding mode R
15436
15437 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15438 (significant digits), Setting/Accessing, Creating numbers, Usage,
15439 Precedence, Overriding globals, Local settings, Rounding, Default values,
15440 Remarks
15441
15442 =back
15443
15444 =item INTERNALS
15445
15446 =over 4
15447
15448 =item MATH LIBRARY
15449
15450 =item SIGN
15451
15452 =item mantissa(), exponent() and parts()
15453
15454 =back
15455
15456 =item EXAMPLES
15457
15458   use Math::BigInt;
15459
15460 =item Autocreating constants
15461
15462 =item PERFORMANCE
15463
15464 =over 4
15465
15466 =item Alternative math libraries
15467
15468 =item SUBCLASSING
15469
15470 =back
15471
15472 =item Subclassing Math::BigInt
15473
15474 =item UPGRADING
15475
15476 =over 4
15477
15478 =item Auto-upgrade
15479
15480 bsqrt(), div(), blog()
15481
15482 =back
15483
15484 =item BUGS
15485
15486 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
15487 5.6.0
15488
15489 =item CAVEATS
15490
15491 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
15492 Modifying and =, bpow, Overloading -$x, Mixing different object types,
15493 bsqrt(), brsft()
15494
15495 =item LICENSE
15496
15497 =item SEE ALSO
15498
15499 =item AUTHORS
15500
15501 =back
15502
15503 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15504
15505 =over 4
15506
15507 =item SYNOPSIS
15508
15509 =item DESCRIPTION
15510
15511 =item STORAGE
15512
15513 =item METHODS
15514
15515 =item WRAP YOUR OWN
15516
15517 =item LICENSE
15518
15519 This program is free software; you may redistribute it and/or modify it
15520 under
15521 the same terms as Perl itself. 
15522
15523 =item AUTHORS
15524
15525 =item SEE ALSO
15526
15527 =back
15528
15529 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
15530
15531 =over 4
15532
15533 =item SYNOPSIS
15534
15535 =item DESCRIPTION
15536
15537 =item METHODS
15538
15539 =item LICENSE
15540
15541 This program is free software; you may redistribute it and/or modify it
15542 under
15543 the same terms as Perl itself. 
15544
15545 =item AUTHORS
15546
15547 =item SEE ALSO
15548
15549 =back
15550
15551 =head2 Math::BigRat - arbitrarily big rational numbers
15552
15553 =over 4
15554
15555 =item SYNOPSIS
15556
15557 =item DESCRIPTION
15558
15559 =over 4
15560
15561 =item MATH LIBRARY
15562
15563 =back
15564
15565 =item METHODS
15566
15567 =over 4
15568
15569 =item new()
15570
15571 =item numerator()
15572
15573 =item denominator()
15574
15575         $d = $x->denominator();
15576
15577 =item parts()
15578
15579 =item as_number()
15580
15581 =item bfac()
15582
15583 =item blog()
15584
15585 =item bround()/round()/bfround()
15586
15587 =item bmod()
15588
15589 =item is_one()
15590
15591 =item is_zero()
15592
15593 =item is_positive()
15594
15595 =item is_negative()
15596
15597 =item is_int()
15598
15599 =item is_odd()
15600
15601 =item is_even()
15602
15603 =item bceil()
15604
15605 =item bfloor()
15606
15607         $x->bfloor();
15608
15609 =item bsqrt()
15610
15611         $x->bsqrt();
15612
15613 =item config
15614
15615 =back
15616
15617 =item BUGS
15618
15619 inf handling (partial), NaN handling (partial), rounding (not implemented
15620 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
15621 blog(), bmodinv() and bmodpow() (partial)
15622
15623 =item LICENSE
15624
15625 =item SEE ALSO
15626
15627 =item AUTHORS
15628
15629 =back
15630
15631 =head2 Math::Complex - complex numbers and associated mathematical
15632 functions
15633
15634 =over 4
15635
15636 =item SYNOPSIS
15637
15638 =item DESCRIPTION
15639
15640 =item OPERATIONS
15641
15642 =item CREATION
15643
15644 =item STRINGIFICATION
15645
15646 =over 4
15647
15648 =item CHANGED IN PERL 5.6
15649
15650 =back
15651
15652 =item USAGE
15653
15654 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15655
15656 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15657
15658 =item BUGS
15659
15660 =item AUTHORS
15661
15662 =back
15663
15664 =head2 Math::Trig - trigonometric functions
15665
15666 =over 4
15667
15668 =item SYNOPSIS
15669
15670 =item DESCRIPTION
15671
15672 =item TRIGONOMETRIC FUNCTIONS
15673
15674 B<tan>
15675
15676 =over 4
15677
15678 =item ERRORS DUE TO DIVISION BY ZERO
15679
15680 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15681
15682 =back
15683
15684 =item PLANE ANGLE CONVERSIONS
15685
15686 =item RADIAL COORDINATE CONVERSIONS
15687
15688 =over 4
15689
15690 =item COORDINATE SYSTEMS
15691
15692 =item 3-D ANGLE CONVERSIONS
15693
15694 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15695 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15696
15697 =back
15698
15699 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15700
15701 =item EXAMPLES
15702
15703 =over 4
15704
15705 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15706
15707 =back
15708
15709 =item BUGS
15710
15711 =item AUTHORS
15712
15713 =back
15714
15715 =head2 Memoize - Make functions faster by trading space for time
15716
15717 =over 4
15718
15719 =item SYNOPSIS
15720
15721 =item DESCRIPTION
15722
15723 =item DETAILS
15724
15725 =item OPTIONS
15726
15727 =over 4
15728
15729 =item INSTALL
15730
15731 =item NORMALIZER
15732
15733 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15734
15735 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15736
15737 =back
15738
15739 =item OTHER FACILITIES
15740
15741 =over 4
15742
15743 =item C<unmemoize>
15744
15745 =item C<flush_cache>
15746
15747 =back
15748
15749 =item CAVEATS
15750
15751 =item PERSISTENT CACHE SUPPORT
15752
15753 =item EXPIRATION SUPPORT
15754
15755 =item BUGS
15756
15757 =item MAILING LIST
15758
15759 =item AUTHOR
15760
15761 =item COPYRIGHT AND LICENSE
15762
15763 =item THANK YOU
15764
15765 =back
15766
15767 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15768 Storable use
15769
15770 =over 4
15771
15772 =item DESCRIPTION
15773
15774 =back
15775
15776 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15777 memoized values
15778
15779 =over 4
15780
15781 =item SYNOPSIS
15782
15783 =item DESCRIPTION
15784
15785 =item INTERFACE
15786
15787  TIEHASH,  EXISTS,  STORE
15788
15789 =item ALTERNATIVES
15790
15791 =item CAVEATS
15792
15793 =item AUTHOR
15794
15795 =item SEE ALSO
15796
15797 =back
15798
15799 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15800
15801 =over 4
15802
15803 =item DESCRIPTION
15804
15805 =back
15806
15807 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15808
15809 =over 4
15810
15811 =item DESCRIPTION
15812
15813 =back
15814
15815 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15816 Storable use
15817
15818 =over 4
15819
15820 =item DESCRIPTION
15821
15822 =back
15823
15824 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15825 Storable use
15826
15827 =over 4
15828
15829 =item DESCRIPTION
15830
15831 =back
15832
15833 =head2 Memoize::Storable - store Memoized data in Storable database
15834
15835 =over 4
15836
15837 =item DESCRIPTION
15838
15839 =back
15840
15841 =head2 NDBM_File - Tied access to ndbm files
15842
15843 =over 4
15844
15845 =item SYNOPSIS
15846
15847 =item DESCRIPTION
15848
15849 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15850
15851 =item DIAGNOSTICS
15852
15853 =over 4
15854
15855 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15856
15857 =back
15858
15859 =item BUGS AND WARNINGS
15860
15861 =back
15862
15863 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
15864 redispatch
15865
15866 =over 4
15867
15868 =item SYNOPSIS
15869
15870 =item DESCRIPTION
15871
15872 =over 4
15873
15874 =item Enforcing redispatch
15875
15876 =item Avoiding repetitions
15877
15878 =item Invoking all versions of a method with a single call
15879
15880 =item Using C<EVERY> methods
15881
15882 =back
15883
15884 =item AUTHOR
15885
15886 =item BUGS AND IRRITATIONS
15887
15888 =item COPYRIGHT
15889
15890 =back
15891
15892 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15893
15894 =over 4
15895
15896 =item SYNOPSIS
15897
15898 =item DESCRIPTION
15899
15900 =item USER METHODS
15901
15902 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15903 dataend ()
15904
15905 =item CLASS METHODS
15906
15907 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15908 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15909 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
15910
15911 =item EXPORTS
15912
15913 =item AUTHOR
15914
15915 =item COPYRIGHT
15916
15917 =back
15918
15919 =head2 Net::Config - Local configuration data for libnet
15920
15921 =over 4
15922
15923 =item SYNOPSYS
15924
15925 =item DESCRIPTION
15926
15927 =item METHODS
15928
15929 requires_firewall HOST
15930
15931 =item NetConfig VALUES
15932
15933 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15934 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15935 ftp_int_pasive, local_netmask, test_hosts, test_exists
15936
15937 =back
15938
15939 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15940 and domain
15941
15942 =over 4
15943
15944 =item SYNOPSIS
15945
15946 =item DESCRIPTION
15947
15948 hostfqdn (), hostname (), hostdomain ()
15949
15950 =item AUTHOR
15951
15952 =item COPYRIGHT
15953
15954 =back
15955
15956 =head2 Net::FTP - FTP Client class
15957
15958 =over 4
15959
15960 =item SYNOPSIS
15961
15962 =item DESCRIPTION
15963
15964 =item OVERVIEW
15965
15966 =item CONSTRUCTOR
15967
15968 new (HOST [,OPTIONS])
15969
15970 =item METHODS
15971
15972 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15973 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15974 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
15975 RECURSE ]), mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [,
15976 RECORD_SIZE] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]]
15977 ), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [,
15978 REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (),
15979 mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash (
15980 [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [
15981 DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port (
15982 [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15983 pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
15984 NON_PASV_SERVER ), abort (), quit ()
15985
15986 =over 4
15987
15988 =item Methods for the adventurous
15989
15990 quot (CMD [,ARGS])
15991
15992 =back
15993
15994 =item THE dataconn CLASS
15995
15996 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15997 bytes_read (), abort (), close ()
15998
15999 =item UNIMPLEMENTED
16000
16001 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
16002
16003 =item REPORTING BUGS
16004
16005 =item AUTHOR
16006
16007 =item SEE ALSO
16008
16009 =item USE EXAMPLES
16010
16011 http://www.csh.rit.edu/~adam/Progs/
16012
16013 =item CREDITS
16014
16015 =item COPYRIGHT
16016
16017 =back
16018
16019 =head2 Net::NNTP - NNTP Client class
16020
16021 =over 4
16022
16023 =item SYNOPSIS
16024
16025 =item DESCRIPTION
16026
16027 =item CONSTRUCTOR
16028
16029 new ( [ HOST ] [, OPTIONS ])
16030
16031 =item METHODS
16032
16033 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
16034 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
16035 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
16036 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
16037 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
16038 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
16039 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
16040
16041 =over 4
16042
16043 =item Extension methods
16044
16045 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
16046 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
16047 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
16048 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
16049 GROUP ] ), reader
16050
16051 =back
16052
16053 =item UNSUPPORTED
16054
16055 =item DEFINITIONS
16056
16057 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
16058
16059 =item SEE ALSO
16060
16061 =item AUTHOR
16062
16063 =item COPYRIGHT
16064
16065 =back
16066
16067 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
16068
16069 =over 4
16070
16071 =item SYNOPSIS
16072
16073 =item DESCRIPTION
16074
16075 =item CONSTRUCTOR
16076
16077 new ( [ HOST, ] [ OPTIONS ] )
16078
16079 =item METHODS
16080
16081 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16082 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16083 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16084 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16085
16086 =item NOTES
16087
16088 =item SEE ALSO
16089
16090 =item AUTHOR
16091
16092 =item COPYRIGHT
16093
16094 =back
16095
16096 =head2 Net::Ping - check a remote host for reachability
16097
16098 =over 4
16099
16100 =item SYNOPSIS
16101
16102 =item DESCRIPTION
16103
16104 =over 4
16105
16106 =item Functions
16107
16108 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
16109 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
16110 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
16111 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
16112 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
16113 [, $timeout]);
16114
16115 =back
16116
16117 =item NOTES
16118
16119 =item INSTALL
16120
16121 =item BUGS
16122
16123 =item AUTHORS
16124
16125 =item COPYRIGHT
16126
16127 =back
16128
16129 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16130
16131 =over 4
16132
16133 =item SYNOPSIS
16134
16135 =item DESCRIPTION
16136
16137 =item EXAMPLES
16138
16139 =item CONSTRUCTOR
16140
16141 new Net::SMTP [ HOST, ] [ OPTIONS ]
16142
16143 =item METHODS
16144
16145 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16146 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16147 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16148 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16149 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16150 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16151 quit ()
16152
16153 =item ADDRESSES
16154
16155 =item SEE ALSO
16156
16157 =item AUTHOR
16158
16159 =item COPYRIGHT
16160
16161 =back
16162
16163 =head2 Net::Time - time and daytime network client interface
16164
16165 =over 4
16166
16167 =item SYNOPSIS
16168
16169 =item DESCRIPTION
16170
16171 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16172 PROTOCOL [, TIMEOUT]]])
16173
16174 =item AUTHOR
16175
16176 =item COPYRIGHT
16177
16178 =back
16179
16180 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16181 functions
16182
16183 =over 4
16184
16185 =item SYNOPSIS
16186
16187 =item DESCRIPTION
16188
16189 =item EXAMPLES
16190
16191 =item NOTE
16192
16193 =item AUTHOR
16194
16195 =back
16196
16197 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16198
16199 =over 4
16200
16201 =item DESCRIPTION
16202
16203 =over 4
16204
16205 =item Where to get this document
16206
16207 =item How to contribute to this document
16208
16209 =back
16210
16211 =item Author and Copyright Information
16212
16213 =over 4
16214
16215 =item Disclaimer
16216
16217 =back
16218
16219 =item Obtaining and installing libnet
16220
16221 =over 4
16222
16223 =item What is libnet ?
16224
16225 =item Which version of perl do I need ?
16226
16227 =item What other modules do I need ?
16228
16229 =item What machines support libnet ?
16230
16231 =item Where can I get the latest libnet release
16232
16233 =back
16234
16235 =item Using Net::FTP
16236
16237 =over 4
16238
16239 =item How do I download files from an FTP server ?
16240
16241 =item How do I transfer files in binary mode ?
16242
16243 =item How can I get the size of a file on a remote FTP server ?
16244
16245 =item How can I get the modification time of a file on a remote FTP server
16246 ?
16247
16248 =item How can I change the permissions of a file on a remote server ?
16249
16250 =item Can I do a reget operation like the ftp command ?
16251
16252 =item How do I get a directory listing from an FTP server ?
16253
16254 =item Changing directory to "" does not fail ?
16255
16256 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16257
16258 =item I am behind an FTP proxy firewall, but cannot access machines outside
16259 ?
16260
16261 =item My ftp proxy firewall does not listen on port 21
16262
16263 =item Is it possible to change the file permissions of a file on an FTP
16264 server ?
16265
16266 =item I have seen scripts call a method message, but cannot find it
16267 documented ?
16268
16269 =item Why does Net::FTP not implement mput and mget methods
16270
16271 =back
16272
16273 =item Using Net::SMTP
16274
16275 =over 4
16276
16277 =item Why can't the part of an Email address after the @ be used as the
16278 hostname ?
16279
16280 =item Why does Net::SMTP not do DNS MX lookups ?
16281
16282 =item The verify method always returns true ?
16283
16284 =back
16285
16286 =item Debugging scripts
16287
16288 =over 4
16289
16290 =item How can I debug my scripts that use Net::* modules ?
16291
16292 =back
16293
16294 =item AUTHOR AND COPYRIGHT
16295
16296 =back
16297
16298 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16299 functions
16300
16301 =over 4
16302
16303 =item SYNOPSIS
16304
16305 =item DESCRIPTION
16306
16307 =item EXAMPLES
16308
16309 =item NOTE
16310
16311 =item AUTHOR
16312
16313 =back
16314
16315 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16316 functions
16317
16318 =over 4
16319
16320 =item SYNOPSIS
16321
16322 =item DESCRIPTION
16323
16324 =item NOTE
16325
16326 =item AUTHOR
16327
16328 =back
16329
16330 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16331 functions
16332
16333 =over 4
16334
16335 =item SYNOPSIS
16336
16337 =item DESCRIPTION
16338
16339 =item EXAMPLES
16340
16341 =item NOTE
16342
16343 =item AUTHOR
16344
16345 =back
16346
16347 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16348
16349 =over 4
16350
16351 =item SYNOPSIS
16352
16353 =item DESCRIPTION
16354
16355 =item THE .netrc FILE
16356
16357 machine name, default, login name, password string, account string, macdef
16358 name
16359
16360 =item CONSTRUCTOR
16361
16362 lookup ( MACHINE [, LOGIN ])
16363
16364 =item METHODS
16365
16366 login (), password (), account (), lpa ()
16367
16368 =item AUTHOR
16369
16370 =item SEE ALSO
16371
16372 =item COPYRIGHT
16373
16374 =back
16375
16376 =head2 O - Generic interface to Perl Compiler backends
16377
16378 =over 4
16379
16380 =item SYNOPSIS
16381
16382 =item DESCRIPTION
16383
16384 =item CONVENTIONS
16385
16386 =item IMPLEMENTATION
16387
16388 =item BUGS
16389
16390 =item AUTHOR
16391
16392 =back
16393
16394 =head2 ODBM_File - Tied access to odbm files
16395
16396 =over 4
16397
16398 =item SYNOPSIS
16399
16400 =item DESCRIPTION
16401
16402 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16403
16404 =item DIAGNOSTICS
16405
16406 =over 4
16407
16408 =item C<odbm store returned -1, errno 22, key "..." at ...>
16409
16410 =back
16411
16412 =item BUGS AND WARNINGS
16413
16414 =back
16415
16416 =head2 Opcode - Disable named opcodes when compiling perl code
16417
16418 =over 4
16419
16420 =item SYNOPSIS
16421
16422 =item DESCRIPTION
16423
16424 =item NOTE
16425
16426 =item WARNING
16427
16428 =item Operator Names and Operator Lists
16429
16430 an operator name (opname), an operator tag name (optag), a negated opname
16431 or optag, an operator set (opset)
16432
16433 =item Opcode Functions
16434
16435 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16436 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16437 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16438 opdump (PAT)
16439
16440 =item Manipulating Opsets
16441
16442 =item TO DO (maybe)
16443
16444 =back
16445
16446 =over 4
16447
16448 =item Predefined Opcode Tags
16449
16450 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16451 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16452 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16453 :dangerous
16454
16455 =item SEE ALSO
16456
16457 =item AUTHORS
16458
16459 =back
16460
16461 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16462 compartments
16463
16464 =over 4
16465
16466 =item SYNOPSIS
16467
16468 =item DESCRIPTION
16469
16470 a new namespace, an operator mask
16471
16472 =item WARNING
16473
16474 =over 4
16475
16476 =item RECENT CHANGES
16477
16478 =item Methods in class Safe
16479
16480 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16481 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16482 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16483 root (NAMESPACE), mask (MASK)
16484
16485 =item Some Safety Issues
16486
16487 Memory, CPU, Snooping, Signals, State Changes
16488
16489 =item AUTHOR
16490
16491 =back
16492
16493 =back
16494
16495 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16496 compiling
16497
16498 =over 4
16499
16500 =item SYNOPSIS  
16501
16502 =item DESCRIPTION
16503
16504 =item SEE ALSO
16505
16506 =back
16507
16508 =head2 POSIX - Perl interface to IEEE Std 1003.1
16509
16510 =over 4
16511
16512 =item SYNOPSIS
16513
16514 =item DESCRIPTION
16515
16516 =item NOTE
16517
16518 =item CAVEATS 
16519
16520 =item FUNCTIONS
16521
16522 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16523 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16524 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16525 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16526 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16527 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16528 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16529 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
16530 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
16531 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
16532 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
16533 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
16534 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
16535 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
16536 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
16537 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
16538 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
16539 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16540 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16541 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16542 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16543 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16544 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16545 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16546 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16547 wctomb, write
16548
16549 =item CLASSES
16550
16551 =over 4
16552
16553 =item POSIX::SigAction
16554
16555 new, handler, mask, flags, safe
16556
16557 =item POSIX::SigSet
16558
16559 new, addset, delset, emptyset, fillset, ismember
16560
16561 =item POSIX::Termios
16562
16563 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16564 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16565 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16566 field values, c_cflag field values, c_iflag field values, c_lflag field
16567 values, c_oflag field values
16568
16569 =back
16570
16571 =item PATHNAME CONSTANTS
16572
16573 Constants
16574
16575 =item POSIX CONSTANTS
16576
16577 Constants
16578
16579 =item SYSTEM CONFIGURATION
16580
16581 Constants
16582
16583 =item ERRNO
16584
16585 Constants
16586
16587 =item FCNTL
16588
16589 Constants
16590
16591 =item FLOAT
16592
16593 Constants
16594
16595 =item LIMITS
16596
16597 Constants
16598
16599 =item LOCALE
16600
16601 Constants
16602
16603 =item MATH
16604
16605 Constants
16606
16607 =item SIGNAL
16608
16609 Constants
16610
16611 =item STAT
16612
16613 Constants, Macros
16614
16615 =item STDLIB
16616
16617 Constants
16618
16619 =item STDIO
16620
16621 Constants
16622
16623 =item TIME
16624
16625 Constants
16626
16627 =item UNISTD
16628
16629 Constants
16630
16631 =item WAIT
16632
16633 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16634 WTERMSIG, WIFSTOPPED, WSTOPSIG
16635
16636 =back
16637
16638 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16639 name space
16640
16641 =over 4
16642
16643 =item SYNOPSIS
16644
16645 =item DESCRIPTION
16646
16647 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
16648
16649 =over 4
16650
16651 =item Custom Layers
16652
16653 :encoding, :via
16654
16655 =item Alternatives to raw
16656
16657 =item Defaults and how to override them
16658
16659 =item Querying the layers of filehandles
16660
16661 =back
16662
16663 =item AUTHOR
16664
16665 =item SEE ALSO
16666
16667 =back
16668
16669 =head2 PerlIO::encoding - encoding layer
16670
16671 =over 4
16672
16673 =item SYNOPSIS
16674
16675 =item DESCRIPTION
16676
16677 =item SEE ALSO
16678
16679 =back
16680
16681 =head2 PerlIO::scalar - in-memory IO, scalar IO
16682
16683 =over 4
16684
16685 =item SYNOPSIS
16686
16687 =item DESCRIPTION
16688
16689 =item IMPLEMENTATION NOTE
16690
16691 =back
16692
16693 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
16694
16695 =over 4
16696
16697 =item SYNOPSIS
16698
16699 =item DESCRIPTION
16700
16701 =item EXPECTED METHODS
16702
16703 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16704 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
16705 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
16706 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
16707 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16708 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16709 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16710 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16711
16712 =item EXAMPLES
16713
16714 =over 4
16715
16716 =item Example - a Hexadecimal Handle
16717
16718 =back
16719
16720 =back
16721
16722 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
16723
16724 =over 4
16725
16726 =item SYNOPSIS
16727
16728 =item DESCRIPTION
16729
16730 =item REQUIRED MODULES
16731
16732 =item SEE ALSO
16733
16734 =item ACKNOWLEDGEMENTS
16735
16736 =item COPYRIGHT
16737
16738 =back
16739
16740 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16741
16742 =over 4
16743
16744 =item SYNOPSIS
16745
16746 =item OPTIONS/ARGUMENTS
16747
16748 =over 4
16749
16750 =item podchecker()
16751
16752 B<-warnings> =E<gt> I<val>
16753
16754 =back
16755
16756 =item DESCRIPTION
16757
16758 =item DIAGNOSTICS
16759
16760 =over 4
16761
16762 =item Errors
16763
16764 empty =headn, =over on line I<N> without closing =back, =item without
16765 previous =over, =back without previous =over, No argument for =begin, =end
16766 without =begin, Nested =begin's, =for without formatter specification,
16767 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16768 interior-sequence "I<SEQ>", nested commands
16769 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16770 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16771 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16772 after =back
16773
16774 =item Warnings
16775
16776 multiple occurrence of link target I<name>, line containing nothing but
16777 whitespace in paragraph, file does not start with =head, previous =item has
16778 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16779 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16780 items in =over, No argument for =item, empty section in previous paragraph,
16781 Verbatim paragraph in NAME section, =headI<n> without preceding higher
16782 level
16783
16784 =item Hyperlinks
16785
16786 ignoring leading/trailing whitespace in link, (section) in '$page'
16787 deprecated, alternative text/node '%s' contains non-escaped | or /
16788
16789 =back
16790
16791 =item RETURN VALUE
16792
16793 =item EXAMPLES
16794
16795 =item INTERFACE
16796
16797 =back
16798
16799 C<Pod::Checker-E<gt>new( %options )>
16800
16801 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16802 @args )>
16803
16804 C<$checker-E<gt>num_errors()>
16805
16806 C<$checker-E<gt>num_warnings()>
16807
16808 C<$checker-E<gt>name()>
16809
16810 C<$checker-E<gt>node()>
16811
16812 C<$checker-E<gt>idx()>
16813
16814 C<$checker-E<gt>hyperlink()>
16815
16816 =over 4
16817
16818 =item AUTHOR
16819
16820 =back
16821
16822 =head2 Pod::Find - find POD documents in directory trees
16823
16824 =over 4
16825
16826 =item SYNOPSIS
16827
16828 =item DESCRIPTION
16829
16830 =back
16831
16832 =over 4
16833
16834 =item C<pod_find( { %opts } , @directories )>
16835
16836 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16837 1>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item C<simplify_name( $str )>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item C<pod_where( { %opts }, $pod )>
16850
16851 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16852 1>
16853
16854 =back
16855
16856 =over 4
16857
16858 =item C<contains_pod( $file , $verbose )>
16859
16860 =back
16861
16862 =over 4
16863
16864 =item AUTHOR
16865
16866 =item SEE ALSO
16867
16868 =back
16869
16870 =head2 Pod::Html - module to convert pod files to HTML
16871
16872 =over 4
16873
16874 =item SYNOPSIS
16875
16876 =item DESCRIPTION
16877
16878 =item ARGUMENTS
16879
16880 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
16881 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
16882 quiet, recurse, title, verbose
16883
16884 =item EXAMPLE
16885
16886 =item ENVIRONMENT
16887
16888 =item AUTHOR
16889
16890 =item SEE ALSO
16891
16892 =item COPYRIGHT
16893
16894 =back
16895
16896 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16897 commands, etc.
16898
16899 =over 4
16900
16901 =item SYNOPSIS
16902
16903 =item REQUIRES
16904
16905 =item EXPORTS
16906
16907 =item DESCRIPTION
16908
16909 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16910 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16911
16912 =back
16913
16914 =over 4
16915
16916 =item B<Pod::InputSource>
16917
16918 =back
16919
16920 =over 4
16921
16922 =item B<new()>
16923
16924 =back
16925
16926 =over 4
16927
16928 =item B<name()>
16929
16930 =back
16931
16932 =over 4
16933
16934 =item B<handle()>
16935
16936 =back
16937
16938 =over 4
16939
16940 =item B<was_cutting()>
16941
16942 =back
16943
16944 =over 4
16945
16946 =item B<Pod::Paragraph>
16947
16948 =back
16949
16950 =over 4
16951
16952 =item Pod::Paragraph-E<gt>B<new()>
16953
16954 =back
16955
16956 =over 4
16957
16958 =item $pod_para-E<gt>B<cmd_name()>
16959
16960 =back
16961
16962 =over 4
16963
16964 =item $pod_para-E<gt>B<text()>
16965
16966 =back
16967
16968 =over 4
16969
16970 =item $pod_para-E<gt>B<raw_text()>
16971
16972 =back
16973
16974 =over 4
16975
16976 =item $pod_para-E<gt>B<cmd_prefix()>
16977
16978 =back
16979
16980 =over 4
16981
16982 =item $pod_para-E<gt>B<cmd_separator()>
16983
16984 =back
16985
16986 =over 4
16987
16988 =item $pod_para-E<gt>B<parse_tree()>
16989
16990 =back
16991
16992 =over 4
16993
16994 =item $pod_para-E<gt>B<file_line()>
16995
16996 =back
16997
16998 =over 4
16999
17000 =item B<Pod::InteriorSequence>
17001
17002 =back
17003
17004 =over 4
17005
17006 =item Pod::InteriorSequence-E<gt>B<new()>
17007
17008 =back
17009
17010 =over 4
17011
17012 =item $pod_seq-E<gt>B<cmd_name()>
17013
17014 =back
17015
17016 =over 4
17017
17018 =item $pod_seq-E<gt>B<prepend()>
17019
17020 =back
17021
17022 =over 4
17023
17024 =item $pod_seq-E<gt>B<append()>
17025
17026 =back
17027
17028 =over 4
17029
17030 =item $pod_seq-E<gt>B<nested()>
17031
17032 =back
17033
17034 =over 4
17035
17036 =item $pod_seq-E<gt>B<raw_text()>
17037
17038 =back
17039
17040 =over 4
17041
17042 =item $pod_seq-E<gt>B<left_delimiter()>
17043
17044 =back
17045
17046 =over 4
17047
17048 =item $pod_seq-E<gt>B<right_delimiter()>
17049
17050 =back
17051
17052 =over 4
17053
17054 =item $pod_seq-E<gt>B<parse_tree()>
17055
17056 =back
17057
17058 =over 4
17059
17060 =item $pod_seq-E<gt>B<file_line()>
17061
17062 =back
17063
17064 =over 4
17065
17066 =item Pod::InteriorSequence::B<DESTROY()>
17067
17068 =back
17069
17070 =over 4
17071
17072 =item B<Pod::ParseTree>
17073
17074 =back
17075
17076 =over 4
17077
17078 =item Pod::ParseTree-E<gt>B<new()>
17079
17080 =back
17081
17082 =over 4
17083
17084 =item $ptree-E<gt>B<top()>
17085
17086 =back
17087
17088 =over 4
17089
17090 =item $ptree-E<gt>B<children()>
17091
17092 =back
17093
17094 =over 4
17095
17096 =item $ptree-E<gt>B<prepend()>
17097
17098 =back
17099
17100 =over 4
17101
17102 =item $ptree-E<gt>B<append()>
17103
17104 =back
17105
17106 =over 4
17107
17108 =item $ptree-E<gt>B<raw_text()>
17109
17110 =back
17111
17112 =over 4
17113
17114 =item Pod::ParseTree::B<DESTROY()>
17115
17116 =back
17117
17118 =over 4
17119
17120 =item SEE ALSO
17121
17122 =item AUTHOR
17123
17124 =back
17125
17126 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17127
17128 =over 4
17129
17130 =item SYNOPSIS
17131
17132 =item DESCRIPTION
17133
17134 =back
17135
17136 =over 4
17137
17138 =item OBJECT METHODS
17139
17140 C<initialize>
17141
17142 =back
17143
17144 =over 4
17145
17146 =item Data Accessors
17147
17148 B<AddPreamble>
17149
17150 =back
17151
17152 B<AddPostamble>
17153
17154 B<Head1Level>
17155
17156 B<Label>
17157
17158 B<LevelNoNum>
17159
17160 B<MakeIndex>
17161
17162 B<ReplaceNAMEwithSection>
17163
17164 B<StartWithNewPage>
17165
17166 B<TableOfContents>
17167
17168 B<UniqueLabels>
17169
17170 B<UserPreamble>
17171
17172 B<UserPostamble>
17173
17174 B<Lists>
17175
17176 =over 4
17177
17178 =item Subclassed methods
17179
17180 =back
17181
17182 B<begin_pod>
17183
17184 B<end_pod>
17185
17186 B<command>
17187
17188 B<verbatim>
17189
17190 B<textblock>
17191
17192 B<interior_sequence>
17193
17194 =over 4
17195
17196 =item List Methods
17197
17198 B<begin_list>
17199
17200 =back
17201
17202 B<end_list>
17203
17204 B<add_item>
17205
17206 =over 4
17207
17208 =item Methods for headings
17209
17210 B<head>
17211
17212 =back
17213
17214 =over 4
17215
17216 =item Internal methods
17217
17218 B<_output>
17219
17220 =back
17221
17222 B<_replace_special_chars>
17223
17224 B<_replace_special_chars_late>
17225
17226 B<_create_label>
17227
17228 B<_create_index>
17229
17230 B<_clean_latex_commands>
17231
17232 B<_split_delimited>
17233
17234 =over 4
17235
17236 =item NOTES
17237
17238 =item SEE ALSO
17239
17240 =item AUTHORS
17241
17242 =item COPYRIGHT
17243
17244 =item REVISION
17245
17246 =back
17247
17248 =head2 Pod::Man - Convert POD data to formatted *roff input
17249
17250 =over 4
17251
17252 =item SYNOPSIS
17253
17254 =item DESCRIPTION
17255
17256 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17257 release, section
17258
17259 =item DIAGNOSTICS
17260
17261 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17262 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17263 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17264 =back
17265
17266 =item BUGS
17267
17268 =item CAVEATS
17269
17270 =item SEE ALSO
17271
17272 =item AUTHOR
17273
17274 =item COPYRIGHT AND LICENSE
17275
17276 =back
17277
17278 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
17279
17280 =over 4
17281
17282 =item SYNOPSIS
17283
17284 =item DESCRIPTION
17285
17286 =item SEE ALSO
17287
17288 =item AUTHOR
17289
17290 =item COPYRIGHT AND LICENSE
17291
17292 =back
17293
17294 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17295
17296 =over 4
17297
17298 =item SYNOPSIS
17299
17300 =item DESCRIPTION
17301
17302 =back
17303
17304 =over 4
17305
17306 =item Pod::List
17307
17308 Pod::List-E<gt>new()
17309
17310 =back
17311
17312 $list-E<gt>file()
17313
17314 $list-E<gt>start()
17315
17316 $list-E<gt>indent()
17317
17318 $list-E<gt>type()
17319
17320 $list-E<gt>rx()
17321
17322 $list-E<gt>item()
17323
17324 $list-E<gt>parent()
17325
17326 $list-E<gt>tag()
17327
17328 =over 4
17329
17330 =item Pod::Hyperlink
17331
17332 Pod::Hyperlink-E<gt>new()
17333
17334 =back
17335
17336 $link-E<gt>parse($string)
17337
17338 $link-E<gt>markup($string)
17339
17340 $link-E<gt>text()
17341
17342 $link-E<gt>warning()
17343
17344 $link-E<gt>file(), $link-E<gt>line()
17345
17346 $link-E<gt>page()
17347
17348 $link-E<gt>node()
17349
17350 $link-E<gt>alttext()
17351
17352 $link-E<gt>type()
17353
17354 $link-E<gt>link()
17355
17356 =over 4
17357
17358 =item Pod::Cache
17359
17360 Pod::Cache-E<gt>new()
17361
17362 =back
17363
17364 $cache-E<gt>item()
17365
17366 $cache-E<gt>find_page($name)
17367
17368 =over 4
17369
17370 =item Pod::Cache::Item
17371
17372 Pod::Cache::Item-E<gt>new()
17373
17374 =back
17375
17376 $cacheitem-E<gt>page()
17377
17378 $cacheitem-E<gt>description()
17379
17380 $cacheitem-E<gt>path()
17381
17382 $cacheitem-E<gt>file()
17383
17384 $cacheitem-E<gt>nodes()
17385
17386 $cacheitem-E<gt>find_node($name)
17387
17388 $cacheitem-E<gt>idx()
17389
17390 =over 4
17391
17392 =item AUTHOR
17393
17394 =item SEE ALSO
17395
17396 =back
17397
17398 =head2 Pod::Parser - base class for creating POD filters and translators
17399
17400 =over 4
17401
17402 =item SYNOPSIS
17403
17404 =item REQUIRES
17405
17406 =item EXPORTS
17407
17408 =item DESCRIPTION
17409
17410 =item QUICK OVERVIEW
17411
17412 =item PARSING OPTIONS
17413
17414 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17415 B<-warnings> (default: unset)
17416
17417 =back
17418
17419 =over 4
17420
17421 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17422
17423 =back
17424
17425 =over 4
17426
17427 =item B<command()>
17428
17429 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17430
17431 =back
17432
17433 =over 4
17434
17435 =item B<verbatim()>
17436
17437 C<$text>, C<$line_num>, C<$pod_para>
17438
17439 =back
17440
17441 =over 4
17442
17443 =item B<textblock()>
17444
17445 C<$text>, C<$line_num>, C<$pod_para>
17446
17447 =back
17448
17449 =over 4
17450
17451 =item B<interior_sequence()>
17452
17453 =back
17454
17455 =over 4
17456
17457 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17458
17459 =back
17460
17461 =over 4
17462
17463 =item B<new()>
17464
17465 =back
17466
17467 =over 4
17468
17469 =item B<initialize()>
17470
17471 =back
17472
17473 =over 4
17474
17475 =item B<begin_pod()>
17476
17477 =back
17478
17479 =over 4
17480
17481 =item B<begin_input()>
17482
17483 =back
17484
17485 =over 4
17486
17487 =item B<end_input()>
17488
17489 =back
17490
17491 =over 4
17492
17493 =item B<end_pod()>
17494
17495 =back
17496
17497 =over 4
17498
17499 =item B<preprocess_line()>
17500
17501 =back
17502
17503 =over 4
17504
17505 =item B<preprocess_paragraph()>
17506
17507 =back
17508
17509 =over 4
17510
17511 =item METHODS FOR PARSING AND PROCESSING
17512
17513 =back
17514
17515 =over 4
17516
17517 =item B<parse_text()>
17518
17519 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17520 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17521 I<code-ref>|I<method-name>
17522
17523 =back
17524
17525 =over 4
17526
17527 =item B<interpolate()>
17528
17529 =back
17530
17531 =over 4
17532
17533 =item B<parse_paragraph()>
17534
17535 =back
17536
17537 =over 4
17538
17539 =item B<parse_from_filehandle()>
17540
17541 =back
17542
17543 =over 4
17544
17545 =item B<parse_from_file()>
17546
17547 =back
17548
17549 =over 4
17550
17551 =item ACCESSOR METHODS
17552
17553 =back
17554
17555 =over 4
17556
17557 =item B<errorsub()>
17558
17559 =back
17560
17561 =over 4
17562
17563 =item B<cutting()>
17564
17565 =back
17566
17567 =over 4
17568
17569 =item B<parseopts()>
17570
17571 =back
17572
17573 =over 4
17574
17575 =item B<output_file()>
17576
17577 =back
17578
17579 =over 4
17580
17581 =item B<output_handle()>
17582
17583 =back
17584
17585 =over 4
17586
17587 =item B<input_file()>
17588
17589 =back
17590
17591 =over 4
17592
17593 =item B<input_handle()>
17594
17595 =back
17596
17597 =over 4
17598
17599 =item B<input_streams()>
17600
17601 =back
17602
17603 =over 4
17604
17605 =item B<top_stream()>
17606
17607 =back
17608
17609 =over 4
17610
17611 =item PRIVATE METHODS AND DATA
17612
17613 =back
17614
17615 =over 4
17616
17617 =item B<_push_input_stream()>
17618
17619 =back
17620
17621 =over 4
17622
17623 =item B<_pop_input_stream()>
17624
17625 =back
17626
17627 =over 4
17628
17629 =item TREE-BASED PARSING
17630
17631 =item SEE ALSO
17632
17633 =item AUTHOR
17634
17635 =back
17636
17637 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
17638
17639 =over 4
17640
17641 =item SYNOPSIS
17642
17643 =item DESCRIPTION
17644
17645 =item SEE ALSO
17646
17647 =item COPYRIGHT AND DISCLAIMERS
17648
17649 =item AUTHOR
17650
17651 =back
17652
17653 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
17654
17655 =over 4
17656
17657 =item SYNOPSIS
17658
17659 =item DESCRIPTION
17660
17661 =item CAVEAT
17662
17663 =item SEE ALSO
17664
17665 =item COPYRIGHT AND DISCLAIMERS
17666
17667 =item AUTHOR
17668
17669 =back
17670
17671 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
17672
17673 =over 4
17674
17675 =item SYNOPSIS
17676
17677 =item DESCRIPTION
17678
17679 =item CAVEAT
17680
17681 =item SEE ALSO
17682
17683 =item COPYRIGHT AND DISCLAIMERS
17684
17685 =item AUTHOR
17686
17687 =back
17688
17689 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
17690
17691 =over 4
17692
17693 =item SYNOPSIS
17694
17695 =item DESCRIPTION
17696
17697 =item SEE ALSO
17698
17699 =item COPYRIGHT AND DISCLAIMERS
17700
17701 =item AUTHOR
17702
17703 =back
17704
17705 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
17706
17707 =over 4
17708
17709 =item SYNOPSIS
17710
17711 =item DESCRIPTION
17712
17713 =item SEE ALSO
17714
17715 =item COPYRIGHT AND DISCLAIMERS
17716
17717 =item AUTHOR
17718
17719 =back
17720
17721 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
17722
17723 =over 4
17724
17725 =item SYNOPSIS
17726
17727 =item DESCRIPTION
17728
17729 =item CAVEAT
17730
17731 =item SEE ALSO
17732
17733 =item COPYRIGHT AND DISCLAIMERS
17734
17735 =item AUTHOR
17736
17737 =back
17738
17739 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
17740
17741 =over 4
17742
17743 =item SYNOPSIS
17744
17745 =item DESCRIPTION
17746
17747 =item SEE ALSO
17748
17749 =item AUTHOR
17750
17751 =back
17752
17753 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
17754
17755 =over 4
17756
17757 =item SYNOPSIS
17758
17759 =item DESCRIPTION
17760
17761 =item SEE ALSO
17762
17763 =item COPYRIGHT AND DISCLAIMERS
17764
17765 =item AUTHOR
17766
17767 =back
17768
17769 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
17770
17771 =over 4
17772
17773 =item SYNOPSIS
17774
17775 =item DESCRIPTION
17776
17777 alt, indent, loose, sentence, width
17778
17779 =item DIAGNOSTICS
17780
17781 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
17782 Unknown sequence: %s, Unmatched =back
17783
17784 =item RESTRICTIONS
17785
17786 =item NOTES
17787
17788 =item SEE ALSO
17789
17790 =item AUTHOR
17791
17792 =back
17793
17794 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17795
17796 =over 4
17797
17798 =item SYNOPSIS
17799
17800 =item DESCRIPTION
17801
17802 =over 4
17803
17804 =item EXPORT
17805
17806 =back
17807
17808 =item AUTHOR
17809
17810 =item SEE ALSO
17811
17812 =back
17813
17814 =head2 Pod::Select, podselect() - extract selected sections of POD from
17815 input
17816
17817 =over 4
17818
17819 =item SYNOPSIS
17820
17821 =item REQUIRES
17822
17823 =item EXPORTS
17824
17825 =item DESCRIPTION
17826
17827 =item SECTION SPECIFICATIONS
17828
17829 =item RANGE SPECIFICATIONS
17830
17831 =back
17832
17833 =over 4
17834
17835 =item OBJECT METHODS
17836
17837 =back
17838
17839 =over 4
17840
17841 =item B<curr_headings()>
17842
17843 =back
17844
17845 =over 4
17846
17847 =item B<select()>
17848
17849 =back
17850
17851 =over 4
17852
17853 =item B<add_selection()>
17854
17855 =back
17856
17857 =over 4
17858
17859 =item B<clear_selections()>
17860
17861 =back
17862
17863 =over 4
17864
17865 =item B<match_section()>
17866
17867 =back
17868
17869 =over 4
17870
17871 =item B<is_selected()>
17872
17873 =back
17874
17875 =over 4
17876
17877 =item EXPORTED FUNCTIONS
17878
17879 =back
17880
17881 =over 4
17882
17883 =item B<podselect()>
17884
17885 B<-output>, B<-sections>, B<-ranges>
17886
17887 =back
17888
17889 =over 4
17890
17891 =item PRIVATE METHODS AND DATA
17892
17893 =back
17894
17895 =over 4
17896
17897 =item B<_compile_section_spec()>
17898
17899 =back
17900
17901 =over 4
17902
17903 =item $self->{_SECTION_HEADINGS}
17904
17905 =back
17906
17907 =over 4
17908
17909 =item $self->{_SELECTED_SECTIONS}
17910
17911 =back
17912
17913 =over 4
17914
17915 =item SEE ALSO
17916
17917 =item AUTHOR
17918
17919 =back
17920
17921 =head2 Pod::Text - Convert POD data to formatted ASCII text
17922
17923 =over 4
17924
17925 =item SYNOPSIS
17926
17927 =item DESCRIPTION
17928
17929 alt, code, indent, loose, margin, quotes, sentence, width
17930
17931 =item DIAGNOSTICS
17932
17933 Bizarre space in item, Item called without tag, Can't open %s for reading:
17934 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17935 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17936 Unmatched =back
17937
17938 =item RESTRICTIONS
17939
17940 =item NOTES
17941
17942 =item SEE ALSO
17943
17944 =item AUTHOR
17945
17946 =item COPYRIGHT AND LICENSE
17947
17948 =back
17949
17950 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17951
17952 =over 4
17953
17954 =item SYNOPSIS
17955
17956 =item DESCRIPTION
17957
17958 =item BUGS
17959
17960 =item SEE ALSO
17961
17962 =item AUTHOR
17963
17964 =item COPYRIGHT AND LICENSE
17965
17966 =back
17967
17968 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17969 text
17970
17971 =over 4
17972
17973 =item SYNOPSIS
17974
17975 =item DESCRIPTION
17976
17977 =item BUGS
17978
17979 =item SEE ALSO
17980
17981 =item AUTHOR
17982
17983 =item COPYRIGHT AND LICENSE
17984
17985 =back
17986
17987 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
17988 escapes
17989
17990 =over 4
17991
17992 =item SYNOPSIS
17993
17994 =item DESCRIPTION
17995
17996 =item NOTES
17997
17998 =item SEE ALSO
17999
18000 =item AUTHOR
18001
18002 =item COPYRIGHT AND LICENSE
18003
18004 =back
18005
18006 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
18007 documentation
18008
18009 =over 4
18010
18011 =item SYNOPSIS
18012
18013 =item ARGUMENTS
18014
18015 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
18016 C<-pathlist>
18017
18018 =item DESCRIPTION
18019
18020 =item EXAMPLES
18021
18022 =over 4
18023
18024 =item Recommended Use
18025
18026 =back
18027
18028 =item CAVEATS
18029
18030 =item AUTHOR
18031
18032 =item ACKNOWLEDGEMENTS
18033
18034 =back
18035
18036 =head2 SDBM_File - Tied access to sdbm files
18037
18038 =over 4
18039
18040 =item SYNOPSIS
18041
18042 =item DESCRIPTION
18043
18044 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18045
18046 =item DIAGNOSTICS
18047
18048 =over 4
18049
18050 =item C<sdbm store returned -1, errno 22, key "..." at ...>
18051
18052 =back
18053
18054 =item BUGS AND WARNINGS
18055
18056 =back
18057
18058 =head2 Safe - Compile and execute code in restricted compartments
18059
18060 =over 4
18061
18062 =item SYNOPSIS
18063
18064 =item DESCRIPTION
18065
18066 a new namespace, an operator mask
18067
18068 =item WARNING
18069
18070 =over 4
18071
18072 =item RECENT CHANGES
18073
18074 =item Methods in class Safe
18075
18076 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18077 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18078 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18079 root (NAMESPACE), mask (MASK)
18080
18081 =item Some Safety Issues
18082
18083 Memory, CPU, Snooping, Signals, State Changes
18084
18085 =item AUTHOR
18086
18087 =back
18088
18089 =back
18090
18091 =head2 Scalar::Util - A selection of general-utility scalar subroutines
18092
18093 =over 4
18094
18095 =item SYNOPSIS
18096
18097 =item DESCRIPTION
18098
18099 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
18100 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
18101 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
18102
18103 =item KNOWN BUGS
18104
18105 =item COPYRIGHT
18106
18107 =item BLATANT PLUG
18108
18109 =back
18110
18111 =head2 Search::Dict, look - search for key in dictionary file
18112
18113 =over 4
18114
18115 =item SYNOPSIS
18116
18117 =item DESCRIPTION
18118
18119 =back
18120
18121 =head2 SelectSaver - save and restore selected file handle
18122
18123 =over 4
18124
18125 =item SYNOPSIS
18126
18127 =item DESCRIPTION
18128
18129 =back
18130
18131 =head2 SelfLoader - load functions only on demand
18132
18133 =over 4
18134
18135 =item SYNOPSIS
18136
18137 =item DESCRIPTION
18138
18139 =over 4
18140
18141 =item The __DATA__ token
18142
18143 =item SelfLoader autoloading
18144
18145 =item Autoloading and package lexicals
18146
18147 =item SelfLoader and AutoLoader
18148
18149 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
18150
18151 =item Classes and inherited methods.
18152
18153 =back
18154
18155 =item Multiple packages and fully qualified subroutine names
18156
18157 =back
18158
18159 =head2 Shell - run shell commands transparently within perl
18160
18161 =over 4
18162
18163 =item SYNOPSIS
18164
18165 =item DESCRIPTION
18166
18167 =over 4
18168
18169 =item OBJECT ORIENTED SYNTAX
18170
18171 =back
18172
18173 =item AUTHOR
18174
18175 =back
18176
18177 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
18178 socket.h defines and structure manipulators 
18179
18180 =over 4
18181
18182 =item SYNOPSIS
18183
18184 =item DESCRIPTION
18185
18186 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
18187 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
18188 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
18189 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
18190 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
18191
18192 =back
18193
18194 =head2 Storable - persistence for Perl data structures
18195
18196 =over 4
18197
18198 =item SYNOPSIS
18199
18200 =item DESCRIPTION
18201
18202 =item MEMORY STORE
18203
18204 =item ADVISORY LOCKING
18205
18206 =item SPEED
18207
18208 =item CANONICAL REPRESENTATION
18209
18210 =item CODE REFERENCES
18211
18212 =item FORWARD COMPATIBILITY
18213
18214 utf8 data, restricted hashes, files from future versions of Storable
18215
18216 =item ERROR REPORTING
18217
18218 =item WIZARDS ONLY
18219
18220 =over 4
18221
18222 =item Hooks
18223
18224 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18225 I<serialized>, ..
18226
18227 =item Predicates
18228
18229 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18230 C<Storable::is_retrieving>
18231
18232 =item Recursion
18233
18234 =item Deep Cloning
18235
18236 =back
18237
18238 =item Storable magic
18239
18240 =item EXAMPLES
18241
18242 =item WARNING
18243
18244 =item BUGS
18245
18246 =over 4
18247
18248 =item 64 bit data in perl 5.6.0 and 5.6.1
18249
18250 =back
18251
18252 =item CREDITS
18253
18254 =item AUTHOR
18255
18256 =item SEE ALSO
18257
18258 =back
18259
18260 =head2 Switch - A switch statement for Perl
18261
18262 =over 4
18263
18264 =item VERSION
18265
18266 =item SYNOPSIS
18267
18268 =item BACKGROUND
18269
18270 =item DESCRIPTION
18271
18272 =over 4
18273
18274 =item Allowing fall-through
18275
18276 =item Automating fall-through
18277
18278 =item Alternative syntax
18279
18280 =item Higher-order Operations
18281
18282 =back
18283
18284 =item DEPENDENCIES
18285
18286 =item AUTHOR
18287
18288 =item BUGS
18289
18290 =item LIMITATIONS
18291
18292 =item COPYRIGHT
18293
18294 =back
18295
18296 =head2 Symbol - manipulate Perl symbols and their names
18297
18298 =over 4
18299
18300 =item SYNOPSIS
18301
18302 =item DESCRIPTION
18303
18304 =item BUGS
18305
18306 =back
18307
18308 =head2 Sys::Hostname - Try every conceivable way to get hostname
18309
18310 =over 4
18311
18312 =item SYNOPSIS
18313
18314 =item DESCRIPTION
18315
18316 =item AUTHOR
18317
18318 =back
18319
18320 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18321 interface to the UNIX syslog(3) calls
18322
18323 =over 4
18324
18325 =item SYNOPSIS
18326
18327 =item DESCRIPTION
18328
18329 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18330 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18331 in 5.004_02), closelog
18332
18333 =item EXAMPLES
18334
18335 =item SEE ALSO
18336
18337 =item AUTHOR
18338
18339 =back
18340
18341 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18342 Perl interface to the UNIX syslog(3) calls
18343
18344 =over 4
18345
18346 =item SYNOPSIS
18347
18348 =item DESCRIPTION
18349
18350 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18351 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18352 in 5.004_02), closelog
18353
18354 =item EXAMPLES
18355
18356 =item SEE ALSO
18357
18358 =item AUTHOR
18359
18360 =back
18361
18362 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18363
18364 =over 4
18365
18366 =item SYNOPSIS
18367
18368 =item DESCRIPTION
18369
18370 =item DIAGNOSTICS
18371
18372 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18373 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18374 comma allowed after filehandle, No name for escape sequence %s
18375
18376 =item ENVIRONMENT
18377
18378 ANSI_COLORS_DISABLED
18379
18380 =item RESTRICTIONS
18381
18382 =item NOTES
18383
18384 =item SEE ALSO
18385
18386 =item AUTHORS
18387
18388 =item COPYRIGHT AND LICENSE
18389
18390 =back
18391
18392 =head2 Term::Cap - Perl termcap interface
18393
18394 =over 4
18395
18396 =item SYNOPSIS
18397
18398 =item DESCRIPTION
18399
18400 =over 4
18401
18402 =item METHODS
18403
18404 =back
18405
18406 =back
18407
18408 B<Tgetent>, OSPEED, TERM
18409
18410 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18411
18412 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18413
18414 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18415
18416 B<Trequire>
18417
18418 =over 4
18419
18420 =item EXAMPLES
18421
18422 =item COPYRIGHT AND LICENSE
18423
18424 =item AUTHOR
18425
18426 =item SEE ALSO
18427
18428 =back
18429
18430 =head2 Term::Complete - Perl word completion module
18431
18432 =over 4
18433
18434 =item SYNOPSIS
18435
18436 =item DESCRIPTION
18437
18438 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18439
18440 =item DIAGNOSTICS
18441
18442 =item BUGS
18443
18444 =item AUTHOR
18445
18446 =back
18447
18448 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
18449 If no real package is found, substitutes stubs instead of basic functions.
18450
18451 =over 4
18452
18453 =item SYNOPSIS
18454
18455 =item DESCRIPTION
18456
18457 =item Minimal set of supported functions
18458
18459 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
18460 C<findConsole>, Attribs, C<Features>
18461
18462 =item Additional supported functions
18463
18464 C<tkRunning>, C<ornaments>, C<newTTY>
18465
18466 =item EXPORTS
18467
18468 =item ENVIRONMENT
18469
18470 =item CAVEATS
18471
18472 =back
18473
18474 =head2 Test - provides a simple framework for writing test scripts
18475
18476 =over 4
18477
18478 =item SYNOPSIS
18479
18480 =item DESCRIPTION
18481
18482 =item QUICK START GUIDE
18483
18484 =over 4
18485
18486 =item Functions
18487
18488 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
18489 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
18490
18491 =back
18492
18493 =back
18494
18495 B<_to_value>
18496
18497 C<ok(...)>
18498
18499 C<skip(I<skip_if_true>, I<args...>)>
18500
18501 =over 4
18502
18503 =item TEST TYPES
18504
18505 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18506
18507 =item ONFAIL
18508
18509 =item BUGS and CAVEATS
18510
18511 =item NOTE
18512
18513 =item SEE ALSO
18514
18515 =item AUTHOR
18516
18517 =back
18518
18519 =head2 Test::Builder - Backend for building test libraries
18520
18521 =over 4
18522
18523 =item SYNOPSIS
18524
18525 =item DESCRIPTION
18526
18527 =over 4
18528
18529 =item Construction
18530
18531 B<new>
18532
18533 =back
18534
18535 =back
18536
18537 =over 4
18538
18539 =item Setting up tests
18540
18541 B<exported_to>
18542
18543 =back
18544
18545 B<plan>
18546
18547 B<expected_tests>
18548
18549 B<no_plan>
18550
18551 B<has_plan>
18552
18553 B<skip_all>
18554
18555 =over 4
18556
18557 =item Running tests
18558
18559 B<ok>
18560
18561 =back
18562
18563 B<is_eq>, B<is_num>
18564
18565 B<isnt_eq>, B<isnt_num>
18566
18567 B<like>, B<unlike>
18568
18569 B<maybe_regex>
18570
18571 B<cmp_ok>
18572
18573 B<BAILOUT>
18574
18575 B<skip>
18576
18577 B<todo_skip>
18578
18579 B<skip_rest>
18580
18581 =over 4
18582
18583 =item Test style
18584
18585 B<level>
18586
18587 =back
18588
18589 B<use_numbers>
18590
18591 B<no_header>, B<no_ending>
18592
18593 =over 4
18594
18595 =item Output
18596
18597 B<diag>
18598
18599 =back
18600
18601 B<_print>
18602
18603 B<output>, B<failure_output>, B<todo_output>
18604
18605 =over 4
18606
18607 =item Test Status and Info
18608
18609 B<current_test>
18610
18611 =back
18612
18613 B<summary>
18614
18615 B<details>
18616
18617 B<todo>
18618
18619 B<caller>
18620
18621 B<_sanity_check>
18622
18623 B<_whoa>
18624
18625 B<_my_exit>
18626
18627 =over 4
18628
18629 =item THREADS
18630
18631 =item EXAMPLES
18632
18633 =item SEE ALSO
18634
18635 =item AUTHORS
18636
18637 =item COPYRIGHT
18638
18639 =back
18640
18641 =head2 Test::Harness - Run Perl standard test scripts with statistics
18642
18643 =over 4
18644
18645 =item VERSION
18646
18647 =back
18648
18649 =over 4
18650
18651 =item SYNOPSIS
18652
18653 =item DESCRIPTION
18654
18655 =over 4
18656
18657 =item The test script output
18658
18659 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18660 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18661 else>
18662
18663 =item Taint mode
18664
18665 =item Configuration variables.
18666
18667 B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
18668
18669 =item Failure
18670
18671 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18672 Failed>
18673
18674 =item Functions
18675
18676 B<runtests>
18677
18678 =back
18679
18680 =back
18681
18682 B<_all_ok>
18683
18684 B<_globdir>
18685
18686 B<_run_all_tests>
18687
18688 B<_mk_leader>
18689
18690 B<_leader_width>
18691
18692 =over 4
18693
18694 =item EXPORT
18695
18696 =item DIAGNOSTICS
18697
18698 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18699 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18700 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18701 %s>, C<FAILED--Further testing stopped: %s>
18702
18703 =item ENVIRONMENT
18704
18705 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18706 C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
18707 C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>,
18708 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18709
18710 =item EXAMPLE
18711
18712 =item SEE ALSO
18713
18714 =item AUTHORS
18715
18716 =item LICENSE
18717
18718 =item TODO
18719
18720 =item BUGS
18721
18722 =item AUTHORS
18723
18724 =item COPYRIGHT
18725
18726 =back
18727
18728 =head2 Test::Harness::Assert - simple assert
18729
18730 =over 4
18731
18732 =item SYNOPSIS
18733
18734 =item DESCRIPTION
18735
18736 =item FUNCTIONS
18737
18738 =over 4
18739
18740 =item C<assert()>
18741
18742 =back
18743
18744 =back
18745
18746 =over 4
18747
18748 =item AUTHOR
18749
18750 =item SEE ALSO
18751
18752 =back
18753
18754 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18755
18756 =over 4
18757
18758 =item SYNOPSIS
18759
18760 =item DESCRIPTION
18761
18762 =over 4
18763
18764 =item new()
18765
18766 =item next()
18767
18768 =back
18769
18770 =back
18771
18772 =head2 Test::Harness::Straps - detailed analysis of test results
18773
18774 =over 4
18775
18776 =item SYNOPSIS
18777
18778 =item DESCRIPTION
18779
18780 =item Construction
18781
18782 =over 4
18783
18784 =item C<new>
18785
18786 =back
18787
18788 =back
18789
18790 =over 4
18791
18792 =item C<_init>
18793
18794 =back
18795
18796 =over 4
18797
18798 =item Analysis
18799
18800 =over 4
18801
18802 =item C<analyze>
18803
18804 =back
18805
18806 =back
18807
18808 =over 4
18809
18810 =item C<analyze_fh>
18811
18812 =back
18813
18814 =over 4
18815
18816 =item C<analyze_file>
18817
18818 =back
18819
18820 =over 4
18821
18822 =item C<_command_line( $file )>
18823
18824 =back
18825
18826 =over 4
18827
18828 =item C<_command>
18829
18830 =back
18831
18832 =over 4
18833
18834 =item C<_switches>
18835
18836 =back
18837
18838 =over 4
18839
18840 =item C<_cleaned_switches>
18841
18842 =back
18843
18844 =over 4
18845
18846 =item C<_INC2PERL5LIB>
18847
18848 =back
18849
18850 =over 4
18851
18852 =item C<_filtered_INC>
18853
18854 =back
18855
18856 =over 4
18857
18858 =item C<_restore_PERL5LIB>
18859
18860 =back
18861
18862 =over 4
18863
18864 =item Parsing
18865
18866 =over 4
18867
18868 =item C<_is_comment>
18869
18870 =back
18871
18872 =back
18873
18874 =over 4
18875
18876 =item C<_is_header>
18877
18878 =back
18879
18880 =over 4
18881
18882 =item C<_is_test>
18883
18884 =back
18885
18886 =over 4
18887
18888 =item C<_is_bail_out>
18889
18890 =back
18891
18892 =over 4
18893
18894 =item C<_reset_file_state>
18895
18896 =back
18897
18898 =over 4
18899
18900 =item Results
18901
18902 =over 4
18903
18904 =item C<_detailize>
18905
18906 =back
18907
18908 =back
18909
18910 =over 4
18911
18912 =item EXAMPLES
18913
18914 =item AUTHOR
18915
18916 =item SEE ALSO
18917
18918 =back
18919
18920 =head2 Test::More - yet another framework for writing test scripts
18921
18922 =over 4
18923
18924 =item SYNOPSIS
18925
18926 =item DESCRIPTION
18927
18928 =over 4
18929
18930 =item I love it when a plan comes together
18931
18932 =back
18933
18934 =back
18935
18936 =over 4
18937
18938 =item Test names
18939
18940 =item I'm ok, you're not ok.
18941
18942 B<ok>
18943
18944 =back
18945
18946 B<is>, B<isnt>
18947
18948 B<like>
18949
18950 B<unlike>
18951
18952 B<cmp_ok>
18953
18954 B<can_ok>
18955
18956 B<isa_ok>
18957
18958 B<pass>, B<fail>
18959
18960 =over 4
18961
18962 =item Diagnostics
18963
18964 B<diag>
18965
18966 =back
18967
18968 =over 4
18969
18970 =item Module tests
18971
18972 B<use_ok>
18973
18974 =back
18975
18976 B<require_ok>
18977
18978 =over 4
18979
18980 =item Conditional tests
18981
18982 B<SKIP: BLOCK>
18983
18984 =back
18985
18986 B<TODO: BLOCK>, B<todo_skip>
18987
18988 When do I use SKIP vs. TODO?
18989
18990 =over 4
18991
18992 =item Comparison functions
18993
18994 B<is_deeply>
18995
18996 =back
18997
18998 B<eq_array>
18999
19000 B<eq_hash>
19001
19002 B<eq_set>
19003
19004 =over 4
19005
19006 =item Extending and Embedding Test::More
19007
19008 B<builder>
19009
19010 =back
19011
19012 =over 4
19013
19014 =item NOTES
19015
19016 =item BUGS and CAVEATS
19017
19018 Making your own ok(), The eq_* family has some caveats, Test::Harness
19019 upgrades
19020
19021 =item HISTORY
19022
19023 =item SEE ALSO
19024
19025 =item AUTHORS
19026
19027 =item COPYRIGHT
19028
19029 =back
19030
19031 =head2 Test::Simple - Basic utilities for writing tests.
19032
19033 =over 4
19034
19035 =item SYNOPSIS
19036
19037 =item DESCRIPTION
19038
19039 B<ok>
19040
19041 =back
19042
19043 =over 4
19044
19045 =item EXAMPLE
19046
19047 =item CAVEATS
19048
19049 =item NOTES
19050
19051 =item HISTORY
19052
19053 =item SEE ALSO
19054
19055 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
19056 L<Test::Harness>
19057
19058 =item AUTHORS
19059
19060 =item COPYRIGHT
19061
19062 =back
19063
19064 =head2 Test::Tutorial - A tutorial about writing really basic tests
19065
19066 =over 4
19067
19068 =item DESCRIPTION
19069
19070 =over 4
19071
19072 =item Nuts and bolts of testing.
19073
19074 =item Where to start?
19075
19076 =item Names
19077
19078 =item Test the manual
19079
19080 =item Sometimes the tests are wrong
19081
19082 =item Testing lots of values
19083
19084 =item Informative names
19085
19086 =item Skipping tests
19087
19088 =item Todo tests
19089
19090 =item Testing with taint mode.
19091
19092 =back
19093
19094 =item FOOTNOTES
19095
19096 =item AUTHORS
19097
19098 =item COPYRIGHT
19099
19100 =back
19101
19102 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
19103
19104 =over 4
19105
19106 =item SYNOPSIS
19107
19108 =item DESCRIPTION
19109
19110 =item EXAMPLE
19111
19112 =back
19113
19114 =head2 Text::Balanced - Extract delimited text sequences from strings.
19115
19116 =over 4
19117
19118 =item SYNOPSIS
19119
19120 =item DESCRIPTION
19121
19122 =over 4
19123
19124 =item General behaviour in list contexts
19125
19126 [0], [1], [2]
19127
19128 =item General behaviour in scalar and void contexts
19129
19130 =item A note about prefixes
19131
19132 =item C<extract_delimited>
19133
19134 =item C<extract_bracketed>
19135
19136 =item C<extract_variable>
19137
19138 [0], [1], [2]
19139
19140 =item C<extract_tagged>
19141
19142 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
19143 [0], [1], [2], [3], [4], [5]
19144
19145 =item C<gen_extract_tagged>
19146
19147 =item C<extract_quotelike>
19148
19149 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
19150
19151 =item C<extract_quotelike> and "here documents"
19152
19153 [0], [1], [2], [3], [4], [5], [6], [7..10]
19154
19155 =item C<extract_codeblock>
19156
19157 =item C<extract_multiple>
19158
19159 =item C<gen_delimited_pat>
19160
19161 =back
19162
19163 =item DIAGNOSTICS
19164
19165  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
19166 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
19167 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
19168 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
19169 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
19170 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
19171 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
19172 after dereferencer>, C<Did not find expected opening bracket at %s>,
19173 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
19174 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
19175 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
19176 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
19177 tag>
19178
19179 =item AUTHOR
19180
19181 =item BUGS AND IRRITATIONS
19182
19183 =item COPYRIGHT
19184
19185 =back
19186
19187 =head2 Text::ParseWords - parse text into an array of tokens or array of
19188 arrays
19189
19190 =over 4
19191
19192 =item SYNOPSIS
19193
19194 =item DESCRIPTION
19195
19196 =item EXAMPLES
19197
19198 =item AUTHORS
19199
19200 =back
19201
19202 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
19203 by Knuth
19204
19205 =over 4
19206
19207 =item SYNOPSIS
19208
19209 =item DESCRIPTION
19210
19211 =item EXAMPLES
19212
19213 =item LIMITATIONS
19214
19215 =item AUTHOR
19216
19217 =back
19218
19219 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
19220 unexpand(1)
19221
19222 =over 4
19223
19224 =item SYNOPSIS
19225
19226 =item DESCRIPTION
19227
19228 =item BUGS
19229
19230 =item AUTHOR
19231
19232 =back
19233
19234 =head2 Text::Wrap - line wrapping to form simple paragraphs
19235
19236 =over 4
19237
19238 =item SYNOPSIS 
19239
19240 =item DESCRIPTION
19241
19242 =item OVERRIDES
19243
19244 =item EXAMPLE
19245
19246 =item AUTHOR
19247
19248 =back
19249
19250 =head2 Thread - manipulate threads in Perl (for old code only)
19251
19252 =over 4
19253
19254 =item CAVEAT
19255
19256 =item SYNOPSIS
19257
19258 =item DESCRIPTION
19259
19260 =item FUNCTIONS
19261
19262 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
19263 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
19264 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
19265
19266 =item METHODS
19267
19268 join, eval, detach, equal, tid, flags, done
19269
19270 =item LIMITATIONS
19271
19272 =item SEE ALSO
19273
19274 =back
19275
19276 =head2 Thread::Queue - thread-safe queues
19277
19278 =over 4
19279
19280 =item SYNOPSIS
19281
19282 =item DESCRIPTION
19283
19284 =item FUNCTIONS AND METHODS
19285
19286 new, enqueue LIST, dequeue, dequeue_nb, pending
19287
19288 =item SEE ALSO
19289
19290 =back
19291
19292 =head2 Thread::Semaphore - thread-safe semaphores
19293
19294 =over 4
19295
19296 =item SYNOPSIS
19297
19298 =item DESCRIPTION
19299
19300 =item FUNCTIONS AND METHODS
19301
19302 new, new NUMBER, down, down NUMBER, up, up NUMBER
19303
19304 =back
19305
19306 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
19307 (for old code)
19308
19309 =over 4
19310
19311 =item CAVEAT
19312
19313 =item SYNOPSIS
19314
19315 =item DESCRIPTION
19316
19317 =item BUGS
19318
19319 =back
19320
19321 =head2 Thread::Specific - thread-specific keys
19322
19323 =over 4
19324
19325 =item SYNOPSIS
19326
19327 =item DESCRIPTION
19328
19329 =back
19330
19331 =head2 Tie::Array - base class for tied arrays
19332
19333 =over 4
19334
19335 =item SYNOPSIS
19336
19337 =item DESCRIPTION
19338
19339 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19340 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19341 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19342 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19343
19344 =item CAVEATS
19345
19346 =item AUTHOR
19347
19348 =back
19349
19350 =head2 Tie::File - Access the lines of a disk file via a Perl array
19351
19352 =over 4
19353
19354 =item SYNOPSIS
19355
19356 =item DESCRIPTION
19357
19358 =over 4
19359
19360 =item C<recsep>
19361
19362 =item C<autochomp>
19363
19364 =item C<mode>
19365
19366 =item C<memory>
19367
19368 =item C<dw_size>
19369
19370 =item Option Format
19371
19372 =back
19373
19374 =item Public Methods
19375
19376 =over 4
19377
19378 =item C<flock>
19379
19380 =item C<autochomp>
19381
19382 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19383
19384 =item C<offset>
19385
19386 =back
19387
19388 =item Tying to an already-opened filehandle
19389
19390 =item Deferred Writing
19391
19392 =over 4
19393
19394 =item Autodeferring
19395
19396 =back
19397
19398 =item CONCURRENT ACCESS TO FILES
19399
19400 =item CAVEATS
19401
19402 =item SUBCLASSING
19403
19404 =item WHAT ABOUT C<DB_File>?
19405
19406 =item AUTHOR
19407
19408 =item LICENSE
19409
19410 =item WARRANTY
19411
19412 =item THANKS
19413
19414 =item TODO
19415
19416 =back
19417
19418 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19419 handles
19420
19421 =over 4
19422
19423 =item SYNOPSIS
19424
19425 =item DESCRIPTION
19426
19427 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19428 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19429 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19430 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19431
19432 =item MORE INFORMATION
19433
19434 =item COMPATIBILITY
19435
19436 =back
19437
19438 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19439 tied hashes
19440
19441 =over 4
19442
19443 =item SYNOPSIS
19444
19445 =item DESCRIPTION
19446
19447 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19448 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
19449 this, SCALAR this
19450
19451 =item Inheriting from B<Tie::StdHash>
19452
19453 =item Inheriting from B<Tie::ExtraHash>
19454
19455 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
19456
19457 =item MORE INFORMATION
19458
19459 =back
19460
19461 =head2 Tie::Memoize - add data to hash when needed
19462
19463 =over 4
19464
19465 =item SYNOPSIS
19466
19467 =item DESCRIPTION
19468
19469 =item Inheriting from B<Tie::Memoize>
19470
19471 =item EXAMPLE
19472
19473 =item BUGS
19474
19475 =item AUTHOR
19476
19477 =back
19478
19479 =head2 Tie::RefHash - use references as hash keys
19480
19481 =over 4
19482
19483 =item SYNOPSIS
19484
19485 =item DESCRIPTION
19486
19487 =item EXAMPLE
19488
19489 =item AUTHOR
19490
19491 =item VERSION
19492
19493 =item SEE ALSO
19494
19495 =back
19496
19497 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19498 scalars
19499
19500 =over 4
19501
19502 =item SYNOPSIS
19503
19504 =item DESCRIPTION
19505
19506 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19507
19508 =item MORE INFORMATION
19509
19510 =back
19511
19512 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19513
19514 =over 4
19515
19516 =item SYNOPSIS
19517
19518 =item DESCRIPTION
19519
19520 =item CAVEATS
19521
19522 =back
19523
19524 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19525 timers
19526
19527 =over 4
19528
19529 =item SYNOPSIS
19530
19531 =item DESCRIPTION
19532
19533 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19534 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19535 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
19536 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
19537 $which )
19538
19539 =item EXAMPLES
19540
19541 =item C API
19542
19543 =item DIAGNOSTICS
19544
19545 =over 4
19546
19547 =item negative time not invented yet
19548
19549 =item internal error: useconds < 0 (unsigned ... signed ...)
19550
19551 =back
19552
19553 =item CAVEATS
19554
19555 =item AUTHORS
19556
19557 =item COPYRIGHT AND LICENSE
19558
19559 =back
19560
19561 =head2 Time::Local - efficiently compute time from local and GMT time
19562
19563 =over 4
19564
19565 =item SYNOPSIS
19566
19567 =item DESCRIPTION
19568
19569 =over 4
19570
19571 =item Ambiguous Local Times (DST)
19572
19573 =item Negative Epoch Values
19574
19575 =back
19576
19577 =item IMPLEMENTATION
19578
19579 =item BUGS
19580
19581 =item SUPPORT
19582
19583 =item AUTHOR
19584
19585 =back
19586
19587 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19588 function
19589
19590 =over 4
19591
19592 =item SYNOPSIS
19593
19594 =item DESCRIPTION
19595
19596 =item NOTE
19597
19598 =item AUTHOR
19599
19600 =back
19601
19602 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19603 function
19604
19605 =over 4
19606
19607 =item SYNOPSIS
19608
19609 =item DESCRIPTION
19610
19611 =item NOTE
19612
19613 =item AUTHOR
19614
19615 =back
19616
19617 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19618
19619 =over 4
19620
19621 =item SYNOPSIS
19622
19623 =item DESCRIPTION
19624
19625 =item AUTHOR
19626
19627 =back
19628
19629 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19630
19631 =over 4
19632
19633 =item SYNOPSIS
19634
19635 =item DESCRIPTION
19636
19637 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
19638 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
19639 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
19640
19641 =item EXPORTS
19642
19643 =back
19644
19645 =head2 Unicode::Collate - Unicode Collation Algorithm
19646
19647 =over 4
19648
19649 =item SYNOPSIS
19650
19651 =item DESCRIPTION
19652
19653 =over 4
19654
19655 =item Constructor and Tailoring
19656
19657 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
19658 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
19659 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
19660 variable, alternate
19661
19662 =item Methods for Collation
19663
19664 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19665 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19666 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19667 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19668 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19669 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19670 $Collator-E<gt>viewSortKey($string)>
19671
19672 =item Methods for Searching
19673
19674 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
19675 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
19676 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
19677 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
19678 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
19679 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
19680 $Collator-E<gt>gsubst($string, $substring, $replacement)>
19681
19682 =item Other Methods
19683
19684 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
19685 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
19686
19687 =item EXPORT
19688
19689 =item CAVEAT
19690
19691 =item Conformance Test
19692
19693 =back
19694
19695 =item AUTHOR
19696
19697 =item SEE ALSO
19698
19699 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
19700 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
19701 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
19702
19703 =back
19704
19705 =head2 Unicode::Normalize - Unicode Normalization Forms
19706
19707 =over 4
19708
19709 =item SYNOPSIS
19710
19711 =item DESCRIPTION
19712
19713 =over 4
19714
19715 =item Normalization Forms
19716
19717 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19718 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19719 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
19720 C<$normalized_string = normalize($form_name, $string)>
19721
19722 =item Decomposition and Composition
19723
19724 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19725 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19726 reorder($string)>, C<$composed_string   = compose($string)>
19727
19728 =item Quick Check
19729
19730 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19731 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19732 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
19733 check($form_name, $string)>
19734
19735 =item Character Data
19736
19737 C<$canonical_decomposed = getCanon($codepoint)>,
19738 C<$compatibility_decomposed = getCompat($codepoint)>,
19739 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19740 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19741 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19742 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
19743 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19744
19745 =item EXPORT
19746
19747 =back
19748
19749 =item AUTHOR
19750
19751 =item SEE ALSO
19752
19753 http://www.unicode.org/reports/tr15/,
19754 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
19755 http://www.unicode.org/notes/tn5/
19756
19757 =back
19758
19759 =head2 Unicode::UCD - Unicode character database
19760
19761 =over 4
19762
19763 =item SYNOPSIS
19764
19765 =item DESCRIPTION
19766
19767 =back
19768
19769 =over 4
19770
19771 =item charinfo
19772
19773 =back
19774
19775 =over 4
19776
19777 =item charblock
19778
19779 =back
19780
19781 =over 4
19782
19783 =item charscript
19784
19785 =back
19786
19787 =over 4
19788
19789 =item charblocks
19790
19791 =back
19792
19793 =over 4
19794
19795 =item charscripts
19796
19797 =back
19798
19799 =over 4
19800
19801 =item Blocks versus Scripts
19802
19803 =item Matching Scripts and Blocks
19804
19805 =item Code Point Arguments
19806
19807 =item charinrange
19808
19809 =back
19810
19811 =over 4
19812
19813 =item compexcl
19814
19815 =back
19816
19817 =over 4
19818
19819 =item casefold
19820
19821 =back
19822
19823 =over 4
19824
19825 =item casespec
19826
19827 =back
19828
19829 =over 4
19830
19831 =item Unicode::UCD::UnicodeVersion
19832
19833 =back
19834
19835 =over 4
19836
19837 =item Implementation Note
19838
19839 =back
19840
19841 =over 4
19842
19843 =item BUGS
19844
19845 =item AUTHOR
19846
19847 =back
19848
19849 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19850 functions
19851
19852 =over 4
19853
19854 =item SYNOPSIS
19855
19856 =item DESCRIPTION
19857
19858 =item NOTE
19859
19860 =item AUTHOR
19861
19862 =back
19863
19864 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19865 functions
19866
19867 =over 4
19868
19869 =item SYNOPSIS
19870
19871 =item DESCRIPTION
19872
19873 =over 4
19874
19875 =item System Specifics
19876
19877 =back
19878
19879 =item NOTE
19880
19881 =item AUTHOR
19882
19883 =item HISTORY
19884
19885 March 18th, 2000
19886
19887 =back
19888
19889 =head2 Win32 - Interfaces to some Win32 API Functions
19890
19891 =over 4
19892
19893 =item DESCRIPTION
19894
19895 =over 4
19896
19897 =item Alphabetical Listing of Win32 Functions
19898
19899 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19900 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19901 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19902 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19903 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
19904 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
19905 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
19906 Win32::GetOSVersion(), Win32::GetOSName(),
19907 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19908 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19909 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19910 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19911 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19912 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19913 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19914 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19915 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19916 Win32::UnregisterServer(LIBRARYNAME)
19917
19918 =back
19919
19920 =back
19921
19922 =head2 XSLoader - Dynamically load C libraries into Perl code
19923
19924 =over 4
19925
19926 =item SYNOPSIS
19927
19928 =item DESCRIPTION
19929
19930 =over 4
19931
19932 =item Migration from C<DynaLoader>
19933
19934 =item Backward compatible boilerplate
19935
19936 =back
19937
19938 =item Order of initialization: early load()
19939
19940 =over 4
19941
19942 =item The most hairy case
19943
19944 =back
19945
19946 =item LIMITATIONS
19947
19948 =item AUTHOR
19949
19950 =back
19951
19952 =head1 AUXILIARY DOCUMENTATION
19953
19954 Here should be listed all the extra programs' documentation, but they
19955 don't all have manual pages yet:
19956
19957 =over 4
19958
19959 =item a2p
19960
19961 =item c2ph
19962
19963 =item dprofpp
19964
19965 =item h2ph
19966
19967 =item h2xs
19968
19969 =item perlbug
19970
19971 =item perldoc
19972
19973 =item pl2pm
19974
19975 =item pod2html
19976
19977 =item pod2man
19978
19979 =item s2p
19980
19981 =item splain
19982
19983 =item xsubpp
19984
19985 =back
19986
19987 =head1 AUTHOR
19988
19989 Larry Wall <F<larry@wall.org>>, with the help of oodles
19990 of other folks.
19991