8b0a972acfd8ad4b20b96ee6f9490312d3e7d2c7
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
1
2 =head1 NAME
3
4 perltoc - perl documentation table of contents
5
6 =head1 DESCRIPTION
7
8 This page provides a brief table of contents for the rest of the Perl
9 documentation set.  It is meant to be scanned quickly or grepped
10 through to locate the proper section you're looking for.
11
12 =head1 BASIC DOCUMENTATION
13
14 =head2 perl - Practical Extraction and Report Language
15
16 =over 4
17
18 =item SYNOPSIS
19
20 =over 4
21
22 =item Overview
23
24 =item Tutorials
25
26 =item Reference Manual
27
28 =item Internals and C Language Interface
29
30 =item Miscellaneous
31
32 =item Language-Specific
33
34 =item Platform-Specific
35
36 =back
37
38 =item DESCRIPTION
39
40 =item AVAILABILITY
41
42 =item ENVIRONMENT
43
44 =item AUTHOR
45
46 =item FILES
47
48 =item SEE ALSO
49
50 =item DIAGNOSTICS
51
52 =item BUGS
53
54 =item NOTES
55
56 =back
57
58 =head2 perlintro -- a brief introduction and overview of Perl
59
60 =over 4
61
62 =item DESCRIPTION
63
64 =over 4
65
66 =item What is Perl?
67
68 =item Running Perl programs
69
70 =item Basic syntax overview
71
72 =item Perl variable types
73
74 Scalars, Arrays, Hashes
75
76 =item Variable scoping
77
78 =item Conditional and looping constructs
79
80 if, while, for, foreach
81
82 =item Builtin operators and functions
83
84 Arithmetic, Numeric comparison, String comparison, Boolean logic,
85 Miscellaneous
86
87 =item Files and I/O
88
89 =item Regular expressions
90
91 Simple matching, Simple substitution, More complex regular expressions,
92 Parentheses for capturing, Other regexp features
93
94 =item Writing subroutines
95
96 =item OO Perl
97
98 =item Using Perl modules
99
100 =back
101
102 =item AUTHOR
103
104 =back
105
106 =head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11
107 21:32:23 $)
108
109 =over 4
110
111 =item DESCRIPTION
112
113 =over 4
114
115 =item perlfaq: Structural overview of the FAQ.
116
117 =item L<perlfaq1>: General Questions About Perl
118
119 =item L<perlfaq2>: Obtaining and Learning about Perl
120
121 =item L<perlfaq3>: Programming Tools
122
123 =item L<perlfaq4>: Data Manipulation
124
125 =item L<perlfaq5>: Files and Formats
126
127 =item L<perlfaq6>: Regular Expressions
128
129 =item L<perlfaq7>: General Perl Language Issues
130
131 =item L<perlfaq8>: System Interaction
132
133 =item L<perlfaq9>: Networking
134
135 =back
136
137 =item About the perlfaq documents
138
139 =over 4
140
141 =item Where to get the perlfaq
142
143 =item How to contribute to the perlfaq
144
145 =item What will happen if you mail your Perl programming problems to the
146 authors
147
148 =back
149
150 =item Credits
151
152 =item Author and Copyright Information
153
154 =over 4
155
156 =item Bundled Distributions
157
158 =item Disclaimer
159
160 =back
161
162 =item Changes
163
164 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98,
165 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
166 Initial Release: 11/March/97
167
168 =back
169
170 =head2 perlbook - Perl book information
171
172 =over 4
173
174 =item DESCRIPTION
175
176 =back
177
178 =head2 perlsyn - Perl syntax
179
180 =over 4
181
182 =item DESCRIPTION
183
184 =over 4
185
186 =item Declarations
187
188 =item Simple statements
189
190 =item Compound statements
191
192 =item Loop Control
193
194 =item For Loops
195
196 =item Foreach Loops
197
198 =item Basic BLOCKs and Switch Statements
199
200 =item Goto
201
202 =item PODs: Embedded Documentation
203
204 =item Plain Old Comments (Not!)
205
206 =back
207
208 =back
209
210 =head2 perldata - Perl data types
211
212 =over 4
213
214 =item DESCRIPTION
215
216 =over 4
217
218 =item Variable names
219
220 =item Context
221
222 =item Scalar values
223
224 =item Scalar value constructors
225
226 =item List value constructors
227
228 =item Slices
229
230 =item Typeglobs and Filehandles
231
232 =back
233
234 =item SEE ALSO
235
236 =back
237
238 =head2 perlop - Perl operators and precedence
239
240 =over 4
241
242 =item SYNOPSIS
243
244 =item DESCRIPTION
245
246 =over 4
247
248 =item Terms and List Operators (Leftward)
249
250 =item The Arrow Operator
251
252 =item Auto-increment and Auto-decrement
253
254 =item Exponentiation
255
256 =item Symbolic Unary Operators
257
258 =item Binding Operators
259
260 =item Multiplicative Operators
261
262 =item Additive Operators
263
264 =item Shift Operators
265
266 =item Named Unary Operators
267
268 =item Relational Operators
269
270 =item Equality Operators
271
272 =item Bitwise And
273
274 =item Bitwise Or and Exclusive Or
275
276 =item C-style Logical And
277
278 =item C-style Logical Or
279
280 =item Range Operators
281
282 =item Conditional Operator
283
284 =item Assignment Operators
285
286 =item Comma Operator
287
288 =item List Operators (Rightward)
289
290 =item Logical Not
291
292 =item Logical And
293
294 =item Logical or and Exclusive Or
295
296 =item C Operators Missing From Perl
297
298 unary &, unary *, (TYPE)
299
300 =item Quote and Quote-like Operators
301
302 =item Regexp Quote-Like Operators
303
304 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
305 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
306 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
307 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
308
309 =item Gory details of parsing quoted constructs
310
311 Finding the end, Removal of backslashes before delimiters, Interpolation,
312 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
313 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
314 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
315 regular expressions
316
317 =item I/O Operators
318
319 =item Constant Folding
320
321 =item Bitwise String Operators
322
323 =item Integer Arithmetic
324
325 =item Floating-point Arithmetic
326
327 =item Bigger Numbers
328
329 =back
330
331 =back
332
333 =head2 perlsub - Perl subroutines
334
335 =over 4
336
337 =item SYNOPSIS
338
339 =item DESCRIPTION
340
341 =over 4
342
343 =item Private Variables via my()
344
345 =item Persistent Private Variables
346
347 =item Temporary Values via local()
348
349 =item Lvalue subroutines
350
351 Lvalue subroutines are EXPERIMENTAL
352
353 =item Passing Symbol Table Entries (typeglobs)
354
355 =item When to Still Use local()
356
357 =item Pass by Reference
358
359 =item Prototypes
360
361 =item Constant Functions
362
363 =item Overriding Built-in Functions
364
365 =item Autoloading
366
367 =item Subroutine Attributes
368
369 =back
370
371 =item SEE ALSO
372
373 =back
374
375 =head2 perlfunc - Perl builtin functions
376
377 =over 4
378
379 =item DESCRIPTION
380
381 =over 4
382
383 =item Perl Functions by Category
384
385 Functions for SCALARs or strings, Regular expressions and pattern matching,
386 Numeric functions, Functions for real @ARRAYs, Functions for list data,
387 Functions for real %HASHes, Input and output functions, Functions for fixed
388 length data or records, Functions for filehandles, files, or directories,
389 Keywords related to the control flow of your perl program, Keywords related
390 to scoping, Miscellaneous functions, Functions for processes and process
391 groups, Keywords related to perl modules, Keywords related to classes and
392 object-orientedness, Low-level socket functions, System V interprocess
393 communication functions, Fetching user and group info, Fetching network
394 info, Time-related functions, Functions new in perl5, Functions obsoleted
395 in perl5
396
397 =item Portability
398
399 =item Alphabetical Listing of Perl Functions
400
401 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
402 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
403 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
404 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
405 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
406 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
407 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
408 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
409 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
410 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
411 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
412 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
413 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
414 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
415 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
416 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
417 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
418 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
419 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
420 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
421 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
422 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
423 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
424 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
425 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
426 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
427 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
428 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
429 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
430 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
431 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
432 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
433 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
434 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
435 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
436 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
437 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
438 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
439 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
440 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
441 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
442 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
443 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
444 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
445 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
446 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
447 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
448 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
449 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
450 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
451 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
452 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
453 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
454 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
455 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
456 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
457 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
458 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
459 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
460 study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub
461 NAME (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr
462 EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall
463 LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen
464 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET,
465 sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE,
466 system LIST, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET,
467 syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell
468 FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied
469 VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate
470 EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef
471 EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE,
472 unshift ARRAY,LIST, use Module VERSION LIST, use Module VERSION, use Module
473 LIST, use Module, use VERSION, utime LIST, values HASH, vec
474 EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write
475 FILEHANDLE, write EXPR, write, y///
476
477 =back
478
479 =back
480
481 =head2 perlreftut - Mark's very short tutorial about references
482
483 =over 4
484
485 =item DESCRIPTION
486
487 =item Who Needs Complicated Data Structures?
488
489 =item The Solution
490
491 =item Syntax
492
493 =over 4
494
495 =item Making References
496
497 =item Using References
498
499 =back
500
501 =item An Example
502
503 =item Arrow Rule
504
505 =item Solution
506
507 =item The Rest
508
509 =item Summary
510
511 =item Credits
512
513 =over 4
514
515 =item Distribution Conditions
516
517 =back
518
519 =back
520
521 =head2 perldsc - Perl Data Structures Cookbook
522
523 =over 4
524
525 =item DESCRIPTION
526
527 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
528 more elaborate constructs
529
530 =item REFERENCES
531
532 =item COMMON MISTAKES
533
534 =item CAVEAT ON PRECEDENCE
535
536 =item WHY YOU SHOULD ALWAYS C<use strict>
537
538 =item DEBUGGING
539
540 =item CODE EXAMPLES
541
542 =item ARRAYS OF ARRAYS
543
544 =over 4
545
546 =item Declaration of an ARRAY OF ARRAYS
547
548 =item Generation of an ARRAY OF ARRAYS
549
550 =item Access and Printing of an ARRAY OF ARRAYS
551
552 =back
553
554 =item HASHES OF ARRAYS
555
556 =over 4
557
558 =item Declaration of a HASH OF ARRAYS
559
560 =item Generation of a HASH OF ARRAYS
561
562 =item Access and Printing of a HASH OF ARRAYS
563
564 =back
565
566 =item ARRAYS OF HASHES
567
568 =over 4
569
570 =item Declaration of an ARRAY OF HASHES
571
572 =item Generation of an ARRAY OF HASHES
573
574 =item Access and Printing of an ARRAY OF HASHES
575
576 =back
577
578 =item HASHES OF HASHES
579
580 =over 4
581
582 =item Declaration of a HASH OF HASHES
583
584 =item Generation of a HASH OF HASHES
585
586 =item Access and Printing of a HASH OF HASHES
587
588 =back
589
590 =item MORE ELABORATE RECORDS
591
592 =over 4
593
594 =item Declaration of MORE ELABORATE RECORDS
595
596 =item Declaration of a HASH OF COMPLEX RECORDS
597
598 =item Generation of a HASH OF COMPLEX RECORDS
599
600 =back
601
602 =item Database Ties
603
604 =item SEE ALSO
605
606 =item AUTHOR
607
608 =back
609
610 =head2 perlrequick - Perl regular expressions quick start
611
612 =over 4
613
614 =item DESCRIPTION
615
616 =item The Guide
617
618 =over 4
619
620 =item Simple word matching
621
622 =item Using character classes
623
624 =item Matching this or that
625
626 =item Grouping things and hierarchical matching
627
628 =item Extracting matches
629
630 =item Matching repetitions
631
632 =item More matching
633
634 =item Search and replace
635
636 =item The split operator
637
638 =back
639
640 =item BUGS
641
642 =item SEE ALSO
643
644 =item AUTHOR AND COPYRIGHT
645
646 =over 4
647
648 =item Acknowledgments
649
650 =back
651
652 =back
653
654 =head2 perlpod - the Plain Old Documentation format
655
656 =over 4
657
658 =item DESCRIPTION
659
660 =over 4
661
662 =item Ordinary Paragraph
663
664 =item Verbatim Paragraph
665
666 =item Command Paragraph
667
668 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
669 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
670 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
671 I<formatname>>, C<=for I<formatname> I<text...>>
672
673 =item Formatting Codes
674
675 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
676 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
677 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
678 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
679 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
680 (zero-effect) formatting code
681
682 =item The Intent
683
684 =item Embedding Pods in Perl Modules
685
686 =item Hints for Writing Pod
687
688 =back
689
690 =item SEE ALSO
691
692 =item AUTHOR
693
694 =back
695
696 =head2 perlpodspec - Plain Old Documentation: format specification and
697 notes
698
699 =over 4
700
701 =item DESCRIPTION
702
703 =item Pod Definitions
704
705 =item Pod Commands
706
707 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
708 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
709
710 =item Pod Formatting Codes
711
712 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
713 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
714 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
715 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
716 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
717 contains non-breaking spaces
718
719 =item Notes on Implementing Pod Processors
720
721 =item About LE<lt>...E<gt> Codes
722
723 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
724
725 =item About =over...=back Regions
726
727 =item About Data Paragraphs and "=begin/=end" Regions
728
729 =item SEE ALSO
730
731 =item AUTHOR
732
733 =back
734
735 =head2 perlstyle - Perl style guide
736
737 =over 4
738
739 =item DESCRIPTION
740
741 =back
742
743 =head2 perltrap - Perl traps for the unwary
744
745 =over 4
746
747 =item DESCRIPTION
748
749 =over 4
750
751 =item Awk Traps
752
753 =item C Traps
754
755 =item Sed Traps
756
757 =item Shell Traps
758
759 =item Perl Traps
760
761 =item Perl4 to Perl5 Traps
762
763 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
764 Traps, General data type traps, Context Traps - scalar, list contexts,
765 Precedence Traps, General Regular Expression Traps using s///, etc,
766 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
767
768 =item Discontinuance, Deprecation, and BugFix traps
769
770 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
771 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
772 Discontinuance, Deprecation, Discontinuance, Discontinuance
773
774 =item Parsing Traps
775
776 Parsing, Parsing, Parsing, Parsing, Parsing
777
778 =item Numerical Traps
779
780 Numerical, Numerical, Numerical, Bitwise string ops
781
782 =item General data type traps
783
784 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
785 (Constants), (Scalars), (Variable Suicide)
786
787 =item Context Traps - scalar, list contexts
788
789 (list context), (scalar context), (scalar context), (list, builtin)
790
791 =item Precedence Traps
792
793 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
794 Precedence
795
796 =item General Regular Expression Traps using s///, etc.
797
798 Regular Expression, Regular Expression, Regular Expression, Regular
799 Expression, Regular Expression, Regular Expression, Regular Expression,
800 Regular Expression
801
802 =item Subroutine, Signal, Sorting Traps
803
804 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
805
806 =item OS Traps
807
808 (SysV), (SysV)
809
810 =item Interpolation Traps
811
812 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
813 Interpolation, Interpolation, Interpolation, Interpolation
814
815 =item DBM Traps
816
817 DBM, DBM
818
819 =item Unclassified Traps
820
821 C<require>/C<do> trap using returned value, C<split> on empty string with
822 LIMIT specified
823
824 =back
825
826 =back
827
828 =head2 perlrun - how to execute the Perl interpreter
829
830 =over 4
831
832 =item SYNOPSIS
833
834 =item DESCRIPTION
835
836 =over 4
837
838 =item #! and quoting on non-Unix systems
839
840 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
841
842 =item Location of Perl
843
844 =item Command Switches
845
846 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
847 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
848 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
849 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
850 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
851 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
852 B<-X>, B<-x> I<directory>
853
854 =back
855
856 =item ENVIRONMENT
857
858 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
859 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
860 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
861 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
862 SYS$LOGIN (specific to the VMS port)
863
864 =back
865
866 =head2 perldiag - various Perl diagnostics
867
868 =over 4
869
870 =item DESCRIPTION
871
872 =back
873
874 =head2 perllexwarn - Perl Lexical Warnings
875
876 =over 4
877
878 =item DESCRIPTION
879
880 =over 4
881
882 =item Default Warnings and Optional Warnings
883
884 =item What's wrong with B<-w> and C<$^W>
885
886 =item Controlling Warnings from the Command Line
887
888 B<-w>, B<-W>, B<-X>
889
890 =item Backward Compatibility
891
892 =item Category Hierarchy
893
894 =item Fatal Warnings
895
896 =item Reporting Warnings from a Module
897
898 =back
899
900 =item TODO
901
902 =item SEE ALSO
903
904 =item AUTHOR
905
906 =back
907
908 =head2 perldebtut - Perl debugging tutorial
909
910 =over 4
911
912 =item DESCRIPTION
913
914 =item use strict
915
916 =item Looking at data and -w and v
917
918 =item help
919
920 =item Stepping through code
921
922 =item Placeholder for a, w, t, T
923
924 =item REGULAR EXPRESSIONS
925
926 =item OUTPUT TIPS
927
928 =item CGI
929
930 =item GUIs
931
932 =item SUMMARY
933
934 =item SEE ALSO
935
936 =item AUTHOR
937
938 =item CONTRIBUTORS
939
940 =back
941
942 =head2 perldebug - Perl debugging
943
944 =over 4
945
946 =item DESCRIPTION
947
948 =item The Perl Debugger
949
950 =over 4
951
952 =item Debugger Commands
953
954 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
955 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
956 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
957 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
958 subname [condition], b postpone subname [condition], b load filename, b
959 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
960 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
961 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
962 command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q
963 or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
964
965 =item Configurable Options
966
967 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
968 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
969 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
970 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
971 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
972 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
973 C<NonStop>
974
975 =item Debugger input/output
976
977 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
978 listing
979
980 =item Debugging compile-time statements
981
982 =item Debugger Customization
983
984 =item Readline Support
985
986 =item Editor Support for Debugging
987
988 =item The Perl Profiler
989
990 =back
991
992 =item Debugging regular expressions
993
994 =item Debugging memory usage
995
996 =item SEE ALSO
997
998 =item BUGS
999
1000 =back
1001
1002 =head2 perlvar - Perl predefined variables
1003
1004 =over 4
1005
1006 =item DESCRIPTION
1007
1008 =over 4
1009
1010 =item Predefined Names
1011
1012 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1013 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1014 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1015 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1016 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1017 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1018 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1019 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1020 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1021 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1022 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1023 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1024 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1025 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1026 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1027 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1028 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1029 IO::Handle->format_line_break_characters EXPR,
1030 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1031 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1032 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1033 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1034 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1035 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1036 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1037 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1038 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1039 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1040 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1041 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1042
1043 =item Error Indicators
1044
1045 =item Technical Note on the Syntax of Variable Names
1046
1047 =back
1048
1049 =item BUGS
1050
1051 =back
1052
1053 =head2 perllol - Manipulating Arrays of Arrays in Perl
1054
1055 =over 4
1056
1057 =item DESCRIPTION
1058
1059 =over 4
1060
1061 =item Declaration and Access of Arrays of Arrays
1062
1063 =item Growing Your Own
1064
1065 =item Access and Printing
1066
1067 =item Slices
1068
1069 =back
1070
1071 =item SEE ALSO
1072
1073 =item AUTHOR
1074
1075 =back
1076
1077 =head2 perlopentut - tutorial on opening things in Perl
1078
1079 =over 4
1080
1081 =item DESCRIPTION
1082
1083 =item Open E<agrave> la shell
1084
1085 =over 4
1086
1087 =item Simple Opens
1088
1089 =item Pipe Opens
1090
1091 =item The Minus File
1092
1093 =item Mixing Reads and Writes
1094
1095 =item Filters 
1096
1097 =back
1098
1099 =item Open E<agrave> la C
1100
1101 =over 4
1102
1103 =item Permissions E<agrave> la mode
1104
1105 =back
1106
1107 =item Obscure Open Tricks
1108
1109 =over 4
1110
1111 =item Re-Opening Files (dups)
1112
1113 =item Dispelling the Dweomer
1114
1115 =item Paths as Opens
1116
1117 =item Single Argument Open
1118
1119 =item Playing with STDIN and STDOUT
1120
1121 =back
1122
1123 =item Other I/O Issues
1124
1125 =over 4
1126
1127 =item Opening Non-File Files
1128
1129 =item Binary Files
1130
1131 =item File Locking
1132
1133 =item IO Layers
1134
1135 =back
1136
1137 =item SEE ALSO 
1138
1139 =item AUTHOR and COPYRIGHT
1140
1141 =item HISTORY
1142
1143 =back
1144
1145 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1146
1147 =over 4
1148
1149 =item DESCRIPTION
1150
1151 =item The Basic Principle
1152
1153 =item Packing Text
1154
1155 =item Packing Numbers
1156
1157 =over 4
1158
1159 =item Integers
1160
1161 =item Unpacking a Stack Frame
1162
1163 =item How to Eat an Egg on a Net
1164
1165 =item Floating point Numbers
1166
1167 =back
1168
1169 =item Exotic Templates
1170
1171 =over 4
1172
1173 =item Bit Strings
1174
1175 =item Uuencoding
1176
1177 =item Doing Sums
1178
1179 =item  Unicode
1180
1181 =item Another Portable Binary Encoding
1182
1183 =back
1184
1185 =item Lengths and Widths
1186
1187 =over 4
1188
1189 =item String Lengths
1190
1191 =item Dynamic Templates
1192
1193 =back
1194
1195 =item Packing and Unpacking C Structures
1196
1197 =over 4
1198
1199 =item The Alignment Pit
1200
1201 =item Alignment, Take 2
1202
1203 =item Alignment, Take 3
1204
1205 =item Pointers for How to Use Them
1206
1207 =back
1208
1209 =item Pack Recipes
1210
1211 =item Funnies Section
1212
1213 =item Authors
1214
1215 =back
1216
1217 =head2 perlretut - Perl regular expressions tutorial
1218
1219 =over 4
1220
1221 =item DESCRIPTION
1222
1223 =item Part 1: The basics
1224
1225 =over 4
1226
1227 =item Simple word matching
1228
1229 =item Using character classes
1230
1231 =item Matching this or that
1232
1233 =item Grouping things and hierarchical matching
1234
1235 =item Extracting matches
1236
1237 =item Matching repetitions
1238
1239 =item Building a regexp
1240
1241 =item Using regular expressions in Perl
1242
1243 =back
1244
1245 =item Part 2: Power tools
1246
1247 =over 4
1248
1249 =item More on characters, strings, and character classes
1250
1251 =item Compiling and saving regular expressions
1252
1253 =item Embedding comments and modifiers in a regular expression
1254
1255 =item Non-capturing groupings
1256
1257 =item Looking ahead and looking behind
1258
1259 =item Using independent subexpressions to prevent backtracking
1260
1261 =item Conditional expressions
1262
1263 =item A bit of magic: executing Perl code in a regular expression
1264
1265 =item Pragmas and debugging
1266
1267 =back
1268
1269 =item BUGS
1270
1271 =item SEE ALSO
1272
1273 =item AUTHOR AND COPYRIGHT
1274
1275 =over 4
1276
1277 =item Acknowledgments
1278
1279 =back
1280
1281 =back
1282
1283 =head2 perlre - Perl regular expressions
1284
1285 =over 4
1286
1287 =item DESCRIPTION
1288
1289 i, m, s, x
1290
1291 =over 4
1292
1293 =item Regular Expressions
1294
1295 [1], [2], [3], cntrl, graph, print, punct, xdigit
1296
1297 =item Extended Patterns
1298
1299 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1300 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1301 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1302 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1303
1304 =item Backtracking
1305
1306 =item Version 8 Regular Expressions
1307
1308 =item Warning on \1 vs $1
1309
1310 =item Repeated patterns matching zero-length substring
1311
1312 =item Combining pieces together
1313
1314 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1315 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1316 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1317 C<(?(condition)yes-pattern|no-pattern)>
1318
1319 =item Creating custom RE engines
1320
1321 =back
1322
1323 =item BUGS
1324
1325 =item SEE ALSO
1326
1327 =back
1328
1329 =head2 perlref - Perl references and nested data structures
1330
1331 =over 4
1332
1333 =item NOTE
1334
1335 =item DESCRIPTION
1336
1337 =over 4
1338
1339 =item Making References
1340
1341 =item Using References
1342
1343 =item Symbolic references
1344
1345 =item Not-so-symbolic references
1346
1347 =item Pseudo-hashes: Using an array as a hash
1348
1349 =item Function Templates
1350
1351 =back
1352
1353 =item WARNING
1354
1355 =item SEE ALSO
1356
1357 =back
1358
1359 =head2 perlform - Perl formats
1360
1361 =over 4
1362
1363 =item DESCRIPTION
1364
1365 =over 4
1366
1367 =item Format Variables
1368
1369 =back
1370
1371 =item NOTES
1372
1373 =over 4
1374
1375 =item Footers
1376
1377 =item Accessing Formatting Internals
1378
1379 =back
1380
1381 =item WARNINGS
1382
1383 =back
1384
1385 =head2 perlboot - Beginner's Object-Oriented Tutorial
1386
1387 =over 4
1388
1389 =item DESCRIPTION
1390
1391 =over 4
1392
1393 =item If we could talk to the animals...
1394
1395 =item Introducing the method invocation arrow
1396
1397 =item Invoking a barnyard
1398
1399 =item The extra parameter of method invocation
1400
1401 =item Calling a second method to simplify things
1402
1403 =item Inheriting the windpipes
1404
1405 =item A few notes about @ISA
1406
1407 =item Overriding the methods
1408
1409 =item Starting the search from a different place
1410
1411 =item The SUPER way of doing things
1412
1413 =item Where we're at so far...
1414
1415 =item A horse is a horse, of course of course -- or is it?
1416
1417 =item Invoking an instance method
1418
1419 =item Accessing the instance data
1420
1421 =item How to build a horse
1422
1423 =item Inheriting the constructor
1424
1425 =item Making a method work with either classes or instances
1426
1427 =item Adding parameters to a method
1428
1429 =item More interesting instances
1430
1431 =item A horse of a different color
1432
1433 =item Summary
1434
1435 =back
1436
1437 =item SEE ALSO
1438
1439 =item COPYRIGHT
1440
1441 =back
1442
1443 =head2 perltoot - Tom's object-oriented tutorial for perl
1444
1445 =over 4
1446
1447 =item DESCRIPTION
1448
1449 =item Creating a Class
1450
1451 =over 4
1452
1453 =item Object Representation
1454
1455 =item Class Interface
1456
1457 =item Constructors and Instance Methods
1458
1459 =item Planning for the Future: Better Constructors
1460
1461 =item Destructors
1462
1463 =item Other Object Methods
1464
1465 =back
1466
1467 =item Class Data
1468
1469 =over 4
1470
1471 =item Accessing Class Data
1472
1473 =item Debugging Methods
1474
1475 =item Class Destructors
1476
1477 =item Documenting the Interface
1478
1479 =back
1480
1481 =item Aggregation
1482
1483 =item Inheritance
1484
1485 =over 4
1486
1487 =item Overridden Methods
1488
1489 =item Multiple Inheritance
1490
1491 =item UNIVERSAL: The Root of All Objects
1492
1493 =back
1494
1495 =item Alternate Object Representations
1496
1497 =over 4
1498
1499 =item Arrays as Objects
1500
1501 =item Closures as Objects
1502
1503 =back
1504
1505 =item AUTOLOAD: Proxy Methods
1506
1507 =over 4
1508
1509 =item Autoloaded Data Methods
1510
1511 =item Inherited Autoloaded Data Methods
1512
1513 =back
1514
1515 =item Metaclassical Tools
1516
1517 =over 4
1518
1519 =item Class::Struct
1520
1521 =item Data Members as Variables
1522
1523 =back
1524
1525 =item NOTES
1526
1527 =over 4
1528
1529 =item Object Terminology
1530
1531 =back
1532
1533 =item SEE ALSO
1534
1535 =item AUTHOR AND COPYRIGHT
1536
1537 =item COPYRIGHT
1538
1539 =over 4
1540
1541 =item Acknowledgments
1542
1543 =back
1544
1545 =back
1546
1547 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1548
1549 =over 4
1550
1551 =item DESCRIPTION
1552
1553 =item Class Data in a Can
1554
1555 =item Class Data as Package Variables
1556
1557 =over 4
1558
1559 =item Putting All Your Eggs in One Basket
1560
1561 =item Inheritance Concerns
1562
1563 =item The Eponymous Meta-Object
1564
1565 =item Indirect References to Class Data
1566
1567 =item Monadic Classes
1568
1569 =item Translucent Attributes
1570
1571 =back
1572
1573 =item Class Data as Lexical Variables
1574
1575 =over 4
1576
1577 =item Privacy and Responsibility 
1578
1579 =item File-Scoped Lexicals
1580
1581 =item More Inheritance Concerns
1582
1583 =item Locking the Door and Throwing Away the Key
1584
1585 =item Translucency Revisited
1586
1587 =back
1588
1589 =item NOTES
1590
1591 =item SEE ALSO
1592
1593 =item AUTHOR AND COPYRIGHT
1594
1595 =item ACKNOWLEDGEMENTS
1596
1597 =item HISTORY
1598
1599 =back
1600
1601 =head2 perlobj - Perl objects
1602
1603 =over 4
1604
1605 =item DESCRIPTION
1606
1607 =over 4
1608
1609 =item An Object is Simply a Reference
1610
1611 =item A Class is Simply a Package
1612
1613 =item A Method is Simply a Subroutine
1614
1615 =item Method Invocation
1616
1617 =item Indirect Object Syntax
1618
1619 =item Default UNIVERSAL methods
1620
1621 isa(CLASS), can(METHOD), VERSION( [NEED] )
1622
1623 =item Destructors
1624
1625 =item Summary
1626
1627 =item Two-Phased Garbage Collection
1628
1629 =back
1630
1631 =item SEE ALSO
1632
1633 =back
1634
1635 =head2 perlbot - Bag'o Object Tricks (the BOT)
1636
1637 =over 4
1638
1639 =item DESCRIPTION
1640
1641 =item OO SCALING TIPS
1642
1643 =item INSTANCE VARIABLES
1644
1645 =item SCALAR INSTANCE VARIABLES
1646
1647 =item INSTANCE VARIABLE INHERITANCE
1648
1649 =item OBJECT RELATIONSHIPS
1650
1651 =item OVERRIDING SUPERCLASS METHODS
1652
1653 =item USING RELATIONSHIP WITH SDBM
1654
1655 =item THINKING OF CODE REUSE
1656
1657 =item CLASS CONTEXT AND THE OBJECT
1658
1659 =item INHERITING A CONSTRUCTOR
1660
1661 =item DELEGATION
1662
1663 =back
1664
1665 =head2 perltie - how to hide an object class in a simple variable
1666
1667 =over 4
1668
1669 =item SYNOPSIS
1670
1671 =item DESCRIPTION
1672
1673 =over 4
1674
1675 =item Tying Scalars
1676
1677 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1678 DESTROY this
1679
1680 =item Tying Arrays
1681
1682 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1683 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1684 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1685 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1686 this
1687
1688 =item Tying Hashes
1689
1690 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1691 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1692 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1693
1694 =item Tying FileHandles
1695
1696 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1697 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1698 DESTROY this
1699
1700 =item UNTIE this
1701
1702 =item The C<untie> Gotcha
1703
1704 =back
1705
1706 =item SEE ALSO
1707
1708 =item BUGS
1709
1710 =item AUTHOR
1711
1712 =back
1713
1714 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1715 safe subprocesses, sockets, and semaphores)
1716
1717 =over 4
1718
1719 =item DESCRIPTION
1720
1721 =item Signals
1722
1723 =over 4
1724
1725 =item Handling the SIGHUP Signal in Daemons
1726
1727 =back
1728
1729 =item Named Pipes
1730
1731 =over 4
1732
1733 =item Deferred Signals
1734
1735 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1736 triggered by operating system state
1737
1738 =back
1739
1740 =item Using open() for IPC
1741
1742 =over 4
1743
1744 =item Filehandles
1745
1746 =item Background Processes
1747
1748 =item Complete Dissociation of Child from Parent
1749
1750 =item Safe Pipe Opens
1751
1752 =item Bidirectional Communication with Another Process
1753
1754 =item Bidirectional Communication with Yourself
1755
1756 =back
1757
1758 =item Sockets: Client/Server Communication
1759
1760 =over 4
1761
1762 =item Internet Line Terminators
1763
1764 =item Internet TCP Clients and Servers
1765
1766 =item Unix-Domain TCP Clients and Servers
1767
1768 =back
1769
1770 =item TCP Clients with IO::Socket
1771
1772 =over 4
1773
1774 =item A Simple Client
1775
1776 C<Proto>, C<PeerAddr>, C<PeerPort>
1777
1778 =item A Webget Client
1779
1780 =item Interactive Client with IO::Socket
1781
1782 =back
1783
1784 =item TCP Servers with IO::Socket
1785
1786 Proto, LocalPort, Listen, Reuse
1787
1788 =item UDP: Message Passing
1789
1790 =item SysV IPC
1791
1792 =item NOTES
1793
1794 =item BUGS
1795
1796 =item AUTHOR
1797
1798 =item SEE ALSO
1799
1800 =back
1801
1802 =head2 perlfork - Perl's fork() emulation
1803
1804 =over 4
1805
1806 =item SYNOPSIS
1807
1808 =item DESCRIPTION
1809
1810 =over 4
1811
1812 =item Behavior of other Perl features in forked pseudo-processes
1813
1814 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1815 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1816 files, directories and network sockets
1817
1818 =item Resource limits
1819
1820 =item Killing the parent process
1821
1822 =item Lifetime of the parent process and pseudo-processes
1823
1824 =item CAVEATS AND LIMITATIONS
1825
1826 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1827 Global state maintained by XSUBs, Interpreter embedded in larger
1828 application, Thread-safety of extensions
1829
1830 =back
1831
1832 =item BUGS
1833
1834 =item AUTHOR
1835
1836 =item SEE ALSO
1837
1838 =back
1839
1840 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1841
1842 =over 4
1843
1844 =item SYNOPSIS
1845
1846 =item DESCRIPTION
1847
1848 =item Storing numbers
1849
1850 =item Numeric operators and numeric conversions
1851
1852 =item Flavors of Perl numeric operations
1853
1854 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1855 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1856 integer>, Operators which expect an integer, Operators which expect a
1857 string
1858
1859 =item AUTHOR
1860
1861 =item SEE ALSO
1862
1863 =back
1864
1865 =head2 perlthrtut - tutorial on threads in Perl
1866
1867 =over 4
1868
1869 =item DESCRIPTION
1870
1871 =item Status
1872
1873 =item What Is A Thread Anyway?
1874
1875 =item Threaded Program Models
1876
1877 =over 4
1878
1879 =item Boss/Worker
1880
1881 =item Work Crew
1882
1883 =item Pipeline
1884
1885 =back
1886
1887 =item Native threads
1888
1889 =item What kind of threads are Perl threads?
1890
1891 =item Threadsafe Modules
1892
1893 =item Thread Basics
1894
1895 =over 4
1896
1897 =item Basic Thread Support
1898
1899 =item A Note about the Examples
1900
1901 =item Creating Threads
1902
1903 =item Giving up control
1904
1905 =item Waiting For A Thread To Exit
1906
1907 =item Ignoring A Thread
1908
1909 =back
1910
1911 =item Threads And Data
1912
1913 =over 4
1914
1915 =item Shared And Unshared Data
1916
1917 =item Thread Pitfalls: Races
1918
1919 =back
1920
1921 =item Synchronization and control
1922
1923 =over 4
1924
1925 =item Controlling access: lock()
1926
1927 =item A Thread Pitfall: Deadlocks
1928
1929 =item Queues: Passing Data Around
1930
1931 =item Semaphores: Synchronizing Data Access
1932
1933 =item Basic semaphores
1934
1935 =item Advanced Semaphores
1936
1937 =item cond_wait() and cond_signal()
1938
1939 =back
1940
1941 =item General Thread Utility Routines
1942
1943 =over 4
1944
1945 =item What Thread Am I In?
1946
1947 =item Thread IDs
1948
1949 =item Are These Threads The Same?
1950
1951 =item What Threads Are Running?
1952
1953 =back
1954
1955 =item A Complete Example
1956
1957 =item Performance considerations
1958
1959 =item Threadsafety of System Libraries
1960
1961 =item Conclusion
1962
1963 =item Bibliography
1964
1965 =over 4
1966
1967 =item Introductory Texts
1968
1969 =item OS-Related References
1970
1971 =item Other References
1972
1973 =back
1974
1975 =item Acknowledgements
1976
1977 =item AUTHOR
1978
1979 =item Copyrights
1980
1981 =back
1982
1983 =head2 perlothrtut - old tutorial on threads in Perl
1984
1985 =over 4
1986
1987 =item DESCRIPTION
1988
1989 =item What Is A Thread Anyway?
1990
1991 =item Threaded Program Models
1992
1993 =over 4
1994
1995 =item Boss/Worker
1996
1997 =item Work Crew
1998
1999 =item Pipeline
2000
2001 =back
2002
2003 =item Native threads
2004
2005 =item What kind of threads are perl threads?
2006
2007 =item Threadsafe Modules
2008
2009 =item Thread Basics
2010
2011 =over 4
2012
2013 =item Basic Thread Support
2014
2015 =item Creating Threads
2016
2017 =item Giving up control
2018
2019 =item Waiting For A Thread To Exit
2020
2021 =item Errors In Threads
2022
2023 =item Ignoring A Thread
2024
2025 =back
2026
2027 =item Threads And Data
2028
2029 =over 4
2030
2031 =item Shared And Unshared Data
2032
2033 =item Thread Pitfall: Races
2034
2035 =item Controlling access: lock()
2036
2037 =item Thread Pitfall: Deadlocks
2038
2039 =item Queues: Passing Data Around
2040
2041 =back
2042
2043 =item Threads And Code
2044
2045 =over 4
2046
2047 =item Semaphores: Synchronizing Data Access
2048
2049 Basic semaphores, Advanced Semaphores
2050
2051 =item Attributes: Restricting Access To Subroutines
2052
2053 =item Subroutine Locks
2054
2055 =item Methods
2056
2057 =item Locking A Subroutine
2058
2059 =back
2060
2061 =item General Thread Utility Routines
2062
2063 =over 4
2064
2065 =item What Thread Am I In?
2066
2067 =item Thread IDs
2068
2069 =item Are These Threads The Same?
2070
2071 =item What Threads Are Running?
2072
2073 =back
2074
2075 =item A Complete Example
2076
2077 =item Conclusion
2078
2079 =item Bibliography
2080
2081 =over 4
2082
2083 =item Introductory Texts
2084
2085 =item OS-Related References
2086
2087 =item Other References
2088
2089 =back
2090
2091 =item Acknowledgements
2092
2093 =item AUTHOR
2094
2095 =item Copyrights
2096
2097 =back
2098
2099 =head2 perlport - Writing portable Perl
2100
2101 =over 4
2102
2103 =item DESCRIPTION
2104
2105 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2106 portable
2107
2108 =item ISSUES
2109
2110 =over 4
2111
2112 =item Newlines
2113
2114 =item Numbers endianness and Width
2115
2116 =item Files and Filesystems
2117
2118 =item System Interaction
2119
2120 =item Command names versus file pathnames
2121
2122 =item Interprocess Communication (IPC)
2123
2124 =item External Subroutines (XS)
2125
2126 =item Standard Modules
2127
2128 =item Time and Date
2129
2130 =item Character sets and character encoding
2131
2132 =item Internationalisation
2133
2134 =item System Resources
2135
2136 =item Security
2137
2138 =item Style
2139
2140 =back
2141
2142 =item CPAN Testers
2143
2144 Mailing list: cpan-testers@perl.org, Testing results:
2145 http://testers.cpan.org/
2146
2147 =item PLATFORMS
2148
2149 =over 4
2150
2151 =item Unix
2152
2153 =item DOS and Derivatives
2154
2155 =item S<Mac OS>
2156
2157 =item VMS
2158
2159 =item VOS
2160
2161 =item EBCDIC Platforms
2162
2163 =item Acorn RISC OS
2164
2165 =item Other perls
2166
2167 =back
2168
2169 =item FUNCTION IMPLEMENTATIONS
2170
2171 =over 4
2172
2173 =item Alphabetical Listing of Perl Functions
2174
2175 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2176 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2177 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2178 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2179 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2180 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2181 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2182 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2183 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2184 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2185 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2186 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2187 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2188 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2189 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2190 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2191 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2192 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2193 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2194 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2195 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2196 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2197 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2198 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2199 wait, waitpid PID,FLAGS
2200
2201 =back
2202
2203 =item CHANGES
2204
2205 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2206 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2207 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2208 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2209 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2210 v1.30, 03 August 1998, v1.23, 10 July 1998
2211
2212 =item Supported Platforms
2213
2214 =item SEE ALSO
2215
2216 =item AUTHORS / CONTRIBUTORS
2217
2218 =back
2219
2220 =head2 perllocale - Perl locale handling (internationalization and
2221 localization)
2222
2223 =over 4
2224
2225 =item DESCRIPTION
2226
2227 =item PREPARING TO USE LOCALES
2228
2229 =item USING LOCALES
2230
2231 =over 4
2232
2233 =item The use locale pragma
2234
2235 =item The setlocale function
2236
2237 =item Finding locales
2238
2239 =item LOCALE PROBLEMS
2240
2241 =item Temporarily fixing locale problems
2242
2243 =item Permanently fixing locale problems
2244
2245 =item Permanently fixing your system's locale configuration
2246
2247 =item Fixing system locale configuration
2248
2249 =item The localeconv function
2250
2251 =item I18N::Langinfo
2252
2253 =back
2254
2255 =item LOCALE CATEGORIES
2256
2257 =over 4
2258
2259 =item Category LC_COLLATE: Collation
2260
2261 =item Category LC_CTYPE: Character Types
2262
2263 =item Category LC_NUMERIC: Numeric Formatting
2264
2265 =item Category LC_MONETARY: Formatting of monetary amounts
2266
2267 =item LC_TIME
2268
2269 =item Other categories
2270
2271 =back
2272
2273 =item SECURITY
2274
2275 =item ENVIRONMENT
2276
2277 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2278 LC_NUMERIC, LC_TIME, LANG
2279
2280 =item NOTES
2281
2282 =over 4
2283
2284 =item Backward compatibility
2285
2286 =item I18N:Collate obsolete
2287
2288 =item Sort speed and memory use impacts
2289
2290 =item write() and LC_NUMERIC
2291
2292 =item Freely available locale definitions
2293
2294 =item I18n and l10n
2295
2296 =item An imperfect standard
2297
2298 =back
2299
2300 =item Unicode and UTF-8
2301
2302 =item BUGS
2303
2304 =over 4
2305
2306 =item Broken systems
2307
2308 =back
2309
2310 =item SEE ALSO
2311
2312 =item HISTORY
2313
2314 =back
2315
2316 =head2 perluniintro - Perl Unicode introduction
2317
2318 =over 4
2319
2320 =item DESCRIPTION
2321
2322 =over 4
2323
2324 =item Unicode
2325
2326 =item Perl's Unicode Support
2327
2328 =item Perl's Unicode Model
2329
2330 =item Unicode and EBCDIC
2331
2332 =item Creating Unicode
2333
2334 =item Handling Unicode
2335
2336 =item Legacy Encodings
2337
2338 =item Unicode I/O
2339
2340 =item Displaying Unicode As Text
2341
2342 =item Special Cases
2343
2344 =item Advanced Topics
2345
2346 =item Miscellaneous
2347
2348 =item Questions With Answers
2349
2350 =item Hexadecimal Notation
2351
2352 =item Further Resources
2353
2354 =back
2355
2356 =item UNICODE IN OLDER PERLS
2357
2358 =item SEE ALSO
2359
2360 =item ACKNOWLEDGMENTS
2361
2362 =item AUTHOR, COPYRIGHT, AND LICENSE
2363
2364 =back
2365
2366 =head2 perlunicode - Unicode support in Perl
2367
2368 =over 4
2369
2370 =item DESCRIPTION
2371
2372 =over 4
2373
2374 =item Important Caveats
2375
2376 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
2377 enable UTF-8/UTF-EBCDIC in scripts
2378
2379 =item Byte and Character Semantics
2380
2381 =item Effects of Character Semantics
2382
2383 =item Scripts
2384
2385 =item Blocks
2386
2387 =item User-Defined Character Properties
2388
2389 =item Character Encodings for Input and Output
2390
2391 =item Unicode Regular Expression Support Level
2392
2393 =item Unicode Encodings
2394
2395 =item Security Implications of Unicode
2396
2397 =item Unicode in Perl on EBCDIC
2398
2399 =item Locales
2400
2401 =item Using Unicode in XS
2402
2403 =back
2404
2405 =item BUGS
2406
2407 =over 4
2408
2409 =item Interaction with Locales
2410
2411 =item Interaction with Extensions
2412
2413 =item Speed
2414
2415 =back
2416
2417 =item SEE ALSO
2418
2419 =back
2420
2421 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2422
2423 =over 4
2424
2425 =item DESCRIPTION
2426
2427 =item COMMON CHARACTER CODE SETS
2428
2429 =over 4
2430
2431 =item ASCII
2432
2433 =item ISO 8859
2434
2435 =item Latin 1 (ISO 8859-1)
2436
2437 =item EBCDIC
2438
2439 =item 13 variant characters
2440
2441 =item 0037
2442
2443 =item 1047
2444
2445 =item POSIX-BC
2446
2447 =item Unicode code points versus EBCDIC code points
2448
2449 =item Remaining Perl Unicode problems in EBCDIC
2450
2451 =item Unicode and UTF
2452
2453 =item Using Encode
2454
2455 =back
2456
2457 =item SINGLE OCTET TABLES
2458
2459 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2460
2461 =item IDENTIFYING CHARACTER CODE SETS
2462
2463 =item CONVERSIONS
2464
2465 =over 4
2466
2467 =item tr///
2468
2469 =item iconv
2470
2471 =item C RTL
2472
2473 =back
2474
2475 =item OPERATOR DIFFERENCES
2476
2477 =item FUNCTION DIFFERENCES
2478
2479 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2480
2481 =item REGULAR EXPRESSION DIFFERENCES
2482
2483 =item SOCKETS
2484
2485 =item SORTING
2486
2487 =over 4
2488
2489 =item Ignore ASCII vs. EBCDIC sort differences.
2490
2491 =item MONO CASE then sort data.
2492
2493 =item Convert, sort data, then re convert.
2494
2495 =item Perform sorting on one type of machine only.
2496
2497 =back
2498
2499 =item TRANSFORMATION FORMATS
2500
2501 =over 4
2502
2503 =item URL decoding and encoding
2504
2505 =item uu encoding and decoding
2506
2507 =item Quoted-Printable encoding and decoding
2508
2509 =item Caesarian ciphers
2510
2511 =back
2512
2513 =item Hashing order and checksums
2514
2515 =item I18N AND L10N
2516
2517 =item MULTI OCTET CHARACTER SETS
2518
2519 =item OS ISSUES
2520
2521 =over 4
2522
2523 =item OS/400 
2524
2525 IFS access
2526
2527 =item OS/390, z/OS
2528
2529 chcp, dataset access, OS/390, z/OS iconv, locales
2530
2531 =item VM/ESA?
2532
2533 =item POSIX-BC?
2534
2535 =back
2536
2537 =item BUGS
2538
2539 =item SEE ALSO
2540
2541 =item REFERENCES
2542
2543 =item HISTORY
2544
2545 =item AUTHOR
2546
2547 =back
2548
2549 =head2 perlsec - Perl security
2550
2551 =over 4
2552
2553 =item DESCRIPTION
2554
2555 =over 4
2556
2557 =item Laundering and Detecting Tainted Data
2558
2559 =item Switches On the "#!" Line
2560
2561 =item Cleaning Up Your Path
2562
2563 =item Security Bugs
2564
2565 =item Protecting Your Programs
2566
2567 =item Unicode
2568
2569 =back
2570
2571 =item SEE ALSO
2572
2573 =back
2574
2575 =head2 perlmod - Perl modules (packages and symbol tables)
2576
2577 =over 4
2578
2579 =item DESCRIPTION
2580
2581 =over 4
2582
2583 =item Packages
2584
2585 =item Symbol Tables
2586
2587 =item Package Constructors and Destructors
2588
2589 =item Perl Classes
2590
2591 =item Perl Modules
2592
2593 =item Making your module threadsafe
2594
2595 =back
2596
2597 =item SEE ALSO
2598
2599 =back
2600
2601 =head2 perlmodinstall - Installing CPAN Modules
2602
2603 =over 4
2604
2605 =item DESCRIPTION
2606
2607 =over 4
2608
2609 =item PREAMBLE
2610
2611 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2612 module (sometimes unnecessary), B<INSTALL> the module
2613
2614 =back
2615
2616 =item PORTABILITY
2617
2618 =item HEY
2619
2620 =item AUTHOR
2621
2622 =item COPYRIGHT
2623
2624 =back
2625
2626 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2627
2628 =over 4
2629
2630 =item DESCRIPTION
2631
2632 =item THE PERL MODULE LIBRARY
2633
2634 =over 4
2635
2636 =item Pragmatic Modules
2637
2638 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2639 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2640 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2641 threads, utf8, vars, vmsish, warnings, warnings::register
2642
2643 =item Standard Modules
2644
2645 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2646 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2647 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2648 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2649 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2650 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2651 Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest,
2652 DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter,
2653 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
2654 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
2655 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
2656 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
2657 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
2658 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2659 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2660 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2661 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2662 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2663 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2664 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2665 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2666 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2667 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2668 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2669 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2670 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2671 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2672 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2673 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2674 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2675 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2676 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2677 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2678 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2679 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2680 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe,
2681 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
2682 Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
2683 Test::Builder, Test::Harness, Test::Harness::Assert,
2684 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2685 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2686 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2687 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2688 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2689 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2690 Unicode::UCD, User::grent, User::pwent, Win32
2691
2692 =item Extension Modules
2693
2694 =back
2695
2696 =item CPAN
2697
2698 =over 4
2699
2700 =item Africa
2701
2702 =item Asia
2703
2704 =item Central America
2705
2706 =item Europe
2707
2708 =item North America
2709
2710 =item Oceania
2711
2712 =item South America
2713
2714 =back
2715
2716 =item Modules: Creation, Use, and Abuse
2717
2718 =over 4
2719
2720 =item Guidelines for Module Creation
2721
2722 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2723
2724 =item Guidelines for Reusing Application Code
2725
2726 =back
2727
2728 =item NOTE
2729
2730 =back
2731
2732 =head2 perlmodstyle - Perl module style guide
2733
2734 =over 4
2735
2736 =item INTRODUCTION
2737
2738 =item QUICK CHECKLIST
2739
2740 =over 4
2741
2742 =item Before you start
2743
2744 =item The API
2745
2746 =item Stability
2747
2748 =item Documentation
2749
2750 =item Release considerations
2751
2752 =back
2753
2754 =item BEFORE YOU START WRITING A MODULE
2755
2756 =over 4
2757
2758 =item Has it been done before?
2759
2760 =item Do one thing and do it well
2761
2762 =item What's in a name?
2763
2764 =back
2765
2766 =item DESIGNING AND WRITING YOUR MODULE
2767
2768 =over 4
2769
2770 =item To OO or not to OO?
2771
2772 =item Designing your API
2773
2774 Write simple routines to do simple things, Separate functionality from
2775 output, Provide sensible shortcuts and defaults, Naming conventions,
2776 Parameter passing
2777
2778 =item Strictness and warnings
2779
2780 =item Backwards compatibility
2781
2782 =item Error handling and messages
2783
2784 =back
2785
2786 =item DOCUMENTING YOUR MODULE
2787
2788 =over 4
2789
2790 =item POD
2791
2792 =item README, INSTALL, release notes, changelogs
2793
2794 =back
2795
2796 =item RELEASE CONSIDERATIONS
2797
2798 =over 4
2799
2800 =item Version numbering
2801
2802 =item Pre-requisites
2803
2804 =item Testing
2805
2806 =item Packaging
2807
2808 =item Licensing
2809
2810 =back
2811
2812 =item COMMON PITFALLS
2813
2814 =over 4
2815
2816 =item Reinventing the wheel
2817
2818 =item Trying to do too much
2819
2820 =item Inappropriate documentation
2821
2822 =back
2823
2824 =item SEE ALSO
2825
2826 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2827 http://pause.perl.org/, Any good book on software engineering
2828
2829 =item AUTHOR
2830
2831 =back
2832
2833 =head2 perlnewmod - preparing a new module for distribution
2834
2835 =over 4
2836
2837 =item DESCRIPTION
2838
2839 =over 4
2840
2841 =item Warning
2842
2843 =item What should I make into a module?
2844
2845 =item Step-by-step: Preparing the ground
2846
2847 Look around, Check it's new, Discuss the need, Choose a name, Check again
2848
2849 =item Step-by-step: Making the module
2850
2851 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2852 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2853 documentation|perlpod>, Write tests, Write the README
2854
2855 =item Step-by-step: Distributing your module
2856
2857 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2858 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2859
2860 =back
2861
2862 =item AUTHOR
2863
2864 =item SEE ALSO
2865
2866 =back
2867
2868 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2869 2002/04/07 18:46:13 $)
2870
2871 =over 4
2872
2873 =item DESCRIPTION
2874
2875 =over 4
2876
2877 =item What is Perl?
2878
2879 =item Who supports Perl?  Who develops it?  Why is it free?
2880
2881 =item Which version of Perl should I use?
2882
2883 =item What are perl4 and perl5?
2884
2885 =item What is perl6?
2886
2887 =item How stable is Perl?
2888
2889 =item Is Perl difficult to learn?
2890
2891 =item How does Perl compare with other languages like Java, Python, REXX,
2892 Scheme, or Tcl?
2893
2894 =item Can I do [task] in Perl?
2895
2896 =item When shouldn't I program in Perl?
2897
2898 =item What's the difference between "perl" and "Perl"?
2899
2900 =item Is it a Perl program or a Perl script?
2901
2902 =item What is a JAPH?
2903
2904 =item Where can I get a list of Larry Wall witticisms?
2905
2906 =item How can I convince my sysadmin/supervisor/employees to use version
2907 5/5.6.1/Perl instead of some other language?
2908
2909 =back
2910
2911 =item AUTHOR AND COPYRIGHT
2912
2913 =back
2914
2915 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2916 $Date: 2002/04/26 16:56:35 $)
2917
2918 =over 4
2919
2920 =item DESCRIPTION
2921
2922 =over 4
2923
2924 =item What machines support Perl?  Where do I get it?
2925
2926 =item How can I get a binary version of Perl?
2927
2928 =item I don't have a C compiler on my system.  How can I compile perl?
2929
2930 =item I copied the Perl binary from one machine to another, but scripts
2931 don't work.
2932
2933 =item I grabbed the sources and tried to compile but gdbm/dynamic
2934 loading/malloc/linking/... failed.  How do I make it work?
2935
2936 =item What modules and extensions are available for Perl?  What is CPAN? 
2937 What does CPAN/src/... mean?
2938
2939 =item Is there an ISO or ANSI certified version of Perl?
2940
2941 =item Where can I get information on Perl?
2942
2943 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2944
2945 =item Where should I post source code?
2946
2947 =item Perl Books
2948
2949 References, Tutorials, Task-Oriented, Special Topics
2950
2951 =item Perl in Magazines
2952
2953 =item Perl on the Net: FTP and WWW Access
2954
2955 =item What mailing lists are there for Perl?
2956
2957 =item Archives of comp.lang.perl.misc
2958
2959 =item Where can I buy a commercial version of Perl?
2960
2961 =item Where do I send bug reports?
2962
2963 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2964
2965 =back
2966
2967 =item AUTHOR AND COPYRIGHT
2968
2969 =back
2970
2971 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
2972 13:11:13 $)
2973
2974 =over 4
2975
2976 =item DESCRIPTION
2977
2978 =over 4
2979
2980 =item How do I do (anything)?
2981
2982 =item How can I use Perl interactively?
2983
2984 =item Is there a Perl shell?
2985
2986 =item How do I debug my Perl programs?
2987
2988 =item How do I profile my Perl programs?
2989
2990 =item How do I cross-reference my Perl programs?
2991
2992 =item Is there a pretty-printer (formatter) for Perl?
2993
2994 =item Is there a ctags for Perl?
2995
2996 =item Is there an IDE or Windows Perl Editor?
2997
2998 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
2999 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
3000 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3001
3002 =item Where can I get Perl macros for vi?
3003
3004 =item Where can I get perl-mode for emacs?
3005
3006 =item How can I use curses with Perl?
3007
3008 =item How can I use X or Tk with Perl?
3009
3010 =item How can I generate simple menus without using CGI or Tk?
3011
3012 =item How can I make my Perl program run faster?
3013
3014 =item How can I make my Perl program take less memory?
3015
3016 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3017 stringification, Pass by reference, Tie large variables to disk
3018
3019 =item Is it unsafe to return a pointer to local data?
3020
3021 =item How can I free an array or hash so my program shrinks?
3022
3023 =item How can I make my CGI script more efficient?
3024
3025 =item How can I hide the source for my Perl program?
3026
3027 =item How can I compile my Perl program into byte code or C?
3028
3029 =item How can I compile Perl into Java?
3030
3031 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3032
3033 =item Can I write useful Perl programs on the command line?
3034
3035 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3036
3037 =item Where can I learn about CGI or Web programming in Perl?
3038
3039 =item Where can I learn about object-oriented Perl programming?
3040
3041 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3042
3043 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3044 my C program; what am I doing wrong?
3045
3046 =item When I tried to run my script, I got this message. What does it mean?
3047
3048 =item What's MakeMaker?
3049
3050 =back
3051
3052 =item AUTHOR AND COPYRIGHT
3053
3054 =back
3055
3056 =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
3057 07:04:25 $)
3058
3059 =over 4
3060
3061 =item DESCRIPTION
3062
3063 =item Data: Numbers
3064
3065 =over 4
3066
3067 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3068 numbers I should be getting (eg, 19.95)?
3069
3070 =item Why isn't my octal data interpreted correctly?
3071
3072 =item Does Perl have a round() function?  What about ceil() and floor()? 
3073 Trig functions?
3074
3075 =item How do I convert between numeric representations?
3076
3077 How do I convert hexadecimal into decimal, How do I convert from decimal to
3078 hexadecimal, How do I convert from octal to decimal, How do I convert from
3079 decimal to octal, How do I convert from binary to decimal, How do I convert
3080 from decimal to binary
3081
3082 =item Why doesn't & work the way I want it to?
3083
3084 =item How do I multiply matrices?
3085
3086 =item How do I perform an operation on a series of integers?
3087
3088 =item How can I output Roman numerals?
3089
3090 =item Why aren't my random numbers random?
3091
3092 =item How do I get a random number between X and Y?
3093
3094 =back
3095
3096 =item Data: Dates
3097
3098 =over 4
3099
3100 =item How do I find the week-of-the-year/day-of-the-year?
3101
3102 =item How do I find the current century or millennium?
3103
3104 =item How can I compare two dates and find the difference?
3105
3106 =item How can I take a string and turn it into epoch seconds?
3107
3108 =item How can I find the Julian Day?
3109
3110 =item How do I find yesterday's date?
3111
3112 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3113
3114 =back
3115
3116 =item Data: Strings
3117
3118 =over 4
3119
3120 =item How do I validate input?
3121
3122 =item How do I unescape a string?
3123
3124 =item How do I remove consecutive pairs of characters?
3125
3126 =item How do I expand function calls in a string?
3127
3128 =item How do I find matching/nesting anything?
3129
3130 =item How do I reverse a string?
3131
3132 =item How do I expand tabs in a string?
3133
3134 =item How do I reformat a paragraph?
3135
3136 =item How can I access/change the first N letters of a string?
3137
3138 =item How do I change the Nth occurrence of something?
3139
3140 =item How can I count the number of occurrences of a substring within a
3141 string?
3142
3143 =item How do I capitalize all the words on one line?
3144
3145 =item How can I split a [character] delimited string except when inside
3146 [character]? (Comma-separated files)
3147
3148 =item How do I strip blank space from the beginning/end of a string?
3149
3150 =item How do I pad a string with blanks or pad a number with zeroes?
3151
3152 =item How do I extract selected columns from a string?
3153
3154 =item How do I find the soundex value of a string?
3155
3156 =item How can I expand variables in text strings?
3157
3158 =item What's wrong with always quoting "$vars"?
3159
3160 =item Why don't my <<HERE documents work?
3161
3162 1. There must be no space after the << part, 2. There (probably) should be
3163 a semicolon at the end, 3. You can't (easily) have any space in front of
3164 the tag
3165
3166 =back
3167
3168 =item Data: Arrays
3169
3170 =over 4
3171
3172 =item What is the difference between a list and an array?
3173
3174 =item What is the difference between $array[1] and @array[1]?
3175
3176 =item How can I remove duplicate elements from a list or array?
3177
3178 a), b), c), d), e)
3179
3180 =item How can I tell whether a certain element is contained in a list or
3181 array?
3182
3183 =item How do I compute the difference of two arrays?  How do I compute the
3184 intersection of two arrays?
3185
3186 =item How do I test whether two arrays or hashes are equal?
3187
3188 =item How do I find the first array element for which a condition is true?
3189
3190 =item How do I handle linked lists?
3191
3192 =item How do I handle circular lists?
3193
3194 =item How do I shuffle an array randomly?
3195
3196 =item How do I process/modify each element of an array?
3197
3198 =item How do I select a random element from an array?
3199
3200 =item How do I permute N elements of a list?
3201
3202 =item How do I sort an array by (anything)?
3203
3204 =item How do I manipulate arrays of bits?
3205
3206 =item Why does defined() return true on empty arrays and hashes?
3207
3208 =back
3209
3210 =item Data: Hashes (Associative Arrays)
3211
3212 =over 4
3213
3214 =item How do I process an entire hash?
3215
3216 =item What happens if I add or remove keys from a hash while iterating over
3217 it?
3218
3219 =item How do I look up a hash element by value?
3220
3221 =item How can I know how many entries are in a hash?
3222
3223 =item How do I sort a hash (optionally by value instead of key)?
3224
3225 =item How can I always keep my hash sorted?
3226
3227 =item What's the difference between "delete" and "undef" with hashes?
3228
3229 =item Why don't my tied hashes make the defined/exists distinction?
3230
3231 =item How do I reset an each() operation part-way through?
3232
3233 =item How can I get the unique keys from two hashes?
3234
3235 =item How can I store a multidimensional array in a DBM file?
3236
3237 =item How can I make my hash remember the order I put elements into it?
3238
3239 =item Why does passing a subroutine an undefined element in a hash create
3240 it?
3241
3242 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3243 array of hashes or arrays?
3244
3245 =item How can I use a reference as a hash key?
3246
3247 =back
3248
3249 =item Data: Misc
3250
3251 =over 4
3252
3253 =item How do I handle binary data correctly?
3254
3255 =item How do I determine whether a scalar is a number/whole/integer/float?
3256
3257 =item How do I keep persistent data across program calls?
3258
3259 =item How do I print out or copy a recursive data structure?
3260
3261 =item How do I define methods for every class/object?
3262
3263 =item How do I verify a credit card checksum?
3264
3265 =item How do I pack arrays of doubles or floats for XS code?
3266
3267 =back
3268
3269 =item AUTHOR AND COPYRIGHT
3270
3271 =back
3272
3273 =head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
3274 07:04:25 $)
3275
3276 =over 4
3277
3278 =item DESCRIPTION
3279
3280 =over 4
3281
3282 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3283
3284 =item How do I change one line in a file/delete a line in a file/insert a
3285 line in the middle of a file/append to the beginning of a file?
3286
3287 =item How do I count the number of lines in a file?
3288
3289 =item How do I make a temporary file name?
3290
3291 =item How can I manipulate fixed-record-length files?
3292
3293 =item How can I make a filehandle local to a subroutine?  How do I pass
3294 filehandles between subroutines?  How do I make an array of filehandles?
3295
3296 =item How can I use a filehandle indirectly?
3297
3298 =item How can I set up a footer format to be used with write()?
3299
3300 =item How can I write() into a string?
3301
3302 =item How can I output my numbers with commas added?
3303
3304 =item How can I translate tildes (~) in a filename?
3305
3306 =item How come when I open a file read-write it wipes it out?
3307
3308 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3309
3310 =item Is there a leak/bug in glob()?
3311
3312 =item How can I open a file with a leading ">" or trailing blanks?
3313
3314 =item How can I reliably rename a file?
3315
3316 =item How can I lock a file?
3317
3318 =item Why can't I just open(FH, ">file.lock")?
3319
3320 =item I still don't get locking.  I just want to increment the number in
3321 the file.  How can I do this?
3322
3323 =item All I want to do is append a small amount of text to the end of a
3324 file.  Do I still have to use locking?
3325
3326 =item How do I randomly update a binary file?
3327
3328 =item How do I get a file's timestamp in perl?
3329
3330 =item How do I set a file's timestamp in perl?
3331
3332 =item How do I print to more than one file at once?
3333
3334 =item How can I read in an entire file all at once?
3335
3336 =item How can I read in a file by paragraphs?
3337
3338 =item How can I read a single character from a file?  From the keyboard?
3339
3340 =item How can I tell whether there's a character waiting on a filehandle?
3341
3342 =item How do I do a C<tail -f> in perl?
3343
3344 =item How do I dup() a filehandle in Perl?
3345
3346 =item How do I close a file descriptor by number?
3347
3348 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3349 `C:\temp\foo.exe` work?
3350
3351 =item Why doesn't glob("*.*") get all the files?
3352
3353 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3354 protected files?  Isn't this a bug in Perl?
3355
3356 =item How do I select a random line from a file?
3357
3358 =item Why do I get weird spaces when I print an array of lines?
3359
3360 =back
3361
3362 =item AUTHOR AND COPYRIGHT
3363
3364 =back
3365
3366 =head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
3367 22:31:09 $)
3368
3369 =over 4
3370
3371 =item DESCRIPTION
3372
3373 =over 4
3374
3375 =item How can I hope to use regular expressions without creating illegible
3376 and unmaintainable code?
3377
3378 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3379
3380 =item I'm having trouble matching over more than one line.  What's wrong?
3381
3382 =item How can I pull out lines between two patterns that are themselves on
3383 different lines?
3384
3385 =item I put a regular expression into $/ but it didn't work. What's wrong?
3386
3387 =item How do I substitute case insensitively on the LHS while preserving
3388 case on the RHS?
3389
3390 =item How can I make C<\w> match national character sets?
3391
3392 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3393
3394 =item How can I quote a variable to use in a regex?
3395
3396 =item What is C</o> really for?
3397
3398 =item How do I use a regular expression to strip C style comments from a
3399 file?
3400
3401 =item Can I use Perl regular expressions to match balanced text?
3402
3403 =item What does it mean that regexes are greedy?  How can I get around it?
3404
3405 =item How do I process each word on each line?
3406
3407 =item How can I print out a word-frequency or line-frequency summary?
3408
3409 =item How can I do approximate matching?
3410
3411 =item How do I efficiently match many regular expressions at once?
3412
3413 =item Why don't word-boundary searches with C<\b> work for me?
3414
3415 =item Why does using $&, $`, or $' slow my program down?
3416
3417 =item What good is C<\G> in a regular expression?
3418
3419 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3420
3421 =item What's wrong with using grep or map in a void context?
3422
3423 =item How can I match strings with multibyte characters?
3424
3425 =item How do I match a pattern that is supplied by the user?
3426
3427 =back
3428
3429 =item AUTHOR AND COPYRIGHT
3430
3431 =back
3432
3433 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3434 2002/03/26 15:48:32 $)
3435
3436 =over 4
3437
3438 =item DESCRIPTION
3439
3440 =over 4
3441
3442 =item Can I get a BNF/yacc/RE for the Perl language?
3443
3444 =item What are all these $@%&* punctuation signs, and how do I know when to
3445 use them?
3446
3447 =item Do I always/never have to quote my strings or use semicolons and
3448 commas?
3449
3450 =item How do I skip some return values?
3451
3452 =item How do I temporarily block warnings?
3453
3454 =item What's an extension?
3455
3456 =item Why do Perl operators have different precedence than C operators?
3457
3458 =item How do I declare/create a structure?
3459
3460 =item How do I create a module?
3461
3462 =item How do I create a class?
3463
3464 =item How can I tell if a variable is tainted?
3465
3466 =item What's a closure?
3467
3468 =item What is variable suicide and how can I prevent it?
3469
3470 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3471 Regex}?
3472
3473 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3474 Passing Methods
3475
3476 =item How do I create a static variable?
3477
3478 =item What's the difference between dynamic and lexical (static) scoping? 
3479 Between local() and my()?
3480
3481 =item How can I access a dynamic variable while a similarly named lexical
3482 is in scope?
3483
3484 =item What's the difference between deep and shallow binding?
3485
3486 =item Why doesn't "my($foo) = <FILE>;" work right?
3487
3488 =item How do I redefine a builtin function, operator, or method?
3489
3490 =item What's the difference between calling a function as &foo and foo()?
3491
3492 =item How do I create a switch or case statement?
3493
3494 =item How can I catch accesses to undefined variables/functions/methods?
3495
3496 =item Why can't a method included in this same file be found?
3497
3498 =item How can I find out my current package?
3499
3500 =item How can I comment out a large block of perl code?
3501
3502 =item How do I clear a package?
3503
3504 =item How can I use a variable as a variable name?
3505
3506 =back
3507
3508 =item AUTHOR AND COPYRIGHT
3509
3510 =back
3511
3512 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3513 12:41:42 $)
3514
3515 =over 4
3516
3517 =item DESCRIPTION
3518
3519 =over 4
3520
3521 =item How do I find out which operating system I'm running under?
3522
3523 =item How come exec() doesn't return?
3524
3525 =item How do I do fancy stuff with the keyboard/screen/mouse?
3526
3527 Keyboard, Screen, Mouse
3528
3529 =item How do I print something out in color?
3530
3531 =item How do I read just one key without waiting for a return key?
3532
3533 =item How do I check whether input is ready on the keyboard?
3534
3535 =item How do I clear the screen?
3536
3537 =item How do I get the screen size?
3538
3539 =item How do I ask the user for a password?
3540
3541 =item How do I read and write the serial port?
3542
3543 lockfiles, open mode, end of line, flushing output, non-blocking input
3544
3545 =item How do I decode encrypted password files?
3546
3547 =item How do I start a process in the background?
3548
3549 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3550
3551 =item How do I trap control characters/signals?
3552
3553 =item How do I modify the shadow password file on a Unix system?
3554
3555 =item How do I set the time and date?
3556
3557 =item How can I sleep() or alarm() for under a second?
3558
3559 =item How can I measure time under a second?
3560
3561 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3562
3563 =item Why doesn't my sockets program work under System V (Solaris)?  What
3564 does the error message "Protocol not supported" mean?
3565
3566 =item How can I call my system's unique C functions from Perl?
3567
3568 =item Where do I get the include files to do ioctl() or syscall()?
3569
3570 =item Why do setuid perl scripts complain about kernel problems?
3571
3572 =item How can I open a pipe both to and from a command?
3573
3574 =item Why can't I get the output of a command with system()?
3575
3576 =item How can I capture STDERR from an external command?
3577
3578 =item Why doesn't open() return an error when a pipe open fails?
3579
3580 =item What's wrong with using backticks in a void context?
3581
3582 =item How can I call backticks without shell processing?
3583
3584 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3585 ^Z on MS-DOS)?
3586
3587 =item How can I convert my shell script to perl?
3588
3589 =item Can I use perl to run a telnet or ftp session?
3590
3591 =item How can I write expect in Perl?
3592
3593 =item Is there a way to hide perl's command line from programs such as
3594 "ps"?
3595
3596 =item I {changed directory, modified my environment} in a perl script.  How
3597 come the change disappeared when I exited the script?  How do I get my
3598 changes to be visible?
3599
3600 Unix
3601
3602 =item How do I close a process's filehandle without waiting for it to
3603 complete?
3604
3605 =item How do I fork a daemon process?
3606
3607 =item How do I find out if I'm running interactively or not?
3608
3609 =item How do I timeout a slow event?
3610
3611 =item How do I set CPU limits?
3612
3613 =item How do I avoid zombies on a Unix system?
3614
3615 =item How do I use an SQL database?
3616
3617 =item How do I make a system() exit on control-C?
3618
3619 =item How do I open a file without blocking?
3620
3621 =item How do I install a module from CPAN?
3622
3623 =item What's the difference between require and use?
3624
3625 =item How do I keep my own module/library directory?
3626
3627 =item How do I add the directory my program lives in to the module/library
3628 search path?
3629
3630 =item How do I add a directory to my include path at runtime?
3631
3632 =item What is socket.ph and where do I get it?
3633
3634 =back
3635
3636 =item AUTHOR AND COPYRIGHT
3637
3638 =back
3639
3640 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3641 $)
3642
3643 =over 4
3644
3645 =item DESCRIPTION
3646
3647 =over 4
3648
3649 =item What is the correct form of response from a CGI script?
3650
3651 =item My CGI script runs from the command line but not the browser.  (500
3652 Server Error)
3653
3654 =item How can I get better error messages from a CGI program?
3655
3656 =item How do I remove HTML from a string?
3657
3658 =item How do I extract URLs?
3659
3660 =item How do I download a file from the user's machine?  How do I open a
3661 file on another machine?
3662
3663 =item How do I make a pop-up menu in HTML?
3664
3665 =item How do I fetch an HTML file?
3666
3667 =item How do I automate an HTML form submission?
3668
3669 =item How do I decode or create those %-encodings on the web?
3670
3671 =item How do I redirect to another page?
3672
3673 =item How do I put a password on my web pages?
3674
3675 =item How do I edit my .htpasswd and .htgroup files with Perl?
3676
3677 =item How do I make sure users can't enter values into a form that cause my
3678 CGI script to do bad things?
3679
3680 =item How do I parse a mail header?
3681
3682 =item How do I decode a CGI form?
3683
3684 =item How do I check a valid mail address?
3685
3686 =item How do I decode a MIME/BASE64 string?
3687
3688 =item How do I return the user's mail address?
3689
3690 =item How do I send mail?
3691
3692 =item How do I use MIME to make an attachment to a mail message?
3693
3694 =item How do I read mail?
3695
3696 =item How do I find out my hostname/domainname/IP address?
3697
3698 =item How do I fetch a news article or the active newsgroups?
3699
3700 =item How do I fetch/put an FTP file?
3701
3702 =item How can I do RPC in Perl?
3703
3704 =back
3705
3706 =item AUTHOR AND COPYRIGHT
3707
3708 =back
3709
3710 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3711
3712 =over 4
3713
3714 =item DESCRIPTION
3715
3716 =over 4
3717
3718 =item Layout
3719
3720 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3721
3722 =back
3723
3724 =item Using The Back Ends
3725
3726 =over 4
3727
3728 =item The Cross Referencing Back End
3729
3730 i, &, s, r
3731
3732 =item The Decompiling Back End
3733
3734 =item The Lint Back End
3735
3736 =item The Simple C Back End
3737
3738 =item The Bytecode Back End
3739
3740 =item The Optimized C Back End
3741
3742 =back
3743
3744 =item Module List for the Compiler Suite
3745
3746 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3747 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3748 B::Stackobj, B::Stash, B::Terse, B::Xref
3749
3750 =item KNOWN PROBLEMS
3751
3752 =item AUTHOR
3753
3754 =back
3755
3756 =head2 perlembed - how to embed perl in your C program
3757
3758 =over 4
3759
3760 =item DESCRIPTION
3761
3762 =over 4
3763
3764 =item PREAMBLE
3765
3766 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3767 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3768
3769 =item ROADMAP
3770
3771 =item Compiling your C program
3772
3773 =item Adding a Perl interpreter to your C program
3774
3775 =item Calling a Perl subroutine from your C program
3776
3777 =item Evaluating a Perl statement from your C program
3778
3779 =item Performing Perl pattern matches and substitutions from your C program
3780
3781 =item Fiddling with the Perl stack from your C program
3782
3783 =item Maintaining a persistent interpreter
3784
3785 =item Execution of END blocks
3786
3787 =item Maintaining multiple interpreter instances
3788
3789 =item Using Perl modules, which themselves use C libraries, from your C
3790 program
3791
3792 =back
3793
3794 =item Embedding Perl under Win32
3795
3796 =item MORAL
3797
3798 =item AUTHOR
3799
3800 =item COPYRIGHT
3801
3802 =back
3803
3804 =head2 perldebguts - Guts of Perl debugging 
3805
3806 =over 4
3807
3808 =item DESCRIPTION
3809
3810 =item Debugger Internals
3811
3812 =over 4
3813
3814 =item Writing Your Own Debugger
3815
3816 =back
3817
3818 =item Frame Listing Output Examples
3819
3820 =item Debugging regular expressions
3821
3822 =over 4
3823
3824 =item Compile-time output
3825
3826 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3827 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3828 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3829 C<anchored(TYPE)>
3830
3831 =item Types of nodes
3832
3833 =item Run-time output
3834
3835 =back
3836
3837 =item Debugging Perl memory usage
3838
3839 =over 4
3840
3841 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3842
3843 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3844 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3845 6144>
3846
3847 =item Example of using B<-DL> switch
3848
3849 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3850
3851 =item B<-DL> details
3852
3853 C<!!!>, C<!!>, C<!>
3854
3855 =item Limitations of B<-DL> statistics
3856
3857 =back
3858
3859 =item SEE ALSO
3860
3861 =back
3862
3863 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3864
3865 =over 4
3866
3867 =item DESCRIPTION
3868
3869 =item SPECIAL NOTES
3870
3871 =over 4
3872
3873 =item make
3874
3875 =item Version caveat
3876
3877 =item Dynamic Loading versus Static Loading
3878
3879 =back
3880
3881 =item TUTORIAL
3882
3883 =over 4
3884
3885 =item EXAMPLE 1
3886
3887 =item EXAMPLE 2
3888
3889 =item What has gone on?
3890
3891 =item Writing good test scripts
3892
3893 =item EXAMPLE 3
3894
3895 =item What's new here?
3896
3897 =item Input and Output Parameters
3898
3899 =item The XSUBPP Program
3900
3901 =item The TYPEMAP file
3902
3903 =item Warning about Output Arguments
3904
3905 =item EXAMPLE 4
3906
3907 =item What has happened here?
3908
3909 =item Anatomy of .xs file
3910
3911 =item Getting the fat out of XSUBs
3912
3913 =item More about XSUB arguments
3914
3915 =item The Argument Stack
3916
3917 =item Extending your Extension
3918
3919 =item Documenting your Extension
3920
3921 =item Installing your Extension
3922
3923 =item EXAMPLE 5
3924
3925 =item New Things in this Example
3926
3927 =item EXAMPLE 6
3928
3929 =item New Things in this Example
3930
3931 =item EXAMPLE 7 (Coming Soon)
3932
3933 =item EXAMPLE 8 (Coming Soon)
3934
3935 =item EXAMPLE 9 Passing open files to XSes
3936
3937 =item Troubleshooting these Examples
3938
3939 =back
3940
3941 =item See also
3942
3943 =item Author
3944
3945 =over 4
3946
3947 =item Last Changed
3948
3949 =back
3950
3951 =back
3952
3953 =head2 perlxs - XS language reference manual
3954
3955 =over 4
3956
3957 =item DESCRIPTION
3958
3959 =over 4
3960
3961 =item Introduction
3962
3963 =item On The Road
3964
3965 =item The Anatomy of an XSUB
3966
3967 =item The Argument Stack
3968
3969 =item The RETVAL Variable
3970
3971 =item The MODULE Keyword
3972
3973 =item The PACKAGE Keyword
3974
3975 =item The PREFIX Keyword
3976
3977 =item The OUTPUT: Keyword
3978
3979 =item The NO_OUTPUT Keyword
3980
3981 =item The CODE: Keyword
3982
3983 =item The INIT: Keyword
3984
3985 =item The NO_INIT Keyword
3986
3987 =item Initializing Function Parameters
3988
3989 =item Default Parameter Values
3990
3991 =item The PREINIT: Keyword
3992
3993 =item The SCOPE: Keyword
3994
3995 =item The INPUT: Keyword
3996
3997 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3998
3999 =item The C<length(NAME)> Keyword
4000
4001 =item Variable-length Parameter Lists
4002
4003 =item The C_ARGS: Keyword
4004
4005 =item The PPCODE: Keyword
4006
4007 =item Returning Undef And Empty Lists
4008
4009 =item The REQUIRE: Keyword
4010
4011 =item The CLEANUP: Keyword
4012
4013 =item The POSTCALL: Keyword
4014
4015 =item The BOOT: Keyword
4016
4017 =item The VERSIONCHECK: Keyword
4018
4019 =item The PROTOTYPES: Keyword
4020
4021 =item The PROTOTYPE: Keyword
4022
4023 =item The ALIAS: Keyword
4024
4025 =item The OVERLOAD: Keyword
4026
4027 =item The INTERFACE: Keyword
4028
4029 =item The INTERFACE_MACRO: Keyword
4030
4031 =item The INCLUDE: Keyword
4032
4033 =item The CASE: Keyword
4034
4035 =item The & Unary Operator
4036
4037 =item Inserting POD, Comments and C Preprocessor Directives
4038
4039 =item Using XS With C++
4040
4041 =item Interface Strategy
4042
4043 =item Perl Objects And C Structures
4044
4045 =item The Typemap
4046
4047 =item Safely Storing Static Data in XS
4048
4049 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4050
4051 =back
4052
4053 =item EXAMPLES
4054
4055 =item XS VERSION
4056
4057 =item AUTHOR
4058
4059 =back
4060
4061 =head2 perlclib - Internal replacements for standard C library functions
4062
4063 =over 4
4064
4065 =item DESCRIPTION
4066
4067 =over 4
4068
4069 =item Conventions
4070
4071 C<t>, C<p>, C<n>, C<s>
4072
4073 =item File Operations
4074
4075 =item File Input and Output
4076
4077 =item File Positioning
4078
4079 =item Memory Management and String Handling
4080
4081 =item Character Class Tests
4082
4083 =item F<stdlib.h> functions
4084
4085 =item Miscellaneous functions
4086
4087 =back
4088
4089 =item SEE ALSO
4090
4091 =back
4092
4093 =head2 perlguts - Introduction to the Perl API
4094
4095 =over 4
4096
4097 =item DESCRIPTION
4098
4099 =item Variables
4100
4101 =over 4
4102
4103 =item Datatypes
4104
4105 =item What is an "IV"?
4106
4107 =item Working with SVs
4108
4109 =item Offsets
4110
4111 =item What's Really Stored in an SV?
4112
4113 =item Working with AVs
4114
4115 =item Working with HVs
4116
4117 =item Hash API Extensions
4118
4119 =item References
4120
4121 =item Blessed References and Class Objects
4122
4123 =item Creating New Variables
4124
4125 GV_ADDMULTI, GV_ADDWARN
4126
4127 =item Reference Counts and Mortality
4128
4129 =item Stashes and Globs
4130
4131 =item Double-Typed SVs
4132
4133 =item Magic Variables
4134
4135 =item Assigning Magic
4136
4137 =item Magic Virtual Tables
4138
4139 =item Finding Magic
4140
4141 =item Understanding the Magic of Tied Hashes and Arrays
4142
4143 =item Localizing changes
4144
4145 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4146 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4147 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4148 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4149 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4150 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4151 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4152 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4153 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4154 save_hptr(HV **hptr)>
4155
4156 =back
4157
4158 =item Subroutines
4159
4160 =over 4
4161
4162 =item XSUBs and the Argument Stack
4163
4164 =item Calling Perl Routines from within C Programs
4165
4166 =item Memory Allocation
4167
4168 =item PerlIO
4169
4170 =item Putting a C value on Perl stack
4171
4172 =item Scratchpads
4173
4174 =item Scratchpads and recursion
4175
4176 =back
4177
4178 =item Compiled code
4179
4180 =over 4
4181
4182 =item Code tree
4183
4184 =item Examining the tree
4185
4186 =item Compile pass 1: check routines
4187
4188 =item Compile pass 1a: constant folding
4189
4190 =item Compile pass 2: context propagation
4191
4192 =item Compile pass 3: peephole optimization
4193
4194 =item Pluggable runops
4195
4196 =back
4197
4198 =item Examining internal data structures with the C<dump> functions
4199
4200 =item How multiple interpreters and concurrency are supported
4201
4202 =over 4
4203
4204 =item Background and PERL_IMPLICIT_CONTEXT
4205
4206 =item So what happened to dTHR?
4207
4208 =item How do I use all this in extensions?
4209
4210 =item Should I do anything special if I call perl from multiple threads?
4211
4212 =item Future Plans and PERL_IMPLICIT_SYS
4213
4214 =back
4215
4216 =item Internal Functions
4217
4218 A, p, d, s, n, r, f, M, o, j, x
4219
4220 =over 4
4221
4222 =item Formatted Printing of IVs, UVs, and NVs
4223
4224 =item Pointer-To-Integer and Integer-To-Pointer
4225
4226 =item Source Documentation
4227
4228 =back
4229
4230 =item Unicode Support
4231
4232 =over 4
4233
4234 =item What B<is> Unicode, anyway?
4235
4236 =item How can I recognise a UTF8 string?
4237
4238 =item How does UTF8 represent Unicode characters?
4239
4240 =item How does Perl store UTF8 strings?
4241
4242 =item How do I convert a string to UTF8?
4243
4244 =item Is there anything else I need to know?
4245
4246 =back
4247
4248 =item Custom Operators
4249
4250 =item AUTHORS
4251
4252 =item SEE ALSO
4253
4254 =back
4255
4256 =head2 perlcall - Perl calling conventions from C
4257
4258 =over 4
4259
4260 =item DESCRIPTION
4261
4262 An Error Handler, An Event Driven Program
4263
4264 =item THE CALL_ FUNCTIONS
4265
4266 call_sv, call_pv, call_method, call_argv
4267
4268 =item FLAG VALUES
4269
4270 =over 4
4271
4272 =item  G_VOID
4273
4274 =item  G_SCALAR
4275
4276 =item G_ARRAY
4277
4278 =item G_DISCARD
4279
4280 =item G_NOARGS
4281
4282 =item G_EVAL
4283
4284 =item G_KEEPERR
4285
4286 =item Determining the Context
4287
4288 =back
4289
4290 =item KNOWN PROBLEMS
4291
4292 =item EXAMPLES
4293
4294 =over 4
4295
4296 =item No Parameters, Nothing returned
4297
4298 =item Passing Parameters
4299
4300 =item Returning a Scalar
4301
4302 =item Returning a list of values
4303
4304 =item Returning a list in a scalar context
4305
4306 =item Returning Data from Perl via the parameter list
4307
4308 =item Using G_EVAL
4309
4310 =item Using G_KEEPERR
4311
4312 =item Using call_sv
4313
4314 =item Using call_argv
4315
4316 =item Using call_method
4317
4318 =item Using GIMME_V
4319
4320 =item Using Perl to dispose of temporaries
4321
4322 =item Strategies for storing Callback Context Information
4323
4324 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4325 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4326 callback
4327
4328 =item Alternate Stack Manipulation
4329
4330 =item Creating and calling an anonymous subroutine in C
4331
4332 =back
4333
4334 =item SEE ALSO
4335
4336 =item AUTHOR
4337
4338 =item DATE
4339
4340 =back
4341
4342 =head2 perlutil - utilities packaged with the Perl distribution
4343
4344 =over 4
4345
4346 =item DESCRIPTION
4347
4348 =over 4
4349
4350 =item DOCUMENTATION
4351
4352 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4353 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4354 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4355 L<roffitall|roffitall>
4356
4357 =item CONVERTORS
4358
4359 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4360
4361 =item Administration
4362
4363 L<libnetcfg|libnetcfg>
4364
4365 =item Development
4366
4367 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4368 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4369
4370 =item SEE ALSO
4371
4372 =back
4373
4374 =back
4375
4376 =head2 perlfilter - Source Filters
4377
4378 =over 4
4379
4380 =item DESCRIPTION
4381
4382 =item CONCEPTS
4383
4384 =item USING FILTERS
4385
4386 =item WRITING A SOURCE FILTER
4387
4388 =item WRITING A SOURCE FILTER IN C
4389
4390 B<Decryption Filters>
4391
4392 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4393
4394 =item WRITING A SOURCE FILTER IN PERL
4395
4396 =item USING CONTEXT: THE DEBUG FILTER
4397
4398 =item CONCLUSION
4399
4400 =item REQUIREMENTS
4401
4402 =item AUTHOR
4403
4404 =item Copyrights
4405
4406 =back
4407
4408 =head2 perldbmfilter - Perl DBM Filters
4409
4410 =over 4
4411
4412 =item SYNOPSIS
4413
4414 =item DESCRIPTION
4415
4416 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4417 B<filter_fetch_value>
4418
4419 =over 4
4420
4421 =item The Filter
4422
4423 =item An Example -- the NULL termination problem.
4424
4425 =item Another Example -- Key is a C int.
4426
4427 =back
4428
4429 =item SEE ALSO
4430
4431 =item AUTHOR
4432
4433 =back
4434
4435 =head2 perlapi - autogenerated documentation for the perl public API
4436
4437 =over 4
4438
4439 =item DESCRIPTION
4440
4441 =item "Gimme" Values
4442
4443 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4444
4445 =item Array Manipulation Functions
4446
4447 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4448 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4449 get_av, newAV, Nullav, sortsv
4450
4451 =item Callback Functions
4452
4453 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4454 FREETMPS, LEAVE, SAVETMPS
4455
4456 =item Character classes
4457
4458 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4459
4460 =item Cloning an interpreter
4461
4462 perl_clone
4463
4464 =item CV Manipulation Functions
4465
4466 CvSTASH, get_cv, Nullcv
4467
4468 =item Embedding Functions
4469
4470 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4471 perl_free, perl_parse, perl_run, require_pv
4472
4473 =item Functions in file pp_pack.c
4474
4475 pack_cat, unpack_str
4476
4477 =item Global Variables
4478
4479 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4480
4481 =item GV Functions
4482
4483 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4484 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4485
4486 =item Handy Values
4487
4488 HEf_SVKEY, Nullch, Nullsv
4489
4490 =item Hash Manipulation Functions
4491
4492 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4493 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4494 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4495 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4496 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4497
4498 =item Magical Functions
4499
4500 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4501 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4502 SvSetSV, SvSetSV_nosteal, SvSHARE
4503
4504 =item Memory Management
4505
4506 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4507 savepv, savepvn, savesharedpv, StructCopy, Zero
4508
4509 =item Miscellaneous Functions
4510
4511 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4512 strNE, strnEQ, strnNE
4513
4514 =item Numeric functions
4515
4516 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4517 scan_hex, scan_oct
4518
4519 =item Optree Manipulation Functions
4520
4521 cv_const_sv, newCONSTSUB, newXS
4522
4523 =item Stack Manipulation Macros
4524
4525 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4526 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4527 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4528 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4529 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4530
4531 =item SV Flags
4532
4533 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4534
4535 =item SV Manipulation Functions
4536
4537 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4538 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4539 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4540 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4541 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4542 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4543 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4544 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4545 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4546 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4547 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4548 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4549 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4550 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4551 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4552 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4553 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4554 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4555 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4556 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4557 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4558 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4559 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4560 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4561 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4562 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4563 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4564 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4565 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4566 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4567 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4568 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4569 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4570
4571 =item Unicode Support
4572
4573 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4574 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4575 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4576 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4577 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4578
4579 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4580
4581 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4582 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4583
4584 =item Warning and Dieing
4585
4586 croak, warn
4587
4588 =item AUTHORS
4589
4590 =item SEE ALSO
4591
4592 =back
4593
4594 =head2 perlintern - autogenerated documentation of purely B<internal>
4595                  Perl functions
4596
4597 =over 4
4598
4599 =item DESCRIPTION
4600
4601 =item Global Variables
4602
4603 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4604 PL_rs
4605
4606 =item GV Functions
4607
4608 is_gv_magical
4609
4610 =item IO Functions
4611
4612 start_glob
4613
4614 =item Pad Data Structures
4615
4616 CvPADLIST
4617
4618 =item Stack Manipulation Macros
4619
4620 djSP, LVRET
4621
4622 =item SV Manipulation Functions
4623
4624 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4625
4626 =item AUTHORS
4627
4628 =item SEE ALSO
4629
4630 =back
4631
4632 =head2 perliol - C API for Perl's implementation of IO in Layers.
4633
4634 =over 4
4635
4636 =item SYNOPSIS
4637
4638 =item DESCRIPTION
4639
4640 =over 4
4641
4642 =item History and Background
4643
4644 =item Layers vs Disciplines
4645
4646 =item Data Structures
4647
4648 =item Functions and Attributes
4649
4650 =item Per-instance Data
4651
4652 =item Layers in action.
4653
4654 =item Per-instance flag bits
4655
4656 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4657 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4658 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4659 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4660
4661 =item Methods in Detail
4662
4663 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4664 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4665 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4666 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4667 Set_ptrcnt
4668
4669 =item Core Layers
4670
4671 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4672
4673 =item Extension Layers
4674
4675 ":encoding", ":scalar", ":via"
4676
4677 =back
4678
4679 =item TODO
4680
4681 =back
4682
4683 =head2 perlapio - perl's IO abstraction interface.
4684
4685 =over 4
4686
4687 =item SYNOPSIS
4688
4689 =item DESCRIPTION
4690
4691 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4692 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4693 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4694 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4695 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4696 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4697 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4698 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4699 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4700 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4701 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4702
4703 =over 4
4704
4705 =item Co-existence with stdio
4706
4707 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4708 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4709
4710 =item "Fast gets" Functions
4711
4712 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4713 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4714 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4715 B<PerlIO_get_bufsiz(f)>
4716
4717 =item Other Functions
4718
4719 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4720 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4721
4722 =back
4723
4724 =back
4725
4726 =head2 perltodo - Perl TO-DO List
4727
4728 =over 4
4729
4730 =item DESCRIPTION
4731
4732 =item To do during 5.6.x
4733
4734 =over 4
4735
4736 =item Support for I/O disciplines
4737
4738 =item Autoload bytes.pm
4739
4740 =item Make "\u{XXXX}" et al work
4741
4742 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4743
4744 =item Overloadable regex assertions
4745
4746 =item Unicode
4747
4748 =item Work out exit/die semantics for threads
4749
4750 =item Better support for nonpreemptive threading systems like GNU pth
4751
4752 =item Typed lexicals for compiler
4753
4754 =item Compiler workarounds for Win32
4755
4756 =item AUTOLOADing in the compiler
4757
4758 =item Fixing comppadlist when compiling
4759
4760 =item Cleaning up exported namespace
4761
4762 =item Complete signal handling
4763
4764 =item Out-of-source builds
4765
4766 =item POSIX realtime support
4767
4768 =item UNIX98 support
4769
4770 =item IPv6 Support
4771
4772 =item Long double conversion
4773
4774 =item Locales
4775
4776 =item Arithmetic on non-Arabic numerals
4777
4778 =item POSIX Unicode character classes
4779
4780 =item Factoring out common suffices/prefices in regexps (trie optimization)
4781
4782 =item Security audit shipped utilities
4783
4784 =item Sort out the uid-setting mess
4785
4786 =item Custom opcodes
4787
4788 =item DLL Versioning
4789
4790 =item Introduce @( and @)
4791
4792 =item Floating point handling
4793
4794 =item IV/UV preservation
4795
4796 =item Replace pod2html with something using Pod::Parser
4797
4798 =item Automate module testing on CPAN
4799
4800 =item sendmsg and recvmsg
4801
4802 =item Rewrite perlre documentation
4803
4804 =item Convert example code to IO::Handle filehandles
4805
4806 =item Document Win32 choices
4807
4808 =item Check new modules
4809
4810 =item Make roffitall find pods and libs itself
4811
4812 =back
4813
4814 =item To do at some point
4815
4816 =over 4
4817
4818 =item Remove regular expression recursion
4819
4820 =item Memory leaks after failed eval
4821
4822 =item bitfields in pack
4823
4824 =item Cross compilation
4825
4826 =item Perl preprocessor / macros
4827
4828 =item Perl lexer in Perl
4829
4830 =item Using POSIX calls internally
4831
4832 =item -i rename file when changed
4833
4834 =item All ARGV input should act like E<lt>E<gt>
4835
4836 =item Support for rerunning debugger
4837
4838 =item Test Suite for the Debugger
4839
4840 =item my sub foo { }
4841
4842 =item One-pass global destruction
4843
4844 =item Rewrite regexp parser
4845
4846 =item Cache recently used regexps
4847
4848 =item Cross-compilation support
4849
4850 =item Bit-shifting bitvectors
4851
4852 =item debugger pragma
4853
4854 =item use less pragma
4855
4856 =item switch structures
4857
4858 =item Cache eval tree
4859
4860 =item rcatmaybe
4861
4862 =item Shrink opcode tables
4863
4864 =item Optimize away @_
4865
4866 =item Prototypes versus indirect objects
4867
4868 =item Install HTML
4869
4870 =item Prototype method calls
4871
4872 =item Return context prototype declarations
4873
4874 =item magic_setisa
4875
4876 =item Garbage collection
4877
4878 =item IO tutorial
4879
4880 =item Rewrite perldoc
4881
4882 =item Install .3p manpages
4883
4884 =item Unicode tutorial
4885
4886 =item Update POSIX.pm for 1003.1-2
4887
4888 =item Retargetable installation
4889
4890 =item POSIX emulation on non-POSIX systems
4891
4892 =item Rename Win32 headers
4893
4894 =item Finish off lvalue functions
4895
4896 =item Update sprintf documentation
4897
4898 =item Use fchown/fchmod internally
4899
4900 =item Make v-strings overloaded objects
4901
4902 =item Allow restricted hash assignment
4903
4904 =item Should overload be inheritable?
4905
4906 =item Taint rethink
4907
4908 =back
4909
4910 =item Vague ideas
4911
4912 =over 4
4913
4914 =item ref() in list context
4915
4916 =item Make tr/// return histogram of characters in list context
4917
4918 =item Compile to real threaded code
4919
4920 =item Structured types
4921
4922 =item Modifiable $1 et al.
4923
4924 =item Procedural interfaces for IO::*, etc.
4925
4926 =item RPC modules
4927
4928 =item Attach/detach debugger from running program
4929
4930 =item GUI::Native
4931
4932 =item foreach(reverse ...)
4933
4934 =item Constant function cache
4935
4936 =item Approximate regular expression matching
4937
4938 =back
4939
4940 =item Ongoing
4941
4942 =over 4
4943
4944 =item Update guts documentation
4945
4946 =item Add more tests
4947
4948 =item Update auxiliary tools
4949
4950 =item Create debugging macros
4951
4952 =item truncate to the people
4953
4954 =item Unicode in Filenames
4955
4956 =back
4957
4958 =item Recently done things
4959
4960 =over 4
4961
4962 =item Alternative RE syntax module
4963
4964 =item Safe signal handling
4965
4966 =item Tie Modules
4967
4968 =item gettimeofday
4969
4970 =item setitimer and getimiter
4971
4972 =item Testing __DIE__ hook
4973
4974 =item CPP equivalent in Perl
4975
4976 =item Explicit switch statements
4977
4978 =item autocroak
4979
4980 =item UTF/EBCDIC
4981
4982 =item UTF Regexes
4983
4984 =item perlcc to produce executable
4985
4986 =item END blocks saved in compiled output
4987
4988 =item Secure temporary file module
4989
4990 =item Integrate Time::HiRes
4991
4992 =item Turn Cwd into XS
4993
4994 =item Mmap for input
4995
4996 =item Byte to/from UTF8 and UTF8 to/from local conversion
4997
4998 =item Add sockatmark support
4999
5000 =item Mailing list archives
5001
5002 =item Bug tracking
5003
5004 =item Integrate MacPerl
5005
5006 =item Web "nerve center" for Perl
5007
5008 =item Regular expression tutorial
5009
5010 =item Debugging Tutorial
5011
5012 =item Integrate new modules
5013
5014 =item Integrate profiler
5015
5016 =item Y2K error detection
5017
5018 =item Regular expression debugger
5019
5020 =item POD checker
5021
5022 =item "Dynamic" lexicals
5023
5024 =item Cache precompiled modules
5025
5026 =back
5027
5028 =item Deprecated Wishes
5029
5030 =over 4
5031
5032 =item Loop control on do{}
5033
5034 =item Lexically scoped typeglobs
5035
5036 =item format BOTTOM
5037
5038 =item report HANDLE
5039
5040 =item Generalised want()/caller())
5041
5042 =item Named prototypes
5043
5044 =item Built-in globbing
5045
5046 =item Regression tests for suidperl
5047
5048 =item Cached hash values
5049
5050 =item Add compression modules
5051
5052 =item Reorganise documentation into tutorials/references
5053
5054 =item Remove distinction between functions and operators
5055
5056 =item Make XS easier to use
5057
5058 =item Make embedding easier to use
5059
5060 =item man for perl
5061
5062 =item my $Package::variable
5063
5064 =item "or" tests defined, not truth
5065
5066 =item "class"-based lexicals
5067
5068 =item byteperl
5069
5070 =item Lazy evaluation / tail recursion removal
5071
5072 =item Make "use utf8" the default
5073
5074 =item Unicode collation and normalization
5075
5076 =item pack/unpack tutorial
5077
5078 =back
5079
5080 =back
5081
5082 =head2 perlhack - How to hack at the Perl internals
5083
5084 =over 4
5085
5086 =item DESCRIPTION
5087
5088 Does concept match the general goals of Perl?, Where is the
5089 implementation?, Backwards compatibility, Could it be a module instead?, Is
5090 the feature generic enough?, Does it potentially introduce new bugs?, Does
5091 it preclude other desirable features?, Is the implementation robust?, Is
5092 the implementation generic enough to be portable?, Is the implementation
5093 tested?, Is there enough documentation?, Is there another way to do it?,
5094 Does it create too much work?, Patches speak louder than words
5095
5096 =over 4
5097
5098 =item Keeping in sync
5099
5100 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5101 NFS, rsync'ing the patches
5102
5103 =item Why rsync the source tree
5104
5105 It's easier to rsync the source tree, It's more reliable
5106
5107 =item Why rsync the patches
5108
5109 It's easier to rsync the patches, It's a good reference, Finding a start
5110 point, Finding how to fix a bug, Finding the source of misbehaviour
5111
5112 =item Perlbug remote interface
5113
5114 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5115 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5116
5117 =item Submitting patches
5118
5119 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5120 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5121
5122 =item Finding Your Way Around
5123
5124 Core modules, Tests, Documentation, Configure, Interpreter
5125
5126 =item Elements of the interpreter
5127
5128 Startup, Parsing, Optimization, Running
5129
5130 =item Internal Variable Types
5131
5132 =item Op Trees
5133
5134 =item Stacks
5135
5136 Argument stack, Mark stack, Save stack
5137
5138 =item Millions of Macros
5139
5140 =item Poking at Perl
5141
5142 =item Using a source-level debugger
5143
5144 run [args], break function_name, break source.c:xxx, step, next, continue,
5145 finish, 'enter', print
5146
5147 =item Dumping Perl Data Structures
5148
5149 =item Patching
5150
5151 =item Patching a core module
5152
5153 =item Adding a new function to the core
5154
5155 =item Writing a test
5156
5157 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5158 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5159
5160 =item Special Make Test Targets
5161
5162 coretest, test.deparse, minitest, test.third check.third utest.third
5163 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5164
5165 =back
5166
5167 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5168
5169 =over 4
5170
5171 =item Rational Software's Purify
5172
5173 =item Purify on Unix
5174
5175 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5176
5177 =item Purify on NT
5178
5179 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5180
5181 =item Compaq's/Digital's/HP's Third Degree
5182
5183 =item PERL_DESTRUCT_LEVEL
5184
5185 =item Profiling
5186
5187 =item Gprof Profiling
5188
5189 -a, -b, -e routine, -f routine, -s, -z
5190
5191 =item GCC gcov Profiling
5192
5193 =item Pixie Profiling
5194
5195 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5196 -z[ero]
5197
5198 =item Miscellaneous tricks
5199
5200 =item CONCLUSION
5201
5202 I<The Road goes ever on and on, down from the door where it began.>
5203
5204 =back
5205
5206 =item AUTHOR
5207
5208 =back
5209
5210 =head2 perlhist - the Perl history records
5211
5212 =over 4
5213
5214 =item DESCRIPTION
5215
5216 =item INTRODUCTION
5217
5218 =item THE KEEPERS OF THE PUMPKIN
5219
5220 =over 4
5221
5222 =item PUMPKIN?
5223
5224 =back
5225
5226 =item THE RECORDS
5227
5228 =over 4
5229
5230 =item SELECTED RELEASE SIZES
5231
5232 =item SELECTED PATCH SIZES
5233
5234 =back
5235
5236 =item THE KEEPERS OF THE RECORDS
5237
5238 =back
5239
5240 =head2 perldelta - what is new for perl v5.8.0
5241
5242 =over 4
5243
5244 =item DESCRIPTION
5245
5246 =item Highlights In 5.8.0
5247
5248 =item Incompatible Changes
5249
5250 =over 4
5251
5252 =item Binary Incompatibility
5253
5254 =item 64-bit platforms and malloc
5255
5256 =item AIX Dynaloading
5257
5258 =item Attributes for C<my> variables now handled at run-time.
5259
5260 =item Socket Extension Dynamic in VMS
5261
5262 =item IEEE-format Floating Point Default on OpenVMS Alpha
5263
5264 =item New Unicode Properties
5265
5266 =item REF(...) Instead Of SCALAR(...)
5267
5268 =item pack/unpack D/F recycled
5269
5270 =item Deprecations
5271
5272 =back
5273
5274 =item Core Enhancements
5275
5276 =over 4
5277
5278 =item PerlIO is Now The Default
5279
5280 =item Restricted Hashes
5281
5282 =item Safe Signals
5283
5284 =item Unicode Overhaul
5285
5286 =item Understanding of Numbers
5287
5288 =item Arrays now always interpolate into double-quoted strings [561]
5289
5290 =item Miscellaneous Changes
5291
5292 =back
5293
5294 =item Modules and Pragmata
5295
5296 =over 4
5297
5298 =item New Modules and Pragmata
5299
5300 =item Updated And Improved Modules and Pragmata
5301
5302 =back
5303
5304 =item Utility Changes
5305
5306 =item New Documentation
5307
5308 =item Performance Enhancements
5309
5310 =item Installation and Configuration Improvements
5311
5312 =over 4
5313
5314 =item Generic Improvements
5315
5316 =item New Or Improved Platforms
5317
5318 =back
5319
5320 =item Selected Bug Fixes
5321
5322 =over 4
5323
5324 =item Platform Specific Changes and Fixes
5325
5326 =back
5327
5328 =item New or Changed Diagnostics
5329
5330 =item Changed Internals
5331
5332 =item Security Vulnerability Closed [561]
5333
5334 =item New Tests
5335
5336 =item Known Problems
5337
5338 =over 4
5339
5340 =item AIX
5341
5342 =item Alpha systems with old gccs fail several tests
5343
5344 =item AmigaOS
5345
5346 =item BeOS
5347
5348 =item Cygwin "unable to remap"
5349
5350 =item Cygwin ndbm tests fail on FAT
5351
5352 =item ext/threads/t/libc
5353
5354 =item FreeBSD built with ithreads coredumps reading large directories
5355
5356 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5357
5358 =item IRIX fails ext/List/Util/t/shuffle.t
5359
5360 =item Modifying $_ Inside for(..)
5361
5362 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5363
5364 =item lib/ftmp-security tests warn 'system possibly insecure'
5365
5366 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5367
5368 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5369
5370 =item Linux With Sfio Fails op/misc Test 48
5371
5372 =item libwww-perl (LWP) fails base/date #51
5373
5374 =item Mac OS X
5375
5376 =item OS/2 Test Failures
5377
5378 =item op/sprintf tests 91, 129, and 130
5379
5380 =item Solaris 2.5
5381
5382 =item Solaris x86 Fails Tests With -Duse64bitint
5383
5384 =item SUPER-UX (NEC SX)
5385
5386 =item PDL failing some tests
5387
5388 =item Term::ReadKey not working on Win32
5389
5390 =item Failure of Thread (5.005-style) tests
5391
5392 =item Timing problems
5393
5394 =item Unicode in package/class and subroutine names does not work
5395
5396 =item UNICOS/mk
5397
5398 =item UTS
5399
5400 =item VOS (Stratus)
5401
5402 =item VMS
5403
5404 =item Win32
5405
5406 =item XML::Parser not working
5407
5408 =item z/OS (OS/390)
5409
5410 =item Localising Tied Arrays and Hashes Is Broken
5411
5412 =item Self-tying Problems
5413
5414 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5415
5416 =item Building Extensions Can Fail Because Of Largefiles
5417
5418 =item Unicode Support on EBCDIC Still Spotty
5419
5420 =item The Compiler Suite Is Still Very Experimental
5421
5422 =item The Long Double Support Is Still Experimental
5423
5424 =item Seen In Perl 5.7 But Gone Now
5425
5426 =back
5427
5428 =item Reporting Bugs
5429
5430 =item SEE ALSO
5431
5432 =item HISTORY
5433
5434 =back
5435
5436 =head2 perl572delta - what's new for perl v5.7.2
5437
5438 =over 4
5439
5440 =item DESCRIPTION
5441
5442 =item Security Vulnerability Closed
5443
5444 =item Incompatible Changes
5445
5446 =over 4
5447
5448 =item 64-bit platforms and malloc
5449
5450 =item AIX Dynaloading
5451
5452 =item Socket Extension Dynamic in VMS
5453
5454 =item Different Definition of the Unicode Character Classes \p{In...}
5455
5456 =item Deprecations
5457
5458 =back
5459
5460 =item Core Enhancements
5461
5462 =item Modules and Pragmata
5463
5464 =over 4
5465
5466 =item New Modules and Distributions
5467
5468 =item Updated And Improved Modules and Pragmata
5469
5470 =back
5471
5472 =item Utility Changes
5473
5474 =item New Documentation
5475
5476 =item Installation and Configuration Improvements
5477
5478 =over 4
5479
5480 =item New Or Improved Platforms
5481
5482 =item Generic Improvements
5483
5484 =back
5485
5486 =item Selected Bug Fixes
5487
5488 =over 4
5489
5490 =item Platform Specific Changes and Fixes
5491
5492 =back
5493
5494 =item New or Changed Diagnostics
5495
5496 =item Source Code Enhancements
5497
5498 =over 4
5499
5500 =item MAGIC constants
5501
5502 =item Better commented code
5503
5504 =item Regex pre-/post-compilation items matched up
5505
5506 =item gcc -Wall
5507
5508 =back
5509
5510 =item New Tests
5511
5512 =item Known Problems
5513
5514 =over 4
5515
5516 =item AIX
5517
5518 =item Amiga Perl Invoking Mystery
5519
5520 =item lib/ftmp-security tests warn 'system possibly insecure'
5521
5522 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5523
5524 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5525
5526 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5527
5528 =item Linux With Sfio Fails op/misc Test 48
5529
5530 =item OS/390
5531
5532 =item op/sprintf tests 129 and 130
5533
5534 =item  Failure of Thread tests
5535
5536 =item UNICOS
5537
5538 =item UTS
5539
5540 =item VMS
5541
5542 =item Win32
5543
5544 =item Localising a Tied Variable Leaks Memory
5545
5546 =item Self-tying of Arrays and Hashes Is Forbidden
5547
5548 =item Variable Attributes are not Currently Usable for Tieing
5549
5550 =item Building Extensions Can Fail Because Of Largefiles
5551
5552 =item The Compiler Suite Is Still Experimental
5553
5554 =item The Long Double Support is Still Experimental
5555
5556 =back
5557
5558 =item Reporting Bugs
5559
5560 =item SEE ALSO
5561
5562 =item HISTORY
5563
5564 =back
5565
5566 =head2 perl571delta - what's new for perl v5.7.1
5567
5568 =over 4
5569
5570 =item DESCRIPTION
5571
5572 =item Security Vulnerability Closed
5573
5574 =item Incompatible Changes
5575
5576 =item Core Enhancements
5577
5578 =over 4
5579
5580 =item AUTOLOAD Is Now Lvaluable
5581
5582 =item PerlIO is Now The Default
5583
5584 =item Signals Are Now Safe
5585
5586 =back
5587
5588 =item Modules and Pragmata
5589
5590 =over 4
5591
5592 =item New Modules
5593
5594 =item Updated And Improved Modules and Pragmata
5595
5596 =back
5597
5598 =item Performance Enhancements
5599
5600 =item Utility Changes
5601
5602 =item New Documentation
5603
5604 =over 4
5605
5606 =item perlclib
5607
5608 =item perliol
5609
5610 =item README.aix
5611
5612 =item README.bs2000
5613
5614 =item README.macos
5615
5616 =item README.mpeix
5617
5618 =item README.solaris
5619
5620 =item README.vos
5621
5622 =item Porting/repository.pod
5623
5624 =back
5625
5626 =item Installation and Configuration Improvements
5627
5628 =over 4
5629
5630 =item New Or Improved Platforms
5631
5632 =item Generic Improvements
5633
5634 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5635 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5636 d_strtoq, d_u32align, d_ualarm, d_usleep
5637
5638 =back
5639
5640 =item Selected Bug Fixes
5641
5642 =over 4
5643
5644 =item Platform Specific Changes and Fixes
5645
5646 =back
5647
5648 =item New or Changed Diagnostics
5649
5650 =item Changed Internals
5651
5652 =item New Tests
5653
5654 =item Known Problems
5655
5656 =over 4
5657
5658 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5659
5660 =item lib/ftmp-security tests warn 'system possibly insecure'
5661
5662 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5663
5664 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5665
5666 =item lib/b test 19
5667
5668 =item Linux With Sfio Fails op/misc Test 48
5669
5670 =item sigaction test 13 in VMS
5671
5672 =item sprintf tests 129 and 130
5673
5674 =item  Failure of Thread tests
5675
5676 =item Localising a Tied Variable Leaks Memory
5677
5678 =item Self-tying of Arrays and Hashes Is Forbidden
5679
5680 =item Building Extensions Can Fail Because Of Largefiles
5681
5682 =item The Compiler Suite Is Still Experimental
5683
5684 =back
5685
5686 =item Reporting Bugs
5687
5688 =item SEE ALSO
5689
5690 =item HISTORY
5691
5692 =back
5693
5694 =head2 perl570delta - what's new for perl v5.7.0
5695
5696 =over 4
5697
5698 =item DESCRIPTION
5699
5700 =item Security Vulnerability Closed
5701
5702 =item Incompatible Changes
5703
5704 =item Core Enhancements
5705
5706 =item Modules and Pragmata
5707
5708 =over 4
5709
5710 =item New Modules
5711
5712 =item Updated And Improved Modules and Pragmata
5713
5714 =back
5715
5716 =item Utility Changes
5717
5718 =item New Documentation
5719
5720 =item Performance Enhancements
5721
5722 =item Installation and Configuration Improvements
5723
5724 =over 4
5725
5726 =item Generic Improvements
5727
5728 =back
5729
5730 =item Selected Bug Fixes
5731
5732 =over 4
5733
5734 =item Platform Specific Changes and Fixes
5735
5736 =back
5737
5738 =item New or Changed Diagnostics
5739
5740 =item Changed Internals
5741
5742 =item Known Problems
5743
5744 =over 4
5745
5746 =item Unicode Support Still Far From Perfect
5747
5748 =item EBCDIC Still A Lost Platform
5749
5750 =item Building Extensions Can Fail Because Of Largefiles
5751
5752 =item ftmp-security tests warn 'system possibly insecure'
5753
5754 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5755
5756 =item Long Doubles Still Don't Work In Solaris
5757
5758 =item Linux With Sfio Fails op/misc Test 48
5759
5760 =item Storable tests fail in some platforms
5761
5762 =item Threads Are Still Experimental
5763
5764 =item The Compiler Suite Is Still Experimental
5765
5766 =back
5767
5768 =item Reporting Bugs
5769
5770 =item SEE ALSO
5771
5772 =item HISTORY
5773
5774 =back
5775
5776 =head2 perl561delta - what's new for perl v5.6.x
5777
5778 =over 4
5779
5780 =item DESCRIPTION
5781
5782 =item Summary of changes between 5.6.0 and 5.6.1
5783
5784 =over 4
5785
5786 =item Security Issues
5787
5788 =item Core bug fixes
5789
5790 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5791 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5792 references to special variables, Lexical warnings, Spurious warnings and
5793 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5794 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5795 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5796 Module;>, Tests
5797
5798 =item Core features
5799
5800 =item Configuration issues
5801
5802 =item Documentation
5803
5804 =item Bundled modules
5805
5806 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5807 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5808 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5809 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5810
5811 =item Platform-specific improvements
5812
5813 NCR MP-RAS, NonStop-UX
5814
5815 =back
5816
5817 =item Core Enhancements
5818
5819 =over 4
5820
5821 =item Interpreter cloning, threads, and concurrency
5822
5823 =item Lexically scoped warning categories
5824
5825 =item Unicode and UTF-8 support
5826
5827 =item Support for interpolating named characters
5828
5829 =item "our" declarations
5830
5831 =item Support for strings represented as a vector of ordinals
5832
5833 =item Improved Perl version numbering system
5834
5835 =item New syntax for declaring subroutine attributes
5836
5837 =item File and directory handles can be autovivified
5838
5839 =item open() with more than two arguments
5840
5841 =item 64-bit support
5842
5843 =item Large file support
5844
5845 =item Long doubles
5846
5847 =item "more bits"
5848
5849 =item Enhanced support for sort() subroutines
5850
5851 =item C<sort $coderef @foo> allowed
5852
5853 =item File globbing implemented internally
5854
5855 =item Support for CHECK blocks
5856
5857 =item POSIX character class syntax [: :] supported
5858
5859 =item Better pseudo-random number generator
5860
5861 =item Improved C<qw//> operator
5862
5863 =item Better worst-case behavior of hashes
5864
5865 =item pack() format 'Z' supported
5866
5867 =item pack() format modifier '!' supported
5868
5869 =item pack() and unpack() support counted strings
5870
5871 =item Comments in pack() templates
5872
5873 =item Weak references
5874
5875 =item Binary numbers supported
5876
5877 =item Lvalue subroutines
5878
5879 =item Some arrows may be omitted in calls through references
5880
5881 =item Boolean assignment operators are legal lvalues
5882
5883 =item exists() is supported on subroutine names
5884
5885 =item exists() and delete() are supported on array elements
5886
5887 =item Pseudo-hashes work better
5888
5889 =item Automatic flushing of output buffers
5890
5891 =item Better diagnostics on meaningless filehandle operations
5892
5893 =item Where possible, buffered data discarded from duped input filehandle
5894
5895 =item eof() has the same old magic as <>
5896
5897 =item binmode() can be used to set :crlf and :raw modes
5898
5899 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5900
5901 =item system(), backticks and pipe open now reflect exec() failure
5902
5903 =item Improved diagnostics
5904
5905 =item Diagnostics follow STDERR
5906
5907 =item More consistent close-on-exec behavior
5908
5909 =item syswrite() ease-of-use
5910
5911 =item Better syntax checks on parenthesized unary operators
5912
5913 =item Bit operators support full native integer width
5914
5915 =item Improved security features
5916
5917 =item More functional bareword prototype (*)
5918
5919 =item C<require> and C<do> may be overridden
5920
5921 =item $^X variables may now have names longer than one character
5922
5923 =item New variable $^C reflects C<-c> switch
5924
5925 =item New variable $^V contains Perl version as a string
5926
5927 =item Optional Y2K warnings
5928
5929 =item Arrays now always interpolate into double-quoted strings
5930
5931 =back
5932
5933 =item Modules and Pragmata
5934
5935 =over 4
5936
5937 =item Modules
5938
5939 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5940 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5941 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5942 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5943 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5944 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5945 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5946 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5947
5948 =item Pragmata
5949
5950 =back
5951
5952 =item Utility Changes
5953
5954 =over 4
5955
5956 =item dprofpp
5957
5958 =item find2perl
5959
5960 =item h2xs
5961
5962 =item perlcc
5963
5964 =item perldoc
5965
5966 =item The Perl Debugger
5967
5968 =back
5969
5970 =item Improved Documentation
5971
5972 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5973 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5974 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5975 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5976
5977 =item Performance enhancements
5978
5979 =over 4
5980
5981 =item Simple sort() using { $a <=> $b } and the like are optimized
5982
5983 =item Optimized assignments to lexical variables
5984
5985 =item Faster subroutine calls
5986
5987 =item delete(), each(), values() and hash iteration are faster
5988
5989 =back
5990
5991 =item Installation and Configuration Improvements
5992
5993 =over 4
5994
5995 =item -Dusethreads means something different
5996
5997 =item New Configure flags
5998
5999 =item Threadedness and 64-bitness now more daring
6000
6001 =item Long Doubles
6002
6003 =item -Dusemorebits
6004
6005 =item -Duselargefiles
6006
6007 =item installusrbinperl
6008
6009 =item SOCKS support
6010
6011 =item C<-A> flag
6012
6013 =item Enhanced Installation Directories
6014
6015 =item gcc automatically tried if 'cc' does not seem to be working
6016
6017 =back
6018
6019 =item Platform specific changes
6020
6021 =over 4
6022
6023 =item Supported platforms
6024
6025 =item DOS
6026
6027 =item OS390 (OpenEdition MVS)
6028
6029 =item VMS
6030
6031 =item Win32
6032
6033 =back
6034
6035 =item Significant bug fixes
6036
6037 =over 4
6038
6039 =item <HANDLE> on empty files
6040
6041 =item C<eval '...'> improvements
6042
6043 =item All compilation errors are true errors
6044
6045 =item Implicitly closed filehandles are safer
6046
6047 =item Behavior of list slices is more consistent
6048
6049 =item C<(\$)> prototype and C<$foo{a}>
6050
6051 =item C<goto &sub> and AUTOLOAD
6052
6053 =item C<-bareword> allowed under C<use integer>
6054
6055 =item Failures in DESTROY()
6056
6057 =item Locale bugs fixed
6058
6059 =item Memory leaks
6060
6061 =item Spurious subroutine stubs after failed subroutine calls
6062
6063 =item Taint failures under C<-U>
6064
6065 =item END blocks and the C<-c> switch
6066
6067 =item Potential to leak DATA filehandles
6068
6069 =back
6070
6071 =item New or Changed Diagnostics
6072
6073 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6074 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6075 / cannot take a count, / must be followed by a, A or Z, / must be followed
6076 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6077 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6078 passed through, /%s/ should probably be written as "%s", %s() called too
6079 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6080 argument is not a HASH or ARRAY element or slice, %s argument is not a
6081 subroutine name, %s package attribute may clash with future reserved word:
6082 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6083 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6084 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6085 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6086 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6087 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6088 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6089 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6090 weaken a nonreference, Character class [:%s:] unknown, Character class
6091 syntax [%s] belongs inside character classes, Constant is not %s reference,
6092 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6093 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6094 "local" instead of "our"?), Document contains no data, entering effective
6095 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6096 output, flock() on closed filehandle %s, Global symbol "%s" requires
6097 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6098 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6099 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6100 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6101 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6102 separator character %s in attribute list, Invalid separator character %s in
6103 subroutine attribute list, leaving effective %s failed, Lvalue subs
6104 returning %s not implemented yet, Method %s not permitted, Missing
6105 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6106 No %s specified for -%c, No package name allowed for variable %s in "our",
6107 No space allowed after -%c, no UTC offset information; assuming local time
6108 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6109 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6110 around "%s" list, Possible unintended interpolation of %s in string,
6111 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6112 instead, Premature end of script headers, Repeat count in pack overflows,
6113 Repeat count in unpack overflows, realloc() of freed memory ignored,
6114 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6115 zero-length expression, switching effective %s is not implemented, This
6116 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6117 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6118 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6119 escape \\%c passed through, Unterminated attribute parameter in attribute
6120 list, Unterminated attribute list, Unterminated attribute parameter in
6121 subroutine attribute list, Unterminated subroutine attribute list, Value of
6122 CLI symbol "%s" too long, Version number must be a constant number
6123
6124 =item New tests
6125
6126 =item Incompatible Changes
6127
6128 =over 4
6129
6130 =item Perl Source Incompatibilities
6131
6132 CHECK is a new keyword, Treatment of list slices of undef has changed,
6133 Format of $English::PERL_VERSION is different, Literals of the form
6134 C<1.2.3> parse differently, Possibly changed pseudo-random number
6135 generator, Hashing function for hash keys has changed, C<undef> fails on
6136 read only values, Close-on-exec bit may be set on pipe and socket handles,
6137 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6138 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6139 Text of some diagnostic output has changed, C<%@> has been removed,
6140 Parenthesized not() behaves like a list operator, Semantics of bareword
6141 prototype C<(*)> have changed, Semantics of bit operators may have changed
6142 on 64-bit platforms, More builtins taint their results
6143
6144 =item C Source Incompatibilities
6145
6146 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6147
6148 =item Compatible C Source API Changes
6149
6150 C<PATCHLEVEL> is now C<PERL_VERSION>
6151
6152 =item Binary Incompatibilities
6153
6154 =back
6155
6156 =item Known Problems
6157
6158 =over 4
6159
6160 =item Localizing a tied hash element may leak memory
6161
6162 =item Known test failures
6163
6164 =item EBCDIC platforms not fully supported
6165
6166 =item UNICOS/mk CC failures during Configure run
6167
6168 =item Arrow operator and arrays
6169
6170 =item Experimental features
6171
6172 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6173 pseudo-hash data type, The Compiler suite, Internal implementation of file
6174 globbing, The DB module, The regular expression code constructs:
6175
6176 =back
6177
6178 =item Obsolete Diagnostics
6179
6180 Character class syntax [: :] is reserved for future extensions, Ill-formed
6181 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6182 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6183 to mean "${$}<digit>" is deprecated
6184
6185 =item Reporting Bugs
6186
6187 =item SEE ALSO
6188
6189 =item HISTORY
6190
6191 =back
6192
6193 =head2 perl56delta - what's new for perl v5.6.0
6194
6195 =over 4
6196
6197 =item DESCRIPTION
6198
6199 =item Core Enhancements
6200
6201 =over 4
6202
6203 =item Interpreter cloning, threads, and concurrency
6204
6205 =item Lexically scoped warning categories
6206
6207 =item Unicode and UTF-8 support
6208
6209 =item Support for interpolating named characters
6210
6211 =item "our" declarations
6212
6213 =item Support for strings represented as a vector of ordinals
6214
6215 =item Improved Perl version numbering system
6216
6217 =item New syntax for declaring subroutine attributes
6218
6219 =item File and directory handles can be autovivified
6220
6221 =item open() with more than two arguments
6222
6223 =item 64-bit support
6224
6225 =item Large file support
6226
6227 =item Long doubles
6228
6229 =item "more bits"
6230
6231 =item Enhanced support for sort() subroutines
6232
6233 =item C<sort $coderef @foo> allowed
6234
6235 =item File globbing implemented internally
6236
6237 =item Support for CHECK blocks
6238
6239 =item POSIX character class syntax [: :] supported
6240
6241 =item Better pseudo-random number generator
6242
6243 =item Improved C<qw//> operator
6244
6245 =item Better worst-case behavior of hashes
6246
6247 =item pack() format 'Z' supported
6248
6249 =item pack() format modifier '!' supported
6250
6251 =item pack() and unpack() support counted strings
6252
6253 =item Comments in pack() templates
6254
6255 =item Weak references
6256
6257 =item Binary numbers supported
6258
6259 =item Lvalue subroutines
6260
6261 =item Some arrows may be omitted in calls through references
6262
6263 =item Boolean assignment operators are legal lvalues
6264
6265 =item exists() is supported on subroutine names
6266
6267 =item exists() and delete() are supported on array elements
6268
6269 =item Pseudo-hashes work better
6270
6271 =item Automatic flushing of output buffers
6272
6273 =item Better diagnostics on meaningless filehandle operations
6274
6275 =item Where possible, buffered data discarded from duped input filehandle
6276
6277 =item eof() has the same old magic as <>
6278
6279 =item binmode() can be used to set :crlf and :raw modes
6280
6281 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6282
6283 =item system(), backticks and pipe open now reflect exec() failure
6284
6285 =item Improved diagnostics
6286
6287 =item Diagnostics follow STDERR
6288
6289 =item More consistent close-on-exec behavior
6290
6291 =item syswrite() ease-of-use
6292
6293 =item Better syntax checks on parenthesized unary operators
6294
6295 =item Bit operators support full native integer width
6296
6297 =item Improved security features
6298
6299 =item More functional bareword prototype (*)
6300
6301 =item C<require> and C<do> may be overridden
6302
6303 =item $^X variables may now have names longer than one character
6304
6305 =item New variable $^C reflects C<-c> switch
6306
6307 =item New variable $^V contains Perl version as a string
6308
6309 =item Optional Y2K warnings
6310
6311 =item Arrays now always interpolate into double-quoted strings
6312
6313 =back
6314
6315 =item Modules and Pragmata
6316
6317 =over 4
6318
6319 =item Modules
6320
6321 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6322 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6323 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6324 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6325 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6326 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6327 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6328 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6329
6330 =item Pragmata
6331
6332 =back
6333
6334 =item Utility Changes
6335
6336 =over 4
6337
6338 =item dprofpp
6339
6340 =item find2perl
6341
6342 =item h2xs
6343
6344 =item perlcc
6345
6346 =item perldoc
6347
6348 =item The Perl Debugger
6349
6350 =back
6351
6352 =item Improved Documentation
6353
6354 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6355 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6356 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6357 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6358
6359 =item Performance enhancements
6360
6361 =over 4
6362
6363 =item Simple sort() using { $a <=> $b } and the like are optimized
6364
6365 =item Optimized assignments to lexical variables
6366
6367 =item Faster subroutine calls
6368
6369 =item delete(), each(), values() and hash iteration are faster
6370
6371 =back
6372
6373 =item Installation and Configuration Improvements
6374
6375 =over 4
6376
6377 =item -Dusethreads means something different
6378
6379 =item New Configure flags
6380
6381 =item Threadedness and 64-bitness now more daring
6382
6383 =item Long Doubles
6384
6385 =item -Dusemorebits
6386
6387 =item -Duselargefiles
6388
6389 =item installusrbinperl
6390
6391 =item SOCKS support
6392
6393 =item C<-A> flag
6394
6395 =item Enhanced Installation Directories
6396
6397 =back
6398
6399 =item Platform specific changes
6400
6401 =over 4
6402
6403 =item Supported platforms
6404
6405 =item DOS
6406
6407 =item OS390 (OpenEdition MVS)
6408
6409 =item VMS
6410
6411 =item Win32
6412
6413 =back
6414
6415 =item Significant bug fixes
6416
6417 =over 4
6418
6419 =item <HANDLE> on empty files
6420
6421 =item C<eval '...'> improvements
6422
6423 =item All compilation errors are true errors
6424
6425 =item Implicitly closed filehandles are safer
6426
6427 =item Behavior of list slices is more consistent
6428
6429 =item C<(\$)> prototype and C<$foo{a}>
6430
6431 =item C<goto &sub> and AUTOLOAD
6432
6433 =item C<-bareword> allowed under C<use integer>
6434
6435 =item Failures in DESTROY()
6436
6437 =item Locale bugs fixed
6438
6439 =item Memory leaks
6440
6441 =item Spurious subroutine stubs after failed subroutine calls
6442
6443 =item Taint failures under C<-U>
6444
6445 =item END blocks and the C<-c> switch
6446
6447 =item Potential to leak DATA filehandles
6448
6449 =back
6450
6451 =item New or Changed Diagnostics
6452
6453 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6454 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6455 / cannot take a count, / must be followed by a, A or Z, / must be followed
6456 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6457 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6458 passed through, /%s/ should probably be written as "%s", %s() called too
6459 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6460 argument is not a HASH or ARRAY element or slice, %s argument is not a
6461 subroutine name, %s package attribute may clash with future reserved word:
6462 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6463 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6464 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6465 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6466 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6467 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6468 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6469 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6470 weaken a nonreference, Character class [:%s:] unknown, Character class
6471 syntax [%s] belongs inside character classes, Constant is not %s reference,
6472 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6473 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6474 "local" instead of "our"?), Document contains no data, entering effective
6475 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6476 output, flock() on closed filehandle %s, Global symbol "%s" requires
6477 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6478 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6479 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6480 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6481 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6482 separator character %s in attribute list, Invalid separator character %s in
6483 subroutine attribute list, leaving effective %s failed, Lvalue subs
6484 returning %s not implemented yet, Method %s not permitted, Missing
6485 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6486 No %s specified for -%c, No package name allowed for variable %s in "our",
6487 No space allowed after -%c, no UTC offset information; assuming local time
6488 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6489 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6490 around "%s" list, Possible unintended interpolation of %s in string,
6491 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6492 instead, Premature end of script headers, Repeat count in pack overflows,
6493 Repeat count in unpack overflows, realloc() of freed memory ignored,
6494 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6495 zero-length expression, switching effective %s is not implemented, This
6496 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6497 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6498 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6499 escape \\%c passed through, Unterminated attribute parameter in attribute
6500 list, Unterminated attribute list, Unterminated attribute parameter in
6501 subroutine attribute list, Unterminated subroutine attribute list, Value of
6502 CLI symbol "%s" too long, Version number must be a constant number
6503
6504 =item New tests
6505
6506 =item Incompatible Changes
6507
6508 =over 4
6509
6510 =item Perl Source Incompatibilities
6511
6512 CHECK is a new keyword, Treatment of list slices of undef has changed,
6513 Format of $English::PERL_VERSION is different, Literals of the form
6514 C<1.2.3> parse differently, Possibly changed pseudo-random number
6515 generator, Hashing function for hash keys has changed, C<undef> fails on
6516 read only values, Close-on-exec bit may be set on pipe and socket handles,
6517 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6518 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6519 Text of some diagnostic output has changed, C<%@> has been removed,
6520 Parenthesized not() behaves like a list operator, Semantics of bareword
6521 prototype C<(*)> have changed, Semantics of bit operators may have changed
6522 on 64-bit platforms, More builtins taint their results
6523
6524 =item C Source Incompatibilities
6525
6526 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6527
6528 =item Compatible C Source API Changes
6529
6530 C<PATCHLEVEL> is now C<PERL_VERSION>
6531
6532 =item Binary Incompatibilities
6533
6534 =back
6535
6536 =item Known Problems
6537
6538 =over 4
6539
6540 =item Thread test failures
6541
6542 =item EBCDIC platforms not supported
6543
6544 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6545
6546 =item NEXTSTEP 3.3 POSIX test failure
6547
6548 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6549 gcc
6550
6551 =item UNICOS/mk CC failures during Configure run
6552
6553 =item Arrow operator and arrays
6554
6555 =item Experimental features
6556
6557 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6558 pseudo-hash data type, The Compiler suite, Internal implementation of file
6559 globbing, The DB module, The regular expression code constructs:
6560
6561 =back
6562
6563 =item Obsolete Diagnostics
6564
6565 Character class syntax [: :] is reserved for future extensions, Ill-formed
6566 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6567 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6568 to mean "${$}<digit>" is deprecated
6569
6570 =item Reporting Bugs
6571
6572 =item SEE ALSO
6573
6574 =item HISTORY
6575
6576 =back
6577
6578 =head2 perl5005delta - what's new for perl5.005
6579
6580 =over 4
6581
6582 =item DESCRIPTION
6583
6584 =item About the new versioning system
6585
6586 =item Incompatible Changes
6587
6588 =over 4
6589
6590 =item WARNING:  This version is not binary compatible with Perl 5.004.
6591
6592 =item Default installation structure has changed
6593
6594 =item Perl Source Compatibility
6595
6596 =item C Source Compatibility
6597
6598 =item Binary Compatibility
6599
6600 =item Security fixes may affect compatibility
6601
6602 =item Relaxed new mandatory warnings introduced in 5.004
6603
6604 =item Licensing
6605
6606 =back
6607
6608 =item Core Changes
6609
6610 =over 4
6611
6612 =item Threads
6613
6614 =item Compiler
6615
6616 =item Regular Expressions
6617
6618 Many new and improved optimizations, Many bug fixes, New regular expression
6619 constructs, New operator for precompiled regular expressions, Other
6620 improvements, Incompatible changes
6621
6622 =item   Improved malloc()
6623
6624 =item Quicksort is internally implemented
6625
6626 =item Reliable signals
6627
6628 =item Reliable stack pointers
6629
6630 =item More generous treatment of carriage returns
6631
6632 =item Memory leaks
6633
6634 =item Better support for multiple interpreters
6635
6636 =item Behavior of local() on array and hash elements is now well-defined
6637
6638 =item C<%!> is transparently tied to the L<Errno> module
6639
6640 =item Pseudo-hashes are supported
6641
6642 =item C<EXPR foreach EXPR> is supported
6643
6644 =item Keywords can be globally overridden
6645
6646 =item C<$^E> is meaningful on Win32
6647
6648 =item C<foreach (1..1000000)> optimized
6649
6650 =item C<Foo::> can be used as implicitly quoted package name
6651
6652 =item C<exists $Foo::{Bar::}> tests existence of a package
6653
6654 =item Better locale support
6655
6656 =item Experimental support for 64-bit platforms
6657
6658 =item prototype() returns useful results on builtins
6659
6660 =item Extended support for exception handling
6661
6662 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6663
6664 =item All C<printf> format conversions are handled internally
6665
6666 =item New C<INIT> keyword
6667
6668 =item New C<lock> keyword
6669
6670 =item New C<qr//> operator
6671
6672 =item C<our> is now a reserved word
6673
6674 =item Tied arrays are now fully supported
6675
6676 =item Tied handles support is better
6677
6678 =item 4th argument to substr
6679
6680 =item Negative LENGTH argument to splice
6681
6682 =item Magic lvalues are now more magical
6683
6684 =item <> now reads in records
6685
6686 =back
6687
6688 =item Supported Platforms
6689
6690 =over 4
6691
6692 =item New Platforms
6693
6694 =item Changes in existing support
6695
6696 =back
6697
6698 =item Modules and Pragmata
6699
6700 =over 4
6701
6702 =item New Modules
6703
6704 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6705 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6706 Thread, attrs, fields, re
6707
6708 =item Changes in existing modules
6709
6710 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6711 MakeMaker, CPAN, Cwd
6712
6713 =back
6714
6715 =item Utility Changes
6716
6717 =item Documentation Changes
6718
6719 =item New Diagnostics
6720
6721 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6722 while coercing array into hash, Bareword "%s" refers to nonexistent
6723 package, Can't call method "%s" on an undefined value, Can't check
6724 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6725 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6726 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6727 for "%s", Character class syntax [. .] is reserved for future extensions,
6728 Character class syntax [: :] is reserved for future extensions, Character
6729 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6730 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6731 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6732 package main), Illegal hex digit ignored, No such array field, No such
6733 field "%s" in variable %s of type %s, Out of memory during ridiculously
6734 large request, Range iterator outside integer range, Recursive inheritance
6735 detected while looking for method '%s' %s, Reference found where even-sized
6736 list expected, Undefined value assigned to typeglob, Use of reserved word
6737 "%s" is deprecated, perl: warning: Setting locale failed
6738
6739 =item Obsolete Diagnostics
6740
6741 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6742 temporary file, regexp too big
6743
6744 =item Configuration Changes
6745
6746 =item BUGS
6747
6748 =item SEE ALSO
6749
6750 =item HISTORY
6751
6752 =back
6753
6754 =head2 perl5004delta - what's new for perl5.004
6755
6756 =over 4
6757
6758 =item DESCRIPTION
6759
6760 =item Supported Environments
6761
6762 =item Core Changes
6763
6764 =over 4
6765
6766 =item List assignment to %ENV works
6767
6768 =item Change to "Can't locate Foo.pm in @INC" error
6769
6770 =item Compilation option: Binary compatibility with 5.003
6771
6772 =item $PERL5OPT environment variable
6773
6774 =item Limitations on B<-M>, B<-m>, and B<-T> options
6775
6776 =item More precise warnings
6777
6778 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6779
6780 =item Previously deprecated %OVERLOAD is no longer usable
6781
6782 =item Subroutine arguments created only when they're modified
6783
6784 =item Group vector changeable with C<$)>
6785
6786 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6787
6788 =item Fixed localization of $<digit>, $&, etc.
6789
6790 =item No resetting of $. on implicit close
6791
6792 =item C<wantarray> may return undef
6793
6794 =item C<eval EXPR> determines value of EXPR in scalar context
6795
6796 =item Changes to tainting checks
6797
6798 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6799 spawning if tainted $TERM doesn't look like a terminal name
6800
6801 =item New Opcode module and revised Safe module
6802
6803 =item Embedding improvements
6804
6805 =item Internal change: FileHandle class based on IO::* classes
6806
6807 =item Internal change: PerlIO abstraction interface
6808
6809 =item New and changed syntax
6810
6811 $coderef->(PARAMS)
6812
6813 =item New and changed builtin constants
6814
6815 __PACKAGE__
6816
6817 =item New and changed builtin variables
6818
6819 $^E, $^H, $^M
6820
6821 =item New and changed builtin functions
6822
6823 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6824 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6825 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6826 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6827 nested C<sub{}> closures work now, formats work right on changing lexicals
6828
6829 =item New builtin methods
6830
6831 isa(CLASS), can(METHOD), VERSION( [NEED] )
6832
6833 =item TIEHANDLE now supported
6834
6835 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6836 LIST, READLINE this, GETC this, DESTROY this
6837
6838 =item Malloc enhancements
6839
6840 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6841
6842 =item Miscellaneous efficiency enhancements
6843
6844 =back
6845
6846 =item Support for More Operating Systems
6847
6848 =over 4
6849
6850 =item Win32
6851
6852 =item Plan 9
6853
6854 =item QNX
6855
6856 =item AmigaOS
6857
6858 =back
6859
6860 =item Pragmata
6861
6862 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6863 constant NAME => VALUE, use locale, use ops, use vmsish
6864
6865 =item Modules
6866
6867 =over 4
6868
6869 =item Required Updates
6870
6871 =item Installation directories
6872
6873 =item Module information summary
6874
6875 =item Fcntl
6876
6877 =item IO
6878
6879 =item Math::Complex
6880
6881 =item Math::Trig
6882
6883 =item DB_File
6884
6885 =item Net::Ping
6886
6887 =item Object-oriented overrides for builtin operators
6888
6889 =back
6890
6891 =item Utility Changes
6892
6893 =over 4
6894
6895 =item pod2html
6896
6897 Sends converted HTML to standard output
6898
6899 =item xsubpp
6900
6901 C<void> XSUBs now default to returning nothing
6902
6903 =back
6904
6905 =item C Language API Changes
6906
6907 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6908 manipulating hashes
6909
6910 =item Documentation Changes
6911
6912 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6913 L<perlmodlib>, L<perldebug>, L<perlsec>
6914
6915 =item New Diagnostics
6916
6917 "my" variable %s masks earlier declaration in same scope, %s argument is
6918 not a HASH element or slice, Allocation too large: %lx, Allocation too
6919 large, Applying %s to %s will act on scalar(%s), Attempt to free
6920 nonexistent shared string, Attempt to use reference as lvalue in substr,
6921 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6922 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6923 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6924 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6925 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6926 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6927 %s, Integer overflow in hex number, Integer overflow in octal number,
6928 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6929 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6930 possible typo, Null picture in formline, Offset outside string, Out of
6931 memory!, Out of memory during request for %s, panic: frexp, Possible
6932 attempt to put comments in qw() list, Possible attempt to separate words
6933 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6934 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6935 option, untie attempted while %d inner references still exist, Unrecognized
6936 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6937 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6938 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6939 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6940 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6941 long, Process terminated by SIG%s
6942
6943 =item BUGS
6944
6945 =item SEE ALSO
6946
6947 =item HISTORY
6948
6949 =back
6950
6951 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6952
6953 =over 4
6954
6955 =item DESCRIPTION
6956
6957 =over 4
6958
6959 =item Compiling Perl 5 on AIX
6960
6961 =item OS level
6962
6963 =item Building Dynamic Extensions on AIX
6964
6965 =item The IBM ANSI C Compiler
6966
6967 =item Using GNU's gcc for building perl
6968
6969 =item Using Large Files with Perl
6970
6971 =item Threaded Perl
6972
6973 =item 64-bit Perl
6974
6975 =item AIX 4.2 and extensions using C++ with statics
6976
6977 =back
6978
6979 =item AUTHOR
6980
6981 =item DATE
6982
6983 =back
6984
6985 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6986
6987 =over 4
6988
6989 =item DESCRIPTION
6990
6991 =item AUTHOR
6992
6993 =back
6994
6995 =head2 perlamiga - Perl under Amiga OS
6996
6997 =over 4
6998
6999 =item NOTE
7000
7001 =item SYNOPSIS
7002
7003 =back
7004
7005 =over 4
7006
7007 =item DESCRIPTION
7008
7009 =over 4
7010
7011 =item Prerequisites for Compiling Perl on AmigaOS
7012
7013 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7014
7015 =item Starting Perl programs under AmigaOS
7016
7017 =item Shortcomings of Perl under AmigaOS
7018
7019 =back
7020
7021 =item INSTALLATION
7022
7023 =item Accessing documentation
7024
7025 =over 4
7026
7027 =item Manpages for Perl on AmigaOS
7028
7029 =item Perl HTML Documentation on AmigaOS
7030
7031 =item Perl GNU Info Files on AmigaOS
7032
7033 =item Perl LaTeX Documentation on AmigaOS
7034
7035 =back
7036
7037 =item BUILDING PERL ON AMIGAOS
7038
7039 =over 4
7040
7041 =item Build Prerequisites for Perl on AmigaOS
7042
7043 =item Getting the Perl Source for AmigaOS
7044
7045 =item Making Perl on AmigaOS
7046
7047 =item Testing Perl on AmigaOS
7048
7049 =item Installing the built Perl on AmigaOS
7050
7051 =back
7052
7053 =item PERL 5.8.0 BROKEN IN AMIGAOS
7054
7055 =item AUTHORS
7056
7057 =item SEE ALSO
7058
7059 =back
7060
7061 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7062
7063 =over 4
7064
7065 =item DESCRIPTION
7066
7067 =over 4
7068
7069 =item General Issues with Perl on BeOS
7070
7071 =item BeOS Release-specific Notes
7072
7073 R4 x86, R4 PPC
7074
7075 =item Contact Information
7076
7077 =item Update 2002-05-30
7078
7079 =back
7080
7081 =back
7082
7083 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7084
7085 =over 4
7086
7087 =item SYNOPSIS
7088
7089 =item DESCRIPTION
7090
7091 =over 4
7092
7093 =item gzip on BS2000
7094
7095 =item bison on BS2000
7096
7097 =item Unpacking Perl Distribution on BS2000
7098
7099 =item Compiling Perl on BS2000
7100
7101 =item Testing Perl on BS2000
7102
7103 =item Installing Perl on BS2000
7104
7105 =item Using Perl in the Posix-Shell of BS2000
7106
7107 =item Using Perl in "native" BS2000
7108
7109 =item Floating point anomalies on BS2000
7110
7111 =back
7112
7113 =item AUTHORS
7114
7115 =item SEE ALSO
7116
7117 =over 4
7118
7119 =item Mailing list
7120
7121 =back
7122
7123 =item HISTORY
7124
7125 =back
7126
7127 =over 4
7128
7129 =item Name
7130
7131 =item Description
7132
7133 =item Build
7134
7135 =over 4
7136
7137 =item Tools & SDK
7138
7139 =item Make
7140
7141 =back
7142
7143 =item Acknowledgements
7144
7145 =item Author
7146
7147 =back
7148
7149 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7150
7151 =over 4
7152
7153 =item SYNOPSIS
7154
7155 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7156
7157 =over 4
7158
7159 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7160
7161 =item Cygwin Configuration
7162
7163 C<PATH>, I<nroff>, Permissions
7164
7165 =back
7166
7167 =item CONFIGURE PERL ON CYGWIN
7168
7169 =over 4
7170
7171 =item Stripping Perl Binaries on Cygwin
7172
7173 =item Optional Libraries for Perl on Cygwin
7174
7175 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7176 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7177
7178 =item Configure-time Options for Perl on Cygwin
7179
7180 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7181 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7182 C<-Dmksymlinks>
7183
7184 =item Suspicious Warnings on Cygwin
7185
7186 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7187
7188 =back
7189
7190 =item MAKE ON CYGWIN
7191
7192 =over 4
7193
7194 =item Warnings on Cygwin
7195
7196 =item ld2 on Cygwin
7197
7198 =back
7199
7200 =item TEST ON CYGWIN
7201
7202 =over 4
7203
7204 =item File Permissions on Cygwin
7205
7206 =item NDBM_File does not work on FAT filesystems
7207
7208 =item Script Portability on Cygwin
7209
7210 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7211
7212 =back
7213
7214 =item INSTALL PERL ON CYGWIN
7215
7216 =item MANIFEST ON CYGWIN
7217
7218 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7219 Source, Compiled Module Source, Perl Modules/Scripts
7220
7221 =item BUGS ON CYGWIN
7222
7223 =item AUTHORS
7224
7225 =item HISTORY
7226
7227 =back
7228
7229 =head2 perldgux - Perl under DG/UX.
7230
7231 =over 4
7232
7233 =item SYNOPSIS
7234
7235 =back
7236
7237 =over 4
7238
7239 =item DESCRIPTION
7240
7241 =item BUILDING PERL ON DG/UX
7242
7243 =over 4
7244
7245 =item Non-threaded Perl on DG/UX
7246
7247 =item Threaded Perl on DG/UX
7248
7249 =item Testing Perl on DG/UX
7250
7251 =item Installing the built perl on DG/UX
7252
7253 =back
7254
7255 =item AUTHOR
7256
7257 =item SEE ALSO
7258
7259 =back
7260
7261 =head2 perldos - Perl under DOS, W31, W95.
7262
7263 =over 4
7264
7265 =item SYNOPSIS
7266
7267 =item DESCRIPTION
7268
7269 =over 4
7270
7271 =item Prerequisites for Compiling Perl on DOS
7272
7273 DJGPP, Pthreads
7274
7275 =item Shortcomings of Perl under DOS
7276
7277 =item Building Perl on DOS
7278
7279 =item Testing Perl on DOS
7280
7281 =item Installation of Perl on DOS
7282
7283 =back
7284
7285 =item BUILDING AND INSTALLING MODULES ON DOS
7286
7287 =over 4
7288
7289 =item Building Prerequisites for Perl on DOS
7290
7291 =item Unpacking CPAN Modules on DOS
7292
7293 =item Building Non-XS Modules on DOS
7294
7295 =item Building XS Modules on DOS
7296
7297 =back
7298
7299 =item AUTHOR
7300
7301 =item SEE ALSO
7302
7303 =back
7304
7305 =head2 perlepoc, README.epoc - Perl for EPOC
7306
7307 =over 4
7308
7309 =item SYNOPSIS
7310
7311 =item INTRODUCTION
7312
7313 =item INSTALLING PERL ON EPOC
7314
7315 =item STARTING PERL ON EPOC
7316
7317 =over 4
7318
7319 =item Editors on Epoc
7320
7321 =item Features of Perl on Epoc
7322
7323 =item Restrictions of Perl on Epoc
7324
7325 =item Compiling Perl 5 on the EPOC cross compiling environment
7326
7327 =back
7328
7329 =item SUPPORT STATUS OF PERL ON EPOC
7330
7331 =item AUTHOR
7332
7333 =item LAST UPDATE
7334
7335 =back
7336
7337 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7338
7339 =over 4
7340
7341 =item DESCRIPTION
7342
7343 =over 4
7344
7345 =item FreeBSD core dumps from readdir_r with ithreads
7346
7347 =item $^X doesn't always contain a full path in FreeBSD
7348
7349 =item Perl will no longer be part of "base FreeBSD"
7350
7351 =back
7352
7353 =item AUTHOR
7354
7355 =back
7356
7357 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7358 (HP-UX) systems
7359
7360 =over 4
7361
7362 =item DESCRIPTION
7363
7364 =over 4
7365
7366 =item Using perl as shipped with HP-UX
7367
7368 =item Compiling Perl 5 on HP-UX
7369
7370 =item PA-RISC
7371
7372 =item PA-RISC 1.0
7373
7374 =item PA-RISC 1.1
7375
7376 =item PA-RISC 2.0
7377
7378 =item Itanium
7379
7380 =item Portability Between PA-RISC Versions
7381
7382 =item Itanium Processor Family and HP-UX
7383
7384 =item Building Dynamic Extensions on HP-UX
7385
7386 =item The HP ANSI C Compiler
7387
7388 =item The GNU C Compiler
7389
7390 =item Using Large Files with Perl on HP-UX
7391
7392 =item Threaded Perl on HP-UX
7393
7394 =item 64-bit Perl on HP-UX
7395
7396 =item Oracle on HP-UX
7397
7398 =item GDBM and Threads on HP-UX
7399
7400 =item NFS filesystems and utime(2) on HP-UX
7401
7402 =item perl -P and // and HP-UX
7403
7404 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7405
7406 =back
7407
7408 =item nss_delete core dump from op/pwent or op/grent
7409
7410 =item AUTHOR
7411
7412 =item DATE
7413
7414 =back
7415
7416 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7417
7418 =over 4
7419
7420 =item DESCRIPTION
7421
7422 =over 4
7423
7424 =item Known Problems with Perl on Hurd 
7425
7426 =back
7427
7428 =item AUTHOR
7429
7430 =back
7431
7432 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7433
7434 =over 4
7435
7436 =item DESCRIPTION
7437
7438 =over 4
7439
7440 =item Building 32-bit Perl in Irix
7441
7442 =item Building 64-bit Perl in Irix
7443
7444 =item About Compiler Versions of Irix
7445
7446 =item Linker Problems in Irix
7447
7448 =item Malloc in Irix
7449
7450 =item Building with threads in Irix
7451
7452 =back
7453
7454 =item AUTHOR
7455
7456 =back
7457
7458 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7459 systems
7460
7461 =over 4
7462
7463 =item DESCRIPTION
7464
7465 =over 4
7466
7467 =item Compiling Perl 5 on MachTen
7468
7469 =item Failures during C<make test> on MachTen
7470
7471 op/lexassign.t, pragma/warnings.t
7472
7473 =item Building external modules on MachTen
7474
7475 =back
7476
7477 =item AUTHOR
7478
7479 =item DATE
7480
7481 =back
7482
7483 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7484
7485 =over 4
7486
7487 =item SYNOPSIS
7488
7489 =item DESCRIPTION
7490
7491 =item AUTHOR
7492
7493 =item DATE
7494
7495 =back
7496
7497 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7498
7499 =over 4
7500
7501 =item DESCRIPTION
7502
7503 =item Known problems with Perl on MiNT
7504
7505 =item AUTHOR
7506
7507 =back
7508
7509 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7510
7511 =over 4
7512
7513 =item SYNOPSIS
7514
7515 =item NOTE
7516
7517 =item Binary distribution from HP
7518
7519 =item What's New in Perl for MPE/iX
7520
7521 =item Welcome to Perl/iX
7522
7523 =item System Requirements for Perl/iX
7524
7525 =item How to Obtain Perl/iX
7526
7527 =item Perl/iX Distribution Contents Highlights
7528
7529 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7530 public_html/feedback.cgi, src/perl-5.6.0-mpe
7531
7532 =item How to Compile Perl/iX
7533
7534  4,  6
7535
7536 =item Getting Started with Perl/iX
7537
7538 =item MPE/iX Implementation Considerations
7539
7540 =item Known Perl/iX Bugs Under Investigation
7541
7542 =item Perl/iX To-Do List
7543
7544 =item Perl/iX Change History
7545
7546 =item AUTHOR
7547
7548 =item Name
7549
7550 =item Description
7551
7552 =item Build
7553
7554 =over 4
7555
7556 =item Tools & SDK
7557
7558 =item Setup
7559
7560 SetNWBld.bat, Buildtype.bat
7561
7562 =item Make
7563
7564 =item Interpreter
7565
7566 =item Extensions
7567
7568 =back
7569
7570 =item Install
7571
7572 =item Build new extensions
7573
7574 =item Acknowledgements
7575
7576 =item Authors
7577
7578 =item Date
7579
7580 =back
7581
7582 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7583
7584 =over 4
7585
7586 =item SYNOPSIS
7587
7588 =back
7589
7590 =over 4
7591
7592 =item DESCRIPTION
7593
7594 =over 4
7595
7596 =item Target
7597
7598 =item Other OSes
7599
7600 =item Prerequisites
7601
7602 EMX, RSX, HPFS, pdksh
7603
7604 =item Starting Perl programs under OS/2 (and DOS and...)
7605
7606 =item Starting OS/2 (and DOS) programs under Perl
7607
7608 =back
7609
7610 =item Frequently asked questions
7611
7612 =over 4
7613
7614 =item "It does not work"
7615
7616 =item I cannot run external programs
7617
7618 =item I cannot embed perl into my program, or use F<perl.dll> from my
7619 program. 
7620
7621 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7622 L<ExtUtils::Embed>?
7623
7624 =item C<``> and pipe-C<open> do not work under DOS.
7625
7626 =item Cannot start C<find.exe "pattern" file>
7627
7628 =back
7629
7630 =item INSTALLATION
7631
7632 =over 4
7633
7634 =item Automatic binary installation
7635
7636 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7637
7638 =item Manual binary installation
7639
7640 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7641 (statically linked), Executables for Perl utilities, Main Perl library,
7642 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7643 and utilities, Manpages for Perl modules, Source for Perl documentation,
7644 Perl manual in F<.INF> format, Pdksh
7645
7646 =item B<Warning>
7647
7648 =back
7649
7650 =item Accessing documentation
7651
7652 =over 4
7653
7654 =item OS/2 F<.INF> file
7655
7656 =item Plain text
7657
7658 =item Manpages
7659
7660 =item HTML
7661
7662 =item GNU C<info> files
7663
7664 =item F<PDF> files
7665
7666 =item C<LaTeX> docs
7667
7668 =back
7669
7670 =item BUILD
7671
7672 =over 4
7673
7674 =item The short story
7675
7676 =item Prerequisites
7677
7678 =item Getting perl source
7679
7680 =item Application of the patches
7681
7682 =item Hand-editing
7683
7684 =item Making
7685
7686 =item Testing
7687
7688 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7689 F<op/stat.t>
7690
7691 =item Installing the built perl
7692
7693 =item C<a.out>-style build
7694
7695 =back
7696
7697 =item Build FAQ
7698
7699 =over 4
7700
7701 =item Some C</> became C<\> in pdksh.
7702
7703 =item C<'errno'> - unresolved external
7704
7705 =item Problems with tr or sed
7706
7707 =item Some problem (forget which ;-)
7708
7709 =item Library ... not found
7710
7711 =item Segfault in make
7712
7713 =item op/sprintf test failure
7714
7715 =back
7716
7717 =item Specific (mis)features of OS/2 port
7718
7719 =over 4
7720
7721 =item C<setpriority>, C<getpriority>
7722
7723 =item C<system()>
7724
7725 =item C<extproc> on the first line
7726
7727 =item Additional modules:
7728
7729 =item Prebuilt methods:
7730
7731 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7732  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
7733 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
7734 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
7735 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
7736 C<Cwd::extLibpath_set( path [, type ] )>,
7737 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7738 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7739 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7740 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7741 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
7742 C<OS2::DLLname([how [, \&xsub]])>
7743
7744 =item Prebuilt variables:
7745
7746 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
7747 $OS2::nsyserror
7748
7749 =item Misfeatures
7750
7751 =item Modifications
7752
7753 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7754 C<flock>
7755
7756 =item Identifying DLLs
7757
7758 =item Centralized management of resources
7759
7760 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
7761 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
7762 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
7763 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
7764
7765 =back
7766
7767 =item Perl flavors
7768
7769 =over 4
7770
7771 =item F<perl.exe>
7772
7773 =item F<perl_.exe>
7774
7775 =item F<perl__.exe>
7776
7777 =item F<perl___.exe>
7778
7779 =item Why strange names?
7780
7781 =item Why dynamic linking?
7782
7783 =item Why chimera build?
7784
7785 =back
7786
7787 =item ENVIRONMENT
7788
7789 =over 4
7790
7791 =item C<PERLLIB_PREFIX>
7792
7793 =item C<PERL_BADLANG>
7794
7795 =item C<PERL_BADFREE>
7796
7797 =item C<PERL_SH_DIR>
7798
7799 =item C<USE_PERL_FLOCK>
7800
7801 =item C<TMP> or C<TEMP>
7802
7803 =back
7804
7805 =item Evolution
7806
7807 =over 4
7808
7809 =item Text-mode filehandles
7810
7811 =item Priorities
7812
7813 =item DLL name mangling: pre 5.6.2
7814
7815 =item DLL name mangling: 5.6.2 and beyond
7816
7817 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7818 C<LIBPATH>
7819
7820 =item DLL forwarder generation
7821
7822 =item Threading
7823
7824 =item Calls to external programs
7825
7826 =item Memory allocation
7827
7828 =item Threads
7829
7830 C<COND_WAIT>, F<os2.c>
7831
7832 =back
7833
7834 =item BUGS
7835
7836 =back
7837
7838 =over 4
7839
7840 =item AUTHOR
7841
7842 =item SEE ALSO
7843
7844 =back
7845
7846 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7847 and z/OS
7848
7849 =over 4
7850
7851 =item SYNOPSIS
7852
7853 =item DESCRIPTION
7854
7855 =over 4
7856
7857 =item Tools
7858
7859 =item Unpacking Perl distribution on OS/390
7860
7861 =item Setup and utilities for Perl on OS/390
7862
7863 =item Configure Perl on OS/390
7864
7865 =item Build, Test, Install Perl on OS/390
7866
7867 =item Build Anomalies with Perl on OS/390
7868
7869 =item Testing Anomalies with Perl on OS/390
7870
7871 =item Installation Anomalies with Perl on OS/390
7872
7873 =item Usage Hints for Perl on OS/390
7874
7875 =item Floating Point Anomalies with Perl on OS/390
7876
7877 =item Modules and Extensions for Perl on OS/390
7878
7879 =back
7880
7881 =item AUTHORS
7882
7883 =item SEE ALSO
7884
7885 =over 4
7886
7887 =item Mailing list for Perl on OS/390
7888
7889 =back
7890
7891 =item HISTORY
7892
7893 =back
7894
7895 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7896
7897 =over 4
7898
7899 =item DESCRIPTION
7900
7901 =over 4
7902
7903 =item Required Software for Compiling Perl on QNX4
7904
7905 /bin/sh, ar, nm, cpp, make
7906
7907 =item Outstanding Issues with Perl on QNX4
7908
7909 =item QNX auxiliary files
7910
7911 qnx/ar, qnx/cpp
7912
7913 =item Outstanding issues with perl under QNX6
7914
7915 =back
7916
7917 =item AUTHOR
7918
7919 =back
7920
7921 =head2 perlplan9 - Plan 9-specific documentation for Perl
7922
7923 =over 4
7924
7925 =item DESCRIPTION
7926
7927 =over 4
7928
7929 =item Invoking Perl
7930
7931 =item What's in Plan 9 Perl
7932
7933 =item What's not in Plan 9 Perl
7934
7935 =item Perl5 Functions not currently supported in Plan 9 Perl
7936
7937 =item Signals in Plan 9 Perl
7938
7939 =back
7940
7941 =item COMPILING AND INSTALLING PERL ON PLAN 9
7942
7943 =over 4
7944
7945 =item Installing Perl Documentation on Plan 9
7946
7947 =back
7948
7949 =item BUGS
7950
7951 =item Revision date
7952
7953 =item AUTHOR
7954
7955 =back
7956
7957 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7958
7959 =over 4
7960
7961 =item DESCRIPTION
7962
7963 =over 4
7964
7965 =item Solaris Version Numbers.
7966
7967 =back
7968
7969 =item RESOURCES
7970
7971 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7972
7973 =item SETTING UP
7974
7975 =over 4
7976
7977 =item File Extraction Problems on Solaris.
7978
7979 =item Compiler and Related Tools on Solaris.
7980
7981 =item Environment for Compiling Perl on Solaris
7982
7983 =back
7984
7985 =item RUN CONFIGURE.
7986
7987 =over 4
7988
7989 =item 64-bit Issues with Perl on Solaris.
7990
7991 =item Threads in Perl on Solaris.
7992
7993 =item Malloc Issues with Perl on Solaris.
7994
7995 =back
7996
7997 =item MAKE PROBLEMS.
7998
7999 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8000 relocation error:, dlopen: stub interception failed, #error "No
8001 DATAMODEL_NATIVE specified", sh: ar: not found
8002
8003 =item MAKE TEST
8004
8005 =over 4
8006
8007 =item op/stat.t test 4 in Solaris
8008
8009 =item nss_delete core dump from op/pwent or op/grent
8010
8011 =back
8012
8013 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8014
8015 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8016
8017 =over 4
8018
8019 =item Limits on Numbers of Open Files on Solaris.
8020
8021 =back
8022
8023 =item SOLARIS-SPECIFIC MODULES.
8024
8025 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8026
8027 =over 4
8028
8029 =item Proc::ProcessTable on Solaris
8030
8031 =item BSD::Resource on Solaris
8032
8033 =item Net::SSLeay on Solaris
8034
8035 =back
8036
8037 =item AUTHOR
8038
8039 =item LAST MODIFIED
8040
8041 =back
8042
8043 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8044 Digital UNIX formerly known as DEC OSF/1) systems
8045
8046 =over 4
8047
8048 =item DESCRIPTION
8049
8050 =over 4
8051
8052 =item Compiling Perl 5 on Tru64
8053
8054 =item Using Large Files with Perl on Tru64
8055
8056 =item Threaded Perl on Tru64
8057
8058 =item Long Doubles on Tru64
8059
8060 =item 64-bit Perl on Tru64
8061
8062 =item Warnings about floating-point overflow when compiling Perl on Tru64
8063
8064 =back
8065
8066 =item Testing Perl on Tru64
8067
8068 =item ext/ODBM_File/odbm Test Failing With Static Builds
8069
8070 =item Perl Fails Because Of Unresolved Symbol sockatmark
8071
8072 =item AUTHOR
8073
8074 =back
8075
8076 =head2 perluts - Perl under UTS
8077
8078 =over 4
8079
8080 =item SYNOPSIS
8081
8082 =item DESCRIPTION
8083
8084 =item BUILDING PERL ON UTS
8085
8086 =item Installing the built perl on UTS
8087
8088 =item AUTHOR
8089
8090 =back
8091
8092 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8093
8094 =over 4
8095
8096 =item SYNOPSIS
8097
8098 =item DESCRIPTION
8099
8100 =over 4
8101
8102 =item Unpacking Perl Distribution on VM/ESA
8103
8104 =item Setup Perl and utilities on VM/ESA
8105
8106 =item Configure Perl on VM/ESA
8107
8108 =item Testing Anomalies of Perl on VM/ESA
8109
8110 =item Usage Hints for Perl on VM/ESA
8111
8112 =back
8113
8114 =item AUTHORS
8115
8116 =item SEE ALSO
8117
8118 =over 4
8119
8120 =item Mailing list for Perl on VM/ESA
8121
8122 =back
8123
8124 =back
8125
8126 =head2 perlvms - VMS-specific documentation for Perl
8127
8128 =over 4
8129
8130 =item DESCRIPTION
8131
8132 =item Installation
8133
8134 =item Organization of Perl Images
8135
8136 =over 4
8137
8138 =item Core Images
8139
8140 =item Perl Extensions
8141
8142 =item Installing static extensions
8143
8144 =item Installing dynamic extensions
8145
8146 =back
8147
8148 =item File specifications
8149
8150 =over 4
8151
8152 =item Syntax
8153
8154 =item Wildcard expansion
8155
8156 =item Pipes
8157
8158 =back
8159
8160 =item PERL5LIB and PERLLIB
8161
8162 =item Command line
8163
8164 =over 4
8165
8166 =item I/O redirection and backgrounding
8167
8168 =item Command line switches
8169
8170 -i, -S, -u
8171
8172 =back
8173
8174 =item Perl functions
8175
8176 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8177 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8178 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8179 LIST, waitpid PID,FLAGS
8180
8181 =item Perl variables
8182
8183 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8184
8185 =item Standard modules with VMS-specific differences
8186
8187 =over 4
8188
8189 =item SDBM_File
8190
8191 =back
8192
8193 =item Revision date
8194
8195 =item AUTHOR
8196
8197 =back
8198
8199 =head2 perlvos, README.vos - Perl for Stratus VOS
8200
8201 =over 4
8202
8203 =item SYNOPSIS
8204
8205 =over 4
8206
8207 =item Multiple methods to build perl for VOS
8208
8209 =item Stratus POSIX Support
8210
8211 =back
8212
8213 =item INSTALLING PERL IN VOS
8214
8215 =over 4
8216
8217 =item Compiling Perl 5 on VOS
8218
8219 =item Installing Perl 5 on VOS
8220
8221 =back
8222
8223 =item USING PERL IN VOS
8224
8225 =over 4
8226
8227 =item Unimplemented Features of Perl on VOS
8228
8229 =item Restrictions of Perl on VOS
8230
8231 =item Handling of underflow and overflow
8232
8233 =back
8234
8235 =item TEST STATUS
8236
8237 =item SUPPORT STATUS
8238
8239 =item AUTHOR
8240
8241 =item LAST UPDATE
8242
8243 =back
8244
8245 =head2 perlwin32 - Perl under Windows
8246
8247 =over 4
8248
8249 =item SYNOPSIS
8250
8251 =item DESCRIPTION
8252
8253 =over 4
8254
8255 =item Setting Up Perl on Win32
8256
8257 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8258 SDK 64-bit Compiler, Mingw32 with GCC
8259
8260 =item Building
8261
8262 =item Testing Perl on Win32
8263
8264 =item Installation of Perl on Win32
8265
8266 =item Usage Hints for Perl on Win32
8267
8268 Environment Variables, File Globbing, Using perl from the command line,
8269 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8270 Extensions, Notes on 64-bit Windows
8271
8272 =item Running Perl Scripts
8273
8274 Miscellaneous Things
8275
8276 =back
8277
8278 =item BUGS AND CAVEATS
8279
8280 =item AUTHORS
8281
8282 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8283 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8284 E<lt>nick@ing-simmons.netE<gt>
8285
8286 =item SEE ALSO
8287
8288 =item HISTORY
8289
8290 =back
8291
8292 =head1 PRAGMA DOCUMENTATION
8293
8294 =head2 attrs - set/get attributes of a subroutine (deprecated)
8295
8296 =over 4
8297
8298 =item SYNOPSIS
8299
8300 =item DESCRIPTION
8301
8302 method, locked
8303
8304 =back
8305
8306 =head2 re - Perl pragma to alter regular expression behaviour
8307
8308 =over 4
8309
8310 =item SYNOPSIS
8311
8312 =item DESCRIPTION
8313
8314 =back
8315
8316 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8317
8318 =over 4
8319
8320 =item SYNOPSIS
8321
8322 =item DESCRIPTION
8323
8324 =item FUNCTIONS AND METHODS
8325
8326 new, enqueue LIST, dequeue, dequeue_nb, pending
8327
8328 =item SEE ALSO
8329
8330 =back
8331
8332 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8333 semaphores
8334
8335 =over 4
8336
8337 =item SYNOPSIS
8338
8339 =item DESCRIPTION
8340
8341 =item FUNCTIONS AND METHODS
8342
8343 new, new NUMBER, down, down NUMBER, up, up NUMBER
8344
8345 =back
8346
8347 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8348 data structures between threads
8349
8350 =over 4
8351
8352 =item SYNOPSIS
8353
8354 =item DESCRIPTION
8355
8356 =item EXPORT
8357
8358 =item FUNCTIONS
8359
8360 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8361 cond_broadcast VARIABLE
8362
8363 =item NOTES
8364
8365 =item BUGS
8366
8367 =item AUTHOR
8368
8369 =item SEE ALSO
8370
8371 =back
8372
8373 =head2 threads - Perl extension allowing use of interpreter based threads
8374 from perl
8375
8376 =over 4
8377
8378 =item SYNOPSIS
8379
8380 =item DESCRIPTION
8381
8382 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8383 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8384 threads->list();, async BLOCK;
8385
8386 =item WARNINGS
8387
8388 A thread exited while %d other threads were still running
8389
8390 =item BUGS / TODO
8391
8392 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8393 not threadsafe, will not be
8394
8395 =item AUTHOR and COPYRIGHT
8396
8397 =item SEE ALSO
8398
8399 =back
8400
8401 =head2 attributes - get/set subroutine or variable attributes
8402
8403 =over 4
8404
8405 =item SYNOPSIS
8406
8407 =item DESCRIPTION
8408
8409 =over 4
8410
8411 =item Built-in Attributes
8412
8413 locked, method, lvalue
8414
8415 =item Available Subroutines
8416
8417 get, reftype
8418
8419 =item Package-specific Attribute Handling
8420
8421 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8422
8423 =item Syntax of Attribute Lists
8424
8425 =back
8426
8427 =item EXPORTS
8428
8429 =over 4
8430
8431 =item Default exports
8432
8433 =item Available exports
8434
8435 =item Export tags defined
8436
8437 =back
8438
8439 =item EXAMPLES
8440
8441 =item SEE ALSO
8442
8443 =back
8444
8445 =head2 attrs - set/get attributes of a subroutine (deprecated)
8446
8447 =over 4
8448
8449 =item SYNOPSIS
8450
8451 =item DESCRIPTION
8452
8453 method, locked
8454
8455 =back
8456
8457 =head2 autouse - postpone load of modules until a function is used
8458
8459 =over 4
8460
8461 =item SYNOPSIS
8462
8463 =item DESCRIPTION
8464
8465 =item WARNING
8466
8467 =item AUTHOR
8468
8469 =item SEE ALSO
8470
8471 =back
8472
8473 =head2 base - Establish IS-A relationship with base class at compile time
8474
8475 =over 4
8476
8477 =item SYNOPSIS
8478
8479 =item DESCRIPTION
8480
8481 =item HISTORY
8482
8483 =item SEE ALSO
8484
8485 =back
8486
8487 =head2 bigint - Transparent big integer support for Perl
8488
8489 =over 4
8490
8491 =item SYNOPSIS
8492
8493 =item DESCRIPTION
8494
8495 =over 4
8496
8497 =item OPTIONS
8498
8499 a or accuracy, p or precision, t or trace, l or lib, v or version
8500
8501 =item MATH LIBRARY
8502
8503 =item INTERNAL FORMAT
8504
8505 =item SIGN
8506
8507 =item METHODS
8508
8509 =back
8510
8511 =item MODULES USED
8512
8513 =item EXAMPLES
8514
8515 =item LICENSE
8516
8517 =item SEE ALSO
8518
8519 =item AUTHORS
8520
8521 =back
8522
8523 =head2 bignum - Transparent BigNumber support for Perl
8524
8525 =over 4
8526
8527 =item SYNOPSIS
8528
8529 =item DESCRIPTION
8530
8531 =over 4
8532
8533 =item OPTIONS
8534
8535 a or accuracy, p or precision, t or trace, l or lib, v or version
8536
8537 =item MATH LIBRARY
8538
8539 =item INTERNAL FORMAT
8540
8541 =item SIGN
8542
8543 =item METHODS
8544
8545 =back
8546
8547 =item MODULES USED
8548
8549 =item EXAMPLES
8550
8551 =item LICENSE
8552
8553 =item SEE ALSO
8554
8555 =item AUTHORS
8556
8557 =back
8558
8559 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8560
8561 =over 4
8562
8563 =item SYNOPSIS
8564
8565 =item DESCRIPTION
8566
8567 =over 4
8568
8569 =item MODULES USED
8570
8571 =item MATH LIBRARY
8572
8573 =item SIGN
8574
8575 =item METHODS
8576
8577 =back
8578
8579 =item EXAMPLES
8580
8581         perl -Mbigrat -le 'print sqrt(33)'
8582         perl -Mbigrat -le 'print 2*255'
8583         perl -Mbigrat -le 'print 4.5+2*255'
8584         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
8585         perl -Mbigrat -le 'print 12->is_odd()';
8586
8587 =item LICENSE
8588
8589 =item SEE ALSO
8590
8591 =item AUTHORS
8592
8593 =back
8594
8595 =head2 blib - Use MakeMaker's uninstalled version of a package
8596
8597 =over 4
8598
8599 =item SYNOPSIS
8600
8601 =item DESCRIPTION
8602
8603 =item BUGS
8604
8605 =item AUTHOR
8606
8607 =back
8608
8609 =head2 bytes - Perl pragma to force byte semantics rather than character
8610 semantics
8611
8612 =over 4
8613
8614 =item SYNOPSIS
8615
8616 =item DESCRIPTION
8617
8618 =item SEE ALSO
8619
8620 =back
8621
8622 =head2 charnames - define character names for C<\N{named}> string literal
8623 escapes
8624
8625 =over 4
8626
8627 =item SYNOPSIS
8628
8629 =item DESCRIPTION
8630
8631 =item CUSTOM TRANSLATORS
8632
8633 =item charnames::viacode(code)
8634
8635 =item charnames::vianame(name)
8636
8637 =item ALIASES
8638
8639 =item ILLEGAL CHARACTERS
8640
8641 =item BUGS
8642
8643 =back
8644
8645 =head2 constant - Perl pragma to declare constants
8646
8647 =over 4
8648
8649 =item SYNOPSIS
8650
8651 =item DESCRIPTION
8652
8653 =item NOTES
8654
8655 =over 4
8656
8657 =item List constants
8658
8659 =item Defining multiple constants at once
8660
8661 =item Magic constants
8662
8663 =back
8664
8665 =item TECHNICAL NOTES
8666
8667 =item BUGS
8668
8669 =item AUTHOR
8670
8671 =item COPYRIGHT
8672
8673 =back
8674
8675 =head2 diagnostics - Perl compiler pragma to force verbose warning
8676 diagnostics
8677
8678 =over 4
8679
8680 =item SYNOPSIS
8681
8682 =item DESCRIPTION
8683
8684 =over 4
8685
8686 =item The C<diagnostics> Pragma
8687
8688 =item The I<splain> Program
8689
8690 =back
8691
8692 =item EXAMPLES
8693
8694 =item INTERNALS
8695
8696 =item BUGS
8697
8698 =item AUTHOR
8699
8700 =back
8701
8702 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8703
8704 =over 4
8705
8706 =item SYNOPSIS
8707
8708 =item ABSTRACT
8709
8710 =item USAGE
8711
8712 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8713 I<ENCNAME_IN> ...] ;, no encoding;
8714
8715 =item CAVEATS
8716
8717 =over 4
8718
8719 =item NOT SCOPED
8720
8721 =item DO NOT MIX MULTIPLE ENCODINGS
8722
8723 =back
8724
8725 =item Non-ASCII Identifiers and Filter option
8726
8727 use encoding I<ENCNAME> Filter=E<gt>1;
8728
8729 =item EXAMPLE - Greekperl
8730
8731 =item KNOWN PROBLEMS
8732
8733 =item SEE ALSO
8734
8735 =back
8736
8737 =head2 fields - compile-time class fields
8738
8739 =over 4
8740
8741 =item SYNOPSIS
8742
8743 =item DESCRIPTION
8744
8745 new, phash
8746
8747 =item SEE ALSO
8748
8749 =back
8750
8751 =head2 filetest - Perl pragma to control the filetest permission operators
8752
8753 =over 4
8754
8755 =item SYNOPSIS
8756
8757 =item DESCRIPTION
8758
8759 =over 4
8760
8761 =item subpragma access
8762
8763 =back
8764
8765 =back
8766
8767 =head2 if - C<use> a Perl module if a condition holds
8768
8769 =over 4
8770
8771 =item SYNOPSIS
8772
8773 =item DESCRIPTION
8774
8775 =item BUGS
8776
8777 =item AUTHOR
8778
8779 =back
8780
8781 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8782 point
8783
8784 =over 4
8785
8786 =item SYNOPSIS
8787
8788 =item DESCRIPTION
8789
8790 =back
8791
8792 =head2 less - perl pragma to request less of something from the compiler
8793
8794 =over 4
8795
8796 =item SYNOPSIS
8797
8798 =item DESCRIPTION
8799
8800 =back
8801
8802 =head2 lib - manipulate @INC at compile time
8803
8804 =over 4
8805
8806 =item SYNOPSIS
8807
8808 =item DESCRIPTION
8809
8810 =over 4
8811
8812 =item Adding directories to @INC
8813
8814 =item Deleting directories from @INC
8815
8816 =item Restoring original @INC
8817
8818 =back
8819
8820 =item CAVEATS
8821
8822 =item NOTES
8823
8824 =item SEE ALSO
8825
8826 =item AUTHOR
8827
8828 =back
8829
8830 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8831 operations
8832
8833 =over 4
8834
8835 =item SYNOPSIS
8836
8837 =item DESCRIPTION
8838
8839 =back
8840
8841 =head2 open - perl pragma to set default PerlIO layers for input and output
8842
8843 =over 4
8844
8845 =item SYNOPSIS
8846
8847 =item DESCRIPTION
8848
8849 =item NONPERLIO FUNCTIONALITY
8850
8851 =item IMPLEMENTATION DETAILS
8852
8853 =item SEE ALSO
8854
8855 =back
8856
8857 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8858
8859 =over 4
8860
8861 =item SYNOPSIS  
8862
8863 =item DESCRIPTION
8864
8865 =item SEE ALSO
8866
8867 =back
8868
8869 =head2 overload - Package for overloading perl operations
8870
8871 =over 4
8872
8873 =item SYNOPSIS
8874
8875 =item DESCRIPTION
8876
8877 =over 4
8878
8879 =item Declaration of overloaded functions
8880
8881 =item Calling Conventions for Binary Operations
8882
8883 FALSE, TRUE, C<undef>
8884
8885 =item Calling Conventions for Unary Operations
8886
8887 =item Calling Conventions for Mutators
8888
8889 C<++> and C<-->, C<x=> and other assignment versions
8890
8891 =item Overloadable Operations
8892
8893 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8894 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8895 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8896
8897 =item Inheritance and overloading
8898
8899 Strings as values of C<use overload> directive, Overloading of an operation
8900 is inherited by derived classes
8901
8902 =back
8903
8904 =item SPECIAL SYMBOLS FOR C<use overload>
8905
8906 =over 4
8907
8908 =item Last Resort
8909
8910 =item Fallback
8911
8912 C<undef>, TRUE, defined, but FALSE
8913
8914 =item Copy Constructor
8915
8916 B<Example>
8917
8918 =back
8919
8920 =item MAGIC AUTOGENERATION
8921
8922 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8923 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8924 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8925 I<Copy operator>
8926
8927 =item Losing overloading
8928
8929 =item Run-time Overloading
8930
8931 =item Public functions
8932
8933 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8934
8935 =item Overloading constants
8936
8937 integer, float, binary, q, qr
8938
8939 =item IMPLEMENTATION
8940
8941 =item Metaphor clash
8942
8943 =item Cookbook
8944
8945 =over 4
8946
8947 =item Two-face scalars
8948
8949 =item Two-face references
8950
8951 =item Symbolic calculator
8952
8953 =item I<Really> symbolic calculator
8954
8955 =back
8956
8957 =item AUTHOR
8958
8959 =item DIAGNOSTICS
8960
8961 Odd number of arguments for overload::constant, `%s' is not an overloadable
8962 type, `%s' is not a code reference
8963
8964 =item BUGS
8965
8966 =back
8967
8968 =head2 re - Perl pragma to alter regular expression behaviour
8969
8970 =over 4
8971
8972 =item SYNOPSIS
8973
8974 =item DESCRIPTION
8975
8976 =back
8977
8978 =head2 sigtrap - Perl pragma to enable simple signal handling
8979
8980 =over 4
8981
8982 =item SYNOPSIS
8983
8984 =item DESCRIPTION
8985
8986 =item OPTIONS
8987
8988 =over 4
8989
8990 =item SIGNAL HANDLERS
8991
8992 B<stack-trace>, B<die>, B<handler> I<your-handler>
8993
8994 =item SIGNAL LISTS
8995
8996 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8997
8998 =item OTHER
8999
9000 B<untrapped>, B<any>, I<signal>, I<number>
9001
9002 =back
9003
9004 =item EXAMPLES
9005
9006 =back
9007
9008 =head2 sort - perl pragma to control sort() behaviour
9009
9010 =over 4
9011
9012 =item SYNOPSIS
9013
9014 =item DESCRIPTION
9015
9016 =item CAVEATS
9017
9018 =back
9019
9020 =head2 strict - Perl pragma to restrict unsafe constructs
9021
9022 =over 4
9023
9024 =item SYNOPSIS
9025
9026 =item DESCRIPTION
9027
9028 C<strict refs>, C<strict vars>, C<strict subs>
9029
9030 =back
9031
9032 =head2 subs - Perl pragma to predeclare sub names
9033
9034 =over 4
9035
9036 =item SYNOPSIS
9037
9038 =item DESCRIPTION
9039
9040 =back
9041
9042 =head2 threads - Perl extension allowing use of interpreter based threads
9043 from perl
9044
9045 =over 4
9046
9047 =item SYNOPSIS
9048
9049 =item DESCRIPTION
9050
9051 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9052 threads->self, $thread->tid, threads->yield();, threads->list();, async
9053 BLOCK;
9054
9055 =item WARNINGS
9056
9057 A thread exited while %d other threads were still running
9058
9059 =item BUGS / TODO
9060
9061 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
9062 not threadsafe, will not be
9063
9064 =item AUTHOR and COPYRIGHT
9065
9066 =item SEE ALSO
9067
9068 =back
9069
9070 =head2 threadshared, threads::shared - Perl extension for sharing data
9071 structures between threads
9072
9073 =over 4
9074
9075 =item SYNOPSIS
9076
9077 =item DESCRIPTION
9078
9079 =item EXPORT
9080
9081 =item FUNCTIONS
9082
9083 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9084 cond_broadcast VARIABLE
9085
9086 =item NOTES
9087
9088 =item BUGS
9089
9090 =item AUTHOR
9091
9092 =item SEE ALSO
9093
9094 =back
9095
9096 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
9097
9098 =over 4
9099
9100 =item SYNOPSIS
9101
9102 =item DESCRIPTION
9103
9104 =item FUNCTIONS AND METHODS
9105
9106 new, enqueue LIST, dequeue, dequeue_nb, pending
9107
9108 =item SEE ALSO
9109
9110 =back
9111
9112 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
9113 semaphores
9114
9115 =over 4
9116
9117 =item SYNOPSIS
9118
9119 =item DESCRIPTION
9120
9121 =item FUNCTIONS AND METHODS
9122
9123 new, new NUMBER, down, down NUMBER, up, up NUMBER
9124
9125 =back
9126
9127 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9128 code
9129
9130 =over 4
9131
9132 =item SYNOPSIS
9133
9134 =item DESCRIPTION
9135
9136 =over 4
9137
9138 =item Utility functions
9139
9140 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9141 utf8::encode($string), $flag = utf8::decode($string), $flag =
9142 utf8::valid(STRING)
9143
9144 =back
9145
9146 =item BUGS
9147
9148 =item SEE ALSO
9149
9150 =back
9151
9152 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9153
9154 =over 4
9155
9156 =item SYNOPSIS
9157
9158 =item DESCRIPTION
9159
9160 =back
9161
9162 =head2 vmsish - Perl pragma to control VMS-specific language features
9163
9164 =over 4
9165
9166 =item SYNOPSIS
9167
9168 =item DESCRIPTION
9169
9170 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9171
9172 =back
9173
9174 =head2 warnings - Perl pragma to control optional warnings
9175
9176 =over 4
9177
9178 =item SYNOPSIS
9179
9180 =item DESCRIPTION
9181
9182 use warnings::register, warnings::enabled(), warnings::enabled($category),
9183 warnings::enabled($object), warnings::warn($message),
9184 warnings::warn($category, $message), warnings::warn($object, $message),
9185 warnings::warnif($message), warnings::warnif($category, $message),
9186 warnings::warnif($object, $message)
9187
9188 =back
9189
9190 =head2 warnings::register - warnings import function
9191
9192 =over 4
9193
9194 =item SYNOPSIS
9195
9196 =item DESCRIPTION
9197
9198 =back
9199
9200 =head1 MODULE DOCUMENTATION
9201
9202 =head2 AnyDBM_File - provide framework for multiple DBMs
9203
9204 =over 4
9205
9206 =item SYNOPSIS
9207
9208 =item DESCRIPTION
9209
9210 =over 4
9211
9212 =item DBM Comparisons
9213
9214 [0], [1], [2], [3]
9215
9216 =back
9217
9218 =item SEE ALSO
9219
9220 =back
9221
9222 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9223
9224 =over 4
9225
9226 =item VERSION
9227
9228 =item SYNOPSIS
9229
9230 =item DESCRIPTION
9231
9232 [0], [1], [2], [3], [4], [5]
9233
9234 =over 4
9235
9236 =item Typed lexicals
9237
9238 =item Type-specific attribute handlers
9239
9240 =item Non-interpretive attribute handlers
9241
9242 =item Phase-specific attribute handlers
9243
9244 =item Attributes as C<tie> interfaces
9245
9246 =back
9247
9248 =item EXAMPLES
9249
9250 =item DIAGNOSTICS
9251
9252 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9253 attributes>, C<Declaration of %s attribute in package %s may clash with
9254 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9255 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9256 be able to apply END handler>
9257
9258 =item AUTHOR
9259
9260 =item BUGS
9261
9262 =item COPYRIGHT
9263
9264 =back
9265
9266 =head2 AutoLoader - load subroutines only on demand
9267
9268 =over 4
9269
9270 =item SYNOPSIS
9271
9272 =item DESCRIPTION
9273
9274 =over 4
9275
9276 =item Subroutine Stubs
9277
9278 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9279
9280 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9281
9282 =item Package Lexicals
9283
9284 =item Not Using AutoLoader
9285
9286 =item B<AutoLoader> vs. B<SelfLoader>
9287
9288 =back
9289
9290 =item CAVEATS
9291
9292 =item SEE ALSO
9293
9294 =back
9295
9296 =head2 AutoSplit - split a package for autoloading
9297
9298 =over 4
9299
9300 =item SYNOPSIS
9301
9302 =item DESCRIPTION
9303
9304 $keep, $check, $modtime
9305
9306 =over 4
9307
9308 =item Multiple packages
9309
9310 =back
9311
9312 =item DIAGNOSTICS
9313
9314 =back
9315
9316 =head2 B - The Perl Compiler
9317
9318 =over 4
9319
9320 =item SYNOPSIS
9321
9322 =item DESCRIPTION
9323
9324 =item OVERVIEW OF CLASSES
9325
9326 =over 4
9327
9328 =item SV-RELATED CLASSES
9329
9330 =item B::SV METHODS
9331
9332 REFCNT, FLAGS
9333
9334 =item B::IV METHODS
9335
9336 IV, IVX, UVX, int_value, needs64bits, packiv
9337
9338 =item B::NV METHODS
9339
9340 NV, NVX
9341
9342 =item B::RV METHODS
9343
9344 RV
9345
9346 =item B::PV METHODS
9347
9348 PV, RV, PVX
9349
9350 =item B::PVMG METHODS
9351
9352 MAGIC, SvSTASH
9353
9354 =item B::MAGIC METHODS
9355
9356 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9357
9358 =item B::PVLV METHODS
9359
9360 TARGOFF, TARGLEN, TYPE, TARG
9361
9362 =item B::BM METHODS
9363
9364 USEFUL, PREVIOUS, RARE, TABLE
9365
9366 =item B::GV METHODS
9367
9368 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9369 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9370
9371 =item B::IO METHODS
9372
9373 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9374 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9375
9376 =item B::AV METHODS
9377
9378 FILL, MAX, OFF, ARRAY, AvFLAGS
9379
9380 =item B::CV METHODS
9381
9382 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9383 CvFLAGS, const_sv
9384
9385 =item B::HV METHODS
9386
9387 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9388
9389 =item OP-RELATED CLASSES
9390
9391 =item B::OP METHODS
9392
9393 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9394
9395 =item B::UNOP METHOD
9396
9397 first
9398
9399 =item B::BINOP METHOD
9400
9401 last
9402
9403 =item B::LOGOP METHOD
9404
9405 other
9406
9407 =item B::LISTOP METHOD
9408
9409 children
9410
9411 =item B::PMOP METHODS
9412
9413 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9414 pmpermflags, precomp, pmoffet
9415
9416 =item B::SVOP METHOD
9417
9418 sv, gv
9419
9420 =item B::PADOP METHOD
9421
9422 padix
9423
9424 =item B::PVOP METHOD
9425
9426 pv
9427
9428 =item B::LOOP METHODS
9429
9430 redoop, nextop, lastop
9431
9432 =item B::COP METHODS
9433
9434 label, stash, file, cop_seq, arybase, line
9435
9436 =back
9437
9438 =item FUNCTIONS EXPORTED BY C<B>
9439
9440 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9441 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9442 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9443 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9444 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9445
9446 =item AUTHOR
9447
9448 =back
9449
9450 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9451 bytecode
9452
9453 =over 4
9454
9455 =item SYNOPSIS
9456
9457 =item DESCRIPTION
9458
9459 %insn_data, @insn_name, @optype, @specialsv_name
9460
9461 =item AUTHOR
9462
9463 =back
9464
9465 =head2 B::Assembler - Assemble Perl bytecode
9466
9467 =over 4
9468
9469 =item SYNOPSIS
9470
9471 =item DESCRIPTION
9472
9473 =item AUTHORS
9474
9475 =back
9476
9477 =head2 B::Bblock - Walk basic blocks
9478
9479 =over 4
9480
9481 =item SYNOPSIS
9482
9483 =item DESCRIPTION
9484
9485 =over 4
9486
9487 =item Functions
9488
9489 B<find_leaders>
9490
9491 =back
9492
9493 =item AUTHOR
9494
9495 =back
9496
9497 =head2 B::Bytecode - Perl compiler's bytecode backend
9498
9499 =over 4
9500
9501 =item SYNOPSIS
9502
9503 =item DESCRIPTION
9504
9505 =item OPTIONS
9506
9507 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9508 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9509 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9510
9511 =item EXAMPLES
9512
9513 =item BUGS
9514
9515 =item AUTHORS
9516
9517 =back
9518
9519 =head2 B::C - Perl compiler's C backend
9520
9521 =over 4
9522
9523 =item SYNOPSIS
9524
9525 =item DESCRIPTION
9526
9527 =item OPTIONS
9528
9529 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9530 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9531 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9532 B<-llimit>
9533
9534 =item EXAMPLES
9535
9536 =item BUGS
9537
9538 =item AUTHOR
9539
9540 =back
9541
9542 =head2 B::CC - Perl compiler's optimized C translation backend
9543
9544 =over 4
9545
9546 =item SYNOPSIS
9547
9548 =item DESCRIPTION
9549
9550 =item OPTIONS
9551
9552 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9553 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9554 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9555
9556 =item EXAMPLES
9557
9558 =item BUGS
9559
9560 =item DIFFERENCES
9561
9562 =over 4
9563
9564 =item Loops
9565
9566 =item Context of ".."
9567
9568 =item Arithmetic
9569
9570 =item Deprecated features
9571
9572 =back
9573
9574 =item AUTHOR
9575
9576 =back
9577
9578 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9579
9580 =over 4
9581
9582 =item SYNOPSIS
9583
9584 =item DESCRIPTION
9585
9586 =item EXAMPLE
9587
9588 =item OPTIONS
9589
9590 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9591 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9592 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9593
9594 =item FORMATTING SPECIFICATIONS
9595
9596 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9597 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9598 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9599 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9600 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9601 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9602 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9603 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9604
9605 =item ABBREVIATIONS
9606
9607 =over 4
9608
9609 =item OP flags abbreviations
9610
9611 =item OP class abbreviations
9612
9613 =back
9614
9615 =item Using B::Concise outside of the O framework
9616
9617 =item AUTHOR
9618
9619 =back
9620
9621 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9622
9623 =over 4
9624
9625 =item SYNOPSIS
9626
9627 =item DESCRIPTION
9628
9629 =item AUTHOR
9630
9631 =back
9632
9633 =head2 B::Deparse - Perl compiler backend to produce perl code
9634
9635 =over 4
9636
9637 =item SYNOPSIS
9638
9639 =item DESCRIPTION
9640
9641 =item OPTIONS
9642
9643 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9644 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9645
9646 =item USING B::Deparse AS A MODULE
9647
9648 =over 4
9649
9650 =item Synopsis
9651
9652 =item Description
9653
9654 =item new
9655
9656 =item ambient_pragmas
9657
9658 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9659
9660 =item coderef2text
9661
9662 =back
9663
9664 =item BUGS
9665
9666 =item AUTHOR
9667
9668 =back
9669
9670 =head2 B::Disassembler - Disassemble Perl bytecode
9671
9672 =over 4
9673
9674 =item SYNOPSIS
9675
9676 =item DESCRIPTION
9677
9678 =item AUTHOR
9679
9680 =back
9681
9682 =head2 B::Lint - Perl lint
9683
9684 =over 4
9685
9686 =item SYNOPSIS
9687
9688 =item DESCRIPTION
9689
9690 =item OPTIONS AND LINT CHECKS
9691
9692 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9693 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9694
9695 =item NON LINT-CHECK OPTIONS
9696
9697 B<-u Package>
9698
9699 =item BUGS
9700
9701 =item AUTHOR
9702
9703 =back
9704
9705 =head2 B::O, O - Generic interface to Perl Compiler backends
9706
9707 =over 4
9708
9709 =item SYNOPSIS
9710
9711 =item DESCRIPTION
9712
9713 =item CONVENTIONS
9714
9715 =item IMPLEMENTATION
9716
9717 =item BUGS
9718
9719 =item AUTHOR
9720
9721 =back
9722
9723 =head2 B::Showlex - Show lexical variables used in functions or files
9724
9725 =over 4
9726
9727 =item SYNOPSIS
9728
9729 =item DESCRIPTION
9730
9731 =item AUTHOR
9732
9733 =back
9734
9735 =head2 B::Stackobj - Helper module for CC backend
9736
9737 =over 4
9738
9739 =item SYNOPSIS
9740
9741 =item DESCRIPTION
9742
9743 =item AUTHOR
9744
9745 =back
9746
9747 =head2 B::Stash - show what stashes are loaded
9748
9749 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9750
9751 =over 4
9752
9753 =item SYNOPSIS
9754
9755 =item DESCRIPTION
9756
9757 =item AUTHOR
9758
9759 =back
9760
9761 =head2 B::Xref - Generates cross reference reports for Perl programs
9762
9763 =over 4
9764
9765 =item SYNOPSIS
9766
9767 =item DESCRIPTION
9768
9769 =item OPTIONS
9770
9771 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9772
9773 =item BUGS
9774
9775 =item AUTHOR
9776
9777 =back
9778
9779 =head2 Bblock, B::Bblock - Walk basic blocks
9780
9781 =over 4
9782
9783 =item SYNOPSIS
9784
9785 =item DESCRIPTION
9786
9787 =over 4
9788
9789 =item Functions
9790
9791 B<find_leaders>
9792
9793 =back
9794
9795 =item AUTHOR
9796
9797 =back
9798
9799 =head2 Benchmark - benchmark running times of Perl code
9800
9801 =over 4
9802
9803 =item SYNOPSIS
9804
9805 =item DESCRIPTION
9806
9807 =over 4
9808
9809 =item Methods
9810
9811 new, debug, iters
9812
9813 =item Standard Exports
9814
9815 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9816 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9817 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9818
9819 =item Optional Exports
9820
9821 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9822 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9823 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9824
9825 =back
9826
9827 =item NOTES
9828
9829 =item EXAMPLES
9830
9831 =item INHERITANCE
9832
9833 =item CAVEATS
9834
9835 =item SEE ALSO
9836
9837 =item AUTHORS
9838
9839 =item MODIFICATION HISTORY
9840
9841 =back
9842
9843 =head2 ByteLoader - load byte compiled perl code
9844
9845 =over 4
9846
9847 =item SYNOPSIS
9848
9849 =item DESCRIPTION
9850
9851 =item AUTHOR
9852
9853 =item SEE ALSO
9854
9855 =back
9856
9857 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9858
9859 =over 4
9860
9861 =item SYNOPSIS
9862
9863 =item DESCRIPTION
9864
9865 =item OPTIONS
9866
9867 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9868 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9869 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9870
9871 =item EXAMPLES
9872
9873 =item BUGS
9874
9875 =item AUTHORS
9876
9877 =back
9878
9879 =head2 CGI - Simple Common Gateway Interface Class
9880
9881 =over 4
9882
9883 =item SYNOPSIS
9884
9885 =item ABSTRACT
9886
9887 =item DESCRIPTION
9888
9889 =over 4
9890
9891 =item PROGRAMMING STYLE
9892
9893 =item CALLING CGI.PM ROUTINES
9894
9895 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9896
9897 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9898
9899 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9900
9901 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9902
9903 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9904
9905 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9906
9907 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9908
9909 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9910
9911 =item DELETING A PARAMETER COMPLETELY:
9912
9913 =item DELETING ALL PARAMETERS:
9914
9915 =item DIRECT ACCESS TO THE PARAMETER LIST:
9916
9917 =item FETCHING THE PARAMETER LIST AS A HASH:
9918
9919 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9920
9921 =item RETRIEVING CGI ERRORS
9922
9923 =item USING THE FUNCTION-ORIENTED INTERFACE
9924
9925 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9926 B<:standard>, B<:all>
9927
9928 =item PRAGMAS
9929
9930 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9931 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9932 -private_tempfiles
9933
9934 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9935
9936 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9937 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9938 a </ul> tag)
9939
9940 =back
9941
9942 =item GENERATING DYNAMIC DOCUMENTS
9943
9944 =over 4
9945
9946 =item CREATING A STANDARD HTTP HEADER:
9947
9948 =item GENERATING A REDIRECTION HEADER
9949
9950 =item CREATING THE HTML DOCUMENT HEADER
9951
9952 B<Parameters:>, 4, 5, 6..
9953
9954 =item ENDING THE HTML DOCUMENT:
9955
9956 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9957
9958 =item OBTAINING THE SCRIPT'S URL
9959
9960 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9961 (B<-query_string>), B<-base>
9962
9963 =item MIXING POST AND URL PARAMETERS
9964
9965 =back
9966
9967 =item CREATING STANDARD HTML ELEMENTS:
9968
9969 =over 4
9970
9971 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9972
9973 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9974
9975 =item HTML SHORTCUTS AND LIST INTERPOLATION
9976
9977 =item NON-STANDARD HTML SHORTCUTS
9978
9979 =item AUTOESCAPING HTML
9980
9981 $escaped_string = escapeHTML("unescaped string");, $charset =
9982 charset([$charset]);, $flag = autoEscape([$flag]);
9983
9984 =item PRETTY-PRINTING HTML
9985
9986 =back
9987
9988 =item CREATING FILL-OUT FORMS:
9989
9990 =over 4
9991
9992 =item CREATING AN ISINDEX TAG
9993
9994 =item STARTING AND ENDING A FORM
9995
9996 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9997
9998 =item CREATING A TEXT FIELD
9999
10000 B<Parameters>
10001
10002 =item CREATING A BIG TEXT FIELD
10003
10004 =item CREATING A PASSWORD FIELD
10005
10006 =item CREATING A FILE UPLOAD FIELD
10007
10008 B<Parameters>
10009
10010 =item CREATING A POPUP MENU
10011
10012 =item CREATING A SCROLLING LIST
10013
10014 B<Parameters:>
10015
10016 =item CREATING A GROUP OF RELATED CHECKBOXES
10017
10018 B<Parameters:>
10019
10020 =item CREATING A STANDALONE CHECKBOX
10021
10022 B<Parameters:>
10023
10024 =item CREATING A RADIO BUTTON GROUP
10025
10026 B<Parameters:>
10027
10028 =item CREATING A SUBMIT BUTTON 
10029
10030 B<Parameters:>
10031
10032 =item CREATING A RESET BUTTON
10033
10034 =item CREATING A DEFAULT BUTTON
10035
10036 =item CREATING A HIDDEN FIELD
10037
10038 B<Parameters:>
10039
10040 =item CREATING A CLICKABLE IMAGE BUTTON
10041
10042 B<Parameters:>
10043
10044 =item CREATING A JAVASCRIPT ACTION BUTTON
10045
10046 =back
10047
10048 =item HTTP COOKIES
10049
10050 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10051 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10052
10053 =item WORKING WITH FRAMES
10054
10055 1. Create a <Frameset> document, 2. Specify the destination for the
10056 document in the HTTP header, 3. Specify the destination for the document in
10057 the <form> tag
10058
10059 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10060
10061 =item DEBUGGING
10062
10063 =over 4
10064
10065 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10066
10067 =back
10068
10069 =item FETCHING ENVIRONMENT VARIABLES
10070
10071 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10072 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10073 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10074 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10075 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10076
10077 =item USING NPH SCRIPTS
10078
10079 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10080 parameters
10081
10082 =item Server Push
10083
10084 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10085
10086 =item Avoiding Denial of Service Attacks
10087
10088 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10089 basis>, B<2. Globally for all scripts>
10090
10091 =item COMPATIBILITY WITH CGI-LIB.PL
10092
10093 =item AUTHOR INFORMATION
10094
10095 =item CREDITS
10096
10097 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10098 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10099 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10100 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10101 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10102 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10103 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10104 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10105 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10106 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10107 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10108 ...and many many more..
10109
10110 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10111
10112 =item BUGS
10113
10114 =item SEE ALSO
10115
10116 =back
10117
10118 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10119
10120 =over 4
10121
10122 =item SYNOPSIS
10123
10124 =item ABSTRACT
10125
10126 =item DESCRIPTION
10127
10128 =item AUTHOR INFORMATION
10129
10130 =item BUGS
10131
10132 =item SEE ALSO
10133
10134 =back
10135
10136 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10137 other) error log
10138
10139 =over 4
10140
10141 =item SYNOPSIS
10142
10143 =item DESCRIPTION
10144
10145 =item REDIRECTING ERROR MESSAGES
10146
10147 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10148
10149 =over 4
10150
10151 =item Changing the default message
10152
10153 =back
10154
10155 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10156
10157 =item CHANGE LOG
10158
10159 =item AUTHORS
10160
10161 =item SEE ALSO
10162
10163 =back
10164
10165 =head2 CGI::Cookie - Interface to Netscape Cookies
10166
10167 =over 4
10168
10169 =item SYNOPSIS
10170
10171 =item DESCRIPTION
10172
10173 =item USING CGI::Cookie
10174
10175 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10176
10177 =over 4
10178
10179 =item Creating New Cookies
10180
10181 =item Sending the Cookie to the Browser
10182
10183 =item Recovering Previous Cookies
10184
10185 =item Manipulating Cookies
10186
10187 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10188
10189 =back
10190
10191 =item AUTHOR INFORMATION
10192
10193 =item BUGS
10194
10195 =item SEE ALSO
10196
10197 =back
10198
10199 =head2 CGI::Fast - CGI Interface for Fast CGI
10200
10201 =over 4
10202
10203 =item SYNOPSIS
10204
10205 =item DESCRIPTION
10206
10207 =item OTHER PIECES OF THE PUZZLE
10208
10209 =item WRITING FASTCGI PERL SCRIPTS
10210
10211 =item INSTALLING FASTCGI SCRIPTS
10212
10213 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10214
10215 =item EXTERNAL FASTCGI SERVER INVOCATION
10216
10217 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10218
10219 =item CAVEATS
10220
10221 =item AUTHOR INFORMATION
10222
10223 =item BUGS
10224
10225 =item SEE ALSO
10226
10227 =back
10228
10229 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10230
10231 =over 4
10232
10233 =item SYNOPSIS
10234
10235 =item DESCRIPTION
10236
10237 =over 4
10238
10239 =item Tags that won't be formatted
10240
10241 =item Customizing the Indenting
10242
10243 =back
10244
10245 =item BUGS
10246
10247 =item AUTHOR
10248
10249 =item SEE ALSO
10250
10251 =back
10252
10253 =head2 CGI::Push - Simple Interface to Server Push
10254
10255 =over 4
10256
10257 =item SYNOPSIS
10258
10259 =item DESCRIPTION
10260
10261 =item USING CGI::Push
10262
10263 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10264
10265 =over 4
10266
10267 =item Heterogeneous Pages
10268
10269 =item Changing the Page Delay on the Fly
10270
10271 =back
10272
10273 =item INSTALLING CGI::Push SCRIPTS
10274
10275 =item AUTHOR INFORMATION
10276
10277 =item BUGS
10278
10279 =item SEE ALSO
10280
10281 =back
10282
10283 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10284
10285 =over 4
10286
10287 =item SYNOPSIS
10288
10289 =item ABSTRACT
10290
10291 =item DESCRIPTION
10292
10293 =item AUTHOR INFORMATION
10294
10295 =item BUGS
10296
10297 =item SEE ALSO
10298
10299 =back
10300
10301 =head2 CGI::Util - Internal utilities used by CGI module
10302
10303 =over 4
10304
10305 =item SYNOPSIS
10306
10307 =item DESCRIPTION
10308
10309 =item AUTHOR INFORMATION
10310
10311 =item SEE ALSO
10312
10313 =back
10314
10315 =head2 CPAN - query, download and build perl modules from CPAN sites
10316
10317 =over 4
10318
10319 =item SYNOPSIS
10320
10321 =item DESCRIPTION
10322
10323 =over 4
10324
10325 =item Interactive Mode
10326
10327 Searching for authors, bundles, distribution files and modules, make, test,
10328 install, clean  modules or distributions, get, readme, look module or
10329 distribution, ls author, Signals
10330
10331 =item CPAN::Shell
10332
10333 =item autobundle
10334
10335 =item recompile
10336
10337 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10338
10339 =item Programmer's interface
10340
10341 expand($type,@things), expandany(@things), Programming Examples
10342
10343 =item Methods in the other Classes
10344
10345 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10346 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10347 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10348 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10349 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10350 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10351 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10352 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10353 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10354 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10355 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10356 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10357 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10358 CPAN::Distribution::look(), CPAN::Distribution::make(),
10359 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10360 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10361 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10362 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10363 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10364 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10365 CPAN::Module::description(), CPAN::Module::force($method,@args),
10366 CPAN::Module::get(), CPAN::Module::inst_file(),
10367 CPAN::Module::inst_version(), CPAN::Module::install(),
10368 CPAN::Module::look(), CPAN::Module::make(),
10369 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10370 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10371
10372 =item Cache Manager
10373
10374 =item Bundles
10375
10376 =item Prerequisites
10377
10378 =item Finding packages and VERSION
10379
10380 =item Debugging
10381
10382 =item Floppy, Zip, Offline Mode
10383
10384 =back
10385
10386 =item CONFIGURATION
10387
10388 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10389 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10390 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10391 [unshift|push|splice] E<lt>listE<gt>>
10392
10393 =over 4
10394
10395 =item Note on urllist parameter's format
10396
10397 =item urllist parameter has CD-ROM support
10398
10399 =back
10400
10401 =item SECURITY
10402
10403 =item EXPORT
10404
10405 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10406
10407 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10408
10409 =over 4
10410
10411 =item Three basic types of firewalls
10412
10413 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10414
10415 =item Configuring lynx or ncftp for going through a firewall
10416
10417 =back
10418
10419 =item FAQ
10420
10421 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10422
10423 =item BUGS
10424
10425 =item AUTHOR
10426
10427 =item TRANSLATIONS
10428
10429 =item SEE ALSO
10430
10431 =back
10432
10433 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10434
10435 =over 4
10436
10437 =item SYNOPSIS
10438
10439 =item DESCRIPTION
10440
10441 =back
10442
10443 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10444 module
10445
10446 =over 4
10447
10448 =item SYNOPSIS
10449
10450 =item DESCRIPTION
10451
10452 =item  SEE ALSO
10453
10454 =back
10455
10456 =head2 Carp, carp    - warn of errors (from perspective of caller)
10457
10458 =over 4
10459
10460 =item SYNOPSIS
10461
10462 =item DESCRIPTION
10463
10464 =over 4
10465
10466 =item Forcing a Stack Trace
10467
10468 =back
10469
10470 =item BUGS
10471
10472 =back
10473
10474 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10475
10476 =head2 Class::ISA -- report the search path for a class's ISA tree
10477
10478 =over 4
10479
10480 =item SYNOPSIS
10481
10482 =item DESCRIPTION
10483
10484 =item FUNCTIONS
10485
10486 the function Class::ISA::super_path($CLASS), the function
10487 Class::ISA::self_and_super_path($CLASS), the function
10488 Class::ISA::self_and_super_versions($CLASS)
10489
10490 =item CAUTIONARY NOTES
10491
10492 =item COPYRIGHT
10493
10494 =item AUTHOR
10495
10496 =back
10497
10498 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10499
10500 =over 4
10501
10502 =item SYNOPSIS
10503
10504 =item DESCRIPTION
10505
10506 =over 4
10507
10508 =item The C<struct()> function
10509
10510 =item Class Creation at Compile Time
10511
10512 =item Element Types and Accessor Methods
10513
10514 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10515 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10516
10517 =item Initializing with C<new>
10518
10519 =back
10520
10521 =item EXAMPLES
10522
10523 Example 1, Example 2, Example 3
10524
10525 =item Author and Modification History
10526
10527 =back
10528
10529 =head2 Config - access Perl configuration information
10530
10531 =over 4
10532
10533 =item SYNOPSIS
10534
10535 =item DESCRIPTION
10536
10537 myconfig(), config_sh(), config_vars(@names)
10538
10539 =item EXAMPLE
10540
10541 =item WARNING
10542
10543 =item GLOSSARY
10544
10545 =over 4
10546
10547 =item _
10548
10549 C<_a>, C<_exe>, C<_o>
10550
10551 =item a
10552
10553 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10554 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10555 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10556 C<asctime_r_proto>, C<awk>
10557
10558 =item b
10559
10560 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10561
10562 =item c
10563
10564 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10565 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10566 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10567 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10568 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10569 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10570 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10571
10572 =item d
10573
10574 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10575 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10576 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10577 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10578 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10579 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10580 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10581 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10582 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10583 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10584 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10585 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10586 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10587 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10588 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10589 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10590 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10591 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10592 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10593 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10594 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10595 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10596 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10597 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10598 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10599 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10600 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10601 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10602 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10603 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10604 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10605 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10606 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10607 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10608 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10609 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10610 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10611 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10612 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10613 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10614 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10615 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10616 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10617 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10618 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10619 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10620 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10621 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10622 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10623 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10624 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10625 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10626 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10627 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10628 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10629 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10630 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10631 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10632 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10633 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10634 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10635 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10636 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10637 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10638 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10639 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10640 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10641 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10642 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10643 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10644 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10645 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10646 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10647 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10648 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10649 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10650 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10651 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10652 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10653 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10654 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10655 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10656 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10657 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10658 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10659 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10660 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10661 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10662 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10663 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10664
10665 =item e
10666
10667 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10668 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10669 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10670 C<expr>, C<extensions>, C<extras>
10671
10672 =item f
10673
10674 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10675 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10676 C<full_sed>
10677
10678 =item g
10679
10680 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10681 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10682 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10683 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10684 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10685 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10686 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10687 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10688 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10689 C<gzip>
10690
10691 =item h
10692
10693 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10694
10695 =item i
10696
10697 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10698 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10699 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10700 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10701 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10702 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10703 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10704 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10705 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10706 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10707 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10708 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10709 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10710 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10711 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10712 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10713 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10714 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10715 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10716 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10717 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10718 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10719 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10720 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10721
10722 =item k
10723
10724 C<known_extensions>, C<ksh>
10725
10726 =item l
10727
10728 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10729 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10730 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10731 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10732 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10733 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10734 C<lseektype>
10735
10736 =item m
10737
10738 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10739 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10740 C<man3direxp>, C<man3ext>
10741
10742 =item M
10743
10744 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10745 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10746
10747 =item n
10748
10749 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10750 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10751 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10752 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10753 C<nvsize>, C<nvtype>
10754
10755 =item o
10756
10757 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10758 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10759
10760 =item p
10761
10762 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10763 C<perl>, C<perl_patchlevel>
10764
10765 =item P
10766
10767 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10768 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10769 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10770 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10771
10772 =item q
10773
10774 C<quadkind>, C<quadtype>
10775
10776 =item r
10777
10778 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10779 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10780 C<rmail>, C<run>, C<runnm>
10781
10782 =item s
10783
10784 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10785 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10786 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10787 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10788 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10789 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10790 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10791 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10792 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10793 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10794 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10795 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10796 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10797 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10798 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10799 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10800 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10801
10802 =item t
10803
10804 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10805 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10806 C<ttyname_r_proto>
10807
10808 =item u
10809
10810 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10811 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10812 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10813 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10814 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10815 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10816 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10817 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10818 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10819
10820 =item v
10821
10822 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10823 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10824 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10825 C<versiononly>, C<vi>, C<voidflags>
10826
10827 =item x
10828
10829 C<xlibpth>, C<xs_apiversion>
10830
10831 =item y
10832
10833 C<yacc>, C<yaccflags>
10834
10835 =item z
10836
10837 C<zcat>, C<zip>
10838
10839 =back
10840
10841 =item NOTE
10842
10843 =back
10844
10845 =head2 Cwd - get pathname of current working directory
10846
10847 =over 4
10848
10849 =item SYNOPSIS
10850
10851 =item DESCRIPTION
10852
10853 =over 4
10854
10855 =item getcwd and friends
10856
10857 getcwd, cwd, fastcwd, fastgetcwd
10858
10859 =item abs_path and friends
10860
10861 abs_path, realpath, fast_abs_path
10862
10863 =item $ENV{PWD}
10864
10865 =back
10866
10867 =item NOTES
10868
10869 =item SEE ALSO
10870
10871 =back
10872
10873 =head2 DB - programmatic interface to the Perl debugging API (draft,
10874 subject to
10875 change)
10876
10877 =over 4
10878
10879 =item SYNOPSIS
10880
10881 =item DESCRIPTION
10882
10883 =over 4
10884
10885 =item Global Variables
10886
10887  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
10888 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
10889 $DB::lineno
10890
10891 =item API Methods
10892
10893 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10894 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10895
10896 =item Client Callback Methods
10897
10898 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10899 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10900 CLIENT->output(LIST)
10901
10902 =back
10903
10904 =item BUGS
10905
10906 =item AUTHOR
10907
10908 =back
10909
10910 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10911
10912 =over 4
10913
10914 =item SYNOPSIS
10915
10916 =item DESCRIPTION
10917
10918 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10919
10920 =over 4
10921
10922 =item Using DB_File with Berkeley DB version 2 or greater
10923
10924 =item Interface to Berkeley DB
10925
10926 =item Opening a Berkeley DB Database File
10927
10928 =item Default Parameters
10929
10930 =item In Memory Databases
10931
10932 =back
10933
10934 =item DB_HASH
10935
10936 =over 4
10937
10938 =item A Simple Example
10939
10940 =back
10941
10942 =item DB_BTREE
10943
10944 =over 4
10945
10946 =item Changing the BTREE sort order
10947
10948 =item Handling Duplicate Keys 
10949
10950 =item The get_dup() Method
10951
10952 =item The find_dup() Method
10953
10954 =item The del_dup() Method
10955
10956 =item Matching Partial Keys 
10957
10958 =back
10959
10960 =item DB_RECNO
10961
10962 =over 4
10963
10964 =item The 'bval' Option
10965
10966 =item A Simple Example
10967
10968 =item Extra RECNO Methods
10969
10970 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10971 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10972 length, elements);>
10973
10974 =item Another Example
10975
10976 =back
10977
10978 =item THE API INTERFACE
10979
10980 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10981 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10982 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10983 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10984
10985 =item DBM FILTERS
10986
10987 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10988 B<filter_fetch_value>
10989
10990 =over 4
10991
10992 =item The Filter
10993
10994 =item An Example -- the NULL termination problem.
10995
10996 =item Another Example -- Key is a C int.
10997
10998 =back
10999
11000 =item HINTS AND TIPS 
11001
11002 =over 4
11003
11004 =item Locking: The Trouble with fd
11005
11006 =item Safe ways to lock a database
11007
11008 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11009
11010 =item Sharing Databases With C Applications
11011
11012 =item The untie() Gotcha
11013
11014 =back
11015
11016 =item COMMON QUESTIONS
11017
11018 =over 4
11019
11020 =item Why is there Perl source in my database?
11021
11022 =item How do I store complex data structures with DB_File?
11023
11024 =item What does "Invalid Argument" mean?
11025
11026 =item What does "Bareword 'DB_File' not allowed" mean? 
11027
11028 =back
11029
11030 =item REFERENCES
11031
11032 =item HISTORY
11033
11034 =item BUGS
11035
11036 =item AVAILABILITY
11037
11038 =item COPYRIGHT
11039
11040 =item SEE ALSO
11041
11042 =item AUTHOR
11043
11044 =back
11045
11046 =head2 Data::Dumper - stringified perl data structures, suitable for both
11047 printing and C<eval>
11048
11049 =over 4
11050
11051 =item SYNOPSIS
11052
11053 =item DESCRIPTION
11054
11055 =over 4
11056
11057 =item Methods
11058
11059 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
11060 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11061 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11062 I<$OBJ>->Reset
11063
11064 =item Functions
11065
11066 Dumper(I<LIST>)
11067
11068 =item Configuration Variables or Methods
11069
11070 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11071 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11072 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11073 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11074 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11075 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11076 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11077 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11078 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11079 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11080 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11081 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11082 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11083 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11084 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11085
11086 =item Exports
11087
11088 Dumper
11089
11090 =back
11091
11092 =item EXAMPLES
11093
11094 =item BUGS
11095
11096 =item AUTHOR
11097
11098 =item VERSION
11099
11100 =item SEE ALSO
11101
11102 =back
11103
11104 =head2 Devel::DProf - a Perl code profiler
11105
11106 =over 4
11107
11108 =item SYNOPSIS
11109
11110 =item DESCRIPTION
11111
11112 =item PROFILE FORMAT
11113
11114 =item AUTOLOAD
11115
11116 =item ENVIRONMENT
11117
11118 =item BUGS
11119
11120 =item SEE ALSO
11121
11122 =back
11123
11124 =head2 Devel::PPPort, Perl/Pollution/Portability
11125
11126 =over 4
11127
11128 =item SYNOPSIS
11129
11130 =item DESCRIPTION
11131
11132 =over 4
11133
11134 =item WriteFile
11135
11136 =back
11137
11138 =item ppport.h
11139
11140 =item AUTHOR
11141
11142 =item SEE ALSO
11143
11144 =back
11145
11146 =head2 Devel::Peek - A data debugging tool for the XS programmer
11147
11148 =over 4
11149
11150 =item SYNOPSIS
11151
11152 =item DESCRIPTION
11153
11154 =over 4
11155
11156 =item Runtime debugging
11157
11158 =item Memory footprint debugging
11159
11160 =back
11161
11162 =item EXAMPLES
11163
11164 =over 4
11165
11166 =item A simple scalar string
11167
11168 =item A simple scalar number
11169
11170 =item A simple scalar with an extra reference
11171
11172 =item A reference to a simple scalar
11173
11174 =item A reference to an array
11175
11176 =item A reference to a hash
11177
11178 =item Dumping a large array or hash
11179
11180 =item A reference to an SV which holds a C pointer
11181
11182 =item A reference to a subroutine
11183
11184 =back
11185
11186 =item EXPORTS
11187
11188 =item BUGS
11189
11190 =item AUTHOR
11191
11192 =item SEE ALSO
11193
11194 =back
11195
11196 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11197
11198 =over 4
11199
11200 =item SYNOPSIS
11201
11202 =item DESCRIPTION
11203
11204 =back
11205
11206 =head2 Digest:: - Modules that calculate message digests
11207
11208 =over 4
11209
11210 =item SYNOPSIS
11211
11212 =item DESCRIPTION
11213
11214 I<binary>, I<hex>, I<base64>
11215
11216 =item OO INTERFACE
11217
11218 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11219 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11220 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11221
11222 =item SEE ALSO
11223
11224 =item AUTHOR
11225
11226 =back
11227
11228 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11229
11230 =over 4
11231
11232 =item SYNOPSIS
11233
11234 =item DESCRIPTION
11235
11236 =item FUNCTIONS
11237
11238 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11239
11240 =item METHODS
11241
11242 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11243 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11244
11245 =item EXAMPLES
11246
11247 =item SEE ALSO
11248
11249 =item COPYRIGHT
11250
11251 =item AUTHORS
11252
11253 =back
11254
11255 =head2 DirHandle - supply object methods for directory handles
11256
11257 =over 4
11258
11259 =item SYNOPSIS
11260
11261 =item DESCRIPTION
11262
11263 =item NOTES
11264
11265 =back
11266
11267 =head2 Dumpvalue - provides screen dump of Perl data.
11268
11269 =over 4
11270
11271 =item SYNOPSIS
11272
11273 =item DESCRIPTION
11274
11275 =over 4
11276
11277 =item Creation
11278
11279 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11280 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11281 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11282 stopDbSignal
11283
11284 =item Methods
11285
11286 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11287 compactDump, veryCompact, set, get
11288
11289 =back
11290
11291 =back
11292
11293 =head2 DynaLoader - Dynamically load C libraries into Perl code
11294
11295 =over 4
11296
11297 =item SYNOPSIS
11298
11299 =item DESCRIPTION
11300
11301 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11302 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11303 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11304 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11305 bootstrap()
11306
11307 =item AUTHOR
11308
11309 =back
11310
11311 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11312 Perl code
11313
11314 =over 4
11315
11316 =item SYNOPSIS
11317
11318 =item DESCRIPTION
11319
11320 =item AUTHOR
11321
11322 =back
11323
11324 =head2 Encode - character encodings
11325
11326 =over 4
11327
11328 =item SYNOPSIS
11329
11330 =over 4
11331
11332 =item Table of Contents
11333
11334 =back
11335
11336 =item DESCRIPTION
11337
11338 =over 4
11339
11340 =item TERMINOLOGY
11341
11342 =back
11343
11344 =item PERL ENCODING API
11345
11346 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11347 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11348 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11349 CHECK]);
11350
11351 =over 4
11352
11353 =item Listing available encodings
11354
11355 =item Defining Aliases
11356
11357 =back
11358
11359 =item Encoding via PerlIO
11360
11361 =item Handling Malformed Data
11362
11363 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11364 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11365 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11366 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11367 bitmask
11368
11369 =over 4
11370
11371 =item Unimplemented fallback schemes
11372
11373 =back
11374
11375 =item Defining Encodings
11376
11377 =item The UTF-8 flag
11378
11379 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11380
11381 =over 4
11382
11383 =item Messing with Perl's Internals
11384
11385 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11386
11387 =back
11388
11389 =item SEE ALSO
11390
11391 =item MAINTAINER
11392
11393 =back
11394
11395 =head2 Encode::Alias - alias definitions to encodings
11396
11397 =over 4
11398
11399 =item SYNOPSIS
11400
11401 =item DESCRIPTION
11402
11403 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11404 reference, e.g.:
11405
11406 =over 4
11407
11408 =item Alias overloading
11409
11410 =back
11411
11412 =item SEE ALSO
11413
11414 =back
11415
11416 =head2 Encode::Byte - Single Byte Encodings
11417
11418 =over 4
11419
11420 =item SYNOPSIS
11421
11422 =item ABSTRACT
11423
11424 =item DESCRIPTION
11425
11426 =item SEE ALSO
11427
11428 =back
11429
11430 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11431
11432 =head2 Encode::CN - China-based Chinese Encodings
11433
11434 =over 4
11435
11436 =item SYNOPSIS
11437
11438 =item DESCRIPTION
11439
11440 =item NOTES
11441
11442 =item BUGS
11443
11444 =item SEE ALSO
11445
11446 =back
11447
11448 =head2 Encode::CN::HZ -- internally used by Encode::CN
11449
11450 =head2 Encode::Config -- internally used by Encode
11451
11452 =head2 Encode::EBCDIC - EBCDIC Encodings
11453
11454 =over 4
11455
11456 =item SYNOPSIS
11457
11458 =item ABSTRACT
11459
11460 =item DESCRIPTION
11461
11462 =item SEE ALSO
11463
11464 =back
11465
11466 =head2 Encode::Encoding - Encode Implementation Base Class
11467
11468 =over 4
11469
11470 =item SYNOPSIS
11471
11472 =item DESCRIPTION
11473
11474 =over 4
11475
11476 =item Methods you should implement
11477
11478 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11479
11480 =item Other methods defined in Encode::Encodings
11481
11482 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11483
11484 =item Example: Encode::ROT13
11485
11486 =back
11487
11488 =item Why the heck Encode API is different?
11489
11490 =over 4
11491
11492 =item Compiled Encodings
11493
11494 =back
11495
11496 =item SEE ALSO
11497
11498 Scheme 1, Scheme 2, Other Schemes
11499
11500 =back
11501
11502 =head2 Encode::Guess -- Guesses encoding from data
11503
11504 =over 4
11505
11506 =item SYNOPSIS
11507
11508 =item ABSTRACT
11509
11510 =item DESCRIPTION
11511
11512 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11513 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11514 guess_encoding($data, [, I<list of suspects>])
11515
11516 =item CAVEATS
11517
11518 =item TO DO
11519
11520 =item SEE ALSO
11521
11522 =back
11523
11524 =head2 Encode::JP - Japanese Encodings
11525
11526 =over 4
11527
11528 =item SYNOPSIS
11529
11530 =item ABSTRACT
11531
11532 =item DESCRIPTION
11533
11534 =item Note on ISO-2022-JP(-1)?
11535
11536 =item BUGS
11537
11538 =item SEE ALSO
11539
11540 =back
11541
11542 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11543
11544 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11545
11546 =head2 Encode::KR - Korean Encodings
11547
11548 =over 4
11549
11550 =item SYNOPSIS
11551
11552 =item DESCRIPTION
11553
11554 =item BUGS
11555
11556 =item SEE ALSO
11557
11558 =back
11559
11560 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11561
11562 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11563
11564 =over 4
11565
11566 =item SYNOPSIS
11567
11568 =item ABSTRACT
11569
11570 =item DESCRIPTION
11571
11572 =item BUGS
11573
11574 =item SEE ALSO
11575
11576 =back
11577
11578 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11579
11580 =over 4
11581
11582 =item Overview
11583
11584 =item How does it work?
11585
11586 =item BUGS
11587
11588 =over 4
11589
11590 =item Workaround
11591
11592 =item How can I tell whether my encoding fully supports PerlIO ?
11593
11594 =back
11595
11596 =item SEE ALSO
11597
11598 =back
11599
11600 =head2 Encode::Supported -- Encodings supported by Encode
11601
11602 =over 4
11603
11604 =item DESCRIPTION
11605
11606 =over 4
11607
11608 =item Encoding Names
11609
11610 =back
11611
11612 =item Supported Encodings
11613
11614 =over 4
11615
11616 =item Built-in Encodings
11617
11618 =item Encode::Unicode -- other Unicode encodings
11619
11620 =item Encode::Byte -- Extended ASCII
11621
11622 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11623 the Cyrillic world, gsm0338 - Hentai Latin 1
11624
11625 =item CJK: Chinese, Japanese, Korean (Multibyte)
11626
11627 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11628 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11629 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11630
11631 =item Miscellaneous encodings
11632
11633 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11634
11635 =back
11636
11637 =item Unsupported encodings
11638
11639   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11640 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11641 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11642 Various Mac encodings, (Mac) Indic encodings
11643
11644 =item Encoding vs. Charset -- terminology
11645
11646 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11647
11648 =over 4
11649
11650 =item Microsoft-related naming mess
11651
11652 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11653
11654 =back
11655
11656 =item Glossary
11657
11658 character repertoire, coded character set (CCS), character encoding scheme
11659 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11660 UTF-16
11661
11662 =item See Also
11663
11664 =item References
11665
11666 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11667 RFC, UC, Unicode Glossary
11668
11669 =over 4
11670
11671 =item Other Notable Sites
11672
11673 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11674 "Introduction to i18n"
11675
11676 =item Offline sources
11677
11678 C<CJKV Information Processing> by Ken Lunde
11679
11680 =back
11681
11682 =back
11683
11684 =head2 Encode::Symbol - Symbol Encodings
11685
11686 =over 4
11687
11688 =item SYNOPSIS
11689
11690 =item ABSTRACT
11691
11692 =item DESCRIPTION
11693
11694 =item SEE ALSO
11695
11696 =back
11697
11698 =head2 Encode::TW - Taiwan-based Chinese Encodings
11699
11700 =over 4
11701
11702 =item SYNOPSIS
11703
11704 =item DESCRIPTION
11705
11706 =item NOTES
11707
11708 =item BUGS
11709
11710 =item SEE ALSO
11711
11712 =back
11713
11714 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11715
11716 =over 4
11717
11718 =item SYNOPSIS
11719
11720 =item ABSTRACT
11721
11722 L<http://www.unicode.org/glossary/> says:, Quick Reference
11723
11724 =item Size, Endianness, and BOM
11725
11726 =over 4
11727
11728 =item by size
11729
11730 =item by endianness
11731
11732 BOM as integer when fetched in network byte order
11733
11734 =back
11735
11736 =item Surrogate Pairs
11737
11738 =item SEE ALSO
11739
11740 =back
11741
11742 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11743 encodings
11744
11745 =over 4
11746
11747 =item SYNOPSIS
11748
11749 =item DESCRIPTION
11750
11751 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11752 reference, e.g.:
11753
11754 =over 4
11755
11756 =item Alias overloading
11757
11758 =back
11759
11760 =item SEE ALSO
11761
11762 =back
11763
11764 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11765 Internally used by Encode::??::ISO_2022_*
11766
11767 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11768 Encode::CN
11769
11770 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11771 Encode
11772
11773 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11774 Implementation Base Class
11775
11776 =over 4
11777
11778 =item SYNOPSIS
11779
11780 =item DESCRIPTION
11781
11782 =over 4
11783
11784 =item Methods you should implement
11785
11786 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11787
11788 =item Other methods defined in Encode::Encodings
11789
11790 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11791
11792 =item Example: Encode::ROT13
11793
11794 =back
11795
11796 =item Why the heck Encode API is different?
11797
11798 =over 4
11799
11800 =item Compiled Encodings
11801
11802 =back
11803
11804 =item SEE ALSO
11805
11806 Scheme 1, Scheme 2, Other Schemes
11807
11808 =back
11809
11810 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11811 data
11812
11813 =over 4
11814
11815 =item SYNOPSIS
11816
11817 =item ABSTRACT
11818
11819 =item DESCRIPTION
11820
11821 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11822 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11823 guess_encoding($data, [, I<list of suspects>])
11824
11825 =item CAVEATS
11826
11827 =item TO DO
11828
11829 =item SEE ALSO
11830
11831 =back
11832
11833 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11834 Encode::JP::2022_JP*
11835
11836 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11837 by Encode::JP
11838
11839 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11840 used by Encode::KR
11841
11842 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11843 and 'Q' header encoding
11844
11845 =over 4
11846
11847 =item SYNOPSIS
11848
11849 =item ABSTRACT
11850
11851 =item DESCRIPTION
11852
11853 =item BUGS
11854
11855 =item SEE ALSO
11856
11857 =back
11858
11859 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11860 on Encode and PerlIO
11861
11862 =over 4
11863
11864 =item Overview
11865
11866 =item How does it work?
11867
11868 =item BUGS
11869
11870 =over 4
11871
11872 =item Workaround
11873
11874 =item How can I tell whether my encoding fully supports PerlIO ?
11875
11876 =back
11877
11878 =item SEE ALSO
11879
11880 =back
11881
11882 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11883 supported by Encode
11884
11885 =over 4
11886
11887 =item DESCRIPTION
11888
11889 =over 4
11890
11891 =item Encoding Names
11892
11893 =back
11894
11895 =item Supported Encodings
11896
11897 =over 4
11898
11899 =item Built-in Encodings
11900
11901 =item Encode::Unicode -- other Unicode encodings
11902
11903 =item Encode::Byte -- Extended ASCII
11904
11905 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11906 the Cyrillic world, gsm0338 - Hentai Latin 1
11907
11908 =item CJK: Chinese, Japanese, Korean (Multibyte)
11909
11910 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11911 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11912 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11913
11914 =item Miscellaneous encodings
11915
11916 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11917
11918 =back
11919
11920 =item Unsupported encodings
11921
11922   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11923 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11924 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11925 Various Mac encodings, (Mac) Indic encodings
11926
11927 =item Encoding vs. Charset -- terminology
11928
11929 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11930
11931 =over 4
11932
11933 =item Microsoft-related naming mess
11934
11935 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11936
11937 =back
11938
11939 =item Glossary
11940
11941 character repertoire, coded character set (CCS), character encoding scheme
11942 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11943 UTF-16
11944
11945 =item See Also
11946
11947 =item References
11948
11949 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11950 RFC, UC, Unicode Glossary
11951
11952 =over 4
11953
11954 =item Other Notable Sites
11955
11956 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11957 "Introduction to i18n"
11958
11959 =item Offline sources
11960
11961 C<CJKV Information Processing> by Ken Lunde
11962
11963 =back
11964
11965 =back
11966
11967 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11968
11969 =over 4
11970
11971 =item SYNOPSIS
11972
11973   use Encode::Encoder;
11974   # Encode::encode("ISO-8859-1", $data); 
11975   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11976   # shortcut
11977   use Encode::Encoder qw(encoder);
11978   encoder($data)->iso_8859_1;
11979   # you can stack them!
11980   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11981   # you can use it as a decoder as well
11982   encoder($base64)->bytes('base64')->latin1;
11983   # stringified
11984   print encoder($data)->utf8->latin1;  # prints the string in latin1
11985   # numified
11986   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11987
11988 =item ABSTRACT
11989
11990 =item Description
11991
11992 =over 4
11993
11994 =item Predefined Methods
11995
11996 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11997 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11998 $e-E<gt>bytes([$encoding])
11999
12000 =item Example: base64 transcoder
12001
12002 =item Operator Overloading
12003
12004 =back
12005
12006 =item SEE ALSO
12007
12008 =back
12009
12010 =head2 Encodencoding, encoding - allows you to write your script in
12011 non-ascii or non-utf8
12012
12013 =over 4
12014
12015 =item SYNOPSIS
12016
12017 =item ABSTRACT
12018
12019 =item USAGE
12020
12021 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12022 I<ENCNAME_IN> ...] ;, no encoding;
12023
12024 =item CAVEATS
12025
12026 =over 4
12027
12028 =item NOT SCOPED
12029
12030 =item DO NOT MIX MULTIPLE ENCODINGS
12031
12032 =back
12033
12034 =item Non-ASCII Identifiers and Filter option
12035
12036 use encoding I<ENCNAME> Filter=E<gt>1;
12037
12038 =item EXAMPLE - Greekperl
12039
12040 =item KNOWN PROBLEMS
12041
12042 =item SEE ALSO
12043
12044 =back
12045
12046 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12047
12048 =over 4
12049
12050 =item SYNOPSIS
12051
12052   use Encode::Encoder;
12053   # Encode::encode("ISO-8859-1", $data); 
12054   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12055   # shortcut
12056   use Encode::Encoder qw(encoder);
12057   encoder($data)->iso_8859_1;
12058   # you can stack them!
12059   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12060   # you can use it as a decoder as well
12061   encoder($base64)->bytes('base64')->latin1;
12062   # stringified
12063   print encoder($data)->utf8->latin1;  # prints the string in latin1
12064   # numified
12065   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12066
12067 =item ABSTRACT
12068
12069 =item Description
12070
12071 =over 4
12072
12073 =item Predefined Methods
12074
12075 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12076 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12077 $e-E<gt>bytes([$encoding])
12078
12079 =item Example: base64 transcoder
12080
12081 =item Operator Overloading
12082
12083 =back
12084
12085 =item SEE ALSO
12086
12087 =back
12088
12089 =head2 English - use nice English (or awk) names for ugly punctuation
12090 variables
12091
12092 =over 4
12093
12094 =item SYNOPSIS
12095
12096 =item DESCRIPTION
12097
12098 =item PERFORMANCE
12099
12100 =back
12101
12102 =head2 Env - perl module that imports environment variables as scalars or
12103 arrays
12104
12105 =over 4
12106
12107 =item SYNOPSIS
12108
12109 =item DESCRIPTION
12110
12111 =item LIMITATIONS
12112
12113 =item AUTHOR
12114
12115 =back
12116
12117 =head2 Errno - System errno constants
12118
12119 =over 4
12120
12121 =item SYNOPSIS
12122
12123 =item DESCRIPTION
12124
12125 =item CAVEATS
12126
12127 =item AUTHOR
12128
12129 =item COPYRIGHT
12130
12131 =back
12132
12133 =head2 Exporter - Implements default import method for modules
12134
12135 =over 4
12136
12137 =item SYNOPSIS
12138
12139 =item DESCRIPTION
12140
12141 =over 4
12142
12143 =item How to Export
12144
12145 =item Selecting What To Export
12146
12147 =item How to Import
12148
12149 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12150
12151 =back
12152
12153 =item Advanced features
12154
12155 =over 4
12156
12157 =item Specialised Import Lists
12158
12159 =item Exporting without using Exporter's import method
12160
12161 =item Module Version Checking
12162
12163 =item Managing Unknown Symbols
12164
12165 =item Tag Handling Utility Functions
12166
12167 =item Generating combined tags
12168
12169 =item C<AUTOLOAD>ed Constants
12170
12171 =back
12172
12173 =back
12174
12175 =head2 Exporter::Heavy - Exporter guts
12176
12177 =over 4
12178
12179 =item SYNOPSIS
12180
12181 =item DESCRIPTION
12182
12183 =back
12184
12185 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12186 Makefiles etc.
12187
12188 =over 4
12189
12190 =item SYNOPSIS
12191
12192 =item DESCRIPTION
12193
12194 =back
12195
12196 cat
12197
12198 eqtime src dst
12199
12200 rm_rf files...
12201
12202 rm_f files...
12203
12204 touch files ..
12205
12206 mv source... destination
12207
12208 cp source... destination
12209
12210 chmod mode files..
12211
12212 mkpath directory..
12213
12214 test_f file
12215
12216 =over 4
12217
12218 =item BUGS
12219
12220 =item SEE ALSO 
12221
12222 =item AUTHOR
12223
12224 =back
12225
12226 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12227
12228 =over 4
12229
12230 =item SYNOPSIS
12231
12232 =item DESCRIPTION
12233
12234 B<test_harness>
12235
12236 =back
12237
12238 =head2 ExtUtils::Constant - generate XS code to import C header constants
12239
12240 =over 4
12241
12242 =item SYNOPSIS
12243
12244 =item DESCRIPTION
12245
12246 =item USAGE
12247
12248 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12249
12250 =item FUNCTIONS
12251
12252 =back
12253
12254 C_stringify NAME
12255
12256 perl_stringify NAME
12257
12258 constant_types
12259
12260 memEQ_clause NAME, CHECKED_AT, INDENT
12261
12262 assign INDENT, TYPE, PRE, POST, VALUE..
12263
12264 return_clause
12265
12266 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12267
12268 params WHAT
12269
12270 dump_names
12271
12272 dogfood
12273
12274 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12275 def_post, utf8
12276
12277 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12278
12279 autoload PACKAGE, VERSION, AUTOLOADER
12280
12281 WriteMakefileSnippet
12282
12283 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12284 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12285
12286 =over 4
12287
12288 =item AUTHOR
12289
12290 =back
12291
12292 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12293
12294 =over 4
12295
12296 =item SYNOPSIS
12297
12298 =item DESCRIPTION
12299
12300 =item @EXPORT
12301
12302 =item FUNCTIONS
12303
12304 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12305 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12306
12307 =item EXAMPLES
12308
12309 =item SEE ALSO
12310
12311 =item AUTHOR
12312
12313 =back
12314
12315 =head2 ExtUtils::Install - install files from here to there
12316
12317 =over 4
12318
12319 =item SYNOPSIS
12320
12321 =item DESCRIPTION
12322
12323 =back
12324
12325 =head2 ExtUtils::Installed - Inventory management of installed modules
12326
12327 =over 4
12328
12329 =item SYNOPSIS
12330
12331 =item DESCRIPTION
12332
12333 =item USAGE
12334
12335 =item FUNCTIONS
12336
12337 new(), modules(), files(), directories(), directory_tree(), validate(),
12338 packlist(), version()
12339
12340 =item EXAMPLE
12341
12342 =item AUTHOR
12343
12344 =back
12345
12346 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12347
12348 =over 4
12349
12350 =item SYNOPSIS
12351
12352 =item DESCRIPTION
12353
12354 For static extensions, For dynamic extensions at build/link time, For
12355 dynamic extensions at load time
12356
12357 =over 4
12358
12359 =item EXTRALIBS
12360
12361 =item LDLOADLIBS and LD_RUN_PATH
12362
12363 =item BSLOADLIBS
12364
12365 =back
12366
12367 =item PORTABILITY
12368
12369 =over 4
12370
12371 =item VMS implementation
12372
12373 =item Win32 implementation
12374
12375 =back
12376
12377 =item SEE ALSO
12378
12379 =back
12380
12381 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12382
12383 =over 4
12384
12385 =item SYNOPSIS
12386
12387 =item DESCRIPTION
12388
12389 =back
12390
12391 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12392
12393 =over 4
12394
12395 =item SYNOPSIS
12396
12397 =item DESCRIPTION
12398
12399 =item Inherently Cross-Platform Methods
12400
12401 =over 4
12402
12403 =item File::Spec wrappers  B<DEPRECATED>
12404
12405 canonpath
12406
12407 =back
12408
12409 =back
12410
12411 catdir
12412
12413 catfile
12414
12415 curdir
12416
12417 file_name_is_absolute
12418
12419 path
12420
12421 rootdir
12422
12423 updir
12424
12425 =over 4
12426
12427 =item Thought To Be Cross-Platform Methods
12428
12429 test_via_harness
12430
12431 =back
12432
12433 test_via_script
12434
12435 =over 4
12436
12437 =item AUTHOR
12438
12439 =back
12440
12441 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12442 ExtUtils::MakeMaker
12443
12444 =over 4
12445
12446 =item SYNOPSIS
12447
12448 =item DESCRIPTION
12449
12450 =back
12451
12452 perl_archive
12453
12454 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12455 ExtUtils::MakeMaker
12456
12457 =over 4
12458
12459 =item SYNOPSIS
12460
12461 =item DESCRIPTION
12462
12463 canonpath, cflags, manifypods, perl_archive
12464
12465 =back
12466
12467 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12468
12469 =over 4
12470
12471 =item SYNOPSIS
12472
12473 =item DESCRIPTION
12474
12475 =over 4
12476
12477 =item Overridden methods
12478
12479 B<replace_manpage_separator>
12480
12481 =back
12482
12483 =back
12484
12485 =over 4
12486
12487 =item AUTHOR
12488
12489 =item SEE ALSO
12490
12491 =back
12492
12493 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12494 ExtUtils::MakeMaker
12495
12496 =over 4
12497
12498 =item SYNOPSIS
12499
12500 =item DESCRIPTION
12501
12502 =back
12503
12504 maybe_command
12505
12506 guess_name
12507
12508 macify
12509
12510 patternify
12511
12512 init_main
12513
12514 init_others
12515
12516 init_dirscan
12517
12518 libscan (o)
12519
12520 constants (o)
12521
12522 static (o)
12523
12524 dlsyms (o)
12525
12526 dynamic (o)
12527
12528 clean (o)
12529
12530 realclean (o)
12531
12532 rulez (o)
12533
12534 processPL (o)
12535
12536 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12537 ExtUtils::MakeMaker
12538
12539 =over 4
12540
12541 =item SYNOPSIS
12542
12543 =item DESCRIPTION
12544
12545 =back
12546
12547 constants (o)
12548
12549 static_lib (o)
12550
12551 dynamic_lib (o)
12552
12553 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12554 ExtUtils::MakeMaker
12555
12556 =over 4
12557
12558 =item SYNOPSIS
12559
12560 =item DESCRIPTION
12561
12562 =item METHODS
12563
12564 =back
12565
12566 perl_archive_after
12567
12568 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12569
12570 =over 4
12571
12572 =item SYNOPSIS
12573
12574 =item DESCRIPTION
12575
12576 =over 4
12577
12578 =item Overridden methods
12579
12580 B<replace_manpage_separator>
12581
12582 =back
12583
12584 =back
12585
12586 =over 4
12587
12588 =item AUTHOR
12589
12590 =item SEE ALSO
12591
12592 =back
12593
12594 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12595
12596 =over 4
12597
12598 =item SYNOPSIS
12599
12600 =item DESCRIPTION
12601
12602 =item METHODS
12603
12604 =back
12605
12606 =over 4
12607
12608 =item SelfLoaded methods
12609
12610 c_o (o)
12611
12612 =back
12613
12614 cflags (o)
12615
12616 clean (o)
12617
12618 const_cccmd (o)
12619
12620 const_config (o)
12621
12622 const_loadlibs (o)
12623
12624 constants (o)
12625
12626 depend (o)
12627
12628 dir_target (o)
12629
12630 dist (o)
12631
12632 dist_basics (o)
12633
12634 dist_ci (o)
12635
12636 dist_core (o)
12637
12638 dist_dir
12639
12640 dist_test
12641
12642 dlsyms (o)
12643
12644 dynamic (o)
12645
12646 dynamic_bs (o)
12647
12648 dynamic_lib (o)
12649
12650 exescan
12651
12652 extliblist
12653
12654 find_perl
12655
12656 find_tests
12657
12658 =over 4
12659
12660 =item Methods to actually produce chunks of text for the Makefile
12661
12662 fixin
12663
12664 =back
12665
12666 force (o)
12667
12668 guess_name
12669
12670 has_link_code
12671
12672 init_dirscan
12673
12674 init_main
12675
12676 init_others
12677
12678 init_INST
12679
12680 init_INSTALL
12681
12682 init_lib2arch
12683
12684 init_PERL
12685
12686 init_PERM
12687
12688 install (o)
12689
12690 installbin (o)
12691
12692 libscan (o)
12693
12694 linkext (o)
12695
12696 lsdir
12697
12698 macro (o)
12699
12700 makeaperl (o)
12701
12702 makefile (o)
12703
12704 manifypods (o)
12705
12706 maybe_command
12707
12708 maybe_command_in_dirs
12709
12710 needs_linking (o)
12711
12712 nicetext
12713
12714 parse_abstract
12715
12716 parse_version
12717
12718 pasthru (o)
12719
12720 perl_script
12721
12722 perldepend (o)
12723
12724 perm_rw (o)
12725
12726 perm_rwx (o)
12727
12728 pm_to_blib
12729
12730 post_constants (o)
12731
12732 post_initialize (o)
12733
12734 postamble (o)
12735
12736 ppd
12737
12738 prefixify
12739
12740 processPL (o)
12741
12742 quote_paren
12743
12744 realclean (o)
12745
12746 replace_manpage_separator
12747
12748 static (o)
12749
12750 static_lib (o)
12751
12752 staticmake (o)
12753
12754 subdir_x (o)
12755
12756 subdirs (o)
12757
12758 test (o)
12759
12760 test_via_harness (override)
12761
12762 test_via_script (override)
12763
12764 tool_autosplit (o)
12765
12766 tools_other (o)
12767
12768 tool_xsubpp (o)
12769
12770 top_targets (o)
12771
12772 writedoc
12773
12774 xs_c (o)
12775
12776 xs_cpp (o)
12777
12778 xs_o (o)
12779
12780 perl_archive
12781
12782 perl_archive_after
12783
12784 export_list
12785
12786 =over 4
12787
12788 =item SEE ALSO
12789
12790 =back
12791
12792 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12793 ExtUtils::MakeMaker
12794
12795 =over 4
12796
12797 =item SYNOPSIS
12798
12799 =item DESCRIPTION
12800
12801 =over 4
12802
12803 =item Methods always loaded
12804
12805 wraplist
12806
12807 =back
12808
12809 =back
12810
12811 =over 4
12812
12813 =item Methods
12814
12815 guess_name (override)
12816
12817 =back
12818
12819 find_perl (override)
12820
12821 maybe_command (override)
12822
12823 maybe_command_in_dirs (override)
12824
12825 perl_script (override)
12826
12827 replace_manpage_separator
12828
12829 init_main (override)
12830
12831 init_others (override)
12832
12833 constants (override)
12834
12835 cflags (override)
12836
12837 const_cccmd (override)
12838
12839 pm_to_blib (override)
12840
12841 tool_autosplit (override)
12842
12843 tool_sxubpp (override)
12844
12845 xsubpp_version (override)
12846
12847 tools_other (override)
12848
12849 dist (override)
12850
12851 c_o (override)
12852
12853 xs_c (override)
12854
12855 xs_o (override)
12856
12857 top_targets (override)
12858
12859 dlsyms (override)
12860
12861 dynamic_lib (override)
12862
12863 dynamic_bs (override)
12864
12865 static_lib (override)
12866
12867 manifypods (override)
12868
12869 processPL (override)
12870
12871 installbin (override)
12872
12873 subdir_x (override)
12874
12875 clean (override)
12876
12877 realclean (override)
12878
12879 dist_core (override)
12880
12881 dist_test (override)
12882
12883 install (override)
12884
12885 perldepend (override)
12886
12887 makefile (override)
12888
12889 find_tests (override)
12890
12891 test (override)
12892
12893 makeaperl (override)
12894
12895 nicetext (override)
12896
12897 prefixify (override)
12898
12899 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12900 ExtUtils::MakeMaker
12901
12902 =over 4
12903
12904 =item SYNOPSIS
12905
12906 =item DESCRIPTION
12907
12908 =back
12909
12910 constants (o)
12911
12912 static_lib (o)
12913
12914 dynamic_bs (o)
12915
12916 dynamic_lib (o)
12917
12918 perl_script
12919
12920 pm_to_blib
12921
12922 tool_autosplit (override)
12923
12924 tools_other (o)
12925
12926 xs_o (o)
12927
12928 top_targets (o)
12929
12930 manifypods (o)
12931
12932 dist_ci (o)
12933
12934 dist_core (o)
12935
12936 pasthru (o)
12937
12938 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12939
12940 =over 4
12941
12942 =item SYNOPSIS
12943
12944 =item DESCRIPTION
12945
12946 =back
12947
12948 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12949
12950 =over 4
12951
12952 =item SYNOPSIS
12953
12954 =item DESCRIPTION
12955
12956 =back
12957
12958 =head2 ExtUtils::MakeMaker - create an extension Makefile
12959
12960 =over 4
12961
12962 =item SYNOPSIS
12963
12964 =item DESCRIPTION
12965
12966 =over 4
12967
12968 =item How To Write A Makefile.PL
12969
12970 =item Default Makefile Behaviour
12971
12972 =item make test
12973
12974 =item make testdb
12975
12976 =item make install
12977
12978 =item PREFIX and LIB attribute
12979
12980 =item AFS users
12981
12982 =item Static Linking of a new Perl Binary
12983
12984 =item Determination of Perl Library and Installation Locations
12985
12986 =item Which architecture dependent directory?
12987
12988 =item Using Attributes and Parameters
12989
12990 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12991 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12992 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12993 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12994 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12995 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12996 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12997 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12998 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB,
12999 LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS,
13000 MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT,
13001 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13002 PERL_MALLOC_OK, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX,
13003 PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13004 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13005 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
13006 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
13007
13008 =item Additional lowercase attributes
13009
13010 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
13011 tool_autosplit
13012
13013 =item Overriding MakeMaker Methods
13014
13015 =item The End Of Cargo Cult Programming
13016
13017 C<<MAN3PODS => ' '>>
13018
13019 =item Hintsfile support
13020
13021 =item Distribution Support
13022
13023    make distcheck,    make skipcheck,    make distclean,    make manifest, 
13024   make distdir,   make disttest,    make tardist,    make dist,    make
13025 uutardist,    make shdist,    make zipdist,    make ci
13026
13027 =item Disabling an extension
13028
13029 =back
13030
13031 =item ENVIRONMENT
13032
13033 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13034
13035 =item SEE ALSO
13036
13037 =item AUTHORS
13038
13039 =back
13040
13041 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13042
13043 =over 4
13044
13045 =item SYNOPSIS
13046
13047 =item DESCRIPTION
13048
13049 =item MANIFEST.SKIP
13050
13051 =item EXPORT_OK
13052
13053 =item GLOBAL VARIABLES
13054
13055 =item DIAGNOSTICS
13056
13057 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13058 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13059
13060 =item ENVIRONMENT
13061
13062 B<PERL_MM_MANIFEST_DEBUG>
13063
13064 =item SEE ALSO
13065
13066 =item AUTHOR
13067
13068 =back
13069
13070 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13071
13072 =over 4
13073
13074 =item SYNOPSIS
13075
13076 =item DESCRIPTION
13077
13078 =item SEE ALSO
13079
13080 =back
13081
13082 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13083
13084 =over 4
13085
13086 =item SYNOPSIS
13087
13088 =item DESCRIPTION
13089
13090 =back
13091
13092 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13093 extension
13094
13095 =over 4
13096
13097 =item SYNOPSIS
13098
13099 =item DESCRIPTION
13100
13101 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13102
13103 =item AUTHOR
13104
13105 =item REVISION
13106
13107 =back
13108
13109 =head2 ExtUtils::Packlist - manage .packlist files
13110
13111 =over 4
13112
13113 =item SYNOPSIS
13114
13115 =item DESCRIPTION
13116
13117 =item USAGE
13118
13119 =item FUNCTIONS
13120
13121 new(), read(), write(), validate(), packlist_file()
13122
13123 =item EXAMPLE
13124
13125 =item AUTHOR
13126
13127 =back
13128
13129 =head2 ExtUtils::testlib - add blib/* directories to @INC
13130
13131 =over 4
13132
13133 =item SYNOPSIS
13134
13135 =item DESCRIPTION
13136
13137 =back
13138
13139 =head2 Fatal - replace functions with equivalents which succeed or die
13140
13141 =over 4
13142
13143 =item SYNOPSIS
13144
13145 =item DESCRIPTION
13146
13147 =item AUTHOR
13148
13149 =back
13150
13151 =head2 Fcntl - load the C Fcntl.h defines
13152
13153 =over 4
13154
13155 =item SYNOPSIS
13156
13157 =item DESCRIPTION
13158
13159 =item NOTE
13160
13161 =item EXPORTED SYMBOLS
13162
13163 =back
13164
13165 =head2 File::Basename, fileparse - split a pathname into pieces
13166
13167 =over 4
13168
13169 =item SYNOPSIS
13170
13171 =item DESCRIPTION
13172
13173 fileparse_set_fstype, fileparse
13174
13175 =item EXAMPLES
13176
13177 C<basename>, C<dirname>
13178
13179 =back
13180
13181 =head2 File::CheckTree, validate - run many filetest checks on a tree
13182
13183 =over 4
13184
13185 =item SYNOPSIS
13186
13187 =item DESCRIPTION
13188
13189 =item AUTHOR
13190
13191 =item HISTORY
13192
13193 =back
13194
13195 =head2 File::Compare - Compare files or filehandles
13196
13197 =over 4
13198
13199 =item SYNOPSIS
13200
13201 =item DESCRIPTION
13202
13203 =item RETURN
13204
13205 =item AUTHOR
13206
13207 =back
13208
13209 =head2 File::Copy - Copy files or filehandles
13210
13211 =over 4
13212
13213 =item SYNOPSIS
13214
13215 =item DESCRIPTION
13216
13217 =over 4
13218
13219 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13220
13221 rmscopy($from,$to[,$date_flag])
13222
13223 =back
13224
13225 =item RETURN
13226
13227 =item NOTES
13228
13229 =item AUTHOR
13230
13231 =back
13232
13233 =head2 File::DosGlob - DOS like globbing and then some
13234
13235 =over 4
13236
13237 =item SYNOPSIS
13238
13239 =item DESCRIPTION
13240
13241 =item NOTES
13242
13243 =item EXPORTS (by request only)
13244
13245 =item BUGS
13246
13247 =item AUTHOR
13248
13249 =item HISTORY
13250
13251 =item SEE ALSO
13252
13253 =back
13254
13255 =head2 File::Find - Traverse a directory tree.
13256
13257 =over 4
13258
13259 =item SYNOPSIS
13260
13261 =item DESCRIPTION
13262
13263 B<find>, B<finddepth>
13264
13265 =over 4
13266
13267 =item %options
13268
13269 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13270 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13271 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13272
13273 =item The wanted function
13274
13275 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13276 filename within that directory, C<$File::Find::name> is the complete
13277 pathname to the file
13278
13279 =back
13280
13281 =item WARNINGS
13282
13283 =item CAVEAT
13284
13285 $dont_use_nlink, symlinks
13286
13287 =item NOTES
13288
13289 =item HISTORY
13290
13291 =back
13292
13293 =head2 File::Glob - Perl extension for BSD glob routine
13294
13295 =over 4
13296
13297 =item SYNOPSIS
13298
13299 =item DESCRIPTION
13300
13301 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13302 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13303 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13304
13305 =item DIAGNOSTICS
13306
13307 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13308
13309 =item NOTES
13310
13311 =item AUTHOR
13312
13313 =back
13314
13315 =head2 File::Path - create or remove directory trees
13316
13317 =over 4
13318
13319 =item SYNOPSIS
13320
13321 =item DESCRIPTION
13322
13323 =item AUTHORS
13324
13325 =back
13326
13327 =head2 File::Spec - portably perform operations on file names
13328
13329 =over 4
13330
13331 =item SYNOPSIS
13332
13333 =item DESCRIPTION
13334
13335 =item METHODS
13336
13337 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13338 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13339 splitdir, catpath(), abs2rel, rel2abs()
13340
13341 =item SEE ALSO
13342
13343 =item AUTHORS
13344
13345 =back
13346
13347 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13348
13349 =over 4
13350
13351 =item SYNOPSIS
13352
13353 =item DESCRIPTION
13354
13355 =back
13356
13357 =head2 File::Spec::Epoc - methods for Epoc file specs
13358
13359 =over 4
13360
13361 =item SYNOPSIS
13362
13363 =item DESCRIPTION
13364
13365 canonpath()
13366
13367 =back
13368
13369 =over 4
13370
13371 =item SEE ALSO
13372
13373 =back
13374
13375 =head2 File::Spec::Functions - portably perform operations on file names
13376
13377 =over 4
13378
13379 =item SYNOPSIS
13380
13381 =item DESCRIPTION
13382
13383 =over 4
13384
13385 =item Exports
13386
13387 =back
13388
13389 =item SEE ALSO
13390
13391 =back
13392
13393 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13394
13395 =over 4
13396
13397 =item SYNOPSIS
13398
13399 =item DESCRIPTION
13400
13401 =item METHODS
13402
13403 canonpath
13404
13405 =back
13406
13407 catdir()
13408
13409 catfile
13410
13411 curdir
13412
13413 devnull
13414
13415 rootdir
13416
13417 tmpdir
13418
13419 updir
13420
13421 file_name_is_absolute
13422
13423 path
13424
13425 splitpath
13426
13427 splitdir
13428
13429 catpath
13430
13431 abs2rel
13432
13433 rel2abs
13434
13435 =over 4
13436
13437 =item AUTHORS
13438
13439 =item SEE ALSO
13440
13441 =back
13442
13443 canonpath
13444
13445 splitpath
13446
13447 splitdir
13448
13449 catpath
13450
13451 =head2 File::Spec::OS2 - methods for OS/2 file specs
13452
13453 =over 4
13454
13455 =item SYNOPSIS
13456
13457 =item DESCRIPTION
13458
13459 =back
13460
13461 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13462 modules
13463
13464 =over 4
13465
13466 =item SYNOPSIS
13467
13468 =item DESCRIPTION
13469
13470 =item METHODS
13471
13472 canonpath()
13473
13474 =back
13475
13476 catdir()
13477
13478 catfile
13479
13480 curdir
13481
13482 devnull
13483
13484 rootdir
13485
13486 tmpdir
13487
13488 updir
13489
13490 no_upwards
13491
13492 case_tolerant
13493
13494 file_name_is_absolute
13495
13496 path
13497
13498 join
13499
13500 splitpath
13501
13502 splitdir
13503
13504 catpath()
13505
13506 abs2rel
13507
13508 rel2abs()
13509
13510 =over 4
13511
13512 =item SEE ALSO
13513
13514 =back
13515
13516 =head2 File::Spec::VMS - methods for VMS file specs
13517
13518 =over 4
13519
13520 =item SYNOPSIS
13521
13522 =item DESCRIPTION
13523
13524 eliminate_macros
13525
13526 =back
13527
13528 fixpath
13529
13530 =over 4
13531
13532 =item Methods always loaded
13533
13534 canonpath (override)
13535
13536 =back
13537
13538 catdir
13539
13540 catfile
13541
13542 curdir (override)
13543
13544 devnull (override)
13545
13546 rootdir (override)
13547
13548 tmpdir (override)
13549
13550 updir (override)
13551
13552 case_tolerant (override)
13553
13554 path (override)
13555
13556 file_name_is_absolute (override)
13557
13558 splitpath (override)
13559
13560 splitdir (override)
13561
13562 catpath (override)
13563
13564 abs2rel (override)
13565
13566 rel2abs (override)
13567
13568 =over 4
13569
13570 =item SEE ALSO
13571
13572 =back
13573
13574 =head2 File::Spec::Win32 - methods for Win32 file specs
13575
13576 =over 4
13577
13578 =item SYNOPSIS
13579
13580 =item DESCRIPTION
13581
13582 devnull
13583
13584 =back
13585
13586 tmpdir
13587
13588 catfile
13589
13590 canonpath
13591
13592 splitpath
13593
13594 splitdir
13595
13596 catpath
13597
13598 =over 4
13599
13600 =item Note For File::Spec::Win32 Maintainers
13601
13602 =back
13603
13604 =over 4
13605
13606 =item SEE ALSO
13607
13608 =back
13609
13610 =head2 File::Temp - return name and handle of a temporary file safely
13611
13612 =over 4
13613
13614 =item PORTABILITY
13615
13616 =item SYNOPSIS
13617
13618 =item DESCRIPTION
13619
13620 =back
13621
13622 =over 4
13623
13624 =item FUNCTIONS
13625
13626 B<tempfile>
13627
13628 =back
13629
13630 B<tempdir>
13631
13632 =over 4
13633
13634 =item MKTEMP FUNCTIONS
13635
13636 B<mkstemp>
13637
13638 =back
13639
13640 B<mkstemps>
13641
13642 B<mkdtemp>
13643
13644 B<mktemp>
13645
13646 =over 4
13647
13648 =item POSIX FUNCTIONS
13649
13650 B<tmpnam>
13651
13652 =back
13653
13654 B<tmpfile>
13655
13656 =over 4
13657
13658 =item ADDITIONAL FUNCTIONS
13659
13660 B<tempnam>
13661
13662 =back
13663
13664 =over 4
13665
13666 =item UTILITY FUNCTIONS
13667
13668 B<unlink0>
13669
13670 =back
13671
13672 =over 4
13673
13674 =item PACKAGE VARIABLES
13675
13676 B<safe_level>, STANDARD, MEDIUM, HIGH
13677
13678 =back
13679
13680 TopSystemUID
13681
13682 =over 4
13683
13684 =item WARNING
13685
13686 =over 4
13687
13688 =item Temporary files and NFS
13689
13690 =back
13691
13692 =item HISTORY
13693
13694 =item SEE ALSO
13695
13696 =item AUTHOR
13697
13698 =back
13699
13700 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13701
13702 =over 4
13703
13704 =item SYNOPSIS
13705
13706 =item DESCRIPTION
13707
13708 =item NOTE
13709
13710 =item AUTHOR
13711
13712 =back
13713
13714 =head2 FileCache - keep more files open than the system permits
13715
13716 =over 4
13717
13718 =item SYNOPSIS
13719
13720 =item DESCRIPTION
13721
13722 cacheout EXPR, cacheout MODE, EXPR
13723
13724 =item CAVEATS
13725
13726 =item BUGS
13727
13728 =back
13729
13730 =head2 FileHandle - supply object methods for filehandles
13731
13732 =over 4
13733
13734 =item SYNOPSIS
13735
13736 =item DESCRIPTION
13737
13738 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13739
13740 =item SEE ALSO
13741
13742 =back
13743
13744 =head2 Filter::Simple - Simplified source filtering
13745
13746 =over 4
13747
13748 =item SYNOPSIS
13749
13750 =item DESCRIPTION
13751
13752 =over 4
13753
13754 =item The Problem
13755
13756 =item A Solution
13757
13758 =item Disabling or changing <no> behaviour
13759
13760 =item All-in-one interface
13761
13762 =item Filtering only specific components of source code
13763
13764 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13765 C<"all">
13766
13767 =item Filtering only the code parts of source code
13768
13769 Most source code ceases to be grammatically correct when it is broken up
13770 into the pieces between string literals and regexes. So the C<'code'>
13771 component filter behaves slightly differently from the other partial
13772 filters
13773 described in the previous section.
13774
13775 =item Using Filter::Simple with an explicit C<import> subroutine
13776
13777 =item Using Filter::Simple and Exporter together
13778
13779 =item How it works
13780
13781 =back
13782
13783 =item AUTHOR
13784
13785 =item COPYRIGHT
13786
13787 =back
13788
13789 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13790
13791 =over 4
13792
13793 =item SYNOPSIS
13794
13795 =item DESCRIPTION
13796
13797 =over 4
13798
13799 =item B<use Filter::Util::Call>
13800
13801 =item B<import()>
13802
13803 =item B<filter() and anonymous sub>
13804
13805 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13806
13807 =back
13808
13809 =item EXAMPLES
13810
13811 =over 4
13812
13813 =item Example 1: A simple filter.
13814
13815 =item Example 2: Using the context
13816
13817 =item Example 3: Using the context within the filter
13818
13819 =item Example 4: Using filter_del
13820
13821 =back
13822
13823 =item Filter::Simple
13824
13825 =item AUTHOR
13826
13827 =item DATE
13828
13829 =back
13830
13831 =head2 FindBin - Locate directory of original perl script
13832
13833 =over 4
13834
13835 =item SYNOPSIS
13836
13837 =item DESCRIPTION
13838
13839 =item EXPORTABLE VARIABLES
13840
13841 =item KNOWN ISSUES
13842
13843 =item KNOWN BUGS
13844
13845 =item AUTHORS
13846
13847 =item COPYRIGHT
13848
13849 =back
13850
13851 =head2 GDBM_File - Perl5 access to the gdbm library.
13852
13853 =over 4
13854
13855 =item SYNOPSIS
13856
13857 =item DESCRIPTION
13858
13859 =item AVAILABILITY
13860
13861 =item BUGS
13862
13863 =item SEE ALSO
13864
13865 =back
13866
13867 =head2 Getopt::Long - Extended processing of command line options
13868
13869 =over 4
13870
13871 =item SYNOPSIS
13872
13873 =item DESCRIPTION
13874
13875 =item Command Line Options, an Introduction
13876
13877 =item Getting Started with Getopt::Long
13878
13879 =over 4
13880
13881 =item Simple options
13882
13883 =item A little bit less simple options
13884
13885 =item Mixing command line option with other arguments
13886
13887 =item Options with values
13888
13889 =item Options with multiple values
13890
13891 =item Options with hash values
13892
13893 =item User-defined subroutines to handle options
13894
13895 =item Options with multiple names
13896
13897 =item Case and abbreviations
13898
13899 =item Summary of Option Specifications
13900
13901 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13902 + [ I<desttype> ]
13903
13904 =back
13905
13906 =item Advanced Possibilities
13907
13908 =over 4
13909
13910 =item Object oriented interface
13911
13912 =item Thread Safety
13913
13914 =item Documentation and help texts
13915
13916 =item Storing options in a hash
13917
13918 =item Bundling
13919
13920 =item The lonesome dash
13921
13922 =item Argument callback
13923
13924 =back
13925
13926 =item Configuring Getopt::Long
13927
13928 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13929 require_order, permute, bundling (default: disabled), bundling_override
13930 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13931 (default: disabled), pass_through (default: disabled), prefix,
13932 prefix_pattern, debug (default: disabled)
13933
13934 =item Return values and Errors
13935
13936 =item Legacy
13937
13938 =over 4
13939
13940 =item Default destinations
13941
13942 =item Alternative option starters
13943
13944 =item Configuration variables
13945
13946 =back
13947
13948 =item Trouble Shooting
13949
13950 =over 4
13951
13952 =item Warning: Ignoring '!' modifier for short option
13953
13954 =item GetOptions does not return a false result when an option is not
13955 supplied
13956
13957 =item GetOptions does not split the command line correctly
13958
13959 =item How do I put a "-?" option into a Getopt::Long?
13960
13961 =back
13962
13963 =item AUTHOR
13964
13965 =item COPYRIGHT AND DISCLAIMER
13966
13967 =back
13968
13969 =head2 Getopt::Std, getopt - Process single-character switches with switch
13970 clustering
13971
13972 =over 4
13973
13974 =item SYNOPSIS
13975
13976 =item DESCRIPTION
13977
13978 =back
13979
13980 =head2 Hash::Util - A selection of general-utility hash subroutines
13981
13982 =over 4
13983
13984 =item SYNOPSIS
13985
13986 =item DESCRIPTION
13987
13988 =over 4
13989
13990 =item Restricted hashes
13991
13992 lock_keys, unlock_keys
13993
13994 =back
13995
13996 =back
13997
13998 lock_value, unlock_value
13999
14000 B<lock_hash>, B<unlock_hash>
14001
14002 =over 4
14003
14004 =item AUTHOR
14005
14006 =item SEE ALSO
14007
14008 =back
14009
14010 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14011 locale
14012
14013 =over 4
14014
14015 =item SYNOPSIS
14016
14017 =item DESCRIPTION
14018
14019 =back
14020
14021 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14022 tags
14023
14024 =over 4
14025
14026 =item SYNOPSIS
14027
14028 =item DESCRIPTION
14029
14030 =back
14031
14032 the function is_language_tag($lang1)
14033
14034 the function extract_language_tags($whatever)
14035
14036 the function same_language_tag($lang1, $lang2)
14037
14038 the function similarity_language_tag($lang1, $lang2)
14039
14040 the function is_dialect_of($lang1, $lang2)
14041
14042 the function super_languages($lang1)
14043
14044 the function locale2language_tag($locale_identifier)
14045
14046 the function encode_language_tag($lang1)
14047
14048 the function alternate_language_tags($lang1)
14049
14050 the function @langs = panic_languages(@accept_languages)
14051
14052 =over 4
14053
14054 =item ABOUT LOWERCASING
14055
14056 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14057
14058 =item SEE ALSO
14059
14060 =item COPYRIGHT
14061
14062 =item AUTHOR
14063
14064 =back
14065
14066 =head2 I18N::LangTags::List -- tags and names for human languages
14067
14068 =over 4
14069
14070 =item SYNOPSIS
14071
14072 =item DESCRIPTION
14073
14074 =item ABOUT LANGUAGE TAGS
14075
14076 =item LIST OF LANGUAGES
14077
14078 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14079 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14080 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14081 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14082 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14083 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14084 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14085 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14086 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14087 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14088 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14089 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14090 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14091 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14092 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14093 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14094 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14095 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14096 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14097 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14098 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14099 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14100 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14101 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14102 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14103 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14104 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14105 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14106 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14107 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14108 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14109 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14110 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14111 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14112 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14113 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14114 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14115 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14116 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14117 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14118 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14119 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14120 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14121 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14122 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14123 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14124 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14125 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14126 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14127 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14128 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14129 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14130 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14131 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14132 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14133 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14134 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14135 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14136 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14137 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14138 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14139 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14140 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14141 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14142 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14143 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14144 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14145 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14146 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14147 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14148 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14149 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14150 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14151 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14152 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14153 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14154 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14155 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14156 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14157 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14158 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14159 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14160 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14161 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14162 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14163 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14164 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14165 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14166 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14167 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14168 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14169 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14170 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14171 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14172 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14173 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14174 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14175 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14176 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14177 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14178 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14179 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14180 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14181 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14182 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14183 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14184 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14185 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14186 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14187 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14188 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14189 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14190 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14191 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14192 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14193 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14194 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14195 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14196 Zhuang, {zu} : Zulu, {zun} : Zuni
14197
14198 =item SEE ALSO
14199
14200 =item COPYRIGHT AND DISCLAIMER
14201
14202 =item AUTHOR
14203
14204 =back
14205
14206 =head2 I18N::Langinfo - query locale information
14207
14208 =over 4
14209
14210 =item SYNOPSIS
14211
14212 =item DESCRIPTION
14213
14214 =over 4
14215
14216 =item EXPORT
14217
14218 =back
14219
14220 =item SEE ALSO
14221
14222 =item AUTHOR
14223
14224 =item COPYRIGHT AND LICENSE
14225
14226 =back
14227
14228 =head2 IO - load various IO modules
14229
14230 =over 4
14231
14232 =item SYNOPSIS
14233
14234 =item DESCRIPTION
14235
14236 =back
14237
14238 =head2 IO::Dir - supply object methods for directory handles
14239
14240 =over 4
14241
14242 =item SYNOPSIS
14243
14244 =item DESCRIPTION
14245
14246 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14247 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14248
14249 =item SEE ALSO
14250
14251 =item AUTHOR
14252
14253 =item COPYRIGHT
14254
14255 =back
14256
14257 =head2 IO::File - supply object methods for filehandles
14258
14259 =over 4
14260
14261 =item SYNOPSIS
14262
14263 =item DESCRIPTION
14264
14265 =item CONSTRUCTOR
14266
14267 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14268
14269 =item METHODS
14270
14271 open( FILENAME [,MODE [,PERMS]] )
14272
14273 =item SEE ALSO
14274
14275 =item HISTORY
14276
14277 =back
14278
14279 =head2 IO::Handle - supply object methods for I/O handles
14280
14281 =over 4
14282
14283 =item SYNOPSIS
14284
14285 =item DESCRIPTION
14286
14287 =item CONSTRUCTOR
14288
14289 new (), new_from_fd ( FD, MODE )
14290
14291 =item METHODS
14292
14293 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14294 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14295 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14296 $io->blocking ( [ BOOL ] ), $io->untaint
14297
14298 =item NOTE
14299
14300 =item SEE ALSO
14301
14302 =item BUGS
14303
14304 =item HISTORY
14305
14306 =back
14307
14308 =head2 IO::Pipe - supply object methods for pipes
14309
14310 =over 4
14311
14312 =item SYNOPSIS
14313
14314 =item DESCRIPTION
14315
14316 =item CONSTRUCTOR
14317
14318 new ( [READER, WRITER] )
14319
14320 =item METHODS
14321
14322 reader ([ARGS]), writer ([ARGS]), handles ()
14323
14324 =item SEE ALSO
14325
14326 =item AUTHOR
14327
14328 =item COPYRIGHT
14329
14330 =back
14331
14332 =head2 IO::Poll - Object interface to system poll call
14333
14334 =over 4
14335
14336 =item SYNOPSIS
14337
14338 =item DESCRIPTION
14339
14340 =item METHODS
14341
14342 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14343 IO ), handles( [ EVENT_MASK ] )
14344
14345 =item SEE ALSO
14346
14347 =item AUTHOR
14348
14349 =item COPYRIGHT
14350
14351 =back
14352
14353 =head2 IO::Seekable - supply seek based methods for I/O objects
14354
14355 =over 4
14356
14357 =item SYNOPSIS
14358
14359 =item DESCRIPTION
14360
14361 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14362 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14363 $io->tell
14364
14365 =item SEE ALSO
14366
14367 =item HISTORY
14368
14369 =back
14370
14371 =head2 IO::Select - OO interface to the select system call
14372
14373 =over 4
14374
14375 =item SYNOPSIS
14376
14377 =item DESCRIPTION
14378
14379 =item CONSTRUCTOR
14380
14381 new ( [ HANDLES ] )
14382
14383 =item METHODS
14384
14385 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14386 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14387 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14388
14389 =item EXAMPLE
14390
14391 =item AUTHOR
14392
14393 =item COPYRIGHT
14394
14395 =back
14396
14397 =head2 IO::Socket - Object interface to socket communications
14398
14399 =over 4
14400
14401 =item SYNOPSIS
14402
14403 =item DESCRIPTION
14404
14405 =item CONSTRUCTOR
14406
14407 new ( [ARGS] )
14408
14409 =item METHODS
14410
14411 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14412 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14413
14414 =item SEE ALSO
14415
14416 =item AUTHOR
14417
14418 =item COPYRIGHT
14419
14420 =back
14421
14422 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14423
14424 =over 4
14425
14426 =item SYNOPSIS
14427
14428 =item DESCRIPTION
14429
14430 =item CONSTRUCTOR
14431
14432 new ( [ARGS] )
14433
14434 =over 4
14435
14436 =item METHODS
14437
14438 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14439 ()
14440
14441 =back
14442
14443 =item SEE ALSO
14444
14445 =item AUTHOR
14446
14447 =item COPYRIGHT
14448
14449 =back
14450
14451 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14452
14453 =over 4
14454
14455 =item SYNOPSIS
14456
14457 =item DESCRIPTION
14458
14459 =item CONSTRUCTOR
14460
14461 new ( [ARGS] )
14462
14463 =item METHODS
14464
14465 hostpath(), peerpath()
14466
14467 =item SEE ALSO
14468
14469 =item AUTHOR
14470
14471 =item COPYRIGHT
14472
14473 =back
14474
14475 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14476 handles
14477
14478 =over 4
14479
14480 =item SYNOPSIS
14481
14482 =item DESCRIPTION
14483
14484 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14485 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14486
14487 =item SEE ALSO
14488
14489 =item AUTHOR
14490
14491 =item COPYRIGHT
14492
14493 =back
14494
14495 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14496
14497 =over 4
14498
14499 =item SYNOPSIS
14500
14501 =item DESCRIPTION
14502
14503 =item CONSTRUCTOR
14504
14505 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14506
14507 =item METHODS
14508
14509 open( FILENAME [,MODE [,PERMS]] )
14510
14511 =item SEE ALSO
14512
14513 =item HISTORY
14514
14515 =back
14516
14517 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14518 handles
14519
14520 =over 4
14521
14522 =item SYNOPSIS
14523
14524 =item DESCRIPTION
14525
14526 =item CONSTRUCTOR
14527
14528 new (), new_from_fd ( FD, MODE )
14529
14530 =item METHODS
14531
14532 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14533 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14534 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14535 $io->blocking ( [ BOOL ] ), $io->untaint
14536
14537 =item NOTE
14538
14539 =item SEE ALSO
14540
14541 =item BUGS
14542
14543 =item HISTORY
14544
14545 =back
14546
14547 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14548
14549 =over 4
14550
14551 =item SYNOPSIS
14552
14553 =item DESCRIPTION
14554
14555 =item CONSTRUCTOR
14556
14557 new ( [READER, WRITER] )
14558
14559 =item METHODS
14560
14561 reader ([ARGS]), writer ([ARGS]), handles ()
14562
14563 =item SEE ALSO
14564
14565 =item AUTHOR
14566
14567 =item COPYRIGHT
14568
14569 =back
14570
14571 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14572
14573 =over 4
14574
14575 =item SYNOPSIS
14576
14577 =item DESCRIPTION
14578
14579 =item METHODS
14580
14581 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14582 IO ), handles( [ EVENT_MASK ] )
14583
14584 =item SEE ALSO
14585
14586 =item AUTHOR
14587
14588 =item COPYRIGHT
14589
14590 =back
14591
14592 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14593 I/O objects
14594
14595 =over 4
14596
14597 =item SYNOPSIS
14598
14599 =item DESCRIPTION
14600
14601 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14602 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14603 $io->tell
14604
14605 =item SEE ALSO
14606
14607 =item HISTORY
14608
14609 =back
14610
14611 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14612 call
14613
14614 =over 4
14615
14616 =item SYNOPSIS
14617
14618 =item DESCRIPTION
14619
14620 =item CONSTRUCTOR
14621
14622 new ( [ HANDLES ] )
14623
14624 =item METHODS
14625
14626 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14627 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14628 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14629
14630 =item EXAMPLE
14631
14632 =item AUTHOR
14633
14634 =item COPYRIGHT
14635
14636 =back
14637
14638 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14639 communications
14640
14641 =over 4
14642
14643 =item SYNOPSIS
14644
14645 =item DESCRIPTION
14646
14647 =item CONSTRUCTOR
14648
14649 new ( [ARGS] )
14650
14651 =item METHODS
14652
14653 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14654 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14655
14656 =item SEE ALSO
14657
14658 =item AUTHOR
14659
14660 =item COPYRIGHT
14661
14662 =back
14663
14664 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14665 AF_INET domain sockets
14666
14667 =over 4
14668
14669 =item SYNOPSIS
14670
14671 =item DESCRIPTION
14672
14673 =item CONSTRUCTOR
14674
14675 new ( [ARGS] )
14676
14677 =over 4
14678
14679 =item METHODS
14680
14681 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14682 ()
14683
14684 =back
14685
14686 =item SEE ALSO
14687
14688 =item AUTHOR
14689
14690 =item COPYRIGHT
14691
14692 =back
14693
14694 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14695 AF_UNIX domain sockets
14696
14697 =over 4
14698
14699 =item SYNOPSIS
14700
14701 =item DESCRIPTION
14702
14703 =item CONSTRUCTOR
14704
14705 new ( [ARGS] )
14706
14707 =item METHODS
14708
14709 hostpath(), peerpath()
14710
14711 =item SEE ALSO
14712
14713 =item AUTHOR
14714
14715 =item COPYRIGHT
14716
14717 =back
14718
14719 =head2 IPC::Msg - SysV Msg IPC object class
14720
14721 =over 4
14722
14723 =item SYNOPSIS
14724
14725 =item DESCRIPTION
14726
14727 =item METHODS
14728
14729 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14730 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14731 FLAGS ] ), stat
14732
14733 =item SEE ALSO
14734
14735 =item AUTHOR
14736
14737 =item COPYRIGHT
14738
14739 =back
14740
14741 =head2 IPC::Open2, open2 - open a process for both reading and writing
14742
14743 =over 4
14744
14745 =item SYNOPSIS
14746
14747 =item DESCRIPTION
14748
14749 =item WARNING 
14750
14751 =item SEE ALSO
14752
14753 =back
14754
14755 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14756 handling
14757
14758 =over 4
14759
14760 =item SYNOPSIS
14761
14762 =item DESCRIPTION
14763
14764 =item WARNING
14765
14766 =back
14767
14768 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14769
14770 =over 4
14771
14772 =item SYNOPSIS
14773
14774 =item DESCRIPTION
14775
14776 =item METHODS
14777
14778 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14779 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14780 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14781 , VALUE ), stat
14782
14783 =item SEE ALSO
14784
14785 =item AUTHOR
14786
14787 =item COPYRIGHT
14788
14789 =back
14790
14791 =head2 IPC::SysV - SysV IPC constants
14792
14793 =over 4
14794
14795 =item SYNOPSIS
14796
14797 =item DESCRIPTION
14798
14799 ftok( PATH, ID )
14800
14801 =item SEE ALSO
14802
14803 =item AUTHORS
14804
14805 =item COPYRIGHT
14806
14807 =back
14808
14809 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14810
14811 =over 4
14812
14813 =item SYNOPSIS
14814
14815 =item DESCRIPTION
14816
14817 =item METHODS
14818
14819 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14820 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14821 FLAGS ] ), stat
14822
14823 =item SEE ALSO
14824
14825 =item AUTHOR
14826
14827 =item COPYRIGHT
14828
14829 =back
14830
14831 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14832 class
14833
14834 =over 4
14835
14836 =item SYNOPSIS
14837
14838 =item DESCRIPTION
14839
14840 =item METHODS
14841
14842 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14843 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14844 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14845 , VALUE ), stat
14846
14847 =item SEE ALSO
14848
14849 =item AUTHOR
14850
14851 =item COPYRIGHT
14852
14853 =back
14854
14855 =head2 List::Util - A selection of general-utility list subroutines
14856
14857 =over 4
14858
14859 =item SYNOPSIS
14860
14861 =item DESCRIPTION
14862
14863 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14864 BLOCK LIST, shuffle LIST, sum LIST
14865
14866 =item KNOWN BUGS
14867
14868 =item SUGGESTED ADDITIONS
14869
14870 =item COPYRIGHT
14871
14872 =back
14873
14874 =head2 List::Utilib::List::Util, List::Util - A selection of
14875 general-utility list subroutines
14876
14877 =over 4
14878
14879 =item SYNOPSIS
14880
14881 =item DESCRIPTION
14882
14883 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14884 BLOCK LIST, shuffle LIST, sum LIST
14885
14886 =item KNOWN BUGS
14887
14888 =item SUGGESTED ADDITIONS
14889
14890 =item COPYRIGHT
14891
14892 =back
14893
14894 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14895 general-utility scalar subroutines
14896
14897 =over 4
14898
14899 =item SYNOPSIS
14900
14901 =item DESCRIPTION
14902
14903 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14904 EXPR, tainted EXPR, weaken REF
14905
14906 =item KNOWN BUGS
14907
14908 =item COPYRIGHT
14909
14910 =item BLATANT PLUG
14911
14912 =back
14913
14914 =head2 Locale::Constants - constants for Locale codes
14915
14916 =over 4
14917
14918 =item SYNOPSIS
14919
14920 =item DESCRIPTION
14921
14922 =item KNOWN BUGS AND LIMITATIONS
14923
14924 =item SEE ALSO
14925
14926 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14927
14928 =item AUTHOR
14929
14930 =item COPYRIGHT
14931
14932 =back
14933
14934 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14935
14936 =over 4
14937
14938 =item SYNOPSIS
14939
14940 =item DESCRIPTION
14941
14942 B<alpha-2>, B<alpha-3>, B<numeric>
14943
14944 =item CONVERSION ROUTINES
14945
14946 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14947 country_code2code( CODE, CODESET, CODESET )
14948
14949 =item QUERY ROUTINES
14950
14951 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14952
14953 =item SEMI-PRIVATE ROUTINES
14954
14955 =over 4
14956
14957 =item alias_code
14958
14959 =item rename_country
14960
14961 =back
14962
14963 =item EXAMPLES
14964
14965 =item DOMAIN NAMES
14966
14967 =item KNOWN BUGS AND LIMITATIONS
14968
14969 =item SEE ALSO
14970
14971 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14972 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14973 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14974 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14975
14976 =item AUTHOR
14977
14978 =item COPYRIGHT
14979
14980 =back
14981
14982 =head2 Locale::Currency - ISO three letter codes for currency
14983 identification (ISO 4217)
14984
14985 =over 4
14986
14987 =item SYNOPSIS
14988
14989 =item DESCRIPTION
14990
14991 XTS, XXX
14992
14993 =item CONVERSION ROUTINES
14994
14995 code2currency(), currency2code()
14996
14997 =item QUERY ROUTINES
14998
14999 C<all_currency_codes()>, C<all_currency_names()>
15000
15001 =item EXAMPLES
15002
15003 =item KNOWN BUGS AND LIMITATIONS
15004
15005 =item SEE ALSO
15006
15007 Locale::Country, Locale::Script, ISO 4217:1995,
15008 http://www.bsi-global.com/iso4217currency
15009
15010 =item AUTHOR
15011
15012 =item COPYRIGHT
15013
15014 =back
15015
15016 =head2 Locale::Language - ISO two letter codes for language identification
15017 (ISO 639)
15018
15019 =over 4
15020
15021 =item SYNOPSIS
15022
15023 =item DESCRIPTION
15024
15025 =item CONVERSION ROUTINES
15026
15027 code2language(), language2code()
15028
15029 =item QUERY ROUTINES
15030
15031 C<all_language_codes()>, C<all_language_names()>
15032
15033 =item EXAMPLES
15034
15035 =item KNOWN BUGS AND LIMITATIONS
15036
15037 =item SEE ALSO
15038
15039 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15040 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15041
15042 =item AUTHOR
15043
15044 =item COPYRIGHT
15045
15046 =back
15047
15048 =head2 Locale::Maketext -- framework for localization
15049
15050 =over 4
15051
15052 =item SYNOPSIS
15053
15054 =item DESCRIPTION
15055
15056 =item QUICK OVERVIEW
15057
15058 =item METHODS
15059
15060 =over 4
15061
15062 =item Construction Methods
15063
15064 =item The "maketext" Method
15065
15066 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15067
15068 =item Utility Methods
15069
15070 $language->quant($number, $singular), $language->quant($number, $singular,
15071 $plural), $language->quant($number, $singular, $plural, $negative),
15072 $language->numf($number), $language->sprintf($format, @items),
15073 $language->language_tag(), $language->encoding()
15074
15075 =item Language Handle Attributes and Internals
15076
15077 =back
15078
15079 =item LANGUAGE CLASS HIERARCHIES
15080
15081 =item ENTRIES IN EACH LEXICON
15082
15083 =item BRACKET NOTATION
15084
15085 =item AUTO LEXICONS
15086
15087 =item CONTROLLING LOOKUP FAILURE
15088
15089 =item HOW TO USE MAKETEXT
15090
15091 =item SEE ALSO
15092
15093 =item COPYRIGHT AND DISCLAIMER
15094
15095 =item AUTHOR
15096
15097 =back
15098
15099 =head2 Locale::Maketext::TPJ13 -- article about software localization
15100
15101 =over 4
15102
15103 =item SYNOPSIS
15104
15105 =item DESCRIPTION
15106
15107 =item Localization and Perl: gettext breaks, Maketext fixes
15108
15109 =over 4
15110
15111 =item A Localization Horror Story: It Could Happen To You
15112
15113 =item The Linguistic View
15114
15115 =item Breaking gettext
15116
15117 =item Replacing gettext
15118
15119 =item Buzzwords: Abstraction and Encapsulation
15120
15121 =item Buzzword: Isomorphism
15122
15123 =item Buzzword: Inheritance
15124
15125 =item Buzzword: Concision
15126
15127 =item The Devil in the Details
15128
15129 =item The Proof in the Pudding: Localizing Web Sites
15130
15131 =item References
15132
15133 =back
15134
15135 =back
15136
15137 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15138
15139 =over 4
15140
15141 =item SYNOPSIS
15142
15143 =item DESCRIPTION
15144
15145 B<alpha-2>, B<alpha-3>, B<numeric>
15146
15147 =over 4
15148
15149 =item SPECIAL CODES
15150
15151 =back
15152
15153 =item CONVERSION ROUTINES
15154
15155 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15156 script_code2code( CODE, CODESET, CODESET )
15157
15158 =item QUERY ROUTINES
15159
15160 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15161
15162 =item EXAMPLES
15163
15164 =item KNOWN BUGS AND LIMITATIONS
15165
15166 =item SEE ALSO
15167
15168 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15169 http://www.evertype.com/standards/iso15924/
15170
15171 =item AUTHOR
15172
15173 =item COPYRIGHT
15174
15175 =back
15176
15177 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15178
15179 =over 4
15180
15181 =item SYNOPSIS
15182
15183 =item DESCRIPTION
15184
15185 encode_base64($str, [$eol]), decode_base64($str)
15186
15187 =item DIAGNOSTICS
15188
15189 Premature end of base64 data, Premature padding of base64 data
15190
15191 =item EXAMPLES
15192
15193 =item COPYRIGHT
15194
15195 =back
15196
15197 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15198 of quoted-printable strings
15199
15200 =over 4
15201
15202 =item SYNOPSIS
15203
15204 =item DESCRIPTION
15205
15206 encode_qp($str), decode_qp($str);
15207
15208 =item COPYRIGHT
15209
15210 =back
15211
15212 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15213 strings
15214
15215 =over 4
15216
15217 =item SYNOPSIS
15218
15219 =item DESCRIPTION
15220
15221 encode_qp($str), decode_qp($str);
15222
15223 =item COPYRIGHT
15224
15225 =back
15226
15227 =head2 Math::BigFloat - Arbitrary size floating point math package
15228
15229 =over 4
15230
15231 =item SYNOPSIS
15232
15233 =item DESCRIPTION
15234
15235 =over 4
15236
15237 =item Canonical notation
15238
15239 =item Output
15240
15241 =item C<mantissa()>, C<exponent()> and C<parts()>
15242
15243 =item Accuracy vs. Precision
15244
15245 =item Rounding
15246
15247 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15248 ), fround  ( -$scale ) and fround ( 0 )
15249
15250 =back
15251
15252 =item EXAMPLES
15253
15254   # not ready yet
15255
15256 =item Autocreating constants
15257
15258 =over 4
15259
15260 =item Math library
15261
15262 =item Using Math::BigInt::Lite
15263
15264 =back
15265
15266 =item BUGS
15267
15268 =item CAVEAT
15269
15270 stringify, bstr(), bdiv, Modifying and =, bpow
15271
15272 =item LICENSE
15273
15274 =item AUTHORS
15275
15276 =back
15277
15278 =head2 Math::BigInt - Arbitrary size integer math package
15279
15280 =over 4
15281
15282 =item SYNOPSIS
15283
15284 =item DESCRIPTION
15285
15286 Canonical notation, Input, Output
15287
15288 =item METHODS
15289
15290 =over 4
15291
15292 =item config
15293
15294 =item accuracy
15295
15296 =item brsft
15297
15298 =item new
15299
15300 =item bnan
15301
15302 =item bzero
15303
15304 =item binf
15305
15306 =item bone
15307
15308 =item is_one()/is_zero()/is_nan()/is_inf()
15309
15310 =item is_positive()/is_negative()
15311
15312         $x->is_positive();              # true if >= 0
15313         $x->is_negative();              # true if <  0
15314
15315 =item is_odd()/is_even()/is_int()
15316
15317 =item bcmp
15318
15319 =item bacmp
15320
15321 =item sign
15322
15323 =item bcmp
15324
15325 =item bneg
15326
15327 =item babs
15328
15329 =item bnorm
15330
15331 =item bnot
15332
15333 =item binc
15334
15335 =item bdec
15336
15337 =item badd
15338
15339 =item bsub
15340
15341 =item bmul
15342
15343 =item bdiv
15344
15345 =item bmod
15346
15347 =item bmodinv
15348
15349 =item bmodpow
15350
15351 =item bpow
15352
15353 =item blsft
15354
15355 =item brsft
15356
15357 =item band
15358
15359 =item bior
15360
15361 =item bxor
15362
15363 =item bnot
15364
15365 =item bsqrt
15366
15367 =item bfac
15368
15369 =item round
15370
15371 =item bround
15372
15373 =item bfround
15374
15375 =item bfloor
15376
15377 =item bceil
15378
15379 =item bgcd
15380
15381 =item blcm
15382
15383 =item exponent
15384
15385 =item mantissa
15386
15387 =item parts
15388
15389 =item copy
15390
15391 =item as_number
15392
15393 =item bsstr
15394
15395 =item as_hex
15396
15397 =item as_bin
15398
15399 =back
15400
15401 =item ACCURACY and PRECISION
15402
15403 =over 4
15404
15405 =item Precision P
15406
15407 =item Accuracy A
15408
15409 =item Fallback F
15410
15411 =item Rounding mode R
15412
15413 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15414 (significant digits), Setting/Accessing, Creating numbers, Usage,
15415 Precedence, Overriding globals, Local settings, Rounding, Default values,
15416 Remarks
15417
15418 =back
15419
15420 =item INTERNALS
15421
15422 =over 4
15423
15424 =item MATH LIBRARY
15425
15426 =item SIGN
15427
15428 =item mantissa(), exponent() and parts()
15429
15430 =back
15431
15432 =item EXAMPLES
15433
15434   use Math::BigInt;
15435
15436 =item Autocreating constants
15437
15438 =item PERFORMANCE
15439
15440 =over 4
15441
15442 =item Alternative math libraries
15443
15444 =item SUBCLASSING
15445
15446 =back
15447
15448 =item Subclassing Math::BigInt
15449
15450 =item UPGRADING
15451
15452 =over 4
15453
15454 =item Auto-upgrade
15455
15456 bsqrt(), div(), blog()
15457
15458 =back
15459
15460 =item BUGS
15461
15462 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15463
15464 =item CAVEATS
15465
15466 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15467 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15468 types, bsqrt(), brsft()
15469
15470 =item LICENSE
15471
15472 =item SEE ALSO
15473
15474 =item AUTHORS
15475
15476 =back
15477
15478 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15479
15480 =over 4
15481
15482 =item SYNOPSIS
15483
15484 =item DESCRIPTION
15485
15486 =item EXPORT
15487
15488 =item WRAP YOUR OWN
15489
15490 =item LICENSE
15491
15492 This program is free software; you may redistribute it and/or modify it
15493 under
15494 the same terms as Perl itself. 
15495
15496 =item AUTHORS
15497
15498 =item SEE ALSO
15499
15500 =back
15501
15502 =head2 Math::BigRat - arbitrarily big rationals
15503
15504 =over 4
15505
15506 =item SYNOPSIS
15507
15508 =item DESCRIPTION
15509
15510 =over 4
15511
15512 =item MATH LIBRARY
15513
15514 =back
15515
15516 =item METHODS
15517
15518 =over 4
15519
15520 =item new()
15521
15522 =item numerator()
15523
15524 =item denominator()
15525
15526         $d = $x->denominator();
15527
15528 =item parts()
15529
15530 =item as_number()
15531
15532 =item bfac()
15533
15534 =item blog()
15535
15536 =item bround()/round()/bfround()
15537
15538 =back
15539
15540 =item BUGS
15541
15542 =item LICENSE
15543
15544 =item SEE ALSO
15545
15546 =item AUTHORS
15547
15548 =back
15549
15550 =head2 Math::Complex - complex numbers and associated mathematical
15551 functions
15552
15553 =over 4
15554
15555 =item SYNOPSIS
15556
15557 =item DESCRIPTION
15558
15559 =item OPERATIONS
15560
15561 =item CREATION
15562
15563 =item STRINGIFICATION
15564
15565 =over 4
15566
15567 =item CHANGED IN PERL 5.6
15568
15569 =back
15570
15571 =item USAGE
15572
15573 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15574
15575 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15576
15577 =item BUGS
15578
15579 =item AUTHORS
15580
15581 =back
15582
15583 =head2 Math::Trig - trigonometric functions
15584
15585 =over 4
15586
15587 =item SYNOPSIS
15588
15589 =item DESCRIPTION
15590
15591 =item TRIGONOMETRIC FUNCTIONS
15592
15593 B<tan>
15594
15595 =over 4
15596
15597 =item ERRORS DUE TO DIVISION BY ZERO
15598
15599 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15600
15601 =back
15602
15603 =item PLANE ANGLE CONVERSIONS
15604
15605 =item RADIAL COORDINATE CONVERSIONS
15606
15607 =over 4
15608
15609 =item COORDINATE SYSTEMS
15610
15611 =item 3-D ANGLE CONVERSIONS
15612
15613 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15614 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15615
15616 =back
15617
15618 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15619
15620 =item EXAMPLES
15621
15622 =over 4
15623
15624 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15625
15626 =back
15627
15628 =item BUGS
15629
15630 =item AUTHORS
15631
15632 =back
15633
15634 =head2 Memoize - Make functions faster by trading space for time
15635
15636 =over 4
15637
15638 =item SYNOPSIS
15639
15640 =item DESCRIPTION
15641
15642 =item DETAILS
15643
15644 =item OPTIONS
15645
15646 =over 4
15647
15648 =item INSTALL
15649
15650 =item NORMALIZER
15651
15652 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15653
15654 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15655
15656 =back
15657
15658 =item OTHER FACILITIES
15659
15660 =over 4
15661
15662 =item C<unmemoize>
15663
15664 =item C<flush_cache>
15665
15666 =back
15667
15668 =item CAVEATS
15669
15670 =item PERSISTENT CACHE SUPPORT
15671
15672 =item EXPIRATION SUPPORT
15673
15674 =item BUGS
15675
15676 =item MAILING LIST
15677
15678 =item AUTHOR
15679
15680 =item COPYRIGHT AND LICENSE
15681
15682 =item THANK YOU
15683
15684 =back
15685
15686 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15687 Storable use
15688
15689 =over 4
15690
15691 =item DESCRIPTION
15692
15693 =back
15694
15695 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15696 memoized values
15697
15698 =over 4
15699
15700 =item SYNOPSIS
15701
15702 =item DESCRIPTION
15703
15704 =item INTERFACE
15705
15706  TIEHASH,  EXISTS,  STORE
15707
15708 =item ALTERNATIVES
15709
15710 =item CAVEATS
15711
15712 =item AUTHOR
15713
15714 =item SEE ALSO
15715
15716 =back
15717
15718 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15719
15720 =over 4
15721
15722 =item DESCRIPTION
15723
15724 =back
15725
15726 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15727
15728 =over 4
15729
15730 =item DESCRIPTION
15731
15732 =back
15733
15734 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15735 Storable use
15736
15737 =over 4
15738
15739 =item DESCRIPTION
15740
15741 =back
15742
15743 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15744 Storable use
15745
15746 =over 4
15747
15748 =item DESCRIPTION
15749
15750 =back
15751
15752 =head2 Memoize::Storable - store Memoized data in Storable database
15753
15754 =over 4
15755
15756 =item DESCRIPTION
15757
15758 =back
15759
15760 =head2 NDBM_File - Tied access to ndbm files
15761
15762 =over 4
15763
15764 =item SYNOPSIS
15765
15766 =item DESCRIPTION
15767
15768 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15769
15770 =item DIAGNOSTICS
15771
15772 =over 4
15773
15774 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15775
15776 =back
15777
15778 =item BUGS AND WARNINGS
15779
15780 =back
15781
15782 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15783
15784 =over 4
15785
15786 =item SYNOPSIS
15787
15788 =item DESCRIPTION
15789
15790 =over 4
15791
15792 =item Enforcing redispatch
15793
15794 =item Avoiding repetitions
15795
15796 =back
15797
15798 =item AUTHOR
15799
15800 =item BUGS AND IRRITATIONS
15801
15802 =item COPYRIGHT
15803
15804 =back
15805
15806 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15807
15808 =over 4
15809
15810 =item SYNOPSIS
15811
15812 =item DESCRIPTION
15813
15814 =item USER METHODS
15815
15816 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15817 dataend ()
15818
15819 =item CLASS METHODS
15820
15821 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15822 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15823 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15824
15825 =item EXPORTS
15826
15827 =item AUTHOR
15828
15829 =item COPYRIGHT
15830
15831 =back
15832
15833 =head2 Net::Config - Local configuration data for libnet
15834
15835 =over 4
15836
15837 =item SYNOPSYS
15838
15839 =item DESCRIPTION
15840
15841 =item METHODS
15842
15843 requires_firewall HOST
15844
15845 =item NetConfig VALUES
15846
15847 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15848 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15849 ftp_int_pasive, local_netmask, test_hosts, test_exists
15850
15851 =back
15852
15853 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15854 and domain
15855
15856 =over 4
15857
15858 =item SYNOPSIS
15859
15860 =item DESCRIPTION
15861
15862 hostfqdn (), hostname (), hostdomain ()
15863
15864 =item AUTHOR
15865
15866 =item COPYRIGHT
15867
15868 =back
15869
15870 =head2 Net::FTP - FTP Client class
15871
15872 =over 4
15873
15874 =item SYNOPSIS
15875
15876 =item DESCRIPTION
15877
15878 =item OVERVIEW
15879
15880 =item CONSTRUCTOR
15881
15882 new (HOST [,OPTIONS])
15883
15884 =item METHODS
15885
15886 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15887 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15888 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15889 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15890 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15891 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15892 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15893 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15894 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15895 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15896 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15897 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15898 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15899
15900 =over 4
15901
15902 =item Methods for the adventurous
15903
15904 quot (CMD [,ARGS])
15905
15906 =back
15907
15908 =item THE dataconn CLASS
15909
15910 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15911 bytes_read (), abort (), close ()
15912
15913 =item UNIMPLEMENTED
15914
15915 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15916
15917 =item REPORTING BUGS
15918
15919 =item AUTHOR
15920
15921 =item SEE ALSO
15922
15923 =item USE EXAMPLES
15924
15925 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15926
15927 =item CREDITS
15928
15929 =item COPYRIGHT
15930
15931 =back
15932
15933 =head2 Net::NNTP - NNTP Client class
15934
15935 =over 4
15936
15937 =item SYNOPSIS
15938
15939 =item DESCRIPTION
15940
15941 =item CONSTRUCTOR
15942
15943 new ( [ HOST ] [, OPTIONS ])
15944
15945 =item METHODS
15946
15947 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15948 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15949 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15950 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15951 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15952 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15953 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15954
15955 =over 4
15956
15957 =item Extension methods
15958
15959 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15960 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15961 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15962 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15963 GROUP ] ), reader
15964
15965 =back
15966
15967 =item UNSUPPORTED
15968
15969 =item DEFINITIONS
15970
15971 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15972
15973 =item SEE ALSO
15974
15975 =item AUTHOR
15976
15977 =item COPYRIGHT
15978
15979 =back
15980
15981 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15982
15983 =over 4
15984
15985 =item SYNOPSIS
15986
15987 =item DESCRIPTION
15988
15989 =item EXAMPLES
15990
15991 =item CONSTRUCTOR
15992
15993 new ( [ HOST, ] [ OPTIONS ] )
15994
15995 =item METHODS
15996
15997 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15998 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15999 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16000 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16001
16002 =item NOTES
16003
16004 =item SEE ALSO
16005
16006 =item AUTHOR
16007
16008 =item COPYRIGHT
16009
16010 =back
16011
16012 =head2 Net::Ping - check a remote host for reachability
16013
16014 =over 4
16015
16016 =item SYNOPSIS
16017
16018 =item DESCRIPTION
16019
16020 =over 4
16021
16022 =item Functions
16023
16024 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( {
16025 0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host
16026 [, $timeout]);, $p->open($host);, $p->close();, pingecho($host [,
16027 $timeout]);
16028
16029 =back
16030
16031 =item WARNING
16032
16033 =item NOTES
16034
16035 =item AUTHORS
16036
16037 =item COPYRIGHT
16038
16039 =back
16040
16041 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16042
16043 =over 4
16044
16045 =item SYNOPSIS
16046
16047 =item DESCRIPTION
16048
16049 =item EXAMPLES
16050
16051 =item CONSTRUCTOR
16052
16053 new Net::SMTP [ HOST, ] [ OPTIONS ]
16054
16055 =item METHODS
16056
16057 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16058 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16059 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16060 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16061 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16062 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16063 quit ()
16064
16065 =item ADDRESSES
16066
16067 =item SEE ALSO
16068
16069 =item AUTHOR
16070
16071 =item COPYRIGHT
16072
16073 =back
16074
16075 =head2 Net::Time - time and daytime network client interface
16076
16077 =over 4
16078
16079 =item SYNOPSIS
16080
16081 =item DESCRIPTION
16082
16083 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16084 PROTOCOL [, TIMEOUT]]])
16085
16086 =item AUTHOR
16087
16088 =item COPYRIGHT
16089
16090 =back
16091
16092 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16093 functions
16094
16095 =over 4
16096
16097 =item SYNOPSIS
16098
16099 =item DESCRIPTION
16100
16101 =item EXAMPLES
16102
16103 =item NOTE
16104
16105 =item AUTHOR
16106
16107 =back
16108
16109 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16110
16111 =over 4
16112
16113 =item DESCRIPTION
16114
16115 =over 4
16116
16117 =item Where to get this document
16118
16119 =item How to contribute to this document
16120
16121 =back
16122
16123 =item Author and Copyright Information
16124
16125 =over 4
16126
16127 =item Disclaimer
16128
16129 =back
16130
16131 =item Obtaining and installing libnet
16132
16133 =over 4
16134
16135 =item What is libnet ?
16136
16137 =item Which version of perl do I need ?
16138
16139 =item What other modules do I need ?
16140
16141 =item What machines support libnet ?
16142
16143 =item Where can I get the latest libnet release
16144
16145 =back
16146
16147 =item Using Net::FTP
16148
16149 =over 4
16150
16151 =item How do I download files from an FTP server ?
16152
16153 =item How do I transfer files in binary mode ?
16154
16155 =item How can I get the size of a file on a remote FTP server ?
16156
16157 =item How can I get the modification time of a file on a remote FTP server
16158 ?
16159
16160 =item How can I change the permissions of a file on a remote server ?
16161
16162 =item Can I do a reget operation like the ftp command ?
16163
16164 =item How do I get a directory listing from an FTP server ?
16165
16166 =item Changing directory to "" does not fail ?
16167
16168 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16169
16170 =item I am behind an FTP proxy firewall, but cannot access machines outside
16171 ?
16172
16173 =item My ftp proxy firewall does not listen on port 21
16174
16175 =item Is it possible to change the file permissions of a file on an FTP
16176 server ?
16177
16178 =item I have seen scripts call a method message, but cannot find it
16179 documented ?
16180
16181 =item Why does Net::FTP not implement mput and mget methods
16182
16183 =back
16184
16185 =item Using Net::SMTP
16186
16187 =over 4
16188
16189 =item Why can't the part of an Email address after the @ be used as the
16190 hostname ?
16191
16192 =item Why does Net::SMTP not do DNS MX lookups ?
16193
16194 =item The verify method always returns true ?
16195
16196 =back
16197
16198 =item Debugging scripts
16199
16200 =over 4
16201
16202 =item How can I debug my scripts that use Net::* modules ?
16203
16204 =back
16205
16206 =item AUTHOR AND COPYRIGHT
16207
16208 =back
16209
16210 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16211 functions
16212
16213 =over 4
16214
16215 =item SYNOPSIS
16216
16217 =item DESCRIPTION
16218
16219 =item EXAMPLES
16220
16221 =item NOTE
16222
16223 =item AUTHOR
16224
16225 =back
16226
16227 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16228 functions
16229
16230 =over 4
16231
16232 =item SYNOPSIS
16233
16234 =item DESCRIPTION
16235
16236 =item NOTE
16237
16238 =item AUTHOR
16239
16240 =back
16241
16242 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16243 functions
16244
16245 =over 4
16246
16247 =item SYNOPSIS
16248
16249 =item DESCRIPTION
16250
16251 =item EXAMPLES
16252
16253 =item NOTE
16254
16255 =item AUTHOR
16256
16257 =back
16258
16259 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16260
16261 =over 4
16262
16263 =item SYNOPSIS
16264
16265 =item DESCRIPTION
16266
16267 =item THE .netrc FILE
16268
16269 machine name, default, login name, password string, account string, macdef
16270 name
16271
16272 =item CONSTRUCTOR
16273
16274 lookup ( MACHINE [, LOGIN ])
16275
16276 =item METHODS
16277
16278 login (), password (), account (), lpa ()
16279
16280 =item AUTHOR
16281
16282 =item SEE ALSO
16283
16284 =item COPYRIGHT
16285
16286 =back
16287
16288 =head2 O - Generic interface to Perl Compiler backends
16289
16290 =over 4
16291
16292 =item SYNOPSIS
16293
16294 =item DESCRIPTION
16295
16296 =item CONVENTIONS
16297
16298 =item IMPLEMENTATION
16299
16300 =item BUGS
16301
16302 =item AUTHOR
16303
16304 =back
16305
16306 =head2 ODBM_File - Tied access to odbm files
16307
16308 =over 4
16309
16310 =item SYNOPSIS
16311
16312 =item DESCRIPTION
16313
16314 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16315
16316 =item DIAGNOSTICS
16317
16318 =over 4
16319
16320 =item C<odbm store returned -1, errno 22, key "..." at ...>
16321
16322 =back
16323
16324 =item BUGS AND WARNINGS
16325
16326 =back
16327
16328 =head2 Opcode - Disable named opcodes when compiling perl code
16329
16330 =over 4
16331
16332 =item SYNOPSIS
16333
16334 =item DESCRIPTION
16335
16336 =item NOTE
16337
16338 =item WARNING
16339
16340 =item Operator Names and Operator Lists
16341
16342 an operator name (opname), an operator tag name (optag), a negated opname
16343 or optag, an operator set (opset)
16344
16345 =item Opcode Functions
16346
16347 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16348 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16349 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16350 opdump (PAT)
16351
16352 =item Manipulating Opsets
16353
16354 =item TO DO (maybe)
16355
16356 =back
16357
16358 =over 4
16359
16360 =item Predefined Opcode Tags
16361
16362 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16363 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16364 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16365 :dangerous
16366
16367 =item SEE ALSO
16368
16369 =item AUTHORS
16370
16371 =back
16372
16373 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16374 compartments
16375
16376 =over 4
16377
16378 =item SYNOPSIS
16379
16380 =item DESCRIPTION
16381
16382 a new namespace, an operator mask
16383
16384 =item WARNING
16385
16386 =over 4
16387
16388 =item RECENT CHANGES
16389
16390 =item Methods in class Safe
16391
16392 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16393 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16394 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16395 root (NAMESPACE), mask (MASK)
16396
16397 =item Some Safety Issues
16398
16399 Memory, CPU, Snooping, Signals, State Changes
16400
16401 =item AUTHOR
16402
16403 =back
16404
16405 =back
16406
16407 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16408 compiling
16409
16410 =over 4
16411
16412 =item SYNOPSIS  
16413
16414 =item DESCRIPTION
16415
16416 =item SEE ALSO
16417
16418 =back
16419
16420 =head2 POSIX - Perl interface to IEEE Std 1003.1
16421
16422 =over 4
16423
16424 =item SYNOPSIS
16425
16426 =item DESCRIPTION
16427
16428 =item NOTE
16429
16430 =item CAVEATS 
16431
16432 =item FUNCTIONS
16433
16434 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16435 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16436 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16437 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16438 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16439 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16440 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16441 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16442 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16443 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16444 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16445 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16446 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16447 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16448 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16449 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16450 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16451 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16452 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16453 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16454 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16455 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16456 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16457 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16458 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16459 wctomb, write
16460
16461 =item CLASSES
16462
16463 =over 4
16464
16465 =item POSIX::SigAction
16466
16467 new
16468
16469 =item POSIX::SigSet
16470
16471 new, addset, delset, emptyset, fillset, ismember
16472
16473 =item POSIX::Termios
16474
16475 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16476 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16477 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16478 field values, c_cflag field values, c_iflag field values, c_lflag field
16479 values, c_oflag field values
16480
16481 =back
16482
16483 =item PATHNAME CONSTANTS
16484
16485 Constants
16486
16487 =item POSIX CONSTANTS
16488
16489 Constants
16490
16491 =item SYSTEM CONFIGURATION
16492
16493 Constants
16494
16495 =item ERRNO
16496
16497 Constants
16498
16499 =item FCNTL
16500
16501 Constants
16502
16503 =item FLOAT
16504
16505 Constants
16506
16507 =item LIMITS
16508
16509 Constants
16510
16511 =item LOCALE
16512
16513 Constants
16514
16515 =item MATH
16516
16517 Constants
16518
16519 =item SIGNAL
16520
16521 Constants
16522
16523 =item STAT
16524
16525 Constants, Macros
16526
16527 =item STDLIB
16528
16529 Constants
16530
16531 =item STDIO
16532
16533 Constants
16534
16535 =item TIME
16536
16537 Constants
16538
16539 =item UNISTD
16540
16541 Constants
16542
16543 =item WAIT
16544
16545 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16546 WTERMSIG, WIFSTOPPED, WSTOPSIG
16547
16548 =back
16549
16550 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16551 name space
16552
16553 =over 4
16554
16555 =item SYNOPSIS
16556
16557 =item DESCRIPTION
16558
16559 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
16560
16561 =over 4
16562
16563 =item Alternatives to raw
16564
16565 =item Defaults and how to override them
16566
16567 =back
16568
16569 =item AUTHOR
16570
16571 =item SEE ALSO
16572
16573 =back
16574
16575 =head2 PerlIO::encoding - encoding layer
16576
16577 =over 4
16578
16579 =item SYNOPSIS
16580
16581 =item DESCRIPTION
16582
16583 =item SEE ALSO
16584
16585 =back
16586
16587 =head2 PerlIO::scalar - support module for in-memory IO.
16588
16589 =over 4
16590
16591 =item SYNOPSIS
16592
16593 =item DESCRIPTION
16594
16595 =back
16596
16597 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
16598
16599 =over 4
16600
16601 =item SYNOPSIS
16602
16603 =item DESCRIPTION
16604
16605 =item EXPECTED METHODS
16606
16607 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16608 $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
16609 $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
16610 $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
16611 $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
16612 $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
16613 $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
16614 $obj->EOF($fh)
16615
16616 =item EXAMPLES
16617
16618 =over 4
16619
16620 =item Example - a Hexadecimal Handle
16621
16622 =back
16623
16624 =back
16625
16626 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
16627
16628 =over 4
16629
16630 =item SYNOPSIS
16631
16632 =item DESCRIPTION
16633
16634 =item SEE ALSO
16635
16636 =item COPYRIGHT
16637
16638 =back
16639
16640 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16641
16642 =over 4
16643
16644 =item SYNOPSIS
16645
16646 =item OPTIONS/ARGUMENTS
16647
16648 =over 4
16649
16650 =item podchecker()
16651
16652 B<-warnings> =E<gt> I<val>
16653
16654 =back
16655
16656 =item DESCRIPTION
16657
16658 =item DIAGNOSTICS
16659
16660 =over 4
16661
16662 =item Errors
16663
16664 empty =headn, =over on line I<N> without closing =back, =item without
16665 previous =over, =back without previous =over, No argument for =begin, =end
16666 without =begin, Nested =begin's, =for without formatter specification,
16667 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16668 interior-sequence "I<SEQ>", nested commands
16669 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16670 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16671 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16672 after =back
16673
16674 =item Warnings
16675
16676 multiple occurrence of link target I<name>, line containing nothing but
16677 whitespace in paragraph, file does not start with =head, previous =item has
16678 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16679 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16680 items in =over, No argument for =item, empty section in previous paragraph,
16681 Verbatim paragraph in NAME section
16682
16683 =item Hyperlinks
16684
16685 ignoring leading/trailing whitespace in link, (section) in '$page'
16686 deprecated, alternative text/node '%s' contains non-escaped | or /
16687
16688 =back
16689
16690 =item RETURN VALUE
16691
16692 =item EXAMPLES
16693
16694 =item INTERFACE
16695
16696 =back
16697
16698 C<Pod::Checker-E<gt>new( %options )>
16699
16700 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16701 @args )>
16702
16703 C<$checker-E<gt>num_errors()>
16704
16705 C<$checker-E<gt>name()>
16706
16707 C<$checker-E<gt>node()>
16708
16709 C<$checker-E<gt>idx()>
16710
16711 C<$checker-E<gt>hyperlink()>
16712
16713 =over 4
16714
16715 =item AUTHOR
16716
16717 =back
16718
16719 =head2 Pod::Find - find POD documents in directory trees
16720
16721 =over 4
16722
16723 =item SYNOPSIS
16724
16725 =item DESCRIPTION
16726
16727 =back
16728
16729 =over 4
16730
16731 =item C<pod_find( { %opts } , @directories )>
16732
16733 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16734 1>
16735
16736 =back
16737
16738 =over 4
16739
16740 =item C<simplify_name( $str )>
16741
16742 =back
16743
16744 =over 4
16745
16746 =item C<pod_where( { %opts }, $pod )>
16747
16748 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16749 1>
16750
16751 =back
16752
16753 =over 4
16754
16755 =item C<contains_pod( $file , $verbose )>
16756
16757 =back
16758
16759 =over 4
16760
16761 =item AUTHOR
16762
16763 =item SEE ALSO
16764
16765 =back
16766
16767 =head2 Pod::Html - module to convert pod files to HTML
16768
16769 =over 4
16770
16771 =item SYNOPSIS
16772
16773 =item DESCRIPTION
16774
16775 =item ARGUMENTS
16776
16777 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16778 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16779 title, verbose
16780
16781 =item EXAMPLE
16782
16783 =item ENVIRONMENT
16784
16785 =item AUTHOR
16786
16787 =item SEE ALSO
16788
16789 =item COPYRIGHT
16790
16791 =back
16792
16793 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16794 commands, etc.
16795
16796 =over 4
16797
16798 =item SYNOPSIS
16799
16800 =item REQUIRES
16801
16802 =item EXPORTS
16803
16804 =item DESCRIPTION
16805
16806 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16807 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item B<Pod::InputSource>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item B<new()>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item B<name()>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item B<handle()>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item B<was_cutting()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item B<Pod::Paragraph>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item Pod::Paragraph-E<gt>B<new()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item $pod_para-E<gt>B<cmd_name()>
16856
16857 =back
16858
16859 =over 4
16860
16861 =item $pod_para-E<gt>B<text()>
16862
16863 =back
16864
16865 =over 4
16866
16867 =item $pod_para-E<gt>B<raw_text()>
16868
16869 =back
16870
16871 =over 4
16872
16873 =item $pod_para-E<gt>B<cmd_prefix()>
16874
16875 =back
16876
16877 =over 4
16878
16879 =item $pod_para-E<gt>B<cmd_separator()>
16880
16881 =back
16882
16883 =over 4
16884
16885 =item $pod_para-E<gt>B<parse_tree()>
16886
16887 =back
16888
16889 =over 4
16890
16891 =item $pod_para-E<gt>B<file_line()>
16892
16893 =back
16894
16895 =over 4
16896
16897 =item B<Pod::InteriorSequence>
16898
16899 =back
16900
16901 =over 4
16902
16903 =item Pod::InteriorSequence-E<gt>B<new()>
16904
16905 =back
16906
16907 =over 4
16908
16909 =item $pod_seq-E<gt>B<cmd_name()>
16910
16911 =back
16912
16913 =over 4
16914
16915 =item $pod_seq-E<gt>B<prepend()>
16916
16917 =back
16918
16919 =over 4
16920
16921 =item $pod_seq-E<gt>B<append()>
16922
16923 =back
16924
16925 =over 4
16926
16927 =item $pod_seq-E<gt>B<nested()>
16928
16929 =back
16930
16931 =over 4
16932
16933 =item $pod_seq-E<gt>B<raw_text()>
16934
16935 =back
16936
16937 =over 4
16938
16939 =item $pod_seq-E<gt>B<left_delimiter()>
16940
16941 =back
16942
16943 =over 4
16944
16945 =item $pod_seq-E<gt>B<right_delimiter()>
16946
16947 =back
16948
16949 =over 4
16950
16951 =item $pod_seq-E<gt>B<parse_tree()>
16952
16953 =back
16954
16955 =over 4
16956
16957 =item $pod_seq-E<gt>B<file_line()>
16958
16959 =back
16960
16961 =over 4
16962
16963 =item Pod::InteriorSequence::B<DESTROY()>
16964
16965 =back
16966
16967 =over 4
16968
16969 =item B<Pod::ParseTree>
16970
16971 =back
16972
16973 =over 4
16974
16975 =item Pod::ParseTree-E<gt>B<new()>
16976
16977 =back
16978
16979 =over 4
16980
16981 =item $ptree-E<gt>B<top()>
16982
16983 =back
16984
16985 =over 4
16986
16987 =item $ptree-E<gt>B<children()>
16988
16989 =back
16990
16991 =over 4
16992
16993 =item $ptree-E<gt>B<prepend()>
16994
16995 =back
16996
16997 =over 4
16998
16999 =item $ptree-E<gt>B<append()>
17000
17001 =back
17002
17003 =over 4
17004
17005 =item $ptree-E<gt>B<raw_text()>
17006
17007 =back
17008
17009 =over 4
17010
17011 =item Pod::ParseTree::B<DESTROY()>
17012
17013 =back
17014
17015 =over 4
17016
17017 =item SEE ALSO
17018
17019 =item AUTHOR
17020
17021 =back
17022
17023 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17024
17025 =over 4
17026
17027 =item SYNOPSIS
17028
17029 =item DESCRIPTION
17030
17031 =back
17032
17033 =over 4
17034
17035 =item OBJECT METHODS
17036
17037 C<initialize>
17038
17039 =back
17040
17041 =over 4
17042
17043 =item Data Accessors
17044
17045 B<AddPreamble>
17046
17047 =back
17048
17049 B<AddPostamble>
17050
17051 B<Head1Level>
17052
17053 B<Label>
17054
17055 B<LevelNoNum>
17056
17057 B<MakeIndex>
17058
17059 B<ReplaceNAMEwithSection>
17060
17061 B<StartWithNewPage>
17062
17063 B<TableOfContents>
17064
17065 B<UniqueLabels>
17066
17067 B<UserPreamble>
17068
17069 B<UserPostamble>
17070
17071 B<Lists>
17072
17073 =over 4
17074
17075 =item Subclassed methods
17076
17077 =back
17078
17079 B<begin_pod>
17080
17081 B<end_pod>
17082
17083 B<command>
17084
17085 B<verbatim>
17086
17087 B<textblock>
17088
17089 B<interior_sequence>
17090
17091 =over 4
17092
17093 =item List Methods
17094
17095 B<begin_list>
17096
17097 =back
17098
17099 B<end_list>
17100
17101 B<add_item>
17102
17103 =over 4
17104
17105 =item Methods for headings
17106
17107 B<head>
17108
17109 =back
17110
17111 =over 4
17112
17113 =item Internal methods
17114
17115 B<_output>
17116
17117 =back
17118
17119 B<_replace_special_chars>
17120
17121 B<_replace_special_chars_late>
17122
17123 B<_create_label>
17124
17125 B<_create_index>
17126
17127 B<_clean_latex_commands>
17128
17129 B<_split_delimited>
17130
17131 =over 4
17132
17133 =item NOTES
17134
17135 =item SEE ALSO
17136
17137 =item AUTHORS
17138
17139 =item COPYRIGHT
17140
17141 =item REVISION
17142
17143 =back
17144
17145 =head2 Pod::Man - Convert POD data to formatted *roff input
17146
17147 =over 4
17148
17149 =item SYNOPSIS
17150
17151 =item DESCRIPTION
17152
17153 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17154 release, section
17155
17156 =item DIAGNOSTICS
17157
17158 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17159 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17160 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17161 =back
17162
17163 =item BUGS
17164
17165 =item CAVEATS
17166
17167 =item SEE ALSO
17168
17169 =item AUTHOR
17170
17171 =item COPYRIGHT AND LICENSE
17172
17173 =back
17174
17175 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17176
17177 =over 4
17178
17179 =item SYNOPSIS
17180
17181 =item DESCRIPTION
17182
17183 =item AUTHOR
17184
17185 =item COPYRIGHT AND LICENSE
17186
17187 =back
17188
17189 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17190
17191 =over 4
17192
17193 =item SYNOPSIS
17194
17195 =item DESCRIPTION
17196
17197 =back
17198
17199 =over 4
17200
17201 =item Pod::List
17202
17203 Pod::List-E<gt>new()
17204
17205 =back
17206
17207 $list-E<gt>file()
17208
17209 $list-E<gt>start()
17210
17211 $list-E<gt>indent()
17212
17213 $list-E<gt>type()
17214
17215 $list-E<gt>rx()
17216
17217 $list-E<gt>item()
17218
17219 $list-E<gt>parent()
17220
17221 $list-E<gt>tag()
17222
17223 =over 4
17224
17225 =item Pod::Hyperlink
17226
17227 Pod::Hyperlink-E<gt>new()
17228
17229 =back
17230
17231 $link-E<gt>parse($string)
17232
17233 $link-E<gt>markup($string)
17234
17235 $link-E<gt>text()
17236
17237 $link-E<gt>warning()
17238
17239 $link-E<gt>file(), $link-E<gt>line()
17240
17241 $link-E<gt>page()
17242
17243 $link-E<gt>node()
17244
17245 $link-E<gt>alttext()
17246
17247 $link-E<gt>type()
17248
17249 $link-E<gt>link()
17250
17251 =over 4
17252
17253 =item Pod::Cache
17254
17255 Pod::Cache-E<gt>new()
17256
17257 =back
17258
17259 $cache-E<gt>item()
17260
17261 $cache-E<gt>find_page($name)
17262
17263 =over 4
17264
17265 =item Pod::Cache::Item
17266
17267 Pod::Cache::Item-E<gt>new()
17268
17269 =back
17270
17271 $cacheitem-E<gt>page()
17272
17273 $cacheitem-E<gt>description()
17274
17275 $cacheitem-E<gt>path()
17276
17277 $cacheitem-E<gt>file()
17278
17279 $cacheitem-E<gt>nodes()
17280
17281 $cacheitem-E<gt>find_node($name)
17282
17283 $cacheitem-E<gt>idx()
17284
17285 =over 4
17286
17287 =item AUTHOR
17288
17289 =item SEE ALSO
17290
17291 =back
17292
17293 =head2 Pod::Parser - base class for creating POD filters and translators
17294
17295 =over 4
17296
17297 =item SYNOPSIS
17298
17299 =item REQUIRES
17300
17301 =item EXPORTS
17302
17303 =item DESCRIPTION
17304
17305 =item QUICK OVERVIEW
17306
17307 =item PARSING OPTIONS
17308
17309 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17310 B<-warnings> (default: unset)
17311
17312 =back
17313
17314 =over 4
17315
17316 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17317
17318 =back
17319
17320 =over 4
17321
17322 =item B<command()>
17323
17324 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17325
17326 =back
17327
17328 =over 4
17329
17330 =item B<verbatim()>
17331
17332 C<$text>, C<$line_num>, C<$pod_para>
17333
17334 =back
17335
17336 =over 4
17337
17338 =item B<textblock()>
17339
17340 C<$text>, C<$line_num>, C<$pod_para>
17341
17342 =back
17343
17344 =over 4
17345
17346 =item B<interior_sequence()>
17347
17348 =back
17349
17350 =over 4
17351
17352 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17353
17354 =back
17355
17356 =over 4
17357
17358 =item B<new()>
17359
17360 =back
17361
17362 =over 4
17363
17364 =item B<initialize()>
17365
17366 =back
17367
17368 =over 4
17369
17370 =item B<begin_pod()>
17371
17372 =back
17373
17374 =over 4
17375
17376 =item B<begin_input()>
17377
17378 =back
17379
17380 =over 4
17381
17382 =item B<end_input()>
17383
17384 =back
17385
17386 =over 4
17387
17388 =item B<end_pod()>
17389
17390 =back
17391
17392 =over 4
17393
17394 =item B<preprocess_line()>
17395
17396 =back
17397
17398 =over 4
17399
17400 =item B<preprocess_paragraph()>
17401
17402 =back
17403
17404 =over 4
17405
17406 =item METHODS FOR PARSING AND PROCESSING
17407
17408 =back
17409
17410 =over 4
17411
17412 =item B<parse_text()>
17413
17414 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17415 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17416 I<code-ref>|I<method-name>
17417
17418 =back
17419
17420 =over 4
17421
17422 =item B<interpolate()>
17423
17424 =back
17425
17426 =over 4
17427
17428 =item B<parse_paragraph()>
17429
17430 =back
17431
17432 =over 4
17433
17434 =item B<parse_from_filehandle()>
17435
17436 =back
17437
17438 =over 4
17439
17440 =item B<parse_from_file()>
17441
17442 =back
17443
17444 =over 4
17445
17446 =item ACCESSOR METHODS
17447
17448 =back
17449
17450 =over 4
17451
17452 =item B<errorsub()>
17453
17454 =back
17455
17456 =over 4
17457
17458 =item B<cutting()>
17459
17460 =back
17461
17462 =over 4
17463
17464 =item B<parseopts()>
17465
17466 =back
17467
17468 =over 4
17469
17470 =item B<output_file()>
17471
17472 =back
17473
17474 =over 4
17475
17476 =item B<output_handle()>
17477
17478 =back
17479
17480 =over 4
17481
17482 =item B<input_file()>
17483
17484 =back
17485
17486 =over 4
17487
17488 =item B<input_handle()>
17489
17490 =back
17491
17492 =over 4
17493
17494 =item B<input_streams()>
17495
17496 =back
17497
17498 =over 4
17499
17500 =item B<top_stream()>
17501
17502 =back
17503
17504 =over 4
17505
17506 =item PRIVATE METHODS AND DATA
17507
17508 =back
17509
17510 =over 4
17511
17512 =item B<_push_input_stream()>
17513
17514 =back
17515
17516 =over 4
17517
17518 =item B<_pop_input_stream()>
17519
17520 =back
17521
17522 =over 4
17523
17524 =item TREE-BASED PARSING
17525
17526 =item SEE ALSO
17527
17528 =item AUTHOR
17529
17530 =back
17531
17532 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17533
17534 =over 4
17535
17536 =item SYNOPSIS
17537
17538 =item DESCRIPTION
17539
17540 =over 4
17541
17542 =item EXPORT
17543
17544 =back
17545
17546 =item AUTHOR
17547
17548 =item SEE ALSO
17549
17550 =back
17551
17552 =head2 Pod::Select, podselect() - extract selected sections of POD from
17553 input
17554
17555 =over 4
17556
17557 =item SYNOPSIS
17558
17559 =item REQUIRES
17560
17561 =item EXPORTS
17562
17563 =item DESCRIPTION
17564
17565 =item SECTION SPECIFICATIONS
17566
17567 =item RANGE SPECIFICATIONS
17568
17569 =back
17570
17571 =over 4
17572
17573 =item OBJECT METHODS
17574
17575 =back
17576
17577 =over 4
17578
17579 =item B<curr_headings()>
17580
17581 =back
17582
17583 =over 4
17584
17585 =item B<select()>
17586
17587 =back
17588
17589 =over 4
17590
17591 =item B<add_selection()>
17592
17593 =back
17594
17595 =over 4
17596
17597 =item B<clear_selections()>
17598
17599 =back
17600
17601 =over 4
17602
17603 =item B<match_section()>
17604
17605 =back
17606
17607 =over 4
17608
17609 =item B<is_selected()>
17610
17611 =back
17612
17613 =over 4
17614
17615 =item EXPORTED FUNCTIONS
17616
17617 =back
17618
17619 =over 4
17620
17621 =item B<podselect()>
17622
17623 B<-output>, B<-sections>, B<-ranges>
17624
17625 =back
17626
17627 =over 4
17628
17629 =item PRIVATE METHODS AND DATA
17630
17631 =back
17632
17633 =over 4
17634
17635 =item B<_compile_section_spec()>
17636
17637 =back
17638
17639 =over 4
17640
17641 =item $self->{_SECTION_HEADINGS}
17642
17643 =back
17644
17645 =over 4
17646
17647 =item $self->{_SELECTED_SECTIONS}
17648
17649 =back
17650
17651 =over 4
17652
17653 =item SEE ALSO
17654
17655 =item AUTHOR
17656
17657 =back
17658
17659 =head2 Pod::Text - Convert POD data to formatted ASCII text
17660
17661 =over 4
17662
17663 =item SYNOPSIS
17664
17665 =item DESCRIPTION
17666
17667 alt, code, indent, loose, quotes, sentence, width
17668
17669 =item DIAGNOSTICS
17670
17671 Bizarre space in item, Item called without tag, Can't open %s for reading:
17672 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17673 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17674 Unmatched =back
17675
17676 =item RESTRICTIONS
17677
17678 =item NOTES
17679
17680 =item SEE ALSO
17681
17682 =item AUTHOR
17683
17684 =item COPYRIGHT AND LICENSE
17685
17686 =back
17687
17688 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17689
17690 =over 4
17691
17692 =item SYNOPSIS
17693
17694 =item DESCRIPTION
17695
17696 =item BUGS
17697
17698 =item SEE ALSO
17699
17700 =item AUTHOR
17701
17702 =item COPYRIGHT AND LICENSE
17703
17704 =back
17705
17706 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17707 text
17708
17709 =over 4
17710
17711 =item SYNOPSIS
17712
17713 =item DESCRIPTION
17714
17715 =item BUGS
17716
17717 =item SEE ALSO
17718
17719 =item AUTHOR
17720
17721 =item COPYRIGHT AND LICENSE
17722
17723 =back
17724
17725 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17726 text with format escapes
17727
17728 =over 4
17729
17730 =item SYNOPSIS
17731
17732 =item DESCRIPTION
17733
17734 =item NOTES
17735
17736 =item SEE ALSO
17737
17738 =item AUTHOR
17739
17740 =item COPYRIGHT AND LICENSE
17741
17742 =back
17743
17744 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17745 documentation
17746
17747 =over 4
17748
17749 =item SYNOPSIS
17750
17751 =item ARGUMENTS
17752
17753 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17754 C<-pathlist>
17755
17756 =item DESCRIPTION
17757
17758 =item EXAMPLES
17759
17760 =over 4
17761
17762 =item Recommended Use
17763
17764 =back
17765
17766 =item CAVEATS
17767
17768 =item AUTHOR
17769
17770 =item ACKNOWLEDGEMENTS
17771
17772 =back
17773
17774 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17775 translators.
17776
17777 =over 4
17778
17779 =item HEADINGS
17780
17781 =item This C<is> a "level 1" heading
17782
17783 =over 4
17784
17785 =item ``Level'' "2 I<heading>
17786
17787 =back
17788
17789 =item This C<is> a "level 1" heading
17790
17791 =over 4
17792
17793 =item ``Level'' 2 I<heading>
17794
17795 =back
17796
17797 =item LINKS
17798
17799 =item OVER AND ITEMS
17800
17801 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17802 text
17803
17804 =item FORMATTING CODES
17805
17806 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17807
17808 =item VERBATIM
17809
17810 =item CONCLUSION
17811
17812 =back
17813
17814 =head2 Pod::t::htmlescp, Escape Sequences Test
17815
17816 =over 4
17817
17818 =item DESCRIPTION
17819
17820 =back
17821
17822 =head2 Pod::t::htmlview, Test HTML Rendering
17823
17824 =over 4
17825
17826 =item SYNOPSIS
17827
17828 =item DESCRIPTION
17829
17830 =item METHODS =E<gt> OTHER STUFF
17831
17832 =over 4
17833
17834 =item new()
17835
17836 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17837 Sat, 3 Mat
17838
17839 =item old()
17840
17841 =back
17842
17843 =item TESTING FOR AND BEGIN
17844
17845 =item TESTING URLs hyperlinking
17846
17847 =item SEE ALSO
17848
17849 =back
17850
17851 =head2 SDBM_File - Tied access to sdbm files
17852
17853 =over 4
17854
17855 =item SYNOPSIS
17856
17857 =item DESCRIPTION
17858
17859 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17860
17861 =item DIAGNOSTICS
17862
17863 =over 4
17864
17865 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17866
17867 =back
17868
17869 =item BUGS AND WARNINGS
17870
17871 =back
17872
17873 =head2 Safe - Compile and execute code in restricted compartments
17874
17875 =over 4
17876
17877 =item SYNOPSIS
17878
17879 =item DESCRIPTION
17880
17881 a new namespace, an operator mask
17882
17883 =item WARNING
17884
17885 =over 4
17886
17887 =item RECENT CHANGES
17888
17889 =item Methods in class Safe
17890
17891 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17892 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17893 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17894 root (NAMESPACE), mask (MASK)
17895
17896 =item Some Safety Issues
17897
17898 Memory, CPU, Snooping, Signals, State Changes
17899
17900 =item AUTHOR
17901
17902 =back
17903
17904 =back
17905
17906 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17907
17908 =over 4
17909
17910 =item SYNOPSIS
17911
17912 =item DESCRIPTION
17913
17914 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17915 EXPR, tainted EXPR, weaken REF
17916
17917 =item KNOWN BUGS
17918
17919 =item COPYRIGHT
17920
17921 =item BLATANT PLUG
17922
17923 =back
17924
17925 =head2 Search::Dict, look - search for key in dictionary file
17926
17927 =over 4
17928
17929 =item SYNOPSIS
17930
17931 =item DESCRIPTION
17932
17933 =back
17934
17935 =head2 SelectSaver - save and restore selected file handle
17936
17937 =over 4
17938
17939 =item SYNOPSIS
17940
17941 =item DESCRIPTION
17942
17943 =back
17944
17945 =head2 SelfLoader - load functions only on demand
17946
17947 =over 4
17948
17949 =item SYNOPSIS
17950
17951 =item DESCRIPTION
17952
17953 =over 4
17954
17955 =item The __DATA__ token
17956
17957 =item SelfLoader autoloading
17958
17959 =item Autoloading and package lexicals
17960
17961 =item SelfLoader and AutoLoader
17962
17963 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17964
17965 =item Classes and inherited methods.
17966
17967 =back
17968
17969 =item Multiple packages and fully qualified subroutine names
17970
17971 =back
17972
17973 =head2 Shell - run shell commands transparently within perl
17974
17975 =over 4
17976
17977 =item SYNOPSIS
17978
17979 =item DESCRIPTION
17980
17981 =over 4
17982
17983 =item OBJECT ORIENTED SYNTAX
17984
17985 =back
17986
17987 =item AUTHOR
17988
17989 =back
17990
17991 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17992 socket.h defines and structure manipulators 
17993
17994 =over 4
17995
17996 =item SYNOPSIS
17997
17998 =item DESCRIPTION
17999
18000 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
18001 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
18002 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
18003 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
18004 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
18005
18006 =back
18007
18008 =head2 Storable - persistence for Perl data structures
18009
18010 =over 4
18011
18012 =item SYNOPSIS
18013
18014 =item DESCRIPTION
18015
18016 =item MEMORY STORE
18017
18018 =item ADVISORY LOCKING
18019
18020 =item SPEED
18021
18022 =item CANONICAL REPRESENTATION
18023
18024 =item FORWARD COMPATIBILITY
18025
18026 utf8 data, restricted hashes, files from future versions of Storable
18027
18028 =item ERROR REPORTING
18029
18030 =item WIZARDS ONLY
18031
18032 =over 4
18033
18034 =item Hooks
18035
18036 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18037 I<serialized>, ..
18038
18039 =item Predicates
18040
18041 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18042 C<Storable::is_retrieving>
18043
18044 =item Recursion
18045
18046 =item Deep Cloning
18047
18048 =back
18049
18050 =item Storable magic
18051
18052 =item EXAMPLES
18053
18054 =item WARNING
18055
18056 =item BUGS
18057
18058 =over 4
18059
18060 =item 64 bit data in perl 5.6.0 and 5.6.1
18061
18062 =back
18063
18064 =item CREDITS
18065
18066 =item AUTHOR
18067
18068 =item SEE ALSO
18069
18070 =back
18071
18072 =head2 Switch - A switch statement for Perl
18073
18074 =over 4
18075
18076 =item VERSION
18077
18078 =item SYNOPSIS
18079
18080 =item BACKGROUND
18081
18082 =item DESCRIPTION
18083
18084 =over 4
18085
18086 =item Allowing fall-through
18087
18088 =item Automating fall-through
18089
18090 =item Alternative syntax
18091
18092 =item Higher-order Operations
18093
18094 =back
18095
18096 =item DEPENDENCIES
18097
18098 =item AUTHOR
18099
18100 =item BUGS
18101
18102 =item LIMITATION
18103
18104 =item COPYRIGHT
18105
18106 =back
18107
18108 =head2 Symbol - manipulate Perl symbols and their names
18109
18110 =over 4
18111
18112 =item SYNOPSIS
18113
18114 =item DESCRIPTION
18115
18116 =back
18117
18118 =head2 Sys::Hostname - Try every conceivable way to get hostname
18119
18120 =over 4
18121
18122 =item SYNOPSIS
18123
18124 =item DESCRIPTION
18125
18126 =item AUTHOR
18127
18128 =back
18129
18130 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18131 interface to the UNIX syslog(3) calls
18132
18133 =over 4
18134
18135 =item SYNOPSIS
18136
18137 =item DESCRIPTION
18138
18139 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18140 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18141 in 5.004_02), closelog
18142
18143 =item EXAMPLES
18144
18145 =item SEE ALSO
18146
18147 =item AUTHOR
18148
18149 =back
18150
18151 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18152 Perl interface to the UNIX syslog(3) calls
18153
18154 =over 4
18155
18156 =item SYNOPSIS
18157
18158 =item DESCRIPTION
18159
18160 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18161 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18162 in 5.004_02), closelog
18163
18164 =item EXAMPLES
18165
18166 =item SEE ALSO
18167
18168 =item AUTHOR
18169
18170 =back
18171
18172 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18173
18174 =over 4
18175
18176 =item SYNOPSIS
18177
18178 =item DESCRIPTION
18179
18180 =item DIAGNOSTICS
18181
18182 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18183 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18184 comma allowed after filehandle, No name for escape sequence %s
18185
18186 =item ENVIRONMENT
18187
18188 ANSI_COLORS_DISABLED
18189
18190 =item RESTRICTIONS
18191
18192 =item NOTES
18193
18194 =item SEE ALSO
18195
18196 =item AUTHORS
18197
18198 =item LICENSE
18199
18200 =back
18201
18202 =head2 Term::Cap - Perl termcap interface
18203
18204 =over 4
18205
18206 =item SYNOPSIS
18207
18208 =item DESCRIPTION
18209
18210 =over 4
18211
18212 =item METHODS
18213
18214 =back
18215
18216 =back
18217
18218 B<Tgetent>, OSPEED, TERM
18219
18220 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18221
18222 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18223
18224 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18225
18226 B<Trequire>
18227
18228 =over 4
18229
18230 =item EXAMPLES
18231
18232 =item COPYRIGHT AND LICENSE
18233
18234 =item AUTHOR
18235
18236 =item SEE ALSO
18237
18238 =back
18239
18240 =head2 Term::Complete - Perl word completion module
18241
18242 =over 4
18243
18244 =item SYNOPSIS
18245
18246 =item DESCRIPTION
18247
18248 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18249
18250 =item DIAGNOSTICS
18251
18252 =item BUGS
18253
18254 =item AUTHOR
18255
18256 =back
18257
18258 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18259 no real package is found, substitutes stubs instead of basic functions.
18260
18261 =over 4
18262
18263 =item SYNOPSIS
18264
18265 =item DESCRIPTION
18266
18267 =item Minimal set of supported functions
18268
18269 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18270 C<MinLine>, C<findConsole>, Attribs, C<Features>
18271
18272 =item Additional supported functions
18273
18274 C<tkRunning>, C<ornaments>, C<newTTY>
18275
18276 =item EXPORTS
18277
18278 =item ENVIRONMENT
18279
18280 =item CAVEATS
18281
18282 =back
18283
18284 =head2 Test - provides a simple framework for writing test scripts
18285
18286 =over 4
18287
18288 =item SYNOPSIS
18289
18290 =item DESCRIPTION
18291
18292 =over 4
18293
18294 =item Functions
18295
18296 B<plan>
18297
18298 =back
18299
18300 =back
18301
18302 B<_to_value>
18303
18304 B<ok>
18305
18306 =over 4
18307
18308 =item TEST TYPES
18309
18310 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18311
18312 =item ONFAIL
18313
18314 =item BUGS and CAVEATS
18315
18316 =item NOTE
18317
18318 =item SEE ALSO
18319
18320 =item AUTHOR
18321
18322 =back
18323
18324 =head2 Test::Builder - Backend for building test libraries
18325
18326 =over 4
18327
18328 =item SYNOPSIS
18329
18330 =item DESCRIPTION
18331
18332 =over 4
18333
18334 =item Construction
18335
18336 B<new>
18337
18338 =back
18339
18340 =back
18341
18342 =over 4
18343
18344 =item Setting up tests
18345
18346 B<exported_to>
18347
18348 =back
18349
18350 B<plan>
18351
18352 B<expected_tests>
18353
18354 B<no_plan>
18355
18356 B<skip_all>
18357
18358 =over 4
18359
18360 =item Running tests
18361
18362 B<ok>
18363
18364 =back
18365
18366 B<is_eq>, B<is_num>
18367
18368 B<isnt_eq>, B<isnt_num>
18369
18370 B<like>, B<unlike>
18371
18372 B<maybe_regex>
18373
18374 B<cmp_ok>
18375
18376 B<BAILOUT>
18377
18378 B<skip>
18379
18380 B<todo_skip>
18381
18382 B<skip_rest>
18383
18384 =over 4
18385
18386 =item Test style
18387
18388 B<level>
18389
18390 =back
18391
18392 B<use_numbers>
18393
18394 B<no_header>, B<no_ending>
18395
18396 =over 4
18397
18398 =item Output
18399
18400 B<diag>
18401
18402 =back
18403
18404 B<_print>
18405
18406 B<output>, B<failure_output>, B<todo_output>
18407
18408 =over 4
18409
18410 =item Test Status and Info
18411
18412 B<current_test>
18413
18414 =back
18415
18416 B<summary>
18417
18418 B<details>  I<UNIMPLEMENTED>, B<todo>
18419
18420 B<caller>
18421
18422 B<_sanity_check>
18423
18424 B<_whoa>
18425
18426 B<_my_exit>
18427
18428 =over 4
18429
18430 =item THREADS
18431
18432 =item EXAMPLES
18433
18434 =item SEE ALSO
18435
18436 =item AUTHORS
18437
18438 =item COPYRIGHT
18439
18440 =back
18441
18442 =head2 Test::Harness - run perl standard test scripts with statistics
18443
18444 =over 4
18445
18446 =item SYNOPSIS
18447
18448 =item DESCRIPTION
18449
18450 =over 4
18451
18452 =item The test script output
18453
18454 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18455 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18456 else>
18457
18458 =item Taint mode
18459
18460 =item Configuration variables.
18461
18462 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18463
18464 =item Failure
18465
18466 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18467 Failed>
18468
18469 =item Functions
18470
18471 B<runtests>
18472
18473 =back
18474
18475 =back
18476
18477 B<_all_ok>
18478
18479 B<_globdir>
18480
18481 B<_run_all_tests>
18482
18483 B<_mk_leader>
18484
18485 B<_leader_width>
18486
18487 =over 4
18488
18489 =item EXPORT
18490
18491 =item DIAGNOSTICS
18492
18493 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18494 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18495 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18496 %s>, C<FAILED--Further testing stopped: %s>
18497
18498 =item ENVIRONMENT
18499
18500 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18501 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18502 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18503
18504 =item EXAMPLE
18505
18506 =item SEE ALSO
18507
18508 =item AUTHORS
18509
18510 =item TODO
18511
18512 =item BUGS
18513
18514 =back
18515
18516 =head2 Test::Harness::Assert - simple assert
18517
18518 =over 4
18519
18520 =item SYNOPSIS
18521
18522 =item DESCRIPTION
18523
18524 =over 4
18525
18526 =item Functions
18527
18528 B<assert>
18529
18530 =back
18531
18532 =back
18533
18534 =over 4
18535
18536 =item AUTHOR
18537
18538 =item SEE ALSO
18539
18540 =back
18541
18542 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18543
18544 =over 4
18545
18546 =item SYNOPSIS
18547
18548 =item DESCRIPTION
18549
18550 =back
18551
18552 =head2 Test::Harness::Straps - detailed analysis of test results
18553
18554 =over 4
18555
18556 =item SYNOPSIS
18557
18558 =item DESCRIPTION
18559
18560 =over 4
18561
18562 =item Construction
18563
18564 B<new>
18565
18566 =back
18567
18568 =back
18569
18570 B<_init>
18571
18572 =over 4
18573
18574 =item Analysis
18575
18576 B<analyze>
18577
18578 =back
18579
18580 B<analyze_fh>
18581
18582 B<analyze_file>
18583
18584 B<_switches>
18585
18586 B<_INC2PERL5LIB>
18587
18588 B<_filtered_INC>
18589
18590 B<_restore_PERL5LIB>
18591
18592 =over 4
18593
18594 =item Parsing
18595
18596 B<_is_comment>
18597
18598 =back
18599
18600 B<_is_header>
18601
18602 B<_is_test>
18603
18604 B<_is_bail_out>
18605
18606 B<_reset_file_state>
18607
18608 =over 4
18609
18610 =item Results
18611
18612 B<_detailize>
18613
18614 =back
18615
18616 =over 4
18617
18618 =item EXAMPLES
18619
18620 =item AUTHOR
18621
18622 =item SEE ALSO
18623
18624 =back
18625
18626 =head2 Test::More - yet another framework for writing test scripts
18627
18628 =over 4
18629
18630 =item SYNOPSIS
18631
18632 =item DESCRIPTION
18633
18634 =over 4
18635
18636 =item I love it when a plan comes together
18637
18638 =back
18639
18640 =back
18641
18642 =over 4
18643
18644 =item Test names
18645
18646 =item I'm ok, you're not ok.
18647
18648 B<ok>
18649
18650 =back
18651
18652 B<is>, B<isnt>
18653
18654 B<like>
18655
18656 B<unlike>
18657
18658 B<cmp_ok>
18659
18660 B<can_ok>
18661
18662 B<isa_ok>
18663
18664 B<pass>, B<fail>
18665
18666 =over 4
18667
18668 =item Diagnostics
18669
18670 B<diag>
18671
18672 =back
18673
18674 =over 4
18675
18676 =item Module tests
18677
18678 B<use_ok>
18679
18680 =back
18681
18682 B<require_ok>
18683
18684 =over 4
18685
18686 =item Conditional tests
18687
18688 B<SKIP: BLOCK>
18689
18690 =back
18691
18692 B<TODO: BLOCK>, B<todo_skip>
18693
18694 When do I use SKIP vs. TODO?
18695
18696 =over 4
18697
18698 =item Comparison functions
18699
18700 B<is_deeply>
18701
18702 =back
18703
18704 B<eq_array>
18705
18706 B<eq_hash>
18707
18708 B<eq_set>
18709
18710 =over 4
18711
18712 =item Extending and Embedding Test::More
18713
18714 B<builder>
18715
18716 =back
18717
18718 =over 4
18719
18720 =item NOTES
18721
18722 =item BUGS and CAVEATS
18723
18724 Making your own ok(), The eq_* family has some caveats, Test::Harness
18725 upgrades
18726
18727 =item HISTORY
18728
18729 =item SEE ALSO
18730
18731 =item AUTHORS
18732
18733 =item COPYRIGHT
18734
18735 =back
18736
18737 =head2 Test::Simple - Basic utilities for writing tests.
18738
18739 =over 4
18740
18741 =item SYNOPSIS
18742
18743 =item DESCRIPTION
18744
18745 B<ok>
18746
18747 =back
18748
18749 =over 4
18750
18751 =item EXAMPLE
18752
18753 =item CAVEATS
18754
18755 =item NOTES
18756
18757 =item HISTORY
18758
18759 =item SEE ALSO
18760
18761 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18762 L<Test::Harness>
18763
18764 =item AUTHORS
18765
18766 =item COPYRIGHT
18767
18768 =back
18769
18770 =head2 Test::Tutorial - A tutorial about writing really basic tests
18771
18772 =over 4
18773
18774 =item DESCRIPTION
18775
18776 =over 4
18777
18778 =item Nuts and bolts of testing.
18779
18780 =item Where to start?
18781
18782 =item Names
18783
18784 =item Test the manual
18785
18786 =item Sometimes the tests are wrong
18787
18788 =item Testing lots of values
18789
18790 =item Informative names
18791
18792 =item Skipping tests
18793
18794 =item Todo tests
18795
18796 =item Testing with taint mode.
18797
18798 =back
18799
18800 =item FOOTNOTES
18801
18802 =item AUTHORS
18803
18804 =item COPYRIGHT
18805
18806 =back
18807
18808 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18809
18810 =over 4
18811
18812 =item SYNOPSIS
18813
18814 =item DESCRIPTION
18815
18816 =item EXAMPLE
18817
18818 =back
18819
18820 =head2 Text::Balanced - Extract delimited text sequences from strings.
18821
18822 =over 4
18823
18824 =item SYNOPSIS
18825
18826 =item DESCRIPTION
18827
18828 =over 4
18829
18830 =item General behaviour in list contexts
18831
18832 [0], [1], [2]
18833
18834 =item General behaviour in scalar and void contexts
18835
18836 =item A note about prefixes
18837
18838 =item C<extract_delimited>
18839
18840 =item C<extract_bracketed>
18841
18842 =item C<extract_tagged>
18843
18844 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18845 [0], [1], [2], [3], [4], [5]
18846
18847 =item C<gen_extract_tagged>
18848
18849 =item C<extract_quotelike>
18850
18851 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18852
18853 =item C<extract_quotelike> and "here documents"
18854
18855 [0], [1], [2], [3], [4], [5], [6], [7..10]
18856
18857 =item C<extract_codeblock>
18858
18859 =item C<extract_multiple>
18860
18861 =item C<gen_delimited_pat>
18862
18863 =back
18864
18865 =item DIAGNOSTICS
18866
18867  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
18868 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18869 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
18870 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18871 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18872 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18873 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18874 after dereferencer>, C<Did not find expected opening bracket at %s>,
18875 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18876 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18877 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18878 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18879 tag>
18880
18881 =item AUTHOR
18882
18883 =item BUGS AND IRRITATIONS
18884
18885 =item COPYRIGHT
18886
18887 =back
18888
18889 =head2 Text::ParseWords - parse text into an array of tokens or array of
18890 arrays
18891
18892 =over 4
18893
18894 =item SYNOPSIS
18895
18896 =item DESCRIPTION
18897
18898 =item EXAMPLES
18899
18900 =item AUTHORS
18901
18902 =back
18903
18904 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18905 by Knuth
18906
18907 =over 4
18908
18909 =item SYNOPSIS
18910
18911 =item DESCRIPTION
18912
18913 =item EXAMPLES
18914
18915 =item LIMITATIONS
18916
18917 =item AUTHOR
18918
18919 =back
18920
18921 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18922 unexpand(1)
18923
18924 =over 4
18925
18926 =item SYNOPSIS
18927
18928 =item DESCRIPTION
18929
18930 =item BUGS
18931
18932 =item AUTHOR
18933
18934 =back
18935
18936 =head2 Text::Wrap - line wrapping to form simple paragraphs
18937
18938 =over 4
18939
18940 =item SYNOPSIS 
18941
18942 =item DESCRIPTION
18943
18944 =item OVERRIDES
18945
18946 =item EXAMPLE
18947
18948 =item AUTHOR
18949
18950 =back
18951
18952 =head2 Thread - manipulate threads in Perl (for old code only)
18953
18954 =over 4
18955
18956 =item CAVEAT
18957
18958 =item SYNOPSIS
18959
18960 =item DESCRIPTION
18961
18962 =item FUNCTIONS
18963
18964 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18965 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18966 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18967
18968 =item METHODS
18969
18970 join, eval, detach, equal, tid, flags, done
18971
18972 =item LIMITATIONS
18973
18974 =item SEE ALSO
18975
18976 =back
18977
18978 =head2 Thread::Queue - thread-safe queues (for old code only)
18979
18980 =over 4
18981
18982 =item CAVEAT
18983
18984 =item SYNOPSIS
18985
18986 =item DESCRIPTION
18987
18988 =item FUNCTIONS AND METHODS
18989
18990 new, enqueue LIST, dequeue, dequeue_nb, pending
18991
18992 =item SEE ALSO
18993
18994 =back
18995
18996 =head2 Thread::Semaphore - thread-safe semaphores (for old code only)
18997
18998 =over 4
18999
19000 =item CAVEAT
19001
19002 =item SYNOPSIS
19003
19004 =item DESCRIPTION
19005
19006 =item FUNCTIONS AND METHODS
19007
19008 new, new NUMBER, down, down NUMBER, up, up NUMBER
19009
19010 =back
19011
19012 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
19013 (for old code)
19014
19015 =over 4
19016
19017 =item CAVEAT
19018
19019 =item SYNOPSIS
19020
19021 =item DESCRIPTION
19022
19023 =item BUGS
19024
19025 =back
19026
19027 =head2 Thread::Specific - thread-specific keys
19028
19029 =over 4
19030
19031 =item SYNOPSIS
19032
19033 =item DESCRIPTION
19034
19035 =back
19036
19037 =head2 Tie::Array - base class for tied arrays
19038
19039 =over 4
19040
19041 =item SYNOPSIS
19042
19043 =item DESCRIPTION
19044
19045 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19046 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19047 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19048 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19049
19050 =item CAVEATS
19051
19052 =item AUTHOR
19053
19054 =back
19055
19056 =head2 Tie::File - Access the lines of a disk file via a Perl array
19057
19058 =over 4
19059
19060 =item SYNOPSIS
19061
19062 =item DESCRIPTION
19063
19064 =over 4
19065
19066 =item C<recsep>
19067
19068 =item C<autochomp>
19069
19070 =item C<mode>
19071
19072 =item C<memory>
19073
19074 =item C<dw_size>
19075
19076 =item Option Format
19077
19078 =back
19079
19080 =item Public Methods
19081
19082 =over 4
19083
19084 =item C<flock>
19085
19086 =item C<autochomp>
19087
19088 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19089
19090 =back
19091
19092 =item Tying to an already-opened filehandle
19093
19094 =item Deferred Writing
19095
19096 =over 4
19097
19098 =item Autodeferring
19099
19100 =back
19101
19102 =item CAVEATS
19103
19104 =item SUBCLASSING
19105
19106 =item WHAT ABOUT C<DB_File>?
19107
19108 =item AUTHOR
19109
19110 =item LICENSE
19111
19112 =item WARRANTY
19113
19114 =item THANKS
19115
19116 =item TODO
19117
19118 =back
19119
19120 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19121 handles
19122
19123 =over 4
19124
19125 =item SYNOPSIS
19126
19127 =item DESCRIPTION
19128
19129 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19130 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19131 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19132 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19133
19134 =item MORE INFORMATION
19135
19136 =item COMPATIBILITY
19137
19138 =back
19139
19140 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19141 tied hashes
19142
19143 =over 4
19144
19145 =item SYNOPSIS
19146
19147 =item DESCRIPTION
19148
19149 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19150 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19151
19152 =item Inheriting from B<Tie::StdHash>
19153
19154 =item Inheriting from B<Tie::ExtraHash>
19155
19156 =item C<UNTIE> and C<DESTROY>
19157
19158 =item MORE INFORMATION
19159
19160 =back
19161
19162 =head2 Tie::Memoize - add data to hash when needed
19163
19164 =over 4
19165
19166 =item SYNOPSIS
19167
19168 =item DESCRIPTION
19169
19170 =item Inheriting from B<Tie::Memoize>
19171
19172 =item EXAMPLE
19173
19174 =item BUGS
19175
19176 =item AUTHOR
19177
19178 =back
19179
19180 =head2 Tie::RefHash - use references as hash keys
19181
19182 =over 4
19183
19184 =item SYNOPSIS
19185
19186 =item DESCRIPTION
19187
19188 =item EXAMPLE
19189
19190 =item AUTHOR
19191
19192 =item VERSION
19193
19194 =item SEE ALSO
19195
19196 =back
19197
19198 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19199 scalars
19200
19201 =over 4
19202
19203 =item SYNOPSIS
19204
19205 =item DESCRIPTION
19206
19207 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19208
19209 =item MORE INFORMATION
19210
19211 =back
19212
19213 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19214
19215 =over 4
19216
19217 =item SYNOPSIS
19218
19219 =item DESCRIPTION
19220
19221 =item CAVEATS
19222
19223 =back
19224
19225 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19226 timers
19227
19228 =over 4
19229
19230 =item SYNOPSIS
19231
19232 =item DESCRIPTION
19233
19234 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19235 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19236 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19237 getitimer ( $which )
19238
19239 =item EXAMPLES
19240
19241 =item C API
19242
19243 =item CAVEATS
19244
19245 =item AUTHORS
19246
19247 =item REVISION
19248
19249 =item COPYRIGHT
19250
19251 =back
19252
19253 =head2 Time::Local - efficiently compute time from local and GMT time
19254
19255 =over 4
19256
19257 =item SYNOPSIS
19258
19259 =item DESCRIPTION
19260
19261 =item IMPLEMENTATION
19262
19263 =item BUGS
19264
19265 =back
19266
19267 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19268 function
19269
19270 =over 4
19271
19272 =item SYNOPSIS
19273
19274 =item DESCRIPTION
19275
19276 =item NOTE
19277
19278 =item AUTHOR
19279
19280 =back
19281
19282 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19283 function
19284
19285 =over 4
19286
19287 =item SYNOPSIS
19288
19289 =item DESCRIPTION
19290
19291 =item NOTE
19292
19293 =item AUTHOR
19294
19295 =back
19296
19297 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19298
19299 =over 4
19300
19301 =item SYNOPSIS
19302
19303 =item DESCRIPTION
19304
19305 =item AUTHOR
19306
19307 =back
19308
19309 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19310
19311 =over 4
19312
19313 =item SYNOPSIS
19314
19315 =item DESCRIPTION
19316
19317 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19318 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19319
19320 =back
19321
19322 =head2 Unicode::Collate - Unicode Collation Algorithm
19323
19324 =over 4
19325
19326 =item SYNOPSIS
19327
19328 =item DESCRIPTION
19329
19330 =over 4
19331
19332 =item Constructor and Tailoring
19333
19334 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19335 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19336 undefChar, katakana_before_hiragana, upper_before_lower
19337
19338 =item Methods for Collation
19339
19340 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19341 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19342 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19343 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19344 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19345 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19346 $Collator-E<gt>viewSortKey($string)>, C<$position =
19347 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19348 $Collator-E<gt>index($string, $substring)>
19349
19350 =item Other Methods
19351
19352 UCA_Version, Base_Unicode_Version
19353
19354 =item EXPORT
19355
19356 =item TODO
19357
19358 =item CAVEAT
19359
19360 =item BUGS
19361
19362 =back
19363
19364 =item AUTHOR
19365
19366 =item SEE ALSO
19367
19368 http://www.unicode.org/unicode/reports/tr10/,
19369 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19370 http://www.unicode.org/unicode/reports/tr15/,
19371 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19372
19373 =back
19374
19375 =head2 Unicode::Normalize - Unicode Normalization Forms
19376
19377 =over 4
19378
19379 =item SYNOPSIS
19380
19381 =item DESCRIPTION
19382
19383 =over 4
19384
19385 =item Normalization Forms
19386
19387 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19388 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19389 C<$normalized_string = normalize($form_name, $string)>
19390
19391 =item Decomposition and Composition
19392
19393 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19394 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19395 reorder($string)>, C<$composed_string   = compose($string)>
19396
19397 =item Quick Check
19398
19399 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19400 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19401 check($form_name, $string)>
19402
19403 =item Character Data
19404
19405 C<$canonical_decomposed = getCanon($codepoint)>,
19406 C<$compatibility_decomposed = getCompat($codepoint)>,
19407 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19408 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19409 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19410 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19411 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19412
19413 =item EXPORT
19414
19415 =back
19416
19417 =item AUTHOR
19418
19419 =item SEE ALSO
19420
19421 http://www.unicode.org/unicode/reports/tr15/,
19422 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19423
19424 =back
19425
19426 =head2 Unicode::UCD - Unicode character database
19427
19428 =over 4
19429
19430 =item SYNOPSIS
19431
19432 =item DESCRIPTION
19433
19434 =back
19435
19436 =over 4
19437
19438 =item charinfo
19439
19440 =back
19441
19442 =over 4
19443
19444 =item charblock
19445
19446 =back
19447
19448 =over 4
19449
19450 =item charscript
19451
19452 =back
19453
19454 =over 4
19455
19456 =item charblocks
19457
19458 =back
19459
19460 =over 4
19461
19462 =item charscripts
19463
19464 =back
19465
19466 =over 4
19467
19468 =item Blocks versus Scripts
19469
19470 =item Matching Scripts and Blocks
19471
19472 =item Code Point Arguments
19473
19474 =item charinrange
19475
19476 =back
19477
19478 =over 4
19479
19480 =item compexcl
19481
19482 =back
19483
19484 =over 4
19485
19486 =item casefold
19487
19488 =back
19489
19490 =over 4
19491
19492 =item casespec
19493
19494 =back
19495
19496 =over 4
19497
19498 =item Unicode::UCD::UnicodeVersion
19499
19500 =back
19501
19502 =over 4
19503
19504 =item Implementation Note
19505
19506 =back
19507
19508 =over 4
19509
19510 =item BUGS
19511
19512 =item AUTHOR
19513
19514 =back
19515
19516 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19517 functions
19518
19519 =over 4
19520
19521 =item SYNOPSIS
19522
19523 =item DESCRIPTION
19524
19525 =item NOTE
19526
19527 =item AUTHOR
19528
19529 =back
19530
19531 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19532 functions
19533
19534 =over 4
19535
19536 =item SYNOPSIS
19537
19538 =item DESCRIPTION
19539
19540 =over 4
19541
19542 =item System Specifics
19543
19544 =back
19545
19546 =item NOTE
19547
19548 =item AUTHOR
19549
19550 =item HISTORY
19551
19552 March 18th, 2000
19553
19554 =back
19555
19556 =head2 Win32 - Interfaces to some Win32 API Functions
19557
19558 =over 4
19559
19560 =item DESCRIPTION
19561
19562 =over 4
19563
19564 =item Alphabetical Listing of Win32 Functions
19565
19566 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19567 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19568 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19569 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19570 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19571 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19572 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19573 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19574 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19575 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19576 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19577 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19578 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19579 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19580 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19581 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19582 Win32::UnregisterServer(LIBRARYNAME)
19583
19584 =back
19585
19586 =back
19587
19588 =head2 XSLoader - Dynamically load C libraries into Perl code
19589
19590 =over 4
19591
19592 =item SYNOPSIS
19593
19594 =item DESCRIPTION
19595
19596 =item AUTHOR
19597
19598 =back
19599
19600 =head1 AUXILIARY DOCUMENTATION
19601
19602 Here should be listed all the extra programs' documentation, but they
19603 don't all have manual pages yet:
19604
19605 =over 4
19606
19607 =item a2p
19608
19609 =item s2p
19610
19611 =item find2perl
19612
19613 =item h2ph
19614
19615 =item c2ph
19616
19617 =item h2xs
19618
19619 =item xsubpp
19620
19621 =item pod2man
19622
19623 =item wrapsuid
19624
19625 =back
19626
19627 =head1 AUTHOR
19628
19629 Larry Wall <F<larry@wall.org>>, with the help of oodles
19630 of other folks.
19631