This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Rebuild table of contents and re-sort MANIFEST
[perl5.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 Range Operators
1797
1798 =item Conditional Operator
1799
1800 =item Assignment Operators
1801
1802 =item Comma Operator
1803
1804 =item List Operators (Rightward)
1805
1806 =item Logical Not
1807
1808 =item Logical And
1809
1810 =item Logical or and Exclusive Or
1811
1812 =item C Operators Missing From Perl
1813
1814 unary &, unary *, (TYPE)
1815
1816 =item Quote and Quote-like Operators
1817
1818 =item Regexp Quote-Like Operators
1819
1820 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1821 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1822 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1823 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1824
1825 =item Gory details of parsing quoted constructs
1826
1827 Finding the end, Removal of backslashes before delimiters, Interpolation,
1828 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1829 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1830 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1831 regular expressions
1832
1833 =item I/O Operators
1834
1835 =item Constant Folding
1836
1837 =item No-ops
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, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
1992 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
1993 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
1994 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>, B<-C [I<number/list>]>, B<-c>, B<-d>,
2252 B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e>
2253 I<commandline>, B<-F>I<pattern>, B<-h>, B<-i>[I<extension>],
2254 B<-I>I<directory>, B<-l>[I<octnum>], B<-m>[B<->]I<module>,
2255 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<configvar>, B<-w>, B<-W>,
2258 B<-X>, 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_ALLOW_NON_IFS_LSP
2267 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL,
2268 PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
2269 PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
2270 (specific to the VMS port)
2271
2272 =back
2273
2274 =head2 perldiag - various Perl diagnostics
2275
2276 =over 4
2277
2278 =item DESCRIPTION
2279
2280 =back
2281
2282 =head2 perllexwarn - Perl Lexical Warnings
2283
2284 =over 4
2285
2286 =item DESCRIPTION
2287
2288 =over 4
2289
2290 =item Default Warnings and Optional Warnings
2291
2292 =item What's wrong with B<-w> and C<$^W>
2293
2294 =item Controlling Warnings from the Command Line
2295
2296 B<-w>, B<-W>, B<-X>
2297
2298 =item Backward Compatibility
2299
2300 =item Category Hierarchy
2301
2302 =item Fatal Warnings
2303
2304 =item Reporting Warnings from a Module
2305
2306 =back
2307
2308 =item TODO
2309
2310 =item SEE ALSO
2311
2312 =item AUTHOR
2313
2314 =back
2315
2316 =head2 perldebug - Perl debugging
2317
2318 =over 4
2319
2320 =item DESCRIPTION
2321
2322 =item The Perl Debugger
2323
2324 =over 4
2325
2326 =item Debugger Commands
2327
2328 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2329 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2330 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2331 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2332 subname [condition], b postpone subname [condition], b load filename, b
2333 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2334 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2335 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2336 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2337 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2338 [manpage]
2339
2340 =item Configurable Options
2341
2342 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2343 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2344 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2345 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2346 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2347 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2348 C<NonStop>
2349
2350 =item Debugger input/output
2351
2352 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2353 listing
2354
2355 =item Debugging compile-time statements
2356
2357 =item Debugger Customization
2358
2359 =item Readline Support
2360
2361 =item Editor Support for Debugging
2362
2363 =item The Perl Profiler
2364
2365 =back
2366
2367 =item Debugging regular expressions
2368
2369 =item Debugging memory usage
2370
2371 =item SEE ALSO
2372
2373 =item BUGS
2374
2375 =back
2376
2377 =head2 perlvar - Perl predefined variables
2378
2379 =over 4
2380
2381 =item DESCRIPTION
2382
2383 =over 4
2384
2385 =item Predefined Names
2386
2387 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2388 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $*,
2389 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2390 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2391 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2392 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2393 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2394 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2395 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2396 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2397 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2398 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2399 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2400 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2401 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2402 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2403 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2404 IO::Handle->format_line_break_characters EXPR,
2405 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2406 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2407 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2408 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2409 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2410 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2411 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2412 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2413 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2414 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2415 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2416 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2417 $SIG{expr}
2418
2419 =item Error Indicators
2420
2421 =item Technical Note on the Syntax of Variable Names
2422
2423 =back
2424
2425 =item BUGS
2426
2427 =back
2428
2429 =head2 perlre - Perl regular expressions
2430
2431 =over 4
2432
2433 =item DESCRIPTION
2434
2435 i, m, s, x
2436
2437 =over 4
2438
2439 =item Regular Expressions
2440
2441 [1], [2], [3], cntrl, graph, print, punct, xdigit
2442
2443 =item Extended Patterns
2444
2445 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2446 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2447 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2448 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2449
2450 =item Backtracking
2451
2452 =item Version 8 Regular Expressions
2453
2454 =item Warning on \1 vs $1
2455
2456 =item Repeated patterns matching zero-length substring
2457
2458 =item Combining pieces together
2459
2460 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2461 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2462 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2463 C<(?(condition)yes-pattern|no-pattern)>
2464
2465 =item Creating custom RE engines
2466
2467 =back
2468
2469 =item BUGS
2470
2471 =item SEE ALSO
2472
2473 =back
2474
2475 =head2 perlreref - Perl Regular Expressions Reference
2476
2477 =over 4
2478
2479 =item DESCRIPTION
2480
2481 =over 4
2482
2483 =item OPERATORS
2484
2485 =item SYNTAX
2486
2487 =item ESCAPE SEQUENCES
2488
2489 =item CHARACTER CLASSES
2490
2491 =item ANCHORS
2492
2493 =item QUANTIFIERS
2494
2495 =item EXTENDED CONSTRUCTS
2496
2497 =item VARIABLES
2498
2499 =item FUNCTIONS
2500
2501 =item TERMINOLOGY
2502
2503 =back
2504
2505 =item AUTHOR
2506
2507 =item SEE ALSO
2508
2509 =item THANKS
2510
2511 =back
2512
2513 =head2 perlref - Perl references and nested data structures
2514
2515 =over 4
2516
2517 =item NOTE
2518
2519 =item DESCRIPTION
2520
2521 =over 4
2522
2523 =item Making References
2524
2525 =item Using References
2526
2527 =item Symbolic references
2528
2529 =item Not-so-symbolic references
2530
2531 =item Pseudo-hashes: Using an array as a hash
2532
2533 =item Function Templates
2534
2535 =back
2536
2537 =item WARNING
2538
2539 =item SEE ALSO
2540
2541 =back
2542
2543 =head2 perlform - Perl formats
2544
2545 =over 4
2546
2547 =item DESCRIPTION
2548
2549 =over 4
2550
2551 =item Text Fields
2552
2553 =item Numeric Fields
2554
2555 =item The Field @* for Variable Width Multi-Line Text
2556
2557 =item The Field ^* for Variable Width One-line-at-a-time Text
2558
2559 =item Specifying Values
2560
2561 =item Using Fill Mode
2562
2563 =item Suppressing Lines Where All Fields Are Void
2564
2565 =item Repeating Format Lines
2566
2567 =item Top of Form Processing
2568
2569 =item Format Variables
2570
2571 =back
2572
2573 =item NOTES
2574
2575 =over 4
2576
2577 =item Footers
2578
2579 =item Accessing Formatting Internals
2580
2581 =back
2582
2583 =item WARNINGS
2584
2585 =back
2586
2587 =head2 perlobj - Perl objects
2588
2589 =over 4
2590
2591 =item DESCRIPTION
2592
2593 =over 4
2594
2595 =item An Object is Simply a Reference
2596
2597 =item A Class is Simply a Package
2598
2599 =item A Method is Simply a Subroutine
2600
2601 =item Method Invocation
2602
2603 =item Indirect Object Syntax
2604
2605 =item Default UNIVERSAL methods
2606
2607 isa(CLASS), can(METHOD), VERSION( [NEED] )
2608
2609 =item Destructors
2610
2611 =item Summary
2612
2613 =item Two-Phased Garbage Collection
2614
2615 =back
2616
2617 =item SEE ALSO
2618
2619 =back
2620
2621 =head2 perltie - how to hide an object class in a simple variable
2622
2623 =over 4
2624
2625 =item SYNOPSIS
2626
2627 =item DESCRIPTION
2628
2629 =over 4
2630
2631 =item Tying Scalars
2632
2633 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2634 DESTROY this
2635
2636 =item Tying Arrays
2637
2638 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2639 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2640 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2641 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2642 this
2643
2644 =item Tying Hashes
2645
2646 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2647 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2648 this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
2649
2650 =item Tying FileHandles
2651
2652 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2653 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2654 DESTROY this
2655
2656 =item UNTIE this
2657
2658 =item The C<untie> Gotcha
2659
2660 =back
2661
2662 =item SEE ALSO
2663
2664 =item BUGS
2665
2666 =item AUTHOR
2667
2668 =back
2669
2670 =head2 perldbmfilter - Perl DBM Filters
2671
2672 =over 4
2673
2674 =item SYNOPSIS
2675
2676 =item DESCRIPTION
2677
2678 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2679 B<filter_fetch_value>
2680
2681 =over 4
2682
2683 =item The Filter
2684
2685 =item An Example -- the NULL termination problem.
2686
2687 =item Another Example -- Key is a C int.
2688
2689 =back
2690
2691 =item SEE ALSO
2692
2693 =item AUTHOR
2694
2695 =back
2696
2697 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2698 safe subprocesses, sockets, and semaphores)
2699
2700 =over 4
2701
2702 =item DESCRIPTION
2703
2704 =item Signals
2705
2706 =over 4
2707
2708 =item Handling the SIGHUP Signal in Daemons
2709
2710 =back
2711
2712 =item Named Pipes
2713
2714 =over 4
2715
2716 =item Deferred Signals (Safe Signals)
2717
2718 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2719 "faults", Signals triggered by operating system state
2720
2721 =back
2722
2723 =item Using open() for IPC
2724
2725 =over 4
2726
2727 =item Filehandles
2728
2729 =item Background Processes
2730
2731 =item Complete Dissociation of Child from Parent
2732
2733 =item Safe Pipe Opens
2734
2735 =item Bidirectional Communication with Another Process
2736
2737 =item Bidirectional Communication with Yourself
2738
2739 =back
2740
2741 =item Sockets: Client/Server Communication
2742
2743 =over 4
2744
2745 =item Internet Line Terminators
2746
2747 =item Internet TCP Clients and Servers
2748
2749 =item Unix-Domain TCP Clients and Servers
2750
2751 =back
2752
2753 =item TCP Clients with IO::Socket
2754
2755 =over 4
2756
2757 =item A Simple Client
2758
2759 C<Proto>, C<PeerAddr>, C<PeerPort>
2760
2761 =item A Webget Client
2762
2763 =item Interactive Client with IO::Socket
2764
2765 =back
2766
2767 =item TCP Servers with IO::Socket
2768
2769 Proto, LocalPort, Listen, Reuse
2770
2771 =item UDP: Message Passing
2772
2773 =item SysV IPC
2774
2775 =item NOTES
2776
2777 =item BUGS
2778
2779 =item AUTHOR
2780
2781 =item SEE ALSO
2782
2783 =back
2784
2785 =head2 perlfork - Perl's fork() emulation
2786
2787 =over 4
2788
2789 =item SYNOPSIS
2790
2791 =item DESCRIPTION
2792
2793 =over 4
2794
2795 =item Behavior of other Perl features in forked pseudo-processes
2796
2797 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2798 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2799 files, directories and network sockets
2800
2801 =item Resource limits
2802
2803 =item Killing the parent process
2804
2805 =item Lifetime of the parent process and pseudo-processes
2806
2807 =item CAVEATS AND LIMITATIONS
2808
2809 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2810 Global state maintained by XSUBs, Interpreter embedded in larger
2811 application, Thread-safety of extensions
2812
2813 =back
2814
2815 =item BUGS
2816
2817 =item AUTHOR
2818
2819 =item SEE ALSO
2820
2821 =back
2822
2823 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2824
2825 =over 4
2826
2827 =item SYNOPSIS
2828
2829 =item DESCRIPTION
2830
2831 =item Storing numbers
2832
2833 =item Numeric operators and numeric conversions
2834
2835 =item Flavors of Perl numeric operations
2836
2837 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2838 mathematical operators, Bitwise operators, Bitwise operators during C<use
2839 integer>, Operators which expect an integer, Operators which expect a
2840 string
2841
2842 =item AUTHOR
2843
2844 =item SEE ALSO
2845
2846 =back
2847
2848 =head2 perlthrtut - tutorial on threads in Perl
2849
2850 =over 4
2851
2852 =item DESCRIPTION
2853
2854 =item Status
2855
2856 =item What Is A Thread Anyway?
2857
2858 =item Threaded Program Models
2859
2860 =over 4
2861
2862 =item Boss/Worker
2863
2864 =item Work Crew
2865
2866 =item Pipeline
2867
2868 =back
2869
2870 =item What kind of threads are Perl threads?
2871
2872 =item Thread-Safe Modules
2873
2874 =item Thread Basics
2875
2876 =over 4
2877
2878 =item Basic Thread Support
2879
2880 =item A Note about the Examples
2881
2882 =item Creating Threads
2883
2884 =item Waiting For A Thread To Exit
2885
2886 =item Ignoring A Thread
2887
2888 =back
2889
2890 =item Threads And Data
2891
2892 =over 4
2893
2894 =item Shared And Unshared Data
2895
2896 =item Thread Pitfalls: Races
2897
2898 =back
2899
2900 =item Synchronization and control
2901
2902 =over 4
2903
2904 =item Controlling access: lock()
2905
2906 =item A Thread Pitfall: Deadlocks
2907
2908 =item Queues: Passing Data Around
2909
2910 =item Semaphores: Synchronizing Data Access
2911
2912 =item Basic semaphores
2913
2914 =item Advanced Semaphores
2915
2916 =item cond_wait() and cond_signal()
2917
2918 =item Giving up control
2919
2920 =back
2921
2922 =item General Thread Utility Routines
2923
2924 =over 4
2925
2926 =item What Thread Am I In?
2927
2928 =item Thread IDs
2929
2930 =item Are These Threads The Same?
2931
2932 =item What Threads Are Running?
2933
2934 =back
2935
2936 =item A Complete Example
2937
2938 =item Different implementations of threads
2939
2940 =item Performance considerations
2941
2942 =item Process-scope Changes
2943
2944 =item Thread-Safety of System Libraries
2945
2946 =item Conclusion
2947
2948 =item Bibliography
2949
2950 =over 4
2951
2952 =item Introductory Texts
2953
2954 =item OS-Related References
2955
2956 =item Other References
2957
2958 =back
2959
2960 =item Acknowledgements
2961
2962 =item AUTHOR
2963
2964 =item Copyrights
2965
2966 =back
2967
2968 =head2 perlothrtut - old tutorial on threads in Perl
2969
2970 =over 4
2971
2972 =item DESCRIPTION
2973
2974 =item What Is A Thread Anyway?
2975
2976 =item Threaded Program Models
2977
2978 =over 4
2979
2980 =item Boss/Worker
2981
2982 =item Work Crew
2983
2984 =item Pipeline
2985
2986 =back
2987
2988 =item Native threads
2989
2990 =item What kind of threads are perl threads?
2991
2992 =item Threadsafe Modules
2993
2994 =item Thread Basics
2995
2996 =over 4
2997
2998 =item Basic Thread Support
2999
3000 =item Creating Threads
3001
3002 =item Giving up control
3003
3004 =item Waiting For A Thread To Exit
3005
3006 =item Errors In Threads
3007
3008 =item Ignoring A Thread
3009
3010 =back
3011
3012 =item Threads And Data
3013
3014 =over 4
3015
3016 =item Shared And Unshared Data
3017
3018 =item Thread Pitfall: Races
3019
3020 =item Controlling access: lock()
3021
3022 =item Thread Pitfall: Deadlocks
3023
3024 =item Queues: Passing Data Around
3025
3026 =back
3027
3028 =item Threads And Code
3029
3030 =over 4
3031
3032 =item Semaphores: Synchronizing Data Access
3033
3034 Basic semaphores, Advanced Semaphores
3035
3036 =item Attributes: Restricting Access To Subroutines
3037
3038 =item Subroutine Locks
3039
3040 =item Methods
3041
3042 =item Locking A Subroutine
3043
3044 =back
3045
3046 =item General Thread Utility Routines
3047
3048 =over 4
3049
3050 =item What Thread Am I In?
3051
3052 =item Thread IDs
3053
3054 =item Are These Threads The Same?
3055
3056 =item What Threads Are Running?
3057
3058 =back
3059
3060 =item A Complete Example
3061
3062 =item Conclusion
3063
3064 =item Bibliography
3065
3066 =over 4
3067
3068 =item Introductory Texts
3069
3070 =item OS-Related References
3071
3072 =item Other References
3073
3074 =back
3075
3076 =item Acknowledgements
3077
3078 =item AUTHOR
3079
3080 =item Copyrights
3081
3082 =back
3083
3084 =head2 perlport - Writing portable Perl
3085
3086 =over 4
3087
3088 =item DESCRIPTION
3089
3090 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3091 portable
3092
3093 =item ISSUES
3094
3095 =over 4
3096
3097 =item Newlines
3098
3099 =item Numbers endianness and Width
3100
3101 =item Files and Filesystems
3102
3103 =item System Interaction
3104
3105 =item Command names versus file pathnames
3106
3107 =item Networking
3108
3109 =item Interprocess Communication (IPC)
3110
3111 =item External Subroutines (XS)
3112
3113 =item Standard Modules
3114
3115 =item Time and Date
3116
3117 =item Character sets and character encoding
3118
3119 =item Internationalisation
3120
3121 =item System Resources
3122
3123 =item Security
3124
3125 =item Style
3126
3127 =back
3128
3129 =item CPAN Testers
3130
3131 Mailing list: cpan-testers@perl.org, Testing results:
3132 http://testers.cpan.org/
3133
3134 =item PLATFORMS
3135
3136 =over 4
3137
3138 =item Unix
3139
3140 =item DOS and Derivatives
3141
3142 =item S<Mac OS>
3143
3144 =item VMS
3145
3146 =item VOS
3147
3148 =item EBCDIC Platforms
3149
3150 =item Acorn RISC OS
3151
3152 =item Other perls
3153
3154 =back
3155
3156 =item FUNCTION IMPLEMENTATIONS
3157
3158 =over 4
3159
3160 =item Alphabetical Listing of Perl Functions
3161
3162 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3163 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3164 HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
3165 FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
3166 getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
3167 getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
3168 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
3169 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
3170 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3171 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3172 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3173 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3174 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3175 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3176 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3177 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3178 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3179 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3180 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3181 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3182 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3183 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3184 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3185 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3186 wait, waitpid PID,FLAGS
3187
3188 =back
3189
3190 =item CHANGES
3191
3192 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
3193 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
3194 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
3195 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
3196 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
3197 v1.30, 03 August 1998, v1.23, 10 July 1998
3198
3199 =item Supported Platforms
3200
3201 =item SEE ALSO
3202
3203 =item AUTHORS / CONTRIBUTORS
3204
3205 =back
3206
3207 =head2 perllocale - Perl locale handling (internationalization and
3208 localization)
3209
3210 =over 4
3211
3212 =item DESCRIPTION
3213
3214 =item PREPARING TO USE LOCALES
3215
3216 =item USING LOCALES
3217
3218 =over 4
3219
3220 =item The use locale pragma
3221
3222 =item The setlocale function
3223
3224 =item Finding locales
3225
3226 =item LOCALE PROBLEMS
3227
3228 =item Temporarily fixing locale problems
3229
3230 =item Permanently fixing locale problems
3231
3232 =item Permanently fixing your system's locale configuration
3233
3234 =item Fixing system locale configuration
3235
3236 =item The localeconv function
3237
3238 =item I18N::Langinfo
3239
3240 =back
3241
3242 =item LOCALE CATEGORIES
3243
3244 =over 4
3245
3246 =item Category LC_COLLATE: Collation
3247
3248 =item Category LC_CTYPE: Character Types
3249
3250 =item Category LC_NUMERIC: Numeric Formatting
3251
3252 =item Category LC_MONETARY: Formatting of monetary amounts
3253
3254 =item LC_TIME
3255
3256 =item Other categories
3257
3258 =back
3259
3260 =item SECURITY
3261
3262 =item ENVIRONMENT
3263
3264 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3265 LC_NUMERIC, LC_TIME, LANG
3266
3267 =item NOTES
3268
3269 =over 4
3270
3271 =item Backward compatibility
3272
3273 =item I18N:Collate obsolete
3274
3275 =item Sort speed and memory use impacts
3276
3277 =item write() and LC_NUMERIC
3278
3279 =item Freely available locale definitions
3280
3281 =item I18n and l10n
3282
3283 =item An imperfect standard
3284
3285 =back
3286
3287 =item Unicode and UTF-8
3288
3289 =item BUGS
3290
3291 =over 4
3292
3293 =item Broken systems
3294
3295 =back
3296
3297 =item SEE ALSO
3298
3299 =item HISTORY
3300
3301 =back
3302
3303 =head2 perluniintro - Perl Unicode introduction
3304
3305 =over 4
3306
3307 =item DESCRIPTION
3308
3309 =over 4
3310
3311 =item Unicode
3312
3313 =item Perl's Unicode Support
3314
3315 =item Perl's Unicode Model
3316
3317 =item Unicode and EBCDIC
3318
3319 =item Creating Unicode
3320
3321 =item Handling Unicode
3322
3323 =item Legacy Encodings
3324
3325 =item Unicode I/O
3326
3327 =item Displaying Unicode As Text
3328
3329 =item Special Cases
3330
3331 =item Advanced Topics
3332
3333 =item Miscellaneous
3334
3335 =item Questions With Answers
3336
3337 =item Hexadecimal Notation
3338
3339 =item Further Resources
3340
3341 =back
3342
3343 =item UNICODE IN OLDER PERLS
3344
3345 =item SEE ALSO
3346
3347 =item ACKNOWLEDGMENTS
3348
3349 =item AUTHOR, COPYRIGHT, AND LICENSE
3350
3351 =back
3352
3353 =head2 perlunicode - Unicode support in Perl
3354
3355 =over 4
3356
3357 =item DESCRIPTION
3358
3359 =over 4
3360
3361 =item Important Caveats
3362
3363 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3364 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3365 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3366
3367 =item Byte and Character Semantics
3368
3369 =item Effects of Character Semantics
3370
3371 =item Scripts
3372
3373 =item Blocks
3374
3375 =item User-Defined Character Properties
3376
3377 =item Character Encodings for Input and Output
3378
3379 =item Unicode Regular Expression Support Level
3380
3381 =item Unicode Encodings
3382
3383 =item Security Implications of Unicode
3384
3385 =item Unicode in Perl on EBCDIC
3386
3387 =item Locales
3388
3389 =item When Unicode Does Not Happen
3390
3391 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3392
3393 =item Using Unicode in XS
3394
3395 =back
3396
3397 =item BUGS
3398
3399 =over 4
3400
3401 =item Interaction with Locales
3402
3403 =item Interaction with Extensions
3404
3405 =item Speed
3406
3407 =item Porting code from perl-5.6.X
3408
3409 =back
3410
3411 =item SEE ALSO
3412
3413 =back
3414
3415 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3416
3417 =over 4
3418
3419 =item DESCRIPTION
3420
3421 =item COMMON CHARACTER CODE SETS
3422
3423 =over 4
3424
3425 =item ASCII
3426
3427 =item ISO 8859
3428
3429 =item Latin 1 (ISO 8859-1)
3430
3431 =item EBCDIC
3432
3433 =item 13 variant characters
3434
3435 =item 0037
3436
3437 =item 1047
3438
3439 =item POSIX-BC
3440
3441 =item Unicode code points versus EBCDIC code points
3442
3443 =item Remaining Perl Unicode problems in EBCDIC
3444
3445 =item Unicode and UTF
3446
3447 =item Using Encode
3448
3449 =back
3450
3451 =item SINGLE OCTET TABLES
3452
3453 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3454
3455 =item IDENTIFYING CHARACTER CODE SETS
3456
3457 =item CONVERSIONS
3458
3459 =over 4
3460
3461 =item tr///
3462
3463 =item iconv
3464
3465 =item C RTL
3466
3467 =back
3468
3469 =item OPERATOR DIFFERENCES
3470
3471 =item FUNCTION DIFFERENCES
3472
3473 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3474
3475 =item REGULAR EXPRESSION DIFFERENCES
3476
3477 =item SOCKETS
3478
3479 =item SORTING
3480
3481 =over 4
3482
3483 =item Ignore ASCII vs. EBCDIC sort differences.
3484
3485 =item MONO CASE then sort data.
3486
3487 =item Convert, sort data, then re convert.
3488
3489 =item Perform sorting on one type of machine only.
3490
3491 =back
3492
3493 =item TRANSFORMATION FORMATS
3494
3495 =over 4
3496
3497 =item URL decoding and encoding
3498
3499 =item uu encoding and decoding
3500
3501 =item Quoted-Printable encoding and decoding
3502
3503 =item Caesarian ciphers
3504
3505 =back
3506
3507 =item Hashing order and checksums
3508
3509 =item I18N AND L10N
3510
3511 =item MULTI OCTET CHARACTER SETS
3512
3513 =item OS ISSUES
3514
3515 =over 4
3516
3517 =item OS/400
3518
3519 PASE, IFS access
3520
3521 =item OS/390, z/OS
3522
3523 chcp, dataset access, OS/390, z/OS iconv, locales
3524
3525 =item VM/ESA?
3526
3527 =item POSIX-BC?
3528
3529 =back
3530
3531 =item BUGS
3532
3533 =item SEE ALSO
3534
3535 =item REFERENCES
3536
3537 =item HISTORY
3538
3539 =item AUTHOR
3540
3541 =back
3542
3543 =head2 perlsec - Perl security
3544
3545 =over 4
3546
3547 =item DESCRIPTION
3548
3549 =over 4
3550
3551 =item Laundering and Detecting Tainted Data
3552
3553 =item Switches On the "#!" Line
3554
3555 =item Taint mode and @INC
3556
3557 =item Cleaning Up Your Path
3558
3559 =item Security Bugs
3560
3561 =item Protecting Your Programs
3562
3563 =item Unicode
3564
3565 =item Algorithmic Complexity Attacks
3566
3567 =back
3568
3569 =item SEE ALSO
3570
3571 =back
3572
3573 =head2 perlmod - Perl modules (packages and symbol tables)
3574
3575 =over 4
3576
3577 =item DESCRIPTION
3578
3579 =over 4
3580
3581 =item Packages
3582
3583 =item Symbol Tables
3584
3585 =item BEGIN, CHECK, INIT and END
3586
3587 =item Perl Classes
3588
3589 =item Perl Modules
3590
3591 =item Making your module threadsafe
3592
3593 =back
3594
3595 =item SEE ALSO
3596
3597 =back
3598
3599 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3600
3601 =over 4
3602
3603 =item THE PERL MODULE LIBRARY
3604
3605 =over 4
3606
3607 =item Pragmatic Modules
3608
3609 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
3610 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
3611 less, lib, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
3612 threads, threads::shared, utf8, vars, 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<module-starter> or F<h2xs>, Use L<strict|strict> and
3896 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
3897 Use L<plain old 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 Returning SVs, AVs and HVs through RETVAL
4246
4247 =item The MODULE Keyword
4248
4249 =item The PACKAGE Keyword
4250
4251 =item The PREFIX Keyword
4252
4253 =item The OUTPUT: Keyword
4254
4255 =item The NO_OUTPUT Keyword
4256
4257 =item The CODE: Keyword
4258
4259 =item The INIT: Keyword
4260
4261 =item The NO_INIT Keyword
4262
4263 =item Initializing Function Parameters
4264
4265 =item Default Parameter Values
4266
4267 =item The PREINIT: Keyword
4268
4269 =item The SCOPE: Keyword
4270
4271 =item The INPUT: Keyword
4272
4273 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4274
4275 =item The C<length(NAME)> Keyword
4276
4277 =item Variable-length Parameter Lists
4278
4279 =item The C_ARGS: Keyword
4280
4281 =item The PPCODE: Keyword
4282
4283 =item Returning Undef And Empty Lists
4284
4285 =item The REQUIRE: Keyword
4286
4287 =item The CLEANUP: Keyword
4288
4289 =item The POSTCALL: Keyword
4290
4291 =item The BOOT: Keyword
4292
4293 =item The VERSIONCHECK: Keyword
4294
4295 =item The PROTOTYPES: Keyword
4296
4297 =item The PROTOTYPE: Keyword
4298
4299 =item The ALIAS: Keyword
4300
4301 =item The OVERLOAD: Keyword
4302
4303 =item The FALLBACK: Keyword
4304
4305 =item The INTERFACE: Keyword
4306
4307 =item The INTERFACE_MACRO: Keyword
4308
4309 =item The INCLUDE: Keyword
4310
4311 =item The CASE: Keyword
4312
4313 =item The & Unary Operator
4314
4315 =item Inserting POD, Comments and C Preprocessor Directives
4316
4317 =item Using XS With C++
4318
4319 =item Interface Strategy
4320
4321 =item Perl Objects And C Structures
4322
4323 =item The Typemap
4324
4325 =item Safely Storing Static Data in XS
4326
4327 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4328
4329 =back
4330
4331 =item EXAMPLES
4332
4333 =item XS VERSION
4334
4335 =item AUTHOR
4336
4337 =back
4338
4339 =head2 perlclib - Internal replacements for standard C library functions
4340
4341 =over 4
4342
4343 =item DESCRIPTION
4344
4345 =over 4
4346
4347 =item Conventions
4348
4349 C<t>, C<p>, C<n>, C<s>
4350
4351 =item File Operations
4352
4353 =item File Input and Output
4354
4355 =item File Positioning
4356
4357 =item Memory Management and String Handling
4358
4359 =item Character Class Tests
4360
4361 =item F<stdlib.h> functions
4362
4363 =item Miscellaneous functions
4364
4365 =back
4366
4367 =item SEE ALSO
4368
4369 =back
4370
4371 =head2 perlguts - Introduction to the Perl API
4372
4373 =over 4
4374
4375 =item DESCRIPTION
4376
4377 =item Variables
4378
4379 =over 4
4380
4381 =item Datatypes
4382
4383 =item What is an "IV"?
4384
4385 =item Working with SVs
4386
4387 =item Offsets
4388
4389 =item What's Really Stored in an SV?
4390
4391 =item Working with AVs
4392
4393 =item Working with HVs
4394
4395 =item Hash API Extensions
4396
4397 =item AVs, HVs and undefined values
4398
4399 =item References
4400
4401 =item Blessed References and Class Objects
4402
4403 =item Creating New Variables
4404
4405 GV_ADDMULTI, GV_ADDWARN
4406
4407 =item Reference Counts and Mortality
4408
4409 =item Stashes and Globs
4410
4411 =item Double-Typed SVs
4412
4413 =item Magic Variables
4414
4415 =item Assigning Magic
4416
4417 =item Magic Virtual Tables
4418
4419 =item Finding Magic
4420
4421 =item Understanding the Magic of Tied Hashes and Arrays
4422
4423 =item Localizing changes
4424
4425 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4426 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4427 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4428 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4429 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4430 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4431 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4432 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4433 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4434 save_hptr(HV **hptr)>
4435
4436 =back
4437
4438 =item Subroutines
4439
4440 =over 4
4441
4442 =item XSUBs and the Argument Stack
4443
4444 =item Calling Perl Routines from within C Programs
4445
4446 =item Memory Allocation
4447
4448 =item PerlIO
4449
4450 =item Putting a C value on Perl stack
4451
4452 =item Scratchpads
4453
4454 =item Scratchpads and recursion
4455
4456 =back
4457
4458 =item Compiled code
4459
4460 =over 4
4461
4462 =item Code tree
4463
4464 =item Examining the tree
4465
4466 =item Compile pass 1: check routines
4467
4468 =item Compile pass 1a: constant folding
4469
4470 =item Compile pass 2: context propagation
4471
4472 =item Compile pass 3: peephole optimization
4473
4474 =item Pluggable runops
4475
4476 =back
4477
4478 =item Examining internal data structures with the C<dump> functions
4479
4480 =item How multiple interpreters and concurrency are supported
4481
4482 =over 4
4483
4484 =item Background and PERL_IMPLICIT_CONTEXT
4485
4486 =item So what happened to dTHR?
4487
4488 =item How do I use all this in extensions?
4489
4490 =item Should I do anything special if I call perl from multiple threads?
4491
4492 =item Future Plans and PERL_IMPLICIT_SYS
4493
4494 =back
4495
4496 =item Internal Functions
4497
4498 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4499
4500 =over 4
4501
4502 =item Formatted Printing of IVs, UVs, and NVs
4503
4504 =item Pointer-To-Integer and Integer-To-Pointer
4505
4506 =item Source Documentation
4507
4508 =back
4509
4510 =item Unicode Support
4511
4512 =over 4
4513
4514 =item What B<is> Unicode, anyway?
4515
4516 =item How can I recognise a UTF-8 string?
4517
4518 =item How does UTF-8 represent Unicode characters?
4519
4520 =item How does Perl store UTF-8 strings?
4521
4522 =item How do I convert a string to UTF-8?
4523
4524 =item Is there anything else I need to know?
4525
4526 =back
4527
4528 =item Custom Operators
4529
4530 =item AUTHORS
4531
4532 =item SEE ALSO
4533
4534 =back
4535
4536 =head2 perlcall - Perl calling conventions from C
4537
4538 =over 4
4539
4540 =item DESCRIPTION
4541
4542 An Error Handler, An Event Driven Program
4543
4544 =item THE CALL_ FUNCTIONS
4545
4546 call_sv, call_pv, call_method, call_argv
4547
4548 =item FLAG VALUES
4549
4550 =over 4
4551
4552 =item  G_VOID
4553
4554 =item  G_SCALAR
4555
4556 =item G_ARRAY
4557
4558 =item G_DISCARD
4559
4560 =item G_NOARGS
4561
4562 =item G_EVAL
4563
4564 =item G_KEEPERR
4565
4566 =item Determining the Context
4567
4568 =back
4569
4570 =item KNOWN PROBLEMS
4571
4572 =item EXAMPLES
4573
4574 =over 4
4575
4576 =item No Parameters, Nothing returned
4577
4578 =item Passing Parameters
4579
4580 =item Returning a Scalar
4581
4582 =item Returning a list of values
4583
4584 =item Returning a list in a scalar context
4585
4586 =item Returning Data from Perl via the parameter list
4587
4588 =item Using G_EVAL
4589
4590 =item Using G_KEEPERR
4591
4592 =item Using call_sv
4593
4594 =item Using call_argv
4595
4596 =item Using call_method
4597
4598 =item Using GIMME_V
4599
4600 =item Using Perl to dispose of temporaries
4601
4602 =item Strategies for storing Callback Context Information
4603
4604 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4605 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4606 callback
4607
4608 =item Alternate Stack Manipulation
4609
4610 =item Creating and calling an anonymous subroutine in C
4611
4612 =back
4613
4614 =item SEE ALSO
4615
4616 =item AUTHOR
4617
4618 =item DATE
4619
4620 =back
4621
4622 =head2 perlapi - autogenerated documentation for the perl public API
4623
4624 =over 4
4625
4626 =item DESCRIPTION
4627
4628 =item "Gimme" Values
4629
4630 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4631
4632 =item Array Manipulation Functions
4633
4634 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4635 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4636 get_av, newAV, sortsv
4637
4638 =item Callback Functions
4639
4640 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4641 FREETMPS, LEAVE, SAVETMPS
4642
4643 =item Character classes
4644
4645 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4646
4647 =item Cloning an interpreter
4648
4649 perl_clone
4650
4651 =item CV Manipulation Functions
4652
4653 CvSTASH, get_cv
4654
4655 =item Embedding Functions
4656
4657 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4658 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4659
4660 =item Functions in file pp_pack.c
4661
4662 packlist, pack_cat, unpackstring, unpack_str
4663
4664 =item Global Variables
4665
4666 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4667
4668 =item GV Functions
4669
4670 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4671 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4672
4673 =item Handy Values
4674
4675 Nullav, Nullch, Nullcv, Nullhv, Nullsv
4676
4677 =item Hash Manipulation Functions
4678
4679 get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
4680 HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_clear_placeholders, hv_delete,
4681 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4682 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4683 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
4684 hv_undef, newHV
4685
4686 =item Magical Functions
4687
4688 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4689 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4690 SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK
4691
4692 =item Memory Management
4693
4694 Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree,
4695 savepv, savepvn, savesharedpv, StructCopy, Zero, ZeroD
4696
4697 =item Miscellaneous Functions
4698
4699 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4700 strNE, strnEQ, strnNE, sv_nolocking, sv_nosharing, sv_nounlocking
4701
4702 =item Numeric functions
4703
4704 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4705 scan_hex, scan_oct
4706
4707 =item Optree Manipulation Functions
4708
4709 cv_const_sv, newCONSTSUB, newXS
4710
4711 =item Pad Data Structures
4712
4713 pad_sv
4714
4715 =item Stack Manipulation Macros
4716
4717 dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu,
4718 mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp,
4719 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs,
4720 PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs,
4721 XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
4722 XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO,
4723 XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4724
4725 =item SV Flags
4726
4727 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4728
4729 =item SV Manipulation Functions
4730
4731 get_sv, looks_like_number, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
4732 newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
4733 newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4734 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4735 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
4736 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx,
4737 SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4738 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4739 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4740 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4741 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
4742 SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
4743 SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV,
4744 SvUVx, SvUVX, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv,
4745 sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags,
4746 sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv, sv_catpvf,
4747 sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, sv_catpvn_nomg,
4748 sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_catsv_nomg, sv_chop,
4749 sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec,
4750 sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
4751 sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
4752 sv_len_utf8, sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref,
4753 sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten,
4754 sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8,
4755 sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used,
4756 sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg,
4757 sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4758 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4759 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4760 sv_setsv_nomg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true,
4761 sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn,
4762 sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
4763 sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvf, sv_vcatpvfn,
4764 sv_vcatpvf_mg, sv_vsetpvf, sv_vsetpvfn, sv_vsetpvf_mg
4765
4766 =item Unicode Support
4767
4768 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4769 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4770 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4771 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4772 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4773 uvuni_to_utf8_flags
4774
4775 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4776
4777 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4778 THIS, XS, XS_VERSION, XS_VERSION_BOOTCHECK
4779
4780 =item Warning and Dieing
4781
4782 croak, warn
4783
4784 =item AUTHORS
4785
4786 =item SEE ALSO
4787
4788 =back
4789
4790 =head2 perlintern - autogenerated documentation of purely B<internal>
4791                  Perl functions
4792
4793 =over 4
4794
4795 =item DESCRIPTION
4796
4797 =item CV reference counts and CvOUTSIDE
4798
4799 CvWEAKOUTSIDE
4800
4801 =item Functions in file pad.h
4802
4803 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4804 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4805 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4806 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4807 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4808
4809 =item Functions in file pp_ctl.c
4810
4811 find_runcv
4812
4813 =item Global Variables
4814
4815 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4816 PL_rs
4817
4818 =item GV Functions
4819
4820 is_gv_magical
4821
4822 =item IO Functions
4823
4824 start_glob
4825
4826 =item Pad Data Structures
4827
4828 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4829 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4830 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4831 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4832
4833 =item Stack Manipulation Macros
4834
4835 djSP, LVRET
4836
4837 =item SV Manipulation Functions
4838
4839 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4840
4841 =item AUTHORS
4842
4843 =item SEE ALSO
4844
4845 =back
4846
4847 =head2 perliol - C API for Perl's implementation of IO in Layers.
4848
4849 =over 4
4850
4851 =item SYNOPSIS
4852
4853 =item DESCRIPTION
4854
4855 =over 4
4856
4857 =item History and Background
4858
4859 =item Basic Structure
4860
4861 =item Layers vs Disciplines
4862
4863 =item Data Structures
4864
4865 =item Functions and Attributes
4866
4867 =item Per-instance Data
4868
4869 =item Layers in action.
4870
4871 =item Per-instance flag bits
4872
4873 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4874 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4875 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4876 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4877
4878 =item Methods in Detail
4879
4880 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4881 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4882 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4883 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4884 Set_ptrcnt
4885
4886 =item Utilities
4887
4888 =item Implementing PerlIO Layers
4889
4890 C implementations, Perl implementations
4891
4892 =item Core Layers
4893
4894 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4895
4896 =item Extension Layers
4897
4898 ":encoding", ":scalar", ":via"
4899
4900 =back
4901
4902 =item TODO
4903
4904 =back
4905
4906 =head2 perlapio - perl's IO abstraction interface.
4907
4908 =over 4
4909
4910 =item SYNOPSIS
4911
4912 =item DESCRIPTION
4913
4914 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4915 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4916 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4917 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4918 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4919 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4920 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4921 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4922 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4923 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4924 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4925
4926 =over 4
4927
4928 =item Co-existence with stdio
4929
4930 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4931 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4932
4933 =item "Fast gets" Functions
4934
4935 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4936 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4937 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4938 B<PerlIO_get_bufsiz(f)>
4939
4940 =item Other Functions
4941
4942 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4943 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4944
4945 =back
4946
4947 =back
4948
4949 =head2 perlhack - How to hack at the Perl internals
4950
4951 =over 4
4952
4953 =item DESCRIPTION
4954
4955 Does concept match the general goals of Perl?, Where is the
4956 implementation?, Backwards compatibility, Could it be a module instead?, Is
4957 the feature generic enough?, Does it potentially introduce new bugs?, Does
4958 it preclude other desirable features?, Is the implementation robust?, Is
4959 the implementation generic enough to be portable?, Is the implementation
4960 tested?, Is there enough documentation?, Is there another way to do it?,
4961 Does it create too much work?, Patches speak louder than words
4962
4963 =over 4
4964
4965 =item Keeping in sync
4966
4967 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4968 NFS, rsync'ing the patches
4969
4970 =item Why rsync the source tree
4971
4972 It's easier to rsync the source tree, It's more reliable
4973
4974 =item Why rsync the patches
4975
4976 It's easier to rsync the patches, It's a good reference, Finding a start
4977 point, Finding how to fix a bug, Finding the source of misbehaviour
4978
4979 =item Working with the source
4980
4981 =item Perlbug administration
4982
4983 =item Submitting patches
4984
4985 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4986 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4987
4988 =item Finding Your Way Around
4989
4990 Core modules, Tests, Documentation, Configure, Interpreter
4991
4992 =item Elements of the interpreter
4993
4994 Startup, Parsing, Optimization, Running
4995
4996 =item Internal Variable Types
4997
4998 =item Op Trees
4999
5000 =item Stacks
5001
5002 Argument stack, Mark stack, Save stack
5003
5004 =item Millions of Macros
5005
5006 =item The .i Targets
5007
5008 =item Poking at Perl
5009
5010 =item Using a source-level debugger
5011
5012 run [args], break function_name, break source.c:xxx, step, next, continue,
5013 finish, 'enter', print
5014
5015 =item gdb macro support
5016
5017 =item Dumping Perl Data Structures
5018
5019 =item Patching
5020
5021 =item Patching a core module
5022
5023 =item Adding a new function to the core
5024
5025 =item Writing a test
5026
5027 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5028 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5029 t/cmd t/run t/io t/op, t/lib ext lib
5030
5031 =item Special Make Test Targets
5032
5033 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5034 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5035 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5036 check.utf8, minitest.utf16 test.utf16, test_harness
5037
5038 =item Running tests by hand
5039
5040 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5041
5042 =back
5043
5044 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5045
5046 =over 4
5047
5048 =item Rational Software's Purify
5049
5050 =item Purify on Unix
5051
5052 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5053
5054 =item Purify on NT
5055
5056 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5057
5058 =item valgrind
5059
5060 =item Compaq's/Digital's/HP's Third Degree
5061
5062 =item PERL_DESTRUCT_LEVEL
5063
5064 =item Profiling
5065
5066 =item Gprof Profiling
5067
5068 -a, -b, -e routine, -f routine, -s, -z
5069
5070 =item GCC gcov Profiling
5071
5072 =item Pixie Profiling
5073
5074 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5075 -z[ero]
5076
5077 =item Miscellaneous tricks
5078
5079 =item CONCLUSION
5080
5081 I<The Road goes ever on and on, down from the door where it began.>
5082
5083 =back
5084
5085 =item AUTHOR
5086
5087 =back
5088
5089 =head2 perlbook - Perl book information
5090
5091 =over 4
5092
5093 =item DESCRIPTION
5094
5095 =back
5096
5097 =head2 perltodo - Perl TO-DO List
5098
5099 =over 4
5100
5101 =item DESCRIPTION
5102
5103 =item assertions
5104
5105 =item iCOW
5106
5107 =item (?{...}) closures in regexps
5108
5109 =item A re-entrant regexp engine
5110
5111 =item pragmata
5112
5113 =over 4
5114
5115 =item lexical pragmas
5116
5117 =item use less 'memory'
5118
5119 =back
5120
5121 =item prototypes and functions
5122
5123 =over 4
5124
5125 =item _ prototype character
5126
5127 =item inlining autoloaded constants
5128
5129 =item Finish off lvalue functions
5130
5131 =back
5132
5133 =item Unicode and UTF8
5134
5135 =over 4
5136
5137 =item Implicit Latin 1 => Unicode translation
5138
5139 =item UTF8 caching code
5140
5141 =item Unicode in Filenames
5142
5143 =item Unicode in %ENV
5144
5145 =back
5146
5147 =item Regexps
5148
5149 =over 4
5150
5151 =item regexp optimiser optional
5152
5153 =item common suffices/prefices in regexps (trie optimization)
5154
5155 =back
5156
5157 =item POD
5158
5159 =over 4
5160
5161 =item POD -> HTML conversion still sucks
5162
5163 =back
5164
5165 =item Misc medium sized projects
5166
5167 =over 4
5168
5169 =item UNITCHECK
5170
5171 =item optional optimizer
5172
5173 =item You WANT *how* many
5174
5175 =item lexical aliases
5176
5177 =item no 6
5178
5179 =item IPv6
5180
5181 =item entersub XS vs Perl
5182
5183 =item @INC source filter to Filter::Simple
5184
5185 =item bincompat functions
5186
5187 =item Use fchown/fchmod internally
5188
5189 =back
5190
5191 =item Tests
5192
5193 =over 4
5194
5195 =item Make Schwern poorer
5196
5197 =item test B
5198
5199 =item Improve tests for Config.pm
5200
5201 =item common test code for timed bailout
5202
5203 =back
5204
5205 =item Installation
5206
5207 =over 4
5208
5209 =item compressed man pages
5210
5211 =item Make Config.pm cope with differences between build and installed perl
5212
5213 =item Relocatable perl
5214
5215 =item make HTML install work
5216
5217 =item put patchlevel in -v
5218
5219 =back
5220
5221 =item Incremental things
5222
5223 =over 4
5224
5225 =item autovivification
5226
5227 =item fix tainting bugs
5228
5229 =item Make tainting consistent
5230
5231 =item Dual life everything
5232
5233 =back
5234
5235 =item Vague things
5236
5237 =over 4
5238
5239 =item threads
5240
5241 =item POSIX memory footprint
5242
5243 =item Optimize away @_
5244
5245 =item switch ops
5246
5247 =item Attach/detach debugger from running program
5248
5249 =item A decent benchmark
5250
5251 =item readpipe(LIST)
5252
5253 =back
5254
5255 =back
5256
5257 =head2 perldoc - Look up Perl documentation in Pod format.
5258
5259 =over 4
5260
5261 =item SYNOPSIS
5262
5263 =item DESCRIPTION
5264
5265 =item OPTIONS
5266
5267 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5268 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5269 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5270 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5271 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5272 B<-V>
5273
5274 =item SECURITY
5275
5276 =item ENVIRONMENT
5277
5278 =item AUTHOR
5279
5280 =back
5281
5282 =head2 perlhist - the Perl history records
5283
5284 =over 4
5285
5286 =item DESCRIPTION
5287
5288 =item INTRODUCTION
5289
5290 =item THE KEEPERS OF THE PUMPKIN
5291
5292 =over 4
5293
5294 =item PUMPKIN?
5295
5296 =back
5297
5298 =item THE RECORDS
5299
5300 =over 4
5301
5302 =item SELECTED RELEASE SIZES
5303
5304 =item SELECTED PATCH SIZES
5305
5306 =back
5307
5308 =item THE KEEPERS OF THE RECORDS
5309
5310 =back
5311
5312 =head2 perldelta - what is new for perl v5.8.5
5313
5314 =over 4
5315
5316 =item DESCRIPTION
5317
5318 =item Incompatible Changes
5319
5320 =item Core Enhancements
5321
5322 =item Modules and Pragmata
5323
5324 =item Utility Changes
5325
5326 =item New Documentation
5327
5328 =item Performance Enhancements
5329
5330 =item Installation and Configuration Improvements
5331
5332 =item Selected Bug Fixes
5333
5334 =item New or Changed Diagnostics
5335
5336 =item Changed Internals
5337
5338 =item New Tests
5339
5340 =item Known Problems
5341
5342 =item Platform Specific Problems
5343
5344 =item Reporting Bugs
5345
5346 =item SEE ALSO
5347
5348 =back
5349
5350 =head2 perl586delta, perldelta - what is new for perl v5.8.5
5351
5352 =over 4
5353
5354 =item DESCRIPTION
5355
5356 =item Incompatible Changes
5357
5358 =item Core Enhancements
5359
5360 =item Modules and Pragmata
5361
5362 =item Utility Changes
5363
5364 =item New Documentation
5365
5366 =item Performance Enhancements
5367
5368 =item Installation and Configuration Improvements
5369
5370 =item Selected Bug Fixes
5371
5372 =item New or Changed Diagnostics
5373
5374 =item Changed Internals
5375
5376 =item New Tests
5377
5378 =item Known Problems
5379
5380 =item Platform Specific Problems
5381
5382 =item Reporting Bugs
5383
5384 =item SEE ALSO
5385
5386 =back
5387
5388 =head2 perl585delta - what is new for perl v5.8.5
5389
5390 =over 4
5391
5392 =item DESCRIPTION
5393
5394 =item Incompatible Changes
5395
5396 =item Core Enhancements
5397
5398 =item Modules and Pragmata
5399
5400 =item Utility Changes
5401
5402 =over 4
5403
5404 =item Perl's debugger
5405
5406 =item h2ph
5407
5408 =back
5409
5410 =item Installation and Configuration Improvements
5411
5412 =item Selected Bug Fixes
5413
5414 =item New or Changed Diagnostics
5415
5416 =item Changed Internals
5417
5418 =item Known Problems
5419
5420 =item Platform Specific Problems
5421
5422 =item Reporting Bugs
5423
5424 =item SEE ALSO
5425
5426 =back
5427
5428 =head2 perl584delta - what is new for perl v5.8.4
5429
5430 =over 4
5431
5432 =item DESCRIPTION
5433
5434 =item Incompatible Changes
5435
5436 =item Core Enhancements
5437
5438 =over 4
5439
5440 =item Malloc wrapping
5441
5442 =item Unicode Character Database 4.0.1
5443
5444 =item suidperl less insecure
5445
5446 =item format
5447
5448 =back
5449
5450 =item Modules and Pragmata
5451
5452 =over 4
5453
5454 =item Updated modules
5455
5456 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
5457 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
5458 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
5459 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
5460 base, open, threads, utf8
5461
5462 =back
5463
5464 =item Performance Enhancements
5465
5466 =item Utility Changes
5467
5468 =item Installation and Configuration Improvements
5469
5470 =item Selected Bug Fixes
5471
5472 =item New or Changed Diagnostics
5473
5474 =item Changed Internals
5475
5476 =item Future Directions
5477
5478 =item Platform Specific Problems
5479
5480 =item Reporting Bugs
5481
5482 =item SEE ALSO
5483
5484 =back
5485
5486 =head2 perl583delta - what is new for perl v5.8.3
5487
5488 =over 4
5489
5490 =item DESCRIPTION
5491
5492 =item Incompatible Changes
5493
5494 =item Core Enhancements
5495
5496 =item Modules and Pragmata
5497
5498 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
5499 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
5500 Unicode::Normalize, Test::Harness, threads::shared
5501
5502 =item Utility Changes
5503
5504 =item New Documentation
5505
5506 =item Installation and Configuration Improvements
5507
5508 =item Selected Bug Fixes
5509
5510 =item New or Changed Diagnostics
5511
5512 =item Changed Internals
5513
5514 =item Configuration and Building
5515
5516 =item Platform Specific Problems
5517
5518 =item Known Problems
5519
5520 =item Future Directions
5521
5522 =item Obituary
5523
5524 =item Reporting Bugs
5525
5526 =item SEE ALSO
5527
5528 =back
5529
5530 =head2 perl582delta - what is new for perl v5.8.2
5531
5532 =over 4
5533
5534 =item DESCRIPTION
5535
5536 =item Incompatible Changes
5537
5538 =item Core Enhancements
5539
5540 =over 4
5541
5542 =item Hash Randomisation
5543
5544 =item Threading
5545
5546 =back
5547
5548 =item Modules and Pragmata
5549
5550 =over 4
5551
5552 =item Updated Modules And Pragmata
5553
5554 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
5555 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
5556 Unicode::Normalize, UNIVERSAL
5557
5558 =back
5559
5560 =item Selected Bug Fixes
5561
5562 =item Changed Internals
5563
5564 =item Platform Specific Problems
5565
5566 =item Future Directions
5567
5568 =item Reporting Bugs
5569
5570 =item SEE ALSO
5571
5572 =back
5573
5574 =head2 perl581delta - what is new for perl v5.8.1
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 =back
5595
5596 =item Core Enhancements
5597
5598 =over 4
5599
5600 =item UTF-8 no longer default under UTF-8 locales
5601
5602 =item Unsafe signals again available
5603
5604 =item Tied Arrays with Negative Array Indices
5605
5606 =item local ${$x}
5607
5608 =item Unicode Character Database 4.0.0
5609
5610 =item Deprecation Warnings
5611
5612 =item Miscellaneous Enhancements
5613
5614 =back
5615
5616 =item Modules and Pragmata
5617
5618 =over 4
5619
5620 =item Updated Modules And Pragmata
5621
5622 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5623 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5624 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5625 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5626 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5627 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5628 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5629 Win32::GetOSVersion
5630
5631 =back
5632
5633 =item Utility Changes
5634
5635 =item New Documentation
5636
5637 =item Installation and Configuration Improvements
5638
5639 =over 4
5640
5641 =item Platform-specific enhancements
5642
5643 =back
5644
5645 =item Selected Bug Fixes
5646
5647 =over 4
5648
5649 =item Closures, eval and lexicals
5650
5651 =item Generic fixes
5652
5653 =item Platform-specific fixes
5654
5655 =back
5656
5657 =item New or Changed Diagnostics
5658
5659 =over 4
5660
5661 =item Changed "A thread exited while %d threads were running"
5662
5663 =item Removed "Attempt to clear a restricted hash"
5664
5665 =item New "Illegal declaration of anonymous subroutine"
5666
5667 =item Changed "Invalid range "%s" in transliteration operator"
5668
5669 =item New "Missing control char name in \c"
5670
5671 =item New "Newline in left-justified string for %s"
5672
5673 =item New "Possible precedence problem on bitwise %c operator"
5674
5675 =item New "Pseudo-hashes are deprecated"
5676
5677 =item New "read() on %s filehandle %s"
5678
5679 =item New "5.005 threads are deprecated"
5680
5681 =item New "Tied variable freed while still in use"
5682
5683 =item New "To%s: illegal mapping '%s'"
5684
5685 =item New "Use of freed value in iteration"
5686
5687 =back
5688
5689 =item Changed Internals
5690
5691 =item New Tests
5692
5693 =item Known Problems
5694
5695 =over 4
5696
5697 =item Tied hashes in scalar context
5698
5699 =item Net::Ping 450_service and 510_ping_udp failures
5700
5701 =item B::C
5702
5703 =back
5704
5705 =item Platform Specific Problems
5706
5707 =over 4
5708
5709 =item EBCDIC Platforms
5710
5711 =item Cygwin 1.5 problems
5712
5713 =item HP-UX: HP cc warnings about sendfile and sendpath
5714
5715 =item IRIX: t/uni/tr_7jis.t falsely failing
5716
5717 =item Mac OS X: no usemymalloc
5718
5719 =item Tru64: No threaded builds with GNU cc (gcc)
5720
5721 =item Win32: sysopen, sysread, syswrite
5722
5723 =back
5724
5725 =item Future Directions
5726
5727 =item Reporting Bugs
5728
5729 =item SEE ALSO
5730
5731 =back
5732
5733 =head2 perl58delta - what is new for perl v5.8.0
5734
5735 =over 4
5736
5737 =item DESCRIPTION
5738
5739 =item Highlights In 5.8.0
5740
5741 =item Incompatible Changes
5742
5743 =over 4
5744
5745 =item Binary Incompatibility
5746
5747 =item 64-bit platforms and malloc
5748
5749 =item AIX Dynaloading
5750
5751 =item Attributes for C<my> variables now handled at run-time
5752
5753 =item Socket Extension Dynamic in VMS
5754
5755 =item IEEE-format Floating Point Default on OpenVMS Alpha
5756
5757 =item New Unicode Semantics (no more C<use utf8>, almost)
5758
5759 =item New Unicode Properties
5760
5761 =item REF(...) Instead Of SCALAR(...)
5762
5763 =item pack/unpack D/F recycled
5764
5765 =item glob() now returns filenames in alphabetical order
5766
5767 =item Deprecations
5768
5769 =back
5770
5771 =item Core Enhancements
5772
5773 =over 4
5774
5775 =item Unicode Overhaul
5776
5777 =item PerlIO is Now The Default
5778
5779 =item ithreads
5780
5781 =item Restricted Hashes
5782
5783 =item Safe Signals
5784
5785 =item Understanding of Numbers
5786
5787 =item Arrays now always interpolate into double-quoted strings [561]
5788
5789 =item Miscellaneous Changes
5790
5791 =back
5792
5793 =item Modules and Pragmata
5794
5795 =over 4
5796
5797 =item New Modules and Pragmata
5798
5799 =item Updated And Improved Modules and Pragmata
5800
5801 =back
5802
5803 =item Utility Changes
5804
5805 =item New Documentation
5806
5807 =item Performance Enhancements
5808
5809 =item Installation and Configuration Improvements
5810
5811 =over 4
5812
5813 =item Generic Improvements
5814
5815 =item New Or Improved Platforms
5816
5817 =back
5818
5819 =item Selected Bug Fixes
5820
5821 =over 4
5822
5823 =item Platform Specific Changes and Fixes
5824
5825 =back
5826
5827 =item New or Changed Diagnostics
5828
5829 =item Changed Internals
5830
5831 =item Security Vulnerability Closed [561]
5832
5833 =item New Tests
5834
5835 =item Known Problems
5836
5837 =over 4
5838
5839 =item The Compiler Suite Is Still Very Experimental
5840
5841 =item Localising Tied Arrays and Hashes Is Broken
5842
5843 =item Building Extensions Can Fail Because Of Largefiles
5844
5845 =item Modifying $_ Inside for(..)
5846
5847 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5848
5849 =item lib/ftmp-security tests warn 'system possibly insecure'
5850
5851 =item libwww-perl (LWP) fails base/date #51
5852
5853 =item PDL failing some tests
5854
5855 =item Perl_get_sv
5856
5857 =item Self-tying Problems
5858
5859 =item ext/threads/t/libc
5860
5861 =item Failure of Thread (5.005-style) tests
5862
5863 =item Timing problems
5864
5865 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5866
5867 =item Unicode in package/class and subroutine names does not work
5868
5869 =back
5870
5871 =item Platform Specific Problems
5872
5873 =over 4
5874
5875 =item AIX
5876
5877 =item Alpha systems with old gccs fail several tests
5878
5879 =item AmigaOS
5880
5881 =item BeOS
5882
5883 =item Cygwin "unable to remap"
5884
5885 =item Cygwin ndbm tests fail on FAT
5886
5887 =item DJGPP Failures
5888
5889 =item FreeBSD built with ithreads coredumps reading large directories
5890
5891 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5892
5893 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5894
5895 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5896
5897 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5898
5899 =item Linux With Sfio Fails op/misc Test 48
5900
5901 =item Mac OS X
5902
5903 =item Mac OS X dyld undefined symbols
5904
5905 =item OS/2 Test Failures
5906
5907 =item op/sprintf tests 91, 129, and 130
5908
5909 =item SCO
5910
5911 =item Solaris 2.5
5912
5913 =item Solaris x86 Fails Tests With -Duse64bitint
5914
5915 =item SUPER-UX (NEC SX)
5916
5917 =item Term::ReadKey not working on Win32
5918
5919 =item UNICOS/mk
5920
5921 =item UTS
5922
5923 =item VOS (Stratus)
5924
5925 =item VMS
5926
5927 =item Win32
5928
5929 =item XML::Parser not working
5930
5931 =item z/OS (OS/390)
5932
5933 =item Unicode Support on EBCDIC Still Spotty
5934
5935 =item Seen In Perl 5.7 But Gone Now
5936
5937 =back
5938
5939 =item Reporting Bugs
5940
5941 =item SEE ALSO
5942
5943 =item HISTORY
5944
5945 =back
5946
5947 =head2 perl573delta - what's new for perl v5.7.3
5948
5949 =over 4
5950
5951 =item DESCRIPTION
5952
5953 =item Changes
5954
5955 =item Reporting Bugs
5956
5957 =item SEE ALSO
5958
5959 =item HISTORY
5960
5961 =back
5962
5963 =head2 perl572delta - what's new for perl v5.7.2
5964
5965 =over 4
5966
5967 =item DESCRIPTION
5968
5969 =item Security Vulnerability Closed
5970
5971 =item Incompatible Changes
5972
5973 =over 4
5974
5975 =item 64-bit platforms and malloc
5976
5977 =item AIX Dynaloading
5978
5979 =item Socket Extension Dynamic in VMS
5980
5981 =item Different Definition of the Unicode Character Classes \p{In...}
5982
5983 =item Deprecations
5984
5985 =back
5986
5987 =item Core Enhancements
5988
5989 =item Modules and Pragmata
5990
5991 =over 4
5992
5993 =item New Modules and Distributions
5994
5995 =item Updated And Improved Modules and Pragmata
5996
5997 =back
5998
5999 =item Utility Changes
6000
6001 =item New Documentation
6002
6003 =item Installation and Configuration Improvements
6004
6005 =over 4
6006
6007 =item New Or Improved Platforms
6008
6009 =item Generic Improvements
6010
6011 =back
6012
6013 =item Selected Bug Fixes
6014
6015 =over 4
6016
6017 =item Platform Specific Changes and Fixes
6018
6019 =back
6020
6021 =item New or Changed Diagnostics
6022
6023 =item Source Code Enhancements
6024
6025 =over 4
6026
6027 =item MAGIC constants
6028
6029 =item Better commented code
6030
6031 =item Regex pre-/post-compilation items matched up
6032
6033 =item gcc -Wall
6034
6035 =back
6036
6037 =item New Tests
6038
6039 =item Known Problems
6040
6041 =over 4
6042
6043 =item AIX
6044
6045 =item Amiga Perl Invoking Mystery
6046
6047 =item lib/ftmp-security tests warn 'system possibly insecure'
6048
6049 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6050
6051 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6052
6053 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6054
6055 =item Linux With Sfio Fails op/misc Test 48
6056
6057 =item OS/390
6058
6059 =item op/sprintf tests 129 and 130
6060
6061 =item  Failure of Thread tests
6062
6063 =item UNICOS
6064
6065 =item UTS
6066
6067 =item VMS
6068
6069 =item Win32
6070
6071 =item Localising a Tied Variable Leaks Memory
6072
6073 =item Self-tying of Arrays and Hashes Is Forbidden
6074
6075 =item Variable Attributes are not Currently Usable for Tieing
6076
6077 =item Building Extensions Can Fail Because Of Largefiles
6078
6079 =item The Compiler Suite Is Still Experimental
6080
6081 =item The Long Double Support is Still Experimental
6082
6083 =back
6084
6085 =item Reporting Bugs
6086
6087 =item SEE ALSO
6088
6089 =item HISTORY
6090
6091 =back
6092
6093 =head2 perl571delta - what's new for perl v5.7.1
6094
6095 =over 4
6096
6097 =item DESCRIPTION
6098
6099 =item Security Vulnerability Closed
6100
6101 =item Incompatible Changes
6102
6103 =item Core Enhancements
6104
6105 =over 4
6106
6107 =item AUTOLOAD Is Now Lvaluable
6108
6109 =item PerlIO is Now The Default
6110
6111 =item Signals Are Now Safe
6112
6113 =back
6114
6115 =item Modules and Pragmata
6116
6117 =over 4
6118
6119 =item New Modules
6120
6121 =item Updated And Improved Modules and Pragmata
6122
6123 =back
6124
6125 =item Performance Enhancements
6126
6127 =item Utility Changes
6128
6129 =item New Documentation
6130
6131 =over 4
6132
6133 =item perlclib
6134
6135 =item perliol
6136
6137 =item README.aix
6138
6139 =item README.bs2000
6140
6141 =item README.macos
6142
6143 =item README.mpeix
6144
6145 =item README.solaris
6146
6147 =item README.vos
6148
6149 =item Porting/repository.pod
6150
6151 =back
6152
6153 =item Installation and Configuration Improvements
6154
6155 =over 4
6156
6157 =item New Or Improved Platforms
6158
6159 =item Generic Improvements
6160
6161 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6162 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6163 d_strtoq, d_u32align, d_ualarm, d_usleep
6164
6165 =back
6166
6167 =item Selected Bug Fixes
6168
6169 =over 4
6170
6171 =item Platform Specific Changes and Fixes
6172
6173 =back
6174
6175 =item New or Changed Diagnostics
6176
6177 =item Changed Internals
6178
6179 =item New Tests
6180
6181 =item Known Problems
6182
6183 =over 4
6184
6185 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6186
6187 =item lib/ftmp-security tests warn 'system possibly insecure'
6188
6189 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6190
6191 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6192
6193 =item lib/b test 19
6194
6195 =item Linux With Sfio Fails op/misc Test 48
6196
6197 =item sigaction test 13 in VMS
6198
6199 =item sprintf tests 129 and 130
6200
6201 =item  Failure of Thread tests
6202
6203 =item Localising a Tied Variable Leaks Memory
6204
6205 =item Self-tying of Arrays and Hashes Is Forbidden
6206
6207 =item Building Extensions Can Fail Because Of Largefiles
6208
6209 =item The Compiler Suite Is Still Experimental
6210
6211 =back
6212
6213 =item Reporting Bugs
6214
6215 =item SEE ALSO
6216
6217 =item HISTORY
6218
6219 =back
6220
6221 =head2 perl570delta - what's new for perl v5.7.0
6222
6223 =over 4
6224
6225 =item DESCRIPTION
6226
6227 =item Security Vulnerability Closed
6228
6229 =item Incompatible Changes
6230
6231 =item Core Enhancements
6232
6233 =item Modules and Pragmata
6234
6235 =over 4
6236
6237 =item New Modules
6238
6239 =item Updated And Improved Modules and Pragmata
6240
6241 =back
6242
6243 =item Utility Changes
6244
6245 =item New Documentation
6246
6247 =item Performance Enhancements
6248
6249 =item Installation and Configuration Improvements
6250
6251 =over 4
6252
6253 =item Generic Improvements
6254
6255 =back
6256
6257 =item Selected Bug Fixes
6258
6259 =over 4
6260
6261 =item Platform Specific Changes and Fixes
6262
6263 =back
6264
6265 =item New or Changed Diagnostics
6266
6267 =item Changed Internals
6268
6269 =item Known Problems
6270
6271 =over 4
6272
6273 =item Unicode Support Still Far From Perfect
6274
6275 =item EBCDIC Still A Lost Platform
6276
6277 =item Building Extensions Can Fail Because Of Largefiles
6278
6279 =item ftmp-security tests warn 'system possibly insecure'
6280
6281 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6282
6283 =item Long Doubles Still Don't Work In Solaris
6284
6285 =item Linux With Sfio Fails op/misc Test 48
6286
6287 =item Storable tests fail in some platforms
6288
6289 =item Threads Are Still Experimental
6290
6291 =item The Compiler Suite Is Still Experimental
6292
6293 =back
6294
6295 =item Reporting Bugs
6296
6297 =item SEE ALSO
6298
6299 =item HISTORY
6300
6301 =back
6302
6303 =head2 perl561delta - what's new for perl v5.6.x
6304
6305 =over 4
6306
6307 =item DESCRIPTION
6308
6309 =item Summary of changes between 5.6.0 and 5.6.1
6310
6311 =over 4
6312
6313 =item Security Issues
6314
6315 =item Core bug fixes
6316
6317 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6318 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6319 references to special variables, Lexical warnings, Spurious warnings and
6320 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6321 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6322 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6323 Module;>, Tests
6324
6325 =item Core features
6326
6327 =item Configuration issues
6328
6329 =item Documentation
6330
6331 =item Bundled modules
6332
6333 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6334 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6335 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6336 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6337
6338 =item Platform-specific improvements
6339
6340 NCR MP-RAS, NonStop-UX
6341
6342 =back
6343
6344 =item Core Enhancements
6345
6346 =over 4
6347
6348 =item Interpreter cloning, threads, and concurrency
6349
6350 =item Lexically scoped warning categories
6351
6352 =item Unicode and UTF-8 support
6353
6354 =item Support for interpolating named characters
6355
6356 =item "our" declarations
6357
6358 =item Support for strings represented as a vector of ordinals
6359
6360 =item Improved Perl version numbering system
6361
6362 =item New syntax for declaring subroutine attributes
6363
6364 =item File and directory handles can be autovivified
6365
6366 =item open() with more than two arguments
6367
6368 =item 64-bit support
6369
6370 =item Large file support
6371
6372 =item Long doubles
6373
6374 =item "more bits"
6375
6376 =item Enhanced support for sort() subroutines
6377
6378 =item C<sort $coderef @foo> allowed
6379
6380 =item File globbing implemented internally
6381
6382 =item Support for CHECK blocks
6383
6384 =item POSIX character class syntax [: :] supported
6385
6386 =item Better pseudo-random number generator
6387
6388 =item Improved C<qw//> operator
6389
6390 =item Better worst-case behavior of hashes
6391
6392 =item pack() format 'Z' supported
6393
6394 =item pack() format modifier '!' supported
6395
6396 =item pack() and unpack() support counted strings
6397
6398 =item Comments in pack() templates
6399
6400 =item Weak references
6401
6402 =item Binary numbers supported
6403
6404 =item Lvalue subroutines
6405
6406 =item Some arrows may be omitted in calls through references
6407
6408 =item Boolean assignment operators are legal lvalues
6409
6410 =item exists() is supported on subroutine names
6411
6412 =item exists() and delete() are supported on array elements
6413
6414 =item Pseudo-hashes work better
6415
6416 =item Automatic flushing of output buffers
6417
6418 =item Better diagnostics on meaningless filehandle operations
6419
6420 =item Where possible, buffered data discarded from duped input filehandle
6421
6422 =item eof() has the same old magic as <>
6423
6424 =item binmode() can be used to set :crlf and :raw modes
6425
6426 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6427
6428 =item system(), backticks and pipe open now reflect exec() failure
6429
6430 =item Improved diagnostics
6431
6432 =item Diagnostics follow STDERR
6433
6434 =item More consistent close-on-exec behavior
6435
6436 =item syswrite() ease-of-use
6437
6438 =item Better syntax checks on parenthesized unary operators
6439
6440 =item Bit operators support full native integer width
6441
6442 =item Improved security features
6443
6444 =item More functional bareword prototype (*)
6445
6446 =item C<require> and C<do> may be overridden
6447
6448 =item $^X variables may now have names longer than one character
6449
6450 =item New variable $^C reflects C<-c> switch
6451
6452 =item New variable $^V contains Perl version as a string
6453
6454 =item Optional Y2K warnings
6455
6456 =item Arrays now always interpolate into double-quoted strings
6457
6458 =back
6459
6460 =item Modules and Pragmata
6461
6462 =over 4
6463
6464 =item Modules
6465
6466 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6467 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6468 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6469 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6470 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6471 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6472 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6473 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6474
6475 =item Pragmata
6476
6477 =back
6478
6479 =item Utility Changes
6480
6481 =over 4
6482
6483 =item dprofpp
6484
6485 =item find2perl
6486
6487 =item h2xs
6488
6489 =item perlcc
6490
6491 =item perldoc
6492
6493 =item The Perl Debugger
6494
6495 =back
6496
6497 =item Improved Documentation
6498
6499 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6500 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6501 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6502 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6503
6504 =item Performance enhancements
6505
6506 =over 4
6507
6508 =item Simple sort() using { $a <=> $b } and the like are optimized
6509
6510 =item Optimized assignments to lexical variables
6511
6512 =item Faster subroutine calls
6513
6514 =item delete(), each(), values() and hash iteration are faster
6515
6516 =back
6517
6518 =item Installation and Configuration Improvements
6519
6520 =over 4
6521
6522 =item -Dusethreads means something different
6523
6524 =item New Configure flags
6525
6526 =item Threadedness and 64-bitness now more daring
6527
6528 =item Long Doubles
6529
6530 =item -Dusemorebits
6531
6532 =item -Duselargefiles
6533
6534 =item installusrbinperl
6535
6536 =item SOCKS support
6537
6538 =item C<-A> flag
6539
6540 =item Enhanced Installation Directories
6541
6542 =item gcc automatically tried if 'cc' does not seem to be working
6543
6544 =back
6545
6546 =item Platform specific changes
6547
6548 =over 4
6549
6550 =item Supported platforms
6551
6552 =item DOS
6553
6554 =item OS390 (OpenEdition MVS)
6555
6556 =item VMS
6557
6558 =item Win32
6559
6560 =back
6561
6562 =item Significant bug fixes
6563
6564 =over 4
6565
6566 =item <HANDLE> on empty files
6567
6568 =item C<eval '...'> improvements
6569
6570 =item All compilation errors are true errors
6571
6572 =item Implicitly closed filehandles are safer
6573
6574 =item Behavior of list slices is more consistent
6575
6576 =item C<(\$)> prototype and C<$foo{a}>
6577
6578 =item C<goto &sub> and AUTOLOAD
6579
6580 =item C<-bareword> allowed under C<use integer>
6581
6582 =item Failures in DESTROY()
6583
6584 =item Locale bugs fixed
6585
6586 =item Memory leaks
6587
6588 =item Spurious subroutine stubs after failed subroutine calls
6589
6590 =item Taint failures under C<-U>
6591
6592 =item END blocks and the C<-c> switch
6593
6594 =item Potential to leak DATA filehandles
6595
6596 =back
6597
6598 =item New or Changed Diagnostics
6599
6600 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6601 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6602 / cannot take a count, / must be followed by a, A or Z, / must be followed
6603 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6604 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6605 passed through, /%s/ should probably be written as "%s", %s() called too
6606 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6607 argument is not a HASH or ARRAY element or slice, %s argument is not a
6608 subroutine name, %s package attribute may clash with future reserved word:
6609 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6610 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6611 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6612 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6613 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6614 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6615 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6616 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6617 weaken a nonreference, Character class [:%s:] unknown, Character class
6618 syntax [%s] belongs inside character classes, Constant is not %s reference,
6619 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6620 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6621 "local" instead of "our"?), Document contains no data, entering effective
6622 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6623 output, flock() on closed filehandle %s, Global symbol "%s" requires
6624 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6625 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6626 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6627 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6628 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6629 separator character %s in attribute list, Invalid separator character %s in
6630 subroutine attribute list, leaving effective %s failed, Lvalue subs
6631 returning %s not implemented yet, Method %s not permitted, Missing
6632 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6633 No %s specified for -%c, No package name allowed for variable %s in "our",
6634 No space allowed after -%c, no UTC offset information; assuming local time
6635 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6636 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6637 around "%s" list, Possible unintended interpolation of %s in string,
6638 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6639 instead, Premature end of script headers, Repeat count in pack overflows,
6640 Repeat count in unpack overflows, realloc() of freed memory ignored,
6641 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6642 zero-length expression, switching effective %s is not implemented, This
6643 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6644 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6645 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6646 escape \\%c passed through, Unterminated attribute parameter in attribute
6647 list, Unterminated attribute list, Unterminated attribute parameter in
6648 subroutine attribute list, Unterminated subroutine attribute list, Value of
6649 CLI symbol "%s" too long, Version number must be a constant number
6650
6651 =item New tests
6652
6653 =item Incompatible Changes
6654
6655 =over 4
6656
6657 =item Perl Source Incompatibilities
6658
6659 CHECK is a new keyword, Treatment of list slices of undef has changed,
6660 Format of $English::PERL_VERSION is different, Literals of the form
6661 C<1.2.3> parse differently, Possibly changed pseudo-random number
6662 generator, Hashing function for hash keys has changed, C<undef> fails on
6663 read only values, Close-on-exec bit may be set on pipe and socket handles,
6664 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6665 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6666 Text of some diagnostic output has changed, C<%@> has been removed,
6667 Parenthesized not() behaves like a list operator, Semantics of bareword
6668 prototype C<(*)> have changed, Semantics of bit operators may have changed
6669 on 64-bit platforms, More builtins taint their results
6670
6671 =item C Source Incompatibilities
6672
6673 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6674
6675 =item Compatible C Source API Changes
6676
6677 C<PATCHLEVEL> is now C<PERL_VERSION>
6678
6679 =item Binary Incompatibilities
6680
6681 =back
6682
6683 =item Known Problems
6684
6685 =over 4
6686
6687 =item Localizing a tied hash element may leak memory
6688
6689 =item Known test failures
6690
6691 =item EBCDIC platforms not fully supported
6692
6693 =item UNICOS/mk CC failures during Configure run
6694
6695 =item Arrow operator and arrays
6696
6697 =item Experimental features
6698
6699 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6700 pseudo-hash data type, The Compiler suite, Internal implementation of file
6701 globbing, The DB module, The regular expression code constructs:
6702
6703 =back
6704
6705 =item Obsolete Diagnostics
6706
6707 Character class syntax [: :] is reserved for future extensions, Ill-formed
6708 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6709 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6710 to mean "${$}<digit>" is deprecated
6711
6712 =item Reporting Bugs
6713
6714 =item SEE ALSO
6715
6716 =item HISTORY
6717
6718 =back
6719
6720 =head2 perl56delta - what's new for perl v5.6.0
6721
6722 =over 4
6723
6724 =item DESCRIPTION
6725
6726 =item Core Enhancements
6727
6728 =over 4
6729
6730 =item Interpreter cloning, threads, and concurrency
6731
6732 =item Lexically scoped warning categories
6733
6734 =item Unicode and UTF-8 support
6735
6736 =item Support for interpolating named characters
6737
6738 =item "our" declarations
6739
6740 =item Support for strings represented as a vector of ordinals
6741
6742 =item Improved Perl version numbering system
6743
6744 =item New syntax for declaring subroutine attributes
6745
6746 =item File and directory handles can be autovivified
6747
6748 =item open() with more than two arguments
6749
6750 =item 64-bit support
6751
6752 =item Large file support
6753
6754 =item Long doubles
6755
6756 =item "more bits"
6757
6758 =item Enhanced support for sort() subroutines
6759
6760 =item C<sort $coderef @foo> allowed
6761
6762 =item File globbing implemented internally
6763
6764 =item Support for CHECK blocks
6765
6766 =item POSIX character class syntax [: :] supported
6767
6768 =item Better pseudo-random number generator
6769
6770 =item Improved C<qw//> operator
6771
6772 =item Better worst-case behavior of hashes
6773
6774 =item pack() format 'Z' supported
6775
6776 =item pack() format modifier '!' supported
6777
6778 =item pack() and unpack() support counted strings
6779
6780 =item Comments in pack() templates
6781
6782 =item Weak references
6783
6784 =item Binary numbers supported
6785
6786 =item Lvalue subroutines
6787
6788 =item Some arrows may be omitted in calls through references
6789
6790 =item Boolean assignment operators are legal lvalues
6791
6792 =item exists() is supported on subroutine names
6793
6794 =item exists() and delete() are supported on array elements
6795
6796 =item Pseudo-hashes work better
6797
6798 =item Automatic flushing of output buffers
6799
6800 =item Better diagnostics on meaningless filehandle operations
6801
6802 =item Where possible, buffered data discarded from duped input filehandle
6803
6804 =item eof() has the same old magic as <>
6805
6806 =item binmode() can be used to set :crlf and :raw modes
6807
6808 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6809
6810 =item system(), backticks and pipe open now reflect exec() failure
6811
6812 =item Improved diagnostics
6813
6814 =item Diagnostics follow STDERR
6815
6816 =item More consistent close-on-exec behavior
6817
6818 =item syswrite() ease-of-use
6819
6820 =item Better syntax checks on parenthesized unary operators
6821
6822 =item Bit operators support full native integer width
6823
6824 =item Improved security features
6825
6826 =item More functional bareword prototype (*)
6827
6828 =item C<require> and C<do> may be overridden
6829
6830 =item $^X variables may now have names longer than one character
6831
6832 =item New variable $^C reflects C<-c> switch
6833
6834 =item New variable $^V contains Perl version as a string
6835
6836 =item Optional Y2K warnings
6837
6838 =item Arrays now always interpolate into double-quoted strings
6839
6840 =back
6841
6842 =item Modules and Pragmata
6843
6844 =over 4
6845
6846 =item Modules
6847
6848 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6849 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6850 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6851 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6852 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6853 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6854 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6855 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6856
6857 =item Pragmata
6858
6859 =back
6860
6861 =item Utility Changes
6862
6863 =over 4
6864
6865 =item dprofpp
6866
6867 =item find2perl
6868
6869 =item h2xs
6870
6871 =item perlcc
6872
6873 =item perldoc
6874
6875 =item The Perl Debugger
6876
6877 =back
6878
6879 =item Improved Documentation
6880
6881 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6882 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6883 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6884 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6885
6886 =item Performance enhancements
6887
6888 =over 4
6889
6890 =item Simple sort() using { $a <=> $b } and the like are optimized
6891
6892 =item Optimized assignments to lexical variables
6893
6894 =item Faster subroutine calls
6895
6896 =item delete(), each(), values() and hash iteration are faster
6897
6898 =back
6899
6900 =item Installation and Configuration Improvements
6901
6902 =over 4
6903
6904 =item -Dusethreads means something different
6905
6906 =item New Configure flags
6907
6908 =item Threadedness and 64-bitness now more daring
6909
6910 =item Long Doubles
6911
6912 =item -Dusemorebits
6913
6914 =item -Duselargefiles
6915
6916 =item installusrbinperl
6917
6918 =item SOCKS support
6919
6920 =item C<-A> flag
6921
6922 =item Enhanced Installation Directories
6923
6924 =back
6925
6926 =item Platform specific changes
6927
6928 =over 4
6929
6930 =item Supported platforms
6931
6932 =item DOS
6933
6934 =item OS390 (OpenEdition MVS)
6935
6936 =item VMS
6937
6938 =item Win32
6939
6940 =back
6941
6942 =item Significant bug fixes
6943
6944 =over 4
6945
6946 =item <HANDLE> on empty files
6947
6948 =item C<eval '...'> improvements
6949
6950 =item All compilation errors are true errors
6951
6952 =item Implicitly closed filehandles are safer
6953
6954 =item Behavior of list slices is more consistent
6955
6956 =item C<(\$)> prototype and C<$foo{a}>
6957
6958 =item C<goto &sub> and AUTOLOAD
6959
6960 =item C<-bareword> allowed under C<use integer>
6961
6962 =item Failures in DESTROY()
6963
6964 =item Locale bugs fixed
6965
6966 =item Memory leaks
6967
6968 =item Spurious subroutine stubs after failed subroutine calls
6969
6970 =item Taint failures under C<-U>
6971
6972 =item END blocks and the C<-c> switch
6973
6974 =item Potential to leak DATA filehandles
6975
6976 =back
6977
6978 =item New or Changed Diagnostics
6979
6980 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6981 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6982 / cannot take a count, / must be followed by a, A or Z, / must be followed
6983 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6984 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6985 passed through, /%s/ should probably be written as "%s", %s() called too
6986 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6987 argument is not a HASH or ARRAY element or slice, %s argument is not a
6988 subroutine name, %s package attribute may clash with future reserved word:
6989 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6990 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6991 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6992 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6993 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6994 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6995 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6996 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6997 weaken a nonreference, Character class [:%s:] unknown, Character class
6998 syntax [%s] belongs inside character classes, Constant is not %s reference,
6999 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7000 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7001 "local" instead of "our"?), Document contains no data, entering effective
7002 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7003 output, flock() on closed filehandle %s, Global symbol "%s" requires
7004 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7005 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7006 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7007 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7008 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7009 separator character %s in attribute list, Invalid separator character %s in
7010 subroutine attribute list, leaving effective %s failed, Lvalue subs
7011 returning %s not implemented yet, Method %s not permitted, Missing
7012 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7013 No %s specified for -%c, No package name allowed for variable %s in "our",
7014 No space allowed after -%c, no UTC offset information; assuming local time
7015 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7016 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7017 around "%s" list, Possible unintended interpolation of %s in string,
7018 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7019 instead, Premature end of script headers, Repeat count in pack overflows,
7020 Repeat count in unpack overflows, realloc() of freed memory ignored,
7021 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7022 zero-length expression, switching effective %s is not implemented, This
7023 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7024 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7025 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7026 escape \\%c passed through, Unterminated attribute parameter in attribute
7027 list, Unterminated attribute list, Unterminated attribute parameter in
7028 subroutine attribute list, Unterminated subroutine attribute list, Value of
7029 CLI symbol "%s" too long, Version number must be a constant number
7030
7031 =item New tests
7032
7033 =item Incompatible Changes
7034
7035 =over 4
7036
7037 =item Perl Source Incompatibilities
7038
7039 CHECK is a new keyword, Treatment of list slices of undef has changed,
7040 Format of $English::PERL_VERSION is different, Literals of the form
7041 C<1.2.3> parse differently, Possibly changed pseudo-random number
7042 generator, Hashing function for hash keys has changed, C<undef> fails on
7043 read only values, Close-on-exec bit may be set on pipe and socket handles,
7044 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7045 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7046 Text of some diagnostic output has changed, C<%@> has been removed,
7047 Parenthesized not() behaves like a list operator, Semantics of bareword
7048 prototype C<(*)> have changed, Semantics of bit operators may have changed
7049 on 64-bit platforms, More builtins taint their results
7050
7051 =item C Source Incompatibilities
7052
7053 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7054
7055 =item Compatible C Source API Changes
7056
7057 C<PATCHLEVEL> is now C<PERL_VERSION>
7058
7059 =item Binary Incompatibilities
7060
7061 =back
7062
7063 =item Known Problems
7064
7065 =over 4
7066
7067 =item Thread test failures
7068
7069 =item EBCDIC platforms not supported
7070
7071 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7072
7073 =item NEXTSTEP 3.3 POSIX test failure
7074
7075 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7076 gcc
7077
7078 =item UNICOS/mk CC failures during Configure run
7079
7080 =item Arrow operator and arrays
7081
7082 =item Experimental features
7083
7084 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7085 pseudo-hash data type, The Compiler suite, Internal implementation of file
7086 globbing, The DB module, The regular expression code constructs:
7087
7088 =back
7089
7090 =item Obsolete Diagnostics
7091
7092 Character class syntax [: :] is reserved for future extensions, Ill-formed
7093 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7094 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7095 to mean "${$}<digit>" is deprecated
7096
7097 =item Reporting Bugs
7098
7099 =item SEE ALSO
7100
7101 =item HISTORY
7102
7103 =back
7104
7105 =head2 perl5005delta - what's new for perl5.005
7106
7107 =over 4
7108
7109 =item DESCRIPTION
7110
7111 =item About the new versioning system
7112
7113 =item Incompatible Changes
7114
7115 =over 4
7116
7117 =item WARNING:  This version is not binary compatible with Perl 5.004.
7118
7119 =item Default installation structure has changed
7120
7121 =item Perl Source Compatibility
7122
7123 =item C Source Compatibility
7124
7125 =item Binary Compatibility
7126
7127 =item Security fixes may affect compatibility
7128
7129 =item Relaxed new mandatory warnings introduced in 5.004
7130
7131 =item Licensing
7132
7133 =back
7134
7135 =item Core Changes
7136
7137 =over 4
7138
7139 =item Threads
7140
7141 =item Compiler
7142
7143 =item Regular Expressions
7144
7145 Many new and improved optimizations, Many bug fixes, New regular expression
7146 constructs, New operator for precompiled regular expressions, Other
7147 improvements, Incompatible changes
7148
7149 =item   Improved malloc()
7150
7151 =item Quicksort is internally implemented
7152
7153 =item Reliable signals
7154
7155 =item Reliable stack pointers
7156
7157 =item More generous treatment of carriage returns
7158
7159 =item Memory leaks
7160
7161 =item Better support for multiple interpreters
7162
7163 =item Behavior of local() on array and hash elements is now well-defined
7164
7165 =item C<%!> is transparently tied to the L<Errno> module
7166
7167 =item Pseudo-hashes are supported
7168
7169 =item C<EXPR foreach EXPR> is supported
7170
7171 =item Keywords can be globally overridden
7172
7173 =item C<$^E> is meaningful on Win32
7174
7175 =item C<foreach (1..1000000)> optimized
7176
7177 =item C<Foo::> can be used as implicitly quoted package name
7178
7179 =item C<exists $Foo::{Bar::}> tests existence of a package
7180
7181 =item Better locale support
7182
7183 =item Experimental support for 64-bit platforms
7184
7185 =item prototype() returns useful results on builtins
7186
7187 =item Extended support for exception handling
7188
7189 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7190
7191 =item All C<printf> format conversions are handled internally
7192
7193 =item New C<INIT> keyword
7194
7195 =item New C<lock> keyword
7196
7197 =item New C<qr//> operator
7198
7199 =item C<our> is now a reserved word
7200
7201 =item Tied arrays are now fully supported
7202
7203 =item Tied handles support is better
7204
7205 =item 4th argument to substr
7206
7207 =item Negative LENGTH argument to splice
7208
7209 =item Magic lvalues are now more magical
7210
7211 =item <> now reads in records
7212
7213 =back
7214
7215 =item Supported Platforms
7216
7217 =over 4
7218
7219 =item New Platforms
7220
7221 =item Changes in existing support
7222
7223 =back
7224
7225 =item Modules and Pragmata
7226
7227 =over 4
7228
7229 =item New Modules
7230
7231 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7232 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7233 Thread, attrs, fields, re
7234
7235 =item Changes in existing modules
7236
7237 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7238 MakeMaker, CPAN, Cwd
7239
7240 =back
7241
7242 =item Utility Changes
7243
7244 =item Documentation Changes
7245
7246 =item New Diagnostics
7247
7248 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7249 while coercing array into hash, Bareword "%s" refers to nonexistent
7250 package, Can't call method "%s" on an undefined value, Can't check
7251 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7252 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7253 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7254 for "%s", Character class syntax [. .] is reserved for future extensions,
7255 Character class syntax [: :] is reserved for future extensions, Character
7256 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7257 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7258 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7259 package main), Illegal hex digit ignored, No such array field, No such
7260 field "%s" in variable %s of type %s, Out of memory during ridiculously
7261 large request, Range iterator outside integer range, Recursive inheritance
7262 detected while looking for method '%s' %s, Reference found where even-sized
7263 list expected, Undefined value assigned to typeglob, Use of reserved word
7264 "%s" is deprecated, perl: warning: Setting locale failed
7265
7266 =item Obsolete Diagnostics
7267
7268 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7269 temporary file, regexp too big
7270
7271 =item Configuration Changes
7272
7273 =item BUGS
7274
7275 =item SEE ALSO
7276
7277 =item HISTORY
7278
7279 =back
7280
7281 =head2 perl5004delta - what's new for perl5.004
7282
7283 =over 4
7284
7285 =item DESCRIPTION
7286
7287 =item Supported Environments
7288
7289 =item Core Changes
7290
7291 =over 4
7292
7293 =item List assignment to %ENV works
7294
7295 =item Change to "Can't locate Foo.pm in @INC" error
7296
7297 =item Compilation option: Binary compatibility with 5.003
7298
7299 =item $PERL5OPT environment variable
7300
7301 =item Limitations on B<-M>, B<-m>, and B<-T> options
7302
7303 =item More precise warnings
7304
7305 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7306
7307 =item Previously deprecated %OVERLOAD is no longer usable
7308
7309 =item Subroutine arguments created only when they're modified
7310
7311 =item Group vector changeable with C<$)>
7312
7313 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7314
7315 =item Fixed localization of $<digit>, $&, etc.
7316
7317 =item No resetting of $. on implicit close
7318
7319 =item C<wantarray> may return undef
7320
7321 =item C<eval EXPR> determines value of EXPR in scalar context
7322
7323 =item Changes to tainting checks
7324
7325 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7326 spawning if tainted $TERM doesn't look like a terminal name
7327
7328 =item New Opcode module and revised Safe module
7329
7330 =item Embedding improvements
7331
7332 =item Internal change: FileHandle class based on IO::* classes
7333
7334 =item Internal change: PerlIO abstraction interface
7335
7336 =item New and changed syntax
7337
7338 $coderef->(PARAMS)
7339
7340 =item New and changed builtin constants
7341
7342 __PACKAGE__
7343
7344 =item New and changed builtin variables
7345
7346 $^E, $^H, $^M
7347
7348 =item New and changed builtin functions
7349
7350 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7351 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7352 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7353 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7354 nested C<sub{}> closures work now, formats work right on changing lexicals
7355
7356 =item New builtin methods
7357
7358 isa(CLASS), can(METHOD), VERSION( [NEED] )
7359
7360 =item TIEHANDLE now supported
7361
7362 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7363 LIST, READLINE this, GETC this, DESTROY this
7364
7365 =item Malloc enhancements
7366
7367 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7368
7369 =item Miscellaneous efficiency enhancements
7370
7371 =back
7372
7373 =item Support for More Operating Systems
7374
7375 =over 4
7376
7377 =item Win32
7378
7379 =item Plan 9
7380
7381 =item QNX
7382
7383 =item AmigaOS
7384
7385 =back
7386
7387 =item Pragmata
7388
7389 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7390 constant NAME => VALUE, use locale, use ops, use vmsish
7391
7392 =item Modules
7393
7394 =over 4
7395
7396 =item Required Updates
7397
7398 =item Installation directories
7399
7400 =item Module information summary
7401
7402 =item Fcntl
7403
7404 =item IO
7405
7406 =item Math::Complex
7407
7408 =item Math::Trig
7409
7410 =item DB_File
7411
7412 =item Net::Ping
7413
7414 =item Object-oriented overrides for builtin operators
7415
7416 =back
7417
7418 =item Utility Changes
7419
7420 =over 4
7421
7422 =item pod2html
7423
7424 Sends converted HTML to standard output
7425
7426 =item xsubpp
7427
7428 C<void> XSUBs now default to returning nothing
7429
7430 =back
7431
7432 =item C Language API Changes
7433
7434 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7435 manipulating hashes
7436
7437 =item Documentation Changes
7438
7439 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7440 L<perlmodlib>, L<perldebug>, L<perlsec>
7441
7442 =item New Diagnostics
7443
7444 "my" variable %s masks earlier declaration in same scope, %s argument is
7445 not a HASH element or slice, Allocation too large: %lx, Allocation too
7446 large, Applying %s to %s will act on scalar(%s), Attempt to free
7447 nonexistent shared string, Attempt to use reference as lvalue in substr,
7448 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7449 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7450 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7451 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7452 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7453 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7454 %s, Integer overflow in hex number, Integer overflow in octal number,
7455 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7456 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7457 possible typo, Null picture in formline, Offset outside string, Out of
7458 memory!, Out of memory during request for %s, panic: frexp, Possible
7459 attempt to put comments in qw() list, Possible attempt to separate words
7460 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7461 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7462 option, untie attempted while %d inner references still exist, Unrecognized
7463 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7464 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7465 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7466 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7467 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7468 long, Process terminated by SIG%s
7469
7470 =item BUGS
7471
7472 =item SEE ALSO
7473
7474 =item HISTORY
7475
7476 =back
7477
7478 =head2 perlartistic - the Perl Artistic License
7479
7480 =over 4
7481
7482 =item SYNOPSIS
7483
7484 =item DESCRIPTION
7485
7486 =item The "Artistic License"
7487
7488 =over 4
7489
7490 =item Preamble
7491
7492 =item Definitions
7493
7494 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7495 copying fee", "Freely Available"
7496
7497 =item Conditions
7498
7499 a), b), c), d), a), b), c), d)
7500
7501 =back
7502
7503 =back
7504
7505 =head2 perlgpl - the GNU General Public License, version 2
7506
7507 =over 4
7508
7509 =item SYNOPSIS
7510
7511 =back
7512
7513 =over 4
7514
7515 =item DESCRIPTION
7516
7517 =item GNU GENERAL PUBLIC LICENSE
7518
7519 =back
7520
7521 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7522
7523 =over 4
7524
7525 =item DESCRIPTION
7526
7527 =over 4
7528
7529 =item Compiling Perl 5 on AIX
7530
7531 =item OS level
7532
7533 =item Building Dynamic Extensions on AIX
7534
7535 =item The IBM ANSI C Compiler
7536
7537 =item The usenm option
7538
7539 =item Using GNU's gcc for building perl
7540
7541 =item Using Large Files with Perl
7542
7543 =item Threaded Perl
7544
7545 =item 64-bit Perl
7546
7547 =item AIX 4.2 and extensions using C++ with statics
7548
7549 =back
7550
7551 =item AUTHOR
7552
7553 =item DATE
7554
7555 =back
7556
7557 =head2 perlamiga - Perl under Amiga OS
7558
7559 =over 4
7560
7561 =item NOTE
7562
7563 =item SYNOPSIS
7564
7565 =back
7566
7567 =over 4
7568
7569 =item DESCRIPTION
7570
7571 =over 4
7572
7573 =item Prerequisites for Compiling Perl on AmigaOS
7574
7575 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7576
7577 =item Starting Perl programs under AmigaOS
7578
7579 =item Shortcomings of Perl under AmigaOS
7580
7581 =back
7582
7583 =item INSTALLATION
7584
7585 =item Accessing documentation
7586
7587 =over 4
7588
7589 =item Manpages for Perl on AmigaOS
7590
7591 =item Perl HTML Documentation on AmigaOS
7592
7593 =item Perl GNU Info Files on AmigaOS
7594
7595 =item Perl LaTeX Documentation on AmigaOS
7596
7597 =back
7598
7599 =item BUILDING PERL ON AMIGAOS
7600
7601 =over 4
7602
7603 =item Build Prerequisites for Perl on AmigaOS
7604
7605 =item Getting the Perl Source for AmigaOS
7606
7607 =item Making Perl on AmigaOS
7608
7609 =item Testing Perl on AmigaOS
7610
7611 =item Installing the built Perl on AmigaOS
7612
7613 =back
7614
7615 =item PERL 5.8.0 BROKEN IN AMIGAOS
7616
7617 =item AUTHORS
7618
7619 =item SEE ALSO
7620
7621 =back
7622
7623 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7624
7625 =over 4
7626
7627 =item DESCRIPTION
7628
7629 =item AUTHOR
7630
7631 =back
7632
7633 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7634
7635 =over 4
7636
7637 =item DESCRIPTION
7638
7639 =over 4
7640
7641 =item General Issues with Perl on BeOS
7642
7643 =item BeOS Release-specific Notes
7644
7645 R4 x86, R4 PPC
7646
7647 =item Contact Information
7648
7649 =item Update 2002-05-30
7650
7651 =back
7652
7653 =back
7654
7655 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7656
7657 =over 4
7658
7659 =item SYNOPSIS
7660
7661 =item DESCRIPTION
7662
7663 =over 4
7664
7665 =item gzip on BS2000
7666
7667 =item bison on BS2000
7668
7669 =item Unpacking Perl Distribution on BS2000
7670
7671 =item Compiling Perl on BS2000
7672
7673 =item Testing Perl on BS2000
7674
7675 =item Installing Perl on BS2000
7676
7677 =item Using Perl in the Posix-Shell of BS2000
7678
7679 =item Using Perl in "native" BS2000
7680
7681 =item Floating point anomalies on BS2000
7682
7683 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
7684
7685 =back
7686
7687 =item AUTHORS
7688
7689 =item SEE ALSO
7690
7691 =over 4
7692
7693 =item Mailing list
7694
7695 =back
7696
7697 =item HISTORY
7698
7699 =back
7700
7701 =head2 perlce - Perl for WinCE
7702
7703 =over 4
7704
7705 =item DESCRIPTION
7706
7707 =item BUILD
7708
7709 =over 4
7710
7711 =item Tools & SDK
7712
7713 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7714 celib-sources, Rainer Keuchel's console-sources
7715
7716 =item Make
7717
7718 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
7719   compile.bat dist
7720
7721 =back
7722
7723 =item ACKNOWLEDGEMENTS
7724
7725 =item AUTHORS
7726
7727 =back
7728
7729 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7730
7731 =over 4
7732
7733 =item SYNOPSIS
7734
7735 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7736
7737 =over 4
7738
7739 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7740
7741 =item Cygwin Configuration
7742
7743 C<PATH>, I<nroff>, Permissions
7744
7745 =back
7746
7747 =item CONFIGURE PERL ON CYGWIN
7748
7749 =over 4
7750
7751 =item Stripping Perl Binaries on Cygwin
7752
7753 =item Optional Libraries for Perl on Cygwin
7754
7755 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7756 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7757
7758 =item Configure-time Options for Perl on Cygwin
7759
7760 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7761 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7762 C<-Dmksymlinks>
7763
7764 =item Suspicious Warnings on Cygwin
7765
7766 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7767
7768 =back
7769
7770 =item MAKE ON CYGWIN
7771
7772 =over 4
7773
7774 =item Errors on Cygwin
7775
7776 =item ld2 on Cygwin
7777
7778 =back
7779
7780 =item TEST ON CYGWIN
7781
7782 =over 4
7783
7784 =item File Permissions on Cygwin
7785
7786 =item NDBM_File and ODBM_File do not work on FAT filesystems
7787
7788 =item C<fork()> failures in io_* tests
7789
7790 =item Script Portability on Cygwin
7791
7792 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
7793
7794 =back
7795
7796 =item INSTALL PERL ON CYGWIN
7797
7798 =item MANIFEST ON CYGWIN
7799
7800 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7801 Source, Compiled Module Source, Perl Modules/Scripts
7802
7803 =item BUGS ON CYGWIN
7804
7805 =item AUTHORS
7806
7807 =item HISTORY
7808
7809 =back
7810
7811 =head2 perldgux - Perl under DG/UX.
7812
7813 =over 4
7814
7815 =item SYNOPSIS
7816
7817 =back
7818
7819 =over 4
7820
7821 =item DESCRIPTION
7822
7823 =item BUILDING PERL ON DG/UX
7824
7825 =over 4
7826
7827 =item Non-threaded Perl on DG/UX
7828
7829 =item Threaded Perl on DG/UX
7830
7831 =item Testing Perl on DG/UX
7832
7833 =item Installing the built perl on DG/UX
7834
7835 =back
7836
7837 =item AUTHOR
7838
7839 =item SEE ALSO
7840
7841 =back
7842
7843 =head2 perldos - Perl under DOS, W31, W95.
7844
7845 =over 4
7846
7847 =item SYNOPSIS
7848
7849 =item DESCRIPTION
7850
7851 =over 4
7852
7853 =item Prerequisites for Compiling Perl on DOS
7854
7855 DJGPP, Pthreads
7856
7857 =item Shortcomings of Perl under DOS
7858
7859 =item Building Perl on DOS
7860
7861 =item Testing Perl on DOS
7862
7863 =item Installation of Perl on DOS
7864
7865 =back
7866
7867 =item BUILDING AND INSTALLING MODULES ON DOS
7868
7869 =over 4
7870
7871 =item Building Prerequisites for Perl on DOS
7872
7873 =item Unpacking CPAN Modules on DOS
7874
7875 =item Building Non-XS Modules on DOS
7876
7877 =item Building XS Modules on DOS
7878
7879 =back
7880
7881 =item AUTHOR
7882
7883 =item SEE ALSO
7884
7885 =back
7886
7887 =head2 perlepoc, README.epoc - Perl for EPOC
7888
7889 =over 4
7890
7891 =item SYNOPSIS
7892
7893 =item INTRODUCTION
7894
7895 =item INSTALLING PERL ON EPOC
7896
7897 =item STARTING PERL ON EPOC
7898
7899 =over 4
7900
7901 =item Editors on Epoc
7902
7903 =item Features of Perl on Epoc
7904
7905 =item Restrictions of Perl on Epoc
7906
7907 =item Compiling Perl 5 on the EPOC cross compiling environment
7908
7909 =back
7910
7911 =item SUPPORT STATUS OF PERL ON EPOC
7912
7913 =item AUTHOR
7914
7915 =item LAST UPDATE
7916
7917 =back
7918
7919 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7920
7921 =over 4
7922
7923 =item DESCRIPTION
7924
7925 =over 4
7926
7927 =item FreeBSD core dumps from readdir_r with ithreads
7928
7929 =item $^X doesn't always contain a full path in FreeBSD
7930
7931 =item Perl will no longer be part of "base FreeBSD"
7932
7933 =back
7934
7935 =item AUTHOR
7936
7937 =back
7938
7939 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7940 (HP-UX) systems
7941
7942 =over 4
7943
7944 =item DESCRIPTION
7945
7946 =over 4
7947
7948 =item Using perl as shipped with HP-UX
7949
7950 =item Using perl from HP's porting centre
7951
7952 =item Compiling Perl 5 on HP-UX
7953
7954 =item PA-RISC
7955
7956 =item Portability Between PA-RISC Versions
7957
7958 =item PA-RISC 1.0
7959
7960 =item PA-RISC 1.1
7961
7962 =item PA-RISC 2.0
7963
7964 =item Itanium Processor Family and HP-UX
7965
7966 =item Itanium & Itanium 2
7967
7968 =item Building Dynamic Extensions on HP-UX
7969
7970 =item The HP ANSI C Compiler
7971
7972 =item The GNU C Compiler
7973
7974 =item Using Large Files with Perl on HP-UX
7975
7976 =item Threaded Perl on HP-UX
7977
7978 =item 64-bit Perl on HP-UX
7979
7980 =item Oracle on HP-UX
7981
7982 =item GDBM and Threads on HP-UX
7983
7984 =item NFS filesystems and utime(2) on HP-UX
7985
7986 =item perl -P and // and HP-UX
7987
7988 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7989
7990 =back
7991
7992 =item nss_delete core dump from op/pwent or op/grent
7993
7994 =item AUTHOR
7995
7996 =item DATE
7997
7998 =back
7999
8000 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8001
8002 =over 4
8003
8004 =item DESCRIPTION
8005
8006 =over 4
8007
8008 =item Known Problems with Perl on Hurd 
8009
8010 =back
8011
8012 =item AUTHOR
8013
8014 =back
8015
8016 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8017
8018 =over 4
8019
8020 =item DESCRIPTION
8021
8022 =over 4
8023
8024 =item Building 32-bit Perl in Irix
8025
8026 =item Building 64-bit Perl in Irix
8027
8028 =item About Compiler Versions of Irix
8029
8030 =item Linker Problems in Irix
8031
8032 =item Malloc in Irix
8033
8034 =item Building with threads in Irix
8035
8036 =item Irix 5.3
8037
8038 =back
8039
8040 =item AUTHOR
8041
8042 =back
8043
8044 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8045 systems
8046
8047 =over 4
8048
8049 =item DESCRIPTION
8050
8051 =over 4
8052
8053 =item Perl version 5.8.x and greater not supported
8054
8055 =item Compiling Perl 5.6.x on MachTen
8056
8057 =item Failures during C<make test> on MachTen
8058
8059 op/lexassign.t, pragma/warnings.t
8060
8061 =item Building external modules on MachTen
8062
8063 =back
8064
8065 =item AUTHOR
8066
8067 =item DATE
8068
8069 =back
8070
8071 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8072
8073 =over 4
8074
8075 =item SYNOPSIS
8076
8077 =item DESCRIPTION
8078
8079 =item AUTHOR
8080
8081 =item DATE
8082
8083 =back
8084
8085 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8086
8087 =over 4
8088
8089 =item SYNOPSIS
8090
8091 =item DESCRIPTION
8092
8093 =over 4
8094
8095 =item Installation Prefix
8096
8097 =item libperl and Prebinding
8098
8099 =item Updating Panther
8100
8101 =item Known problems
8102
8103 =item MacPerl
8104
8105 =item Carbon
8106
8107 =item Cocoa
8108
8109 =back
8110
8111 =item Starting From Scratch
8112
8113 =item AUTHOR
8114
8115 =item DATE
8116
8117 =back
8118
8119 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8120
8121 =over 4
8122
8123 =item DESCRIPTION
8124
8125 =item Known problems with Perl on MiNT
8126
8127 =item AUTHOR
8128
8129 =back
8130
8131 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8132
8133 =over 4
8134
8135 =item SYNOPSIS
8136
8137 =item NOTE
8138
8139 =item Binary distribution from HP
8140
8141 =item What's New in Perl for MPE/iX
8142
8143 =item Welcome to Perl/iX
8144
8145 =item System Requirements for Perl/iX
8146
8147 =item How to Obtain Perl/iX
8148
8149 =item Perl/iX Distribution Contents Highlights
8150
8151 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8152 public_html/feedback.cgi, src/perl-5.6.0-mpe
8153
8154 =item How to Compile Perl/iX
8155
8156  4,  6
8157
8158 =item Getting Started with Perl/iX
8159
8160 =item MPE/iX Implementation Considerations
8161
8162 =item Known Perl/iX Bugs Under Investigation
8163
8164 =item Perl/iX To-Do List
8165
8166 =item Perl/iX Change History
8167
8168 =item AUTHOR
8169
8170 =back
8171
8172 =head2 perlnetware - Perl for NetWare
8173
8174 =over 4
8175
8176 =item DESCRIPTION
8177
8178 =item BUILD
8179
8180 =over 4
8181
8182 =item Tools & SDK
8183
8184 =item Setup
8185
8186 SetNWBld.bat, Buildtype.bat
8187
8188 =item Make
8189
8190 =item Interpreter
8191
8192 =item Extensions
8193
8194 =back
8195
8196 =item INSTALL
8197
8198 =item BUILD NEW EXTENSIONS
8199
8200 =item ACKNOWLEDGEMENTS
8201
8202 =item AUTHORS
8203
8204 =item DATE
8205
8206 =back
8207
8208 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8209
8210 =over 4
8211
8212 =item SYNOPSIS
8213
8214 =back
8215
8216 =over 4
8217
8218 =item DESCRIPTION
8219
8220 =over 4
8221
8222 =item Target
8223
8224 =item Other OSes
8225
8226 =item Prerequisites
8227
8228 EMX, RSX, HPFS, pdksh
8229
8230 =item Starting Perl programs under OS/2 (and DOS and...)
8231
8232 =item Starting OS/2 (and DOS) programs under Perl
8233
8234 =back
8235
8236 =item Frequently asked questions
8237
8238 =over 4
8239
8240 =item "It does not work"
8241
8242 =item I cannot run external programs
8243
8244 =item I cannot embed perl into my program, or use F<perl.dll> from my
8245 program. 
8246
8247 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8248 L<ExtUtils::Embed>?
8249
8250 =item C<``> and pipe-C<open> do not work under DOS.
8251
8252 =item Cannot start C<find.exe "pattern" file>
8253
8254 =back
8255
8256 =item INSTALLATION
8257
8258 =over 4
8259
8260 =item Automatic binary installation
8261
8262 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8263
8264 =item Manual binary installation
8265
8266 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8267 (statically linked), Executables for Perl utilities, Main Perl library,
8268 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8269 and utilities, Manpages for Perl modules, Source for Perl documentation,
8270 Perl manual in F<.INF> format, Pdksh
8271
8272 =item B<Warning>
8273
8274 =back
8275
8276 =item Accessing documentation
8277
8278 =over 4
8279
8280 =item OS/2 F<.INF> file
8281
8282 =item Plain text
8283
8284 =item Manpages
8285
8286 =item HTML
8287
8288 =item GNU C<info> files
8289
8290 =item F<PDF> files
8291
8292 =item C<LaTeX> docs
8293
8294 =back
8295
8296 =item BUILD
8297
8298 =over 4
8299
8300 =item The short story
8301
8302 =item Prerequisites
8303
8304 =item Getting perl source
8305
8306 =item Application of the patches
8307
8308 =item Hand-editing
8309
8310 =item Making
8311
8312 =item Testing
8313
8314 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8315 F<op/stat.t>
8316
8317 =item Installing the built perl
8318
8319 =item C<a.out>-style build
8320
8321 =back
8322
8323 =item Building a binary distribution
8324
8325 =item Building custom F<.EXE> files
8326
8327 =over 4
8328
8329 =item Making executables with a custom collection of statically loaded
8330 extensions
8331
8332 =item Making executables with a custom search-paths
8333
8334 =back
8335
8336 =item Build FAQ
8337
8338 =over 4
8339
8340 =item Some C</> became C<\> in pdksh.
8341
8342 =item C<'errno'> - unresolved external
8343
8344 =item Problems with tr or sed
8345
8346 =item Some problem (forget which ;-)
8347
8348 =item Library ... not found
8349
8350 =item Segfault in make
8351
8352 =item op/sprintf test failure
8353
8354 =back
8355
8356 =item Specific (mis)features of OS/2 port
8357
8358 =over 4
8359
8360 =item C<setpriority>, C<getpriority>
8361
8362 =item C<system()>
8363
8364 =item C<extproc> on the first line
8365
8366 =item Additional modules:
8367
8368 =item Prebuilt methods:
8369
8370 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8371  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8372 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8373 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8374 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8375 C<Cwd::extLibpath_set( path [, type ] )>,
8376 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8377 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8378 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8379 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8380 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8381 C<OS2::DLLname([how [, \&xsub]])>
8382
8383 =item Prebuilt variables:
8384
8385 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8386 $OS2::nsyserror
8387
8388 =item Misfeatures
8389
8390 =item Modifications
8391
8392 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8393 C<flock>
8394
8395 =item Identifying DLLs
8396
8397 =item Centralized management of resources
8398
8399 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8400 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8401 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8402 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8403
8404 =back
8405
8406 =item Perl flavors
8407
8408 =over 4
8409
8410 =item F<perl.exe>
8411
8412 =item F<perl_.exe>
8413
8414 =item F<perl__.exe>
8415
8416 =item F<perl___.exe>
8417
8418 =item Why strange names?
8419
8420 =item Why dynamic linking?
8421
8422 =item Why chimera build?
8423
8424 =back
8425
8426 =item ENVIRONMENT
8427
8428 =over 4
8429
8430 =item C<PERLLIB_PREFIX>
8431
8432 =item C<PERL_BADLANG>
8433
8434 =item C<PERL_BADFREE>
8435
8436 =item C<PERL_SH_DIR>
8437
8438 =item C<USE_PERL_FLOCK>
8439
8440 =item C<TMP> or C<TEMP>
8441
8442 =back
8443
8444 =item Evolution
8445
8446 =over 4
8447
8448 =item Text-mode filehandles
8449
8450 =item Priorities
8451
8452 =item DLL name mangling: pre 5.6.2
8453
8454 =item DLL name mangling: 5.6.2 and beyond
8455
8456 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8457 C<LIBPATH>
8458
8459 =item DLL forwarder generation
8460
8461 =item Threading
8462
8463 =item Calls to external programs
8464
8465 =item Memory allocation
8466
8467 =item Threads
8468
8469 C<COND_WAIT>, F<os2.c>
8470
8471 =back
8472
8473 =item BUGS
8474
8475 =back
8476
8477 =over 4
8478
8479 =item AUTHOR
8480
8481 =item SEE ALSO
8482
8483 =back
8484
8485 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8486 and z/OS
8487
8488 =over 4
8489
8490 =item SYNOPSIS
8491
8492 =item DESCRIPTION
8493
8494 =over 4
8495
8496 =item Tools
8497
8498 =item Unpacking Perl distribution on OS/390
8499
8500 =item Setup and utilities for Perl on OS/390
8501
8502 =item Configure Perl on OS/390
8503
8504 =item Build, Test, Install Perl on OS/390
8505
8506 =item Build Anomalies with Perl on OS/390
8507
8508 =item Testing Anomalies with Perl on OS/390
8509
8510 =item Installation Anomalies with Perl on OS/390
8511
8512 =item Usage Hints for Perl on OS/390
8513
8514 =item Floating Point Anomalies with Perl on OS/390
8515
8516 =item Modules and Extensions for Perl on OS/390
8517
8518 =back
8519
8520 =item AUTHORS
8521
8522 =item SEE ALSO
8523
8524 =over 4
8525
8526 =item Mailing list for Perl on OS/390
8527
8528 =back
8529
8530 =item HISTORY
8531
8532 =back
8533
8534 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8535
8536 =over 4
8537
8538 =item DESCRIPTION
8539
8540 =over 4
8541
8542 =item Compiling Perl for OS/400 PASE
8543
8544 =item Installing Perl in OS/400 PASE
8545
8546 =item Using Perl in OS/400 PASE
8547
8548 =item Known Problems
8549
8550 =item Perl on ILE
8551
8552 =back
8553
8554 =item AUTHORS
8555
8556 =back
8557
8558 =head2 perlplan9 - Plan 9-specific documentation for Perl
8559
8560 =over 4
8561
8562 =item DESCRIPTION
8563
8564 =over 4
8565
8566 =item Invoking Perl
8567
8568 =item What's in Plan 9 Perl
8569
8570 =item What's not in Plan 9 Perl
8571
8572 =item Perl5 Functions not currently supported in Plan 9 Perl
8573
8574 =item Signals in Plan 9 Perl
8575
8576 =back
8577
8578 =item COMPILING AND INSTALLING PERL ON PLAN 9
8579
8580 =over 4
8581
8582 =item Installing Perl Documentation on Plan 9
8583
8584 =back
8585
8586 =item BUGS
8587
8588 =item Revision date
8589
8590 =item AUTHOR
8591
8592 =back
8593
8594 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8595
8596 =over 4
8597
8598 =item DESCRIPTION
8599
8600 =over 4
8601
8602 =item Required Software for Compiling Perl on QNX4
8603
8604 /bin/sh, ar, nm, cpp, make
8605
8606 =item Outstanding Issues with Perl on QNX4
8607
8608 =item QNX auxiliary files
8609
8610 qnx/ar, qnx/cpp
8611
8612 =item Outstanding issues with perl under QNX6
8613
8614 =back
8615
8616 =item AUTHOR
8617
8618 =back
8619
8620 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8621
8622 =over 4
8623
8624 =item DESCRIPTION
8625
8626 =over 4
8627
8628 =item Solaris Version Numbers.
8629
8630 =back
8631
8632 =item RESOURCES
8633
8634 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8635
8636 =item SETTING UP
8637
8638 =over 4
8639
8640 =item File Extraction Problems on Solaris.
8641
8642 =item Compiler and Related Tools on Solaris.
8643
8644 =item Environment for Compiling perl on Solaris
8645
8646 =back
8647
8648 =item RUN CONFIGURE.
8649
8650 =over 4
8651
8652 =item 64-bit perl on Solaris.
8653
8654 =item Threads in perl on Solaris.
8655
8656 =item Malloc Issues with perl on Solaris.
8657
8658 =back
8659
8660 =item MAKE PROBLEMS.
8661
8662 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8663 relocation error:, dlopen: stub interception failed, #error "No
8664 DATAMODEL_NATIVE specified", sh: ar: not found
8665
8666 =item MAKE TEST
8667
8668 =over 4
8669
8670 =item op/stat.t test 4 in Solaris
8671
8672 =item nss_delete core dump from op/pwent or op/grent
8673
8674 =back
8675
8676 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8677
8678 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8679
8680 =over 4
8681
8682 =item Limits on Numbers of Open Files on Solaris.
8683
8684 =back
8685
8686 =item SOLARIS-SPECIFIC MODULES.
8687
8688 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8689
8690 =over 4
8691
8692 =item Proc::ProcessTable on Solaris
8693
8694 =item BSD::Resource on Solaris
8695
8696 =item Net::SSLeay on Solaris
8697
8698 =back
8699
8700 =item SunOS 4.x
8701
8702 =item AUTHOR
8703
8704 =item LAST MODIFIED
8705
8706 =back
8707
8708 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8709 Digital UNIX formerly known as DEC OSF/1) systems
8710
8711 =over 4
8712
8713 =item DESCRIPTION
8714
8715 =over 4
8716
8717 =item Compiling Perl 5 on Tru64
8718
8719 =item Using Large Files with Perl on Tru64
8720
8721 =item Threaded Perl on Tru64
8722
8723 =item Long Doubles on Tru64
8724
8725 =item DB_File tests failing on Tru64
8726
8727 =item 64-bit Perl on Tru64
8728
8729 =item Warnings about floating-point overflow when compiling Perl on Tru64
8730
8731 =back
8732
8733 =item Testing Perl on Tru64
8734
8735 =item ext/ODBM_File/odbm Test Failing With Static Builds
8736
8737 =item Perl Fails Because Of Unresolved Symbol sockatmark
8738
8739 =item AUTHOR
8740
8741 =back
8742
8743 =head2 perluts - Perl under UTS
8744
8745 =over 4
8746
8747 =item SYNOPSIS
8748
8749 =item DESCRIPTION
8750
8751 =item BUILDING PERL ON UTS
8752
8753 =item Installing the built perl on UTS
8754
8755 =item AUTHOR
8756
8757 =back
8758
8759 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8760
8761 =over 4
8762
8763 =item SYNOPSIS
8764
8765 =item DESCRIPTION
8766
8767 =over 4
8768
8769 =item Unpacking Perl Distribution on VM/ESA
8770
8771 =item Setup Perl and utilities on VM/ESA
8772
8773 =item Configure Perl on VM/ESA
8774
8775 =item Testing Anomalies of Perl on VM/ESA
8776
8777 =item Usage Hints for Perl on VM/ESA
8778
8779 =back
8780
8781 =item AUTHORS
8782
8783 =item SEE ALSO
8784
8785 =over 4
8786
8787 =item Mailing list for Perl on VM/ESA
8788
8789 =back
8790
8791 =back
8792
8793 =head2 perlvms - VMS-specific documentation for Perl
8794
8795 =over 4
8796
8797 =item DESCRIPTION
8798
8799 =item Installation
8800
8801 =item Organization of Perl Images
8802
8803 =over 4
8804
8805 =item Core Images
8806
8807 =item Perl Extensions
8808
8809 =item Installing static extensions
8810
8811 =item Installing dynamic extensions
8812
8813 =back
8814
8815 =item File specifications
8816
8817 =over 4
8818
8819 =item Syntax
8820
8821 =item Wildcard expansion
8822
8823 =item Pipes
8824
8825 =back
8826
8827 =item PERL5LIB and PERLLIB
8828
8829 =item Command line
8830
8831 =over 4
8832
8833 =item I/O redirection and backgrounding
8834
8835 =item Command line switches
8836
8837 -i, -S, -u
8838
8839 =back
8840
8841 =item Perl functions
8842
8843 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8844 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8845 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8846 LIST, waitpid PID,FLAGS
8847
8848 =item Perl variables
8849
8850 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8851
8852 =item Standard modules with VMS-specific differences
8853
8854 =over 4
8855
8856 =item SDBM_File
8857
8858 =back
8859
8860 =item Revision date
8861
8862 =item AUTHOR
8863
8864 =back
8865
8866 =head2 perlvos, README.vos - Perl for Stratus VOS
8867
8868 =over 4
8869
8870 =item SYNOPSIS
8871
8872 =over 4
8873
8874 =item Multiple methods to build perl for VOS
8875
8876 =item Stratus POSIX Support
8877
8878 =back
8879
8880 =item INSTALLING PERL IN VOS
8881
8882 =over 4
8883
8884 =item Compiling Perl 5 on VOS
8885
8886 =item Installing Perl 5 on VOS
8887
8888 =back
8889
8890 =item USING PERL IN VOS
8891
8892 =over 4
8893
8894 =item Unimplemented Features of Perl on VOS
8895
8896 =item Restrictions of Perl on VOS
8897
8898 =item Handling of underflow and overflow
8899
8900 =back
8901
8902 =item TEST STATUS
8903
8904 =item SUPPORT STATUS
8905
8906 =item AUTHOR
8907
8908 =item LAST UPDATE
8909
8910 =back
8911
8912 =head2 perlwin32 - Perl under Windows
8913
8914 =over 4
8915
8916 =item SYNOPSIS
8917
8918 =item DESCRIPTION
8919
8920 =over 4
8921
8922 =item Setting Up Perl on Win32
8923
8924 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
8925 C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3
8926 with gcc, MinGW release 1 with gcc
8927
8928 =item Building
8929
8930 =item Testing Perl on Win32
8931
8932 =item Installation of Perl on Win32
8933
8934 =item Usage Hints for Perl on Win32
8935
8936 Environment Variables, File Globbing, Using perl from the command line,
8937 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8938 Extensions, Notes on 64-bit Windows
8939
8940 =item Running Perl Scripts
8941
8942 =item Miscellaneous Things
8943
8944 =back
8945
8946 =item BUGS AND CAVEATS
8947
8948 =item ACKNOWLEDGEMENTS
8949
8950 =item AUTHORS
8951
8952 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8953 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8954 E<lt>nick@ing-simmons.netE<gt>
8955
8956 =item SEE ALSO
8957
8958 =item HISTORY
8959
8960 =back
8961
8962 =head1 PRAGMA DOCUMENTATION
8963
8964 =head2 attrs - set/get attributes of a subroutine (deprecated)
8965
8966 =over 4
8967
8968 =item SYNOPSIS
8969
8970 =item DESCRIPTION
8971
8972 method, locked
8973
8974 =back
8975
8976 =head2 re - Perl pragma to alter regular expression behaviour
8977
8978 =over 4
8979
8980 =item SYNOPSIS
8981
8982 =item DESCRIPTION
8983
8984 =back
8985
8986 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8987 data structures between threads
8988
8989 =over 4
8990
8991 =item SYNOPSIS
8992
8993 =item DESCRIPTION
8994
8995 =item EXPORT
8996
8997 =item FUNCTIONS
8998
8999 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9000 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9001 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9002
9003 =item NOTES
9004
9005 =item BUGS
9006
9007 =item AUTHOR
9008
9009 =item SEE ALSO
9010
9011 =back
9012
9013 =head2 threads - Perl extension allowing use of interpreter based threads
9014 from perl
9015
9016 =over 4
9017
9018 =item SYNOPSIS
9019
9020 =item DESCRIPTION
9021
9022 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9023 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9024 threads->list();, async BLOCK;
9025
9026 =item WARNINGS
9027
9028 A thread exited while %d other threads were still running
9029
9030 =item TODO
9031
9032 =item BUGS
9033
9034 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9035 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9036
9037 =item AUTHOR and COPYRIGHT
9038
9039 =item SEE ALSO
9040
9041 =back
9042
9043 =head2 attributes - get/set subroutine or variable attributes
9044
9045 =over 4
9046
9047 =item SYNOPSIS
9048
9049 =item DESCRIPTION
9050
9051 =over 4
9052
9053 =item Built-in Attributes
9054
9055 locked, method, lvalue
9056
9057 =item Available Subroutines
9058
9059 get, reftype
9060
9061 =item Package-specific Attribute Handling
9062
9063 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9064
9065 =item Syntax of Attribute Lists
9066
9067 =back
9068
9069 =item EXPORTS
9070
9071 =over 4
9072
9073 =item Default exports
9074
9075 =item Available exports
9076
9077 =item Export tags defined
9078
9079 =back
9080
9081 =item EXAMPLES
9082
9083 =item SEE ALSO
9084
9085 =back
9086
9087 =head2 autouse - postpone load of modules until a function is used
9088
9089 =over 4
9090
9091 =item SYNOPSIS
9092
9093 =item DESCRIPTION
9094
9095 =item WARNING
9096
9097 =item AUTHOR
9098
9099 =item SEE ALSO
9100
9101 =back
9102
9103 =head2 base - Establish IS-A relationship with base classes at compile time
9104
9105 =over 4
9106
9107 =item SYNOPSIS
9108
9109 =item DESCRIPTION
9110
9111 =item DIAGNOSTICS
9112
9113 Base class package "%s" is empty
9114
9115 =item HISTORY
9116
9117 =item CAVEATS
9118
9119 =item SEE ALSO
9120
9121 =back
9122
9123 =head2 bigint - Transparent BigInteger support for Perl
9124
9125 =over 4
9126
9127 =item SYNOPSIS
9128
9129 =item DESCRIPTION
9130
9131 =over 4
9132
9133 =item OPTIONS
9134
9135 a or accuracy, p or precision, t or trace, l or lib, v or version
9136
9137 =item MATH LIBRARY
9138
9139 =item INTERNAL FORMAT
9140
9141 =item SIGN
9142
9143 =item METHODS
9144
9145 =item CAVEAT
9146
9147 =back
9148
9149 =item MODULES USED
9150
9151 =item EXAMPLES
9152
9153 =item LICENSE
9154
9155 =item SEE ALSO
9156
9157 =item AUTHORS
9158
9159 =back
9160
9161 =head2 bignum - Transparent BigNumber support for Perl
9162
9163 =over 4
9164
9165 =item SYNOPSIS
9166
9167 =item DESCRIPTION
9168
9169 =over 4
9170
9171 =item OPTIONS
9172
9173 a or accuracy, p or precision, t or trace, l or lib, v or version
9174
9175 =item METHODS
9176
9177 =item CAVEAT
9178
9179 inf(), NaN(), upgrade()
9180
9181 =item MATH LIBRARY
9182
9183 =item INTERNAL FORMAT
9184
9185 =item SIGN
9186
9187 =back
9188
9189 =item MODULES USED
9190
9191 =item EXAMPLES
9192
9193 =item LICENSE
9194
9195 =item SEE ALSO
9196
9197 =item AUTHORS
9198
9199 =back
9200
9201 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
9202
9203 =over 4
9204
9205 =item SYNOPSIS
9206
9207 =item DESCRIPTION
9208
9209 =over 4
9210
9211 =item MODULES USED
9212
9213 =item MATH LIBRARY
9214
9215 =item SIGN
9216
9217 =item METHODS
9218
9219 =item CAVEAT
9220
9221 =back
9222
9223 =item EXAMPLES
9224
9225         perl -Mbigrat -le 'print sqrt(33)'
9226         perl -Mbigrat -le 'print 2*255'
9227         perl -Mbigrat -le 'print 4.5+2*255'
9228         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
9229         perl -Mbigrat -le 'print 12->is_odd()';
9230
9231 =item LICENSE
9232
9233 =item SEE ALSO
9234
9235 =item AUTHORS
9236
9237 =back
9238
9239 =head2 blib - Use MakeMaker's uninstalled version of a package
9240
9241 =over 4
9242
9243 =item SYNOPSIS
9244
9245 =item DESCRIPTION
9246
9247 =item BUGS
9248
9249 =item AUTHOR
9250
9251 =back
9252
9253 =head2 bytes - Perl pragma to force byte semantics rather than character
9254 semantics
9255
9256 =over 4
9257
9258 =item SYNOPSIS
9259
9260 =item DESCRIPTION
9261
9262 =item LIMITATIONS
9263
9264 =item SEE ALSO
9265
9266 =back
9267
9268 =head2 charnames - define character names for C<\N{named}> string literal
9269 escapes
9270
9271 =over 4
9272
9273 =item SYNOPSIS
9274
9275 =item DESCRIPTION
9276
9277 =item CUSTOM TRANSLATORS
9278
9279 =item CUSTOM ALIASES
9280
9281 =over 4
9282
9283 =item Anonymous hashes
9284
9285 =item Alias file
9286
9287 =item Alias shortcut
9288
9289 =back
9290
9291 =item charnames::viacode(code)
9292
9293 =item charnames::vianame(name)
9294
9295 =item ALIASES
9296
9297 =item ILLEGAL CHARACTERS
9298
9299 =item BUGS
9300
9301 =back
9302
9303 =head2 constant - Perl pragma to declare constants
9304
9305 =over 4
9306
9307 =item SYNOPSIS
9308
9309 =item DESCRIPTION
9310
9311 =item NOTES
9312
9313 =over 4
9314
9315 =item List constants
9316
9317 =item Defining multiple constants at once
9318
9319 =item Magic constants
9320
9321 =back
9322
9323 =item TECHNICAL NOTES
9324
9325 =item BUGS
9326
9327 =item AUTHOR
9328
9329 =item COPYRIGHT
9330
9331 =back
9332
9333 =head2 diagnostics, splain - produce verbose warning diagnostics
9334
9335 =over 4
9336
9337 =item SYNOPSIS
9338
9339 =item DESCRIPTION
9340
9341 =over 4
9342
9343 =item The C<diagnostics> Pragma
9344
9345 =item The I<splain> Program
9346
9347 =back
9348
9349 =item EXAMPLES
9350
9351 =item INTERNALS
9352
9353 =item BUGS
9354
9355 =item AUTHOR
9356
9357 =back
9358
9359 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9360
9361 =over 4
9362
9363 =item SYNOPSIS
9364
9365 =item ABSTRACT
9366
9367 =over 4
9368
9369 =item Literal Conversions
9370
9371 =item PerlIO layers for C<STD(IN|OUT)>
9372
9373 =item Implicit upgrading for byte strings
9374
9375 =back
9376
9377 =item FEATURES THAT REQUIRE 5.8.1
9378
9379 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9380
9381 =item USAGE
9382
9383 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9384 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9385
9386 =item The Filter Option
9387
9388 =over 4
9389
9390 =item Filter-related changes at Encode version 1.87
9391
9392 =back
9393
9394 =item CAVEATS
9395
9396 =over 4
9397
9398 =item NOT SCOPED
9399
9400 =item DO NOT MIX MULTIPLE ENCODINGS
9401
9402 =item tr/// with ranges
9403
9404 Legend of characters above
9405
9406 =back
9407
9408 =item EXAMPLE - Greekperl
9409
9410 =item KNOWN PROBLEMS
9411
9412 literals in regex that are longer than 127 bytes, EBCDIC, format
9413
9414 =over 4
9415
9416 =item The Logic of :locale
9417
9418 =back
9419
9420 =item HISTORY
9421
9422 =item SEE ALSO
9423
9424 =back
9425
9426 =head2 fields - compile-time class fields
9427
9428 =over 4
9429
9430 =item SYNOPSIS
9431
9432 =item DESCRIPTION
9433
9434 new, phash
9435
9436 =item SEE ALSO
9437
9438 =back
9439
9440 =head2 filetest - Perl pragma to control the filetest permission operators
9441
9442 =over 4
9443
9444 =item SYNOPSIS
9445
9446 =item DESCRIPTION
9447
9448 =over 4
9449
9450 =item subpragma access
9451
9452 =back
9453
9454 =back
9455
9456 =head2 if - C<use> a Perl module if a condition holds
9457
9458 =over 4
9459
9460 =item SYNOPSIS
9461
9462 =item DESCRIPTION
9463
9464 =item BUGS
9465
9466 =item AUTHOR
9467
9468 =back
9469
9470 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9471 point
9472
9473 =over 4
9474
9475 =item SYNOPSIS
9476
9477 =item DESCRIPTION
9478
9479 =back
9480
9481 =head2 less - perl pragma to request less of something from the compiler
9482
9483 =over 4
9484
9485 =item SYNOPSIS
9486
9487 =item DESCRIPTION
9488
9489 =back
9490
9491 =head2 lib - manipulate @INC at compile time
9492
9493 =over 4
9494
9495 =item SYNOPSIS
9496
9497 =item DESCRIPTION
9498
9499 =over 4
9500
9501 =item Adding directories to @INC
9502
9503 =item Deleting directories from @INC
9504
9505 =item Restoring original @INC
9506
9507 =back
9508
9509 =item CAVEATS
9510
9511 =item NOTES
9512
9513 =item SEE ALSO
9514
9515 =item AUTHOR
9516
9517 =back
9518
9519 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9520 operations
9521
9522 =over 4
9523
9524 =item SYNOPSIS
9525
9526 =item DESCRIPTION
9527
9528 =back
9529
9530 =head2 open - perl pragma to set default PerlIO layers for input and output
9531
9532 =over 4
9533
9534 =item SYNOPSIS
9535
9536 =item DESCRIPTION
9537
9538 =item NONPERLIO FUNCTIONALITY
9539
9540 =item IMPLEMENTATION DETAILS
9541
9542 =item SEE ALSO
9543
9544 =back
9545
9546 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9547
9548 =over 4
9549
9550 =item SYNOPSIS  
9551
9552 =item DESCRIPTION
9553
9554 =item SEE ALSO
9555
9556 =back
9557
9558 =head2 overload - Package for overloading perl operations
9559
9560 =over 4
9561
9562 =item SYNOPSIS
9563
9564 =item DESCRIPTION
9565
9566 =over 4
9567
9568 =item Declaration of overloaded functions
9569
9570 =item Calling Conventions for Binary Operations
9571
9572 FALSE, TRUE, C<undef>
9573
9574 =item Calling Conventions for Unary Operations
9575
9576 =item Calling Conventions for Mutators
9577
9578 C<++> and C<-->, C<x=> and other assignment versions
9579
9580 =item Overloadable Operations
9581
9582 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9583 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9584 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9585
9586 =item Inheritance and overloading
9587
9588 Strings as values of C<use overload> directive, Overloading of an operation
9589 is inherited by derived classes
9590
9591 =back
9592
9593 =item SPECIAL SYMBOLS FOR C<use overload>
9594
9595 =over 4
9596
9597 =item Last Resort
9598
9599 =item Fallback
9600
9601 C<undef>, TRUE, defined, but FALSE
9602
9603 =item Copy Constructor
9604
9605 B<Example>
9606
9607 =back
9608
9609 =item MAGIC AUTOGENERATION
9610
9611 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9612 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9613 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9614 I<Copy operator>
9615
9616 =item Losing overloading
9617
9618 =item Run-time Overloading
9619
9620 =item Public functions
9621
9622 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9623
9624 =item Overloading constants
9625
9626 integer, float, binary, q, qr
9627
9628 =item IMPLEMENTATION
9629
9630 =item Metaphor clash
9631
9632 =item Cookbook
9633
9634 =over 4
9635
9636 =item Two-face scalars
9637
9638 =item Two-face references
9639
9640 =item Symbolic calculator
9641
9642 =item I<Really> symbolic calculator
9643
9644 =back
9645
9646 =item AUTHOR
9647
9648 =item DIAGNOSTICS
9649
9650 Odd number of arguments for overload::constant, `%s' is not an overloadable
9651 type, `%s' is not a code reference
9652
9653 =item BUGS
9654
9655 =back
9656
9657 =head2 sigtrap - Perl pragma to enable simple signal handling
9658
9659 =over 4
9660
9661 =item SYNOPSIS
9662
9663 =item DESCRIPTION
9664
9665 =item OPTIONS
9666
9667 =over 4
9668
9669 =item SIGNAL HANDLERS
9670
9671 B<stack-trace>, B<die>, B<handler> I<your-handler>
9672
9673 =item SIGNAL LISTS
9674
9675 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9676
9677 =item OTHER
9678
9679 B<untrapped>, B<any>, I<signal>, I<number>
9680
9681 =back
9682
9683 =item EXAMPLES
9684
9685 =back
9686
9687 =head2 sort - perl pragma to control sort() behaviour
9688
9689 =over 4
9690
9691 =item SYNOPSIS
9692
9693 =item DESCRIPTION
9694
9695 =item CAVEATS
9696
9697 =back
9698
9699 =head2 strict - Perl pragma to restrict unsafe constructs
9700
9701 =over 4
9702
9703 =item SYNOPSIS
9704
9705 =item DESCRIPTION
9706
9707 C<strict refs>, C<strict vars>, C<strict subs>
9708
9709 =item HISTORY
9710
9711 =back
9712
9713 =head2 subs - Perl pragma to predeclare sub names
9714
9715 =over 4
9716
9717 =item SYNOPSIS
9718
9719 =item DESCRIPTION
9720
9721 =back
9722
9723 =head2 threadshared, threads::shared - Perl extension for sharing data
9724 structures between threads
9725
9726 =over 4
9727
9728 =item SYNOPSIS
9729
9730 =item DESCRIPTION
9731
9732 =item EXPORT
9733
9734 =item FUNCTIONS
9735
9736 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9737 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9738 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9739
9740 =item NOTES
9741
9742 =item BUGS
9743
9744 =item AUTHOR
9745
9746 =item SEE ALSO
9747
9748 =back
9749
9750 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9751 code
9752
9753 =over 4
9754
9755 =item SYNOPSIS
9756
9757 =item DESCRIPTION
9758
9759 =over 4
9760
9761 =item Utility functions
9762
9763 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
9764 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
9765 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
9766
9767 =back
9768
9769 =item BUGS
9770
9771 =item SEE ALSO
9772
9773 =back
9774
9775 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9776
9777 =over 4
9778
9779 =item SYNOPSIS
9780
9781 =item DESCRIPTION
9782
9783 =back
9784
9785 =head2 vmsish - Perl pragma to control VMS-specific language features
9786
9787 =over 4
9788
9789 =item SYNOPSIS
9790
9791 =item DESCRIPTION
9792
9793 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9794
9795 =back
9796
9797 =head2 warnings - Perl pragma to control optional warnings
9798
9799 =over 4
9800
9801 =item SYNOPSIS
9802
9803 =item DESCRIPTION
9804
9805 use warnings::register, warnings::enabled(), warnings::enabled($category),
9806 warnings::enabled($object), warnings::warn($message),
9807 warnings::warn($category, $message), warnings::warn($object, $message),
9808 warnings::warnif($message), warnings::warnif($category, $message),
9809 warnings::warnif($object, $message)
9810
9811 =back
9812
9813 =head2 warnings::register - warnings import function
9814
9815 =over 4
9816
9817 =item SYNOPSIS
9818
9819 =item DESCRIPTION
9820
9821 =back
9822
9823 =head1 MODULE DOCUMENTATION
9824
9825 =head2 AnyDBM_File - provide framework for multiple DBMs
9826
9827 =over 4
9828
9829 =item SYNOPSIS
9830
9831 =item DESCRIPTION
9832
9833 =over 4
9834
9835 =item DBM Comparisons
9836
9837 [0], [1], [2], [3]
9838
9839 =back
9840
9841 =item SEE ALSO
9842
9843 =back
9844
9845 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9846
9847 =over 4
9848
9849 =item VERSION
9850
9851 =item SYNOPSIS
9852
9853 =item DESCRIPTION
9854
9855 [0], [1], [2], [3], [4], [5]
9856
9857 =over 4
9858
9859 =item Typed lexicals
9860
9861 =item Type-specific attribute handlers
9862
9863 =item Non-interpretive attribute handlers
9864
9865 =item Phase-specific attribute handlers
9866
9867 =item Attributes as C<tie> interfaces
9868
9869 =back
9870
9871 =item EXAMPLES
9872
9873 =item DIAGNOSTICS
9874
9875 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9876 attributes>, C<Declaration of %s attribute in package %s may clash with
9877 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9878 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9879 be able to apply END handler>
9880
9881 =item AUTHOR
9882
9883 =item BUGS
9884
9885 =item COPYRIGHT
9886
9887 =back
9888
9889 =head2 AutoLoader - load subroutines only on demand
9890
9891 =over 4
9892
9893 =item SYNOPSIS
9894
9895 =item DESCRIPTION
9896
9897 =over 4
9898
9899 =item Subroutine Stubs
9900
9901 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9902
9903 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9904
9905 =item Package Lexicals
9906
9907 =item Not Using AutoLoader
9908
9909 =item B<AutoLoader> vs. B<SelfLoader>
9910
9911 =back
9912
9913 =item CAVEATS
9914
9915 =item SEE ALSO
9916
9917 =back
9918
9919 =head2 AutoSplit - split a package for autoloading
9920
9921 =over 4
9922
9923 =item SYNOPSIS
9924
9925 =item DESCRIPTION
9926
9927 $keep, $check, $modtime
9928
9929 =over 4
9930
9931 =item Multiple packages
9932
9933 =back
9934
9935 =item DIAGNOSTICS
9936
9937 =back
9938
9939 =head2 B - The Perl Compiler
9940
9941 =over 4
9942
9943 =item SYNOPSIS
9944
9945 =item DESCRIPTION
9946
9947 =item OVERVIEW
9948
9949 =item Utility Functions
9950
9951 =over 4
9952
9953 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
9954 objects
9955
9956 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
9957 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
9958
9959 =item Functions for Examining the Symbol Table
9960
9961 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
9962
9963 =item Functions Returning C<B::OP> objects or for walking op trees
9964
9965 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
9966
9967 =item Miscellaneous Utility Functions
9968
9969 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
9970 perlstring(STR), class(OBJ), threadsv_names
9971
9972 =back
9973
9974 =item OVERVIEW OF CLASSES
9975
9976 =over 4
9977
9978 =item SV-RELATED CLASSES
9979
9980 =item B::SV Methods
9981
9982 REFCNT, FLAGS, object_2svref
9983
9984 =item B::IV Methods
9985
9986 IV, IVX, UVX, int_value, needs64bits, packiv
9987
9988 =item B::NV Methods
9989
9990 NV, NVX
9991
9992 =item B::RV Methods
9993
9994 RV
9995
9996 =item B::PV Methods
9997
9998 PV, RV, PVX
9999
10000 =item B::PVMG Methods
10001
10002 MAGIC, SvSTASH
10003
10004 =item B::MAGIC Methods
10005
10006 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10007
10008 =item B::PVLV Methods
10009
10010 TARGOFF, TARGLEN, TYPE, TARG
10011
10012 =item B::BM Methods
10013
10014 USEFUL, PREVIOUS, RARE, TABLE
10015
10016 =item B::GV Methods
10017
10018 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10019 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10020
10021 =item B::IO Methods
10022
10023 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10024 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10025
10026 =item B::AV Methods
10027
10028 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10029
10030 =item B::CV Methods
10031
10032 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10033 XSUBANY, CvFLAGS, const_sv
10034
10035 =item B::HV Methods
10036
10037 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10038
10039 =item OP-RELATED CLASSES
10040
10041 =item B::OP Methods
10042
10043 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
10044 spare
10045
10046 =item B::UNOP METHOD
10047
10048 first
10049
10050 =item B::BINOP METHOD
10051
10052 last
10053
10054 =item B::LOGOP METHOD
10055
10056 other
10057
10058 =item B::LISTOP METHOD
10059
10060 children
10061
10062 =item B::PMOP Methods
10063
10064 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10065 pmpermflags, precomp, pmoffset
10066
10067 =item B::SVOP METHOD
10068
10069 sv, gv
10070
10071 =item B::PADOP METHOD
10072
10073 padix
10074
10075 =item B::PVOP METHOD
10076
10077 pv
10078
10079 =item B::LOOP Methods
10080
10081 redoop, nextop, lastop
10082
10083 =item B::COP Methods
10084
10085 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10086
10087 =back
10088
10089 =item AUTHOR
10090
10091 =back
10092
10093 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10094 bytecode
10095
10096 =over 4
10097
10098 =item SYNOPSIS
10099
10100 =item DESCRIPTION
10101
10102 %insn_data, @insn_name, @optype, @specialsv_name
10103
10104 =item AUTHOR
10105
10106 =back
10107
10108 =head2 B::Assembler - Assemble Perl bytecode
10109
10110 =over 4
10111
10112 =item SYNOPSIS
10113
10114 =item DESCRIPTION
10115
10116 =item AUTHORS
10117
10118 =back
10119
10120 =head2 B::Bblock - Walk basic blocks
10121
10122 =over 4
10123
10124 =item SYNOPSIS
10125
10126 =item DESCRIPTION
10127
10128 =over 4
10129
10130 =item Functions
10131
10132 B<find_leaders>
10133
10134 =back
10135
10136 =item AUTHOR
10137
10138 =back
10139
10140 =head2 B::Bytecode - Perl compiler's bytecode backend
10141
10142 =over 4
10143
10144 =item SYNOPSIS
10145
10146 =item DESCRIPTION
10147
10148 =item EXAMPLE
10149
10150 =item OPTIONS
10151
10152 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10153
10154 =item KNOWN BUGS
10155
10156 =item NOTICE
10157
10158 =item AUTHORS
10159
10160 =back
10161
10162 =head2 B::C - Perl compiler's C backend
10163
10164 =over 4
10165
10166 =item SYNOPSIS
10167
10168 =item DESCRIPTION
10169
10170 =item OPTIONS
10171
10172 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10173 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10174 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10175 B<-llimit>
10176
10177 =item EXAMPLES
10178
10179 =item BUGS
10180
10181 =item AUTHOR
10182
10183 =back
10184
10185 =head2 B::CC - Perl compiler's optimized C translation backend
10186
10187 =over 4
10188
10189 =item SYNOPSIS
10190
10191 =item DESCRIPTION
10192
10193 =item OPTIONS
10194
10195 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10196 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10197 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10198
10199 =item EXAMPLES
10200
10201 =item BUGS
10202
10203 =item DIFFERENCES
10204
10205 =over 4
10206
10207 =item Loops
10208
10209 =item Context of ".."
10210
10211 =item Arithmetic
10212
10213 =item Deprecated features
10214
10215 =back
10216
10217 =item AUTHOR
10218
10219 =back
10220
10221 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10222
10223 =over 4
10224
10225 =item SYNOPSIS
10226
10227 =item DESCRIPTION
10228
10229 =item EXAMPLE
10230
10231 =item OPTIONS
10232
10233 =over 4
10234
10235 =item Options for Opcode Ordering
10236
10237 B<-basic>, B<-exec>, B<-tree>
10238
10239 =item Options for Line-Style
10240
10241 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10242
10243 =item Options for tree-specific formatting
10244
10245 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
10246
10247 =item Options controlling sequence numbering
10248
10249 B<-base>I<n>, B<-bigendian>, B<-littleendian>
10250
10251 =item Other options
10252
10253 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
10254
10255 =item Option Stickiness
10256
10257 =back
10258
10259 =item ABBREVIATIONS
10260
10261 =over 4
10262
10263 =item OP class abbreviations
10264
10265 =item OP flags abbreviations
10266
10267 =back
10268
10269 =item FORMATTING SPECIFICATIONS
10270
10271 =over 4
10272
10273 =item Special Patterns
10274
10275 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10276 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10277 B<~>
10278
10279 =item # Variables
10280
10281 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
10282 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10283 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10284 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10285 B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
10286 B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10287
10288 =back
10289
10290 =item Using B::Concise outside of the O framework
10291
10292 =over 4
10293
10294 =item Example: Altering Concise Renderings
10295
10296 =item set_style()
10297
10298 =item set_style_standard($name)
10299
10300 =item add_style()
10301
10302 =item add_callback()
10303
10304 =item Running B::Concise::compile()
10305
10306 =item B::Concise::reset_sequence()
10307
10308 =item Errors
10309
10310 =back
10311
10312 =item AUTHOR
10313
10314 =back
10315
10316 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10317
10318 =over 4
10319
10320 =item SYNOPSIS
10321
10322 =item DESCRIPTION
10323
10324 =item AUTHOR
10325
10326 =back
10327
10328 =head2 B::Deparse - Perl compiler backend to produce perl code
10329
10330 =over 4
10331
10332 =item SYNOPSIS
10333
10334 =item DESCRIPTION
10335
10336 =item OPTIONS
10337
10338 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10339 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10340
10341 =item USING B::Deparse AS A MODULE
10342
10343 =over 4
10344
10345 =item Synopsis
10346
10347 =item Description
10348
10349 =item new
10350
10351 =item ambient_pragmas
10352
10353 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10354
10355 =item coderef2text
10356
10357 =back
10358
10359 =item BUGS
10360
10361 =item AUTHOR
10362
10363 =back
10364
10365 =head2 B::Disassembler - Disassemble Perl bytecode
10366
10367 =over 4
10368
10369 =item SYNOPSIS
10370
10371 =item DESCRIPTION
10372
10373 =item AUTHOR
10374
10375 =back
10376
10377 =head2 B::Lint - Perl lint
10378
10379 =over 4
10380
10381 =item SYNOPSIS
10382
10383 =item DESCRIPTION
10384
10385 =item OPTIONS AND LINT CHECKS
10386
10387 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10388 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10389 B<regexp-variables>, B<all>, B<none>
10390
10391 =item NON LINT-CHECK OPTIONS
10392
10393 B<-u Package>
10394
10395 =item BUGS
10396
10397 =item AUTHOR
10398
10399 =back
10400
10401 =head2 B::O, O - Generic interface to Perl Compiler backends
10402
10403 =over 4
10404
10405 =item SYNOPSIS
10406
10407 =item DESCRIPTION
10408
10409 =item CONVENTIONS
10410
10411 =item IMPLEMENTATION
10412
10413 =item BUGS
10414
10415 =item AUTHOR
10416
10417 =back
10418
10419 =head2 B::Showlex - Show lexical variables used in functions or files
10420
10421 =over 4
10422
10423 =item SYNOPSIS
10424
10425 =item DESCRIPTION
10426
10427 =item EXAMPLES
10428
10429 =over 4
10430
10431 =item OPTIONS
10432
10433 =back
10434
10435 =item SEE ALSO
10436
10437 =item TODO
10438
10439 =item AUTHOR
10440
10441 =back
10442
10443 =head2 B::Stackobj - Helper module for CC backend
10444
10445 =over 4
10446
10447 =item SYNOPSIS
10448
10449 =item DESCRIPTION
10450
10451 =item AUTHOR
10452
10453 =back
10454
10455 =head2 B::Stash - show what stashes are loaded
10456
10457 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10458
10459 =over 4
10460
10461 =item SYNOPSIS
10462
10463 =item DESCRIPTION
10464
10465 =item AUTHOR
10466
10467 =back
10468
10469 =head2 B::Xref - Generates cross reference reports for Perl programs
10470
10471 =over 4
10472
10473 =item SYNOPSIS
10474
10475 =item DESCRIPTION
10476
10477 =item OPTIONS
10478
10479 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10480
10481 =item BUGS
10482
10483 =item AUTHOR
10484
10485 =back
10486
10487 =head2 Bblock, B::Bblock - Walk basic blocks
10488
10489 =over 4
10490
10491 =item SYNOPSIS
10492
10493 =item DESCRIPTION
10494
10495 =over 4
10496
10497 =item Functions
10498
10499 B<find_leaders>
10500
10501 =back
10502
10503 =item AUTHOR
10504
10505 =back
10506
10507 =head2 Benchmark - benchmark running times of Perl code
10508
10509 =over 4
10510
10511 =item SYNOPSIS
10512
10513 =item DESCRIPTION
10514
10515 =over 4
10516
10517 =item Methods
10518
10519 new, debug, iters
10520
10521 =item Standard Exports
10522
10523 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10524 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10525 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10526
10527 =item Optional Exports
10528
10529 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10530 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10531 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10532
10533 =item :hireswallclock
10534
10535 =back
10536
10537 =item NOTES
10538
10539 =item EXAMPLES
10540
10541 =item INHERITANCE
10542
10543 =item CAVEATS
10544
10545 =item SEE ALSO
10546
10547 =item AUTHORS
10548
10549 =item MODIFICATION HISTORY
10550
10551 =back
10552
10553 =head2 ByteLoader - load byte compiled perl code
10554
10555 =over 4
10556
10557 =item SYNOPSIS
10558
10559 =item DESCRIPTION
10560
10561 =item AUTHOR
10562
10563 =item SEE ALSO
10564
10565 =back
10566
10567 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10568
10569 =over 4
10570
10571 =item SYNOPSIS
10572
10573 =item DESCRIPTION
10574
10575 =item EXAMPLE
10576
10577 =item OPTIONS
10578
10579 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10580
10581 =item KNOWN BUGS
10582
10583 =item NOTICE
10584
10585 =item AUTHORS
10586
10587 =back
10588
10589 =head2 CGI - Simple Common Gateway Interface Class
10590
10591 =over 4
10592
10593 =item SYNOPSIS
10594
10595 =item ABSTRACT
10596
10597 =item DESCRIPTION
10598
10599 =over 4
10600
10601 =item PROGRAMMING STYLE
10602
10603 =item CALLING CGI.PM ROUTINES
10604
10605 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10606
10607 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10608
10609 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10610
10611 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10612
10613 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10614
10615 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10616
10617 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10618
10619 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10620
10621 =item DELETING A PARAMETER COMPLETELY:
10622
10623 =item DELETING ALL PARAMETERS:
10624
10625 =item DIRECT ACCESS TO THE PARAMETER LIST:
10626
10627 =item FETCHING THE PARAMETER LIST AS A HASH:
10628
10629 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10630
10631 =item RETRIEVING CGI ERRORS
10632
10633 =item USING THE FUNCTION-ORIENTED INTERFACE
10634
10635 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10636 B<:standard>, B<:all>
10637
10638 =item PRAGMAS
10639
10640 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10641 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10642 -private_tempfiles
10643
10644 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10645
10646 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10647 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10648 a </ul> tag)
10649
10650 =back
10651
10652 =item GENERATING DYNAMIC DOCUMENTS
10653
10654 =over 4
10655
10656 =item CREATING A STANDARD HTTP HEADER:
10657
10658 =item GENERATING A REDIRECTION HEADER
10659
10660 =item CREATING THE HTML DOCUMENT HEADER
10661
10662 B<Parameters:>, 4, 5, 6..
10663
10664 =item ENDING THE HTML DOCUMENT:
10665
10666 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10667
10668 =item OBTAINING THE SCRIPT'S URL
10669
10670 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10671 (B<-query_string>), B<-base>
10672
10673 =item MIXING POST AND URL PARAMETERS
10674
10675 =back
10676
10677 =item CREATING STANDARD HTML ELEMENTS:
10678
10679 =over 4
10680
10681 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10682
10683 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10684
10685 =item HTML SHORTCUTS AND LIST INTERPOLATION
10686
10687 =item NON-STANDARD HTML SHORTCUTS
10688
10689 =item AUTOESCAPING HTML
10690
10691 $escaped_string = escapeHTML("unescaped string");, $charset =
10692 charset([$charset]);, $flag = autoEscape([$flag]);
10693
10694 =item PRETTY-PRINTING HTML
10695
10696 =back
10697
10698 =item CREATING FILL-OUT FORMS:
10699
10700 =over 4
10701
10702 =item CREATING AN ISINDEX TAG
10703
10704 =item STARTING AND ENDING A FORM
10705
10706 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10707
10708 =item CREATING A TEXT FIELD
10709
10710 B<Parameters>
10711
10712 =item CREATING A BIG TEXT FIELD
10713
10714 =item CREATING A PASSWORD FIELD
10715
10716 =item CREATING A FILE UPLOAD FIELD
10717
10718 B<Parameters>
10719
10720 =item CREATING A POPUP MENU
10721
10722 =item CREATING AN OPTION GROUP
10723
10724 =item CREATING A SCROLLING LIST
10725
10726 B<Parameters:>
10727
10728 =item CREATING A GROUP OF RELATED CHECKBOXES
10729
10730 B<Parameters:>
10731
10732 =item CREATING A STANDALONE CHECKBOX
10733
10734 B<Parameters:>
10735
10736 =item CREATING A RADIO BUTTON GROUP
10737
10738 B<Parameters:>
10739
10740 =item CREATING A SUBMIT BUTTON 
10741
10742 B<Parameters:>
10743
10744 =item CREATING A RESET BUTTON
10745
10746 =item CREATING A DEFAULT BUTTON
10747
10748 =item CREATING A HIDDEN FIELD
10749
10750 B<Parameters:>
10751
10752 =item CREATING A CLICKABLE IMAGE BUTTON
10753
10754 B<Parameters:>, 3. The third option (-align, optional) is an alignment
10755 type, and may be TOP, BOTTOM or MIDDLE
10756
10757 =item CREATING A JAVASCRIPT ACTION BUTTON
10758
10759 =back
10760
10761 =item HTTP COOKIES
10762
10763 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10764 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10765
10766 =item WORKING WITH FRAMES
10767
10768 1. Create a <Frameset> document, 2. Specify the destination for the
10769 document in the HTTP header, 3. Specify the destination for the document in
10770 the <form> tag
10771
10772 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10773
10774 =item DEBUGGING
10775
10776 =over 4
10777
10778 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10779
10780 =back
10781
10782 =item FETCHING ENVIRONMENT VARIABLES
10783
10784 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10785 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
10786 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
10787 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10788 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
10789 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
10790
10791 =item USING NPH SCRIPTS
10792
10793 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10794 parameters
10795
10796 =item Server Push
10797
10798 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10799
10800 =item Avoiding Denial of Service Attacks
10801
10802 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10803 basis>, B<2. Globally for all scripts>
10804
10805 =item COMPATIBILITY WITH CGI-LIB.PL
10806
10807 =item AUTHOR INFORMATION
10808
10809 =item CREDITS
10810
10811 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10812 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10813 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10814 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10815 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10816 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10817 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10818 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10819 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10820 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10821 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10822 ...and many many more..
10823
10824 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10825
10826 =item BUGS
10827
10828 =item SEE ALSO
10829
10830 =back
10831
10832 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10833
10834 =over 4
10835
10836 =item SYNOPSIS
10837
10838 =item ABSTRACT
10839
10840 =item DESCRIPTION
10841
10842 =item AUTHOR INFORMATION
10843
10844 =item BUGS
10845
10846 =item SEE ALSO
10847
10848 =back
10849
10850 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10851 other) error log
10852
10853 =over 4
10854
10855 =item SYNOPSIS
10856
10857 =item DESCRIPTION
10858
10859 =item REDIRECTING ERROR MESSAGES
10860
10861 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10862
10863 =over 4
10864
10865 =item Changing the default message
10866
10867 =back
10868
10869 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10870
10871 =item OVERRIDING THE NAME OF THE PROGRAM
10872
10873 =item AUTHORS
10874
10875 =item SEE ALSO
10876
10877 =back
10878
10879 =head2 CGI::Cookie - Interface to Netscape Cookies
10880
10881 =over 4
10882
10883 =item SYNOPSIS
10884
10885 =item DESCRIPTION
10886
10887 =item USING CGI::Cookie
10888
10889 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10890
10891 =over 4
10892
10893 =item Creating New Cookies
10894
10895 =item Sending the Cookie to the Browser
10896
10897 =item Recovering Previous Cookies
10898
10899 =item Manipulating Cookies
10900
10901 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10902
10903 =back
10904
10905 =item AUTHOR INFORMATION
10906
10907 =item BUGS
10908
10909 =item SEE ALSO
10910
10911 =back
10912
10913 =head2 CGI::Fast - CGI Interface for Fast CGI
10914
10915 =over 4
10916
10917 =item SYNOPSIS
10918
10919 =item DESCRIPTION
10920
10921 =item OTHER PIECES OF THE PUZZLE
10922
10923 =item WRITING FASTCGI PERL SCRIPTS
10924
10925 =item INSTALLING FASTCGI SCRIPTS
10926
10927 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10928
10929 =item EXTERNAL FASTCGI SERVER INVOCATION
10930
10931 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10932
10933 =item CAVEATS
10934
10935 =item AUTHOR INFORMATION
10936
10937 =item BUGS
10938
10939 =item SEE ALSO
10940
10941 =back
10942
10943 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10944
10945 =over 4
10946
10947 =item SYNOPSIS
10948
10949 =item DESCRIPTION
10950
10951 =over 4
10952
10953 =item Tags that won't be formatted
10954
10955 =item Customizing the Indenting
10956
10957 =back
10958
10959 =item BUGS
10960
10961 =item AUTHOR
10962
10963 =item SEE ALSO
10964
10965 =back
10966
10967 =head2 CGI::Push - Simple Interface to Server Push
10968
10969 =over 4
10970
10971 =item SYNOPSIS
10972
10973 =item DESCRIPTION
10974
10975 =item USING CGI::Push
10976
10977 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10978
10979 =over 4
10980
10981 =item Heterogeneous Pages
10982
10983 =item Changing the Page Delay on the Fly
10984
10985 =back
10986
10987 =item INSTALLING CGI::Push SCRIPTS
10988
10989 =item AUTHOR INFORMATION
10990
10991 =item BUGS
10992
10993 =item SEE ALSO
10994
10995 =back
10996
10997 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10998
10999 =over 4
11000
11001 =item SYNOPSIS
11002
11003 =item ABSTRACT
11004
11005 =item DESCRIPTION
11006
11007 =item AUTHOR INFORMATION
11008
11009 =item BUGS
11010
11011 =item SEE ALSO
11012
11013 =back
11014
11015 =head2 CGI::Util - Internal utilities used by CGI module
11016
11017 =over 4
11018
11019 =item SYNOPSIS
11020
11021 =item DESCRIPTION
11022
11023 =item AUTHOR INFORMATION
11024
11025 =item SEE ALSO
11026
11027 =back
11028
11029 =head2 CPAN - query, download and build perl modules from CPAN sites
11030
11031 =over 4
11032
11033 =item SYNOPSIS
11034
11035 =item STATUS
11036
11037 =item DESCRIPTION
11038
11039 =over 4
11040
11041 =item Interactive Mode
11042
11043 Searching for authors, bundles, distribution files and modules, make, test,
11044 install, clean  modules or distributions, get, readme, look module or
11045 distribution, ls author, Signals
11046
11047 =item CPAN::Shell
11048
11049 =item autobundle
11050
11051 =item recompile
11052
11053 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11054
11055 =item Programmer's interface
11056
11057 expand($type,@things), expandany(@things), Programming Examples
11058
11059 =item Methods in the other Classes
11060
11061 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11062 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11063 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11064 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11065 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11066 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11067 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11068 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11069 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11070 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11071 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11072 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11073 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11074 CPAN::Distribution::look(), CPAN::Distribution::make(),
11075 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11076 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
11077 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
11078 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
11079 CPAN::Module::clean(), CPAN::Module::cpan_file(),
11080 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
11081 CPAN::Module::description(), CPAN::Module::force($method,@args),
11082 CPAN::Module::get(), CPAN::Module::inst_file(),
11083 CPAN::Module::inst_version(), CPAN::Module::install(),
11084 CPAN::Module::look(), CPAN::Module::make(),
11085 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11086 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
11087
11088 =item Cache Manager
11089
11090 =item Bundles
11091
11092 =item Prerequisites
11093
11094 =item Finding packages and VERSION
11095
11096 =item Debugging
11097
11098 =item Floppy, Zip, Offline Mode
11099
11100 =back
11101
11102 =item CONFIGURATION
11103
11104 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11105 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11106 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11107 [unshift|push|splice] E<lt>listE<gt>>
11108
11109 =over 4
11110
11111 =item Note on urllist parameter's format
11112
11113 =item urllist parameter has CD-ROM support
11114
11115 =back
11116
11117 =item SECURITY
11118
11119 =item EXPORT
11120
11121 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11122
11123 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11124
11125 =over 4
11126
11127 =item Three basic types of firewalls
11128
11129 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
11130
11131 =item Configuring lynx or ncftp for going through a firewall
11132
11133 =back
11134
11135 =item FAQ
11136
11137 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
11138
11139 =item BUGS
11140
11141 =item AUTHOR
11142
11143 =item TRANSLATIONS
11144
11145 =item SEE ALSO
11146
11147 =back
11148
11149 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
11150
11151 =over 4
11152
11153 =item SYNOPSIS
11154
11155 =item DESCRIPTION
11156
11157 =back
11158
11159 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
11160 module
11161
11162 =over 4
11163
11164 =item SYNOPSIS
11165
11166 =item DESCRIPTION
11167
11168 =item  SEE ALSO
11169
11170 =back
11171
11172 =head2 Carp, carp    - warn of errors (from perspective of caller)
11173
11174 =over 4
11175
11176 =item SYNOPSIS
11177
11178 =item DESCRIPTION
11179
11180 =over 4
11181
11182 =item Forcing a Stack Trace
11183
11184 =back
11185
11186 =back
11187
11188 =over 4
11189
11190 =item GLOBAL VARIABLES
11191
11192 =over 4
11193
11194 =item $Carp::CarpLevel
11195
11196 =item $Carp::MaxEvalLen
11197
11198 =item $Carp::MaxArgLen
11199
11200 =item $Carp::MaxArgNums
11201
11202 =item $Carp::Verbose
11203
11204 =back
11205
11206 =back
11207
11208 =over 4
11209
11210 =item BUGS
11211
11212 =back
11213
11214 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
11215
11216 =head2 Class::ISA -- report the search path for a class's ISA tree
11217
11218 =over 4
11219
11220 =item SYNOPSIS
11221
11222 =item DESCRIPTION
11223
11224 =item FUNCTIONS
11225
11226 the function Class::ISA::super_path($CLASS), the function
11227 Class::ISA::self_and_super_path($CLASS), the function
11228 Class::ISA::self_and_super_versions($CLASS)
11229
11230 =item CAUTIONARY NOTES
11231
11232 =item COPYRIGHT
11233
11234 =item AUTHOR
11235
11236 =back
11237
11238 =head2 Class::Struct - declare struct-like datatypes as Perl classes
11239
11240 =over 4
11241
11242 =item SYNOPSIS
11243
11244 =item DESCRIPTION
11245
11246 =over 4
11247
11248 =item The C<struct()> function
11249
11250 =item Class Creation at Compile Time
11251
11252 =item Element Types and Accessor Methods
11253
11254 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11255 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11256
11257 =item Initializing with C<new>
11258
11259 =back
11260
11261 =item EXAMPLES
11262
11263 Example 1, Example 2, Example 3
11264
11265 =item Author and Modification History
11266
11267 =back
11268
11269 =head2 Config - access Perl configuration information
11270
11271 =over 4
11272
11273 =item SYNOPSIS
11274
11275 =item DESCRIPTION
11276
11277 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11278
11279 =item EXAMPLE
11280
11281 =item WARNING
11282
11283 =item GLOSSARY
11284
11285 =over 4
11286
11287 =item _
11288
11289 C<_a>, C<_exe>, C<_o>
11290
11291 =item a
11292
11293 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11294 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11295 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11296 C<asctime_r_proto>, C<awk>
11297
11298 =item b
11299
11300 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11301
11302 =item c
11303
11304 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11305 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11306 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11307 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11308 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11309 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11310 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11311
11312 =item d
11313
11314 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11315 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11316 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11317 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11318 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11319 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11320 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11321 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11322 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11323 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11324 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11325 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11326 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11327 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11328 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11329 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11330 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11331 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11332 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11333 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11334 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11335 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11336 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11337 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11338 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11339 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11340 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11341 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11342 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11343 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11344 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11345 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11346 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11347 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11348 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11349 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11350 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11351 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11352 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11353 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11354 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11355 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11356 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11357 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11358 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11359 C<d_nanosleep>, C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>,
11360 C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
11361 C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
11362 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
11363 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
11364 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
11365 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
11366 C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>,
11367 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
11368 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
11369 C<d_random_r>, C<d_readdir64_r>, C<d_readdir>, C<d_readdir_r>,
11370 C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
11371 C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
11372 C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
11373 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
11374 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
11375 C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>,
11376 C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>,
11377 C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>,
11378 C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
11379 C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>,
11380 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
11381 C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>,
11382 C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>,
11383 C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>,
11384 C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>,
11385 C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>,
11386 C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>,
11387 C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
11388 C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
11389 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
11390 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
11391 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
11392 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
11393 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
11394 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
11395 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
11396 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
11397 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
11398 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
11399 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
11400 C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>,
11401 C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
11402 C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
11403 C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
11404 C<db_version_major>, C<db_version_minor>, C<db_version_patch>,
11405 C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
11406 C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11407
11408 =item e
11409
11410 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11411 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11412 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11413 C<expr>, C<extensions>, C<extras>
11414
11415 =item f
11416
11417 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11418 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11419 C<full_sed>
11420
11421 =item g
11422
11423 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11424 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11425 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11426 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11427 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11428 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11429 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11430 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11431 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11432 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11433
11434 =item h
11435
11436 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11437 C<html3dir>, C<html3direxp>
11438
11439 =item i
11440
11441 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11442 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11443 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11444 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11445 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11446 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11447 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11448 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11449 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11450 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11451 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11452 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11453 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11454 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11455 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11456 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11457 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11458 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11459 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11460 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11461 C<installprefixexp>, C<installprivlib>, C<installscript>,
11462 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11463 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11464 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11465 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11466 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11467 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11468 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11469
11470 =item k
11471
11472 C<known_extensions>, C<ksh>
11473
11474 =item l
11475
11476 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11477 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11478 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11479 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11480 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11481 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11482 C<lseektype>
11483
11484 =item m
11485
11486 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11487 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11488 C<man3direxp>, C<man3ext>
11489
11490 =item M
11491
11492 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11493 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11494 C<myuname>
11495
11496 =item n
11497
11498 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11499 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11500 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11501 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11502 C<nvsize>, C<nvtype>
11503
11504 =item o
11505
11506 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11507 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11508
11509 =item p
11510
11511 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11512 C<perl>, C<perl_patchlevel>
11513
11514 =item P
11515
11516 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11517 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11518 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
11519 C<procselfexe>, C<prototype>, C<ptrsize>
11520
11521 =item q
11522
11523 C<quadkind>, C<quadtype>
11524
11525 =item r
11526
11527 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11528 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11529 C<rmail>, C<run>, C<runnm>
11530
11531 =item s
11532
11533 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11534 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11535 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11536 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11537 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11538 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11539 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11540 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11541 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11542 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11543 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11544 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11545 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11546 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11547 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11548 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11549 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11550 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11551 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11552 C<submit>, C<subversion>, C<sysman>
11553
11554 =item t
11555
11556 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11557 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11558 C<ttyname_r_proto>
11559
11560 =item u
11561
11562 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11563 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11564 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11565 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11566 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11567 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11568 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11569 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11570 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11571 C<uvXUformat>
11572
11573 =item v
11574
11575 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11576 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11577 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11578 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11579 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11580 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11581 C<versiononly>, C<vi>, C<voidflags>
11582
11583 =item x
11584
11585 C<xlibpth>
11586
11587 =item y
11588
11589 C<yacc>, C<yaccflags>
11590
11591 =item z
11592
11593 C<zcat>, C<zip>
11594
11595 =back
11596
11597 =item NOTE
11598
11599 =back
11600
11601 =head2 Cwd - get pathname of current working directory
11602
11603 =over 4
11604
11605 =item SYNOPSIS
11606
11607 =item DESCRIPTION
11608
11609 =over 4
11610
11611 =item getcwd and friends
11612
11613 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
11614
11615 =item abs_path and friends
11616
11617 abs_path, realpath, fast_abs_path
11618
11619 =item $ENV{PWD}
11620
11621 =back
11622
11623 =item NOTES
11624
11625 =item AUTHOR
11626
11627 =item SEE ALSO
11628
11629 =back
11630
11631 =head2 DB - programmatic interface to the Perl debugging API (draft,
11632 subject to
11633 change)
11634
11635 =over 4
11636
11637 =item SYNOPSIS
11638
11639 =item DESCRIPTION
11640
11641 =over 4
11642
11643 =item Global Variables
11644
11645  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
11646 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
11647 $DB::lineno
11648
11649 =item API Methods
11650
11651 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11652 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11653
11654 =item Client Callback Methods
11655
11656 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11657 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11658 CLIENT->output(LIST)
11659
11660 =back
11661
11662 =item BUGS
11663
11664 =item AUTHOR
11665
11666 =back
11667
11668 =head2 DBM_Filter -- Filter DBM keys/values 
11669
11670 =over 4
11671
11672 =item SYNOPSIS
11673
11674 =item DESCRIPTION
11675
11676 =item What is a DBM Filter?
11677
11678 =over 4
11679
11680 =item So what's new?
11681
11682 =back
11683
11684 =item METHODS
11685
11686 =over 4
11687
11688 =item $db->Filter_Push()
11689
11690 =item $db->Filter_Key_Push()
11691
11692 =item $db->Filter_Value_Push()
11693
11694 Filter_Push, Filter_Key_Push, Filter_Value_Push
11695
11696 =item $db->Filter_Pop()
11697
11698 =item $db->Filtered()
11699
11700 =back
11701
11702 =item Writing a Filter
11703
11704 =over 4
11705
11706 =item Immediate Filters
11707
11708 =item Canned Filters
11709
11710 "name", params
11711
11712 =back
11713
11714 =item Filters Included
11715
11716 utf8, encode, compress, int32, null
11717
11718 =item NOTES
11719
11720 =over 4
11721
11722 =item Maintain Round Trip Integrity
11723
11724 =item Don't mix filtered & non-filtered data in the same database file. 
11725
11726 =back
11727
11728 =item EXAMPLE
11729
11730 =item SEE ALSO
11731
11732 =item AUTHOR
11733
11734 =back
11735
11736 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11737
11738 =over 4
11739
11740 =item SYNOPSIS
11741
11742 =item DESCRIPTION
11743
11744 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11745
11746 =over 4
11747
11748 =item Using DB_File with Berkeley DB version 2 or greater
11749
11750 =item Interface to Berkeley DB
11751
11752 =item Opening a Berkeley DB Database File
11753
11754 =item Default Parameters
11755
11756 =item In Memory Databases
11757
11758 =back
11759
11760 =item DB_HASH
11761
11762 =over 4
11763
11764 =item A Simple Example
11765
11766 =back
11767
11768 =item DB_BTREE
11769
11770 =over 4
11771
11772 =item Changing the BTREE sort order
11773
11774 =item Handling Duplicate Keys 
11775
11776 =item The get_dup() Method
11777
11778 =item The find_dup() Method
11779
11780 =item The del_dup() Method
11781
11782 =item Matching Partial Keys 
11783
11784 =back
11785
11786 =item DB_RECNO
11787
11788 =over 4
11789
11790 =item The 'bval' Option
11791
11792 =item A Simple Example
11793
11794 =item Extra RECNO Methods
11795
11796 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11797 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11798 length, elements);>
11799
11800 =item Another Example
11801
11802 =back
11803
11804 =item THE API INTERFACE
11805
11806 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11807 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11808 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11809 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11810
11811 =item DBM FILTERS
11812
11813 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11814 B<filter_fetch_value>
11815
11816 =over 4
11817
11818 =item The Filter
11819
11820 =item An Example -- the NULL termination problem.
11821
11822 =item Another Example -- Key is a C int.
11823
11824 =back
11825
11826 =item HINTS AND TIPS 
11827
11828 =over 4
11829
11830 =item Locking: The Trouble with fd
11831
11832 =item Safe ways to lock a database
11833
11834 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11835
11836 =item Sharing Databases With C Applications
11837
11838 =item The untie() Gotcha
11839
11840 =back
11841
11842 =item COMMON QUESTIONS
11843
11844 =over 4
11845
11846 =item Why is there Perl source in my database?
11847
11848 =item How do I store complex data structures with DB_File?
11849
11850 =item What does "Invalid Argument" mean?
11851
11852 =item What does "Bareword 'DB_File' not allowed" mean? 
11853
11854 =back
11855
11856 =item REFERENCES
11857
11858 =item HISTORY
11859
11860 =item BUGS
11861
11862 =item AVAILABILITY
11863
11864 =item COPYRIGHT
11865
11866 =item SEE ALSO
11867
11868 =item AUTHOR
11869
11870 =back
11871
11872 =head2 Data::Dumper - stringified perl data structures, suitable for both
11873 printing and C<eval>
11874
11875 =over 4
11876
11877 =item SYNOPSIS
11878
11879 =item DESCRIPTION
11880
11881 =over 4
11882
11883 =item Methods
11884
11885 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
11886 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11887 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11888 I<$OBJ>->Reset
11889
11890 =item Functions
11891
11892 Dumper(I<LIST>)
11893
11894 =item Configuration Variables or Methods
11895
11896 =item Exports
11897
11898 Dumper
11899
11900 =back
11901
11902 =item EXAMPLES
11903
11904 =item BUGS
11905
11906 =over 4
11907
11908 =item NOTE
11909
11910 =back
11911
11912 =item AUTHOR
11913
11914 =item VERSION
11915
11916 =item SEE ALSO
11917
11918 =back
11919
11920 =head2 Devel::DProf - a Perl code profiler
11921
11922 =over 4
11923
11924 =item SYNOPSIS
11925
11926 =item DESCRIPTION
11927
11928 =item PROFILE FORMAT
11929
11930 =item AUTOLOAD
11931
11932 =item ENVIRONMENT
11933
11934 =item BUGS
11935
11936 =item SEE ALSO
11937
11938 =back
11939
11940 =head2 Devel::PPPort - Perl/Pollution/Portability
11941
11942 =over 4
11943
11944 =item SYNOPSIS
11945
11946 =item DESCRIPTION
11947
11948 =over 4
11949
11950 =item Why use ppport.h?
11951
11952 You should use F<ppport.h> in modern code so that your code will work
11953 with the widest range of Perl interpreters possible, without significant
11954 additional work.
11955
11956 =item How to use ppport.h
11957
11958 =item Running ppport.h
11959
11960 =back
11961
11962 =item FUNCTIONS
11963
11964 =over 4
11965
11966 =item WriteFile
11967
11968 =back
11969
11970 =item COMPATIBILITY
11971
11972 =over 4
11973
11974 =item Provided Perl compatibility API
11975
11976 =item Perl API not supported by ppport.h
11977
11978 perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0,
11979 perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03,
11980 perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004
11981
11982 =back
11983
11984 =item BUGS
11985
11986 =item AUTHORS
11987
11988 =item COPYRIGHT
11989
11990 =item SEE ALSO
11991
11992 =back
11993
11994 =head2 Devel::Peek - A data debugging tool for the XS programmer
11995
11996 =over 4
11997
11998 =item SYNOPSIS
11999
12000 =item DESCRIPTION
12001
12002 =over 4
12003
12004 =item Runtime debugging
12005
12006 =item Memory footprint debugging
12007
12008 =back
12009
12010 =item EXAMPLES
12011
12012 =over 4
12013
12014 =item A simple scalar string
12015
12016 =item A simple scalar number
12017
12018 =item A simple scalar with an extra reference
12019
12020 =item A reference to a simple scalar
12021
12022 =item A reference to an array
12023
12024 =item A reference to a hash
12025
12026 =item Dumping a large array or hash
12027
12028 =item A reference to an SV which holds a C pointer
12029
12030 =item A reference to a subroutine
12031
12032 =back
12033
12034 =item EXPORTS
12035
12036 =item BUGS
12037
12038 =item AUTHOR
12039
12040 =item SEE ALSO
12041
12042 =back
12043
12044 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
12045
12046 =over 4
12047
12048 =item SYNOPSIS
12049
12050 =item DESCRIPTION
12051
12052 =back
12053
12054 =head2 Digest - Modules that calculate message digests
12055
12056 =over 4
12057
12058 =item SYNOPSIS
12059
12060 =item DESCRIPTION
12061
12062 I<binary>, I<hex>, I<base64>
12063
12064 =item OO INTERFACE
12065
12066 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
12067 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
12068 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
12069 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
12070 $ctx->hexdigest, $ctx->b64digest
12071
12072 =item Digest speed
12073
12074 =item SEE ALSO
12075
12076 =item AUTHOR
12077
12078 =back
12079
12080 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
12081
12082 =over 4
12083
12084 =item SYNOPSIS
12085
12086 =item DESCRIPTION
12087
12088 =item FUNCTIONS
12089
12090 md5($data,...), md5_hex($data,...), md5_base64($data,...)
12091
12092 =item METHODS
12093
12094 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
12095 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
12096 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
12097
12098 =item EXAMPLES
12099
12100 =item SEE ALSO
12101
12102 =item COPYRIGHT
12103
12104 =item AUTHORS
12105
12106 =back
12107
12108 =head2 Digest::base - Digest base class
12109
12110 =over 4
12111
12112 =item SYNPOSIS
12113
12114 =item DESCRIPTION
12115
12116 =item SEE ALSO
12117
12118 =back
12119
12120 =head2 DirHandle - supply object methods for directory handles
12121
12122 =over 4
12123
12124 =item SYNOPSIS
12125
12126 =item DESCRIPTION
12127
12128 =item NOTES
12129
12130 =back
12131
12132 =head2 Dumpvalue - provides screen dump of Perl data.
12133
12134 =over 4
12135
12136 =item SYNOPSIS
12137
12138 =item DESCRIPTION
12139
12140 =over 4
12141
12142 =item Creation
12143
12144 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
12145 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
12146 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
12147 stopDbSignal
12148
12149 =item Methods
12150
12151 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
12152 compactDump, veryCompact, set, get
12153
12154 =back
12155
12156 =back
12157
12158 =head2 DynaLoader - Dynamically load C libraries into Perl code
12159
12160 =over 4
12161
12162 =item SYNOPSIS
12163
12164 =item DESCRIPTION
12165
12166 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
12167 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
12168 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
12169 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
12170 dl_install_xsub(), bootstrap()
12171
12172 =item AUTHOR
12173
12174 =back
12175
12176 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
12177 Perl code
12178
12179 =over 4
12180
12181 =item SYNOPSIS
12182
12183 =item DESCRIPTION
12184
12185 =over 4
12186
12187 =item Migration from C<DynaLoader>
12188
12189 =item Backward compatible boilerplate
12190
12191 =back
12192
12193 =item Order of initialization: early load()
12194
12195 =over 4
12196
12197 =item The most hairy case
12198
12199 =back
12200
12201 =item LIMITATIONS
12202
12203 =item AUTHOR
12204
12205 =back
12206
12207 =head2 Encode - character encodings
12208
12209 =over 4
12210
12211 =item SYNOPSIS
12212
12213 =over 4
12214
12215 =item Table of Contents
12216
12217 =back
12218
12219 =item DESCRIPTION
12220
12221 =over 4
12222
12223 =item TERMINOLOGY
12224
12225 =back
12226
12227 =item PERL ENCODING API
12228
12229 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
12230 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
12231 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
12232 CHECK]);
12233
12234 =over 4
12235
12236 =item Listing available encodings
12237
12238 =item Defining Aliases
12239
12240 =back
12241
12242 =item Encoding via PerlIO
12243
12244 =item Handling Malformed Data
12245
12246 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
12247 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
12248 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
12249 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
12250 bitmask
12251
12252 =over 4
12253
12254 =item Unimplemented fallback schemes
12255
12256 =back
12257
12258 =item Defining Encodings
12259
12260 =item The UTF-8 flag
12261
12262 Goal #1:, Goal #2:, Goal #3:, Goal #4:
12263
12264 =over 4
12265
12266 =item Messing with Perl's Internals
12267
12268 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
12269
12270 =back
12271
12272 =item SEE ALSO
12273
12274 =item MAINTAINER
12275
12276 =back
12277
12278 =head2 Encode::Alias - alias definitions to encodings
12279
12280 =over 4
12281
12282 =item SYNOPSIS
12283
12284 =item DESCRIPTION
12285
12286 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12287 reference, e.g.:
12288
12289 =over 4
12290
12291 =item Alias overloading
12292
12293 =back
12294
12295 =item SEE ALSO
12296
12297 =back
12298
12299 =head2 Encode::Byte - Single Byte Encodings
12300
12301 =over 4
12302
12303 =item SYNOPSIS
12304
12305 =item ABSTRACT
12306
12307 =item DESCRIPTION
12308
12309 =item SEE ALSO
12310
12311 =back
12312
12313 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
12314
12315 =head2 Encode::CN - China-based Chinese Encodings
12316
12317 =over 4
12318
12319 =item SYNOPSIS
12320
12321 =item DESCRIPTION
12322
12323 =item NOTES
12324
12325 =item BUGS
12326
12327 =item SEE ALSO
12328
12329 =back
12330
12331 =head2 Encode::CN::HZ -- internally used by Encode::CN
12332
12333 =head2 Encode::Config -- internally used by Encode
12334
12335 =head2 Encode::EBCDIC - EBCDIC Encodings
12336
12337 =over 4
12338
12339 =item SYNOPSIS
12340
12341 =item ABSTRACT
12342
12343 =item DESCRIPTION
12344
12345 =item SEE ALSO
12346
12347 =back
12348
12349 =head2 Encode::Encoding - Encode Implementation Base Class
12350
12351 =over 4
12352
12353 =item SYNOPSIS
12354
12355 =item DESCRIPTION
12356
12357 =over 4
12358
12359 =item Methods you should implement
12360
12361 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12362 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12363
12364 =item Other methods defined in Encode::Encodings
12365
12366 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12367
12368 =item Example: Encode::ROT13
12369
12370 =back
12371
12372 =item Why the heck Encode API is different?
12373
12374 =over 4
12375
12376 =item Compiled Encodings
12377
12378 =back
12379
12380 =item SEE ALSO
12381
12382 Scheme 1, Scheme 2, Other Schemes
12383
12384 =back
12385
12386 =head2 Encode::Guess -- Guesses encoding from data
12387
12388 =over 4
12389
12390 =item SYNOPSIS
12391
12392 =item ABSTRACT
12393
12394 =item DESCRIPTION
12395
12396 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12397 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12398 guess_encoding($data, [, I<list of suspects>])
12399
12400 =item CAVEATS
12401
12402 =item TO DO
12403
12404 =item SEE ALSO
12405
12406 =back
12407
12408 =head2 Encode::JP - Japanese Encodings
12409
12410 =over 4
12411
12412 =item SYNOPSIS
12413
12414 =item ABSTRACT
12415
12416 =item DESCRIPTION
12417
12418 =item Note on ISO-2022-JP(-1)?
12419
12420 =item BUGS
12421
12422 =item SEE ALSO
12423
12424 =back
12425
12426 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12427
12428 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12429
12430 =head2 Encode::KR - Korean Encodings
12431
12432 =over 4
12433
12434 =item SYNOPSIS
12435
12436 =item DESCRIPTION
12437
12438 =item BUGS
12439
12440 =item SEE ALSO
12441
12442 =back
12443
12444 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12445
12446 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12447
12448 =over 4
12449
12450 =item SYNOPSIS
12451
12452 =item ABSTRACT
12453
12454 =item DESCRIPTION
12455
12456 =item BUGS
12457
12458 =item SEE ALSO
12459
12460 =back
12461
12462 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12463
12464 =over 4
12465
12466 =item Overview
12467
12468 =item How does it work?
12469
12470 =item Line Buffering
12471
12472 =over 4
12473
12474 =item How can I tell whether my encoding fully supports PerlIO ?
12475
12476 =back
12477
12478 =item SEE ALSO
12479
12480 =back
12481
12482 =head2 Encode::Supported -- Encodings supported by Encode
12483
12484 =over 4
12485
12486 =item DESCRIPTION
12487
12488 =over 4
12489
12490 =item Encoding Names
12491
12492 =back
12493
12494 =item Supported Encodings
12495
12496 =over 4
12497
12498 =item Built-in Encodings
12499
12500 =item Encode::Unicode -- other Unicode encodings
12501
12502 =item Encode::Byte -- Extended ASCII
12503
12504 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12505 the Cyrillic world, gsm0338 - Hentai Latin 1
12506
12507 =item CJK: Chinese, Japanese, Korean (Multibyte)
12508
12509 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12510 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12511 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12512
12513 =item Miscellaneous encodings
12514
12515 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12516
12517 =back
12518
12519 =item Unsupported encodings
12520
12521   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12522 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12523 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12524 Various Mac encodings, (Mac) Indic encodings
12525
12526 =item Encoding vs. Charset -- terminology
12527
12528 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12529
12530 =over 4
12531
12532 =item Microsoft-related naming mess
12533
12534 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12535
12536 =back
12537
12538 =item Glossary
12539
12540 character repertoire, coded character set (CCS), character encoding scheme
12541 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12542 UTF-16
12543
12544 =item See Also
12545
12546 =item References
12547
12548 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12549 RFC, UC, Unicode Glossary
12550
12551 =over 4
12552
12553 =item Other Notable Sites
12554
12555 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12556 "Introduction to i18n"
12557
12558 =item Offline sources
12559
12560 C<CJKV Information Processing> by Ken Lunde
12561
12562 =back
12563
12564 =back
12565
12566 =head2 Encode::Symbol - Symbol Encodings
12567
12568 =over 4
12569
12570 =item SYNOPSIS
12571
12572 =item ABSTRACT
12573
12574 =item DESCRIPTION
12575
12576 =item SEE ALSO
12577
12578 =back
12579
12580 =head2 Encode::TW - Taiwan-based Chinese Encodings
12581
12582 =over 4
12583
12584 =item SYNOPSIS
12585
12586 =item DESCRIPTION
12587
12588 =item NOTES
12589
12590 =item BUGS
12591
12592 =item SEE ALSO
12593
12594 =back
12595
12596 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12597
12598 =over 4
12599
12600 =item SYNOPSIS
12601
12602 =item ABSTRACT
12603
12604 L<http://www.unicode.org/glossary/> says:, Quick Reference
12605
12606 =item Size, Endianness, and BOM
12607
12608 =over 4
12609
12610 =item by size
12611
12612 =item by endianness
12613
12614 BOM as integer when fetched in network byte order
12615
12616 =back
12617
12618 =item Surrogate Pairs
12619
12620 =item SEE ALSO
12621
12622 =back
12623
12624 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12625
12626 =over 4
12627
12628 =item SYNOPSIS
12629
12630 =item ABSTRACT
12631
12632 =item In Practice
12633
12634 =item SEE ALSO
12635
12636 =back
12637
12638 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12639 encodings
12640
12641 =over 4
12642
12643 =item SYNOPSIS
12644
12645 =item DESCRIPTION
12646
12647 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12648 reference, e.g.:
12649
12650 =over 4
12651
12652 =item Alias overloading
12653
12654 =back
12655
12656 =item SEE ALSO
12657
12658 =back
12659
12660 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12661 Internally used by Encode::??::ISO_2022_*
12662
12663 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12664 Encode::CN
12665
12666 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12667 Encode
12668
12669 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12670 Implementation Base Class
12671
12672 =over 4
12673
12674 =item SYNOPSIS
12675
12676 =item DESCRIPTION
12677
12678 =over 4
12679
12680 =item Methods you should implement
12681
12682 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12683 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12684
12685 =item Other methods defined in Encode::Encodings
12686
12687 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12688
12689 =item Example: Encode::ROT13
12690
12691 =back
12692
12693 =item Why the heck Encode API is different?
12694
12695 =over 4
12696
12697 =item Compiled Encodings
12698
12699 =back
12700
12701 =item SEE ALSO
12702
12703 Scheme 1, Scheme 2, Other Schemes
12704
12705 =back
12706
12707 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12708 data
12709
12710 =over 4
12711
12712 =item SYNOPSIS
12713
12714 =item ABSTRACT
12715
12716 =item DESCRIPTION
12717
12718 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12719 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12720 guess_encoding($data, [, I<list of suspects>])
12721
12722 =item CAVEATS
12723
12724 =item TO DO
12725
12726 =item SEE ALSO
12727
12728 =back
12729
12730 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12731 Encode::JP::2022_JP*
12732
12733 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12734 by Encode::JP
12735
12736 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12737 used by Encode::KR
12738
12739 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12740 and 'Q' header encoding
12741
12742 =over 4
12743
12744 =item SYNOPSIS
12745
12746 =item ABSTRACT
12747
12748 =item DESCRIPTION
12749
12750 =item BUGS
12751
12752 =item SEE ALSO
12753
12754 =back
12755
12756 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12757 on Encode and PerlIO
12758
12759 =over 4
12760
12761 =item Overview
12762
12763 =item How does it work?
12764
12765 =item Line Buffering
12766
12767 =over 4
12768
12769 =item How can I tell whether my encoding fully supports PerlIO ?
12770
12771 =back
12772
12773 =item SEE ALSO
12774
12775 =back
12776
12777 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12778 supported by Encode
12779
12780 =over 4
12781
12782 =item DESCRIPTION
12783
12784 =over 4
12785
12786 =item Encoding Names
12787
12788 =back
12789
12790 =item Supported Encodings
12791
12792 =over 4
12793
12794 =item Built-in Encodings
12795
12796 =item Encode::Unicode -- other Unicode encodings
12797
12798 =item Encode::Byte -- Extended ASCII
12799
12800 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12801 the Cyrillic world, gsm0338 - Hentai Latin 1
12802
12803 =item CJK: Chinese, Japanese, Korean (Multibyte)
12804
12805 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12806 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12807 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12808
12809 =item Miscellaneous encodings
12810
12811 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12812
12813 =back
12814
12815 =item Unsupported encodings
12816
12817   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12818 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12819 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12820 Various Mac encodings, (Mac) Indic encodings
12821
12822 =item Encoding vs. Charset -- terminology
12823
12824 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12825
12826 =over 4
12827
12828 =item Microsoft-related naming mess
12829
12830 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12831
12832 =back
12833
12834 =item Glossary
12835
12836 character repertoire, coded character set (CCS), character encoding scheme
12837 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12838 UTF-16
12839
12840 =item See Also
12841
12842 =item References
12843
12844 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12845 RFC, UC, Unicode Glossary
12846
12847 =over 4
12848
12849 =item Other Notable Sites
12850
12851 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12852 "Introduction to i18n"
12853
12854 =item Offline sources
12855
12856 C<CJKV Information Processing> by Ken Lunde
12857
12858 =back
12859
12860 =back
12861
12862 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12863 encoding
12864
12865 =over 4
12866
12867 =item SYNOPSIS
12868
12869 =item ABSTRACT
12870
12871 =item In Practice
12872
12873 =item SEE ALSO
12874
12875 =back
12876
12877 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12878
12879 =over 4
12880
12881 =item SYNOPSIS
12882
12883 =item ABSTRACT
12884
12885 =item Description
12886
12887 =over 4
12888
12889 =item Predefined Methods
12890
12891 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12892 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12893 $e-E<gt>bytes([$encoding])
12894
12895 =item Example: base64 transcoder
12896
12897 =item Operator Overloading
12898
12899 =back
12900
12901 =item SEE ALSO
12902
12903 =back
12904
12905 =head2 Encodencoding, encoding - allows you to write your script in
12906 non-ascii or non-utf8
12907
12908 =over 4
12909
12910 =item SYNOPSIS
12911
12912 =item ABSTRACT
12913
12914 =over 4
12915
12916 =item Literal Conversions
12917
12918 =item PerlIO layers for C<STD(IN|OUT)>
12919
12920 =item Implicit upgrading for byte strings
12921
12922 =back
12923
12924 =item FEATURES THAT REQUIRE 5.8.1
12925
12926 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12927
12928 =item USAGE
12929
12930 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12931 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12932
12933 =item The Filter Option
12934
12935 =over 4
12936
12937 =item Filter-related changes at Encode version 1.87
12938
12939 =back
12940
12941 =item CAVEATS
12942
12943 =over 4
12944
12945 =item NOT SCOPED
12946
12947 =item DO NOT MIX MULTIPLE ENCODINGS
12948
12949 =item tr/// with ranges
12950
12951 Legend of characters above
12952
12953 =back
12954
12955 =item EXAMPLE - Greekperl
12956
12957 =item KNOWN PROBLEMS
12958
12959 literals in regex that are longer than 127 bytes, EBCDIC, format
12960
12961 =over 4
12962
12963 =item The Logic of :locale
12964
12965 =back
12966
12967 =item HISTORY
12968
12969 =item SEE ALSO
12970
12971 =back
12972
12973 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12974
12975 =over 4
12976
12977 =item SYNOPSIS
12978
12979 =item ABSTRACT
12980
12981 =item Description
12982
12983 =over 4
12984
12985 =item Predefined Methods
12986
12987 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12988 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12989 $e-E<gt>bytes([$encoding])
12990
12991 =item Example: base64 transcoder
12992
12993 =item Operator Overloading
12994
12995 =back
12996
12997 =item SEE ALSO
12998
12999 =back
13000
13001 =head2 English - use nice English (or awk) names for ugly punctuation
13002 variables
13003
13004 =over 4
13005
13006 =item SYNOPSIS
13007
13008 =item DESCRIPTION
13009
13010 =item PERFORMANCE
13011
13012 =back
13013
13014 =head2 Env - perl module that imports environment variables as scalars or
13015 arrays
13016
13017 =over 4
13018
13019 =item SYNOPSIS
13020
13021 =item DESCRIPTION
13022
13023 =item LIMITATIONS
13024
13025 =item AUTHOR
13026
13027 =back
13028
13029 =head2 Errno - System errno constants
13030
13031 =over 4
13032
13033 =item SYNOPSIS
13034
13035 =item DESCRIPTION
13036
13037 =item CAVEATS
13038
13039 =item AUTHOR
13040
13041 =item COPYRIGHT
13042
13043 =back
13044
13045 =head2 Exporter - Implements default import method for modules
13046
13047 =over 4
13048
13049 =item SYNOPSIS
13050
13051 =item DESCRIPTION
13052
13053 =over 4
13054
13055 =item How to Export
13056
13057 =item Selecting What To Export
13058
13059 =item How to Import
13060
13061 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
13062
13063 =back
13064
13065 =item Advanced features
13066
13067 =over 4
13068
13069 =item Specialised Import Lists
13070
13071 =item Exporting without using Exporter's import method
13072
13073 =item Exporting without inheriting from Exporter
13074
13075 =item Module Version Checking
13076
13077 =item Managing Unknown Symbols
13078
13079 =item Tag Handling Utility Functions
13080
13081 =item Generating combined tags
13082
13083 =item C<AUTOLOAD>ed Constants
13084
13085 =back
13086
13087 =back
13088
13089 =head2 Exporter::Heavy - Exporter guts
13090
13091 =over 4
13092
13093 =item SYNOPSIS
13094
13095 =item DESCRIPTION
13096
13097 =back
13098
13099 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
13100 Makefiles etc.
13101
13102 =over 4
13103
13104 =item SYNOPSIS
13105
13106 =item DESCRIPTION
13107
13108 =back
13109
13110 cat
13111
13112 eqtime src dst
13113
13114 rm_rf files...
13115
13116 rm_f files...
13117
13118 touch files ..
13119
13120 mv source... destination
13121
13122 cp source... destination
13123
13124 chmod mode files..
13125
13126 mkpath directory..
13127
13128 test_f file
13129
13130 =over 4
13131
13132 =item BUGS
13133
13134 =item SEE ALSO 
13135
13136 =item AUTHOR
13137
13138 =back
13139
13140 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13141
13142 =over 4
13143
13144 =item SYNOPSIS
13145
13146 =item DESCRIPTION
13147
13148 B<test_harness>
13149
13150 =back
13151
13152 B<pod2man>
13153
13154 B<warn_if_old_packlist>
13155
13156 B<perllocal_install>
13157
13158 B<uninstall>
13159
13160 =head2 ExtUtils::Constant - generate XS code to import C header constants
13161
13162 =over 4
13163
13164 =item SYNOPSIS
13165
13166 =item DESCRIPTION
13167
13168 =item USAGE
13169
13170 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13171
13172 =item FUNCTIONS
13173
13174 =back
13175
13176 C_stringify NAME
13177
13178 perl_stringify NAME
13179
13180 constant_types
13181
13182 memEQ_clause NAME, CHECKED_AT, INDENT
13183
13184 assign INDENT, TYPE, PRE, POST, VALUE..
13185
13186 return_clause
13187
13188 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
13189
13190 params WHAT
13191
13192 dump_names
13193
13194 dogfood
13195
13196 C_constant, name, type, value, macro, default, pre, post, def_pre =item
13197 def_post, utf8
13198
13199 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13200
13201 autoload PACKAGE, VERSION, AUTOLOADER
13202
13203 WriteMakefileSnippet
13204
13205 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13206 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13207
13208 =over 4
13209
13210 =item AUTHOR
13211
13212 =back
13213
13214 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13215
13216 =over 4
13217
13218 =item SYNOPSIS
13219
13220 =item DESCRIPTION
13221
13222 =item @EXPORT
13223
13224 =item FUNCTIONS
13225
13226 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13227 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13228
13229 =item EXAMPLES
13230
13231 =item SEE ALSO
13232
13233 =item AUTHOR
13234
13235 =back
13236
13237 =head2 ExtUtils::Install - install files from here to there
13238
13239 =over 4
13240
13241 =item SYNOPSIS
13242
13243 =item DESCRIPTION
13244
13245 =over 4
13246
13247 =item Functions
13248
13249 B<install>
13250
13251 =back
13252
13253 =back
13254
13255 B<install_default> I<DISCOURAGED>
13256
13257 B<uninstall>
13258
13259 B<pm_to_blib>
13260
13261 _autosplit
13262
13263 =over 4
13264
13265 =item ENVIRONMENT
13266
13267 B<PERL_INSTALL_ROOT>
13268
13269 =item AUTHOR
13270
13271 =item LICENSE
13272
13273 =back
13274
13275 =head2 ExtUtils::Installed - Inventory management of installed modules
13276
13277 =over 4
13278
13279 =item SYNOPSIS
13280
13281 =item DESCRIPTION
13282
13283 =item USAGE
13284
13285 =item FUNCTIONS
13286
13287 new(), modules(), files(), directories(), directory_tree(), validate(),
13288 packlist(), version()
13289
13290 =item EXAMPLE
13291
13292 =item AUTHOR
13293
13294 =back
13295
13296 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13297
13298 =over 4
13299
13300 =item SYNOPSIS
13301
13302 =item DESCRIPTION
13303
13304 For static extensions, For dynamic extensions at build/link time, For
13305 dynamic extensions at load time
13306
13307 =over 4
13308
13309 =item EXTRALIBS
13310
13311 =item LDLOADLIBS and LD_RUN_PATH
13312
13313 =item BSLOADLIBS
13314
13315 =back
13316
13317 =item PORTABILITY
13318
13319 =over 4
13320
13321 =item VMS implementation
13322
13323 =item Win32 implementation
13324
13325 =back
13326
13327 =item SEE ALSO
13328
13329 =back
13330
13331 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13332
13333 =over 4
13334
13335 =item SYNOPSIS
13336
13337 =item DESCRIPTION
13338
13339 =back
13340
13341 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13342
13343 =over 4
13344
13345 =item SYNOPSIS
13346
13347 =item DESCRIPTION
13348
13349 =item Inherently Cross-Platform Methods
13350
13351 installvars
13352
13353 =back
13354
13355 os_flavor_is
13356
13357 =over 4
13358
13359 =item File::Spec wrappers
13360
13361 catfile
13362
13363 =back
13364
13365 =over 4
13366
13367 =item Thought To Be Cross-Platform Methods
13368
13369 B<split_command>
13370
13371 =back
13372
13373 B<echo>
13374
13375 init_VERSION
13376
13377 wraplist
13378
13379 manifypods
13380
13381 manifypods_target
13382
13383 makemakerdflt_target
13384
13385 special_targets
13386
13387 POD2MAN_macro
13388
13389 test_via_harness
13390
13391 test_via_script
13392
13393 libscan
13394
13395 tool_autosplit
13396
13397 all_target
13398
13399 metafile_target
13400
13401 metafile_addtomanifest_target
13402
13403 =over 4
13404
13405 =item Abstract methods
13406
13407 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13408 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13409 platform_constants
13410
13411 =back
13412
13413 os_flavor
13414
13415 =over 4
13416
13417 =item AUTHOR
13418
13419 =back
13420
13421 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13422 ExtUtils::MakeMaker
13423
13424 =over 4
13425
13426 =item SYNOPSIS
13427
13428 =item DESCRIPTION
13429
13430 =back
13431
13432 os_flavor (o)
13433
13434 init_linker
13435
13436 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13437 ExtUtils::MakeMaker
13438
13439 =over 4
13440
13441 =item SYNOPSIS
13442
13443 =item DESCRIPTION
13444
13445 os_flavor (o)
13446
13447 =back
13448
13449 cflags (o)
13450
13451 replace_manpage_separator (o)
13452
13453 init_linker
13454
13455 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13456
13457 =over 4
13458
13459 =item SYNOPSIS
13460
13461 =item DESCRIPTION
13462
13463 =over 4
13464
13465 =item Overridden methods
13466
13467 os_flavor
13468
13469 =back
13470
13471 =back
13472
13473 B<replace_manpage_separator>
13474
13475 =over 4
13476
13477 =item AUTHOR
13478
13479 =item SEE ALSO
13480
13481 =back
13482
13483 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13484 ExtUtils::MakeMaker
13485
13486 =over 4
13487
13488 =item SYNOPSIS
13489
13490 =item DESCRIPTION
13491
13492 =back
13493
13494 maybe_command
13495
13496 guess_name
13497
13498 macify
13499
13500 patternify
13501
13502 init_main
13503
13504 init_others
13505
13506 init_platform, platform_constants
13507
13508 init_dirscan
13509
13510 init_VERSION (o)
13511
13512 special_targets (o)
13513
13514 static (o)
13515
13516 dlsyms (o)
13517
13518 dynamic (o)
13519
13520 clean (o)
13521
13522 clean_subdirs_target
13523
13524 realclean (o)
13525
13526 realclean_subdirs_target
13527
13528 rulez (o)
13529
13530 processPL (o)
13531
13532 os_flavor
13533
13534 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13535 ExtUtils::MakeMaker
13536
13537 =over 4
13538
13539 =item SYNOPSIS
13540
13541 =item DESCRIPTION
13542
13543 =back
13544
13545 os_flavor
13546
13547 init_platform (o), platform_constants
13548
13549 const_cccmd (o)
13550
13551 static_lib (o)
13552
13553 dynamic_lib (o)
13554
13555 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13556 ExtUtils::MakeMaker
13557
13558 =over 4
13559
13560 =item SYNOPSIS
13561
13562 =item DESCRIPTION
13563
13564 =item METHODS
13565
13566 init_dist (o)
13567
13568 =back
13569
13570 init_linker
13571
13572 os_flavor
13573
13574 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13575
13576 =over 4
13577
13578 =item SYNOPSIS
13579
13580 =item DESCRIPTION
13581
13582 =over 4
13583
13584 =item Overridden methods
13585
13586 os_flavor
13587
13588 =back
13589
13590 =back
13591
13592 B<replace_manpage_separator>
13593
13594 =over 4
13595
13596 =item AUTHOR
13597
13598 =item SEE ALSO
13599
13600 =back
13601
13602 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13603
13604 =over 4
13605
13606 =item SYNOPSIS
13607
13608 =item DESCRIPTION
13609
13610 =item METHODS
13611
13612 =back
13613
13614 =over 4
13615
13616 =item Methods
13617
13618 os_flavor (o)
13619
13620 =back
13621
13622 c_o (o)
13623
13624 cflags (o)
13625
13626 clean (o)
13627
13628 clean_subdirs_target
13629
13630 const_cccmd (o)
13631
13632 const_config (o)
13633
13634 const_loadlibs (o)
13635
13636 constants (o)
13637
13638 depend (o)
13639
13640 dir_target (o)
13641
13642 init_DEST
13643
13644 init_dist
13645
13646 dist (o)
13647
13648 dist_basics (o)
13649
13650 dist_ci (o)
13651
13652 dist_core (o)
13653
13654 B<dist_target>
13655
13656 B<tardist_target>
13657
13658 B<zipdist_target>
13659
13660 B<tarfile_target>
13661
13662 zipfile_target
13663
13664 uutardist_target
13665
13666 shdist_target
13667
13668 distdir
13669
13670 dist_test
13671
13672 dlsyms (o)
13673
13674 dynamic (o)
13675
13676 dynamic_bs (o)
13677
13678 dynamic_lib (o)
13679
13680 exescan
13681
13682 extliblist
13683
13684 find_perl
13685
13686 find_tests
13687
13688 =over 4
13689
13690 =item Methods to actually produce chunks of text for the Makefile
13691
13692 fixin
13693
13694 =back
13695
13696 force (o)
13697
13698 guess_name
13699
13700 has_link_code
13701
13702 init_dirscan
13703
13704 init_DIRFILESEP
13705
13706 init_main
13707
13708 init_others
13709
13710 init_INST
13711
13712 init_INSTALL
13713
13714 init_linker
13715
13716 init_lib2arch
13717
13718 init_PERL
13719
13720 init_platform (o), platform_constants (o)
13721
13722 init_PERM
13723
13724 init_xs
13725
13726 install (o)
13727
13728 installbin (o)
13729
13730 linkext (o)
13731
13732 lsdir
13733
13734 macro (o)
13735
13736 makeaperl (o)
13737
13738 makefile (o)
13739
13740 maybe_command
13741
13742 needs_linking (o)
13743
13744 nicetext
13745
13746 parse_abstract
13747
13748 parse_version
13749
13750 pasthru (o)
13751
13752 perl_script
13753
13754 perldepend (o)
13755
13756 perm_rw (o)
13757
13758 perm_rwx (o)
13759
13760 pm_to_blib
13761
13762 post_constants (o)
13763
13764 post_initialize (o)
13765
13766 postamble (o)
13767
13768 ppd
13769
13770 prefixify
13771
13772 processPL (o)
13773
13774 quote_paren
13775
13776 realclean (o)
13777
13778 realclean_subdirs_target
13779
13780 replace_manpage_separator
13781
13782 oneliner (o)
13783
13784 quote_literal
13785
13786 escape_newlines
13787
13788 max_exec_len
13789
13790 static (o)
13791
13792 static_lib (o)
13793
13794 staticmake (o)
13795
13796 subdir_x (o)
13797
13798 subdirs (o)
13799
13800 test (o)
13801
13802 test_via_harness (override)
13803
13804 test_via_script (override)
13805
13806 tools_other (o)
13807
13808 tool_xsubpp (o)
13809
13810 all_target
13811
13812 top_targets (o)
13813
13814 writedoc
13815
13816 xs_c (o)
13817
13818 xs_cpp (o)
13819
13820 xs_o (o)
13821
13822 =over 4
13823
13824 =item SEE ALSO
13825
13826 =back
13827
13828 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13829 ExtUtils::MakeMaker
13830
13831 =over 4
13832
13833 =item SYNOPSIS
13834
13835 =item DESCRIPTION
13836
13837 =over 4
13838
13839 =item Methods always loaded
13840
13841 wraplist
13842
13843 =back
13844
13845 =back
13846
13847 =over 4
13848
13849 =item Methods
13850
13851 guess_name (override)
13852
13853 =back
13854
13855 find_perl (override)
13856
13857 maybe_command (override)
13858
13859 perl_script (override)
13860
13861 replace_manpage_separator
13862
13863 init_DEST
13864
13865 init_DIRFILESEP
13866
13867 init_main (override)
13868
13869 init_others (override)
13870
13871 init_platform (override)
13872
13873 platform_constants
13874
13875 init_VERSION (override)
13876
13877 constants (override)
13878
13879 special_targets
13880
13881 cflags (override)
13882
13883 const_cccmd (override)
13884
13885 tool_sxubpp (override)
13886
13887 tools_other (override)
13888
13889 init_dist (override)
13890
13891 c_o (override)
13892
13893 xs_c (override)
13894
13895 xs_o (override)
13896
13897 dlsyms (override)
13898
13899 dynamic_lib (override)
13900
13901 dynamic_bs (override)
13902
13903 static_lib (override)
13904
13905 processPL (override)
13906
13907 installbin (override)
13908
13909 subdir_x (override)
13910
13911 clean (override)
13912
13913 clean_subdirs_target
13914
13915 realclean (override)
13916
13917 zipfile_target (o), tarfile_target (o), shdist_target (o)
13918
13919 dist_test (override)
13920
13921 install (override)
13922
13923 perldepend (override)
13924
13925 makefile (override)
13926
13927 find_tests (override)
13928
13929 test (override)
13930
13931 makeaperl (override)
13932
13933 nicetext (override)
13934
13935 prefixify (override)
13936
13937 oneliner (o)
13938
13939 B<echo> (o)
13940
13941 quote_literal
13942
13943 escape_newlines
13944
13945 max_exec_len
13946
13947 init_linker (o)
13948
13949 eliminate_macros
13950
13951 fixpath
13952
13953 os_flavor
13954
13955 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13956 ExtUtils::MakeMaker
13957
13958 =over 4
13959
13960 =item SYNOPSIS
13961
13962 =item DESCRIPTION
13963
13964 =back
13965
13966 =over 4
13967
13968 =item Overridden methods
13969
13970 B<dlsyms>
13971
13972 =back
13973
13974 replace_manpage_separator
13975
13976 B<maybe_command>
13977
13978 B<find_tests>
13979
13980 B<init_DIRFILESEP>
13981
13982 B<init_others>
13983
13984 init_platform (o), platform_constants (o)
13985
13986 special_targets (o)
13987
13988 static_lib (o)
13989
13990 dynamic_lib (o)
13991
13992 clean
13993
13994 init_linker
13995
13996 perl_script
13997
13998 xs_o (o)
13999
14000 pasthru (o)
14001
14002 oneliner (o)
14003
14004 max_exec_len
14005
14006 os_flavor
14007
14008 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
14009
14010 =over 4
14011
14012 =item SYNOPSIS
14013
14014 =item DESCRIPTION
14015
14016 =over 4
14017
14018 =item Overriden methods
14019
14020 dist_test
14021
14022 =back
14023
14024 =back
14025
14026 subdir_x
14027
14028 xs_c
14029
14030 xs_cpp
14031
14032 xs_o
14033
14034 clean_subdirs_target
14035
14036 realclean_subdirs_target
14037
14038 os_flavor
14039
14040 =over 4
14041
14042 =item AUTHOR
14043
14044 =back
14045
14046 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
14047
14048 =over 4
14049
14050 =item SYNOPSIS
14051
14052 =item DESCRIPTION
14053
14054 =back
14055
14056 =head2 ExtUtils::MakeMaker - Create a module Makefile
14057
14058 =over 4
14059
14060 =item SYNOPSIS
14061
14062 =item DESCRIPTION
14063
14064 =over 4
14065
14066 =item How To Write A Makefile.PL
14067
14068 =item Default Makefile Behaviour
14069
14070 =item make test
14071
14072 =item make testdb
14073
14074 =item make install
14075
14076 =item PREFIX and LIB attribute
14077
14078 =item AFS users
14079
14080 =item Static Linking of a new Perl Binary
14081
14082 =item Determination of Perl Library and Installation Locations
14083
14084 =item Which architecture dependent directory?
14085
14086 =item Using Attributes and Parameters
14087
14088 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
14089 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
14090 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
14091 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
14092 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
14093 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
14094 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
14095 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
14096 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
14097 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
14098 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
14099 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
14100 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
14101 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
14102 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
14103 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
14104 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
14105 VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
14106
14107 =item Additional lowercase attributes
14108
14109 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
14110 test, tool_autosplit
14111
14112 =item Overriding MakeMaker Methods
14113
14114 =item The End Of Cargo Cult Programming
14115
14116 C<<MAN3PODS => ' '>>
14117
14118 =item Hintsfile support
14119
14120 =item Distribution Support
14121
14122    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14123   make distdir,   make disttest,    make tardist,    make dist,    make
14124 uutardist,    make shdist,    make zipdist,    make ci
14125
14126 =item Module Meta-Data
14127
14128 =item Disabling an extension
14129
14130 =item Other Handy Functions
14131
14132 prompt
14133
14134 =back
14135
14136 =item ENVIRONMENT
14137
14138 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14139
14140 =item SEE ALSO
14141
14142 =item AUTHORS
14143
14144 =item LICENSE
14145
14146 =back
14147
14148 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14149 MakeMaker
14150
14151 =over 4
14152
14153 =item DESCRIPTION
14154
14155 =over 4
14156
14157 =item Philosophy and History
14158
14159 Why not just use <insert other build config tool here>?, What's
14160 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14161 shell commands, easier to customize, cleaner internals, less cruft
14162
14163 =item Module Writing
14164
14165 How do I keep my $VERSION up to date without resetting it manually?, What's
14166 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14167
14168 =item XS
14169
14170 How to I prevent "object version X.XX does not match bootstrap parameter
14171 Y.YY" errors?, How do I make two or more XS files coexist in the same
14172 directory?
14173
14174 =back
14175
14176 =item PATCHING
14177
14178 =item AUTHOR
14179
14180 =item SEE ALSO
14181
14182 =back
14183
14184 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14185
14186 =over 4
14187
14188 =item SYNOPSIS
14189
14190 =item DESCRIPTION
14191
14192 =over 4
14193
14194 =item The Mantra
14195
14196 =item The Layout
14197
14198 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14199 bin/
14200
14201 =back
14202
14203 =item SEE ALSO
14204
14205 =back
14206
14207 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
14208
14209 =over 4
14210
14211 =item SYNOPSIS
14212
14213 =item DESCRIPTION
14214
14215 =back
14216
14217 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
14218
14219 =over 4
14220
14221 =item SYNOPSIS
14222
14223 =item DESCRIPTION
14224
14225 =back
14226
14227 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14228
14229 =over 4
14230
14231 =item SYNOPSIS
14232
14233 =item DESCRIPTION
14234
14235 =over 4
14236
14237 =item Functions
14238
14239 mkmanifest
14240
14241 =back
14242
14243 =back
14244
14245 manifind
14246
14247 manicheck
14248
14249 filecheck
14250
14251 fullcheck
14252
14253 skipcheck
14254
14255 maniread
14256
14257 manicopy
14258
14259 maniadd
14260
14261 =over 4
14262
14263 =item MANIFEST
14264
14265 =item MANIFEST.SKIP
14266
14267 =item EXPORT_OK
14268
14269 =item GLOBAL VARIABLES
14270
14271 =back
14272
14273 =over 4
14274
14275 =item DIAGNOSTICS
14276
14277 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14278 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14279
14280 =item ENVIRONMENT
14281
14282 B<PERL_MM_MANIFEST_DEBUG>
14283
14284 =item SEE ALSO
14285
14286 =item AUTHOR
14287
14288 =back
14289
14290 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14291
14292 =over 4
14293
14294 =item SYNOPSIS
14295
14296 =item DESCRIPTION
14297
14298 =item SEE ALSO
14299
14300 =back
14301
14302 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14303
14304 =over 4
14305
14306 =item SYNOPSIS
14307
14308 =item DESCRIPTION
14309
14310 =back
14311
14312 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14313 extension
14314
14315 =over 4
14316
14317 =item SYNOPSIS
14318
14319 =item DESCRIPTION
14320
14321 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14322
14323 =item AUTHOR
14324
14325 =item REVISION
14326
14327 =back
14328
14329 =head2 ExtUtils::Packlist - manage .packlist files
14330
14331 =over 4
14332
14333 =item SYNOPSIS
14334
14335 =item DESCRIPTION
14336
14337 =item USAGE
14338
14339 =item FUNCTIONS
14340
14341 new(), read(), write(), validate(), packlist_file()
14342
14343 =item EXAMPLE
14344
14345 =item AUTHOR
14346
14347 =back
14348
14349 =head2 ExtUtils::testlib - add blib/* directories to @INC
14350
14351 =over 4
14352
14353 =item SYNOPSIS
14354
14355 =item DESCRIPTION
14356
14357 =back
14358
14359 =head2 Fatal - replace functions with equivalents which succeed or die
14360
14361 =over 4
14362
14363 =item SYNOPSIS
14364
14365 =item DESCRIPTION
14366
14367 =item AUTHOR
14368
14369 =back
14370
14371 =head2 Fcntl - load the C Fcntl.h defines
14372
14373 =over 4
14374
14375 =item SYNOPSIS
14376
14377 =item DESCRIPTION
14378
14379 =item NOTE
14380
14381 =item EXPORTED SYMBOLS
14382
14383 =back
14384
14385 =head2 File::Basename, fileparse - split a pathname into pieces
14386
14387 =over 4
14388
14389 =item SYNOPSIS
14390
14391 =item DESCRIPTION
14392
14393 fileparse_set_fstype, fileparse
14394
14395 =item EXAMPLES
14396
14397 C<basename>, C<dirname>
14398
14399 =back
14400
14401 =head2 File::CheckTree, validate - run many filetest checks on a tree
14402
14403 =over 4
14404
14405 =item SYNOPSIS
14406
14407 =item DESCRIPTION
14408
14409 =item AUTHOR
14410
14411 =item HISTORY
14412
14413 =back
14414
14415 =head2 File::Compare - Compare files or filehandles
14416
14417 =over 4
14418
14419 =item SYNOPSIS
14420
14421 =item DESCRIPTION
14422
14423 =item RETURN
14424
14425 =item AUTHOR
14426
14427 =back
14428
14429 =head2 File::Copy - Copy files or filehandles
14430
14431 =over 4
14432
14433 =item SYNOPSIS
14434
14435 =item DESCRIPTION
14436
14437 =over 4
14438
14439 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14440
14441 rmscopy($from,$to[,$date_flag])
14442
14443 =back
14444
14445 =item RETURN
14446
14447 =item NOTES
14448
14449 =item AUTHOR
14450
14451 =back
14452
14453 =head2 File::DosGlob - DOS like globbing and then some
14454
14455 =over 4
14456
14457 =item SYNOPSIS
14458
14459 =item DESCRIPTION
14460
14461 =item NOTES
14462
14463 =item EXPORTS (by request only)
14464
14465 =item BUGS
14466
14467 =item AUTHOR
14468
14469 =item HISTORY
14470
14471 =item SEE ALSO
14472
14473 =back
14474
14475 =head2 File::Find - Traverse a directory tree.
14476
14477 =over 4
14478
14479 =item SYNOPSIS
14480
14481 =item DESCRIPTION
14482
14483 B<find>, B<finddepth>
14484
14485 =over 4
14486
14487 =item %options
14488
14489 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14490 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14491 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14492
14493 =item The wanted function
14494
14495 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14496 filename within that directory, C<$File::Find::name> is the complete
14497 pathname to the file
14498
14499 =back
14500
14501 =item WARNINGS
14502
14503 =item CAVEAT
14504
14505 $dont_use_nlink, symlinks
14506
14507 =item NOTES
14508
14509 =item BUGS AND CAVEATS
14510
14511 =item HISTORY
14512
14513 =back
14514
14515 =head2 File::Glob - Perl extension for BSD glob routine
14516
14517 =over 4
14518
14519 =item SYNOPSIS
14520
14521 =item DESCRIPTION
14522
14523 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14524 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14525 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14526
14527 =item DIAGNOSTICS
14528
14529 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14530
14531 =item NOTES
14532
14533 =item AUTHOR
14534
14535 =back
14536
14537 =head2 File::Path - create or remove directory trees
14538
14539 =over 4
14540
14541 =item SYNOPSIS
14542
14543 =item DESCRIPTION
14544
14545 =item DIAGNOSTICS
14546
14547 =item AUTHORS
14548
14549 =back
14550
14551 =head2 File::Spec - portably perform operations on file names
14552
14553 =over 4
14554
14555 =item SYNOPSIS
14556
14557 =item DESCRIPTION
14558
14559 =item METHODS
14560
14561 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14562 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14563 splitdir, catpath(), abs2rel, rel2abs()
14564
14565 =item SEE ALSO
14566
14567 =item AUTHOR
14568
14569 =back
14570
14571 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14572
14573 =over 4
14574
14575 =item SYNOPSIS
14576
14577 =item DESCRIPTION
14578
14579 =back
14580
14581 canonpath
14582
14583 file_name_is_absolute
14584
14585 tmpdir (override)
14586
14587 =head2 File::Spec::Epoc - methods for Epoc file specs
14588
14589 =over 4
14590
14591 =item SYNOPSIS
14592
14593 =item DESCRIPTION
14594
14595 =item AUTHORS
14596
14597 =back
14598
14599 canonpath()
14600
14601 =over 4
14602
14603 =item SEE ALSO
14604
14605 =back
14606
14607 =head2 File::Spec::Functions - portably perform operations on file names
14608
14609 =over 4
14610
14611 =item SYNOPSIS
14612
14613 =item DESCRIPTION
14614
14615 =over 4
14616
14617 =item Exports
14618
14619 =back
14620
14621 =item SEE ALSO
14622
14623 =back
14624
14625 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14626
14627 =over 4
14628
14629 =item SYNOPSIS
14630
14631 =item DESCRIPTION
14632
14633 =item METHODS
14634
14635 canonpath
14636
14637 =back
14638
14639 catdir()
14640
14641 catfile
14642
14643 curdir
14644
14645 devnull
14646
14647 rootdir
14648
14649 tmpdir
14650
14651 updir
14652
14653 file_name_is_absolute
14654
14655 path
14656
14657 splitpath
14658
14659 splitdir
14660
14661 catpath
14662
14663 abs2rel
14664
14665 rel2abs
14666
14667 =over 4
14668
14669 =item AUTHORS
14670
14671 =item SEE ALSO
14672
14673 =back
14674
14675 =head2 File::Spec::OS2 - methods for OS/2 file specs
14676
14677 =over 4
14678
14679 =item SYNOPSIS
14680
14681 =item DESCRIPTION
14682
14683 tmpdir, splitpath
14684
14685 =back
14686
14687 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14688 modules
14689
14690 =over 4
14691
14692 =item SYNOPSIS
14693
14694 =item DESCRIPTION
14695
14696 =item METHODS
14697
14698 canonpath()
14699
14700 =back
14701
14702 catdir()
14703
14704 catfile
14705
14706 curdir
14707
14708 devnull
14709
14710 rootdir
14711
14712 tmpdir
14713
14714 updir
14715
14716 no_upwards
14717
14718 case_tolerant
14719
14720 file_name_is_absolute
14721
14722 path
14723
14724 join
14725
14726 splitpath
14727
14728 splitdir
14729
14730 catpath()
14731
14732 abs2rel
14733
14734 rel2abs()
14735
14736 =over 4
14737
14738 =item SEE ALSO
14739
14740 =back
14741
14742 =head2 File::Spec::VMS - methods for VMS file specs
14743
14744 =over 4
14745
14746 =item SYNOPSIS
14747
14748 =item DESCRIPTION
14749
14750 eliminate_macros
14751
14752 =back
14753
14754 fixpath
14755
14756 =over 4
14757
14758 =item Methods always loaded
14759
14760 canonpath (override)
14761
14762 =back
14763
14764 catdir
14765
14766 catfile
14767
14768 curdir (override)
14769
14770 devnull (override)
14771
14772 rootdir (override)
14773
14774 tmpdir (override)
14775
14776 updir (override)
14777
14778 case_tolerant (override)
14779
14780 path (override)
14781
14782 file_name_is_absolute (override)
14783
14784 splitpath (override)
14785
14786 splitdir (override)
14787
14788 catpath (override)
14789
14790 abs2rel (override)
14791
14792 rel2abs (override)
14793
14794 =over 4
14795
14796 =item SEE ALSO
14797
14798 =back
14799
14800 =head2 File::Spec::Win32 - methods for Win32 file specs
14801
14802 =over 4
14803
14804 =item SYNOPSIS
14805
14806 =item DESCRIPTION
14807
14808 devnull
14809
14810 =back
14811
14812 tmpdir
14813
14814 catfile
14815
14816 canonpath
14817
14818 splitpath
14819
14820 splitdir
14821
14822 catpath
14823
14824 =over 4
14825
14826 =item Note For File::Spec::Win32 Maintainers
14827
14828 =back
14829
14830 =over 4
14831
14832 =item SEE ALSO
14833
14834 =back
14835
14836 =head2 File::Temp - return name and handle of a temporary file safely
14837
14838 =over 4
14839
14840 =item PORTABILITY
14841
14842 =item SYNOPSIS
14843
14844 =item DESCRIPTION
14845
14846 =back
14847
14848 =over 4
14849
14850 =item OO INTERFACE
14851
14852 B<new>
14853
14854 =back
14855
14856 B<filename>
14857
14858 B<DESTROY>
14859
14860 =over 4
14861
14862 =item FUNCTIONS
14863
14864 B<tempfile>
14865
14866 =back
14867
14868 B<tempdir>
14869
14870 =over 4
14871
14872 =item MKTEMP FUNCTIONS
14873
14874 B<mkstemp>
14875
14876 =back
14877
14878 B<mkstemps>
14879
14880 B<mkdtemp>
14881
14882 B<mktemp>
14883
14884 =over 4
14885
14886 =item POSIX FUNCTIONS
14887
14888 B<tmpnam>
14889
14890 =back
14891
14892 B<tmpfile>
14893
14894 =over 4
14895
14896 =item ADDITIONAL FUNCTIONS
14897
14898 B<tempnam>
14899
14900 =back
14901
14902 =over 4
14903
14904 =item UTILITY FUNCTIONS
14905
14906 B<unlink0>
14907
14908 =back
14909
14910 B<cmpstat>
14911
14912 B<unlink1>
14913
14914 =over 4
14915
14916 =item PACKAGE VARIABLES
14917
14918 B<safe_level>, STANDARD, MEDIUM, HIGH
14919
14920 =back
14921
14922 TopSystemUID
14923
14924 =over 4
14925
14926 =item WARNING
14927
14928 =over 4
14929
14930 =item Temporary files and NFS
14931
14932 =back
14933
14934 =item HISTORY
14935
14936 =item SEE ALSO
14937
14938 =item AUTHOR
14939
14940 =back
14941
14942 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14943
14944 =over 4
14945
14946 =item SYNOPSIS
14947
14948 =item DESCRIPTION
14949
14950 =item BUGS
14951
14952 =item NOTE
14953
14954 =item AUTHOR
14955
14956 =back
14957
14958 =head2 FileCache - keep more files open than the system permits
14959
14960 =over 4
14961
14962 =item SYNOPSIS
14963
14964 =item DESCRIPTION
14965
14966 cacheout EXPR, cacheout MODE, EXPR
14967
14968 =item CAVEATS
14969
14970 =item BUGS
14971
14972 =back
14973
14974 =head2 FileHandle - supply object methods for filehandles
14975
14976 =over 4
14977
14978 =item SYNOPSIS
14979
14980 =item DESCRIPTION
14981
14982 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14983
14984 =item SEE ALSO
14985
14986 =back
14987
14988 =head2 Filter::Simple - Simplified source filtering
14989
14990 =over 4
14991
14992 =item SYNOPSIS
14993
14994 =item DESCRIPTION
14995
14996 =over 4
14997
14998 =item The Problem
14999
15000 =item A Solution
15001
15002 =item Disabling or changing <no> behaviour
15003
15004 =item All-in-one interface
15005
15006 =item Filtering only specific components of source code
15007
15008 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
15009 C<"all">
15010
15011 =item Filtering only the code parts of source code
15012
15013 Most source code ceases to be grammatically correct when it is broken up
15014 into the pieces between string literals and regexes. So the C<'code'>
15015 component filter behaves slightly differently from the other partial
15016 filters
15017 described in the previous section.
15018
15019 =item Using Filter::Simple with an explicit C<import> subroutine
15020
15021 =item Using Filter::Simple and Exporter together
15022
15023 =item How it works
15024
15025 =back
15026
15027 =item AUTHOR
15028
15029 =item COPYRIGHT
15030
15031 =back
15032
15033 =head2 Filter::Util::Call - Perl Source Filter Utility Module
15034
15035 =over 4
15036
15037 =item SYNOPSIS
15038
15039 =item DESCRIPTION
15040
15041 =over 4
15042
15043 =item B<use Filter::Util::Call>
15044
15045 =item B<import()>
15046
15047 =item B<filter() and anonymous sub>
15048
15049 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
15050
15051 =back
15052
15053 =item EXAMPLES
15054
15055 =over 4
15056
15057 =item Example 1: A simple filter.
15058
15059 =item Example 2: Using the context
15060
15061 =item Example 3: Using the context within the filter
15062
15063 =item Example 4: Using filter_del
15064
15065 =back
15066
15067 =item Filter::Simple
15068
15069 =item AUTHOR
15070
15071 =item DATE
15072
15073 =back
15074
15075 =head2 FindBin - Locate directory of original perl script
15076
15077 =over 4
15078
15079 =item SYNOPSIS
15080
15081 =item DESCRIPTION
15082
15083 =item EXPORTABLE VARIABLES
15084
15085 =item KNOWN ISSUES
15086
15087 =item KNOWN BUGS
15088
15089 =item AUTHORS
15090
15091 =item COPYRIGHT
15092
15093 =back
15094
15095 =head2 GDBM_File - Perl5 access to the gdbm library.
15096
15097 =over 4
15098
15099 =item SYNOPSIS
15100
15101 =item DESCRIPTION
15102
15103 =item AVAILABILITY
15104
15105 =item BUGS
15106
15107 =item SEE ALSO
15108
15109 =back
15110
15111 =head2 Getopt::Long - Extended processing of command line options
15112
15113 =over 4
15114
15115 =item SYNOPSIS
15116
15117 =item DESCRIPTION
15118
15119 =item Command Line Options, an Introduction
15120
15121 =item Getting Started with Getopt::Long
15122
15123 =over 4
15124
15125 =item Simple options
15126
15127 =item A little bit less simple options
15128
15129 =item Mixing command line option with other arguments
15130
15131 =item Options with values
15132
15133 =item Options with multiple values
15134
15135 =item Options with hash values
15136
15137 =item User-defined subroutines to handle options
15138
15139 =item Options with multiple names
15140
15141 =item Case and abbreviations
15142
15143 =item Summary of Option Specifications
15144
15145 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15146 + [ I<desttype> ]
15147
15148 =back
15149
15150 =item Advanced Possibilities
15151
15152 =over 4
15153
15154 =item Object oriented interface
15155
15156 =item Thread Safety
15157
15158 =item Documentation and help texts
15159
15160 =item Storing options in a hash
15161
15162 =item Bundling
15163
15164 =item The lonesome dash
15165
15166 =item Argument callback
15167
15168 =back
15169
15170 =item Configuring Getopt::Long
15171
15172 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15173 require_order, permute, bundling (default: disabled), bundling_override
15174 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15175 (default: disabled), auto_version (default:disabled), auto_help
15176 (default:disabled), pass_through (default: disabled), prefix,
15177 prefix_pattern, debug (default: disabled)
15178
15179 =item Exportable Methods
15180
15181 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15182
15183 =item Return values and Errors
15184
15185 =item Legacy
15186
15187 =over 4
15188
15189 =item Default destinations
15190
15191 =item Alternative option starters
15192
15193 =item Configuration variables
15194
15195 =back
15196
15197 =item Trouble Shooting
15198
15199 =over 4
15200
15201 =item GetOptions does not return a false result when an option is not
15202 supplied
15203
15204 =item GetOptions does not split the command line correctly
15205
15206 =item Undefined subroutine &main::GetOptions called
15207
15208 =item How do I put a "-?" option into a Getopt::Long?
15209
15210 =back
15211
15212 =item AUTHOR
15213
15214 =item COPYRIGHT AND DISCLAIMER
15215
15216 =back
15217
15218 =head2 Getopt::Std, getopt, getopts - Process single-character switches
15219 with switch clustering
15220
15221 =over 4
15222
15223 =item SYNOPSIS
15224
15225 =item DESCRIPTION
15226
15227 =item C<--help> and C<--version>
15228
15229 =back
15230
15231 =head2 Hash::Util - A selection of general-utility hash subroutines
15232
15233 =over 4
15234
15235 =item SYNOPSIS
15236
15237 =item DESCRIPTION
15238
15239 =over 4
15240
15241 =item Restricted hashes
15242
15243 lock_keys, unlock_keys
15244
15245 =back
15246
15247 =back
15248
15249 lock_value, unlock_value
15250
15251 B<lock_hash>, B<unlock_hash>
15252
15253 B<hash_seed>
15254
15255 =over 4
15256
15257 =item CAVEATS
15258
15259 =item AUTHOR
15260
15261 =item SEE ALSO
15262
15263 =back
15264
15265 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15266 locale
15267
15268 =over 4
15269
15270 =item SYNOPSIS
15271
15272 =item DESCRIPTION
15273
15274 =back
15275
15276 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15277 tags
15278
15279 =over 4
15280
15281 =item SYNOPSIS
15282
15283 =item DESCRIPTION
15284
15285 =back
15286
15287 the function is_language_tag($lang1)
15288
15289 the function extract_language_tags($whatever)
15290
15291 the function same_language_tag($lang1, $lang2)
15292
15293 the function similarity_language_tag($lang1, $lang2)
15294
15295 the function is_dialect_of($lang1, $lang2)
15296
15297 the function super_languages($lang1)
15298
15299 the function locale2language_tag($locale_identifier)
15300
15301 the function encode_language_tag($lang1)
15302
15303 the function alternate_language_tags($lang1)
15304
15305 the function @langs = panic_languages(@accept_languages)
15306
15307 the function implicate_supers( ...languages... ), the function
15308 implicate_supers_strictly( ...languages... )
15309
15310 =over 4
15311
15312 =item ABOUT LOWERCASING
15313
15314 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15315
15316 =item SEE ALSO
15317
15318 =item COPYRIGHT
15319
15320 =item AUTHOR
15321
15322 =back
15323
15324 =head2 I18N::LangTags::Detect - detect the user's language preferences
15325
15326 =over 4
15327
15328 =item SYNOPSIS
15329
15330 =item DESCRIPTION
15331
15332 =item FUNCTIONS
15333
15334 =item ENVIRONMENT
15335
15336 =item SEE ALSO
15337
15338 =item COPYRIGHT
15339
15340 =item AUTHOR
15341
15342 =back
15343
15344 =head2 I18N::LangTags::List -- tags and names for human languages
15345
15346 =over 4
15347
15348 =item SYNOPSIS
15349
15350 =item DESCRIPTION
15351
15352 =item ABOUT LANGUAGE TAGS
15353
15354 =item LIST OF LANGUAGES
15355
15356 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15357 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15358 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15359 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15360 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15361 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15362 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15363 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15364 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15365 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15366 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15367 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15368 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15369 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15370 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15371 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15372 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15373 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15374 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15375 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15376 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15377 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15378 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15379 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15380 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15381 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15382 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15383 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15384 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15385 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15386 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15387 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15388 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15389 English, {enm} : Old English (1100-1500), {ang} : Old English
15390 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15391 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15392 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
15393 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
15394 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
15395 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
15396 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
15397 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
15398 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
15399 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
15400 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
15401 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
15402 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
15403 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
15404 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
15405 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
15406 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
15407 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
15408 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
15409 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
15410 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
15411 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
15412 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
15413 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
15414 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
15415 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
15416 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
15417 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
15418 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
15419 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
15420 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15421 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15422 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15423 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15424 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15425 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15426 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15427 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15428 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15429 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15430 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15431 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15432 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15433 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15434 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15435 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15436 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15437 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15438 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15439 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15440 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15441 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15442 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15443 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15444 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15445 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15446 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15447 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15448 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15449 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15450 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15451 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15452 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15453 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15454 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15455 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15456 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15457 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15458 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15459 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15460 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15461 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15462 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15463 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15464 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15465 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15466 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15467 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15468 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15469 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15470 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15471 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15472 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15473 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15474 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15475 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15476 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15477 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15478 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15479 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15480 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15481 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15482 {zun} : Zuni
15483
15484 =item SEE ALSO
15485
15486 =item COPYRIGHT AND DISCLAIMER
15487
15488 =item AUTHOR
15489
15490 =back
15491
15492 =head2 I18N::Langinfo - query locale information
15493
15494 =over 4
15495
15496 =item SYNOPSIS
15497
15498 =item DESCRIPTION
15499
15500 =over 4
15501
15502 =item EXPORT
15503
15504 =back
15505
15506 =item SEE ALSO
15507
15508 =item AUTHOR
15509
15510 =item COPYRIGHT AND LICENSE
15511
15512 =back
15513
15514 =head2 IO - load various IO modules
15515
15516 =over 4
15517
15518 =item SYNOPSIS
15519
15520 =item DESCRIPTION
15521
15522 =item DEPRECATED
15523
15524 =back
15525
15526 =head2 IO::Dir - supply object methods for directory handles
15527
15528 =over 4
15529
15530 =item SYNOPSIS
15531
15532 =item DESCRIPTION
15533
15534 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15535 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15536
15537 =item SEE ALSO
15538
15539 =item AUTHOR
15540
15541 =item COPYRIGHT
15542
15543 =back
15544
15545 =head2 IO::File - supply object methods for filehandles
15546
15547 =over 4
15548
15549 =item SYNOPSIS
15550
15551 =item DESCRIPTION
15552
15553 =item CONSTRUCTOR
15554
15555 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15556
15557 =item METHODS
15558
15559 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15560
15561 =item SEE ALSO
15562
15563 =item HISTORY
15564
15565 =back
15566
15567 =head2 IO::Handle - supply object methods for I/O handles
15568
15569 =over 4
15570
15571 =item SYNOPSIS
15572
15573 =item DESCRIPTION
15574
15575 =item CONSTRUCTOR
15576
15577 new (), new_from_fd ( FD, MODE )
15578
15579 =item METHODS
15580
15581 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15582 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15583 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15584 $io->blocking ( [ BOOL ] ), $io->untaint
15585
15586 =item NOTE
15587
15588 =item SEE ALSO
15589
15590 =item BUGS
15591
15592 =item HISTORY
15593
15594 =back
15595
15596 =head2 IO::Pipe - supply object methods for pipes
15597
15598 =over 4
15599
15600 =item SYNOPSIS
15601
15602 =item DESCRIPTION
15603
15604 =item CONSTRUCTOR
15605
15606 new ( [READER, WRITER] )
15607
15608 =item METHODS
15609
15610 reader ([ARGS]), writer ([ARGS]), handles ()
15611
15612 =item SEE ALSO
15613
15614 =item AUTHOR
15615
15616 =item COPYRIGHT
15617
15618 =back
15619
15620 =head2 IO::Poll - Object interface to system poll call
15621
15622 =over 4
15623
15624 =item SYNOPSIS
15625
15626 =item DESCRIPTION
15627
15628 =item METHODS
15629
15630 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15631 IO ), handles( [ EVENT_MASK ] )
15632
15633 =item SEE ALSO
15634
15635 =item AUTHOR
15636
15637 =item COPYRIGHT
15638
15639 =back
15640
15641 =head2 IO::Seekable - supply seek based methods for I/O objects
15642
15643 =over 4
15644
15645 =item SYNOPSIS
15646
15647 =item DESCRIPTION
15648
15649 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15650 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15651 $io->tell
15652
15653 =item SEE ALSO
15654
15655 =item HISTORY
15656
15657 =back
15658
15659 =head2 IO::Select - OO interface to the select system call
15660
15661 =over 4
15662
15663 =item SYNOPSIS
15664
15665 =item DESCRIPTION
15666
15667 =item CONSTRUCTOR
15668
15669 new ( [ HANDLES ] )
15670
15671 =item METHODS
15672
15673 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15674 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15675 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15676
15677 =item EXAMPLE
15678
15679 =item AUTHOR
15680
15681 =item COPYRIGHT
15682
15683 =back
15684
15685 =head2 IO::Socket - Object interface to socket communications
15686
15687 =over 4
15688
15689 =item SYNOPSIS
15690
15691 =item DESCRIPTION
15692
15693 =item CONSTRUCTOR
15694
15695 new ( [ARGS] )
15696
15697 =item METHODS
15698
15699 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15700 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15701
15702 =item SEE ALSO
15703
15704 =item AUTHOR
15705
15706 =item COPYRIGHT
15707
15708 =back
15709
15710 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15711
15712 =over 4
15713
15714 =item SYNOPSIS
15715
15716 =item DESCRIPTION
15717
15718 =item CONSTRUCTOR
15719
15720 new ( [ARGS] )
15721
15722 =over 4
15723
15724 =item METHODS
15725
15726 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15727 ()
15728
15729 =back
15730
15731 =item SEE ALSO
15732
15733 =item AUTHOR
15734
15735 =item COPYRIGHT
15736
15737 =back
15738
15739 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15740
15741 =over 4
15742
15743 =item SYNOPSIS
15744
15745 =item DESCRIPTION
15746
15747 =item CONSTRUCTOR
15748
15749 new ( [ARGS] )
15750
15751 =item METHODS
15752
15753 hostpath(), peerpath()
15754
15755 =item SEE ALSO
15756
15757 =item AUTHOR
15758
15759 =item COPYRIGHT
15760
15761 =back
15762
15763 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15764 handles
15765
15766 =over 4
15767
15768 =item SYNOPSIS
15769
15770 =item DESCRIPTION
15771
15772 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15773 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15774
15775 =item SEE ALSO
15776
15777 =item AUTHOR
15778
15779 =item COPYRIGHT
15780
15781 =back
15782
15783 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15784
15785 =over 4
15786
15787 =item SYNOPSIS
15788
15789 =item DESCRIPTION
15790
15791 =item CONSTRUCTOR
15792
15793 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15794
15795 =item METHODS
15796
15797 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15798
15799 =item SEE ALSO
15800
15801 =item HISTORY
15802
15803 =back
15804
15805 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15806 handles
15807
15808 =over 4
15809
15810 =item SYNOPSIS
15811
15812 =item DESCRIPTION
15813
15814 =item CONSTRUCTOR
15815
15816 new (), new_from_fd ( FD, MODE )
15817
15818 =item METHODS
15819
15820 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15821 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15822 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15823 $io->blocking ( [ BOOL ] ), $io->untaint
15824
15825 =item NOTE
15826
15827 =item SEE ALSO
15828
15829 =item BUGS
15830
15831 =item HISTORY
15832
15833 =back
15834
15835 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15836
15837 =over 4
15838
15839 =item SYNOPSIS
15840
15841 =item DESCRIPTION
15842
15843 =item CONSTRUCTOR
15844
15845 new ( [READER, WRITER] )
15846
15847 =item METHODS
15848
15849 reader ([ARGS]), writer ([ARGS]), handles ()
15850
15851 =item SEE ALSO
15852
15853 =item AUTHOR
15854
15855 =item COPYRIGHT
15856
15857 =back
15858
15859 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15860
15861 =over 4
15862
15863 =item SYNOPSIS
15864
15865 =item DESCRIPTION
15866
15867 =item METHODS
15868
15869 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15870 IO ), handles( [ EVENT_MASK ] )
15871
15872 =item SEE ALSO
15873
15874 =item AUTHOR
15875
15876 =item COPYRIGHT
15877
15878 =back
15879
15880 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15881 I/O objects
15882
15883 =over 4
15884
15885 =item SYNOPSIS
15886
15887 =item DESCRIPTION
15888
15889 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15890 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15891 $io->tell
15892
15893 =item SEE ALSO
15894
15895 =item HISTORY
15896
15897 =back
15898
15899 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15900 call
15901
15902 =over 4
15903
15904 =item SYNOPSIS
15905
15906 =item DESCRIPTION
15907
15908 =item CONSTRUCTOR
15909
15910 new ( [ HANDLES ] )
15911
15912 =item METHODS
15913
15914 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15915 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15916 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15917
15918 =item EXAMPLE
15919
15920 =item AUTHOR
15921
15922 =item COPYRIGHT
15923
15924 =back
15925
15926 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15927 communications
15928
15929 =over 4
15930
15931 =item SYNOPSIS
15932
15933 =item DESCRIPTION
15934
15935 =item CONSTRUCTOR
15936
15937 new ( [ARGS] )
15938
15939 =item METHODS
15940
15941 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15942 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15943
15944 =item SEE ALSO
15945
15946 =item AUTHOR
15947
15948 =item COPYRIGHT
15949
15950 =back
15951
15952 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15953 AF_INET domain sockets
15954
15955 =over 4
15956
15957 =item SYNOPSIS
15958
15959 =item DESCRIPTION
15960
15961 =item CONSTRUCTOR
15962
15963 new ( [ARGS] )
15964
15965 =over 4
15966
15967 =item METHODS
15968
15969 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15970 ()
15971
15972 =back
15973
15974 =item SEE ALSO
15975
15976 =item AUTHOR
15977
15978 =item COPYRIGHT
15979
15980 =back
15981
15982 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15983 AF_UNIX domain sockets
15984
15985 =over 4
15986
15987 =item SYNOPSIS
15988
15989 =item DESCRIPTION
15990
15991 =item CONSTRUCTOR
15992
15993 new ( [ARGS] )
15994
15995 =item METHODS
15996
15997 hostpath(), peerpath()
15998
15999 =item SEE ALSO
16000
16001 =item AUTHOR
16002
16003 =item COPYRIGHT
16004
16005 =back
16006
16007 =head2 IPC::Msg - SysV Msg IPC object class
16008
16009 =over 4
16010
16011 =item SYNOPSIS
16012
16013 =item DESCRIPTION
16014
16015 =item METHODS
16016
16017 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16018 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16019 FLAGS ] ), stat
16020
16021 =item SEE ALSO
16022
16023 =item AUTHOR
16024
16025 =item COPYRIGHT
16026
16027 =back
16028
16029 =head2 IPC::Open2, open2 - open a process for both reading and writing
16030
16031 =over 4
16032
16033 =item SYNOPSIS
16034
16035 =item DESCRIPTION
16036
16037 =item WARNING 
16038
16039 =item SEE ALSO
16040
16041 =back
16042
16043 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
16044 handling
16045
16046 =over 4
16047
16048 =item SYNOPSIS
16049
16050 =item DESCRIPTION
16051
16052 =item WARNING
16053
16054 =back
16055
16056 =head2 IPC::Semaphore - SysV Semaphore IPC object class
16057
16058 =over 4
16059
16060 =item SYNOPSIS
16061
16062 =item DESCRIPTION
16063
16064 =item METHODS
16065
16066 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16067 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16068 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16069 , VALUE ), stat
16070
16071 =item SEE ALSO
16072
16073 =item AUTHOR
16074
16075 =item COPYRIGHT
16076
16077 =back
16078
16079 =head2 IPC::SysV - SysV IPC constants
16080
16081 =over 4
16082
16083 =item SYNOPSIS
16084
16085 =item DESCRIPTION
16086
16087 ftok( PATH, ID )
16088
16089 =item SEE ALSO
16090
16091 =item AUTHORS
16092
16093 =item COPYRIGHT
16094
16095 =back
16096
16097 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
16098
16099 =over 4
16100
16101 =item SYNOPSIS
16102
16103 =item DESCRIPTION
16104
16105 =item METHODS
16106
16107 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16108 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16109 FLAGS ] ), stat
16110
16111 =item SEE ALSO
16112
16113 =item AUTHOR
16114
16115 =item COPYRIGHT
16116
16117 =back
16118
16119 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
16120 class
16121
16122 =over 4
16123
16124 =item SYNOPSIS
16125
16126 =item DESCRIPTION
16127
16128 =item METHODS
16129
16130 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16131 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16132 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16133 , VALUE ), stat
16134
16135 =item SEE ALSO
16136
16137 =item AUTHOR
16138
16139 =item COPYRIGHT
16140
16141 =back
16142
16143 =head2 List::Util - A selection of general-utility list subroutines
16144
16145 =over 4
16146
16147 =item SYNOPSIS
16148
16149 =item DESCRIPTION
16150
16151 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16152 BLOCK LIST, shuffle LIST, sum LIST
16153
16154 =item KNOWN BUGS
16155
16156 =item SUGGESTED ADDITIONS
16157
16158 =item COPYRIGHT
16159
16160 =back
16161
16162 =head2 List::Utilib::List::Util, List::Util - A selection of
16163 general-utility list subroutines
16164
16165 =over 4
16166
16167 =item SYNOPSIS
16168
16169 =item DESCRIPTION
16170
16171 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16172 BLOCK LIST, shuffle LIST, sum LIST
16173
16174 =item KNOWN BUGS
16175
16176 =item SUGGESTED ADDITIONS
16177
16178 =item COPYRIGHT
16179
16180 =back
16181
16182 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16183 general-utility scalar subroutines
16184
16185 =over 4
16186
16187 =item SYNOPSIS
16188
16189 =item DESCRIPTION
16190
16191 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16192 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16193 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16194
16195 =item KNOWN BUGS
16196
16197 =item COPYRIGHT
16198
16199 =item BLATANT PLUG
16200
16201 =back
16202
16203 =head2 Locale::Constants - constants for Locale codes
16204
16205 =over 4
16206
16207 =item SYNOPSIS
16208
16209 =item DESCRIPTION
16210
16211 =item KNOWN BUGS AND LIMITATIONS
16212
16213 =item SEE ALSO
16214
16215 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16216
16217 =item AUTHOR
16218
16219 =item COPYRIGHT
16220
16221 =back
16222
16223 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16224
16225 =over 4
16226
16227 =item SYNOPSIS
16228
16229 =item DESCRIPTION
16230
16231 B<alpha-2>, B<alpha-3>, B<numeric>
16232
16233 =item CONVERSION ROUTINES
16234
16235 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16236 country_code2code( CODE, CODESET, CODESET )
16237
16238 =item QUERY ROUTINES
16239
16240 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16241
16242 =item SEMI-PRIVATE ROUTINES
16243
16244 =over 4
16245
16246 =item alias_code
16247
16248 =item rename_country
16249
16250 =back
16251
16252 =item EXAMPLES
16253
16254 =item DOMAIN NAMES
16255
16256 =item KNOWN BUGS AND LIMITATIONS
16257
16258 =item SEE ALSO
16259
16260 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16261 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16262 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16263 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16264
16265 =item AUTHOR
16266
16267 =item COPYRIGHT
16268
16269 =back
16270
16271 =head2 Locale::Currency - ISO three letter codes for currency
16272 identification (ISO 4217)
16273
16274 =over 4
16275
16276 =item SYNOPSIS
16277
16278 =item DESCRIPTION
16279
16280 XTS, XXX
16281
16282 =item CONVERSION ROUTINES
16283
16284 code2currency(), currency2code()
16285
16286 =item QUERY ROUTINES
16287
16288 C<all_currency_codes()>, C<all_currency_names()>
16289
16290 =item EXAMPLES
16291
16292 =item KNOWN BUGS AND LIMITATIONS
16293
16294 =item SEE ALSO
16295
16296 Locale::Country, Locale::Script, ISO 4217:1995,
16297 http://www.bsi-global.com/iso4217currency
16298
16299 =item AUTHOR
16300
16301 =item COPYRIGHT
16302
16303 =back
16304
16305 =head2 Locale::Language - ISO two letter codes for language identification
16306 (ISO 639)
16307
16308 =over 4
16309
16310 =item SYNOPSIS
16311
16312 =item DESCRIPTION
16313
16314 =item CONVERSION ROUTINES
16315
16316 code2language(), language2code()
16317
16318 =item QUERY ROUTINES
16319
16320 C<all_language_codes()>, C<all_language_names()>
16321
16322 =item EXAMPLES
16323
16324 =item KNOWN BUGS AND LIMITATIONS
16325
16326 =item SEE ALSO
16327
16328 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16329 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16330
16331 =item AUTHOR
16332
16333 =item COPYRIGHT
16334
16335 =back
16336
16337 =head2 Locale::Maketext - framework for localization
16338
16339 =over 4
16340
16341 =item SYNOPSIS
16342
16343 =item DESCRIPTION
16344
16345 =item QUICK OVERVIEW
16346
16347 =item METHODS
16348
16349 =over 4
16350
16351 =item Construction Methods
16352
16353 =item The "maketext" Method
16354
16355 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16356
16357 =item Utility Methods
16358
16359 $language->quant($number, $singular), $language->quant($number, $singular,
16360 $plural), $language->quant($number, $singular, $plural, $negative),
16361 $language->numf($number), $language->sprintf($format, @items),
16362 $language->language_tag(), $language->encoding()
16363
16364 =item Language Handle Attributes and Internals
16365
16366 =back
16367
16368 =item LANGUAGE CLASS HIERARCHIES
16369
16370 =item ENTRIES IN EACH LEXICON
16371
16372 =item BRACKET NOTATION
16373
16374 =item AUTO LEXICONS
16375
16376 =item CONTROLLING LOOKUP FAILURE
16377
16378 =item HOW TO USE MAKETEXT
16379
16380 =item SEE ALSO
16381
16382 =item COPYRIGHT AND DISCLAIMER
16383
16384 =item AUTHOR
16385
16386 =back
16387
16388 =head2 Locale::Maketext::TPJ13 -- article about software localization
16389
16390 =over 4
16391
16392 =item SYNOPSIS
16393
16394 =item DESCRIPTION
16395
16396 =item Localization and Perl: gettext breaks, Maketext fixes
16397
16398 =over 4
16399
16400 =item A Localization Horror Story: It Could Happen To You
16401
16402 =item The Linguistic View
16403
16404 =item Breaking gettext
16405
16406 =item Replacing gettext
16407
16408 =item Buzzwords: Abstraction and Encapsulation
16409
16410 =item Buzzword: Isomorphism
16411
16412 =item Buzzword: Inheritance
16413
16414 =item Buzzword: Concision
16415
16416 =item The Devil in the Details
16417
16418 =item The Proof in the Pudding: Localizing Web Sites
16419
16420 =item References
16421
16422 =back
16423
16424 =back
16425
16426 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16427
16428 =over 4
16429
16430 =item SYNOPSIS
16431
16432 =item DESCRIPTION
16433
16434 B<alpha-2>, B<alpha-3>, B<numeric>
16435
16436 =over 4
16437
16438 =item SPECIAL CODES
16439
16440 =back
16441
16442 =item CONVERSION ROUTINES
16443
16444 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16445 script_code2code( CODE, CODESET, CODESET )
16446
16447 =item QUERY ROUTINES
16448
16449 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16450
16451 =item EXAMPLES
16452
16453 =item KNOWN BUGS AND LIMITATIONS
16454
16455 =item SEE ALSO
16456
16457 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16458 http://www.evertype.com/standards/iso15924/
16459
16460 =item AUTHOR
16461
16462 =item COPYRIGHT
16463
16464 =back
16465
16466 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16467
16468 =over 4
16469
16470 =item SYNOPSIS
16471
16472 =item DESCRIPTION
16473
16474 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16475
16476 =item DIAGNOSTICS
16477
16478 Premature end of base64 data, Premature padding of base64 data
16479
16480 =item EXAMPLES
16481
16482 =item COPYRIGHT
16483
16484 =item SEE ALSO
16485
16486 =back
16487
16488 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16489 of quoted-printable strings
16490
16491 =over 4
16492
16493 =item SYNOPSIS
16494
16495 =item DESCRIPTION
16496
16497 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
16498 decode_qp($str);
16499
16500 =item COPYRIGHT
16501
16502 =item SEE ALSO
16503
16504 =back
16505
16506 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16507 strings
16508
16509 =over 4
16510
16511 =item SYNOPSIS
16512
16513 =item DESCRIPTION
16514
16515 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
16516 decode_qp($str);
16517
16518 =item COPYRIGHT
16519
16520 =item SEE ALSO
16521
16522 =back
16523
16524 =head2 Math::BigFloat - Arbitrary size floating point math package
16525
16526 =over 4
16527
16528 =item SYNOPSIS
16529
16530 =item DESCRIPTION
16531
16532 =over 4
16533
16534 =item Canonical notation
16535
16536 =item Output
16537
16538 =item C<mantissa()>, C<exponent()> and C<parts()>
16539
16540 =item Accuracy vs. Precision
16541
16542 =item Rounding
16543
16544 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16545 ), fround  ( -$scale ) and fround ( 0 )
16546
16547 =back
16548
16549 =item EXAMPLES
16550
16551   # not ready yet
16552
16553 =item Autocreating constants
16554
16555 =over 4
16556
16557 =item Math library
16558
16559 =item Using Math::BigInt::Lite
16560
16561 =back
16562
16563 =item BUGS
16564
16565 =item CAVEATS
16566
16567 stringify, bstr(), bdiv, Modifying and =, bpow
16568
16569 =item SEE ALSO
16570
16571 =item LICENSE
16572
16573 =item AUTHORS
16574
16575 =back
16576
16577 =head2 Math::BigInt - Arbitrary size integer math package
16578
16579 =over 4
16580
16581 =item SYNOPSIS
16582
16583 =item DESCRIPTION
16584
16585 Input, Output
16586
16587 =item METHODS
16588
16589 =over 4
16590
16591 =item config
16592
16593 =item accuracy
16594
16595 =item precision
16596
16597 =item brsft
16598
16599 =item new
16600
16601 =item bnan
16602
16603 =item bzero
16604
16605 =item binf
16606
16607 =item bone
16608
16609 =item is_one()/is_zero()/is_nan()/is_inf()
16610
16611 =item is_pos()/is_neg()
16612
16613         $x->is_pos();                   # true if >= 0
16614         $x->is_neg();                   # true if <  0
16615
16616 =item is_odd()/is_even()/is_int()
16617
16618 =item bcmp
16619
16620 =item bacmp
16621
16622 =item sign
16623
16624 =item digit
16625
16626 =item bneg
16627
16628 =item babs
16629
16630 =item bnorm
16631
16632 =item bnot
16633
16634 =item binc
16635
16636 =item bdec
16637
16638 =item badd
16639
16640 =item bsub
16641
16642 =item bmul
16643
16644 =item bdiv
16645
16646 =item bmod
16647
16648 =item bmodinv
16649
16650 =item bmodpow
16651
16652 =item bpow
16653
16654 =item blsft
16655
16656 =item brsft
16657
16658 =item band
16659
16660 =item bior
16661
16662 =item bxor
16663
16664 =item bnot
16665
16666 =item bsqrt
16667
16668 =item bfac
16669
16670 =item round
16671
16672 =item bround
16673
16674 =item bfround
16675
16676 =item bfloor
16677
16678 =item bceil
16679
16680 =item bgcd
16681
16682 =item blcm
16683
16684 =item exponent
16685
16686 =item mantissa
16687
16688 =item parts
16689
16690 =item copy
16691
16692 =item as_int
16693
16694 =item bsstr
16695
16696 =item as_hex
16697
16698 =item as_bin
16699
16700 =back
16701
16702 =item ACCURACY and PRECISION
16703
16704 =over 4
16705
16706 =item Precision P
16707
16708 =item Accuracy A
16709
16710 =item Fallback F
16711
16712 =item Rounding mode R
16713
16714 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16715 (significant digits), Setting/Accessing, Creating numbers, Usage,
16716 Precedence, Overriding globals, Local settings, Rounding, Default values,
16717 Remarks
16718
16719 =back
16720
16721 =item INTERNALS
16722
16723 =over 4
16724
16725 =item MATH LIBRARY
16726
16727 =item SIGN
16728
16729 =item mantissa(), exponent() and parts()
16730
16731 =back
16732
16733 =item EXAMPLES
16734
16735   use Math::BigInt;
16736
16737 =item Autocreating constants
16738
16739 =item PERFORMANCE
16740
16741 =over 4
16742
16743 =item Alternative math libraries
16744
16745 =item SUBCLASSING
16746
16747 =back
16748
16749 =item Subclassing Math::BigInt
16750
16751 =item UPGRADING
16752
16753 =over 4
16754
16755 =item Auto-upgrade
16756
16757 bsqrt(), div(), blog()
16758
16759 =back
16760
16761 =item BUGS
16762
16763 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16764 5.6.0
16765
16766 =item CAVEATS
16767
16768 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
16769 Modifying and =, bpow, Overloading -$x, Mixing different object types,
16770 bsqrt(), brsft()
16771
16772 =item LICENSE
16773
16774 =item SEE ALSO
16775
16776 =item AUTHORS
16777
16778 =back
16779
16780 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16781
16782 =over 4
16783
16784 =item SYNOPSIS
16785
16786 =item DESCRIPTION
16787
16788 =item STORAGE
16789
16790 =item METHODS
16791
16792 =item WRAP YOUR OWN
16793
16794 =item LICENSE
16795
16796 This program is free software; you may redistribute it and/or modify it
16797 under
16798 the same terms as Perl itself. 
16799
16800 =item AUTHORS
16801
16802 =item SEE ALSO
16803
16804 =back
16805
16806 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
16807
16808 =over 4
16809
16810 =item SYNOPSIS
16811
16812 =item DESCRIPTION
16813
16814 =item METHODS
16815
16816 =item LICENSE
16817
16818 This program is free software; you may redistribute it and/or modify it
16819 under
16820 the same terms as Perl itself. 
16821
16822 =item AUTHORS
16823
16824 =item SEE ALSO
16825
16826 =back
16827
16828 =head2 Math::BigRat - arbitrarily big rational numbers
16829
16830 =over 4
16831
16832 =item SYNOPSIS
16833
16834 =item DESCRIPTION
16835
16836 =over 4
16837
16838 =item MATH LIBRARY
16839
16840 =back
16841
16842 =item METHODS
16843
16844 =over 4
16845
16846 =item new()
16847
16848 =item numerator()
16849
16850 =item denominator()
16851
16852         $d = $x->denominator();
16853
16854 =item parts()
16855
16856 =item as_number()
16857
16858 =item bfac()
16859
16860 =item blog()
16861
16862 =item bround()/round()/bfround()
16863
16864 =item bmod()
16865
16866 =item is_one()
16867
16868 =item is_zero()
16869
16870 =item is_positive()
16871
16872 =item is_negative()
16873
16874 =item is_int()
16875
16876 =item is_odd()
16877
16878 =item is_even()
16879
16880 =item bceil()
16881
16882 =item bfloor()
16883
16884         $x->bfloor();
16885
16886 =item bsqrt()
16887
16888         $x->bsqrt();
16889
16890 =item config
16891
16892 =back
16893
16894 =item BUGS
16895
16896 inf handling (partial), NaN handling (partial), rounding (not implemented
16897 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
16898 blog(), bmodinv() and bmodpow() (partial)
16899
16900 =item LICENSE
16901
16902 =item SEE ALSO
16903
16904 =item AUTHORS
16905
16906 =back
16907
16908 =head2 Math::Complex - complex numbers and associated mathematical
16909 functions
16910
16911 =over 4
16912
16913 =item SYNOPSIS
16914
16915 =item DESCRIPTION
16916
16917 =item OPERATIONS
16918
16919 =item CREATION
16920
16921 =item STRINGIFICATION
16922
16923 =over 4
16924
16925 =item CHANGED IN PERL 5.6
16926
16927 =back
16928
16929 =item USAGE
16930
16931 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16932
16933 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16934
16935 =item BUGS
16936
16937 =item AUTHORS
16938
16939 =back
16940
16941 =head2 Math::Trig - trigonometric functions
16942
16943 =over 4
16944
16945 =item SYNOPSIS
16946
16947 =item DESCRIPTION
16948
16949 =item TRIGONOMETRIC FUNCTIONS
16950
16951 B<tan>
16952
16953 =over 4
16954
16955 =item ERRORS DUE TO DIVISION BY ZERO
16956
16957 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16958
16959 =back
16960
16961 =item PLANE ANGLE CONVERSIONS
16962
16963 =item RADIAL COORDINATE CONVERSIONS
16964
16965 =over 4
16966
16967 =item COORDINATE SYSTEMS
16968
16969 =item 3-D ANGLE CONVERSIONS
16970
16971 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16972 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16973
16974 =back
16975
16976 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16977
16978 =item EXAMPLES
16979
16980 =over 4
16981
16982 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16983
16984 =back
16985
16986 =item BUGS
16987
16988 =item AUTHORS
16989
16990 =back
16991
16992 =head2 Memoize - Make functions faster by trading space for time
16993
16994 =over 4
16995
16996 =item SYNOPSIS
16997
16998 =item DESCRIPTION
16999
17000 =item DETAILS
17001
17002 =item OPTIONS
17003
17004 =over 4
17005
17006 =item INSTALL
17007
17008 =item NORMALIZER
17009
17010 =item C<SCALAR_CACHE>, C<LIST_CACHE>
17011
17012 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
17013
17014 =back
17015
17016 =item OTHER FACILITIES
17017
17018 =over 4
17019
17020 =item C<unmemoize>
17021
17022 =item C<flush_cache>
17023
17024 =back
17025
17026 =item CAVEATS
17027
17028 =item PERSISTENT CACHE SUPPORT
17029
17030 =item EXPIRATION SUPPORT
17031
17032 =item BUGS
17033
17034 =item MAILING LIST
17035
17036 =item AUTHOR
17037
17038 =item COPYRIGHT AND LICENSE
17039
17040 =item THANK YOU
17041
17042 =back
17043
17044 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
17045 Storable use
17046
17047 =over 4
17048
17049 =item DESCRIPTION
17050
17051 =back
17052
17053 =head2 Memoize::Expire - Plug-in module for automatic expiration of
17054 memoized values
17055
17056 =over 4
17057
17058 =item SYNOPSIS
17059
17060 =item DESCRIPTION
17061
17062 =item INTERFACE
17063
17064  TIEHASH,  EXISTS,  STORE
17065
17066 =item ALTERNATIVES
17067
17068 =item CAVEATS
17069
17070 =item AUTHOR
17071
17072 =item SEE ALSO
17073
17074 =back
17075
17076 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
17077
17078 =over 4
17079
17080 =item DESCRIPTION
17081
17082 =back
17083
17084 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
17085
17086 =over 4
17087
17088 =item DESCRIPTION
17089
17090 =back
17091
17092 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
17093 Storable use
17094
17095 =over 4
17096
17097 =item DESCRIPTION
17098
17099 =back
17100
17101 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
17102 Storable use
17103
17104 =over 4
17105
17106 =item DESCRIPTION
17107
17108 =back
17109
17110 =head2 Memoize::Storable - store Memoized data in Storable database
17111
17112 =over 4
17113
17114 =item DESCRIPTION
17115
17116 =back
17117
17118 =head2 NDBM_File - Tied access to ndbm files
17119
17120 =over 4
17121
17122 =item SYNOPSIS
17123
17124 =item DESCRIPTION
17125
17126 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17127
17128 =item DIAGNOSTICS
17129
17130 =over 4
17131
17132 =item C<ndbm store returned -1, errno 22, key "..." at ...>
17133
17134 =back
17135
17136 =item BUGS AND WARNINGS
17137
17138 =back
17139
17140 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
17141 redispatch
17142
17143 =over 4
17144
17145 =item SYNOPSIS
17146
17147 =item DESCRIPTION
17148
17149 =over 4
17150
17151 =item Enforcing redispatch
17152
17153 =item Avoiding repetitions
17154
17155 =item Invoking all versions of a method with a single call
17156
17157 =item Using C<EVERY> methods
17158
17159 =back
17160
17161 =item AUTHOR
17162
17163 =item BUGS AND IRRITATIONS
17164
17165 =item COPYRIGHT
17166
17167 =back
17168
17169 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17170
17171 =over 4
17172
17173 =item SYNOPSIS
17174
17175 =item DESCRIPTION
17176
17177 =item USER METHODS
17178
17179 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17180 dataend ()
17181
17182 =item CLASS METHODS
17183
17184 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17185 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17186 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17187
17188 =item EXPORTS
17189
17190 =item AUTHOR
17191
17192 =item COPYRIGHT
17193
17194 =back
17195
17196 =head2 Net::Config - Local configuration data for libnet
17197
17198 =over 4
17199
17200 =item SYNOPSYS
17201
17202 =item DESCRIPTION
17203
17204 =item METHODS
17205
17206 requires_firewall HOST
17207
17208 =item NetConfig VALUES
17209
17210 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17211 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17212 ftp_int_pasive, local_netmask, test_hosts, test_exists
17213
17214 =back
17215
17216 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17217 and domain
17218
17219 =over 4
17220
17221 =item SYNOPSIS
17222
17223 =item DESCRIPTION
17224
17225 hostfqdn (), hostname (), hostdomain ()
17226
17227 =item AUTHOR
17228
17229 =item COPYRIGHT
17230
17231 =back
17232
17233 =head2 Net::FTP - FTP Client class
17234
17235 =over 4
17236
17237 =item SYNOPSIS
17238
17239 =item DESCRIPTION
17240
17241 =item OVERVIEW
17242
17243 =item CONSTRUCTOR
17244
17245 new ([ HOST ] [, OPTIONS ])
17246
17247 =item METHODS
17248
17249 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17250 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17251 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17252 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
17253 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
17254 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
17255 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
17256 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
17257 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
17258 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
17259 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
17260 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
17261 abort (), quit ()
17262
17263 =over 4
17264
17265 =item Methods for the adventurous
17266
17267 quot (CMD [,ARGS])
17268
17269 =back
17270
17271 =item THE dataconn CLASS
17272
17273 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17274 bytes_read (), abort (), close ()
17275
17276 =item UNIMPLEMENTED
17277
17278 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17279
17280 =item REPORTING BUGS
17281
17282 =item AUTHOR
17283
17284 =item SEE ALSO
17285
17286 =item USE EXAMPLES
17287
17288 http://www.csh.rit.edu/~adam/Progs/
17289
17290 =item CREDITS
17291
17292 =item COPYRIGHT
17293
17294 =back
17295
17296 =head2 Net::NNTP - NNTP Client class
17297
17298 =over 4
17299
17300 =item SYNOPSIS
17301
17302 =item DESCRIPTION
17303
17304 =item CONSTRUCTOR
17305
17306 new ( [ HOST ] [, OPTIONS ])
17307
17308 =item METHODS
17309
17310 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17311 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17312 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17313 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17314 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17315 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17316 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17317
17318 =over 4
17319
17320 =item Extension methods
17321
17322 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17323 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17324 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17325 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17326 GROUP ] ), reader
17327
17328 =back
17329
17330 =item UNSUPPORTED
17331
17332 =item DEFINITIONS
17333
17334 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17335
17336 =item SEE ALSO
17337
17338 =item AUTHOR
17339
17340 =item COPYRIGHT
17341
17342 =back
17343
17344 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17345
17346 =over 4
17347
17348 =item SYNOPSIS
17349
17350 =item DESCRIPTION
17351
17352 =item CONSTRUCTOR
17353
17354 new ( [ HOST ] [, OPTIONS ] 0
17355
17356 =item METHODS
17357
17358 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
17359 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
17360 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
17361 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
17362 ), delete ( MSGNUM ), reset (), quit ()
17363
17364 =item NOTES
17365
17366 =item SEE ALSO
17367
17368 =item AUTHOR
17369
17370 =item COPYRIGHT
17371
17372 =back
17373
17374 =head2 Net::Ping - check a remote host for reachability
17375
17376 =over 4
17377
17378 =item SYNOPSIS
17379
17380 =item DESCRIPTION
17381
17382 =over 4
17383
17384 =item Functions
17385
17386 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
17387 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
17388 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
17389 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
17390 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
17391 [, $timeout]);
17392
17393 =back
17394
17395 =item NOTES
17396
17397 =item INSTALL
17398
17399 =item BUGS
17400
17401 =item AUTHORS
17402
17403 =item COPYRIGHT
17404
17405 =back
17406
17407 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
17408
17409 =over 4
17410
17411 =item SYNOPSIS
17412
17413 =item DESCRIPTION
17414
17415 =item EXAMPLES
17416
17417 =item CONSTRUCTOR
17418
17419 new ( [ HOST ] [, OPTIONS ] )
17420
17421 =item METHODS
17422
17423 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
17424 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
17425 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
17426 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
17427 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
17428 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
17429 $subject ] ), quit ()
17430
17431 =item ADDRESSES
17432
17433 =item SEE ALSO
17434
17435 =item AUTHOR
17436
17437 =item COPYRIGHT
17438
17439 =back
17440
17441 =head2 Net::Time - time and daytime network client interface
17442
17443 =over 4
17444
17445 =item SYNOPSIS
17446
17447 =item DESCRIPTION
17448
17449 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17450 PROTOCOL [, TIMEOUT]]])
17451
17452 =item AUTHOR
17453
17454 =item COPYRIGHT
17455
17456 =back
17457
17458 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17459 functions
17460
17461 =over 4
17462
17463 =item SYNOPSIS
17464
17465 =item DESCRIPTION
17466
17467 =item EXAMPLES
17468
17469 =item NOTE
17470
17471 =item AUTHOR
17472
17473 =back
17474
17475 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17476
17477 =over 4
17478
17479 =item DESCRIPTION
17480
17481 =over 4
17482
17483 =item Where to get this document
17484
17485 =item How to contribute to this document
17486
17487 =back
17488
17489 =item Author and Copyright Information
17490
17491 =over 4
17492
17493 =item Disclaimer
17494
17495 =back
17496
17497 =item Obtaining and installing libnet
17498
17499 =over 4
17500
17501 =item What is libnet ?
17502
17503 =item Which version of perl do I need ?
17504
17505 =item What other modules do I need ?
17506
17507 =item What machines support libnet ?
17508
17509 =item Where can I get the latest libnet release
17510
17511 =back
17512
17513 =item Using Net::FTP
17514
17515 =over 4
17516
17517 =item How do I download files from an FTP server ?
17518
17519 =item How do I transfer files in binary mode ?
17520
17521 =item How can I get the size of a file on a remote FTP server ?
17522
17523 =item How can I get the modification time of a file on a remote FTP server
17524 ?
17525
17526 =item How can I change the permissions of a file on a remote server ?
17527
17528 =item Can I do a reget operation like the ftp command ?
17529
17530 =item How do I get a directory listing from an FTP server ?
17531
17532 =item Changing directory to "" does not fail ?
17533
17534 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17535
17536 =item I am behind an FTP proxy firewall, but cannot access machines outside
17537 ?
17538
17539 =item My ftp proxy firewall does not listen on port 21
17540
17541 =item Is it possible to change the file permissions of a file on an FTP
17542 server ?
17543
17544 =item I have seen scripts call a method message, but cannot find it
17545 documented ?
17546
17547 =item Why does Net::FTP not implement mput and mget methods
17548
17549 =back
17550
17551 =item Using Net::SMTP
17552
17553 =over 4
17554
17555 =item Why can't the part of an Email address after the @ be used as the
17556 hostname ?
17557
17558 =item Why does Net::SMTP not do DNS MX lookups ?
17559
17560 =item The verify method always returns true ?
17561
17562 =back
17563
17564 =item Debugging scripts
17565
17566 =over 4
17567
17568 =item How can I debug my scripts that use Net::* modules ?
17569
17570 =back
17571
17572 =item AUTHOR AND COPYRIGHT
17573
17574 =back
17575
17576 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17577 functions
17578
17579 =over 4
17580
17581 =item SYNOPSIS
17582
17583 =item DESCRIPTION
17584
17585 =item EXAMPLES
17586
17587 =item NOTE
17588
17589 =item AUTHOR
17590
17591 =back
17592
17593 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17594 functions
17595
17596 =over 4
17597
17598 =item SYNOPSIS
17599
17600 =item DESCRIPTION
17601
17602 =item NOTE
17603
17604 =item AUTHOR
17605
17606 =back
17607
17608 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17609 functions
17610
17611 =over 4
17612
17613 =item SYNOPSIS
17614
17615 =item DESCRIPTION
17616
17617 =item EXAMPLES
17618
17619 =item NOTE
17620
17621 =item AUTHOR
17622
17623 =back
17624
17625 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17626
17627 =over 4
17628
17629 =item SYNOPSIS
17630
17631 =item DESCRIPTION
17632
17633 =item THE .netrc FILE
17634
17635 machine name, default, login name, password string, account string, macdef
17636 name
17637
17638 =item CONSTRUCTOR
17639
17640 lookup ( MACHINE [, LOGIN ])
17641
17642 =item METHODS
17643
17644 login (), password (), account (), lpa ()
17645
17646 =item AUTHOR
17647
17648 =item SEE ALSO
17649
17650 =item COPYRIGHT
17651
17652 =back
17653
17654 =head2 O - Generic interface to Perl Compiler backends
17655
17656 =over 4
17657
17658 =item SYNOPSIS
17659
17660 =item DESCRIPTION
17661
17662 =item CONVENTIONS
17663
17664 =item IMPLEMENTATION
17665
17666 =item BUGS
17667
17668 =item AUTHOR
17669
17670 =back
17671
17672 =head2 ODBM_File - Tied access to odbm files
17673
17674 =over 4
17675
17676 =item SYNOPSIS
17677
17678 =item DESCRIPTION
17679
17680 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17681
17682 =item DIAGNOSTICS
17683
17684 =over 4
17685
17686 =item C<odbm store returned -1, errno 22, key "..." at ...>
17687
17688 =back
17689
17690 =item BUGS AND WARNINGS
17691
17692 =back
17693
17694 =head2 Opcode - Disable named opcodes when compiling perl code
17695
17696 =over 4
17697
17698 =item SYNOPSIS
17699
17700 =item DESCRIPTION
17701
17702 =item NOTE
17703
17704 =item WARNING
17705
17706 =item Operator Names and Operator Lists
17707
17708 an operator name (opname), an operator tag name (optag), a negated opname
17709 or optag, an operator set (opset)
17710
17711 =item Opcode Functions
17712
17713 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17714 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17715 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17716 opdump (PAT)
17717
17718 =item Manipulating Opsets
17719
17720 =item TO DO (maybe)
17721
17722 =back
17723
17724 =over 4
17725
17726 =item Predefined Opcode Tags
17727
17728 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17729 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17730 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17731 :dangerous
17732
17733 =item SEE ALSO
17734
17735 =item AUTHORS
17736
17737 =back
17738
17739 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17740 compartments
17741
17742 =over 4
17743
17744 =item SYNOPSIS
17745
17746 =item DESCRIPTION
17747
17748 a new namespace, an operator mask
17749
17750 =item WARNING
17751
17752 =over 4
17753
17754 =item RECENT CHANGES
17755
17756 =item Methods in class Safe
17757
17758 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17759 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17760 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17761 root (NAMESPACE), mask (MASK)
17762
17763 =item Some Safety Issues
17764
17765 Memory, CPU, Snooping, Signals, State Changes
17766
17767 =item AUTHOR
17768
17769 =back
17770
17771 =back
17772
17773 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17774 compiling
17775
17776 =over 4
17777
17778 =item SYNOPSIS  
17779
17780 =item DESCRIPTION
17781
17782 =item SEE ALSO
17783
17784 =back
17785
17786 =head2 POSIX - Perl interface to IEEE Std 1003.1
17787
17788 =over 4
17789
17790 =item SYNOPSIS
17791
17792 =item DESCRIPTION
17793
17794 =item NOTE
17795
17796 =item CAVEATS 
17797
17798 =item FUNCTIONS
17799
17800 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17801 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17802 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17803 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17804 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17805 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17806 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17807 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17808 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17809 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17810 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17811 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17812 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17813 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17814 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17815 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17816 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17817 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17818 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17819 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17820 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17821 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17822 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17823 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17824 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17825 wctomb, write
17826
17827 =item CLASSES
17828
17829 =over 4
17830
17831 =item POSIX::SigAction
17832
17833 new, handler, mask, flags, safe
17834
17835 =item POSIX::SigSet
17836
17837 new, addset, delset, emptyset, fillset, ismember
17838
17839 =item POSIX::Termios
17840
17841 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17842 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17843 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17844 field values, c_cflag field values, c_iflag field values, c_lflag field
17845 values, c_oflag field values
17846
17847 =back
17848
17849 =item PATHNAME CONSTANTS
17850
17851 Constants
17852
17853 =item POSIX CONSTANTS
17854
17855 Constants
17856
17857 =item SYSTEM CONFIGURATION
17858
17859 Constants
17860
17861 =item ERRNO
17862
17863 Constants
17864
17865 =item FCNTL
17866
17867 Constants
17868
17869 =item FLOAT
17870
17871 Constants
17872
17873 =item LIMITS
17874
17875 Constants
17876
17877 =item LOCALE
17878
17879 Constants
17880
17881 =item MATH
17882
17883 Constants
17884
17885 =item SIGNAL
17886
17887 Constants
17888
17889 =item STAT
17890
17891 Constants, Macros
17892
17893 =item STDLIB
17894
17895 Constants
17896
17897 =item STDIO
17898
17899 Constants
17900
17901 =item TIME
17902
17903 Constants
17904
17905 =item UNISTD
17906
17907 Constants
17908
17909 =item WAIT
17910
17911 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17912 WTERMSIG, WIFSTOPPED, WSTOPSIG
17913
17914 =back
17915
17916 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17917 name space
17918
17919 =over 4
17920
17921 =item SYNOPSIS
17922
17923 =item DESCRIPTION
17924
17925 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
17926
17927 =over 4
17928
17929 =item Custom Layers
17930
17931 :encoding, :via
17932
17933 =item Alternatives to raw
17934
17935 =item Defaults and how to override them
17936
17937 =item Querying the layers of filehandles
17938
17939 =back
17940
17941 =item AUTHOR
17942
17943 =item SEE ALSO
17944
17945 =back
17946
17947 =head2 PerlIO::encoding - encoding layer
17948
17949 =over 4
17950
17951 =item SYNOPSIS
17952
17953 =item DESCRIPTION
17954
17955 =item SEE ALSO
17956
17957 =back
17958
17959 =head2 PerlIO::scalar - in-memory IO, scalar IO
17960
17961 =over 4
17962
17963 =item SYNOPSIS
17964
17965 =item DESCRIPTION
17966
17967 =item IMPLEMENTATION NOTE
17968
17969 =back
17970
17971 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17972
17973 =over 4
17974
17975 =item SYNOPSIS
17976
17977 =item DESCRIPTION
17978
17979 =item EXPECTED METHODS
17980
17981 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17982 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
17983 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
17984 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
17985 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
17986 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
17987 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
17988 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
17989
17990 =item EXAMPLES
17991
17992 =over 4
17993
17994 =item Example - a Hexadecimal Handle
17995
17996 =back
17997
17998 =back
17999
18000 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
18001
18002 =over 4
18003
18004 =item SYNOPSIS
18005
18006 =item DESCRIPTION
18007
18008 =item REQUIRED MODULES
18009
18010 =item SEE ALSO
18011
18012 =item ACKNOWLEDGEMENTS
18013
18014 =item COPYRIGHT
18015
18016 =back
18017
18018 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
18019
18020 =over 4
18021
18022 =item SYNOPSIS
18023
18024 =item OPTIONS/ARGUMENTS
18025
18026 =over 4
18027
18028 =item podchecker()
18029
18030 B<-warnings> =E<gt> I<val>
18031
18032 =back
18033
18034 =item DESCRIPTION
18035
18036 =item DIAGNOSTICS
18037
18038 =over 4
18039
18040 =item Errors
18041
18042 empty =headn, =over on line I<N> without closing =back, =item without
18043 previous =over, =back without previous =over, No argument for =begin, =end
18044 without =begin, Nested =begin's, =for without formatter specification,
18045 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
18046 interior-sequence "I<SEQ>", nested commands
18047 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
18048 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
18049 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
18050 after =back
18051
18052 =item Warnings
18053
18054 multiple occurrence of link target I<name>, line containing nothing but
18055 whitespace in paragraph, file does not start with =head, previous =item has
18056 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
18057 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
18058 items in =over, No argument for =item, empty section in previous paragraph,
18059 Verbatim paragraph in NAME section, =headI<n> without preceding higher
18060 level
18061
18062 =item Hyperlinks
18063
18064 ignoring leading/trailing whitespace in link, (section) in '$page'
18065 deprecated, alternative text/node '%s' contains non-escaped | or /
18066
18067 =back
18068
18069 =item RETURN VALUE
18070
18071 =item EXAMPLES
18072
18073 =item INTERFACE
18074
18075 =back
18076
18077 C<Pod::Checker-E<gt>new( %options )>
18078
18079 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
18080 @args )>
18081
18082 C<$checker-E<gt>num_errors()>
18083
18084 C<$checker-E<gt>num_warnings()>
18085
18086 C<$checker-E<gt>name()>
18087
18088 C<$checker-E<gt>node()>
18089
18090 C<$checker-E<gt>idx()>
18091
18092 C<$checker-E<gt>hyperlink()>
18093
18094 =over 4
18095
18096 =item AUTHOR
18097
18098 =back
18099
18100 =head2 Pod::Find - find POD documents in directory trees
18101
18102 =over 4
18103
18104 =item SYNOPSIS
18105
18106 =item DESCRIPTION
18107
18108 =back
18109
18110 =over 4
18111
18112 =item C<pod_find( { %opts } , @directories )>
18113
18114 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
18115 1>
18116
18117 =back
18118
18119 =over 4
18120
18121 =item C<simplify_name( $str )>
18122
18123 =back
18124
18125 =over 4
18126
18127 =item C<pod_where( { %opts }, $pod )>
18128
18129 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
18130 1>
18131
18132 =back
18133
18134 =over 4
18135
18136 =item C<contains_pod( $file , $verbose )>
18137
18138 =back
18139
18140 =over 4
18141
18142 =item AUTHOR
18143
18144 =item SEE ALSO
18145
18146 =back
18147
18148 =head2 Pod::Html - module to convert pod files to HTML
18149
18150 =over 4
18151
18152 =item SYNOPSIS
18153
18154 =item DESCRIPTION
18155
18156 =item ARGUMENTS
18157
18158 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
18159 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
18160 quiet, recurse, title, verbose
18161
18162 =item EXAMPLE
18163
18164 =item ENVIRONMENT
18165
18166 =item AUTHOR
18167
18168 =item SEE ALSO
18169
18170 =item COPYRIGHT
18171
18172 =back
18173
18174 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18175 commands, etc.
18176
18177 =over 4
18178
18179 =item SYNOPSIS
18180
18181 =item REQUIRES
18182
18183 =item EXPORTS
18184
18185 =item DESCRIPTION
18186
18187 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18188 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18189
18190 =back
18191
18192 =over 4
18193
18194 =item B<Pod::InputSource>
18195
18196 =back
18197
18198 =over 4
18199
18200 =item B<new()>
18201
18202 =back
18203
18204 =over 4
18205
18206 =item B<name()>
18207
18208 =back
18209
18210 =over 4
18211
18212 =item B<handle()>
18213
18214 =back
18215
18216 =over 4
18217
18218 =item B<was_cutting()>
18219
18220 =back
18221
18222 =over 4
18223
18224 =item B<Pod::Paragraph>
18225
18226 =back
18227
18228 =over 4
18229
18230 =item Pod::Paragraph-E<gt>B<new()>
18231
18232 =back
18233
18234 =over 4
18235
18236 =item $pod_para-E<gt>B<cmd_name()>
18237
18238 =back
18239
18240 =over 4
18241
18242 =item $pod_para-E<gt>B<text()>
18243
18244 =back
18245
18246 =over 4
18247
18248 =item $pod_para-E<gt>B<raw_text()>
18249
18250 =back
18251
18252 =over 4
18253
18254 =item $pod_para-E<gt>B<cmd_prefix()>
18255
18256 =back
18257
18258 =over 4
18259
18260 =item $pod_para-E<gt>B<cmd_separator()>
18261
18262 =back
18263
18264 =over 4
18265
18266 =item $pod_para-E<gt>B<parse_tree()>
18267
18268 =back
18269
18270 =over 4
18271
18272 =item $pod_para-E<gt>B<file_line()>
18273
18274 =back
18275
18276 =over 4
18277
18278 =item B<Pod::InteriorSequence>
18279
18280 =back
18281
18282 =over 4
18283
18284 =item Pod::InteriorSequence-E<gt>B<new()>
18285
18286 =back
18287
18288 =over 4
18289
18290 =item $pod_seq-E<gt>B<cmd_name()>
18291
18292 =back
18293
18294 =over 4
18295
18296 =item $pod_seq-E<gt>B<prepend()>
18297
18298 =back
18299
18300 =over 4
18301
18302 =item $pod_seq-E<gt>B<append()>
18303
18304 =back
18305
18306 =over 4
18307
18308 =item $pod_seq-E<gt>B<nested()>
18309
18310 =back
18311
18312 =over 4
18313
18314 =item $pod_seq-E<gt>B<raw_text()>
18315
18316 =back
18317
18318 =over 4
18319
18320 =item $pod_seq-E<gt>B<left_delimiter()>
18321
18322 =back
18323
18324 =over 4
18325
18326 =item $pod_seq-E<gt>B<right_delimiter()>
18327
18328 =back
18329
18330 =over 4
18331
18332 =item $pod_seq-E<gt>B<parse_tree()>
18333
18334 =back
18335
18336 =over 4
18337
18338 =item $pod_seq-E<gt>B<file_line()>
18339
18340 =back
18341
18342 =over 4
18343
18344 =item Pod::InteriorSequence::B<DESTROY()>
18345
18346 =back
18347
18348 =over 4
18349
18350 =item B<Pod::ParseTree>
18351
18352 =back
18353
18354 =over 4
18355
18356 =item Pod::ParseTree-E<gt>B<new()>
18357
18358 =back
18359
18360 =over 4
18361
18362 =item $ptree-E<gt>B<top()>
18363
18364 =back
18365
18366 =over 4
18367
18368 =item $ptree-E<gt>B<children()>
18369
18370 =back
18371
18372 =over 4
18373
18374 =item $ptree-E<gt>B<prepend()>
18375
18376 =back
18377
18378 =over 4
18379
18380 =item $ptree-E<gt>B<append()>
18381
18382 =back
18383
18384 =over 4
18385
18386 =item $ptree-E<gt>B<raw_text()>
18387
18388 =back
18389
18390 =over 4
18391
18392 =item Pod::ParseTree::B<DESTROY()>
18393
18394 =back
18395
18396 =over 4
18397
18398 =item SEE ALSO
18399
18400 =item AUTHOR
18401
18402 =back
18403
18404 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
18405
18406 =over 4
18407
18408 =item SYNOPSIS
18409
18410 =item DESCRIPTION
18411
18412 =back
18413
18414 =over 4
18415
18416 =item OBJECT METHODS
18417
18418 C<initialize>
18419
18420 =back
18421
18422 =over 4
18423
18424 =item Data Accessors
18425
18426 B<AddPreamble>
18427
18428 =back
18429
18430 B<AddPostamble>
18431
18432 B<Head1Level>
18433
18434 B<Label>
18435
18436 B<LevelNoNum>
18437
18438 B<MakeIndex>
18439
18440 B<ReplaceNAMEwithSection>
18441
18442 B<StartWithNewPage>
18443
18444 B<TableOfContents>
18445
18446 B<UniqueLabels>
18447
18448 B<UserPreamble>
18449
18450 B<UserPostamble>
18451
18452 B<Lists>
18453
18454 =over 4
18455
18456 =item Subclassed methods
18457
18458 =back
18459
18460 B<begin_pod>
18461
18462 B<end_pod>
18463
18464 B<command>
18465
18466 B<verbatim>
18467
18468 B<textblock>
18469
18470 B<interior_sequence>
18471
18472 =over 4
18473
18474 =item List Methods
18475
18476 B<begin_list>
18477
18478 =back
18479
18480 B<end_list>
18481
18482 B<add_item>
18483
18484 =over 4
18485
18486 =item Methods for headings
18487
18488 B<head>
18489
18490 =back
18491
18492 =over 4
18493
18494 =item Internal methods
18495
18496 B<_output>
18497
18498 =back
18499
18500 B<_replace_special_chars>
18501
18502 B<_replace_special_chars_late>
18503
18504 B<_create_label>
18505
18506 B<_create_index>
18507
18508 B<_clean_latex_commands>
18509
18510 B<_split_delimited>
18511
18512 =over 4
18513
18514 =item NOTES
18515
18516 =item SEE ALSO
18517
18518 =item AUTHORS
18519
18520 =item COPYRIGHT
18521
18522 =item REVISION
18523
18524 =back
18525
18526 =head2 Pod::Man - Convert POD data to formatted *roff input
18527
18528 =over 4
18529
18530 =item SYNOPSIS
18531
18532 =item DESCRIPTION
18533
18534 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18535 release, section
18536
18537 =item DIAGNOSTICS
18538
18539 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18540 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18541 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18542 =back
18543
18544 =item BUGS
18545
18546 =item CAVEATS
18547
18548 =item SEE ALSO
18549
18550 =item AUTHOR
18551
18552 =item COPYRIGHT AND LICENSE
18553
18554 =back
18555
18556 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18557
18558 =over 4
18559
18560 =item SYNOPSIS
18561
18562 =item DESCRIPTION
18563
18564 =item SEE ALSO
18565
18566 =item AUTHOR
18567
18568 =item COPYRIGHT AND LICENSE
18569
18570 =back
18571
18572 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18573
18574 =over 4
18575
18576 =item SYNOPSIS
18577
18578 =item DESCRIPTION
18579
18580 =back
18581
18582 =over 4
18583
18584 =item Pod::List
18585
18586 Pod::List-E<gt>new()
18587
18588 =back
18589
18590 $list-E<gt>file()
18591
18592 $list-E<gt>start()
18593
18594 $list-E<gt>indent()
18595
18596 $list-E<gt>type()
18597
18598 $list-E<gt>rx()
18599
18600 $list-E<gt>item()
18601
18602 $list-E<gt>parent()
18603
18604 $list-E<gt>tag()
18605
18606 =over 4
18607
18608 =item Pod::Hyperlink
18609
18610 Pod::Hyperlink-E<gt>new()
18611
18612 =back
18613
18614 $link-E<gt>parse($string)
18615
18616 $link-E<gt>markup($string)
18617
18618 $link-E<gt>text()
18619
18620 $link-E<gt>warning()
18621
18622 $link-E<gt>file(), $link-E<gt>line()
18623
18624 $link-E<gt>page()
18625
18626 $link-E<gt>node()
18627
18628 $link-E<gt>alttext()
18629
18630 $link-E<gt>type()
18631
18632 $link-E<gt>link()
18633
18634 =over 4
18635
18636 =item Pod::Cache
18637
18638 Pod::Cache-E<gt>new()
18639
18640 =back
18641
18642 $cache-E<gt>item()
18643
18644 $cache-E<gt>find_page($name)
18645
18646 =over 4
18647
18648 =item Pod::Cache::Item
18649
18650 Pod::Cache::Item-E<gt>new()
18651
18652 =back
18653
18654 $cacheitem-E<gt>page()
18655
18656 $cacheitem-E<gt>description()
18657
18658 $cacheitem-E<gt>path()
18659
18660 $cacheitem-E<gt>file()
18661
18662 $cacheitem-E<gt>nodes()
18663
18664 $cacheitem-E<gt>find_node($name)
18665
18666 $cacheitem-E<gt>idx()
18667
18668 =over 4
18669
18670 =item AUTHOR
18671
18672 =item SEE ALSO
18673
18674 =back
18675
18676 =head2 Pod::Parser - base class for creating POD filters and translators
18677
18678 =over 4
18679
18680 =item SYNOPSIS
18681
18682 =item REQUIRES
18683
18684 =item EXPORTS
18685
18686 =item DESCRIPTION
18687
18688 =item QUICK OVERVIEW
18689
18690 =item PARSING OPTIONS
18691
18692 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18693 B<-warnings> (default: unset)
18694
18695 =back
18696
18697 =over 4
18698
18699 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18700
18701 =back
18702
18703 =over 4
18704
18705 =item B<command()>
18706
18707 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18708
18709 =back
18710
18711 =over 4
18712
18713 =item B<verbatim()>
18714
18715 C<$text>, C<$line_num>, C<$pod_para>
18716
18717 =back
18718
18719 =over 4
18720
18721 =item B<textblock()>
18722
18723 C<$text>, C<$line_num>, C<$pod_para>
18724
18725 =back
18726
18727 =over 4
18728
18729 =item B<interior_sequence()>
18730
18731 =back
18732
18733 =over 4
18734
18735 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18736
18737 =back
18738
18739 =over 4
18740
18741 =item B<new()>
18742
18743 =back
18744
18745 =over 4
18746
18747 =item B<initialize()>
18748
18749 =back
18750
18751 =over 4
18752
18753 =item B<begin_pod()>
18754
18755 =back
18756
18757 =over 4
18758
18759 =item B<begin_input()>
18760
18761 =back
18762
18763 =over 4
18764
18765 =item B<end_input()>
18766
18767 =back
18768
18769 =over 4
18770
18771 =item B<end_pod()>
18772
18773 =back
18774
18775 =over 4
18776
18777 =item B<preprocess_line()>
18778
18779 =back
18780
18781 =over 4
18782
18783 =item B<preprocess_paragraph()>
18784
18785 =back
18786
18787 =over 4
18788
18789 =item METHODS FOR PARSING AND PROCESSING
18790
18791 =back
18792
18793 =over 4
18794
18795 =item B<parse_text()>
18796
18797 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18798 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18799 I<code-ref>|I<method-name>
18800
18801 =back
18802
18803 =over 4
18804
18805 =item B<interpolate()>
18806
18807 =back
18808
18809 =over 4
18810
18811 =item B<parse_paragraph()>
18812
18813 =back
18814
18815 =over 4
18816
18817 =item B<parse_from_filehandle()>
18818
18819 =back
18820
18821 =over 4
18822
18823 =item B<parse_from_file()>
18824
18825 =back
18826
18827 =over 4
18828
18829 =item ACCESSOR METHODS
18830
18831 =back
18832
18833 =over 4
18834
18835 =item B<errorsub()>
18836
18837 =back
18838
18839 =over 4
18840
18841 =item B<cutting()>
18842
18843 =back
18844
18845 =over 4
18846
18847 =item B<parseopts()>
18848
18849 =back
18850
18851 =over 4
18852
18853 =item B<output_file()>
18854
18855 =back
18856
18857 =over 4
18858
18859 =item B<output_handle()>
18860
18861 =back
18862
18863 =over 4
18864
18865 =item B<input_file()>
18866
18867 =back
18868
18869 =over 4
18870
18871 =item B<input_handle()>
18872
18873 =back
18874
18875 =over 4
18876
18877 =item B<input_streams()>
18878
18879 =back
18880
18881 =over 4
18882
18883 =item B<top_stream()>
18884
18885 =back
18886
18887 =over 4
18888
18889 =item PRIVATE METHODS AND DATA
18890
18891 =back
18892
18893 =over 4
18894
18895 =item B<_push_input_stream()>
18896
18897 =back
18898
18899 =over 4
18900
18901 =item B<_pop_input_stream()>
18902
18903 =back
18904
18905 =over 4
18906
18907 =item TREE-BASED PARSING
18908
18909 =item SEE ALSO
18910
18911 =item AUTHOR
18912
18913 =back
18914
18915 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18916
18917 =over 4
18918
18919 =item SYNOPSIS
18920
18921 =item DESCRIPTION
18922
18923 =item SEE ALSO
18924
18925 =item COPYRIGHT AND DISCLAIMERS
18926
18927 =item AUTHOR
18928
18929 =back
18930
18931 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18932
18933 =over 4
18934
18935 =item SYNOPSIS
18936
18937 =item DESCRIPTION
18938
18939 =item CAVEAT
18940
18941 =item SEE ALSO
18942
18943 =item COPYRIGHT AND DISCLAIMERS
18944
18945 =item AUTHOR
18946
18947 =back
18948
18949 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18950
18951 =over 4
18952
18953 =item SYNOPSIS
18954
18955 =item DESCRIPTION
18956
18957 =item CAVEAT
18958
18959 =item SEE ALSO
18960
18961 =item COPYRIGHT AND DISCLAIMERS
18962
18963 =item AUTHOR
18964
18965 =back
18966
18967 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18968
18969 =over 4
18970
18971 =item SYNOPSIS
18972
18973 =item DESCRIPTION
18974
18975 =item SEE ALSO
18976
18977 =item COPYRIGHT AND DISCLAIMERS
18978
18979 =item AUTHOR
18980
18981 =back
18982
18983 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18984
18985 =over 4
18986
18987 =item SYNOPSIS
18988
18989 =item DESCRIPTION
18990
18991 =item SEE ALSO
18992
18993 =item COPYRIGHT AND DISCLAIMERS
18994
18995 =item AUTHOR
18996
18997 =back
18998
18999 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
19000
19001 =over 4
19002
19003 =item SYNOPSIS
19004
19005 =item DESCRIPTION
19006
19007 =item CAVEAT
19008
19009 =item SEE ALSO
19010
19011 =item COPYRIGHT AND DISCLAIMERS
19012
19013 =item AUTHOR
19014
19015 =back
19016
19017 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
19018
19019 =over 4
19020
19021 =item SYNOPSIS
19022
19023 =item DESCRIPTION
19024
19025 =item SEE ALSO
19026
19027 =item AUTHOR
19028
19029 =back
19030
19031 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
19032
19033 =over 4
19034
19035 =item SYNOPSIS
19036
19037 =item DESCRIPTION
19038
19039 =item SEE ALSO
19040
19041 =item COPYRIGHT AND DISCLAIMERS
19042
19043 =item AUTHOR
19044
19045 =back
19046
19047 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
19048
19049 =over 4
19050
19051 =item SYNOPSIS
19052
19053 =item DESCRIPTION
19054
19055 alt, indent, loose, sentence, width
19056
19057 =item DIAGNOSTICS
19058
19059 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
19060 Unknown sequence: %s, Unmatched =back
19061
19062 =item RESTRICTIONS
19063
19064 =item NOTES
19065
19066 =item SEE ALSO
19067
19068 =item AUTHOR
19069
19070 =back
19071
19072 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
19073
19074 =over 4
19075
19076 =item SYNOPSIS
19077
19078 =item DESCRIPTION
19079
19080 =over 4
19081
19082 =item EXPORT
19083
19084 =back
19085
19086 =item AUTHOR
19087
19088 =item SEE ALSO
19089
19090 =back
19091
19092 =head2 Pod::Select, podselect() - extract selected sections of POD from
19093 input
19094
19095 =over 4
19096
19097 =item SYNOPSIS
19098
19099 =item REQUIRES
19100
19101 =item EXPORTS
19102
19103 =item DESCRIPTION
19104
19105 =item SECTION SPECIFICATIONS
19106
19107 =item RANGE SPECIFICATIONS
19108
19109 =back
19110
19111 =over 4
19112
19113 =item OBJECT METHODS
19114
19115 =back
19116
19117 =over 4
19118
19119 =item B<curr_headings()>
19120
19121 =back
19122
19123 =over 4
19124
19125 =item B<select()>
19126
19127 =back
19128
19129 =over 4
19130
19131 =item B<add_selection()>
19132
19133 =back
19134
19135 =over 4
19136
19137 =item B<clear_selections()>
19138
19139 =back
19140
19141 =over 4
19142
19143 =item B<match_section()>
19144
19145 =back
19146
19147 =over 4
19148
19149 =item B<is_selected()>
19150
19151 =back
19152
19153 =over 4
19154
19155 =item EXPORTED FUNCTIONS
19156
19157 =back
19158
19159 =over 4
19160
19161 =item B<podselect()>
19162
19163 B<-output>, B<-sections>, B<-ranges>
19164
19165 =back
19166
19167 =over 4
19168
19169 =item PRIVATE METHODS AND DATA
19170
19171 =back
19172
19173 =over 4
19174
19175 =item B<_compile_section_spec()>
19176
19177 =back
19178
19179 =over 4
19180
19181 =item $self->{_SECTION_HEADINGS}
19182
19183 =back
19184
19185 =over 4
19186
19187 =item $self->{_SELECTED_SECTIONS}
19188
19189 =back
19190
19191 =over 4
19192
19193 =item SEE ALSO
19194
19195 =item AUTHOR
19196
19197 =back
19198
19199 =head2 Pod::Text - Convert POD data to formatted ASCII text
19200
19201 =over 4
19202
19203 =item SYNOPSIS
19204
19205 =item DESCRIPTION
19206
19207 alt, code, indent, loose, margin, quotes, sentence, width
19208
19209 =item DIAGNOSTICS
19210
19211 Bizarre space in item, Item called without tag, Can't open %s for reading:
19212 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19213 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19214 Unmatched =back
19215
19216 =item RESTRICTIONS
19217
19218 =item NOTES
19219
19220 =item SEE ALSO
19221
19222 =item AUTHOR
19223
19224 =item COPYRIGHT AND LICENSE
19225
19226 =back
19227
19228 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19229
19230 =over 4
19231
19232 =item SYNOPSIS
19233
19234 =item DESCRIPTION
19235
19236 =item BUGS
19237
19238 =item SEE ALSO
19239
19240 =item AUTHOR
19241
19242 =item COPYRIGHT AND LICENSE
19243
19244 =back
19245
19246 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19247 text
19248
19249 =over 4
19250
19251 =item SYNOPSIS
19252
19253 =item DESCRIPTION
19254
19255 =item BUGS
19256
19257 =item SEE ALSO
19258
19259 =item AUTHOR
19260
19261 =item COPYRIGHT AND LICENSE
19262
19263 =back
19264
19265 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19266 escapes
19267
19268 =over 4
19269
19270 =item SYNOPSIS
19271
19272 =item DESCRIPTION
19273
19274 =item NOTES
19275
19276 =item SEE ALSO
19277
19278 =item AUTHOR
19279
19280 =item COPYRIGHT AND LICENSE
19281
19282 =back
19283
19284 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19285 documentation
19286
19287 =over 4
19288
19289 =item SYNOPSIS
19290
19291 =item ARGUMENTS
19292
19293 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
19294 C<-pathlist>
19295
19296 =item DESCRIPTION
19297
19298 =item EXAMPLES
19299
19300 =over 4
19301
19302 =item Recommended Use
19303
19304 =back
19305
19306 =item CAVEATS
19307
19308 =item AUTHOR
19309
19310 =item ACKNOWLEDGEMENTS
19311
19312 =back
19313
19314 =head2 SDBM_File - Tied access to sdbm files
19315
19316 =over 4
19317
19318 =item SYNOPSIS
19319
19320 =item DESCRIPTION
19321
19322 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19323
19324 =item DIAGNOSTICS
19325
19326 =over 4
19327
19328 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19329
19330 =back
19331
19332 =item BUGS AND WARNINGS
19333
19334 =back
19335
19336 =head2 Safe - Compile and execute code in restricted compartments
19337
19338 =over 4
19339
19340 =item SYNOPSIS
19341
19342 =item DESCRIPTION
19343
19344 a new namespace, an operator mask
19345
19346 =item WARNING
19347
19348 =over 4
19349
19350 =item RECENT CHANGES
19351
19352 =item Methods in class Safe
19353
19354 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
19355 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
19356 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
19357 root (NAMESPACE), mask (MASK)
19358
19359 =item Some Safety Issues
19360
19361 Memory, CPU, Snooping, Signals, State Changes
19362
19363 =item AUTHOR
19364
19365 =back
19366
19367 =back
19368
19369 =head2 Scalar::Util - A selection of general-utility scalar subroutines
19370
19371 =over 4
19372
19373 =item SYNOPSIS
19374
19375 =item DESCRIPTION
19376
19377 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
19378 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
19379 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
19380
19381 =item KNOWN BUGS
19382
19383 =item COPYRIGHT
19384
19385 =item BLATANT PLUG
19386
19387 =back
19388
19389 =head2 Search::Dict, look - search for key in dictionary file
19390
19391 =over 4
19392
19393 =item SYNOPSIS
19394
19395 =item DESCRIPTION
19396
19397 =back
19398
19399 =head2 SelectSaver - save and restore selected file handle
19400
19401 =over 4
19402
19403 =item SYNOPSIS
19404
19405 =item DESCRIPTION
19406
19407 =back
19408
19409 =head2 SelfLoader - load functions only on demand
19410
19411 =over 4
19412
19413 =item SYNOPSIS
19414
19415 =item DESCRIPTION
19416
19417 =over 4
19418
19419 =item The __DATA__ token
19420
19421 =item SelfLoader autoloading
19422
19423 =item Autoloading and package lexicals
19424
19425 =item SelfLoader and AutoLoader
19426
19427 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
19428
19429 =item Classes and inherited methods.
19430
19431 =back
19432
19433 =item Multiple packages and fully qualified subroutine names
19434
19435 =back
19436
19437 =head2 Shell - run shell commands transparently within perl
19438
19439 =over 4
19440
19441 =item SYNOPSIS
19442
19443 =item DESCRIPTION
19444
19445 =over 4
19446
19447 =item Caveats
19448
19449 =item Escaping Magic Characters
19450
19451 =item Configuration
19452
19453 =back
19454
19455 =item BUGS
19456
19457 =item AUTHOR
19458
19459 =back
19460
19461 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19462 socket.h defines and structure manipulators 
19463
19464 =over 4
19465
19466 =item SYNOPSIS
19467
19468 =item DESCRIPTION
19469
19470 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19471 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19472 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19473 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19474 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19475
19476 =back
19477
19478 =head2 Storable - persistence for Perl data structures
19479
19480 =over 4
19481
19482 =item SYNOPSIS
19483
19484 =item DESCRIPTION
19485
19486 =item MEMORY STORE
19487
19488 =item ADVISORY LOCKING
19489
19490 =item SPEED
19491
19492 =item CANONICAL REPRESENTATION
19493
19494 =item CODE REFERENCES
19495
19496 =item FORWARD COMPATIBILITY
19497
19498 utf8 data, restricted hashes, files from future versions of Storable
19499
19500 =item ERROR REPORTING
19501
19502 =item WIZARDS ONLY
19503
19504 =over 4
19505
19506 =item Hooks
19507
19508 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19509 I<serialized>, ..
19510
19511 =item Predicates
19512
19513 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19514 C<Storable::is_retrieving>
19515
19516 =item Recursion
19517
19518 =item Deep Cloning
19519
19520 =back
19521
19522 =item Storable magic
19523
19524 =item EXAMPLES
19525
19526 =item WARNING
19527
19528 =item BUGS
19529
19530 =over 4
19531
19532 =item 64 bit data in perl 5.6.0 and 5.6.1
19533
19534 =back
19535
19536 =item CREDITS
19537
19538 =item AUTHOR
19539
19540 =item SEE ALSO
19541
19542 =back
19543
19544 =head2 Switch - A switch statement for Perl
19545
19546 =over 4
19547
19548 =item VERSION
19549
19550 =item SYNOPSIS
19551
19552 =item BACKGROUND
19553
19554 =item DESCRIPTION
19555
19556 =over 4
19557
19558 =item Allowing fall-through
19559
19560 =item Automating fall-through
19561
19562 =item Alternative syntax
19563
19564 =item Higher-order Operations
19565
19566 =back
19567
19568 =item DEPENDENCIES
19569
19570 =item AUTHOR
19571
19572 =item BUGS
19573
19574 =item LIMITATIONS
19575
19576 =item COPYRIGHT
19577
19578 =back
19579
19580 =head2 Symbol - manipulate Perl symbols and their names
19581
19582 =over 4
19583
19584 =item SYNOPSIS
19585
19586 =item DESCRIPTION
19587
19588 =item BUGS
19589
19590 =back
19591
19592 =head2 Sys::Hostname - Try every conceivable way to get hostname
19593
19594 =over 4
19595
19596 =item SYNOPSIS
19597
19598 =item DESCRIPTION
19599
19600 =item AUTHOR
19601
19602 =back
19603
19604 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19605 interface to the UNIX syslog(3) calls
19606
19607 =over 4
19608
19609 =item SYNOPSIS
19610
19611 =item DESCRIPTION
19612
19613 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19614 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19615 in 5.004_02), closelog
19616
19617 =item EXAMPLES
19618
19619 =item SEE ALSO
19620
19621 =item AUTHOR
19622
19623 =back
19624
19625 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19626 Perl interface to the UNIX syslog(3) calls
19627
19628 =over 4
19629
19630 =item SYNOPSIS
19631
19632 =item DESCRIPTION
19633
19634 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19635 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19636 in 5.004_02), closelog
19637
19638 =item EXAMPLES
19639
19640 =item SEE ALSO
19641
19642 =item AUTHOR
19643
19644 =back
19645
19646 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19647
19648 =over 4
19649
19650 =item SYNOPSIS
19651
19652 =item DESCRIPTION
19653
19654 =item DIAGNOSTICS
19655
19656 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19657 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19658 comma allowed after filehandle, No name for escape sequence %s
19659
19660 =item ENVIRONMENT
19661
19662 ANSI_COLORS_DISABLED
19663
19664 =item RESTRICTIONS
19665
19666 =item NOTES
19667
19668 =item SEE ALSO
19669
19670 =item AUTHORS
19671
19672 =item COPYRIGHT AND LICENSE
19673
19674 =back
19675
19676 =head2 Term::Cap - Perl termcap interface
19677
19678 =over 4
19679
19680 =item SYNOPSIS
19681
19682 =item DESCRIPTION
19683
19684 =over 4
19685
19686 =item METHODS
19687
19688 =back
19689
19690 =back
19691
19692 B<Tgetent>, OSPEED, TERM
19693
19694 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19695
19696 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19697
19698 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19699
19700 B<Trequire>
19701
19702 =over 4
19703
19704 =item EXAMPLES
19705
19706 =item COPYRIGHT AND LICENSE
19707
19708 =item AUTHOR
19709
19710 =item SEE ALSO
19711
19712 =back
19713
19714 =head2 Term::Complete - Perl word completion module
19715
19716 =over 4
19717
19718 =item SYNOPSIS
19719
19720 =item DESCRIPTION
19721
19722 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19723
19724 =item DIAGNOSTICS
19725
19726 =item BUGS
19727
19728 =item AUTHOR
19729
19730 =back
19731
19732 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19733 If no real package is found, substitutes stubs instead of basic functions.
19734
19735 =over 4
19736
19737 =item SYNOPSIS
19738
19739 =item DESCRIPTION
19740
19741 =item Minimal set of supported functions
19742
19743 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19744 C<findConsole>, Attribs, C<Features>
19745
19746 =item Additional supported functions
19747
19748 C<tkRunning>, C<ornaments>, C<newTTY>
19749
19750 =item EXPORTS
19751
19752 =item ENVIRONMENT
19753
19754 =item CAVEATS
19755
19756 =back
19757
19758 =head2 Test - provides a simple framework for writing test scripts
19759
19760 =over 4
19761
19762 =item SYNOPSIS
19763
19764 =item DESCRIPTION
19765
19766 =item QUICK START GUIDE
19767
19768 =over 4
19769
19770 =item Functions
19771
19772 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19773 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19774
19775 =back
19776
19777 =back
19778
19779 B<_to_value>
19780
19781 C<ok(...)>
19782
19783 C<skip(I<skip_if_true>, I<args...>)>
19784
19785 =over 4
19786
19787 =item TEST TYPES
19788
19789 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19790
19791 =item ONFAIL
19792
19793 =item BUGS and CAVEATS
19794
19795 =item ENVIRONMENT
19796
19797 =item NOTE
19798
19799 =item SEE ALSO
19800
19801 =item AUTHOR
19802
19803 =back
19804
19805 =head2 Test::Builder - Backend for building test libraries
19806
19807 =over 4
19808
19809 =item SYNOPSIS
19810
19811 =item DESCRIPTION
19812
19813 =over 4
19814
19815 =item Construction
19816
19817 B<new>
19818
19819 =back
19820
19821 =back
19822
19823 =over 4
19824
19825 =item Setting up tests
19826
19827 B<exported_to>
19828
19829 =back
19830
19831 B<plan>
19832
19833 B<expected_tests>
19834
19835 B<no_plan>
19836
19837 B<has_plan>
19838
19839 B<skip_all>
19840
19841 =over 4
19842
19843 =item Running tests
19844
19845 B<ok>
19846
19847 =back
19848
19849 B<is_eq>, B<is_num>
19850
19851 B<isnt_eq>, B<isnt_num>
19852
19853 B<like>, B<unlike>
19854
19855 B<maybe_regex>
19856
19857 B<cmp_ok>
19858
19859 B<BAILOUT>
19860
19861 B<skip>
19862
19863 B<todo_skip>
19864
19865 B<skip_rest>
19866
19867 =over 4
19868
19869 =item Test style
19870
19871 B<level>
19872
19873 =back
19874
19875 B<use_numbers>
19876
19877 B<no_header>, B<no_ending>
19878
19879 =over 4
19880
19881 =item Output
19882
19883 B<diag>
19884
19885 =back
19886
19887 B<_print>
19888
19889 B<output>, B<failure_output>, B<todo_output>
19890
19891 =over 4
19892
19893 =item Test Status and Info
19894
19895 B<current_test>
19896
19897 =back
19898
19899 B<summary>
19900
19901 B<details>
19902
19903 B<todo>
19904
19905 B<caller>
19906
19907 B<_sanity_check>
19908
19909 B<_whoa>
19910
19911 B<_my_exit>
19912
19913 =over 4
19914
19915 =item THREADS
19916
19917 =item EXAMPLES
19918
19919 =item SEE ALSO
19920
19921 =item AUTHORS
19922
19923 =item COPYRIGHT
19924
19925 =back
19926
19927 =head2 Test::Harness - Run Perl standard test scripts with statistics
19928
19929 =over 4
19930
19931 =item VERSION
19932
19933 =back
19934
19935 =over 4
19936
19937 =item SYNOPSIS
19938
19939 =item DESCRIPTION
19940
19941 =over 4
19942
19943 =item The test script output
19944
19945 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19946 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19947 else>
19948
19949 =item Taint mode
19950
19951 =item Configuration variables.
19952
19953 B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
19954
19955 =item Failure
19956
19957 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19958 Failed>
19959
19960 =item Functions
19961
19962 B<runtests>
19963
19964 =back
19965
19966 =back
19967
19968 B<_all_ok>
19969
19970 B<_globdir>
19971
19972 B<_run_all_tests>
19973
19974 B<_mk_leader>
19975
19976 B<_leader_width>
19977
19978 =over 4
19979
19980 =item EXPORT
19981
19982 =item DIAGNOSTICS
19983
19984 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19985 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19986 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19987 %s>, C<FAILED--Further testing stopped: %s>
19988
19989 =item ENVIRONMENT
19990
19991 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19992 C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
19993 C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>,
19994 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19995
19996 =item EXAMPLE
19997
19998 =item SEE ALSO
19999
20000 =item AUTHORS
20001
20002 =item LICENSE
20003
20004 =item TODO
20005
20006 =item BUGS
20007
20008 =item AUTHORS
20009
20010 =item COPYRIGHT
20011
20012 =back
20013
20014 =head2 Test::Harness::Assert - simple assert
20015
20016 =over 4
20017
20018 =item SYNOPSIS
20019
20020 =item DESCRIPTION
20021
20022 =item FUNCTIONS
20023
20024 =over 4
20025
20026 =item C<assert()>
20027
20028 =back
20029
20030 =back
20031
20032 =over 4
20033
20034 =item AUTHOR
20035
20036 =item SEE ALSO
20037
20038 =back
20039
20040 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
20041
20042 =over 4
20043
20044 =item SYNOPSIS
20045
20046 =item DESCRIPTION
20047
20048 =over 4
20049
20050 =item new()
20051
20052 =item next()
20053
20054 =back
20055
20056 =back
20057
20058 =head2 Test::Harness::Straps - detailed analysis of test results
20059
20060 =over 4
20061
20062 =item SYNOPSIS
20063
20064 =item DESCRIPTION
20065
20066 =item Construction
20067
20068 =over 4
20069
20070 =item C<new>
20071
20072 =back
20073
20074 =back
20075
20076 =over 4
20077
20078 =item C<_init>
20079
20080 =back
20081
20082 =over 4
20083
20084 =item Analysis
20085
20086 =over 4
20087
20088 =item C<analyze>
20089
20090 =back
20091
20092 =back
20093
20094 =over 4
20095
20096 =item C<analyze_fh>
20097
20098 =back
20099
20100 =over 4
20101
20102 =item C<analyze_file>
20103
20104 =back
20105
20106 =over 4
20107
20108 =item C<_command_line( $file )>
20109
20110 =back
20111
20112 =over 4
20113
20114 =item C<_command>
20115
20116 =back
20117
20118 =over 4
20119
20120 =item C<_switches>
20121
20122 =back
20123
20124 =over 4
20125
20126 =item C<_cleaned_switches>
20127
20128 =back
20129
20130 =over 4
20131
20132 =item C<_INC2PERL5LIB>
20133
20134 =back
20135
20136 =over 4
20137
20138 =item C<_filtered_INC>
20139
20140 =back
20141
20142 =over 4
20143
20144 =item C<_restore_PERL5LIB>
20145
20146 =back
20147
20148 =over 4
20149
20150 =item Parsing
20151
20152 =over 4
20153
20154 =item C<_is_comment>
20155
20156 =back
20157
20158 =back
20159
20160 =over 4
20161
20162 =item C<_is_header>
20163
20164 =back
20165
20166 =over 4
20167
20168 =item C<_is_test>
20169
20170 =back
20171
20172 =over 4
20173
20174 =item C<_is_bail_out>
20175
20176 =back
20177
20178 =over 4
20179
20180 =item C<_reset_file_state>
20181
20182 =back
20183
20184 =over 4
20185
20186 =item Results
20187
20188 =over 4
20189
20190 =item C<_detailize>
20191
20192 =back
20193
20194 =back
20195
20196 =over 4
20197
20198 =item EXAMPLES
20199
20200 =item AUTHOR
20201
20202 =item SEE ALSO
20203
20204 =back
20205
20206 =head2 Test::More - yet another framework for writing test scripts
20207
20208 =over 4
20209
20210 =item SYNOPSIS
20211
20212 =item DESCRIPTION
20213
20214 =over 4
20215
20216 =item I love it when a plan comes together
20217
20218 =back
20219
20220 =back
20221
20222 =over 4
20223
20224 =item Test names
20225
20226 =item I'm ok, you're not ok.
20227
20228 B<ok>
20229
20230 =back
20231
20232 B<is>, B<isnt>
20233
20234 B<like>
20235
20236 B<unlike>
20237
20238 B<cmp_ok>
20239
20240 B<can_ok>
20241
20242 B<isa_ok>
20243
20244 B<pass>, B<fail>
20245
20246 =over 4
20247
20248 =item Diagnostics
20249
20250 B<diag>
20251
20252 =back
20253
20254 =over 4
20255
20256 =item Module tests
20257
20258 B<use_ok>
20259
20260 =back
20261
20262 B<require_ok>
20263
20264 =over 4
20265
20266 =item Conditional tests
20267
20268 B<SKIP: BLOCK>
20269
20270 =back
20271
20272 B<TODO: BLOCK>, B<todo_skip>
20273
20274 When do I use SKIP vs. TODO?
20275
20276 =over 4
20277
20278 =item Comparison functions
20279
20280 B<is_deeply>
20281
20282 =back
20283
20284 B<eq_array>
20285
20286 B<eq_hash>
20287
20288 B<eq_set>
20289
20290 =over 4
20291
20292 =item Extending and Embedding Test::More
20293
20294 B<builder>
20295
20296 =back
20297
20298 =over 4
20299
20300 =item NOTES
20301
20302 =item BUGS and CAVEATS
20303
20304 Making your own ok(), The eq_* family has some caveats, Test::Harness
20305 upgrades
20306
20307 =item HISTORY
20308
20309 =item SEE ALSO
20310
20311 =item AUTHORS
20312
20313 =item COPYRIGHT
20314
20315 =back
20316
20317 =head2 Test::Simple - Basic utilities for writing tests.
20318
20319 =over 4
20320
20321 =item SYNOPSIS
20322
20323 =item DESCRIPTION
20324
20325 B<ok>
20326
20327 =back
20328
20329 =over 4
20330
20331 =item EXAMPLE
20332
20333 =item CAVEATS
20334
20335 =item NOTES
20336
20337 =item HISTORY
20338
20339 =item SEE ALSO
20340
20341 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
20342 L<Test::Harness>
20343
20344 =item AUTHORS
20345
20346 =item COPYRIGHT
20347
20348 =back
20349
20350 =head2 Test::Tutorial - A tutorial about writing really basic tests
20351
20352 =over 4
20353
20354 =item DESCRIPTION
20355
20356 =over 4
20357
20358 =item Nuts and bolts of testing.
20359
20360 =item Where to start?
20361
20362 =item Names
20363
20364 =item Test the manual
20365
20366 =item Sometimes the tests are wrong
20367
20368 =item Testing lots of values
20369
20370 =item Informative names
20371
20372 =item Skipping tests
20373
20374 =item Todo tests
20375
20376 =item Testing with taint mode.
20377
20378 =back
20379
20380 =item FOOTNOTES
20381
20382 =item AUTHORS
20383
20384 =item COPYRIGHT
20385
20386 =back
20387
20388 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
20389
20390 =over 4
20391
20392 =item SYNOPSIS
20393
20394 =item DESCRIPTION
20395
20396 =item EXAMPLE
20397
20398 =back
20399
20400 =head2 Text::Balanced - Extract delimited text sequences from strings.
20401
20402 =over 4
20403
20404 =item SYNOPSIS
20405
20406 =item DESCRIPTION
20407
20408 =over 4
20409
20410 =item General behaviour in list contexts
20411
20412 [0], [1], [2]
20413
20414 =item General behaviour in scalar and void contexts
20415
20416 =item A note about prefixes
20417
20418 =item C<extract_delimited>
20419
20420 =item C<extract_bracketed>
20421
20422 =item C<extract_variable>
20423
20424 [0], [1], [2]
20425
20426 =item C<extract_tagged>
20427
20428 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
20429 [0], [1], [2], [3], [4], [5]
20430
20431 =item C<gen_extract_tagged>
20432
20433 =item C<extract_quotelike>
20434
20435 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
20436
20437 =item C<extract_quotelike> and "here documents"
20438
20439 [0], [1], [2], [3], [4], [5], [6], [7..10]
20440
20441 =item C<extract_codeblock>
20442
20443 =item C<extract_multiple>
20444
20445 =item C<gen_delimited_pat>
20446
20447 =back
20448
20449 =item DIAGNOSTICS
20450
20451  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
20452 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
20453 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
20454 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
20455 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
20456 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
20457 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
20458 after dereferencer>, C<Did not find expected opening bracket at %s>,
20459 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
20460 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
20461 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
20462 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
20463 tag>
20464
20465 =item AUTHOR
20466
20467 =item BUGS AND IRRITATIONS
20468
20469 =item COPYRIGHT
20470
20471 =back
20472
20473 =head2 Text::ParseWords - parse text into an array of tokens or array of
20474 arrays
20475
20476 =over 4
20477
20478 =item SYNOPSIS
20479
20480 =item DESCRIPTION
20481
20482 =item EXAMPLES
20483
20484 =item AUTHORS
20485
20486 =back
20487
20488 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20489 by Knuth
20490
20491 =over 4
20492
20493 =item SYNOPSIS
20494
20495 =item DESCRIPTION
20496
20497 =item EXAMPLES
20498
20499 =item LIMITATIONS
20500
20501 =item AUTHOR
20502
20503 =back
20504
20505 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20506 unexpand(1)
20507
20508 =over 4
20509
20510 =item SYNOPSIS
20511
20512 =item DESCRIPTION
20513
20514 =item BUGS
20515
20516 =item AUTHOR
20517
20518 =back
20519
20520 =head2 Text::Wrap - line wrapping to form simple paragraphs
20521
20522 =over 4
20523
20524 =item SYNOPSIS 
20525
20526 =item DESCRIPTION
20527
20528 =item OVERRIDES
20529
20530 =item EXAMPLE
20531
20532 =item AUTHOR
20533
20534 =back
20535
20536 =head2 Thread - manipulate threads in Perl (for old code only)
20537
20538 =over 4
20539
20540 =item CAVEAT
20541
20542 =item SYNOPSIS
20543
20544 =item DESCRIPTION
20545
20546 =item FUNCTIONS
20547
20548 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20549 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20550 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20551
20552 =item METHODS
20553
20554 join, eval, detach, equal, tid, flags, done
20555
20556 =item LIMITATIONS
20557
20558 =item SEE ALSO
20559
20560 =back
20561
20562 =head2 Thread::Queue - thread-safe queues
20563
20564 =over 4
20565
20566 =item SYNOPSIS
20567
20568 =item DESCRIPTION
20569
20570 =item FUNCTIONS AND METHODS
20571
20572 new, enqueue LIST, dequeue, dequeue_nb, pending
20573
20574 =item SEE ALSO
20575
20576 =back
20577
20578 =head2 Thread::Semaphore - thread-safe semaphores
20579
20580 =over 4
20581
20582 =item SYNOPSIS
20583
20584 =item DESCRIPTION
20585
20586 =item FUNCTIONS AND METHODS
20587
20588 new, new NUMBER, down, down NUMBER, up, up NUMBER
20589
20590 =back
20591
20592 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20593 (for old code)
20594
20595 =over 4
20596
20597 =item CAVEAT
20598
20599 =item SYNOPSIS
20600
20601 =item DESCRIPTION
20602
20603 =item BUGS
20604
20605 =back
20606
20607 =head2 Thread::Specific - thread-specific keys
20608
20609 =over 4
20610
20611 =item SYNOPSIS
20612
20613 =item DESCRIPTION
20614
20615 =back
20616
20617 =head2 Tie::Array - base class for tied arrays
20618
20619 =over 4
20620
20621 =item SYNOPSIS
20622
20623 =item DESCRIPTION
20624
20625 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20626 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20627 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20628 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20629
20630 =item CAVEATS
20631
20632 =item AUTHOR
20633
20634 =back
20635
20636 =head2 Tie::File - Access the lines of a disk file via a Perl array
20637
20638 =over 4
20639
20640 =item SYNOPSIS
20641
20642 =item DESCRIPTION
20643
20644 =over 4
20645
20646 =item C<recsep>
20647
20648 =item C<autochomp>
20649
20650 =item C<mode>
20651
20652 =item C<memory>
20653
20654 =item C<dw_size>
20655
20656 =item Option Format
20657
20658 =back
20659
20660 =item Public Methods
20661
20662 =over 4
20663
20664 =item C<flock>
20665
20666 =item C<autochomp>
20667
20668 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20669
20670 =item C<offset>
20671
20672 =back
20673
20674 =item Tying to an already-opened filehandle
20675
20676 =item Deferred Writing
20677
20678 =over 4
20679
20680 =item Autodeferring
20681
20682 =back
20683
20684 =item CONCURRENT ACCESS TO FILES
20685
20686 =item CAVEATS
20687
20688 =item SUBCLASSING
20689
20690 =item WHAT ABOUT C<DB_File>?
20691
20692 =item AUTHOR
20693
20694 =item LICENSE
20695
20696 =item WARRANTY
20697
20698 =item THANKS
20699
20700 =item TODO
20701
20702 =back
20703
20704 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20705 handles
20706
20707 =over 4
20708
20709 =item SYNOPSIS
20710
20711 =item DESCRIPTION
20712
20713 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20714 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20715 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20716 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20717
20718 =item MORE INFORMATION
20719
20720 =item COMPATIBILITY
20721
20722 =back
20723
20724 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20725 tied hashes
20726
20727 =over 4
20728
20729 =item SYNOPSIS
20730
20731 =item DESCRIPTION
20732
20733 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20734 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
20735 this, SCALAR this
20736
20737 =item Inheriting from B<Tie::StdHash>
20738
20739 =item Inheriting from B<Tie::ExtraHash>
20740
20741 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
20742
20743 =item MORE INFORMATION
20744
20745 =back
20746
20747 =head2 Tie::Memoize - add data to hash when needed
20748
20749 =over 4
20750
20751 =item SYNOPSIS
20752
20753 =item DESCRIPTION
20754
20755 =item Inheriting from B<Tie::Memoize>
20756
20757 =item EXAMPLE
20758
20759 =item BUGS
20760
20761 =item AUTHOR
20762
20763 =back
20764
20765 =head2 Tie::RefHash - use references as hash keys
20766
20767 =over 4
20768
20769 =item SYNOPSIS
20770
20771 =item DESCRIPTION
20772
20773 =item EXAMPLE
20774
20775 =item AUTHOR
20776
20777 =item VERSION
20778
20779 =item SEE ALSO
20780
20781 =back
20782
20783 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20784 scalars
20785
20786 =over 4
20787
20788 =item SYNOPSIS
20789
20790 =item DESCRIPTION
20791
20792 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20793
20794 =item MORE INFORMATION
20795
20796 =back
20797
20798 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20799
20800 =over 4
20801
20802 =item SYNOPSIS
20803
20804 =item DESCRIPTION
20805
20806 =item CAVEATS
20807
20808 =back
20809
20810 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20811 timers
20812
20813 =over 4
20814
20815 =item SYNOPSIS
20816
20817 =item DESCRIPTION
20818
20819 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20820 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20821 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
20822 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
20823 $which )
20824
20825 =item EXAMPLES
20826
20827 =item C API
20828
20829 =item DIAGNOSTICS
20830
20831 =over 4
20832
20833 =item negative time not invented yet
20834
20835 =item internal error: useconds < 0 (unsigned ... signed ...)
20836
20837 =back
20838
20839 =item CAVEATS
20840
20841 =item AUTHORS
20842
20843 =item COPYRIGHT AND LICENSE
20844
20845 =back
20846
20847 =head2 Time::Local - efficiently compute time from local and GMT time
20848
20849 =over 4
20850
20851 =item SYNOPSIS
20852
20853 =item DESCRIPTION
20854
20855 =over 4
20856
20857 =item Ambiguous Local Times (DST)
20858
20859 =item Non-Existent Local Times (DST)
20860
20861 =item Negative Epoch Values
20862
20863 =back
20864
20865 =item IMPLEMENTATION
20866
20867 =item BUGS
20868
20869 =item SUPPORT
20870
20871 =item AUTHOR
20872
20873 =back
20874
20875 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20876 function
20877
20878 =over 4
20879
20880 =item SYNOPSIS
20881
20882 =item DESCRIPTION
20883
20884 =item NOTE
20885
20886 =item AUTHOR
20887
20888 =back
20889
20890 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20891 function
20892
20893 =over 4
20894
20895 =item SYNOPSIS
20896
20897 =item DESCRIPTION
20898
20899 =item NOTE
20900
20901 =item AUTHOR
20902
20903 =back
20904
20905 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20906
20907 =over 4
20908
20909 =item SYNOPSIS
20910
20911 =item DESCRIPTION
20912
20913 =item AUTHOR
20914
20915 =back
20916
20917 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20918
20919 =over 4
20920
20921 =item SYNOPSIS
20922
20923 =item DESCRIPTION
20924
20925 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20926 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20927 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20928
20929 =item EXPORTS
20930
20931 =back
20932
20933 =head2 Unicode::Collate - Unicode Collation Algorithm
20934
20935 =over 4
20936
20937 =item SYNOPSIS
20938
20939 =item DESCRIPTION
20940
20941 =over 4
20942
20943 =item Constructor and Tailoring
20944
20945 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
20946 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
20947 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
20948 variable, alternate
20949
20950 =item Methods for Collation
20951
20952 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20953 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20954 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20955 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20956 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20957 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20958 $Collator-E<gt>viewSortKey($string)>
20959
20960 =item Methods for Searching
20961
20962 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20963 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20964 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20965 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20966 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20967 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20968 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20969
20970 =item Other Methods
20971
20972 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
20973 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
20974
20975 =item EXPORT
20976
20977 =item CAVEAT
20978
20979 =item Conformance Test
20980
20981 =back
20982
20983 =item AUTHOR
20984
20985 =item SEE ALSO
20986
20987 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
20988 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
20989 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
20990
20991 =back
20992
20993 =head2 Unicode::Normalize - Unicode Normalization Forms
20994
20995 =over 4
20996
20997 =item SYNOPSIS
20998
20999 =item DESCRIPTION
21000
21001 =over 4
21002
21003 =item Normalization Forms
21004
21005 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
21006 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
21007 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
21008 C<$normalized_string = normalize($form_name, $string)>
21009
21010 =item Decomposition and Composition
21011
21012 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
21013 decompose($string, $useCompatMapping)>, C<$reordered_string  =
21014 reorder($string)>, C<$composed_string   = compose($string)>
21015
21016 =item Quick Check
21017
21018 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
21019 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
21020 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
21021 check($form_name, $string)>
21022
21023 =item Character Data
21024
21025 C<$canonical_decomposed = getCanon($codepoint)>,
21026 C<$compatibility_decomposed = getCompat($codepoint)>,
21027 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
21028 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
21029 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
21030 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
21031 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
21032
21033 =item EXPORT
21034
21035 =back
21036
21037 =item AUTHOR
21038
21039 =item SEE ALSO
21040
21041 http://www.unicode.org/reports/tr15/,
21042 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
21043 http://www.unicode.org/notes/tn5/
21044
21045 =back
21046
21047 =head2 Unicode::UCD - Unicode character database
21048
21049 =over 4
21050
21051 =item SYNOPSIS
21052
21053 =item DESCRIPTION
21054
21055 =back
21056
21057 =over 4
21058
21059 =item charinfo
21060
21061 =back
21062
21063 =over 4
21064
21065 =item charblock
21066
21067 =back
21068
21069 =over 4
21070
21071 =item charscript
21072
21073 =back
21074
21075 =over 4
21076
21077 =item charblocks
21078
21079 =back
21080
21081 =over 4
21082
21083 =item charscripts
21084
21085 =back
21086
21087 =over 4
21088
21089 =item Blocks versus Scripts
21090
21091 =item Matching Scripts and Blocks
21092
21093 =item Code Point Arguments
21094
21095 =item charinrange
21096
21097 =back
21098
21099 =over 4
21100
21101 =item compexcl
21102
21103 =back
21104
21105 =over 4
21106
21107 =item casefold
21108
21109 =back
21110
21111 =over 4
21112
21113 =item casespec
21114
21115 =back
21116
21117 =over 4
21118
21119 =item Unicode::UCD::UnicodeVersion
21120
21121 =back
21122
21123 =over 4
21124
21125 =item Implementation Note
21126
21127 =back
21128
21129 =over 4
21130
21131 =item BUGS
21132
21133 =item AUTHOR
21134
21135 =back
21136
21137 =head2 User::grent - by-name interface to Perl's built-in getgr*()
21138 functions
21139
21140 =over 4
21141
21142 =item SYNOPSIS
21143
21144 =item DESCRIPTION
21145
21146 =item NOTE
21147
21148 =item AUTHOR
21149
21150 =back
21151
21152 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
21153 functions
21154
21155 =over 4
21156
21157 =item SYNOPSIS
21158
21159 =item DESCRIPTION
21160
21161 =over 4
21162
21163 =item System Specifics
21164
21165 =back
21166
21167 =item NOTE
21168
21169 =item AUTHOR
21170
21171 =item HISTORY
21172
21173 March 18th, 2000
21174
21175 =back
21176
21177 =head2 XSLoader - Dynamically load C libraries into Perl code
21178
21179 =over 4
21180
21181 =item SYNOPSIS
21182
21183 =item DESCRIPTION
21184
21185 =over 4
21186
21187 =item Migration from C<DynaLoader>
21188
21189 =item Backward compatible boilerplate
21190
21191 =back
21192
21193 =item Order of initialization: early load()
21194
21195 =over 4
21196
21197 =item The most hairy case
21198
21199 =back
21200
21201 =item LIMITATIONS
21202
21203 =item AUTHOR
21204
21205 =back
21206
21207 =head1 AUXILIARY DOCUMENTATION
21208
21209 Here should be listed all the extra programs' documentation, but they
21210 don't all have manual pages yet:
21211
21212 =over 4
21213
21214 =item a2p
21215
21216 =item c2ph
21217
21218 =item dprofpp
21219
21220 =item h2ph
21221
21222 =item h2xs
21223
21224 =item perlbug
21225
21226 =item perldoc
21227
21228 =item pl2pm
21229
21230 =item pod2html
21231
21232 =item pod2man
21233
21234 =item s2p
21235
21236 =item splain
21237
21238 =item xsubpp
21239
21240 =back
21241
21242 =head1 AUTHOR
21243
21244 Larry Wall <F<larry@wall.org>>, with the help of oodles
21245 of other folks.
21246