Regen Configure; regen perltoc.
[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, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
404 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
405 chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr
406 NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir
407 DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt
408 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR,
409 defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR,
410 dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval
411 BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp,
412 fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
413 FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE,
414 getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority
415 WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname
416 NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname
417 NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE,
418 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
419 gethostent, getnetent, getprotoent, getservent, setpwent, setgrent,
420 sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent
421 STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent,
422 endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR,
423 glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep
424 EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index
425 STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join
426 EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc,
427 lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen
428 SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock THING, log EXPR, log,
429 lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK,
430 mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv
431 ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my TYPE EXPR, my EXPR
432 : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no Module VERSION LIST, no
433 Module VERSION, no Module LIST, no Module, oct EXPR, oct, open
434 FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST,
435 open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR,
436 ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR :
437 ATTRS, pack TEMPLATE,LIST, package NAMESPACE, package, pipe
438 READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
439 LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
440 LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
441 qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
442 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
443 readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
444 recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
445 OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
446 return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
447 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
448 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
449 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
450 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
451 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
452 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
453 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
454 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
455 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
456 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
457 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
458 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
459 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
460 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
461 study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub
462 NAME (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr
463 EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall
464 LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen
465 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET,
466 sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE,
467 system LIST, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET,
468 syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell
469 FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied
470 VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate
471 EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef
472 EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE,
473 unshift ARRAY,LIST, use Module VERSION LIST, use Module VERSION, use Module
474 LIST, use Module, use VERSION, utime LIST, values HASH, vec
475 EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write
476 FILEHANDLE, write EXPR, write, y///
477
478 =back
479
480 =back
481
482 =head2 perlreftut - Mark's very short tutorial about references
483
484 =over 4
485
486 =item DESCRIPTION
487
488 =item Who Needs Complicated Data Structures?
489
490 =item The Solution
491
492 =item Syntax
493
494 =over 4
495
496 =item Making References
497
498 =item Using References
499
500 =back
501
502 =item An Example
503
504 =item Arrow Rule
505
506 =item Solution
507
508 =item The Rest
509
510 =item Summary
511
512 =item Credits
513
514 =over 4
515
516 =item Distribution Conditions
517
518 =back
519
520 =back
521
522 =head2 perldsc - Perl Data Structures Cookbook
523
524 =over 4
525
526 =item DESCRIPTION
527
528 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
529 more elaborate constructs
530
531 =item REFERENCES
532
533 =item COMMON MISTAKES
534
535 =item CAVEAT ON PRECEDENCE
536
537 =item WHY YOU SHOULD ALWAYS C<use strict>
538
539 =item DEBUGGING
540
541 =item CODE EXAMPLES
542
543 =item ARRAYS OF ARRAYS
544
545 =over 4
546
547 =item Declaration of an ARRAY OF ARRAYS
548
549 =item Generation of an ARRAY OF ARRAYS
550
551 =item Access and Printing of an ARRAY OF ARRAYS
552
553 =back
554
555 =item HASHES OF ARRAYS
556
557 =over 4
558
559 =item Declaration of a HASH OF ARRAYS
560
561 =item Generation of a HASH OF ARRAYS
562
563 =item Access and Printing of a HASH OF ARRAYS
564
565 =back
566
567 =item ARRAYS OF HASHES
568
569 =over 4
570
571 =item Declaration of an ARRAY OF HASHES
572
573 =item Generation of an ARRAY OF HASHES
574
575 =item Access and Printing of an ARRAY OF HASHES
576
577 =back
578
579 =item HASHES OF HASHES
580
581 =over 4
582
583 =item Declaration of a HASH OF HASHES
584
585 =item Generation of a HASH OF HASHES
586
587 =item Access and Printing of a HASH OF HASHES
588
589 =back
590
591 =item MORE ELABORATE RECORDS
592
593 =over 4
594
595 =item Declaration of MORE ELABORATE RECORDS
596
597 =item Declaration of a HASH OF COMPLEX RECORDS
598
599 =item Generation of a HASH OF COMPLEX RECORDS
600
601 =back
602
603 =item Database Ties
604
605 =item SEE ALSO
606
607 =item AUTHOR
608
609 =back
610
611 =head2 perlrequick - Perl regular expressions quick start
612
613 =over 4
614
615 =item DESCRIPTION
616
617 =item The Guide
618
619 =over 4
620
621 =item Simple word matching
622
623 =item Using character classes
624
625 =item Matching this or that
626
627 =item Grouping things and hierarchical matching
628
629 =item Extracting matches
630
631 =item Matching repetitions
632
633 =item More matching
634
635 =item Search and replace
636
637 =item The split operator
638
639 =back
640
641 =item BUGS
642
643 =item SEE ALSO
644
645 =item AUTHOR AND COPYRIGHT
646
647 =over 4
648
649 =item Acknowledgments
650
651 =back
652
653 =back
654
655 =head2 perlpod - the Plain Old Documentation format
656
657 =over 4
658
659 =item DESCRIPTION
660
661 =over 4
662
663 =item Ordinary Paragraph
664
665 =item Verbatim Paragraph
666
667 =item Command Paragraph
668
669 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
670 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
671 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
672 I<formatname>>, C<=for I<formatname> I<text...>>
673
674 =item Formatting Codes
675
676 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
677 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
678 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
679 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
680 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
681 (zero-effect) formatting code
682
683 =item The Intent
684
685 =item Embedding Pods in Perl Modules
686
687 =item Hints for Writing Pod
688
689 =back
690
691 =item SEE ALSO
692
693 =item AUTHOR
694
695 =back
696
697 =head2 perlpodspec - Plain Old Documentation: format specification and
698 notes
699
700 =over 4
701
702 =item DESCRIPTION
703
704 =item Pod Definitions
705
706 =item Pod Commands
707
708 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
709 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
710
711 =item Pod Formatting Codes
712
713 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
714 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
715 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
716 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
717 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
718 contains non-breaking spaces
719
720 =item Notes on Implementing Pod Processors
721
722 =item About LE<lt>...E<gt> Codes
723
724 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
725
726 =item About =over...=back Regions
727
728 =item About Data Paragraphs and "=begin/=end" Regions
729
730 =item SEE ALSO
731
732 =item AUTHOR
733
734 =back
735
736 =head2 perlstyle - Perl style guide
737
738 =over 4
739
740 =item DESCRIPTION
741
742 =back
743
744 =head2 perltrap - Perl traps for the unwary
745
746 =over 4
747
748 =item DESCRIPTION
749
750 =over 4
751
752 =item Awk Traps
753
754 =item C Traps
755
756 =item Sed Traps
757
758 =item Shell Traps
759
760 =item Perl Traps
761
762 =item Perl4 to Perl5 Traps
763
764 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
765 Traps, General data type traps, Context Traps - scalar, list contexts,
766 Precedence Traps, General Regular Expression Traps using s///, etc,
767 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
768
769 =item Discontinuance, Deprecation, and BugFix traps
770
771 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
772 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
773 Discontinuance, Deprecation, Discontinuance, Discontinuance
774
775 =item Parsing Traps
776
777 Parsing, Parsing, Parsing, Parsing, Parsing
778
779 =item Numerical Traps
780
781 Numerical, Numerical, Numerical, Bitwise string ops
782
783 =item General data type traps
784
785 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
786 (Constants), (Scalars), (Variable Suicide)
787
788 =item Context Traps - scalar, list contexts
789
790 (list context), (scalar context), (scalar context), (list, builtin)
791
792 =item Precedence Traps
793
794 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
795 Precedence
796
797 =item General Regular Expression Traps using s///, etc.
798
799 Regular Expression, Regular Expression, Regular Expression, Regular
800 Expression, Regular Expression, Regular Expression, Regular Expression,
801 Regular Expression
802
803 =item Subroutine, Signal, Sorting Traps
804
805 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
806
807 =item OS Traps
808
809 (SysV), (SysV)
810
811 =item Interpolation Traps
812
813 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
814 Interpolation, Interpolation, Interpolation, Interpolation
815
816 =item DBM Traps
817
818 DBM, DBM
819
820 =item Unclassified Traps
821
822 C<require>/C<do> trap using returned value, C<split> on empty string with
823 LIMIT specified
824
825 =back
826
827 =back
828
829 =head2 perlrun - how to execute the Perl interpreter
830
831 =over 4
832
833 =item SYNOPSIS
834
835 =item DESCRIPTION
836
837 =over 4
838
839 =item #! and quoting on non-Unix systems
840
841 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
842
843 =item Location of Perl
844
845 =item Command Switches
846
847 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
848 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
849 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
850 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
851 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
852 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
853 B<-X>, B<-x> I<directory>
854
855 =back
856
857 =item ENVIRONMENT
858
859 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
860 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
861 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
862 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
863 SYS$LOGIN (specific to the VMS port)
864
865 =back
866
867 =head2 perldiag - various Perl diagnostics
868
869 =over 4
870
871 =item DESCRIPTION
872
873 =back
874
875 =head2 perllexwarn - Perl Lexical Warnings
876
877 =over 4
878
879 =item DESCRIPTION
880
881 =over 4
882
883 =item Default Warnings and Optional Warnings
884
885 =item What's wrong with B<-w> and C<$^W>
886
887 =item Controlling Warnings from the Command Line
888
889 B<-w>, B<-W>, B<-X>
890
891 =item Backward Compatibility
892
893 =item Category Hierarchy
894
895 =item Fatal Warnings
896
897 =item Reporting Warnings from a Module
898
899 =back
900
901 =item TODO
902
903 =item SEE ALSO
904
905 =item AUTHOR
906
907 =back
908
909 =head2 perldebtut - Perl debugging tutorial
910
911 =over 4
912
913 =item DESCRIPTION
914
915 =item use strict
916
917 =item Looking at data and -w and v
918
919 =item help
920
921 =item Stepping through code
922
923 =item Placeholder for a, w, t, T
924
925 =item REGULAR EXPRESSIONS
926
927 =item OUTPUT TIPS
928
929 =item CGI
930
931 =item GUIs
932
933 =item SUMMARY
934
935 =item SEE ALSO
936
937 =item AUTHOR
938
939 =item CONTRIBUTORS
940
941 =back
942
943 =head2 perldebug - Perl debugging
944
945 =over 4
946
947 =item DESCRIPTION
948
949 =item The Perl Debugger
950
951 =over 4
952
953 =item Debugger Commands
954
955 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
956 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
957 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
958 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
959 subname [condition], b postpone subname [condition], b load filename, b
960 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
961 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
962 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
963 command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or
964 ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
965
966 =item Configurable Options
967
968 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
969 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
970 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
971 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
972 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
973 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
974 C<NonStop>
975
976 =item Debugger input/output
977
978 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
979 listing
980
981 =item Debugging compile-time statements
982
983 =item Debugger Customization
984
985 =item Readline Support
986
987 =item Editor Support for Debugging
988
989 =item The Perl Profiler
990
991 =back
992
993 =item Debugging regular expressions
994
995 =item Debugging memory usage
996
997 =item SEE ALSO
998
999 =item BUGS
1000
1001 =back
1002
1003 =head2 perlvar - Perl predefined variables
1004
1005 =over 4
1006
1007 =item DESCRIPTION
1008
1009 =over 4
1010
1011 =item Predefined Names
1012
1013 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1014 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1015 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1016 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1017 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1018 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1019 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1020 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1021 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1022 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1023 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1024 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1025 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1026 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1027 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1028 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1029 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1030 IO::Handle->format_line_break_characters EXPR,
1031 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1032 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1033 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1034 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1035 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1036 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1037 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1038 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1039 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1040 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1041 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1042 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1043
1044 =item Error Indicators
1045
1046 =item Technical Note on the Syntax of Variable Names
1047
1048 =back
1049
1050 =item BUGS
1051
1052 =back
1053
1054 =head2 perllol - Manipulating Arrays of Arrays in Perl
1055
1056 =over 4
1057
1058 =item DESCRIPTION
1059
1060 =over 4
1061
1062 =item Declaration and Access of Arrays of Arrays
1063
1064 =item Growing Your Own
1065
1066 =item Access and Printing
1067
1068 =item Slices
1069
1070 =back
1071
1072 =item SEE ALSO
1073
1074 =item AUTHOR
1075
1076 =back
1077
1078 =head2 perlopentut - tutorial on opening things in Perl
1079
1080 =over 4
1081
1082 =item DESCRIPTION
1083
1084 =item Open E<agrave> la shell
1085
1086 =over 4
1087
1088 =item Simple Opens
1089
1090 =item Pipe Opens
1091
1092 =item The Minus File
1093
1094 =item Mixing Reads and Writes
1095
1096 =item Filters 
1097
1098 =back
1099
1100 =item Open E<agrave> la C
1101
1102 =over 4
1103
1104 =item Permissions E<agrave> la mode
1105
1106 =back
1107
1108 =item Obscure Open Tricks
1109
1110 =over 4
1111
1112 =item Re-Opening Files (dups)
1113
1114 =item Dispelling the Dweomer
1115
1116 =item Paths as Opens
1117
1118 =item Single Argument Open
1119
1120 =item Playing with STDIN and STDOUT
1121
1122 =back
1123
1124 =item Other I/O Issues
1125
1126 =over 4
1127
1128 =item Opening Non-File Files
1129
1130 =item Binary Files
1131
1132 =item File Locking
1133
1134 =item IO Layers
1135
1136 =back
1137
1138 =item SEE ALSO 
1139
1140 =item AUTHOR and COPYRIGHT
1141
1142 =item HISTORY
1143
1144 =back
1145
1146 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1147
1148 =over 4
1149
1150 =item DESCRIPTION
1151
1152 =item The Basic Principle
1153
1154 =item Packing Text
1155
1156 =item Packing Numbers
1157
1158 =over 4
1159
1160 =item Integers
1161
1162 =item Unpacking a Stack Frame
1163
1164 =item How to Eat an Egg on a Net
1165
1166 =item Floating point Numbers
1167
1168 =back
1169
1170 =item Exotic Templates
1171
1172 =over 4
1173
1174 =item Bit Strings
1175
1176 =item Uuencoding
1177
1178 =item Doing Sums
1179
1180 =item  Unicode
1181
1182 =item Another Portable Binary Encoding
1183
1184 =back
1185
1186 =item Lengths and Widths
1187
1188 =over 4
1189
1190 =item String Lengths
1191
1192 =item Dynamic Templates
1193
1194 =back
1195
1196 =item Packing and Unpacking C Structures
1197
1198 =over 4
1199
1200 =item The Alignment Pit
1201
1202 =item Alignment, Take 2
1203
1204 =item Alignment, Take 3
1205
1206 =item Pointers for How to Use Them
1207
1208 =back
1209
1210 =item Pack Recipes
1211
1212 =item Funnies Section
1213
1214 =item Authors
1215
1216 =back
1217
1218 =head2 perlretut - Perl regular expressions tutorial
1219
1220 =over 4
1221
1222 =item DESCRIPTION
1223
1224 =item Part 1: The basics
1225
1226 =over 4
1227
1228 =item Simple word matching
1229
1230 =item Using character classes
1231
1232 =item Matching this or that
1233
1234 =item Grouping things and hierarchical matching
1235
1236 =item Extracting matches
1237
1238 =item Matching repetitions
1239
1240 =item Building a regexp
1241
1242 =item Using regular expressions in Perl
1243
1244 =back
1245
1246 =item Part 2: Power tools
1247
1248 =over 4
1249
1250 =item More on characters, strings, and character classes
1251
1252 =item Compiling and saving regular expressions
1253
1254 =item Embedding comments and modifiers in a regular expression
1255
1256 =item Non-capturing groupings
1257
1258 =item Looking ahead and looking behind
1259
1260 =item Using independent subexpressions to prevent backtracking
1261
1262 =item Conditional expressions
1263
1264 =item A bit of magic: executing Perl code in a regular expression
1265
1266 =item Pragmas and debugging
1267
1268 =back
1269
1270 =item BUGS
1271
1272 =item SEE ALSO
1273
1274 =item AUTHOR AND COPYRIGHT
1275
1276 =over 4
1277
1278 =item Acknowledgments
1279
1280 =back
1281
1282 =back
1283
1284 =head2 perlre - Perl regular expressions
1285
1286 =over 4
1287
1288 =item DESCRIPTION
1289
1290 i, m, s, x
1291
1292 =over 4
1293
1294 =item Regular Expressions
1295
1296 [1], [2], [3], cntrl, graph, print, punct, xdigit
1297
1298 =item Extended Patterns
1299
1300 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1301 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1302 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1303 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1304
1305 =item Backtracking
1306
1307 =item Version 8 Regular Expressions
1308
1309 =item Warning on \1 vs $1
1310
1311 =item Repeated patterns matching zero-length substring
1312
1313 =item Combining pieces together
1314
1315 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1316 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1317 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1318 C<(?(condition)yes-pattern|no-pattern)>
1319
1320 =item Creating custom RE engines
1321
1322 =back
1323
1324 =item BUGS
1325
1326 =item SEE ALSO
1327
1328 =back
1329
1330 =head2 perlref - Perl references and nested data structures
1331
1332 =over 4
1333
1334 =item NOTE
1335
1336 =item DESCRIPTION
1337
1338 =over 4
1339
1340 =item Making References
1341
1342 =item Using References
1343
1344 =item Symbolic references
1345
1346 =item Not-so-symbolic references
1347
1348 =item Pseudo-hashes: Using an array as a hash
1349
1350 =item Function Templates
1351
1352 =back
1353
1354 =item WARNING
1355
1356 =item SEE ALSO
1357
1358 =back
1359
1360 =head2 perlform - Perl formats
1361
1362 =over 4
1363
1364 =item DESCRIPTION
1365
1366 =over 4
1367
1368 =item Format Variables
1369
1370 =back
1371
1372 =item NOTES
1373
1374 =over 4
1375
1376 =item Footers
1377
1378 =item Accessing Formatting Internals
1379
1380 =back
1381
1382 =item WARNINGS
1383
1384 =back
1385
1386 =head2 perlboot - Beginner's Object-Oriented Tutorial
1387
1388 =over 4
1389
1390 =item DESCRIPTION
1391
1392 =over 4
1393
1394 =item If we could talk to the animals...
1395
1396 =item Introducing the method invocation arrow
1397
1398 =item Invoking a barnyard
1399
1400 =item The extra parameter of method invocation
1401
1402 =item Calling a second method to simplify things
1403
1404 =item Inheriting the windpipes
1405
1406 =item A few notes about @ISA
1407
1408 =item Overriding the methods
1409
1410 =item Starting the search from a different place
1411
1412 =item The SUPER way of doing things
1413
1414 =item Where we're at so far...
1415
1416 =item A horse is a horse, of course of course -- or is it?
1417
1418 =item Invoking an instance method
1419
1420 =item Accessing the instance data
1421
1422 =item How to build a horse
1423
1424 =item Inheriting the constructor
1425
1426 =item Making a method work with either classes or instances
1427
1428 =item Adding parameters to a method
1429
1430 =item More interesting instances
1431
1432 =item A horse of a different color
1433
1434 =item Summary
1435
1436 =back
1437
1438 =item SEE ALSO
1439
1440 =item COPYRIGHT
1441
1442 =back
1443
1444 =head2 perltoot - Tom's object-oriented tutorial for perl
1445
1446 =over 4
1447
1448 =item DESCRIPTION
1449
1450 =item Creating a Class
1451
1452 =over 4
1453
1454 =item Object Representation
1455
1456 =item Class Interface
1457
1458 =item Constructors and Instance Methods
1459
1460 =item Planning for the Future: Better Constructors
1461
1462 =item Destructors
1463
1464 =item Other Object Methods
1465
1466 =back
1467
1468 =item Class Data
1469
1470 =over 4
1471
1472 =item Accessing Class Data
1473
1474 =item Debugging Methods
1475
1476 =item Class Destructors
1477
1478 =item Documenting the Interface
1479
1480 =back
1481
1482 =item Aggregation
1483
1484 =item Inheritance
1485
1486 =over 4
1487
1488 =item Overridden Methods
1489
1490 =item Multiple Inheritance
1491
1492 =item UNIVERSAL: The Root of All Objects
1493
1494 =back
1495
1496 =item Alternate Object Representations
1497
1498 =over 4
1499
1500 =item Arrays as Objects
1501
1502 =item Closures as Objects
1503
1504 =back
1505
1506 =item AUTOLOAD: Proxy Methods
1507
1508 =over 4
1509
1510 =item Autoloaded Data Methods
1511
1512 =item Inherited Autoloaded Data Methods
1513
1514 =back
1515
1516 =item Metaclassical Tools
1517
1518 =over 4
1519
1520 =item Class::Struct
1521
1522 =item Data Members as Variables
1523
1524 =back
1525
1526 =item NOTES
1527
1528 =over 4
1529
1530 =item Object Terminology
1531
1532 =back
1533
1534 =item SEE ALSO
1535
1536 =item AUTHOR AND COPYRIGHT
1537
1538 =item COPYRIGHT
1539
1540 =over 4
1541
1542 =item Acknowledgments
1543
1544 =back
1545
1546 =back
1547
1548 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1549
1550 =over 4
1551
1552 =item DESCRIPTION
1553
1554 =item Class Data in a Can
1555
1556 =item Class Data as Package Variables
1557
1558 =over 4
1559
1560 =item Putting All Your Eggs in One Basket
1561
1562 =item Inheritance Concerns
1563
1564 =item The Eponymous Meta-Object
1565
1566 =item Indirect References to Class Data
1567
1568 =item Monadic Classes
1569
1570 =item Translucent Attributes
1571
1572 =back
1573
1574 =item Class Data as Lexical Variables
1575
1576 =over 4
1577
1578 =item Privacy and Responsibility 
1579
1580 =item File-Scoped Lexicals
1581
1582 =item More Inheritance Concerns
1583
1584 =item Locking the Door and Throwing Away the Key
1585
1586 =item Translucency Revisited
1587
1588 =back
1589
1590 =item NOTES
1591
1592 =item SEE ALSO
1593
1594 =item AUTHOR AND COPYRIGHT
1595
1596 =item ACKNOWLEDGEMENTS
1597
1598 =item HISTORY
1599
1600 =back
1601
1602 =head2 perlobj - Perl objects
1603
1604 =over 4
1605
1606 =item DESCRIPTION
1607
1608 =over 4
1609
1610 =item An Object is Simply a Reference
1611
1612 =item A Class is Simply a Package
1613
1614 =item A Method is Simply a Subroutine
1615
1616 =item Method Invocation
1617
1618 =item Indirect Object Syntax
1619
1620 =item Default UNIVERSAL methods
1621
1622 isa(CLASS), can(METHOD), VERSION( [NEED] )
1623
1624 =item Destructors
1625
1626 =item Summary
1627
1628 =item Two-Phased Garbage Collection
1629
1630 =back
1631
1632 =item SEE ALSO
1633
1634 =back
1635
1636 =head2 perlbot - Bag'o Object Tricks (the BOT)
1637
1638 =over 4
1639
1640 =item DESCRIPTION
1641
1642 =item OO SCALING TIPS
1643
1644 =item INSTANCE VARIABLES
1645
1646 =item SCALAR INSTANCE VARIABLES
1647
1648 =item INSTANCE VARIABLE INHERITANCE
1649
1650 =item OBJECT RELATIONSHIPS
1651
1652 =item OVERRIDING SUPERCLASS METHODS
1653
1654 =item USING RELATIONSHIP WITH SDBM
1655
1656 =item THINKING OF CODE REUSE
1657
1658 =item CLASS CONTEXT AND THE OBJECT
1659
1660 =item INHERITING A CONSTRUCTOR
1661
1662 =item DELEGATION
1663
1664 =back
1665
1666 =head2 perltie - how to hide an object class in a simple variable
1667
1668 =over 4
1669
1670 =item SYNOPSIS
1671
1672 =item DESCRIPTION
1673
1674 =over 4
1675
1676 =item Tying Scalars
1677
1678 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1679 DESTROY this
1680
1681 =item Tying Arrays
1682
1683 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1684 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1685 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1686 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1687 this
1688
1689 =item Tying Hashes
1690
1691 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1692 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1693 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1694
1695 =item Tying FileHandles
1696
1697 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1698 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1699 DESTROY this
1700
1701 =item UNTIE this
1702
1703 =item The C<untie> Gotcha
1704
1705 =back
1706
1707 =item SEE ALSO
1708
1709 =item BUGS
1710
1711 =item AUTHOR
1712
1713 =back
1714
1715 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1716 safe subprocesses, sockets, and semaphores)
1717
1718 =over 4
1719
1720 =item DESCRIPTION
1721
1722 =item Signals
1723
1724 =over 4
1725
1726 =item Handling the SIGHUP Signal in Daemons
1727
1728 =back
1729
1730 =item Named Pipes
1731
1732 =over 4
1733
1734 =item Deferred Signals
1735
1736 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1737 triggered by operating system state
1738
1739 =back
1740
1741 =item Using open() for IPC
1742
1743 =over 4
1744
1745 =item Filehandles
1746
1747 =item Background Processes
1748
1749 =item Complete Dissociation of Child from Parent
1750
1751 =item Safe Pipe Opens
1752
1753 =item Bidirectional Communication with Another Process
1754
1755 =item Bidirectional Communication with Yourself
1756
1757 =back
1758
1759 =item Sockets: Client/Server Communication
1760
1761 =over 4
1762
1763 =item Internet Line Terminators
1764
1765 =item Internet TCP Clients and Servers
1766
1767 =item Unix-Domain TCP Clients and Servers
1768
1769 =back
1770
1771 =item TCP Clients with IO::Socket
1772
1773 =over 4
1774
1775 =item A Simple Client
1776
1777 C<Proto>, C<PeerAddr>, C<PeerPort>
1778
1779 =item A Webget Client
1780
1781 =item Interactive Client with IO::Socket
1782
1783 =back
1784
1785 =item TCP Servers with IO::Socket
1786
1787 Proto, LocalPort, Listen, Reuse
1788
1789 =item UDP: Message Passing
1790
1791 =item SysV IPC
1792
1793 =item NOTES
1794
1795 =item BUGS
1796
1797 =item AUTHOR
1798
1799 =item SEE ALSO
1800
1801 =back
1802
1803 =head2 perlfork - Perl's fork() emulation
1804
1805 =over 4
1806
1807 =item SYNOPSIS
1808
1809 =item DESCRIPTION
1810
1811 =over 4
1812
1813 =item Behavior of other Perl features in forked pseudo-processes
1814
1815 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1816 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1817 files, directories and network sockets
1818
1819 =item Resource limits
1820
1821 =item Killing the parent process
1822
1823 =item Lifetime of the parent process and pseudo-processes
1824
1825 =item CAVEATS AND LIMITATIONS
1826
1827 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1828 Global state maintained by XSUBs, Interpreter embedded in larger
1829 application, Thread-safety of extensions
1830
1831 =back
1832
1833 =item BUGS
1834
1835 =item AUTHOR
1836
1837 =item SEE ALSO
1838
1839 =back
1840
1841 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1842
1843 =over 4
1844
1845 =item SYNOPSIS
1846
1847 =item DESCRIPTION
1848
1849 =item Storing numbers
1850
1851 =item Numeric operators and numeric conversions
1852
1853 =item Flavors of Perl numeric operations
1854
1855 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1856 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1857 integer>, Operators which expect an integer, Operators which expect a
1858 string
1859
1860 =item AUTHOR
1861
1862 =item SEE ALSO
1863
1864 =back
1865
1866 =head2 perlthrtut - tutorial on threads in Perl
1867
1868 =over 4
1869
1870 =item DESCRIPTION
1871
1872 =item Status
1873
1874 =item What Is A Thread Anyway?
1875
1876 =item Threaded Program Models
1877
1878 =over 4
1879
1880 =item Boss/Worker
1881
1882 =item Work Crew
1883
1884 =item Pipeline
1885
1886 =back
1887
1888 =item Native threads
1889
1890 =item What kind of threads are Perl threads?
1891
1892 =item Threadsafe Modules
1893
1894 =item Thread Basics
1895
1896 =over 4
1897
1898 =item Basic Thread Support
1899
1900 =item A Note about the Examples
1901
1902 =item Creating Threads
1903
1904 =item Giving up control
1905
1906 =item Waiting For A Thread To Exit
1907
1908 =item Ignoring A Thread
1909
1910 =back
1911
1912 =item Threads And Data
1913
1914 =over 4
1915
1916 =item Shared And Unshared Data
1917
1918 =item Thread Pitfalls: Races
1919
1920 =back
1921
1922 =item Synchronization and control
1923
1924 =over 4
1925
1926 =item Controlling access: lock()
1927
1928 =item A Thread Pitfall: Deadlocks
1929
1930 =item Queues: Passing Data Around
1931
1932 =item Semaphores: Synchronizing Data Access
1933
1934 =item Basic semaphores
1935
1936 =item Advanced Semaphores
1937
1938 =item cond_wait() and cond_signal()
1939
1940 =back
1941
1942 =item General Thread Utility Routines
1943
1944 =over 4
1945
1946 =item What Thread Am I In?
1947
1948 =item Thread IDs
1949
1950 =item Are These Threads The Same?
1951
1952 =item What Threads Are Running?
1953
1954 =back
1955
1956 =item A Complete Example
1957
1958 =item Performance considerations
1959
1960 =item Threadsafety of System Libraries
1961
1962 =item Conclusion
1963
1964 =item Bibliography
1965
1966 =over 4
1967
1968 =item Introductory Texts
1969
1970 =item OS-Related References
1971
1972 =item Other References
1973
1974 =back
1975
1976 =item Acknowledgements
1977
1978 =item AUTHOR
1979
1980 =item Copyrights
1981
1982 =back
1983
1984 =head2 perlothrtut - old tutorial on threads in Perl
1985
1986 =over 4
1987
1988 =item DESCRIPTION
1989
1990 =item What Is A Thread Anyway?
1991
1992 =item Threaded Program Models
1993
1994 =over 4
1995
1996 =item Boss/Worker
1997
1998 =item Work Crew
1999
2000 =item Pipeline
2001
2002 =back
2003
2004 =item Native threads
2005
2006 =item What kind of threads are perl threads?
2007
2008 =item Threadsafe Modules
2009
2010 =item Thread Basics
2011
2012 =over 4
2013
2014 =item Basic Thread Support
2015
2016 =item Creating Threads
2017
2018 =item Giving up control
2019
2020 =item Waiting For A Thread To Exit
2021
2022 =item Errors In Threads
2023
2024 =item Ignoring A Thread
2025
2026 =back
2027
2028 =item Threads And Data
2029
2030 =over 4
2031
2032 =item Shared And Unshared Data
2033
2034 =item Thread Pitfall: Races
2035
2036 =item Controlling access: lock()
2037
2038 =item Thread Pitfall: Deadlocks
2039
2040 =item Queues: Passing Data Around
2041
2042 =back
2043
2044 =item Threads And Code
2045
2046 =over 4
2047
2048 =item Semaphores: Synchronizing Data Access
2049
2050 Basic semaphores, Advanced Semaphores
2051
2052 =item Attributes: Restricting Access To Subroutines
2053
2054 =item Subroutine Locks
2055
2056 =item Methods
2057
2058 =item Locking A Subroutine
2059
2060 =back
2061
2062 =item General Thread Utility Routines
2063
2064 =over 4
2065
2066 =item What Thread Am I In?
2067
2068 =item Thread IDs
2069
2070 =item Are These Threads The Same?
2071
2072 =item What Threads Are Running?
2073
2074 =back
2075
2076 =item A Complete Example
2077
2078 =item Conclusion
2079
2080 =item Bibliography
2081
2082 =over 4
2083
2084 =item Introductory Texts
2085
2086 =item OS-Related References
2087
2088 =item Other References
2089
2090 =back
2091
2092 =item Acknowledgements
2093
2094 =item AUTHOR
2095
2096 =item Copyrights
2097
2098 =back
2099
2100 =head2 perlport - Writing portable Perl
2101
2102 =over 4
2103
2104 =item DESCRIPTION
2105
2106 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2107 portable
2108
2109 =item ISSUES
2110
2111 =over 4
2112
2113 =item Newlines
2114
2115 =item Numbers endianness and Width
2116
2117 =item Files and Filesystems
2118
2119 =item System Interaction
2120
2121 =item Command names versus file pathnames
2122
2123 =item Interprocess Communication (IPC)
2124
2125 =item External Subroutines (XS)
2126
2127 =item Standard Modules
2128
2129 =item Time and Date
2130
2131 =item Character sets and character encoding
2132
2133 =item Internationalisation
2134
2135 =item System Resources
2136
2137 =item Security
2138
2139 =item Style
2140
2141 =back
2142
2143 =item CPAN Testers
2144
2145 Mailing list: cpan-testers@perl.org, Testing results:
2146 http://testers.cpan.org/
2147
2148 =item PLATFORMS
2149
2150 =over 4
2151
2152 =item Unix
2153
2154 =item DOS and Derivatives
2155
2156 =item S<Mac OS>
2157
2158 =item VMS
2159
2160 =item VOS
2161
2162 =item EBCDIC Platforms
2163
2164 =item Acorn RISC OS
2165
2166 =item Other perls
2167
2168 =back
2169
2170 =item FUNCTION IMPLEMENTATIONS
2171
2172 =over 4
2173
2174 =item Alphabetical Listing of Perl Functions
2175
2176 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2177 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2178 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2179 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2180 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2181 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2182 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2183 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2184 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2185 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2186 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2187 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2188 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2189 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2190 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2191 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2192 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2193 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2194 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2195 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2196 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2197 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2198 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2199 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2200 wait, waitpid PID,FLAGS
2201
2202 =back
2203
2204 =item CHANGES
2205
2206 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2207 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2208 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2209 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2210 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2211 v1.30, 03 August 1998, v1.23, 10 July 1998
2212
2213 =item Supported Platforms
2214
2215 =item SEE ALSO
2216
2217 =item AUTHORS / CONTRIBUTORS
2218
2219 =back
2220
2221 =head2 perllocale - Perl locale handling (internationalization and
2222 localization)
2223
2224 =over 4
2225
2226 =item DESCRIPTION
2227
2228 =item PREPARING TO USE LOCALES
2229
2230 =item USING LOCALES
2231
2232 =over 4
2233
2234 =item The use locale pragma
2235
2236 =item The setlocale function
2237
2238 =item Finding locales
2239
2240 =item LOCALE PROBLEMS
2241
2242 =item Temporarily fixing locale problems
2243
2244 =item Permanently fixing locale problems
2245
2246 =item Permanently fixing your system's locale configuration
2247
2248 =item Fixing system locale configuration
2249
2250 =item The localeconv function
2251
2252 =item I18N::Langinfo
2253
2254 =back
2255
2256 =item LOCALE CATEGORIES
2257
2258 =over 4
2259
2260 =item Category LC_COLLATE: Collation
2261
2262 =item Category LC_CTYPE: Character Types
2263
2264 =item Category LC_NUMERIC: Numeric Formatting
2265
2266 =item Category LC_MONETARY: Formatting of monetary amounts
2267
2268 =item LC_TIME
2269
2270 =item Other categories
2271
2272 =back
2273
2274 =item SECURITY
2275
2276 =item ENVIRONMENT
2277
2278 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2279 LC_NUMERIC, LC_TIME, LANG
2280
2281 =item NOTES
2282
2283 =over 4
2284
2285 =item Backward compatibility
2286
2287 =item I18N:Collate obsolete
2288
2289 =item Sort speed and memory use impacts
2290
2291 =item write() and LC_NUMERIC
2292
2293 =item Freely available locale definitions
2294
2295 =item I18n and l10n
2296
2297 =item An imperfect standard
2298
2299 =back
2300
2301 =item Unicode and UTF-8
2302
2303 =item BUGS
2304
2305 =over 4
2306
2307 =item Broken systems
2308
2309 =back
2310
2311 =item SEE ALSO
2312
2313 =item HISTORY
2314
2315 =back
2316
2317 =head2 perluniintro - Perl Unicode introduction
2318
2319 =over 4
2320
2321 =item DESCRIPTION
2322
2323 =over 4
2324
2325 =item Unicode
2326
2327 =item Perl's Unicode Support
2328
2329 =item Perl's Unicode Model
2330
2331 =item Unicode and EBCDIC
2332
2333 =item Creating Unicode
2334
2335 =item Handling Unicode
2336
2337 =item Legacy Encodings
2338
2339 =item Unicode I/O
2340
2341 =item Displaying Unicode As Text
2342
2343 =item Special Cases
2344
2345 =item Advanced Topics
2346
2347 =item Miscellaneous
2348
2349 =item Questions With Answers
2350
2351 =item Hexadecimal Notation
2352
2353 =item Further Resources
2354
2355 =back
2356
2357 =item UNICODE IN OLDER PERLS
2358
2359 =item SEE ALSO
2360
2361 =item ACKNOWLEDGMENTS
2362
2363 =item AUTHOR, COPYRIGHT, AND LICENSE
2364
2365 =back
2366
2367 =head2 perlunicode - Unicode support in Perl
2368
2369 =over 4
2370
2371 =item DESCRIPTION
2372
2373 =over 4
2374
2375 =item Important Caveats
2376
2377 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2378 to enable UTF-8/UTF-EBCDIC in scripts
2379
2380 =item Byte and Character Semantics
2381
2382 =item Effects of Character Semantics
2383
2384 =item Scripts
2385
2386 =item Blocks
2387
2388 =item User-Defined Character Properties
2389
2390 =item Character Encodings for Input and Output
2391
2392 =item Unicode Regular Expression Support Level
2393
2394 =item Unicode Encodings
2395
2396 =item Security Implications of Unicode
2397
2398 =item Unicode in Perl on EBCDIC
2399
2400 =item Locales
2401
2402 =item Using Unicode in XS
2403
2404 =back
2405
2406 =item BUGS
2407
2408 =over 4
2409
2410 =item Interaction with Locales
2411
2412 =item Interaction with Extensions
2413
2414 =item Speed
2415
2416 =back
2417
2418 =item SEE ALSO
2419
2420 =back
2421
2422 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2423
2424 =over 4
2425
2426 =item DESCRIPTION
2427
2428 =item COMMON CHARACTER CODE SETS
2429
2430 =over 4
2431
2432 =item ASCII
2433
2434 =item ISO 8859
2435
2436 =item Latin 1 (ISO 8859-1)
2437
2438 =item EBCDIC
2439
2440 =item 13 variant characters
2441
2442 =item 0037
2443
2444 =item 1047
2445
2446 =item POSIX-BC
2447
2448 =item Unicode code points versus EBCDIC code points
2449
2450 =item Remaining Perl Unicode problems in EBCDIC
2451
2452 =item Unicode and UTF
2453
2454 =item Using Encode
2455
2456 =back
2457
2458 =item SINGLE OCTET TABLES
2459
2460 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2461
2462 =item IDENTIFYING CHARACTER CODE SETS
2463
2464 =item CONVERSIONS
2465
2466 =over 4
2467
2468 =item tr///
2469
2470 =item iconv
2471
2472 =item C RTL
2473
2474 =back
2475
2476 =item OPERATOR DIFFERENCES
2477
2478 =item FUNCTION DIFFERENCES
2479
2480 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2481
2482 =item REGULAR EXPRESSION DIFFERENCES
2483
2484 =item SOCKETS
2485
2486 =item SORTING
2487
2488 =over 4
2489
2490 =item Ignore ASCII vs. EBCDIC sort differences.
2491
2492 =item MONO CASE then sort data.
2493
2494 =item Convert, sort data, then re convert.
2495
2496 =item Perform sorting on one type of machine only.
2497
2498 =back
2499
2500 =item TRANSFORMATION FORMATS
2501
2502 =over 4
2503
2504 =item URL decoding and encoding
2505
2506 =item uu encoding and decoding
2507
2508 =item Quoted-Printable encoding and decoding
2509
2510 =item Caesarian ciphers
2511
2512 =back
2513
2514 =item Hashing order and checksums
2515
2516 =item I18N AND L10N
2517
2518 =item MULTI OCTET CHARACTER SETS
2519
2520 =item OS ISSUES
2521
2522 =over 4
2523
2524 =item OS/400 
2525
2526 IFS access
2527
2528 =item OS/390, z/OS
2529
2530 chcp, dataset access, OS/390, z/OS iconv, locales
2531
2532 =item VM/ESA?
2533
2534 =item POSIX-BC?
2535
2536 =back
2537
2538 =item BUGS
2539
2540 =item SEE ALSO
2541
2542 =item REFERENCES
2543
2544 =item HISTORY
2545
2546 =item AUTHOR
2547
2548 =back
2549
2550 =head2 perlsec - Perl security
2551
2552 =over 4
2553
2554 =item DESCRIPTION
2555
2556 =over 4
2557
2558 =item Laundering and Detecting Tainted Data
2559
2560 =item Switches On the "#!" Line
2561
2562 =item Cleaning Up Your Path
2563
2564 =item Security Bugs
2565
2566 =item Protecting Your Programs
2567
2568 =item Unicode
2569
2570 =back
2571
2572 =item SEE ALSO
2573
2574 =back
2575
2576 =head2 perlmod - Perl modules (packages and symbol tables)
2577
2578 =over 4
2579
2580 =item DESCRIPTION
2581
2582 =over 4
2583
2584 =item Packages
2585
2586 =item Symbol Tables
2587
2588 =item Package Constructors and Destructors
2589
2590 =item Perl Classes
2591
2592 =item Perl Modules
2593
2594 =item Making your module threadsafe
2595
2596 =back
2597
2598 =item SEE ALSO
2599
2600 =back
2601
2602 =head2 perlmodinstall - Installing CPAN Modules
2603
2604 =over 4
2605
2606 =item DESCRIPTION
2607
2608 =over 4
2609
2610 =item PREAMBLE
2611
2612 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2613 module (sometimes unnecessary), B<INSTALL> the module
2614
2615 =back
2616
2617 =item PORTABILITY
2618
2619 =item HEY
2620
2621 =item AUTHOR
2622
2623 =item COPYRIGHT
2624
2625 =back
2626
2627 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2628
2629 =over 4
2630
2631 =item DESCRIPTION
2632
2633 =item THE PERL MODULE LIBRARY
2634
2635 =over 4
2636
2637 =item Pragmatic Modules
2638
2639 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2640 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2641 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2642 threads, utf8, vars, vmsish, warnings, warnings::register
2643
2644 =item Standard Modules
2645
2646 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2647 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2648 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2649 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2650 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2651 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2652 Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest,
2653 DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter,
2654 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
2655 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
2656 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
2657 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
2658 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
2659 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2660 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2661 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2662 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2663 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2664 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2665 File::Spec::Mac, File::Spec::NW5, File::Spec::OS2, File::Spec::Unix,
2666 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
2667 FileHandle, Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2668 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2669 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2670 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2671 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2672 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2673 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2674 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2675 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2676 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2677 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2678 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2679 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2680 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2681 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe,
2682 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
2683 Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
2684 Test::Builder, Test::Harness, Test::Harness::Assert,
2685 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2686 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2687 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2688 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2689 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2690 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2691 Unicode::UCD, User::grent, User::pwent, Win32
2692
2693 =item Extension Modules
2694
2695 =back
2696
2697 =item CPAN
2698
2699 =over 4
2700
2701 =item Africa
2702
2703 =item Asia
2704
2705 =item Central America
2706
2707 =item Europe
2708
2709 =item North America
2710
2711 =item Oceania
2712
2713 =item South America
2714
2715 =back
2716
2717 =item Modules: Creation, Use, and Abuse
2718
2719 =over 4
2720
2721 =item Guidelines for Module Creation
2722
2723 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2724
2725 =item Guidelines for Reusing Application Code
2726
2727 =back
2728
2729 =item NOTE
2730
2731 =back
2732
2733 =head2 perlmodstyle - Perl module style guide
2734
2735 =over 4
2736
2737 =item INTRODUCTION
2738
2739 =item QUICK CHECKLIST
2740
2741 =over 4
2742
2743 =item Before you start
2744
2745 =item The API
2746
2747 =item Stability
2748
2749 =item Documentation
2750
2751 =item Release considerations
2752
2753 =back
2754
2755 =item BEFORE YOU START WRITING A MODULE
2756
2757 =over 4
2758
2759 =item Has it been done before?
2760
2761 =item Do one thing and do it well
2762
2763 =item What's in a name?
2764
2765 =back
2766
2767 =item DESIGNING AND WRITING YOUR MODULE
2768
2769 =over 4
2770
2771 =item To OO or not to OO?
2772
2773 =item Designing your API
2774
2775 Write simple routines to do simple things, Separate functionality from
2776 output, Provide sensible shortcuts and defaults, Naming conventions,
2777 Parameter passing
2778
2779 =item Strictness and warnings
2780
2781 =item Backwards compatibility
2782
2783 =item Error handling and messages
2784
2785 =back
2786
2787 =item DOCUMENTING YOUR MODULE
2788
2789 =over 4
2790
2791 =item POD
2792
2793 =item README, INSTALL, release notes, changelogs
2794
2795 =back
2796
2797 =item RELEASE CONSIDERATIONS
2798
2799 =over 4
2800
2801 =item Version numbering
2802
2803 =item Pre-requisites
2804
2805 =item Testing
2806
2807 =item Packaging
2808
2809 =item Licensing
2810
2811 =back
2812
2813 =item COMMON PITFALLS
2814
2815 =over 4
2816
2817 =item Reinventing the wheel
2818
2819 =item Trying to do too much
2820
2821 =item Inappropriate documentation
2822
2823 =back
2824
2825 =item SEE ALSO
2826
2827 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2828 http://pause.perl.org/, Any good book on software engineering
2829
2830 =item AUTHOR
2831
2832 =back
2833
2834 =head2 perlnewmod - preparing a new module for distribution
2835
2836 =over 4
2837
2838 =item DESCRIPTION
2839
2840 =over 4
2841
2842 =item Warning
2843
2844 =item What should I make into a module?
2845
2846 =item Step-by-step: Preparing the ground
2847
2848 Look around, Check it's new, Discuss the need, Choose a name, Check again
2849
2850 =item Step-by-step: Making the module
2851
2852 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2853 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2854 documentation|perlpod>, Write tests, Write the README
2855
2856 =item Step-by-step: Distributing your module
2857
2858 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2859 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2860
2861 =back
2862
2863 =item AUTHOR
2864
2865 =item SEE ALSO
2866
2867 =back
2868
2869 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2870 2002/04/07 18:46:13 $)
2871
2872 =over 4
2873
2874 =item DESCRIPTION
2875
2876 =over 4
2877
2878 =item What is Perl?
2879
2880 =item Who supports Perl?  Who develops it?  Why is it free?
2881
2882 =item Which version of Perl should I use?
2883
2884 =item What are perl4 and perl5?
2885
2886 =item What is perl6?
2887
2888 =item How stable is Perl?
2889
2890 =item Is Perl difficult to learn?
2891
2892 =item How does Perl compare with other languages like Java, Python, REXX,
2893 Scheme, or Tcl?
2894
2895 =item Can I do [task] in Perl?
2896
2897 =item When shouldn't I program in Perl?
2898
2899 =item What's the difference between "perl" and "Perl"?
2900
2901 =item Is it a Perl program or a Perl script?
2902
2903 =item What is a JAPH?
2904
2905 =item Where can I get a list of Larry Wall witticisms?
2906
2907 =item How can I convince my sysadmin/supervisor/employees to use version
2908 5/5.6.1/Perl instead of some other language?
2909
2910 =back
2911
2912 =item AUTHOR AND COPYRIGHT
2913
2914 =back
2915
2916 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2917 $Date: 2002/04/26 16:56:35 $)
2918
2919 =over 4
2920
2921 =item DESCRIPTION
2922
2923 =over 4
2924
2925 =item What machines support Perl?  Where do I get it?
2926
2927 =item How can I get a binary version of Perl?
2928
2929 =item I don't have a C compiler on my system.  How can I compile perl?
2930
2931 =item I copied the Perl binary from one machine to another, but scripts
2932 don't work.
2933
2934 =item I grabbed the sources and tried to compile but gdbm/dynamic
2935 loading/malloc/linking/... failed.  How do I make it work?
2936
2937 =item What modules and extensions are available for Perl?  What is CPAN? 
2938 What does CPAN/src/... mean?
2939
2940 =item Is there an ISO or ANSI certified version of Perl?
2941
2942 =item Where can I get information on Perl?
2943
2944 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2945
2946 =item Where should I post source code?
2947
2948 =item Perl Books
2949
2950 References, Tutorials, Task-Oriented, Special Topics
2951
2952 =item Perl in Magazines
2953
2954 =item Perl on the Net: FTP and WWW Access
2955
2956 =item What mailing lists are there for Perl?
2957
2958 =item Archives of comp.lang.perl.misc
2959
2960 =item Where can I buy a commercial version of Perl?
2961
2962 =item Where do I send bug reports?
2963
2964 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2965
2966 =back
2967
2968 =item AUTHOR AND COPYRIGHT
2969
2970 =back
2971
2972 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
2973 13:11:13 $)
2974
2975 =over 4
2976
2977 =item DESCRIPTION
2978
2979 =over 4
2980
2981 =item How do I do (anything)?
2982
2983 =item How can I use Perl interactively?
2984
2985 =item Is there a Perl shell?
2986
2987 =item How do I debug my Perl programs?
2988
2989 =item How do I profile my Perl programs?
2990
2991 =item How do I cross-reference my Perl programs?
2992
2993 =item Is there a pretty-printer (formatter) for Perl?
2994
2995 =item Is there a ctags for Perl?
2996
2997 =item Is there an IDE or Windows Perl Editor?
2998
2999 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
3000 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
3001 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3002
3003 =item Where can I get Perl macros for vi?
3004
3005 =item Where can I get perl-mode for emacs?
3006
3007 =item How can I use curses with Perl?
3008
3009 =item How can I use X or Tk with Perl?
3010
3011 =item How can I generate simple menus without using CGI or Tk?
3012
3013 =item How can I make my Perl program run faster?
3014
3015 =item How can I make my Perl program take less memory?
3016
3017 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3018 stringification, Pass by reference, Tie large variables to disk
3019
3020 =item Is it unsafe to return a pointer to local data?
3021
3022 =item How can I free an array or hash so my program shrinks?
3023
3024 =item How can I make my CGI script more efficient?
3025
3026 =item How can I hide the source for my Perl program?
3027
3028 =item How can I compile my Perl program into byte code or C?
3029
3030 =item How can I compile Perl into Java?
3031
3032 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3033
3034 =item Can I write useful Perl programs on the command line?
3035
3036 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3037
3038 =item Where can I learn about CGI or Web programming in Perl?
3039
3040 =item Where can I learn about object-oriented Perl programming?
3041
3042 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3043
3044 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3045 my C program; what am I doing wrong?
3046
3047 =item When I tried to run my script, I got this message. What does it mean?
3048
3049 =item What's MakeMaker?
3050
3051 =back
3052
3053 =item AUTHOR AND COPYRIGHT
3054
3055 =back
3056
3057 =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
3058 07:04:25 $)
3059
3060 =over 4
3061
3062 =item DESCRIPTION
3063
3064 =item Data: Numbers
3065
3066 =over 4
3067
3068 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3069 numbers I should be getting (eg, 19.95)?
3070
3071 =item Why isn't my octal data interpreted correctly?
3072
3073 =item Does Perl have a round() function?  What about ceil() and floor()? 
3074 Trig functions?
3075
3076 =item How do I convert between numeric representations?
3077
3078 How do I convert hexadecimal into decimal, How do I convert from decimal to
3079 hexadecimal, How do I convert from octal to decimal, How do I convert from
3080 decimal to octal, How do I convert from binary to decimal, How do I convert
3081 from decimal to binary
3082
3083 =item Why doesn't & work the way I want it to?
3084
3085 =item How do I multiply matrices?
3086
3087 =item How do I perform an operation on a series of integers?
3088
3089 =item How can I output Roman numerals?
3090
3091 =item Why aren't my random numbers random?
3092
3093 =item How do I get a random number between X and Y?
3094
3095 =back
3096
3097 =item Data: Dates
3098
3099 =over 4
3100
3101 =item How do I find the week-of-the-year/day-of-the-year?
3102
3103 =item How do I find the current century or millennium?
3104
3105 =item How can I compare two dates and find the difference?
3106
3107 =item How can I take a string and turn it into epoch seconds?
3108
3109 =item How can I find the Julian Day?
3110
3111 =item How do I find yesterday's date?
3112
3113 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3114
3115 =back
3116
3117 =item Data: Strings
3118
3119 =over 4
3120
3121 =item How do I validate input?
3122
3123 =item How do I unescape a string?
3124
3125 =item How do I remove consecutive pairs of characters?
3126
3127 =item How do I expand function calls in a string?
3128
3129 =item How do I find matching/nesting anything?
3130
3131 =item How do I reverse a string?
3132
3133 =item How do I expand tabs in a string?
3134
3135 =item How do I reformat a paragraph?
3136
3137 =item How can I access/change the first N letters of a string?
3138
3139 =item How do I change the Nth occurrence of something?
3140
3141 =item How can I count the number of occurrences of a substring within a
3142 string?
3143
3144 =item How do I capitalize all the words on one line?
3145
3146 =item How can I split a [character] delimited string except when inside
3147 [character]? (Comma-separated files)
3148
3149 =item How do I strip blank space from the beginning/end of a string?
3150
3151 =item How do I pad a string with blanks or pad a number with zeroes?
3152
3153 =item How do I extract selected columns from a string?
3154
3155 =item How do I find the soundex value of a string?
3156
3157 =item How can I expand variables in text strings?
3158
3159 =item What's wrong with always quoting "$vars"?
3160
3161 =item Why don't my <<HERE documents work?
3162
3163 1. There must be no space after the << part, 2. There (probably) should be
3164 a semicolon at the end, 3. You can't (easily) have any space in front of
3165 the tag
3166
3167 =back
3168
3169 =item Data: Arrays
3170
3171 =over 4
3172
3173 =item What is the difference between a list and an array?
3174
3175 =item What is the difference between $array[1] and @array[1]?
3176
3177 =item How can I remove duplicate elements from a list or array?
3178
3179 a), b), c), d), e)
3180
3181 =item How can I tell whether a certain element is contained in a list or
3182 array?
3183
3184 =item How do I compute the difference of two arrays?  How do I compute the
3185 intersection of two arrays?
3186
3187 =item How do I test whether two arrays or hashes are equal?
3188
3189 =item How do I find the first array element for which a condition is true?
3190
3191 =item How do I handle linked lists?
3192
3193 =item How do I handle circular lists?
3194
3195 =item How do I shuffle an array randomly?
3196
3197 =item How do I process/modify each element of an array?
3198
3199 =item How do I select a random element from an array?
3200
3201 =item How do I permute N elements of a list?
3202
3203 =item How do I sort an array by (anything)?
3204
3205 =item How do I manipulate arrays of bits?
3206
3207 =item Why does defined() return true on empty arrays and hashes?
3208
3209 =back
3210
3211 =item Data: Hashes (Associative Arrays)
3212
3213 =over 4
3214
3215 =item How do I process an entire hash?
3216
3217 =item What happens if I add or remove keys from a hash while iterating over
3218 it?
3219
3220 =item How do I look up a hash element by value?
3221
3222 =item How can I know how many entries are in a hash?
3223
3224 =item How do I sort a hash (optionally by value instead of key)?
3225
3226 =item How can I always keep my hash sorted?
3227
3228 =item What's the difference between "delete" and "undef" with hashes?
3229
3230 =item Why don't my tied hashes make the defined/exists distinction?
3231
3232 =item How do I reset an each() operation part-way through?
3233
3234 =item How can I get the unique keys from two hashes?
3235
3236 =item How can I store a multidimensional array in a DBM file?
3237
3238 =item How can I make my hash remember the order I put elements into it?
3239
3240 =item Why does passing a subroutine an undefined element in a hash create
3241 it?
3242
3243 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3244 array of hashes or arrays?
3245
3246 =item How can I use a reference as a hash key?
3247
3248 =back
3249
3250 =item Data: Misc
3251
3252 =over 4
3253
3254 =item How do I handle binary data correctly?
3255
3256 =item How do I determine whether a scalar is a number/whole/integer/float?
3257
3258 =item How do I keep persistent data across program calls?
3259
3260 =item How do I print out or copy a recursive data structure?
3261
3262 =item How do I define methods for every class/object?
3263
3264 =item How do I verify a credit card checksum?
3265
3266 =item How do I pack arrays of doubles or floats for XS code?
3267
3268 =back
3269
3270 =item AUTHOR AND COPYRIGHT
3271
3272 =back
3273
3274 =head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
3275 07:04:25 $)
3276
3277 =over 4
3278
3279 =item DESCRIPTION
3280
3281 =over 4
3282
3283 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3284
3285 =item How do I change one line in a file/delete a line in a file/insert a
3286 line in the middle of a file/append to the beginning of a file?
3287
3288 =item How do I count the number of lines in a file?
3289
3290 =item How do I make a temporary file name?
3291
3292 =item How can I manipulate fixed-record-length files?
3293
3294 =item How can I make a filehandle local to a subroutine?  How do I pass
3295 filehandles between subroutines?  How do I make an array of filehandles?
3296
3297 =item How can I use a filehandle indirectly?
3298
3299 =item How can I set up a footer format to be used with write()?
3300
3301 =item How can I write() into a string?
3302
3303 =item How can I output my numbers with commas added?
3304
3305 =item How can I translate tildes (~) in a filename?
3306
3307 =item How come when I open a file read-write it wipes it out?
3308
3309 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3310
3311 =item Is there a leak/bug in glob()?
3312
3313 =item How can I open a file with a leading ">" or trailing blanks?
3314
3315 =item How can I reliably rename a file?
3316
3317 =item How can I lock a file?
3318
3319 =item Why can't I just open(FH, ">file.lock")?
3320
3321 =item I still don't get locking.  I just want to increment the number in
3322 the file.  How can I do this?
3323
3324 =item All I want to do is append a small amount of text to the end of a
3325 file.  Do I still have to use locking?
3326
3327 =item How do I randomly update a binary file?
3328
3329 =item How do I get a file's timestamp in perl?
3330
3331 =item How do I set a file's timestamp in perl?
3332
3333 =item How do I print to more than one file at once?
3334
3335 =item How can I read in an entire file all at once?
3336
3337 =item How can I read in a file by paragraphs?
3338
3339 =item How can I read a single character from a file?  From the keyboard?
3340
3341 =item How can I tell whether there's a character waiting on a filehandle?
3342
3343 =item How do I do a C<tail -f> in perl?
3344
3345 =item How do I dup() a filehandle in Perl?
3346
3347 =item How do I close a file descriptor by number?
3348
3349 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3350 `C:\temp\foo.exe` work?
3351
3352 =item Why doesn't glob("*.*") get all the files?
3353
3354 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3355 protected files?  Isn't this a bug in Perl?
3356
3357 =item How do I select a random line from a file?
3358
3359 =item Why do I get weird spaces when I print an array of lines?
3360
3361 =back
3362
3363 =item AUTHOR AND COPYRIGHT
3364
3365 =back
3366
3367 =head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
3368 22:31:09 $)
3369
3370 =over 4
3371
3372 =item DESCRIPTION
3373
3374 =over 4
3375
3376 =item How can I hope to use regular expressions without creating illegible
3377 and unmaintainable code?
3378
3379 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3380
3381 =item I'm having trouble matching over more than one line.  What's wrong?
3382
3383 =item How can I pull out lines between two patterns that are themselves on
3384 different lines?
3385
3386 =item I put a regular expression into $/ but it didn't work. What's wrong?
3387
3388 =item How do I substitute case insensitively on the LHS while preserving
3389 case on the RHS?
3390
3391 =item How can I make C<\w> match national character sets?
3392
3393 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3394
3395 =item How can I quote a variable to use in a regex?
3396
3397 =item What is C</o> really for?
3398
3399 =item How do I use a regular expression to strip C style comments from a
3400 file?
3401
3402 =item Can I use Perl regular expressions to match balanced text?
3403
3404 =item What does it mean that regexes are greedy?  How can I get around it?
3405
3406 =item How do I process each word on each line?
3407
3408 =item How can I print out a word-frequency or line-frequency summary?
3409
3410 =item How can I do approximate matching?
3411
3412 =item How do I efficiently match many regular expressions at once?
3413
3414 =item Why don't word-boundary searches with C<\b> work for me?
3415
3416 =item Why does using $&, $`, or $' slow my program down?
3417
3418 =item What good is C<\G> in a regular expression?
3419
3420 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3421
3422 =item What's wrong with using grep or map in a void context?
3423
3424 =item How can I match strings with multibyte characters?
3425
3426 =item How do I match a pattern that is supplied by the user?
3427
3428 =back
3429
3430 =item AUTHOR AND COPYRIGHT
3431
3432 =back
3433
3434 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3435 2002/03/26 15:48:32 $)
3436
3437 =over 4
3438
3439 =item DESCRIPTION
3440
3441 =over 4
3442
3443 =item Can I get a BNF/yacc/RE for the Perl language?
3444
3445 =item What are all these $@%&* punctuation signs, and how do I know when to
3446 use them?
3447
3448 =item Do I always/never have to quote my strings or use semicolons and
3449 commas?
3450
3451 =item How do I skip some return values?
3452
3453 =item How do I temporarily block warnings?
3454
3455 =item What's an extension?
3456
3457 =item Why do Perl operators have different precedence than C operators?
3458
3459 =item How do I declare/create a structure?
3460
3461 =item How do I create a module?
3462
3463 =item How do I create a class?
3464
3465 =item How can I tell if a variable is tainted?
3466
3467 =item What's a closure?
3468
3469 =item What is variable suicide and how can I prevent it?
3470
3471 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3472 Regex}?
3473
3474 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3475 Passing Methods
3476
3477 =item How do I create a static variable?
3478
3479 =item What's the difference between dynamic and lexical (static) scoping? 
3480 Between local() and my()?
3481
3482 =item How can I access a dynamic variable while a similarly named lexical
3483 is in scope?
3484
3485 =item What's the difference between deep and shallow binding?
3486
3487 =item Why doesn't "my($foo) = <FILE>;" work right?
3488
3489 =item How do I redefine a builtin function, operator, or method?
3490
3491 =item What's the difference between calling a function as &foo and foo()?
3492
3493 =item How do I create a switch or case statement?
3494
3495 =item How can I catch accesses to undefined variables/functions/methods?
3496
3497 =item Why can't a method included in this same file be found?
3498
3499 =item How can I find out my current package?
3500
3501 =item How can I comment out a large block of perl code?
3502
3503 =item How do I clear a package?
3504
3505 =item How can I use a variable as a variable name?
3506
3507 =back
3508
3509 =item AUTHOR AND COPYRIGHT
3510
3511 =back
3512
3513 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3514 12:41:42 $)
3515
3516 =over 4
3517
3518 =item DESCRIPTION
3519
3520 =over 4
3521
3522 =item How do I find out which operating system I'm running under?
3523
3524 =item How come exec() doesn't return?
3525
3526 =item How do I do fancy stuff with the keyboard/screen/mouse?
3527
3528 Keyboard, Screen, Mouse
3529
3530 =item How do I print something out in color?
3531
3532 =item How do I read just one key without waiting for a return key?
3533
3534 =item How do I check whether input is ready on the keyboard?
3535
3536 =item How do I clear the screen?
3537
3538 =item How do I get the screen size?
3539
3540 =item How do I ask the user for a password?
3541
3542 =item How do I read and write the serial port?
3543
3544 lockfiles, open mode, end of line, flushing output, non-blocking input
3545
3546 =item How do I decode encrypted password files?
3547
3548 =item How do I start a process in the background?
3549
3550 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3551
3552 =item How do I trap control characters/signals?
3553
3554 =item How do I modify the shadow password file on a Unix system?
3555
3556 =item How do I set the time and date?
3557
3558 =item How can I sleep() or alarm() for under a second?
3559
3560 =item How can I measure time under a second?
3561
3562 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3563
3564 =item Why doesn't my sockets program work under System V (Solaris)?  What
3565 does the error message "Protocol not supported" mean?
3566
3567 =item How can I call my system's unique C functions from Perl?
3568
3569 =item Where do I get the include files to do ioctl() or syscall()?
3570
3571 =item Why do setuid perl scripts complain about kernel problems?
3572
3573 =item How can I open a pipe both to and from a command?
3574
3575 =item Why can't I get the output of a command with system()?
3576
3577 =item How can I capture STDERR from an external command?
3578
3579 =item Why doesn't open() return an error when a pipe open fails?
3580
3581 =item What's wrong with using backticks in a void context?
3582
3583 =item How can I call backticks without shell processing?
3584
3585 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3586 ^Z on MS-DOS)?
3587
3588 =item How can I convert my shell script to perl?
3589
3590 =item Can I use perl to run a telnet or ftp session?
3591
3592 =item How can I write expect in Perl?
3593
3594 =item Is there a way to hide perl's command line from programs such as
3595 "ps"?
3596
3597 =item I {changed directory, modified my environment} in a perl script.  How
3598 come the change disappeared when I exited the script?  How do I get my
3599 changes to be visible?
3600
3601 Unix
3602
3603 =item How do I close a process's filehandle without waiting for it to
3604 complete?
3605
3606 =item How do I fork a daemon process?
3607
3608 =item How do I find out if I'm running interactively or not?
3609
3610 =item How do I timeout a slow event?
3611
3612 =item How do I set CPU limits?
3613
3614 =item How do I avoid zombies on a Unix system?
3615
3616 =item How do I use an SQL database?
3617
3618 =item How do I make a system() exit on control-C?
3619
3620 =item How do I open a file without blocking?
3621
3622 =item How do I install a module from CPAN?
3623
3624 =item What's the difference between require and use?
3625
3626 =item How do I keep my own module/library directory?
3627
3628 =item How do I add the directory my program lives in to the module/library
3629 search path?
3630
3631 =item How do I add a directory to my include path at runtime?
3632
3633 =item What is socket.ph and where do I get it?
3634
3635 =back
3636
3637 =item AUTHOR AND COPYRIGHT
3638
3639 =back
3640
3641 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3642 $)
3643
3644 =over 4
3645
3646 =item DESCRIPTION
3647
3648 =over 4
3649
3650 =item What is the correct form of response from a CGI script?
3651
3652 =item My CGI script runs from the command line but not the browser.  (500
3653 Server Error)
3654
3655 =item How can I get better error messages from a CGI program?
3656
3657 =item How do I remove HTML from a string?
3658
3659 =item How do I extract URLs?
3660
3661 =item How do I download a file from the user's machine?  How do I open a
3662 file on another machine?
3663
3664 =item How do I make a pop-up menu in HTML?
3665
3666 =item How do I fetch an HTML file?
3667
3668 =item How do I automate an HTML form submission?
3669
3670 =item How do I decode or create those %-encodings on the web?
3671
3672 =item How do I redirect to another page?
3673
3674 =item How do I put a password on my web pages?
3675
3676 =item How do I edit my .htpasswd and .htgroup files with Perl?
3677
3678 =item How do I make sure users can't enter values into a form that cause my
3679 CGI script to do bad things?
3680
3681 =item How do I parse a mail header?
3682
3683 =item How do I decode a CGI form?
3684
3685 =item How do I check a valid mail address?
3686
3687 =item How do I decode a MIME/BASE64 string?
3688
3689 =item How do I return the user's mail address?
3690
3691 =item How do I send mail?
3692
3693 =item How do I use MIME to make an attachment to a mail message?
3694
3695 =item How do I read mail?
3696
3697 =item How do I find out my hostname/domainname/IP address?
3698
3699 =item How do I fetch a news article or the active newsgroups?
3700
3701 =item How do I fetch/put an FTP file?
3702
3703 =item How can I do RPC in Perl?
3704
3705 =back
3706
3707 =item AUTHOR AND COPYRIGHT
3708
3709 =back
3710
3711 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3712
3713 =over 4
3714
3715 =item DESCRIPTION
3716
3717 =over 4
3718
3719 =item Layout
3720
3721 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3722
3723 =back
3724
3725 =item Using The Back Ends
3726
3727 =over 4
3728
3729 =item The Cross Referencing Back End
3730
3731 i, &, s, r
3732
3733 =item The Decompiling Back End
3734
3735 =item The Lint Back End
3736
3737 =item The Simple C Back End
3738
3739 =item The Bytecode Back End
3740
3741 =item The Optimized C Back End
3742
3743 =back
3744
3745 =item Module List for the Compiler Suite
3746
3747 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3748 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3749 B::Stackobj, B::Stash, B::Terse, B::Xref
3750
3751 =item KNOWN PROBLEMS
3752
3753 =item AUTHOR
3754
3755 =back
3756
3757 =head2 perlembed - how to embed perl in your C program
3758
3759 =over 4
3760
3761 =item DESCRIPTION
3762
3763 =over 4
3764
3765 =item PREAMBLE
3766
3767 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3768 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3769
3770 =item ROADMAP
3771
3772 =item Compiling your C program
3773
3774 =item Adding a Perl interpreter to your C program
3775
3776 =item Calling a Perl subroutine from your C program
3777
3778 =item Evaluating a Perl statement from your C program
3779
3780 =item Performing Perl pattern matches and substitutions from your C program
3781
3782 =item Fiddling with the Perl stack from your C program
3783
3784 =item Maintaining a persistent interpreter
3785
3786 =item Execution of END blocks
3787
3788 =item Maintaining multiple interpreter instances
3789
3790 =item Using Perl modules, which themselves use C libraries, from your C
3791 program
3792
3793 =back
3794
3795 =item Embedding Perl under Win32
3796
3797 =item MORAL
3798
3799 =item AUTHOR
3800
3801 =item COPYRIGHT
3802
3803 =back
3804
3805 =head2 perldebguts - Guts of Perl debugging 
3806
3807 =over 4
3808
3809 =item DESCRIPTION
3810
3811 =item Debugger Internals
3812
3813 =over 4
3814
3815 =item Writing Your Own Debugger
3816
3817 =back
3818
3819 =item Frame Listing Output Examples
3820
3821 =item Debugging regular expressions
3822
3823 =over 4
3824
3825 =item Compile-time output
3826
3827 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3828 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3829 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3830 C<anchored(TYPE)>
3831
3832 =item Types of nodes
3833
3834 =item Run-time output
3835
3836 =back
3837
3838 =item Debugging Perl memory usage
3839
3840 =over 4
3841
3842 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3843
3844 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3845 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3846 6144>
3847
3848 =item Example of using B<-DL> switch
3849
3850 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3851
3852 =item B<-DL> details
3853
3854 C<!!!>, C<!!>, C<!>
3855
3856 =item Limitations of B<-DL> statistics
3857
3858 =back
3859
3860 =item SEE ALSO
3861
3862 =back
3863
3864 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3865
3866 =over 4
3867
3868 =item DESCRIPTION
3869
3870 =item SPECIAL NOTES
3871
3872 =over 4
3873
3874 =item make
3875
3876 =item Version caveat
3877
3878 =item Dynamic Loading versus Static Loading
3879
3880 =back
3881
3882 =item TUTORIAL
3883
3884 =over 4
3885
3886 =item EXAMPLE 1
3887
3888 =item EXAMPLE 2
3889
3890 =item What has gone on?
3891
3892 =item Writing good test scripts
3893
3894 =item EXAMPLE 3
3895
3896 =item What's new here?
3897
3898 =item Input and Output Parameters
3899
3900 =item The XSUBPP Program
3901
3902 =item The TYPEMAP file
3903
3904 =item Warning about Output Arguments
3905
3906 =item EXAMPLE 4
3907
3908 =item What has happened here?
3909
3910 =item Anatomy of .xs file
3911
3912 =item Getting the fat out of XSUBs
3913
3914 =item More about XSUB arguments
3915
3916 =item The Argument Stack
3917
3918 =item Extending your Extension
3919
3920 =item Documenting your Extension
3921
3922 =item Installing your Extension
3923
3924 =item EXAMPLE 5
3925
3926 =item New Things in this Example
3927
3928 =item EXAMPLE 6
3929
3930 =item New Things in this Example
3931
3932 =item EXAMPLE 7 (Coming Soon)
3933
3934 =item EXAMPLE 8 (Coming Soon)
3935
3936 =item EXAMPLE 9 Passing open files to XSes
3937
3938 =item Troubleshooting these Examples
3939
3940 =back
3941
3942 =item See also
3943
3944 =item Author
3945
3946 =over 4
3947
3948 =item Last Changed
3949
3950 =back
3951
3952 =back
3953
3954 =head2 perlxs - XS language reference manual
3955
3956 =over 4
3957
3958 =item DESCRIPTION
3959
3960 =over 4
3961
3962 =item Introduction
3963
3964 =item On The Road
3965
3966 =item The Anatomy of an XSUB
3967
3968 =item The Argument Stack
3969
3970 =item The RETVAL Variable
3971
3972 =item The MODULE Keyword
3973
3974 =item The PACKAGE Keyword
3975
3976 =item The PREFIX Keyword
3977
3978 =item The OUTPUT: Keyword
3979
3980 =item The NO_OUTPUT Keyword
3981
3982 =item The CODE: Keyword
3983
3984 =item The INIT: Keyword
3985
3986 =item The NO_INIT Keyword
3987
3988 =item Initializing Function Parameters
3989
3990 =item Default Parameter Values
3991
3992 =item The PREINIT: Keyword
3993
3994 =item The SCOPE: Keyword
3995
3996 =item The INPUT: Keyword
3997
3998 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3999
4000 =item The C<length(NAME)> Keyword
4001
4002 =item Variable-length Parameter Lists
4003
4004 =item The C_ARGS: Keyword
4005
4006 =item The PPCODE: Keyword
4007
4008 =item Returning Undef And Empty Lists
4009
4010 =item The REQUIRE: Keyword
4011
4012 =item The CLEANUP: Keyword
4013
4014 =item The POSTCALL: Keyword
4015
4016 =item The BOOT: Keyword
4017
4018 =item The VERSIONCHECK: Keyword
4019
4020 =item The PROTOTYPES: Keyword
4021
4022 =item The PROTOTYPE: Keyword
4023
4024 =item The ALIAS: Keyword
4025
4026 =item The OVERLOAD: Keyword
4027
4028 =item The INTERFACE: Keyword
4029
4030 =item The INTERFACE_MACRO: Keyword
4031
4032 =item The INCLUDE: Keyword
4033
4034 =item The CASE: Keyword
4035
4036 =item The & Unary Operator
4037
4038 =item Inserting POD, Comments and C Preprocessor Directives
4039
4040 =item Using XS With C++
4041
4042 =item Interface Strategy
4043
4044 =item Perl Objects And C Structures
4045
4046 =item The Typemap
4047
4048 =item Safely Storing Static Data in XS
4049
4050 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4051
4052 =back
4053
4054 =item EXAMPLES
4055
4056 =item XS VERSION
4057
4058 =item AUTHOR
4059
4060 =back
4061
4062 =head2 perlclib - Internal replacements for standard C library functions
4063
4064 =over 4
4065
4066 =item DESCRIPTION
4067
4068 =over 4
4069
4070 =item Conventions
4071
4072 C<t>, C<p>, C<n>, C<s>
4073
4074 =item File Operations
4075
4076 =item File Input and Output
4077
4078 =item File Positioning
4079
4080 =item Memory Management and String Handling
4081
4082 =item Character Class Tests
4083
4084 =item F<stdlib.h> functions
4085
4086 =item Miscellaneous functions
4087
4088 =back
4089
4090 =item SEE ALSO
4091
4092 =back
4093
4094 =head2 perlguts - Introduction to the Perl API
4095
4096 =over 4
4097
4098 =item DESCRIPTION
4099
4100 =item Variables
4101
4102 =over 4
4103
4104 =item Datatypes
4105
4106 =item What is an "IV"?
4107
4108 =item Working with SVs
4109
4110 =item Offsets
4111
4112 =item What's Really Stored in an SV?
4113
4114 =item Working with AVs
4115
4116 =item Working with HVs
4117
4118 =item Hash API Extensions
4119
4120 =item References
4121
4122 =item Blessed References and Class Objects
4123
4124 =item Creating New Variables
4125
4126 GV_ADDMULTI, GV_ADDWARN
4127
4128 =item Reference Counts and Mortality
4129
4130 =item Stashes and Globs
4131
4132 =item Double-Typed SVs
4133
4134 =item Magic Variables
4135
4136 =item Assigning Magic
4137
4138 =item Magic Virtual Tables
4139
4140 =item Finding Magic
4141
4142 =item Understanding the Magic of Tied Hashes and Arrays
4143
4144 =item Localizing changes
4145
4146 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4147 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4148 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4149 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4150 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4151 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4152 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4153 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4154 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4155 save_hptr(HV **hptr)>
4156
4157 =back
4158
4159 =item Subroutines
4160
4161 =over 4
4162
4163 =item XSUBs and the Argument Stack
4164
4165 =item Calling Perl Routines from within C Programs
4166
4167 =item Memory Allocation
4168
4169 =item PerlIO
4170
4171 =item Putting a C value on Perl stack
4172
4173 =item Scratchpads
4174
4175 =item Scratchpads and recursion
4176
4177 =back
4178
4179 =item Compiled code
4180
4181 =over 4
4182
4183 =item Code tree
4184
4185 =item Examining the tree
4186
4187 =item Compile pass 1: check routines
4188
4189 =item Compile pass 1a: constant folding
4190
4191 =item Compile pass 2: context propagation
4192
4193 =item Compile pass 3: peephole optimization
4194
4195 =item Pluggable runops
4196
4197 =back
4198
4199 =item Examining internal data structures with the C<dump> functions
4200
4201 =item How multiple interpreters and concurrency are supported
4202
4203 =over 4
4204
4205 =item Background and PERL_IMPLICIT_CONTEXT
4206
4207 =item So what happened to dTHR?
4208
4209 =item How do I use all this in extensions?
4210
4211 =item Should I do anything special if I call perl from multiple threads?
4212
4213 =item Future Plans and PERL_IMPLICIT_SYS
4214
4215 =back
4216
4217 =item Internal Functions
4218
4219 A, p, d, s, n, r, f, M, o, j, x
4220
4221 =over 4
4222
4223 =item Formatted Printing of IVs, UVs, and NVs
4224
4225 =item Pointer-To-Integer and Integer-To-Pointer
4226
4227 =item Source Documentation
4228
4229 =back
4230
4231 =item Unicode Support
4232
4233 =over 4
4234
4235 =item What B<is> Unicode, anyway?
4236
4237 =item How can I recognise a UTF8 string?
4238
4239 =item How does UTF8 represent Unicode characters?
4240
4241 =item How does Perl store UTF8 strings?
4242
4243 =item How do I convert a string to UTF8?
4244
4245 =item Is there anything else I need to know?
4246
4247 =back
4248
4249 =item Custom Operators
4250
4251 =item AUTHORS
4252
4253 =item SEE ALSO
4254
4255 =back
4256
4257 =head2 perlcall - Perl calling conventions from C
4258
4259 =over 4
4260
4261 =item DESCRIPTION
4262
4263 An Error Handler, An Event Driven Program
4264
4265 =item THE CALL_ FUNCTIONS
4266
4267 call_sv, call_pv, call_method, call_argv
4268
4269 =item FLAG VALUES
4270
4271 =over 4
4272
4273 =item  G_VOID
4274
4275 =item  G_SCALAR
4276
4277 =item G_ARRAY
4278
4279 =item G_DISCARD
4280
4281 =item G_NOARGS
4282
4283 =item G_EVAL
4284
4285 =item G_KEEPERR
4286
4287 =item Determining the Context
4288
4289 =back
4290
4291 =item KNOWN PROBLEMS
4292
4293 =item EXAMPLES
4294
4295 =over 4
4296
4297 =item No Parameters, Nothing returned
4298
4299 =item Passing Parameters
4300
4301 =item Returning a Scalar
4302
4303 =item Returning a list of values
4304
4305 =item Returning a list in a scalar context
4306
4307 =item Returning Data from Perl via the parameter list
4308
4309 =item Using G_EVAL
4310
4311 =item Using G_KEEPERR
4312
4313 =item Using call_sv
4314
4315 =item Using call_argv
4316
4317 =item Using call_method
4318
4319 =item Using GIMME_V
4320
4321 =item Using Perl to dispose of temporaries
4322
4323 =item Strategies for storing Callback Context Information
4324
4325 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4326 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4327 callback
4328
4329 =item Alternate Stack Manipulation
4330
4331 =item Creating and calling an anonymous subroutine in C
4332
4333 =back
4334
4335 =item SEE ALSO
4336
4337 =item AUTHOR
4338
4339 =item DATE
4340
4341 =back
4342
4343 =head2 perlutil - utilities packaged with the Perl distribution
4344
4345 =over 4
4346
4347 =item DESCRIPTION
4348
4349 =over 4
4350
4351 =item DOCUMENTATION
4352
4353 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4354 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4355 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4356 L<roffitall|roffitall>
4357
4358 =item CONVERTORS
4359
4360 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4361
4362 =item Administration
4363
4364 L<libnetcfg|libnetcfg>
4365
4366 =item Development
4367
4368 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4369 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4370
4371 =item SEE ALSO
4372
4373 =back
4374
4375 =back
4376
4377 =head2 perlfilter - Source Filters
4378
4379 =over 4
4380
4381 =item DESCRIPTION
4382
4383 =item CONCEPTS
4384
4385 =item USING FILTERS
4386
4387 =item WRITING A SOURCE FILTER
4388
4389 =item WRITING A SOURCE FILTER IN C
4390
4391 B<Decryption Filters>
4392
4393 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4394
4395 =item WRITING A SOURCE FILTER IN PERL
4396
4397 =item USING CONTEXT: THE DEBUG FILTER
4398
4399 =item CONCLUSION
4400
4401 =item REQUIREMENTS
4402
4403 =item AUTHOR
4404
4405 =item Copyrights
4406
4407 =back
4408
4409 =head2 perldbmfilter - Perl DBM Filters
4410
4411 =over 4
4412
4413 =item SYNOPSIS
4414
4415 =item DESCRIPTION
4416
4417 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4418 B<filter_fetch_value>
4419
4420 =over 4
4421
4422 =item The Filter
4423
4424 =item An Example -- the NULL termination problem.
4425
4426 =item Another Example -- Key is a C int.
4427
4428 =back
4429
4430 =item SEE ALSO
4431
4432 =item AUTHOR
4433
4434 =back
4435
4436 =head2 perlapi - autogenerated documentation for the perl public API
4437
4438 =over 4
4439
4440 =item DESCRIPTION
4441
4442 =item "Gimme" Values
4443
4444 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4445
4446 =item Array Manipulation Functions
4447
4448 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4449 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4450 get_av, newAV, Nullav, sortsv
4451
4452 =item Callback Functions
4453
4454 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4455 FREETMPS, LEAVE, SAVETMPS
4456
4457 =item Character classes
4458
4459 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4460
4461 =item Cloning an interpreter
4462
4463 perl_clone
4464
4465 =item CV Manipulation Functions
4466
4467 CvSTASH, get_cv, Nullcv
4468
4469 =item Embedding Functions
4470
4471 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4472 perl_free, perl_parse, perl_run, require_pv
4473
4474 =item Functions in file pp_pack.c
4475
4476 pack_cat, unpack_str
4477
4478 =item Global Variables
4479
4480 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4481
4482 =item GV Functions
4483
4484 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4485 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4486
4487 =item Handy Values
4488
4489 HEf_SVKEY, Nullch, Nullsv
4490
4491 =item Hash Manipulation Functions
4492
4493 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4494 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4495 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4496 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4497 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4498
4499 =item Magical Functions
4500
4501 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4502 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4503 SvSetSV, SvSetSV_nosteal, SvSHARE
4504
4505 =item Memory Management
4506
4507 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4508 savepv, savepvn, savesharedpv, StructCopy, Zero
4509
4510 =item Miscellaneous Functions
4511
4512 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4513 strNE, strnEQ, strnNE
4514
4515 =item Numeric functions
4516
4517 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4518 scan_hex, scan_oct
4519
4520 =item Optree Manipulation Functions
4521
4522 cv_const_sv, newCONSTSUB, newXS
4523
4524 =item Stack Manipulation Macros
4525
4526 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4527 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4528 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4529 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4530 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4531
4532 =item SV Flags
4533
4534 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4535
4536 =item SV Manipulation Functions
4537
4538 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4539 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4540 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4541 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4542 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4543 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4544 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4545 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4546 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4547 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4548 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4549 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4550 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4551 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4552 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4553 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4554 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4555 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4556 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4557 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4558 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4559 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4560 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4561 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4562 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4563 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4564 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4565 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4566 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4567 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4568 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4569 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4570 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4571
4572 =item Unicode Support
4573
4574 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4575 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4576 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4577 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4578 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4579
4580 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4581
4582 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4583 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4584
4585 =item Warning and Dieing
4586
4587 croak, warn
4588
4589 =item AUTHORS
4590
4591 =item SEE ALSO
4592
4593 =back
4594
4595 =head2 perlintern - autogenerated documentation of purely B<internal>
4596                  Perl functions
4597
4598 =over 4
4599
4600 =item DESCRIPTION
4601
4602 =item Global Variables
4603
4604 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4605 PL_rs
4606
4607 =item GV Functions
4608
4609 is_gv_magical
4610
4611 =item IO Functions
4612
4613 start_glob
4614
4615 =item Pad Data Structures
4616
4617 CvPADLIST
4618
4619 =item Stack Manipulation Macros
4620
4621 djSP, LVRET
4622
4623 =item SV Manipulation Functions
4624
4625 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4626
4627 =item AUTHORS
4628
4629 =item SEE ALSO
4630
4631 =back
4632
4633 =head2 perliol - C API for Perl's implementation of IO in Layers.
4634
4635 =over 4
4636
4637 =item SYNOPSIS
4638
4639 =item DESCRIPTION
4640
4641 =over 4
4642
4643 =item History and Background
4644
4645 =item Layers vs Disciplines
4646
4647 =item Data Structures
4648
4649 =item Functions and Attributes
4650
4651 =item Per-instance Data
4652
4653 =item Layers in action.
4654
4655 =item Per-instance flag bits
4656
4657 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4658 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4659 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4660 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4661
4662 =item Methods in Detail
4663
4664 name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
4665 PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
4666 Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
4667 Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, 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,flags)>, B<PerlIO_exportFILE(f,flags)>,
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 ext/threads/t/libc
5351
5352 =item FreeBSD built with ithreads coredumps reading large directories
5353
5354 =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
5355
5356 =item IRIX fails ext/List/Util/t/shuffle.t
5357
5358 =item Modifying $_ Inside for(..)
5359
5360 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5361
5362 =item lib/ftmp-security tests warn 'system possibly insecure'
5363
5364 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5365
5366 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5367
5368 =item Linux With Sfio Fails op/misc Test 48
5369
5370 =item libwww-perl (LWP) fails base/date #51
5371
5372 =item Mac OS X
5373
5374 =item op/sprintf tests 91, 129, and 130
5375
5376 =item Solaris 2.5
5377
5378 =item Solaris x86 Fails Tests With -Duse64bitint
5379
5380 =item SUPER-UX (NEC SX)
5381
5382 =item PDL failing some tests
5383
5384 =item Term::ReadKey not working on Win32
5385
5386 =item Failure of Thread (5.005-style) tests
5387
5388 =item Timing problems
5389
5390 =item UNICOS/mk
5391
5392 =item UTS
5393
5394 =item VOS (Stratus)
5395
5396 =item VMS
5397
5398 =item Win32
5399
5400 =item XML::Parser not working
5401
5402 =item z/OS (OS/390)
5403
5404 =item Localising Tied Arrays and Hashes Is Broken
5405
5406 =item Self-tying Problems
5407
5408 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5409
5410 =item Building Extensions Can Fail Because Of Largefiles
5411
5412 =item Unicode Support on EBCDIC Still Spotty
5413
5414 =item The Compiler Suite Is Still Very Experimental
5415
5416 =item The Long Double Support Is Still Experimental
5417
5418 =item Seen In Perl 5.7 But Gone Now
5419
5420 =back
5421
5422 =item Reporting Bugs
5423
5424 =item SEE ALSO
5425
5426 =item HISTORY
5427
5428 =back
5429
5430 =head2 perl572delta - what's new for perl v5.7.2
5431
5432 =over 4
5433
5434 =item DESCRIPTION
5435
5436 =item Security Vulnerability Closed
5437
5438 =item Incompatible Changes
5439
5440 =over 4
5441
5442 =item 64-bit platforms and malloc
5443
5444 =item AIX Dynaloading
5445
5446 =item Socket Extension Dynamic in VMS
5447
5448 =item Different Definition of the Unicode Character Classes \p{In...}
5449
5450 =item Deprecations
5451
5452 =back
5453
5454 =item Core Enhancements
5455
5456 =item Modules and Pragmata
5457
5458 =over 4
5459
5460 =item New Modules and Distributions
5461
5462 =item Updated And Improved Modules and Pragmata
5463
5464 =back
5465
5466 =item Utility Changes
5467
5468 =item New Documentation
5469
5470 =item Installation and Configuration Improvements
5471
5472 =over 4
5473
5474 =item New Or Improved Platforms
5475
5476 =item Generic Improvements
5477
5478 =back
5479
5480 =item Selected Bug Fixes
5481
5482 =over 4
5483
5484 =item Platform Specific Changes and Fixes
5485
5486 =back
5487
5488 =item New or Changed Diagnostics
5489
5490 =item Source Code Enhancements
5491
5492 =over 4
5493
5494 =item MAGIC constants
5495
5496 =item Better commented code
5497
5498 =item Regex pre-/post-compilation items matched up
5499
5500 =item gcc -Wall
5501
5502 =back
5503
5504 =item New Tests
5505
5506 =item Known Problems
5507
5508 =over 4
5509
5510 =item AIX
5511
5512 =item Amiga Perl Invoking Mystery
5513
5514 =item lib/ftmp-security tests warn 'system possibly insecure'
5515
5516 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5517
5518 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5519
5520 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5521
5522 =item Linux With Sfio Fails op/misc Test 48
5523
5524 =item OS/390
5525
5526 =item op/sprintf tests 129 and 130
5527
5528 =item  Failure of Thread tests
5529
5530 =item UNICOS
5531
5532 =item UTS
5533
5534 =item VMS
5535
5536 =item Win32
5537
5538 =item Localising a Tied Variable Leaks Memory
5539
5540 =item Self-tying of Arrays and Hashes Is Forbidden
5541
5542 =item Variable Attributes are not Currently Usable for Tieing
5543
5544 =item Building Extensions Can Fail Because Of Largefiles
5545
5546 =item The Compiler Suite Is Still Experimental
5547
5548 =item The Long Double Support is Still Experimental
5549
5550 =back
5551
5552 =item Reporting Bugs
5553
5554 =item SEE ALSO
5555
5556 =item HISTORY
5557
5558 =back
5559
5560 =head2 perl571delta - what's new for perl v5.7.1
5561
5562 =over 4
5563
5564 =item DESCRIPTION
5565
5566 =item Security Vulnerability Closed
5567
5568 =item Incompatible Changes
5569
5570 =item Core Enhancements
5571
5572 =over 4
5573
5574 =item AUTOLOAD Is Now Lvaluable
5575
5576 =item PerlIO is Now The Default
5577
5578 =item Signals Are Now Safe
5579
5580 =back
5581
5582 =item Modules and Pragmata
5583
5584 =over 4
5585
5586 =item New Modules
5587
5588 =item Updated And Improved Modules and Pragmata
5589
5590 =back
5591
5592 =item Performance Enhancements
5593
5594 =item Utility Changes
5595
5596 =item New Documentation
5597
5598 =over 4
5599
5600 =item perlclib
5601
5602 =item perliol
5603
5604 =item README.aix
5605
5606 =item README.bs2000
5607
5608 =item README.macos
5609
5610 =item README.mpeix
5611
5612 =item README.solaris
5613
5614 =item README.vos
5615
5616 =item Porting/repository.pod
5617
5618 =back
5619
5620 =item Installation and Configuration Improvements
5621
5622 =over 4
5623
5624 =item New Or Improved Platforms
5625
5626 =item Generic Improvements
5627
5628 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5629 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5630 d_strtoq, d_u32align, d_ualarm, d_usleep
5631
5632 =back
5633
5634 =item Selected Bug Fixes
5635
5636 =over 4
5637
5638 =item Platform Specific Changes and Fixes
5639
5640 =back
5641
5642 =item New or Changed Diagnostics
5643
5644 =item Changed Internals
5645
5646 =item New Tests
5647
5648 =item Known Problems
5649
5650 =over 4
5651
5652 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5653
5654 =item lib/ftmp-security tests warn 'system possibly insecure'
5655
5656 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5657
5658 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5659
5660 =item lib/b test 19
5661
5662 =item Linux With Sfio Fails op/misc Test 48
5663
5664 =item sigaction test 13 in VMS
5665
5666 =item sprintf tests 129 and 130
5667
5668 =item  Failure of Thread tests
5669
5670 =item Localising a Tied Variable Leaks Memory
5671
5672 =item Self-tying of Arrays and Hashes Is Forbidden
5673
5674 =item Building Extensions Can Fail Because Of Largefiles
5675
5676 =item The Compiler Suite Is Still Experimental
5677
5678 =back
5679
5680 =item Reporting Bugs
5681
5682 =item SEE ALSO
5683
5684 =item HISTORY
5685
5686 =back
5687
5688 =head2 perl570delta - what's new for perl v5.7.0
5689
5690 =over 4
5691
5692 =item DESCRIPTION
5693
5694 =item Security Vulnerability Closed
5695
5696 =item Incompatible Changes
5697
5698 =item Core Enhancements
5699
5700 =item Modules and Pragmata
5701
5702 =over 4
5703
5704 =item New Modules
5705
5706 =item Updated And Improved Modules and Pragmata
5707
5708 =back
5709
5710 =item Utility Changes
5711
5712 =item New Documentation
5713
5714 =item Performance Enhancements
5715
5716 =item Installation and Configuration Improvements
5717
5718 =over 4
5719
5720 =item Generic Improvements
5721
5722 =back
5723
5724 =item Selected Bug Fixes
5725
5726 =over 4
5727
5728 =item Platform Specific Changes and Fixes
5729
5730 =back
5731
5732 =item New or Changed Diagnostics
5733
5734 =item Changed Internals
5735
5736 =item Known Problems
5737
5738 =over 4
5739
5740 =item Unicode Support Still Far From Perfect
5741
5742 =item EBCDIC Still A Lost Platform
5743
5744 =item Building Extensions Can Fail Because Of Largefiles
5745
5746 =item ftmp-security tests warn 'system possibly insecure'
5747
5748 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5749
5750 =item Long Doubles Still Don't Work In Solaris
5751
5752 =item Linux With Sfio Fails op/misc Test 48
5753
5754 =item Storable tests fail in some platforms
5755
5756 =item Threads Are Still Experimental
5757
5758 =item The Compiler Suite Is Still Experimental
5759
5760 =back
5761
5762 =item Reporting Bugs
5763
5764 =item SEE ALSO
5765
5766 =item HISTORY
5767
5768 =back
5769
5770 =head2 perl561delta - what's new for perl v5.6.x
5771
5772 =over 4
5773
5774 =item DESCRIPTION
5775
5776 =item Summary of changes between 5.6.0 and 5.6.1
5777
5778 =over 4
5779
5780 =item Security Issues
5781
5782 =item Core bug fixes
5783
5784 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5785 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5786 references to special variables, Lexical warnings, Spurious warnings and
5787 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5788 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5789 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5790 Module;>, Tests
5791
5792 =item Core features
5793
5794 =item Configuration issues
5795
5796 =item Documentation
5797
5798 =item Bundled modules
5799
5800 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5801 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5802 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5803 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5804
5805 =item Platform-specific improvements
5806
5807 NCR MP-RAS, NonStop-UX
5808
5809 =back
5810
5811 =item Core Enhancements
5812
5813 =over 4
5814
5815 =item Interpreter cloning, threads, and concurrency
5816
5817 =item Lexically scoped warning categories
5818
5819 =item Unicode and UTF-8 support
5820
5821 =item Support for interpolating named characters
5822
5823 =item "our" declarations
5824
5825 =item Support for strings represented as a vector of ordinals
5826
5827 =item Improved Perl version numbering system
5828
5829 =item New syntax for declaring subroutine attributes
5830
5831 =item File and directory handles can be autovivified
5832
5833 =item open() with more than two arguments
5834
5835 =item 64-bit support
5836
5837 =item Large file support
5838
5839 =item Long doubles
5840
5841 =item "more bits"
5842
5843 =item Enhanced support for sort() subroutines
5844
5845 =item C<sort $coderef @foo> allowed
5846
5847 =item File globbing implemented internally
5848
5849 =item Support for CHECK blocks
5850
5851 =item POSIX character class syntax [: :] supported
5852
5853 =item Better pseudo-random number generator
5854
5855 =item Improved C<qw//> operator
5856
5857 =item Better worst-case behavior of hashes
5858
5859 =item pack() format 'Z' supported
5860
5861 =item pack() format modifier '!' supported
5862
5863 =item pack() and unpack() support counted strings
5864
5865 =item Comments in pack() templates
5866
5867 =item Weak references
5868
5869 =item Binary numbers supported
5870
5871 =item Lvalue subroutines
5872
5873 =item Some arrows may be omitted in calls through references
5874
5875 =item Boolean assignment operators are legal lvalues
5876
5877 =item exists() is supported on subroutine names
5878
5879 =item exists() and delete() are supported on array elements
5880
5881 =item Pseudo-hashes work better
5882
5883 =item Automatic flushing of output buffers
5884
5885 =item Better diagnostics on meaningless filehandle operations
5886
5887 =item Where possible, buffered data discarded from duped input filehandle
5888
5889 =item eof() has the same old magic as <>
5890
5891 =item binmode() can be used to set :crlf and :raw modes
5892
5893 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5894
5895 =item system(), backticks and pipe open now reflect exec() failure
5896
5897 =item Improved diagnostics
5898
5899 =item Diagnostics follow STDERR
5900
5901 =item More consistent close-on-exec behavior
5902
5903 =item syswrite() ease-of-use
5904
5905 =item Better syntax checks on parenthesized unary operators
5906
5907 =item Bit operators support full native integer width
5908
5909 =item Improved security features
5910
5911 =item More functional bareword prototype (*)
5912
5913 =item C<require> and C<do> may be overridden
5914
5915 =item $^X variables may now have names longer than one character
5916
5917 =item New variable $^C reflects C<-c> switch
5918
5919 =item New variable $^V contains Perl version as a string
5920
5921 =item Optional Y2K warnings
5922
5923 =item Arrays now always interpolate into double-quoted strings
5924
5925 =back
5926
5927 =item Modules and Pragmata
5928
5929 =over 4
5930
5931 =item Modules
5932
5933 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5934 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5935 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5936 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5937 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5938 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5939 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5940 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5941
5942 =item Pragmata
5943
5944 =back
5945
5946 =item Utility Changes
5947
5948 =over 4
5949
5950 =item dprofpp
5951
5952 =item find2perl
5953
5954 =item h2xs
5955
5956 =item perlcc
5957
5958 =item perldoc
5959
5960 =item The Perl Debugger
5961
5962 =back
5963
5964 =item Improved Documentation
5965
5966 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5967 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5968 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5969 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5970
5971 =item Performance enhancements
5972
5973 =over 4
5974
5975 =item Simple sort() using { $a <=> $b } and the like are optimized
5976
5977 =item Optimized assignments to lexical variables
5978
5979 =item Faster subroutine calls
5980
5981 =item delete(), each(), values() and hash iteration are faster
5982
5983 =back
5984
5985 =item Installation and Configuration Improvements
5986
5987 =over 4
5988
5989 =item -Dusethreads means something different
5990
5991 =item New Configure flags
5992
5993 =item Threadedness and 64-bitness now more daring
5994
5995 =item Long Doubles
5996
5997 =item -Dusemorebits
5998
5999 =item -Duselargefiles
6000
6001 =item installusrbinperl
6002
6003 =item SOCKS support
6004
6005 =item C<-A> flag
6006
6007 =item Enhanced Installation Directories
6008
6009 =item gcc automatically tried if 'cc' does not seem to be working
6010
6011 =back
6012
6013 =item Platform specific changes
6014
6015 =over 4
6016
6017 =item Supported platforms
6018
6019 =item DOS
6020
6021 =item OS390 (OpenEdition MVS)
6022
6023 =item VMS
6024
6025 =item Win32
6026
6027 =back
6028
6029 =item Significant bug fixes
6030
6031 =over 4
6032
6033 =item <HANDLE> on empty files
6034
6035 =item C<eval '...'> improvements
6036
6037 =item All compilation errors are true errors
6038
6039 =item Implicitly closed filehandles are safer
6040
6041 =item Behavior of list slices is more consistent
6042
6043 =item C<(\$)> prototype and C<$foo{a}>
6044
6045 =item C<goto &sub> and AUTOLOAD
6046
6047 =item C<-bareword> allowed under C<use integer>
6048
6049 =item Failures in DESTROY()
6050
6051 =item Locale bugs fixed
6052
6053 =item Memory leaks
6054
6055 =item Spurious subroutine stubs after failed subroutine calls
6056
6057 =item Taint failures under C<-U>
6058
6059 =item END blocks and the C<-c> switch
6060
6061 =item Potential to leak DATA filehandles
6062
6063 =back
6064
6065 =item New or Changed Diagnostics
6066
6067 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6068 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6069 / cannot take a count, / must be followed by a, A or Z, / must be followed
6070 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6071 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6072 passed through, /%s/ should probably be written as "%s", %s() called too
6073 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6074 argument is not a HASH or ARRAY element or slice, %s argument is not a
6075 subroutine name, %s package attribute may clash with future reserved word:
6076 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6077 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6078 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6079 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6080 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6081 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6082 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6083 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6084 weaken a nonreference, Character class [:%s:] unknown, Character class
6085 syntax [%s] belongs inside character classes, Constant is not %s reference,
6086 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6087 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6088 "local" instead of "our"?), Document contains no data, entering effective
6089 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6090 output, flock() on closed filehandle %s, Global symbol "%s" requires
6091 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6092 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6093 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6094 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6095 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6096 separator character %s in attribute list, Invalid separator character %s in
6097 subroutine attribute list, leaving effective %s failed, Lvalue subs
6098 returning %s not implemented yet, Method %s not permitted, Missing
6099 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6100 No %s specified for -%c, No package name allowed for variable %s in "our",
6101 No space allowed after -%c, no UTC offset information; assuming local time
6102 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6103 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6104 around "%s" list, Possible unintended interpolation of %s in string,
6105 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6106 instead, Premature end of script headers, Repeat count in pack overflows,
6107 Repeat count in unpack overflows, realloc() of freed memory ignored,
6108 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6109 zero-length expression, switching effective %s is not implemented, This
6110 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6111 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6112 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6113 escape \\%c passed through, Unterminated attribute parameter in attribute
6114 list, Unterminated attribute list, Unterminated attribute parameter in
6115 subroutine attribute list, Unterminated subroutine attribute list, Value of
6116 CLI symbol "%s" too long, Version number must be a constant number
6117
6118 =item New tests
6119
6120 =item Incompatible Changes
6121
6122 =over 4
6123
6124 =item Perl Source Incompatibilities
6125
6126 CHECK is a new keyword, Treatment of list slices of undef has changed,
6127 Format of $English::PERL_VERSION is different, Literals of the form
6128 C<1.2.3> parse differently, Possibly changed pseudo-random number
6129 generator, Hashing function for hash keys has changed, C<undef> fails on
6130 read only values, Close-on-exec bit may be set on pipe and socket handles,
6131 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6132 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6133 Text of some diagnostic output has changed, C<%@> has been removed,
6134 Parenthesized not() behaves like a list operator, Semantics of bareword
6135 prototype C<(*)> have changed, Semantics of bit operators may have changed
6136 on 64-bit platforms, More builtins taint their results
6137
6138 =item C Source Incompatibilities
6139
6140 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6141
6142 =item Compatible C Source API Changes
6143
6144 C<PATCHLEVEL> is now C<PERL_VERSION>
6145
6146 =item Binary Incompatibilities
6147
6148 =back
6149
6150 =item Known Problems
6151
6152 =over 4
6153
6154 =item Localizing a tied hash element may leak memory
6155
6156 =item Known test failures
6157
6158 =item EBCDIC platforms not fully supported
6159
6160 =item UNICOS/mk CC failures during Configure run
6161
6162 =item Arrow operator and arrays
6163
6164 =item Experimental features
6165
6166 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6167 pseudo-hash data type, The Compiler suite, Internal implementation of file
6168 globbing, The DB module, The regular expression code constructs:
6169
6170 =back
6171
6172 =item Obsolete Diagnostics
6173
6174 Character class syntax [: :] is reserved for future extensions, Ill-formed
6175 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6176 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6177 to mean "${$}<digit>" is deprecated
6178
6179 =item Reporting Bugs
6180
6181 =item SEE ALSO
6182
6183 =item HISTORY
6184
6185 =back
6186
6187 =head2 perl56delta - what's new for perl v5.6.0
6188
6189 =over 4
6190
6191 =item DESCRIPTION
6192
6193 =item Core Enhancements
6194
6195 =over 4
6196
6197 =item Interpreter cloning, threads, and concurrency
6198
6199 =item Lexically scoped warning categories
6200
6201 =item Unicode and UTF-8 support
6202
6203 =item Support for interpolating named characters
6204
6205 =item "our" declarations
6206
6207 =item Support for strings represented as a vector of ordinals
6208
6209 =item Improved Perl version numbering system
6210
6211 =item New syntax for declaring subroutine attributes
6212
6213 =item File and directory handles can be autovivified
6214
6215 =item open() with more than two arguments
6216
6217 =item 64-bit support
6218
6219 =item Large file support
6220
6221 =item Long doubles
6222
6223 =item "more bits"
6224
6225 =item Enhanced support for sort() subroutines
6226
6227 =item C<sort $coderef @foo> allowed
6228
6229 =item File globbing implemented internally
6230
6231 =item Support for CHECK blocks
6232
6233 =item POSIX character class syntax [: :] supported
6234
6235 =item Better pseudo-random number generator
6236
6237 =item Improved C<qw//> operator
6238
6239 =item Better worst-case behavior of hashes
6240
6241 =item pack() format 'Z' supported
6242
6243 =item pack() format modifier '!' supported
6244
6245 =item pack() and unpack() support counted strings
6246
6247 =item Comments in pack() templates
6248
6249 =item Weak references
6250
6251 =item Binary numbers supported
6252
6253 =item Lvalue subroutines
6254
6255 =item Some arrows may be omitted in calls through references
6256
6257 =item Boolean assignment operators are legal lvalues
6258
6259 =item exists() is supported on subroutine names
6260
6261 =item exists() and delete() are supported on array elements
6262
6263 =item Pseudo-hashes work better
6264
6265 =item Automatic flushing of output buffers
6266
6267 =item Better diagnostics on meaningless filehandle operations
6268
6269 =item Where possible, buffered data discarded from duped input filehandle
6270
6271 =item eof() has the same old magic as <>
6272
6273 =item binmode() can be used to set :crlf and :raw modes
6274
6275 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6276
6277 =item system(), backticks and pipe open now reflect exec() failure
6278
6279 =item Improved diagnostics
6280
6281 =item Diagnostics follow STDERR
6282
6283 =item More consistent close-on-exec behavior
6284
6285 =item syswrite() ease-of-use
6286
6287 =item Better syntax checks on parenthesized unary operators
6288
6289 =item Bit operators support full native integer width
6290
6291 =item Improved security features
6292
6293 =item More functional bareword prototype (*)
6294
6295 =item C<require> and C<do> may be overridden
6296
6297 =item $^X variables may now have names longer than one character
6298
6299 =item New variable $^C reflects C<-c> switch
6300
6301 =item New variable $^V contains Perl version as a string
6302
6303 =item Optional Y2K warnings
6304
6305 =item Arrays now always interpolate into double-quoted strings
6306
6307 =back
6308
6309 =item Modules and Pragmata
6310
6311 =over 4
6312
6313 =item Modules
6314
6315 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6316 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6317 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6318 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6319 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6320 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6321 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6322 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6323
6324 =item Pragmata
6325
6326 =back
6327
6328 =item Utility Changes
6329
6330 =over 4
6331
6332 =item dprofpp
6333
6334 =item find2perl
6335
6336 =item h2xs
6337
6338 =item perlcc
6339
6340 =item perldoc
6341
6342 =item The Perl Debugger
6343
6344 =back
6345
6346 =item Improved Documentation
6347
6348 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6349 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6350 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6351 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6352
6353 =item Performance enhancements
6354
6355 =over 4
6356
6357 =item Simple sort() using { $a <=> $b } and the like are optimized
6358
6359 =item Optimized assignments to lexical variables
6360
6361 =item Faster subroutine calls
6362
6363 =item delete(), each(), values() and hash iteration are faster
6364
6365 =back
6366
6367 =item Installation and Configuration Improvements
6368
6369 =over 4
6370
6371 =item -Dusethreads means something different
6372
6373 =item New Configure flags
6374
6375 =item Threadedness and 64-bitness now more daring
6376
6377 =item Long Doubles
6378
6379 =item -Dusemorebits
6380
6381 =item -Duselargefiles
6382
6383 =item installusrbinperl
6384
6385 =item SOCKS support
6386
6387 =item C<-A> flag
6388
6389 =item Enhanced Installation Directories
6390
6391 =back
6392
6393 =item Platform specific changes
6394
6395 =over 4
6396
6397 =item Supported platforms
6398
6399 =item DOS
6400
6401 =item OS390 (OpenEdition MVS)
6402
6403 =item VMS
6404
6405 =item Win32
6406
6407 =back
6408
6409 =item Significant bug fixes
6410
6411 =over 4
6412
6413 =item <HANDLE> on empty files
6414
6415 =item C<eval '...'> improvements
6416
6417 =item All compilation errors are true errors
6418
6419 =item Implicitly closed filehandles are safer
6420
6421 =item Behavior of list slices is more consistent
6422
6423 =item C<(\$)> prototype and C<$foo{a}>
6424
6425 =item C<goto &sub> and AUTOLOAD
6426
6427 =item C<-bareword> allowed under C<use integer>
6428
6429 =item Failures in DESTROY()
6430
6431 =item Locale bugs fixed
6432
6433 =item Memory leaks
6434
6435 =item Spurious subroutine stubs after failed subroutine calls
6436
6437 =item Taint failures under C<-U>
6438
6439 =item END blocks and the C<-c> switch
6440
6441 =item Potential to leak DATA filehandles
6442
6443 =back
6444
6445 =item New or Changed Diagnostics
6446
6447 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6448 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6449 / cannot take a count, / must be followed by a, A or Z, / must be followed
6450 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6451 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6452 passed through, /%s/ should probably be written as "%s", %s() called too
6453 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6454 argument is not a HASH or ARRAY element or slice, %s argument is not a
6455 subroutine name, %s package attribute may clash with future reserved word:
6456 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6457 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6458 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6459 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6460 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6461 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6462 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6463 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6464 weaken a nonreference, Character class [:%s:] unknown, Character class
6465 syntax [%s] belongs inside character classes, Constant is not %s reference,
6466 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6467 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6468 "local" instead of "our"?), Document contains no data, entering effective
6469 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6470 output, flock() on closed filehandle %s, Global symbol "%s" requires
6471 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6472 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6473 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6474 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6475 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6476 separator character %s in attribute list, Invalid separator character %s in
6477 subroutine attribute list, leaving effective %s failed, Lvalue subs
6478 returning %s not implemented yet, Method %s not permitted, Missing
6479 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6480 No %s specified for -%c, No package name allowed for variable %s in "our",
6481 No space allowed after -%c, no UTC offset information; assuming local time
6482 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6483 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6484 around "%s" list, Possible unintended interpolation of %s in string,
6485 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6486 instead, Premature end of script headers, Repeat count in pack overflows,
6487 Repeat count in unpack overflows, realloc() of freed memory ignored,
6488 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6489 zero-length expression, switching effective %s is not implemented, This
6490 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6491 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6492 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6493 escape \\%c passed through, Unterminated attribute parameter in attribute
6494 list, Unterminated attribute list, Unterminated attribute parameter in
6495 subroutine attribute list, Unterminated subroutine attribute list, Value of
6496 CLI symbol "%s" too long, Version number must be a constant number
6497
6498 =item New tests
6499
6500 =item Incompatible Changes
6501
6502 =over 4
6503
6504 =item Perl Source Incompatibilities
6505
6506 CHECK is a new keyword, Treatment of list slices of undef has changed,
6507 Format of $English::PERL_VERSION is different, Literals of the form
6508 C<1.2.3> parse differently, Possibly changed pseudo-random number
6509 generator, Hashing function for hash keys has changed, C<undef> fails on
6510 read only values, Close-on-exec bit may be set on pipe and socket handles,
6511 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6512 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6513 Text of some diagnostic output has changed, C<%@> has been removed,
6514 Parenthesized not() behaves like a list operator, Semantics of bareword
6515 prototype C<(*)> have changed, Semantics of bit operators may have changed
6516 on 64-bit platforms, More builtins taint their results
6517
6518 =item C Source Incompatibilities
6519
6520 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6521
6522 =item Compatible C Source API Changes
6523
6524 C<PATCHLEVEL> is now C<PERL_VERSION>
6525
6526 =item Binary Incompatibilities
6527
6528 =back
6529
6530 =item Known Problems
6531
6532 =over 4
6533
6534 =item Thread test failures
6535
6536 =item EBCDIC platforms not supported
6537
6538 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6539
6540 =item NEXTSTEP 3.3 POSIX test failure
6541
6542 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6543 gcc
6544
6545 =item UNICOS/mk CC failures during Configure run
6546
6547 =item Arrow operator and arrays
6548
6549 =item Experimental features
6550
6551 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6552 pseudo-hash data type, The Compiler suite, Internal implementation of file
6553 globbing, The DB module, The regular expression code constructs:
6554
6555 =back
6556
6557 =item Obsolete Diagnostics
6558
6559 Character class syntax [: :] is reserved for future extensions, Ill-formed
6560 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6561 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6562 to mean "${$}<digit>" is deprecated
6563
6564 =item Reporting Bugs
6565
6566 =item SEE ALSO
6567
6568 =item HISTORY
6569
6570 =back
6571
6572 =head2 perl5005delta - what's new for perl5.005
6573
6574 =over 4
6575
6576 =item DESCRIPTION
6577
6578 =item About the new versioning system
6579
6580 =item Incompatible Changes
6581
6582 =over 4
6583
6584 =item WARNING:  This version is not binary compatible with Perl 5.004.
6585
6586 =item Default installation structure has changed
6587
6588 =item Perl Source Compatibility
6589
6590 =item C Source Compatibility
6591
6592 =item Binary Compatibility
6593
6594 =item Security fixes may affect compatibility
6595
6596 =item Relaxed new mandatory warnings introduced in 5.004
6597
6598 =item Licensing
6599
6600 =back
6601
6602 =item Core Changes
6603
6604 =over 4
6605
6606 =item Threads
6607
6608 =item Compiler
6609
6610 =item Regular Expressions
6611
6612 Many new and improved optimizations, Many bug fixes, New regular expression
6613 constructs, New operator for precompiled regular expressions, Other
6614 improvements, Incompatible changes
6615
6616 =item   Improved malloc()
6617
6618 =item Quicksort is internally implemented
6619
6620 =item Reliable signals
6621
6622 =item Reliable stack pointers
6623
6624 =item More generous treatment of carriage returns
6625
6626 =item Memory leaks
6627
6628 =item Better support for multiple interpreters
6629
6630 =item Behavior of local() on array and hash elements is now well-defined
6631
6632 =item C<%!> is transparently tied to the L<Errno> module
6633
6634 =item Pseudo-hashes are supported
6635
6636 =item C<EXPR foreach EXPR> is supported
6637
6638 =item Keywords can be globally overridden
6639
6640 =item C<$^E> is meaningful on Win32
6641
6642 =item C<foreach (1..1000000)> optimized
6643
6644 =item C<Foo::> can be used as implicitly quoted package name
6645
6646 =item C<exists $Foo::{Bar::}> tests existence of a package
6647
6648 =item Better locale support
6649
6650 =item Experimental support for 64-bit platforms
6651
6652 =item prototype() returns useful results on builtins
6653
6654 =item Extended support for exception handling
6655
6656 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6657
6658 =item All C<printf> format conversions are handled internally
6659
6660 =item New C<INIT> keyword
6661
6662 =item New C<lock> keyword
6663
6664 =item New C<qr//> operator
6665
6666 =item C<our> is now a reserved word
6667
6668 =item Tied arrays are now fully supported
6669
6670 =item Tied handles support is better
6671
6672 =item 4th argument to substr
6673
6674 =item Negative LENGTH argument to splice
6675
6676 =item Magic lvalues are now more magical
6677
6678 =item <> now reads in records
6679
6680 =back
6681
6682 =item Supported Platforms
6683
6684 =over 4
6685
6686 =item New Platforms
6687
6688 =item Changes in existing support
6689
6690 =back
6691
6692 =item Modules and Pragmata
6693
6694 =over 4
6695
6696 =item New Modules
6697
6698 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6699 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6700 Thread, attrs, fields, re
6701
6702 =item Changes in existing modules
6703
6704 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6705 MakeMaker, CPAN, Cwd
6706
6707 =back
6708
6709 =item Utility Changes
6710
6711 =item Documentation Changes
6712
6713 =item New Diagnostics
6714
6715 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6716 while coercing array into hash, Bareword "%s" refers to nonexistent
6717 package, Can't call method "%s" on an undefined value, Can't check
6718 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6719 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6720 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6721 for "%s", Character class syntax [. .] is reserved for future extensions,
6722 Character class syntax [: :] is reserved for future extensions, Character
6723 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6724 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6725 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6726 package main), Illegal hex digit ignored, No such array field, No such
6727 field "%s" in variable %s of type %s, Out of memory during ridiculously
6728 large request, Range iterator outside integer range, Recursive inheritance
6729 detected while looking for method '%s' %s, Reference found where even-sized
6730 list expected, Undefined value assigned to typeglob, Use of reserved word
6731 "%s" is deprecated, perl: warning: Setting locale failed
6732
6733 =item Obsolete Diagnostics
6734
6735 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6736 temporary file, regexp too big
6737
6738 =item Configuration Changes
6739
6740 =item BUGS
6741
6742 =item SEE ALSO
6743
6744 =item HISTORY
6745
6746 =back
6747
6748 =head2 perl5004delta - what's new for perl5.004
6749
6750 =over 4
6751
6752 =item DESCRIPTION
6753
6754 =item Supported Environments
6755
6756 =item Core Changes
6757
6758 =over 4
6759
6760 =item List assignment to %ENV works
6761
6762 =item Change to "Can't locate Foo.pm in @INC" error
6763
6764 =item Compilation option: Binary compatibility with 5.003
6765
6766 =item $PERL5OPT environment variable
6767
6768 =item Limitations on B<-M>, B<-m>, and B<-T> options
6769
6770 =item More precise warnings
6771
6772 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6773
6774 =item Previously deprecated %OVERLOAD is no longer usable
6775
6776 =item Subroutine arguments created only when they're modified
6777
6778 =item Group vector changeable with C<$)>
6779
6780 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6781
6782 =item Fixed localization of $<digit>, $&, etc.
6783
6784 =item No resetting of $. on implicit close
6785
6786 =item C<wantarray> may return undef
6787
6788 =item C<eval EXPR> determines value of EXPR in scalar context
6789
6790 =item Changes to tainting checks
6791
6792 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6793 spawning if tainted $TERM doesn't look like a terminal name
6794
6795 =item New Opcode module and revised Safe module
6796
6797 =item Embedding improvements
6798
6799 =item Internal change: FileHandle class based on IO::* classes
6800
6801 =item Internal change: PerlIO abstraction interface
6802
6803 =item New and changed syntax
6804
6805 $coderef->(PARAMS)
6806
6807 =item New and changed builtin constants
6808
6809 __PACKAGE__
6810
6811 =item New and changed builtin variables
6812
6813 $^E, $^H, $^M
6814
6815 =item New and changed builtin functions
6816
6817 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6818 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6819 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6820 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6821 nested C<sub{}> closures work now, formats work right on changing lexicals
6822
6823 =item New builtin methods
6824
6825 isa(CLASS), can(METHOD), VERSION( [NEED] )
6826
6827 =item TIEHANDLE now supported
6828
6829 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6830 LIST, READLINE this, GETC this, DESTROY this
6831
6832 =item Malloc enhancements
6833
6834 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6835
6836 =item Miscellaneous efficiency enhancements
6837
6838 =back
6839
6840 =item Support for More Operating Systems
6841
6842 =over 4
6843
6844 =item Win32
6845
6846 =item Plan 9
6847
6848 =item QNX
6849
6850 =item AmigaOS
6851
6852 =back
6853
6854 =item Pragmata
6855
6856 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6857 constant NAME => VALUE, use locale, use ops, use vmsish
6858
6859 =item Modules
6860
6861 =over 4
6862
6863 =item Required Updates
6864
6865 =item Installation directories
6866
6867 =item Module information summary
6868
6869 =item Fcntl
6870
6871 =item IO
6872
6873 =item Math::Complex
6874
6875 =item Math::Trig
6876
6877 =item DB_File
6878
6879 =item Net::Ping
6880
6881 =item Object-oriented overrides for builtin operators
6882
6883 =back
6884
6885 =item Utility Changes
6886
6887 =over 4
6888
6889 =item pod2html
6890
6891 Sends converted HTML to standard output
6892
6893 =item xsubpp
6894
6895 C<void> XSUBs now default to returning nothing
6896
6897 =back
6898
6899 =item C Language API Changes
6900
6901 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6902 manipulating hashes
6903
6904 =item Documentation Changes
6905
6906 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6907 L<perlmodlib>, L<perldebug>, L<perlsec>
6908
6909 =item New Diagnostics
6910
6911 "my" variable %s masks earlier declaration in same scope, %s argument is
6912 not a HASH element or slice, Allocation too large: %lx, Allocation too
6913 large, Applying %s to %s will act on scalar(%s), Attempt to free
6914 nonexistent shared string, Attempt to use reference as lvalue in substr,
6915 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6916 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6917 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6918 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6919 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6920 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6921 %s, Integer overflow in hex number, Integer overflow in octal number,
6922 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6923 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6924 possible typo, Null picture in formline, Offset outside string, Out of
6925 memory!, Out of memory during request for %s, panic: frexp, Possible
6926 attempt to put comments in qw() list, Possible attempt to separate words
6927 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6928 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6929 option, untie attempted while %d inner references still exist, Unrecognized
6930 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6931 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6932 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6933 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6934 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6935 long, Process terminated by SIG%s
6936
6937 =item BUGS
6938
6939 =item SEE ALSO
6940
6941 =item HISTORY
6942
6943 =back
6944
6945 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6946
6947 =over 4
6948
6949 =item DESCRIPTION
6950
6951 =over 4
6952
6953 =item Compiling Perl 5 on AIX
6954
6955 =item OS level
6956
6957 =item Building Dynamic Extensions on AIX
6958
6959 =item The IBM ANSI C Compiler
6960
6961 =item Using GNU's gcc for building perl
6962
6963 =item Using Large Files with Perl
6964
6965 =item Threaded Perl
6966
6967 =item 64-bit Perl
6968
6969 =item AIX 4.2 and extensions using C++ with statics
6970
6971 =back
6972
6973 =item AUTHOR
6974
6975 =item DATE
6976
6977 =back
6978
6979 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6980
6981 =over 4
6982
6983 =item DESCRIPTION
6984
6985 =item AUTHOR
6986
6987 =back
6988
6989 =head2 perlamiga - Perl under Amiga OS
6990
6991 =over 4
6992
6993 =item SYNOPSIS
6994
6995 =back
6996
6997 =over 4
6998
6999 =item DESCRIPTION
7000
7001 =over 4
7002
7003 =item Prerequisites for Compiling Perl on AmigaOS
7004
7005 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7006
7007 =item Starting Perl programs under AmigaOS
7008
7009 =item Shortcomings of Perl under AmigaOS
7010
7011 =back
7012
7013 =item INSTALLATION
7014
7015 =item Accessing documentation
7016
7017 =over 4
7018
7019 =item Manpages for Perl on AmigaOS
7020
7021 =item Perl HTML Documentation on AmigaOS
7022
7023 =item Perl GNU Info Files on AmigaOS
7024
7025 =item Perl LaTeX Documentation on AmigaOS
7026
7027 =back
7028
7029 =item BUILDING PERL ON AMIGAOS
7030
7031 =over 4
7032
7033 =item Build Prerequisites for Perl on AmigaOS
7034
7035 =item Getting the Perl Source for AmigaOS
7036
7037 =item Making Perl on AmigaOS
7038
7039 =item Testing Perl on AmigaOS
7040
7041 =item Installing the built Perl on AmigaOS
7042
7043 =back
7044
7045 =item AUTHORS
7046
7047 =item SEE ALSO
7048
7049 =back
7050
7051 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7052
7053 =over 4
7054
7055 =item DESCRIPTION
7056
7057 =over 4
7058
7059 =item General Issues with Perl on BeOS
7060
7061 =item BeOS Release-specific Notes
7062
7063 R4 x86, R4 PPC
7064
7065 =item Contact Information
7066
7067 =item Update 2002-05-30
7068
7069 =back
7070
7071 =back
7072
7073 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7074
7075 =over 4
7076
7077 =item SYNOPSIS
7078
7079 =item DESCRIPTION
7080
7081 =over 4
7082
7083 =item gzip on BS2000
7084
7085 =item bison on BS2000
7086
7087 =item Unpacking Perl Distribution on BS2000
7088
7089 =item Compiling Perl on BS2000
7090
7091 =item Testing Perl on BS2000
7092
7093 =item Installing Perl on BS2000
7094
7095 =item Using Perl in the Posix-Shell of BS2000
7096
7097 =item Using Perl in "native" BS2000
7098
7099 =item Floating point anomalies on BS2000
7100
7101 =back
7102
7103 =item AUTHORS
7104
7105 =item SEE ALSO
7106
7107 =over 4
7108
7109 =item Mailing list
7110
7111 =back
7112
7113 =item HISTORY
7114
7115 =back
7116
7117 =over 4
7118
7119 =item Name
7120
7121 =item Description
7122
7123 =item Build
7124
7125 =over 4
7126
7127 =item Tools & SDK
7128
7129 =item Make
7130
7131 =back
7132
7133 =item Acknowledgements
7134
7135 =item Author
7136
7137 =back
7138
7139 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7140
7141 =over 4
7142
7143 =item SYNOPSIS
7144
7145 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7146
7147 =over 4
7148
7149 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7150
7151 =item Cygwin Configuration
7152
7153 C<PATH>, I<nroff>, Permissions
7154
7155 =back
7156
7157 =item CONFIGURE PERL ON CYGWIN
7158
7159 =over 4
7160
7161 =item Stripping Perl Binaries on Cygwin
7162
7163 =item Optional Libraries for Perl on Cygwin
7164
7165 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7166 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7167
7168 =item Configure-time Options for Perl on Cygwin
7169
7170 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7171 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7172 C<-Dmksymlinks>
7173
7174 =item Suspicious Warnings on Cygwin
7175
7176 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7177
7178 =back
7179
7180 =item MAKE ON CYGWIN
7181
7182 =over 4
7183
7184 =item Warnings on Cygwin
7185
7186 =item ld2 on Cygwin
7187
7188 =back
7189
7190 =item TEST ON CYGWIN
7191
7192 =over 4
7193
7194 =item File Permissions on Cygwin
7195
7196 =item Script Portability on Cygwin
7197
7198 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7199
7200 =back
7201
7202 =item INSTALL PERL ON CYGWIN
7203
7204 =item MANIFEST ON CYGWIN
7205
7206 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7207 Source, Compiled Module Source, Perl Modules/Scripts
7208
7209 =item BUGS ON CYGWIN
7210
7211 =item AUTHORS
7212
7213 =item HISTORY
7214
7215 =back
7216
7217 =head2 perldgux - Perl under DG/UX.
7218
7219 =over 4
7220
7221 =item SYNOPSIS
7222
7223 =back
7224
7225 =over 4
7226
7227 =item DESCRIPTION
7228
7229 =item BUILDING PERL ON DG/UX
7230
7231 =over 4
7232
7233 =item Non-threaded Perl on DG/UX
7234
7235 =item Threaded Perl on DG/UX
7236
7237 =item Testing Perl on DG/UX
7238
7239 =item Installing the built perl on DG/UX
7240
7241 =back
7242
7243 =item AUTHOR
7244
7245 =item SEE ALSO
7246
7247 =back
7248
7249 =head2 perldos - Perl under DOS, W31, W95.
7250
7251 =over 4
7252
7253 =item SYNOPSIS
7254
7255 =item DESCRIPTION
7256
7257 =over 4
7258
7259 =item Prerequisites for Compiling Perl on DOS
7260
7261 DJGPP, Pthreads
7262
7263 =item Shortcomings of Perl under DOS
7264
7265 =item Building Perl on DOS
7266
7267 =item Testing Perl on DOS
7268
7269 =item Installation of Perl on DOS
7270
7271 =back
7272
7273 =item BUILDING AND INSTALLING MODULES ON DOS
7274
7275 =over 4
7276
7277 =item Building Prerequisites for Perl on DOS
7278
7279 =item Unpacking CPAN Modules on DOS
7280
7281 =item Building Non-XS Modules on DOS
7282
7283 =item Building XS Modules on DOS
7284
7285 =back
7286
7287 =item AUTHOR
7288
7289 =item SEE ALSO
7290
7291 =back
7292
7293 =head2 perlepoc, README.epoc - Perl for EPOC
7294
7295 =over 4
7296
7297 =item SYNOPSIS
7298
7299 =item INTRODUCTION
7300
7301 =item INSTALLING PERL ON EPOC
7302
7303 =item STARTING PERL ON EPOC
7304
7305 =over 4
7306
7307 =item Editors on Epoc
7308
7309 =item Features of Perl on Epoc
7310
7311 =item Restrictions of Perl on Epoc
7312
7313 =item Compiling Perl 5 on the EPOC cross compiling environment
7314
7315 =back
7316
7317 =item SUPPORT STATUS OF PERL ON EPOC
7318
7319 =item AUTHOR
7320
7321 =item LAST UPDATE
7322
7323 =back
7324
7325 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7326
7327 =over 4
7328
7329 =item DESCRIPTION
7330
7331 =over 4
7332
7333 =item FreeBSD core dumps from readdir_r with ithreads
7334
7335 =item $^X doesn't always contain a full path in FreeBSD
7336
7337 =item Perl will no more be part of "base FreeBSD"
7338
7339 =back
7340
7341 =item AUTHOR
7342
7343 =back
7344
7345 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7346 (HP-UX) systems
7347
7348 =over 4
7349
7350 =item DESCRIPTION
7351
7352 =over 4
7353
7354 =item Using perl as shipped with HP-UX
7355
7356 =item Compiling Perl 5 on HP-UX
7357
7358 =item PA-RISC
7359
7360 =item PA-RISC 1.0
7361
7362 =item PA-RISC 1.1
7363
7364 =item PA-RISC 2.0
7365
7366 =item Itanium
7367
7368 =item Portability Between PA-RISC Versions
7369
7370 =item Itanium Processor Family and HP-UX
7371
7372 =item Building Dynamic Extensions on HP-UX
7373
7374 =item The HP ANSI C Compiler
7375
7376 =item The GNU C Compiler
7377
7378 =item Using Large Files with Perl on HP-UX
7379
7380 =item Threaded Perl on HP-UX
7381
7382 =item 64-bit Perl on HP-UX
7383
7384 =item Oracle on HP-UX
7385
7386 =item GDBM and Threads on HP-UX
7387
7388 =item NFS filesystems and utime(2) on HP-UX
7389
7390 =item perl -P and // and HP-UX
7391
7392 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7393
7394 =back
7395
7396 =item nss_delete core dump from op/pwent or op/grent
7397
7398 =item AUTHOR
7399
7400 =item DATE
7401
7402 =back
7403
7404 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7405
7406 =over 4
7407
7408 =item DESCRIPTION
7409
7410 =over 4
7411
7412 =item Known Problems with Perl on Hurd 
7413
7414 =back
7415
7416 =item AUTHOR
7417
7418 =back
7419
7420 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7421
7422 =over 4
7423
7424 =item DESCRIPTION
7425
7426 =over 4
7427
7428 =item Building 32-bit Perl in Irix
7429
7430 =item Building 64-bit Perl in Irix
7431
7432 =item About Compiler Versions of Irix
7433
7434 =item Linker Problems in Irix
7435
7436 =item Malloc in Irix
7437
7438 =item Building with threads
7439
7440 =back
7441
7442 =item AUTHOR
7443
7444 =back
7445
7446 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7447 systems
7448
7449 =over 4
7450
7451 =item DESCRIPTION
7452
7453 =over 4
7454
7455 =item Compiling Perl 5 on MachTen
7456
7457 =item Failures during C<make test> on MachTen
7458
7459 op/lexassign.t, pragma/warnings.t
7460
7461 =item Building external modules on MachTen
7462
7463 =back
7464
7465 =item AUTHOR
7466
7467 =item DATE
7468
7469 =back
7470
7471 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7472
7473 =over 4
7474
7475 =item SYNOPSIS
7476
7477 =item DESCRIPTION
7478
7479 =item AUTHOR
7480
7481 =item DATE
7482
7483 =back
7484
7485 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7486
7487 =over 4
7488
7489 =item DESCRIPTION
7490
7491 =item Known problems with Perl on MiNT
7492
7493 =item AUTHOR
7494
7495 =back
7496
7497 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7498
7499 =over 4
7500
7501 =item SYNOPSIS
7502
7503 =item NOTE
7504
7505 =item Binary distribution from HP
7506
7507 =item What's New in Perl for MPE/iX
7508
7509 =item Welcome to Perl/iX
7510
7511 =item System Requirements for Perl/iX
7512
7513 =item How to Obtain Perl/iX
7514
7515 =item Perl/iX Distribution Contents Highlights
7516
7517 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7518 public_html/feedback.cgi, src/perl-5.6.0-mpe
7519
7520 =item How to Compile Perl/iX
7521
7522  4,  6
7523
7524 =item Getting Started with Perl/iX
7525
7526 =item MPE/iX Implementation Considerations
7527
7528 =item Known Perl/iX Bugs Under Investigation
7529
7530 =item Perl/iX To-Do List
7531
7532 =item Perl/iX Change History
7533
7534 =item AUTHOR
7535
7536 =item Name
7537
7538 =item Description
7539
7540 =item Build
7541
7542 =over 4
7543
7544 =item Tools & SDK
7545
7546 =item Setup
7547
7548 SetNWBld.bat, Buildtype.bat
7549
7550 =item Make
7551
7552 =item Interpreter
7553
7554 =item Extensions
7555
7556 =back
7557
7558 =item Install
7559
7560 =item Build new extensions
7561
7562 =item Acknowledgements
7563
7564 =item Authors
7565
7566 =item Date
7567
7568 =back
7569
7570 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7571
7572 =over 4
7573
7574 =item SYNOPSIS
7575
7576 =back
7577
7578 =over 4
7579
7580 =item DESCRIPTION
7581
7582 =over 4
7583
7584 =item Target
7585
7586 =item Other OSes
7587
7588 =item Prerequisites
7589
7590 EMX, RSX, HPFS, pdksh
7591
7592 =item Starting Perl programs under OS/2 (and DOS and...)
7593
7594 =item Starting OS/2 (and DOS) programs under Perl
7595
7596 =back
7597
7598 =item Frequently asked questions
7599
7600 =over 4
7601
7602 =item "It does not work"
7603
7604 =item I cannot run external programs
7605
7606 =item I cannot embed perl into my program, or use F<perl.dll> from my
7607 program. 
7608
7609 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7610 L<ExtUtils::Embed>?
7611
7612 =item C<``> and pipe-C<open> do not work under DOS.
7613
7614 =item Cannot start C<find.exe "pattern" file>
7615
7616 =back
7617
7618 =item INSTALLATION
7619
7620 =over 4
7621
7622 =item Automatic binary installation
7623
7624 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7625
7626 =item Manual binary installation
7627
7628 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7629 (statically linked), Executables for Perl utilities, Main Perl library,
7630 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7631 and utilities, Manpages for Perl modules, Source for Perl documentation,
7632 Perl manual in F<.INF> format, Pdksh
7633
7634 =item B<Warning>
7635
7636 =back
7637
7638 =item Accessing documentation
7639
7640 =over 4
7641
7642 =item OS/2 F<.INF> file
7643
7644 =item Plain text
7645
7646 =item Manpages
7647
7648 =item HTML
7649
7650 =item GNU C<info> files
7651
7652 =item F<PDF> files
7653
7654 =item C<LaTeX> docs
7655
7656 =back
7657
7658 =item BUILD
7659
7660 =over 4
7661
7662 =item The short story
7663
7664 =item Prerequisites
7665
7666 =item Getting perl source
7667
7668 =item Application of the patches
7669
7670 =item Hand-editing
7671
7672 =item Making
7673
7674 =item Testing
7675
7676 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7677 F<op/stat.t>
7678
7679 =item Installing the built perl
7680
7681 =item C<a.out>-style build
7682
7683 =back
7684
7685 =item Build FAQ
7686
7687 =over 4
7688
7689 =item Some C</> became C<\> in pdksh.
7690
7691 =item C<'errno'> - unresolved external
7692
7693 =item Problems with tr or sed
7694
7695 =item Some problem (forget which ;-)
7696
7697 =item Library ... not found
7698
7699 =item Segfault in make
7700
7701 =item op/sprintf test failure
7702
7703 =back
7704
7705 =item Specific (mis)features of OS/2 port
7706
7707 =over 4
7708
7709 =item C<setpriority>, C<getpriority>
7710
7711 =item C<system()>
7712
7713 =item C<extproc> on the first line
7714
7715 =item Additional modules:
7716
7717 =item Prebuilt methods:
7718
7719 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7720  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
7721 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
7722 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
7723 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
7724 C<Cwd::extLibpath_set( path [, type ] )>,
7725 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7726 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7727 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7728 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7729 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7730
7731 =item Prebuilt variables:
7732
7733 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7734
7735 =item Misfeatures
7736
7737 =item Modifications
7738
7739 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7740 C<flock>
7741
7742 =item Identifying DLLs
7743
7744 =item Centralized management of resources
7745
7746 C<HAB>, C<HMQ>
7747
7748 =back
7749
7750 =item Perl flavors
7751
7752 =over 4
7753
7754 =item F<perl.exe>
7755
7756 =item F<perl_.exe>
7757
7758 =item F<perl__.exe>
7759
7760 =item F<perl___.exe>
7761
7762 =item Why strange names?
7763
7764 =item Why dynamic linking?
7765
7766 =item Why chimera build?
7767
7768 =back
7769
7770 =item ENVIRONMENT
7771
7772 =over 4
7773
7774 =item C<PERLLIB_PREFIX>
7775
7776 =item C<PERL_BADLANG>
7777
7778 =item C<PERL_BADFREE>
7779
7780 =item C<PERL_SH_DIR>
7781
7782 =item C<USE_PERL_FLOCK>
7783
7784 =item C<TMP> or C<TEMP>
7785
7786 =back
7787
7788 =item Evolution
7789
7790 =over 4
7791
7792 =item Priorities
7793
7794 =item DLL name mangling: pre 5.6.2
7795
7796 =item DLL name mangling: 5.6.2 and beyond
7797
7798 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7799 C<LIBPATH>
7800
7801 =item DLL forwarder generation
7802
7803 =item Threading
7804
7805 =item Calls to external programs
7806
7807 =item Memory allocation
7808
7809 =item Threads
7810
7811 C<COND_WAIT>, F<os2.c>
7812
7813 =back
7814
7815 =item BUGS
7816
7817 =back
7818
7819 =over 4
7820
7821 =item AUTHOR
7822
7823 =item SEE ALSO
7824
7825 =back
7826
7827 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7828 and z/OS
7829
7830 =over 4
7831
7832 =item SYNOPSIS
7833
7834 =item DESCRIPTION
7835
7836 =over 4
7837
7838 =item Tools
7839
7840 =item Unpacking Perl distribution on OS/390
7841
7842 =item Setup and utilities for Perl on OS/390
7843
7844 =item Configure Perl on OS/390
7845
7846 =item Build, Test, Install Perl on OS/390
7847
7848 =item Build Anomalies with Perl on OS/390
7849
7850 =item Testing Anomalies with Perl on OS/390
7851
7852 =item Installation Anomalies with Perl on OS/390
7853
7854 =item Usage Hints for Perl on OS/390
7855
7856 =item Floating Point Anomalies with Perl on OS/390
7857
7858 =item Modules and Extensions for Perl on OS/390
7859
7860 =back
7861
7862 =item AUTHORS
7863
7864 =item SEE ALSO
7865
7866 =over 4
7867
7868 =item Mailing list for Perl on OS/390
7869
7870 =back
7871
7872 =item HISTORY
7873
7874 =back
7875
7876 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7877
7878 =over 4
7879
7880 =item DESCRIPTION
7881
7882 =over 4
7883
7884 =item Required Software for Compiling Perl on QNX4
7885
7886 /bin/sh, ar, nm, cpp, make
7887
7888 =item Outstanding Issues with Perl on QNX4
7889
7890 =item QNX auxiliary files
7891
7892 qnx/ar, qnx/cpp
7893
7894 =item Outstanding issues with perl under QNX6
7895
7896 =back
7897
7898 =item AUTHOR
7899
7900 =back
7901
7902 =head2 perlplan9 - Plan 9-specific documentation for Perl
7903
7904 =over 4
7905
7906 =item DESCRIPTION
7907
7908 =over 4
7909
7910 =item Invoking Perl
7911
7912 =item What's in Plan 9 Perl
7913
7914 =item What's not in Plan 9 Perl
7915
7916 =item Perl5 Functions not currently supported in Plan 9 Perl
7917
7918 =item Signals in Plan 9 Perl
7919
7920 =back
7921
7922 =item COMPILING AND INSTALLING PERL ON PLAN 9
7923
7924 =over 4
7925
7926 =item Installing Perl Documentation on Plan 9
7927
7928 =back
7929
7930 =item BUGS
7931
7932 =item Revision date
7933
7934 =item AUTHOR
7935
7936 =back
7937
7938 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7939
7940 =over 4
7941
7942 =item DESCRIPTION
7943
7944 =over 4
7945
7946 =item Solaris Version Numbers.
7947
7948 =back
7949
7950 =item RESOURCES
7951
7952 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7953
7954 =item SETTING UP
7955
7956 =over 4
7957
7958 =item File Extraction Problems on Solaris.
7959
7960 =item Compiler and Related Tools on Solaris.
7961
7962 =item Environment for Compiling Perl on Solaris
7963
7964 =back
7965
7966 =item RUN CONFIGURE.
7967
7968 =over 4
7969
7970 =item 64-bit Issues with Perl on Solaris.
7971
7972 =item Threads in Perl on Solaris.
7973
7974 =item Malloc Issues with Perl on Solaris.
7975
7976 =back
7977
7978 =item MAKE PROBLEMS.
7979
7980 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
7981 relocation error:, dlopen: stub interception failed, #error "No
7982 DATAMODEL_NATIVE specified", sh: ar: not found
7983
7984 =item MAKE TEST
7985
7986 =over 4
7987
7988 =item op/stat.t test 4 in Solaris
7989
7990 =item nss_delete core dump from op/pwent or op/grent
7991
7992 =back
7993
7994 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
7995
7996 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
7997
7998 =over 4
7999
8000 =item Limits on Numbers of Open Files on Solaris.
8001
8002 =back
8003
8004 =item SOLARIS-SPECIFIC MODULES.
8005
8006 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8007
8008 =over 4
8009
8010 =item Proc::ProcessTable on Solaris
8011
8012 =item BSD::Resource on Solaris
8013
8014 =item Net::SSLeay on Solaris
8015
8016 =back
8017
8018 =item AUTHOR
8019
8020 =item LAST MODIFIED
8021
8022 =back
8023
8024 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8025 Digital UNIX formerly known as DEC OSF/1) systems
8026
8027 =over 4
8028
8029 =item DESCRIPTION
8030
8031 =over 4
8032
8033 =item Compiling Perl 5 on Tru64
8034
8035 =item Using Large Files with Perl on Tru64
8036
8037 =item Threaded Perl on Tru64
8038
8039 =item Long Doubles on Tru64
8040
8041 =item 64-bit Perl on Tru64
8042
8043 =item Warnings about floating-point overflow when compiling Perl on Tru64
8044
8045 =back
8046
8047 =item Testing Perl on Tru64
8048
8049 =item ext/ODBM_File/odbm Test Failing With Static Builds
8050
8051 =item Perl Fails Because Of Unresolved Symbol sockatmark
8052
8053 =item AUTHOR
8054
8055 =back
8056
8057 =head2 perluts - Perl under UTS
8058
8059 =over 4
8060
8061 =item SYNOPSIS
8062
8063 =item DESCRIPTION
8064
8065 =item BUILDING PERL ON UTS
8066
8067 =item Installing the built perl on UTS
8068
8069 =item AUTHOR
8070
8071 =back
8072
8073 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8074
8075 =over 4
8076
8077 =item SYNOPSIS
8078
8079 =item DESCRIPTION
8080
8081 =over 4
8082
8083 =item Unpacking Perl Distribution on VM/ESA
8084
8085 =item Setup Perl and utilities on VM/ESA
8086
8087 =item Configure Perl on VM/ESA
8088
8089 =item Testing Anomalies of Perl on VM/ESA
8090
8091 =item Usage Hints for Perl on VM/ESA
8092
8093 =back
8094
8095 =item AUTHORS
8096
8097 =item SEE ALSO
8098
8099 =over 4
8100
8101 =item Mailing list for Perl on VM/ESA
8102
8103 =back
8104
8105 =back
8106
8107 =head2 perlvms - VMS-specific documentation for Perl
8108
8109 =over 4
8110
8111 =item DESCRIPTION
8112
8113 =item Installation
8114
8115 =item Organization of Perl Images
8116
8117 =over 4
8118
8119 =item Core Images
8120
8121 =item Perl Extensions
8122
8123 =item Installing static extensions
8124
8125 =item Installing dynamic extensions
8126
8127 =back
8128
8129 =item File specifications
8130
8131 =over 4
8132
8133 =item Syntax
8134
8135 =item Wildcard expansion
8136
8137 =item Pipes
8138
8139 =back
8140
8141 =item PERL5LIB and PERLLIB
8142
8143 =item Command line
8144
8145 =over 4
8146
8147 =item I/O redirection and backgrounding
8148
8149 =item Command line switches
8150
8151 -i, -S, -u
8152
8153 =back
8154
8155 =item Perl functions
8156
8157 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8158 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8159 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8160 LIST, waitpid PID,FLAGS
8161
8162 =item Perl variables
8163
8164 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8165
8166 =item Standard modules with VMS-specific differences
8167
8168 =over 4
8169
8170 =item SDBM_File
8171
8172 =back
8173
8174 =item Revision date
8175
8176 =item AUTHOR
8177
8178 =back
8179
8180 =head2 perlvos, README.vos - Perl for Stratus VOS
8181
8182 =over 4
8183
8184 =item SYNOPSIS
8185
8186 =over 4
8187
8188 =item Multiple methods to build perl for VOS
8189
8190 =item Stratus POSIX Support
8191
8192 =back
8193
8194 =item INSTALLING PERL IN VOS
8195
8196 =over 4
8197
8198 =item Compiling Perl 5 on VOS
8199
8200 =item Installing Perl 5 on VOS
8201
8202 =back
8203
8204 =item USING PERL IN VOS
8205
8206 =over 4
8207
8208 =item Unimplemented Features of Perl on VOS
8209
8210 =item Restrictions of Perl on VOS
8211
8212 =item Handling of underflow and overflow
8213
8214 =back
8215
8216 =item TEST STATUS
8217
8218 =item SUPPORT STATUS
8219
8220 =item AUTHOR
8221
8222 =item LAST UPDATE
8223
8224 =back
8225
8226 =head2 perlwin32 - Perl under Windows
8227
8228 =over 4
8229
8230 =item SYNOPSIS
8231
8232 =item DESCRIPTION
8233
8234 =over 4
8235
8236 =item Setting Up Perl on Win32
8237
8238 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8239 SDK 64-bit Compiler, Mingw32 with GCC
8240
8241 =item Building
8242
8243 =item Testing Perl on Win32
8244
8245 =item Installation of Perl on Win32
8246
8247 =item Usage Hints for Perl on Win32
8248
8249 Environment Variables, File Globbing, Using perl from the command line,
8250 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8251 Extensions, Notes on 64-bit Windows
8252
8253 =item Running Perl Scripts
8254
8255 Miscellaneous Things
8256
8257 =back
8258
8259 =item BUGS AND CAVEATS
8260
8261 =item AUTHORS
8262
8263 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8264 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8265 E<lt>nick@ing-simmons.netE<gt>
8266
8267 =item SEE ALSO
8268
8269 =item HISTORY
8270
8271 =back
8272
8273 =head1 PRAGMA DOCUMENTATION
8274
8275 =head2 attrs - set/get attributes of a subroutine (deprecated)
8276
8277 =over 4
8278
8279 =item SYNOPSIS
8280
8281 =item DESCRIPTION
8282
8283 method, locked
8284
8285 =back
8286
8287 =head2 re - Perl pragma to alter regular expression behaviour
8288
8289 =over 4
8290
8291 =item SYNOPSIS
8292
8293 =item DESCRIPTION
8294
8295 =back
8296
8297 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8298
8299 =over 4
8300
8301 =item SYNOPSIS
8302
8303 =item DESCRIPTION
8304
8305 =item FUNCTIONS AND METHODS
8306
8307 new, enqueue LIST, dequeue, dequeue_nb, pending
8308
8309 =item SEE ALSO
8310
8311 =back
8312
8313 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8314 semaphores
8315
8316 =over 4
8317
8318 =item SYNOPSIS
8319
8320 =item DESCRIPTION
8321
8322 =item FUNCTIONS AND METHODS
8323
8324 new, new NUMBER, down, down NUMBER, up, up NUMBER
8325
8326 =back
8327
8328 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8329 data structures between threads
8330
8331 =over 4
8332
8333 =item SYNOPSIS
8334
8335 =item DESCRIPTION
8336
8337 =item EXPORT
8338
8339 =item FUNCTIONS
8340
8341 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8342 cond_broadcast VARIABLE
8343
8344 =item NOTES
8345
8346 =item BUGS
8347
8348 =item AUTHOR
8349
8350 =item SEE ALSO
8351
8352 =back
8353
8354 =head2 threads - Perl extension allowing use of interpreter based threads
8355 from perl
8356
8357 =over 4
8358
8359 =item SYNOPSIS
8360
8361 =item DESCRIPTION
8362
8363 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8364 threads->self, $thread->tid, threads->yield();, threads->list();, async
8365 BLOCK;
8366
8367 =item WARNINGS
8368
8369 A thread exited while %d other threads were still running
8370
8371 =item BUGS / TODO
8372
8373 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8374 not threadsafe, will not be
8375
8376 =item AUTHOR and COPYRIGHT
8377
8378 =item SEE ALSO
8379
8380 =back
8381
8382 =head2 attributes - get/set subroutine or variable attributes
8383
8384 =over 4
8385
8386 =item SYNOPSIS
8387
8388 =item DESCRIPTION
8389
8390 =over 4
8391
8392 =item Built-in Attributes
8393
8394 locked, method, lvalue
8395
8396 =item Available Subroutines
8397
8398 get, reftype
8399
8400 =item Package-specific Attribute Handling
8401
8402 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8403
8404 =item Syntax of Attribute Lists
8405
8406 =back
8407
8408 =item EXPORTS
8409
8410 =over 4
8411
8412 =item Default exports
8413
8414 =item Available exports
8415
8416 =item Export tags defined
8417
8418 =back
8419
8420 =item EXAMPLES
8421
8422 =item SEE ALSO
8423
8424 =back
8425
8426 =head2 attrs - set/get attributes of a subroutine (deprecated)
8427
8428 =over 4
8429
8430 =item SYNOPSIS
8431
8432 =item DESCRIPTION
8433
8434 method, locked
8435
8436 =back
8437
8438 =head2 autouse - postpone load of modules until a function is used
8439
8440 =over 4
8441
8442 =item SYNOPSIS
8443
8444 =item DESCRIPTION
8445
8446 =item WARNING
8447
8448 =item AUTHOR
8449
8450 =item SEE ALSO
8451
8452 =back
8453
8454 =head2 base - Establish IS-A relationship with base class at compile time
8455
8456 =over 4
8457
8458 =item SYNOPSIS
8459
8460 =item DESCRIPTION
8461
8462 =item HISTORY
8463
8464 =item SEE ALSO
8465
8466 =back
8467
8468 =head2 bigint - Transparent big integer support for Perl
8469
8470 =over 4
8471
8472 =item SYNOPSIS
8473
8474 =item DESCRIPTION
8475
8476 =over 4
8477
8478 =item OPTIONS
8479
8480 a or accuracy, p or precision, t or trace, l or lib, v or version
8481
8482 =item MATH LIBRARY
8483
8484 =item INTERNAL FORMAT
8485
8486 =item SIGN
8487
8488 =item METHODS
8489
8490 =back
8491
8492 =item MODULES USED
8493
8494 =item EXAMPLES
8495
8496 =item LICENSE
8497
8498 =item SEE ALSO
8499
8500 =item AUTHORS
8501
8502 =back
8503
8504 =head2 bignum - Transparent BigNumber support for Perl
8505
8506 =over 4
8507
8508 =item SYNOPSIS
8509
8510 =item DESCRIPTION
8511
8512 =over 4
8513
8514 =item OPTIONS
8515
8516 a or accuracy, p or precision, t or trace, l or lib, v or version
8517
8518 =item MATH LIBRARY
8519
8520 =item INTERNAL FORMAT
8521
8522 =item SIGN
8523
8524 =item METHODS
8525
8526 =back
8527
8528 =item MODULES USED
8529
8530 =item EXAMPLES
8531
8532 =item LICENSE
8533
8534 =item SEE ALSO
8535
8536 =item AUTHORS
8537
8538 =back
8539
8540 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8541
8542 =over 4
8543
8544 =item SYNOPSIS
8545
8546 =item DESCRIPTION
8547
8548 =over 4
8549
8550 =item MODULES USED
8551
8552 =item MATH LIBRARY
8553
8554 =item SIGN
8555
8556 =item METHODS
8557
8558 =back
8559
8560 =item EXAMPLES
8561
8562         perl -Mbigrat -le 'print sqrt(33)'
8563         perl -Mbigrat -le 'print 2*255'
8564         perl -Mbigrat -le 'print 4.5+2*255'
8565         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
8566         perl -Mbigrat -le 'print 12->is_odd()';
8567
8568 =item LICENSE
8569
8570 =item SEE ALSO
8571
8572 =item AUTHORS
8573
8574 =back
8575
8576 =head2 blib - Use MakeMaker's uninstalled version of a package
8577
8578 =over 4
8579
8580 =item SYNOPSIS
8581
8582 =item DESCRIPTION
8583
8584 =item BUGS
8585
8586 =item AUTHOR
8587
8588 =back
8589
8590 =head2 bytes - Perl pragma to force byte semantics rather than character
8591 semantics
8592
8593 =over 4
8594
8595 =item SYNOPSIS
8596
8597 =item DESCRIPTION
8598
8599 =item SEE ALSO
8600
8601 =back
8602
8603 =head2 charnames - define character names for C<\N{named}> string literal
8604 escapes
8605
8606 =over 4
8607
8608 =item SYNOPSIS
8609
8610 =item DESCRIPTION
8611
8612 =item CUSTOM TRANSLATORS
8613
8614 =item charnames::viacode(code)
8615
8616 =item charnames::vianame(name)
8617
8618 =item ALIASES
8619
8620 =item ILLEGAL CHARACTERS
8621
8622 =item BUGS
8623
8624 =back
8625
8626 =head2 constant - Perl pragma to declare constants
8627
8628 =over 4
8629
8630 =item SYNOPSIS
8631
8632 =item DESCRIPTION
8633
8634 =item NOTES
8635
8636 =over 4
8637
8638 =item List constants
8639
8640 =item Defining multiple constants at once
8641
8642 =item Magic constants
8643
8644 =back
8645
8646 =item TECHNICAL NOTES
8647
8648 =item BUGS
8649
8650 =item AUTHOR
8651
8652 =item COPYRIGHT
8653
8654 =back
8655
8656 =head2 diagnostics - Perl compiler pragma to force verbose warning
8657 diagnostics
8658
8659 =over 4
8660
8661 =item SYNOPSIS
8662
8663 =item DESCRIPTION
8664
8665 =over 4
8666
8667 =item The C<diagnostics> Pragma
8668
8669 =item The I<splain> Program
8670
8671 =back
8672
8673 =item EXAMPLES
8674
8675 =item INTERNALS
8676
8677 =item BUGS
8678
8679 =item AUTHOR
8680
8681 =back
8682
8683 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8684
8685 =over 4
8686
8687 =item SYNOPSIS
8688
8689 =item ABSTRACT
8690
8691 =item USAGE
8692
8693 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8694 I<ENCNAME_IN> ...] ;, no encoding;
8695
8696 =item CAVEATS
8697
8698 =over 4
8699
8700 =item NOT SCOPED
8701
8702 =item DO NOT MIX MULTIPLE ENCODINGS
8703
8704 =back
8705
8706 =item Non-ASCII Identifiers and Filter option
8707
8708 use encoding I<ENCNAME> Filter=E<gt>1;
8709
8710 =item EXAMPLE - Greekperl
8711
8712 =item KNOWN PROBLEMS
8713
8714 =item SEE ALSO
8715
8716 =back
8717
8718 =head2 fields - compile-time class fields
8719
8720 =over 4
8721
8722 =item SYNOPSIS
8723
8724 =item DESCRIPTION
8725
8726 new, phash
8727
8728 =item SEE ALSO
8729
8730 =back
8731
8732 =head2 filetest - Perl pragma to control the filetest permission operators
8733
8734 =over 4
8735
8736 =item SYNOPSIS
8737
8738 =item DESCRIPTION
8739
8740 =over 4
8741
8742 =item subpragma access
8743
8744 =back
8745
8746 =back
8747
8748 =head2 if - C<use> a Perl module if a condition holds
8749
8750 =over 4
8751
8752 =item SYNOPSIS
8753
8754 =item DESCRIPTION
8755
8756 =item BUGS
8757
8758 =item AUTHOR
8759
8760 =back
8761
8762 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8763 point
8764
8765 =over 4
8766
8767 =item SYNOPSIS
8768
8769 =item DESCRIPTION
8770
8771 =back
8772
8773 =head2 less - perl pragma to request less of something from the compiler
8774
8775 =over 4
8776
8777 =item SYNOPSIS
8778
8779 =item DESCRIPTION
8780
8781 =back
8782
8783 =head2 lib - manipulate @INC at compile time
8784
8785 =over 4
8786
8787 =item SYNOPSIS
8788
8789 =item DESCRIPTION
8790
8791 =over 4
8792
8793 =item Adding directories to @INC
8794
8795 =item Deleting directories from @INC
8796
8797 =item Restoring original @INC
8798
8799 =back
8800
8801 =item CAVEATS
8802
8803 =item NOTES
8804
8805 =item SEE ALSO
8806
8807 =item AUTHOR
8808
8809 =back
8810
8811 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8812 operations
8813
8814 =over 4
8815
8816 =item SYNOPSIS
8817
8818 =item DESCRIPTION
8819
8820 =back
8821
8822 =head2 open - perl pragma to set default disciplines for input and output
8823
8824 =over 4
8825
8826 =item SYNOPSIS
8827
8828 =item DESCRIPTION
8829
8830 =item NONPERLIO FUNCTIONALITY
8831
8832 =item IMPLEMENTATION DETAILS
8833
8834 =item SEE ALSO
8835
8836 =back
8837
8838 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8839
8840 =over 4
8841
8842 =item SYNOPSIS  
8843
8844 =item DESCRIPTION
8845
8846 =item SEE ALSO
8847
8848 =back
8849
8850 =head2 overload - Package for overloading perl operations
8851
8852 =over 4
8853
8854 =item SYNOPSIS
8855
8856 =item DESCRIPTION
8857
8858 =over 4
8859
8860 =item Declaration of overloaded functions
8861
8862 =item Calling Conventions for Binary Operations
8863
8864 FALSE, TRUE, C<undef>
8865
8866 =item Calling Conventions for Unary Operations
8867
8868 =item Calling Conventions for Mutators
8869
8870 C<++> and C<-->, C<x=> and other assignment versions
8871
8872 =item Overloadable Operations
8873
8874 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8875 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8876 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8877
8878 =item Inheritance and overloading
8879
8880 Strings as values of C<use overload> directive, Overloading of an operation
8881 is inherited by derived classes
8882
8883 =back
8884
8885 =item SPECIAL SYMBOLS FOR C<use overload>
8886
8887 =over 4
8888
8889 =item Last Resort
8890
8891 =item Fallback
8892
8893 C<undef>, TRUE, defined, but FALSE
8894
8895 =item Copy Constructor
8896
8897 B<Example>
8898
8899 =back
8900
8901 =item MAGIC AUTOGENERATION
8902
8903 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8904 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8905 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8906 I<Copy operator>
8907
8908 =item Losing overloading
8909
8910 =item Run-time Overloading
8911
8912 =item Public functions
8913
8914 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8915
8916 =item Overloading constants
8917
8918 integer, float, binary, q, qr
8919
8920 =item IMPLEMENTATION
8921
8922 =item Metaphor clash
8923
8924 =item Cookbook
8925
8926 =over 4
8927
8928 =item Two-face scalars
8929
8930 =item Two-face references
8931
8932 =item Symbolic calculator
8933
8934 =item I<Really> symbolic calculator
8935
8936 =back
8937
8938 =item AUTHOR
8939
8940 =item DIAGNOSTICS
8941
8942 Odd number of arguments for overload::constant, `%s' is not an overloadable
8943 type, `%s' is not a code reference
8944
8945 =item BUGS
8946
8947 =back
8948
8949 =head2 re - Perl pragma to alter regular expression behaviour
8950
8951 =over 4
8952
8953 =item SYNOPSIS
8954
8955 =item DESCRIPTION
8956
8957 =back
8958
8959 =head2 sigtrap - Perl pragma to enable simple signal handling
8960
8961 =over 4
8962
8963 =item SYNOPSIS
8964
8965 =item DESCRIPTION
8966
8967 =item OPTIONS
8968
8969 =over 4
8970
8971 =item SIGNAL HANDLERS
8972
8973 B<stack-trace>, B<die>, B<handler> I<your-handler>
8974
8975 =item SIGNAL LISTS
8976
8977 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8978
8979 =item OTHER
8980
8981 B<untrapped>, B<any>, I<signal>, I<number>
8982
8983 =back
8984
8985 =item EXAMPLES
8986
8987 =back
8988
8989 =head2 sort - perl pragma to control sort() behaviour
8990
8991 =over 4
8992
8993 =item SYNOPSIS
8994
8995 =item DESCRIPTION
8996
8997 =item CAVEATS
8998
8999 =back
9000
9001 =head2 strict - Perl pragma to restrict unsafe constructs
9002
9003 =over 4
9004
9005 =item SYNOPSIS
9006
9007 =item DESCRIPTION
9008
9009 C<strict refs>, C<strict vars>, C<strict subs>
9010
9011 =back
9012
9013 =head2 subs - Perl pragma to predeclare sub names
9014
9015 =over 4
9016
9017 =item SYNOPSIS
9018
9019 =item DESCRIPTION
9020
9021 =back
9022
9023 =head2 threads - Perl extension allowing use of interpreter based threads
9024 from perl
9025
9026 =over 4
9027
9028 =item SYNOPSIS
9029
9030 =item DESCRIPTION
9031
9032 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9033 threads->self, $thread->tid, threads->yield();, threads->list();, async
9034 BLOCK;
9035
9036 =item WARNINGS
9037
9038 A thread exited while %d other threads were still running
9039
9040 =item BUGS / TODO
9041
9042 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
9043 not threadsafe, will not be
9044
9045 =item AUTHOR and COPYRIGHT
9046
9047 =item SEE ALSO
9048
9049 =back
9050
9051 =head2 threadshared, threads::shared - Perl extension for sharing data
9052 structures between threads
9053
9054 =over 4
9055
9056 =item SYNOPSIS
9057
9058 =item DESCRIPTION
9059
9060 =item EXPORT
9061
9062 =item FUNCTIONS
9063
9064 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9065 cond_broadcast VARIABLE
9066
9067 =item NOTES
9068
9069 =item BUGS
9070
9071 =item AUTHOR
9072
9073 =item SEE ALSO
9074
9075 =back
9076
9077 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
9078
9079 =over 4
9080
9081 =item SYNOPSIS
9082
9083 =item DESCRIPTION
9084
9085 =item FUNCTIONS AND METHODS
9086
9087 new, enqueue LIST, dequeue, dequeue_nb, pending
9088
9089 =item SEE ALSO
9090
9091 =back
9092
9093 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
9094 semaphores
9095
9096 =over 4
9097
9098 =item SYNOPSIS
9099
9100 =item DESCRIPTION
9101
9102 =item FUNCTIONS AND METHODS
9103
9104 new, new NUMBER, down, down NUMBER, up, up NUMBER
9105
9106 =back
9107
9108 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9109 code
9110
9111 =over 4
9112
9113 =item SYNOPSIS
9114
9115 =item DESCRIPTION
9116
9117 =over 4
9118
9119 =item Utility functions
9120
9121 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9122 utf8::encode($string), $flag = utf8::decode($string), $flag =
9123 utf8::valid(STRING)
9124
9125 =back
9126
9127 =item SEE ALSO
9128
9129 =back
9130
9131 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9132
9133 =over 4
9134
9135 =item SYNOPSIS
9136
9137 =item DESCRIPTION
9138
9139 =back
9140
9141 =head2 vmsish - Perl pragma to control VMS-specific language features
9142
9143 =over 4
9144
9145 =item SYNOPSIS
9146
9147 =item DESCRIPTION
9148
9149 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9150
9151 =back
9152
9153 =head2 warnings - Perl pragma to control optional warnings
9154
9155 =over 4
9156
9157 =item SYNOPSIS
9158
9159 =item DESCRIPTION
9160
9161 use warnings::register, warnings::enabled(), warnings::enabled($category),
9162 warnings::enabled($object), warnings::warn($message),
9163 warnings::warn($category, $message), warnings::warn($object, $message),
9164 warnings::warnif($message), warnings::warnif($category, $message),
9165 warnings::warnif($object, $message)
9166
9167 =back
9168
9169 =head2 warnings::register - warnings import function
9170
9171 =over 4
9172
9173 =item SYNOPSIS
9174
9175 =item DESCRIPTION
9176
9177 =back
9178
9179 =head1 MODULE DOCUMENTATION
9180
9181 =head2 AnyDBM_File - provide framework for multiple DBMs
9182
9183 =over 4
9184
9185 =item SYNOPSIS
9186
9187 =item DESCRIPTION
9188
9189 =over 4
9190
9191 =item DBM Comparisons
9192
9193 [0], [1], [2], [3]
9194
9195 =back
9196
9197 =item SEE ALSO
9198
9199 =back
9200
9201 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9202
9203 =over 4
9204
9205 =item VERSION
9206
9207 =item SYNOPSIS
9208
9209 =item DESCRIPTION
9210
9211 [0], [1], [2], [3], [4], [5]
9212
9213 =over 4
9214
9215 =item Typed lexicals
9216
9217 =item Type-specific attribute handlers
9218
9219 =item Non-interpretive attribute handlers
9220
9221 =item Phase-specific attribute handlers
9222
9223 =item Attributes as C<tie> interfaces
9224
9225 =back
9226
9227 =item EXAMPLES
9228
9229 =item DIAGNOSTICS
9230
9231 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9232 attributes>, C<Declaration of %s attribute in package %s may clash with
9233 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9234 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9235 be able to apply END handler>
9236
9237 =item AUTHOR
9238
9239 =item BUGS
9240
9241 =item COPYRIGHT
9242
9243 =back
9244
9245 =head2 AutoLoader - load subroutines only on demand
9246
9247 =over 4
9248
9249 =item SYNOPSIS
9250
9251 =item DESCRIPTION
9252
9253 =over 4
9254
9255 =item Subroutine Stubs
9256
9257 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9258
9259 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9260
9261 =item Package Lexicals
9262
9263 =item Not Using AutoLoader
9264
9265 =item B<AutoLoader> vs. B<SelfLoader>
9266
9267 =back
9268
9269 =item CAVEATS
9270
9271 =item SEE ALSO
9272
9273 =back
9274
9275 =head2 AutoSplit - split a package for autoloading
9276
9277 =over 4
9278
9279 =item SYNOPSIS
9280
9281 =item DESCRIPTION
9282
9283 $keep, $check, $modtime
9284
9285 =over 4
9286
9287 =item Multiple packages
9288
9289 =back
9290
9291 =item DIAGNOSTICS
9292
9293 =back
9294
9295 =head2 B - The Perl Compiler
9296
9297 =over 4
9298
9299 =item SYNOPSIS
9300
9301 =item DESCRIPTION
9302
9303 =item OVERVIEW OF CLASSES
9304
9305 =over 4
9306
9307 =item SV-RELATED CLASSES
9308
9309 =item B::SV METHODS
9310
9311 REFCNT, FLAGS
9312
9313 =item B::IV METHODS
9314
9315 IV, IVX, UVX, int_value, needs64bits, packiv
9316
9317 =item B::NV METHODS
9318
9319 NV, NVX
9320
9321 =item B::RV METHODS
9322
9323 RV
9324
9325 =item B::PV METHODS
9326
9327 PV, RV, PVX
9328
9329 =item B::PVMG METHODS
9330
9331 MAGIC, SvSTASH
9332
9333 =item B::MAGIC METHODS
9334
9335 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9336
9337 =item B::PVLV METHODS
9338
9339 TARGOFF, TARGLEN, TYPE, TARG
9340
9341 =item B::BM METHODS
9342
9343 USEFUL, PREVIOUS, RARE, TABLE
9344
9345 =item B::GV METHODS
9346
9347 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9348 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9349
9350 =item B::IO METHODS
9351
9352 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9353 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9354
9355 =item B::AV METHODS
9356
9357 FILL, MAX, OFF, ARRAY, AvFLAGS
9358
9359 =item B::CV METHODS
9360
9361 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9362 CvFLAGS, const_sv
9363
9364 =item B::HV METHODS
9365
9366 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9367
9368 =item OP-RELATED CLASSES
9369
9370 =item B::OP METHODS
9371
9372 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9373
9374 =item B::UNOP METHOD
9375
9376 first
9377
9378 =item B::BINOP METHOD
9379
9380 last
9381
9382 =item B::LOGOP METHOD
9383
9384 other
9385
9386 =item B::LISTOP METHOD
9387
9388 children
9389
9390 =item B::PMOP METHODS
9391
9392 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9393 pmpermflags, precomp, pmoffet
9394
9395 =item B::SVOP METHOD
9396
9397 sv, gv
9398
9399 =item B::PADOP METHOD
9400
9401 padix
9402
9403 =item B::PVOP METHOD
9404
9405 pv
9406
9407 =item B::LOOP METHODS
9408
9409 redoop, nextop, lastop
9410
9411 =item B::COP METHODS
9412
9413 label, stash, file, cop_seq, arybase, line
9414
9415 =back
9416
9417 =item FUNCTIONS EXPORTED BY C<B>
9418
9419 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9420 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9421 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9422 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9423 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9424
9425 =item AUTHOR
9426
9427 =back
9428
9429 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9430 bytecode
9431
9432 =over 4
9433
9434 =item SYNOPSIS
9435
9436 =item DESCRIPTION
9437
9438 %insn_data, @insn_name, @optype, @specialsv_name
9439
9440 =item AUTHOR
9441
9442 =back
9443
9444 =head2 B::Assembler - Assemble Perl bytecode
9445
9446 =over 4
9447
9448 =item SYNOPSIS
9449
9450 =item DESCRIPTION
9451
9452 =item AUTHORS
9453
9454 =back
9455
9456 =head2 B::Bblock - Walk basic blocks
9457
9458 =over 4
9459
9460 =item SYNOPSIS
9461
9462 =item DESCRIPTION
9463
9464 =over 4
9465
9466 =item Functions
9467
9468 B<find_leaders>
9469
9470 =back
9471
9472 =item AUTHOR
9473
9474 =back
9475
9476 =head2 B::Bytecode - Perl compiler's bytecode backend
9477
9478 =over 4
9479
9480 =item SYNOPSIS
9481
9482 =item DESCRIPTION
9483
9484 =item OPTIONS
9485
9486 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9487 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9488 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9489
9490 =item EXAMPLES
9491
9492 =item BUGS
9493
9494 =item AUTHORS
9495
9496 =back
9497
9498 =head2 B::C - Perl compiler's C backend
9499
9500 =over 4
9501
9502 =item SYNOPSIS
9503
9504 =item DESCRIPTION
9505
9506 =item OPTIONS
9507
9508 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9509 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9510 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9511 B<-llimit>
9512
9513 =item EXAMPLES
9514
9515 =item BUGS
9516
9517 =item AUTHOR
9518
9519 =back
9520
9521 =head2 B::CC - Perl compiler's optimized C translation backend
9522
9523 =over 4
9524
9525 =item SYNOPSIS
9526
9527 =item DESCRIPTION
9528
9529 =item OPTIONS
9530
9531 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9532 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9533 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9534
9535 =item EXAMPLES
9536
9537 =item BUGS
9538
9539 =item DIFFERENCES
9540
9541 =over 4
9542
9543 =item Loops
9544
9545 =item Context of ".."
9546
9547 =item Arithmetic
9548
9549 =item Deprecated features
9550
9551 =back
9552
9553 =item AUTHOR
9554
9555 =back
9556
9557 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9558
9559 =over 4
9560
9561 =item SYNOPSIS
9562
9563 =item DESCRIPTION
9564
9565 =item EXAMPLE
9566
9567 =item OPTIONS
9568
9569 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9570 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9571 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9572
9573 =item FORMATTING SPECIFICATIONS
9574
9575 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9576 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9577 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9578 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9579 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9580 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9581 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9582 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9583
9584 =item ABBREVIATIONS
9585
9586 =over 4
9587
9588 =item OP flags abbreviations
9589
9590 =item OP class abbreviations
9591
9592 =back
9593
9594 =item Using B::Concise outside of the O framework
9595
9596 =item AUTHOR
9597
9598 =back
9599
9600 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9601
9602 =over 4
9603
9604 =item SYNOPSIS
9605
9606 =item DESCRIPTION
9607
9608 =item AUTHOR
9609
9610 =back
9611
9612 =head2 B::Deparse - Perl compiler backend to produce perl code
9613
9614 =over 4
9615
9616 =item SYNOPSIS
9617
9618 =item DESCRIPTION
9619
9620 =item OPTIONS
9621
9622 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9623 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9624
9625 =item USING B::Deparse AS A MODULE
9626
9627 =over 4
9628
9629 =item Synopsis
9630
9631 =item Description
9632
9633 =item new
9634
9635 =item ambient_pragmas
9636
9637 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9638
9639 =item coderef2text
9640
9641 =back
9642
9643 =item BUGS
9644
9645 =item AUTHOR
9646
9647 =back
9648
9649 =head2 B::Disassembler - Disassemble Perl bytecode
9650
9651 =over 4
9652
9653 =item SYNOPSIS
9654
9655 =item DESCRIPTION
9656
9657 =item AUTHOR
9658
9659 =back
9660
9661 =head2 B::Lint - Perl lint
9662
9663 =over 4
9664
9665 =item SYNOPSIS
9666
9667 =item DESCRIPTION
9668
9669 =item OPTIONS AND LINT CHECKS
9670
9671 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9672 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9673
9674 =item NON LINT-CHECK OPTIONS
9675
9676 B<-u Package>
9677
9678 =item BUGS
9679
9680 =item AUTHOR
9681
9682 =back
9683
9684 =head2 B::O, O - Generic interface to Perl Compiler backends
9685
9686 =over 4
9687
9688 =item SYNOPSIS
9689
9690 =item DESCRIPTION
9691
9692 =item CONVENTIONS
9693
9694 =item IMPLEMENTATION
9695
9696 =item BUGS
9697
9698 =item AUTHOR
9699
9700 =back
9701
9702 =head2 B::Showlex - Show lexical variables used in functions or files
9703
9704 =over 4
9705
9706 =item SYNOPSIS
9707
9708 =item DESCRIPTION
9709
9710 =item AUTHOR
9711
9712 =back
9713
9714 =head2 B::Stackobj - Helper module for CC backend
9715
9716 =over 4
9717
9718 =item SYNOPSIS
9719
9720 =item DESCRIPTION
9721
9722 =item AUTHOR
9723
9724 =back
9725
9726 =head2 B::Stash - show what stashes are loaded
9727
9728 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9729
9730 =over 4
9731
9732 =item SYNOPSIS
9733
9734 =item DESCRIPTION
9735
9736 =item AUTHOR
9737
9738 =back
9739
9740 =head2 B::Xref - Generates cross reference reports for Perl programs
9741
9742 =over 4
9743
9744 =item SYNOPSIS
9745
9746 =item DESCRIPTION
9747
9748 =item OPTIONS
9749
9750 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9751
9752 =item BUGS
9753
9754 =item AUTHOR
9755
9756 =back
9757
9758 =head2 Bblock, B::Bblock - Walk basic blocks
9759
9760 =over 4
9761
9762 =item SYNOPSIS
9763
9764 =item DESCRIPTION
9765
9766 =over 4
9767
9768 =item Functions
9769
9770 B<find_leaders>
9771
9772 =back
9773
9774 =item AUTHOR
9775
9776 =back
9777
9778 =head2 Benchmark - benchmark running times of Perl code
9779
9780 =over 4
9781
9782 =item SYNOPSIS
9783
9784 =item DESCRIPTION
9785
9786 =over 4
9787
9788 =item Methods
9789
9790 new, debug, iters
9791
9792 =item Standard Exports
9793
9794 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9795 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9796 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9797
9798 =item Optional Exports
9799
9800 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9801 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9802 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9803
9804 =back
9805
9806 =item NOTES
9807
9808 =item EXAMPLES
9809
9810 =item INHERITANCE
9811
9812 =item CAVEATS
9813
9814 =item SEE ALSO
9815
9816 =item AUTHORS
9817
9818 =item MODIFICATION HISTORY
9819
9820 =back
9821
9822 =head2 ByteLoader - load byte compiled perl code
9823
9824 =over 4
9825
9826 =item SYNOPSIS
9827
9828 =item DESCRIPTION
9829
9830 =item AUTHOR
9831
9832 =item SEE ALSO
9833
9834 =back
9835
9836 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9837
9838 =over 4
9839
9840 =item SYNOPSIS
9841
9842 =item DESCRIPTION
9843
9844 =item OPTIONS
9845
9846 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9847 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9848 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9849
9850 =item EXAMPLES
9851
9852 =item BUGS
9853
9854 =item AUTHORS
9855
9856 =back
9857
9858 =head2 CGI - Simple Common Gateway Interface Class
9859
9860 =over 4
9861
9862 =item SYNOPSIS
9863
9864 =item ABSTRACT
9865
9866 =item DESCRIPTION
9867
9868 =over 4
9869
9870 =item PROGRAMMING STYLE
9871
9872 =item CALLING CGI.PM ROUTINES
9873
9874 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9875
9876 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9877
9878 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9879
9880 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9881
9882 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9883
9884 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9885
9886 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9887
9888 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9889
9890 =item DELETING A PARAMETER COMPLETELY:
9891
9892 =item DELETING ALL PARAMETERS:
9893
9894 =item DIRECT ACCESS TO THE PARAMETER LIST:
9895
9896 =item FETCHING THE PARAMETER LIST AS A HASH:
9897
9898 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9899
9900 =item RETRIEVING CGI ERRORS
9901
9902 =item USING THE FUNCTION-ORIENTED INTERFACE
9903
9904 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9905 B<:standard>, B<:all>
9906
9907 =item PRAGMAS
9908
9909 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9910 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9911 -private_tempfiles
9912
9913 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9914
9915 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9916 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9917 a </ul> tag)
9918
9919 =back
9920
9921 =item GENERATING DYNAMIC DOCUMENTS
9922
9923 =over 4
9924
9925 =item CREATING A STANDARD HTTP HEADER:
9926
9927 =item GENERATING A REDIRECTION HEADER
9928
9929 =item CREATING THE HTML DOCUMENT HEADER
9930
9931 B<Parameters:>, 4, 5, 6..
9932
9933 =item ENDING THE HTML DOCUMENT:
9934
9935 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9936
9937 =item OBTAINING THE SCRIPT'S URL
9938
9939 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9940 (B<-query_string>), B<-base>
9941
9942 =item MIXING POST AND URL PARAMETERS
9943
9944 =back
9945
9946 =item CREATING STANDARD HTML ELEMENTS:
9947
9948 =over 4
9949
9950 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9951
9952 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9953
9954 =item HTML SHORTCUTS AND LIST INTERPOLATION
9955
9956 =item NON-STANDARD HTML SHORTCUTS
9957
9958 =item AUTOESCAPING HTML
9959
9960 $escaped_string = escapeHTML("unescaped string");, $charset =
9961 charset([$charset]);, $flag = autoEscape([$flag]);
9962
9963 =item PRETTY-PRINTING HTML
9964
9965 =back
9966
9967 =item CREATING FILL-OUT FORMS:
9968
9969 =over 4
9970
9971 =item CREATING AN ISINDEX TAG
9972
9973 =item STARTING AND ENDING A FORM
9974
9975 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9976
9977 =item CREATING A TEXT FIELD
9978
9979 B<Parameters>
9980
9981 =item CREATING A BIG TEXT FIELD
9982
9983 =item CREATING A PASSWORD FIELD
9984
9985 =item CREATING A FILE UPLOAD FIELD
9986
9987 B<Parameters>
9988
9989 =item CREATING A POPUP MENU
9990
9991 =item CREATING A SCROLLING LIST
9992
9993 B<Parameters:>
9994
9995 =item CREATING A GROUP OF RELATED CHECKBOXES
9996
9997 B<Parameters:>
9998
9999 =item CREATING A STANDALONE CHECKBOX
10000
10001 B<Parameters:>
10002
10003 =item CREATING A RADIO BUTTON GROUP
10004
10005 B<Parameters:>
10006
10007 =item CREATING A SUBMIT BUTTON 
10008
10009 B<Parameters:>
10010
10011 =item CREATING A RESET BUTTON
10012
10013 =item CREATING A DEFAULT BUTTON
10014
10015 =item CREATING A HIDDEN FIELD
10016
10017 B<Parameters:>
10018
10019 =item CREATING A CLICKABLE IMAGE BUTTON
10020
10021 B<Parameters:>
10022
10023 =item CREATING A JAVASCRIPT ACTION BUTTON
10024
10025 =back
10026
10027 =item HTTP COOKIES
10028
10029 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10030 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10031
10032 =item WORKING WITH FRAMES
10033
10034 1. Create a <Frameset> document, 2. Specify the destination for the
10035 document in the HTTP header, 3. Specify the destination for the document in
10036 the <form> tag
10037
10038 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10039
10040 =item DEBUGGING
10041
10042 =over 4
10043
10044 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10045
10046 =back
10047
10048 =item FETCHING ENVIRONMENT VARIABLES
10049
10050 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10051 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10052 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10053 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10054 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10055
10056 =item USING NPH SCRIPTS
10057
10058 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10059 parameters
10060
10061 =item Server Push
10062
10063 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10064
10065 =item Avoiding Denial of Service Attacks
10066
10067 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10068 basis>, B<2. Globally for all scripts>
10069
10070 =item COMPATIBILITY WITH CGI-LIB.PL
10071
10072 =item AUTHOR INFORMATION
10073
10074 =item CREDITS
10075
10076 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10077 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10078 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10079 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10080 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10081 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10082 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10083 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10084 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10085 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10086 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10087 ...and many many more..
10088
10089 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10090
10091 =item BUGS
10092
10093 =item SEE ALSO
10094
10095 =back
10096
10097 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10098
10099 =over 4
10100
10101 =item SYNOPSIS
10102
10103 =item ABSTRACT
10104
10105 =item DESCRIPTION
10106
10107 =item AUTHOR INFORMATION
10108
10109 =item BUGS
10110
10111 =item SEE ALSO
10112
10113 =back
10114
10115 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10116 other) error log
10117
10118 =over 4
10119
10120 =item SYNOPSIS
10121
10122 =item DESCRIPTION
10123
10124 =item REDIRECTING ERROR MESSAGES
10125
10126 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10127
10128 =over 4
10129
10130 =item Changing the default message
10131
10132 =back
10133
10134 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10135
10136 =item CHANGE LOG
10137
10138 =item AUTHORS
10139
10140 =item SEE ALSO
10141
10142 =back
10143
10144 =head2 CGI::Cookie - Interface to Netscape Cookies
10145
10146 =over 4
10147
10148 =item SYNOPSIS
10149
10150 =item DESCRIPTION
10151
10152 =item USING CGI::Cookie
10153
10154 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10155
10156 =over 4
10157
10158 =item Creating New Cookies
10159
10160 =item Sending the Cookie to the Browser
10161
10162 =item Recovering Previous Cookies
10163
10164 =item Manipulating Cookies
10165
10166 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10167
10168 =back
10169
10170 =item AUTHOR INFORMATION
10171
10172 =item BUGS
10173
10174 =item SEE ALSO
10175
10176 =back
10177
10178 =head2 CGI::Fast - CGI Interface for Fast CGI
10179
10180 =over 4
10181
10182 =item SYNOPSIS
10183
10184 =item DESCRIPTION
10185
10186 =item OTHER PIECES OF THE PUZZLE
10187
10188 =item WRITING FASTCGI PERL SCRIPTS
10189
10190 =item INSTALLING FASTCGI SCRIPTS
10191
10192 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10193
10194 =item EXTERNAL FASTCGI SERVER INVOCATION
10195
10196 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10197
10198 =item CAVEATS
10199
10200 =item AUTHOR INFORMATION
10201
10202 =item BUGS
10203
10204 =item SEE ALSO
10205
10206 =back
10207
10208 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10209
10210 =over 4
10211
10212 =item SYNOPSIS
10213
10214 =item DESCRIPTION
10215
10216 =over 4
10217
10218 =item Tags that won't be formatted
10219
10220 =item Customizing the Indenting
10221
10222 =back
10223
10224 =item BUGS
10225
10226 =item AUTHOR
10227
10228 =item SEE ALSO
10229
10230 =back
10231
10232 =head2 CGI::Push - Simple Interface to Server Push
10233
10234 =over 4
10235
10236 =item SYNOPSIS
10237
10238 =item DESCRIPTION
10239
10240 =item USING CGI::Push
10241
10242 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10243
10244 =over 4
10245
10246 =item Heterogeneous Pages
10247
10248 =item Changing the Page Delay on the Fly
10249
10250 =back
10251
10252 =item INSTALLING CGI::Push SCRIPTS
10253
10254 =item AUTHOR INFORMATION
10255
10256 =item BUGS
10257
10258 =item SEE ALSO
10259
10260 =back
10261
10262 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10263
10264 =over 4
10265
10266 =item SYNOPSIS
10267
10268 =item ABSTRACT
10269
10270 =item DESCRIPTION
10271
10272 =item AUTHOR INFORMATION
10273
10274 =item BUGS
10275
10276 =item SEE ALSO
10277
10278 =back
10279
10280 =head2 CGI::Util - Internal utilities used by CGI module
10281
10282 =over 4
10283
10284 =item SYNOPSIS
10285
10286 =item DESCRIPTION
10287
10288 =item AUTHOR INFORMATION
10289
10290 =item SEE ALSO
10291
10292 =back
10293
10294 =head2 CPAN - query, download and build perl modules from CPAN sites
10295
10296 =over 4
10297
10298 =item SYNOPSIS
10299
10300 =item DESCRIPTION
10301
10302 =over 4
10303
10304 =item Interactive Mode
10305
10306 Searching for authors, bundles, distribution files and modules, make, test,
10307 install, clean  modules or distributions, get, readme, look module or
10308 distribution, ls author, Signals
10309
10310 =item CPAN::Shell
10311
10312 =item autobundle
10313
10314 =item recompile
10315
10316 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10317
10318 =item Programmer's interface
10319
10320 expand($type,@things), expandany(@things), Programming Examples
10321
10322 =item Methods in the other Classes
10323
10324 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10325 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10326 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10327 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10328 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10329 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10330 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10331 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10332 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10333 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10334 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10335 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10336 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10337 CPAN::Distribution::look(), CPAN::Distribution::make(),
10338 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10339 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10340 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10341 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10342 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10343 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10344 CPAN::Module::description(), CPAN::Module::force($method,@args),
10345 CPAN::Module::get(), CPAN::Module::inst_file(),
10346 CPAN::Module::inst_version(), CPAN::Module::install(),
10347 CPAN::Module::look(), CPAN::Module::make(),
10348 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10349 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10350
10351 =item Cache Manager
10352
10353 =item Bundles
10354
10355 =item Prerequisites
10356
10357 =item Finding packages and VERSION
10358
10359 =item Debugging
10360
10361 =item Floppy, Zip, Offline Mode
10362
10363 =back
10364
10365 =item CONFIGURATION
10366
10367 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10368 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10369 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10370 [unshift|push|splice] E<lt>listE<gt>>
10371
10372 =over 4
10373
10374 =item Note on urllist parameter's format
10375
10376 =item urllist parameter has CD-ROM support
10377
10378 =back
10379
10380 =item SECURITY
10381
10382 =item EXPORT
10383
10384 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10385
10386 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10387
10388 =over 4
10389
10390 =item Three basic types of firewalls
10391
10392 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10393
10394 =item Configuring lynx or ncftp for going through a firewall
10395
10396 =back
10397
10398 =item FAQ
10399
10400 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10401
10402 =item BUGS
10403
10404 =item AUTHOR
10405
10406 =item TRANSLATIONS
10407
10408 =item SEE ALSO
10409
10410 =back
10411
10412 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10413
10414 =over 4
10415
10416 =item SYNOPSIS
10417
10418 =item DESCRIPTION
10419
10420 =back
10421
10422 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10423 module
10424
10425 =over 4
10426
10427 =item SYNOPSIS
10428
10429 =item DESCRIPTION
10430
10431 =item  SEE ALSO
10432
10433 =back
10434
10435 =head2 Carp, carp    - warn of errors (from perspective of caller)
10436
10437 =over 4
10438
10439 =item SYNOPSIS
10440
10441 =item DESCRIPTION
10442
10443 =over 4
10444
10445 =item Forcing a Stack Trace
10446
10447 =back
10448
10449 =item BUGS
10450
10451 =back
10452
10453 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10454
10455 =head2 Class::ISA -- report the search path for a class's ISA tree
10456
10457 =over 4
10458
10459 =item SYNOPSIS
10460
10461 =item DESCRIPTION
10462
10463 =item FUNCTIONS
10464
10465 the function Class::ISA::super_path($CLASS), the function
10466 Class::ISA::self_and_super_path($CLASS), the function
10467 Class::ISA::self_and_super_versions($CLASS)
10468
10469 =item CAUTIONARY NOTES
10470
10471 =item COPYRIGHT
10472
10473 =item AUTHOR
10474
10475 =back
10476
10477 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10478
10479 =over 4
10480
10481 =item SYNOPSIS
10482
10483 =item DESCRIPTION
10484
10485 =over 4
10486
10487 =item The C<struct()> function
10488
10489 =item Class Creation at Compile Time
10490
10491 =item Element Types and Accessor Methods
10492
10493 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10494 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10495
10496 =item Initializing with C<new>
10497
10498 =back
10499
10500 =item EXAMPLES
10501
10502 Example 1, Example 2, Example 3
10503
10504 =item Author and Modification History
10505
10506 =back
10507
10508 =head2 Config - access Perl configuration information
10509
10510 =over 4
10511
10512 =item SYNOPSIS
10513
10514 =item DESCRIPTION
10515
10516 myconfig(), config_sh(), config_vars(@names)
10517
10518 =item EXAMPLE
10519
10520 =item WARNING
10521
10522 =item GLOSSARY
10523
10524 =over 4
10525
10526 =item _
10527
10528 C<_a>, C<_exe>, C<_o>
10529
10530 =item a
10531
10532 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10533 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10534 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10535 C<asctime_r_proto>, C<awk>
10536
10537 =item b
10538
10539 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10540
10541 =item c
10542
10543 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10544 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10545 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10546 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10547 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10548 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10549 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10550
10551 =item d
10552
10553 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10554 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10555 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10556 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10557 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10558 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10559 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10560 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10561 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10562 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10563 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10564 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10565 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10566 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10567 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10568 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10569 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10570 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10571 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10572 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10573 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10574 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10575 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10576 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10577 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10578 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10579 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10580 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10581 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10582 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10583 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10584 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10585 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10586 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10587 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10588 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10589 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10590 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10591 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10592 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10593 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10594 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10595 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10596 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10597 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10598 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10599 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10600 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10601 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10602 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10603 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10604 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10605 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10606 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10607 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10608 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10609 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10610 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10611 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10612 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10613 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10614 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10615 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10616 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10617 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10618 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10619 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10620 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10621 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10622 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10623 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10624 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10625 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10626 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10627 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10628 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10629 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10630 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10631 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10632 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10633 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10634 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10635 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10636 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10637 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10638 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10639 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10640 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10641 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10642 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10643
10644 =item e
10645
10646 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10647 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10648 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10649 C<expr>, C<extensions>, C<extras>
10650
10651 =item f
10652
10653 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10654 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10655 C<full_sed>
10656
10657 =item g
10658
10659 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10660 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10661 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10662 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10663 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10664 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10665 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10666 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10667 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10668 C<gzip>
10669
10670 =item h
10671
10672 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10673
10674 =item i
10675
10676 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10677 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10678 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10679 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10680 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10681 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10682 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10683 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10684 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10685 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10686 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10687 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10688 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10689 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10690 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10691 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10692 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10693 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10694 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10695 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10696 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10697 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10698 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10699 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10700
10701 =item k
10702
10703 C<known_extensions>, C<ksh>
10704
10705 =item l
10706
10707 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10708 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10709 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10710 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10711 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10712 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10713 C<lseektype>
10714
10715 =item m
10716
10717 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10718 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10719 C<man3direxp>, C<man3ext>
10720
10721 =item M
10722
10723 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10724 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10725
10726 =item n
10727
10728 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10729 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10730 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10731 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10732 C<nvsize>, C<nvtype>
10733
10734 =item o
10735
10736 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10737 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10738
10739 =item p
10740
10741 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10742 C<perl>, C<perl_patchlevel>
10743
10744 =item P
10745
10746 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10747 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10748 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10749 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10750
10751 =item q
10752
10753 C<quadkind>, C<quadtype>
10754
10755 =item r
10756
10757 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10758 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10759 C<rmail>, C<run>, C<runnm>
10760
10761 =item s
10762
10763 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10764 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10765 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10766 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10767 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10768 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10769 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10770 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10771 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10772 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10773 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10774 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10775 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10776 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10777 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10778 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10779 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10780
10781 =item t
10782
10783 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10784 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10785 C<ttyname_r_proto>
10786
10787 =item u
10788
10789 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10790 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10791 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10792 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10793 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10794 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10795 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10796 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10797 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10798
10799 =item v
10800
10801 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10802 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10803 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10804 C<versiononly>, C<vi>, C<voidflags>
10805
10806 =item x
10807
10808 C<xlibpth>, C<xs_apiversion>
10809
10810 =item y
10811
10812 C<yacc>, C<yaccflags>
10813
10814 =item z
10815
10816 C<zcat>, C<zip>
10817
10818 =back
10819
10820 =item NOTE
10821
10822 =back
10823
10824 =head2 Cwd - get pathname of current working directory
10825
10826 =over 4
10827
10828 =item SYNOPSIS
10829
10830 =item DESCRIPTION
10831
10832 =over 4
10833
10834 =item getcwd and friends
10835
10836 getcwd, cwd, fastcwd, fastgetcwd
10837
10838 =item abs_path and friends
10839
10840 abs_path, realpath, fast_abs_path
10841
10842 =item $ENV{PWD}
10843
10844 =back
10845
10846 =item NOTES
10847
10848 =item SEE ALSO
10849
10850 =back
10851
10852 =head2 DB - programmatic interface to the Perl debugging API (draft,
10853 subject to
10854 change)
10855
10856 =over 4
10857
10858 =item SYNOPSIS
10859
10860 =item DESCRIPTION
10861
10862 =over 4
10863
10864 =item Global Variables
10865
10866  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
10867 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
10868 $DB::lineno
10869
10870 =item API Methods
10871
10872 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10873 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10874
10875 =item Client Callback Methods
10876
10877 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10878 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10879 CLIENT->output(LIST)
10880
10881 =back
10882
10883 =item BUGS
10884
10885 =item AUTHOR
10886
10887 =back
10888
10889 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10890
10891 =over 4
10892
10893 =item SYNOPSIS
10894
10895 =item DESCRIPTION
10896
10897 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10898
10899 =over 4
10900
10901 =item Using DB_File with Berkeley DB version 2 or greater
10902
10903 =item Interface to Berkeley DB
10904
10905 =item Opening a Berkeley DB Database File
10906
10907 =item Default Parameters
10908
10909 =item In Memory Databases
10910
10911 =back
10912
10913 =item DB_HASH
10914
10915 =over 4
10916
10917 =item A Simple Example
10918
10919 =back
10920
10921 =item DB_BTREE
10922
10923 =over 4
10924
10925 =item Changing the BTREE sort order
10926
10927 =item Handling Duplicate Keys 
10928
10929 =item The get_dup() Method
10930
10931 =item The find_dup() Method
10932
10933 =item The del_dup() Method
10934
10935 =item Matching Partial Keys 
10936
10937 =back
10938
10939 =item DB_RECNO
10940
10941 =over 4
10942
10943 =item The 'bval' Option
10944
10945 =item A Simple Example
10946
10947 =item Extra RECNO Methods
10948
10949 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10950 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10951 length, elements);>
10952
10953 =item Another Example
10954
10955 =back
10956
10957 =item THE API INTERFACE
10958
10959 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10960 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10961 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10962 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10963
10964 =item DBM FILTERS
10965
10966 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10967 B<filter_fetch_value>
10968
10969 =over 4
10970
10971 =item The Filter
10972
10973 =item An Example -- the NULL termination problem.
10974
10975 =item Another Example -- Key is a C int.
10976
10977 =back
10978
10979 =item HINTS AND TIPS 
10980
10981 =over 4
10982
10983 =item Locking: The Trouble with fd
10984
10985 =item Safe ways to lock a database
10986
10987 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10988
10989 =item Sharing Databases With C Applications
10990
10991 =item The untie() Gotcha
10992
10993 =back
10994
10995 =item COMMON QUESTIONS
10996
10997 =over 4
10998
10999 =item Why is there Perl source in my database?
11000
11001 =item How do I store complex data structures with DB_File?
11002
11003 =item What does "Invalid Argument" mean?
11004
11005 =item What does "Bareword 'DB_File' not allowed" mean? 
11006
11007 =back
11008
11009 =item REFERENCES
11010
11011 =item HISTORY
11012
11013 =item BUGS
11014
11015 =item AVAILABILITY
11016
11017 =item COPYRIGHT
11018
11019 =item SEE ALSO
11020
11021 =item AUTHOR
11022
11023 =back
11024
11025 =head2 Data::Dumper - stringified perl data structures, suitable for both
11026 printing and C<eval>
11027
11028 =over 4
11029
11030 =item SYNOPSIS
11031
11032 =item DESCRIPTION
11033
11034 =over 4
11035
11036 =item Methods
11037
11038 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
11039 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11040 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11041 I<$OBJ>->Reset
11042
11043 =item Functions
11044
11045 Dumper(I<LIST>)
11046
11047 =item Configuration Variables or Methods
11048
11049 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11050 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11051 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11052 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11053 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11054 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11055 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11056 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11057 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11058 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11059 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11060 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11061 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11062 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11063 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11064
11065 =item Exports
11066
11067 Dumper
11068
11069 =back
11070
11071 =item EXAMPLES
11072
11073 =item BUGS
11074
11075 =item AUTHOR
11076
11077 =item VERSION
11078
11079 =item SEE ALSO
11080
11081 =back
11082
11083 =head2 Devel::DProf - a Perl code profiler
11084
11085 =over 4
11086
11087 =item SYNOPSIS
11088
11089 =item DESCRIPTION
11090
11091 =item PROFILE FORMAT
11092
11093 =item AUTOLOAD
11094
11095 =item ENVIRONMENT
11096
11097 =item BUGS
11098
11099 =item SEE ALSO
11100
11101 =back
11102
11103 =head2 Devel::PPPort, Perl/Pollution/Portability
11104
11105 =over 4
11106
11107 =item SYNOPSIS
11108
11109 =item DESCRIPTION
11110
11111 =over 4
11112
11113 =item WriteFile
11114
11115 =back
11116
11117 =item ppport.h
11118
11119 =item AUTHOR
11120
11121 =item SEE ALSO
11122
11123 =back
11124
11125 =head2 Devel::Peek - A data debugging tool for the XS programmer
11126
11127 =over 4
11128
11129 =item SYNOPSIS
11130
11131 =item DESCRIPTION
11132
11133 =over 4
11134
11135 =item Runtime debugging
11136
11137 =item Memory footprint debugging
11138
11139 =back
11140
11141 =item EXAMPLES
11142
11143 =over 4
11144
11145 =item A simple scalar string
11146
11147 =item A simple scalar number
11148
11149 =item A simple scalar with an extra reference
11150
11151 =item A reference to a simple scalar
11152
11153 =item A reference to an array
11154
11155 =item A reference to a hash
11156
11157 =item Dumping a large array or hash
11158
11159 =item A reference to an SV which holds a C pointer
11160
11161 =item A reference to a subroutine
11162
11163 =back
11164
11165 =item EXPORTS
11166
11167 =item BUGS
11168
11169 =item AUTHOR
11170
11171 =item SEE ALSO
11172
11173 =back
11174
11175 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11176
11177 =over 4
11178
11179 =item SYNOPSIS
11180
11181 =item DESCRIPTION
11182
11183 =back
11184
11185 =head2 Digest:: - Modules that calculate message digests
11186
11187 =over 4
11188
11189 =item SYNOPSIS
11190
11191 =item DESCRIPTION
11192
11193 I<binary>, I<hex>, I<base64>
11194
11195 =item OO INTERFACE
11196
11197 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11198 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11199 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11200
11201 =item SEE ALSO
11202
11203 =item AUTHOR
11204
11205 =back
11206
11207 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11208
11209 =over 4
11210
11211 =item SYNOPSIS
11212
11213 =item DESCRIPTION
11214
11215 =item FUNCTIONS
11216
11217 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11218
11219 =item METHODS
11220
11221 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11222 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11223
11224 =item EXAMPLES
11225
11226 =item SEE ALSO
11227
11228 =item COPYRIGHT
11229
11230 =item AUTHORS
11231
11232 =back
11233
11234 =head2 DirHandle - supply object methods for directory handles
11235
11236 =over 4
11237
11238 =item SYNOPSIS
11239
11240 =item DESCRIPTION
11241
11242 =item NOTES
11243
11244 =back
11245
11246 =head2 Dumpvalue - provides screen dump of Perl data.
11247
11248 =over 4
11249
11250 =item SYNOPSIS
11251
11252 =item DESCRIPTION
11253
11254 =over 4
11255
11256 =item Creation
11257
11258 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11259 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11260 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11261 stopDbSignal
11262
11263 =item Methods
11264
11265 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11266 compactDump, veryCompact, set, get
11267
11268 =back
11269
11270 =back
11271
11272 =head2 DynaLoader - Dynamically load C libraries into Perl code
11273
11274 =over 4
11275
11276 =item SYNOPSIS
11277
11278 =item DESCRIPTION
11279
11280 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11281 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11282 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11283 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11284 bootstrap()
11285
11286 =item AUTHOR
11287
11288 =back
11289
11290 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11291 Perl code
11292
11293 =over 4
11294
11295 =item SYNOPSIS
11296
11297 =item DESCRIPTION
11298
11299 =item AUTHOR
11300
11301 =back
11302
11303 =head2 Encode - character encodings
11304
11305 =over 4
11306
11307 =item SYNOPSIS
11308
11309 =over 4
11310
11311 =item Table of Contents
11312
11313 =back
11314
11315 =item DESCRIPTION
11316
11317 =over 4
11318
11319 =item TERMINOLOGY
11320
11321 =back
11322
11323 =item PERL ENCODING API
11324
11325 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11326 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11327 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11328 CHECK]);
11329
11330 =over 4
11331
11332 =item Listing available encodings
11333
11334 =item Defining Aliases
11335
11336 =back
11337
11338 =item Encoding via PerlIO
11339
11340 =item Handling Malformed Data
11341
11342 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11343 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11344 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11345 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11346 bitmask
11347
11348 =over 4
11349
11350 =item Unimplemented fallback schemes
11351
11352 =back
11353
11354 =item Defining Encodings
11355
11356 =item The UTF-8 flag
11357
11358 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11359
11360 =over 4
11361
11362 =item Messing with Perl's Internals
11363
11364 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11365
11366 =back
11367
11368 =item SEE ALSO
11369
11370 =item MAINTAINER
11371
11372 =back
11373
11374 =head2 Encode::Alias - alias definitions to encodings
11375
11376 =over 4
11377
11378 =item SYNOPSIS
11379
11380 =item DESCRIPTION
11381
11382 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11383 reference, e.g.:
11384
11385 =over 4
11386
11387 =item Alias overloading
11388
11389 =back
11390
11391 =item SEE ALSO
11392
11393 =back
11394
11395 =head2 Encode::Byte - Single Byte Encodings
11396
11397 =over 4
11398
11399 =item SYNOPSIS
11400
11401 =item ABSTRACT
11402
11403 =item DESCRIPTION
11404
11405 =item SEE ALSO
11406
11407 =back
11408
11409 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11410
11411 =head2 Encode::CN - China-based Chinese Encodings
11412
11413 =over 4
11414
11415 =item SYNOPSIS
11416
11417 =item DESCRIPTION
11418
11419 =item NOTES
11420
11421 =item BUGS
11422
11423 =item SEE ALSO
11424
11425 =back
11426
11427 =head2 Encode::CN::HZ -- internally used by Encode::CN
11428
11429 =head2 Encode::Config -- internally used by Encode
11430
11431 =head2 Encode::EBCDIC - EBCDIC Encodings
11432
11433 =over 4
11434
11435 =item SYNOPSIS
11436
11437 =item ABSTRACT
11438
11439 =item DESCRIPTION
11440
11441 =item SEE ALSO
11442
11443 =back
11444
11445 =head2 Encode::Encoding - Encode Implementation Base Class
11446
11447 =over 4
11448
11449 =item SYNOPSIS
11450
11451 =item DESCRIPTION
11452
11453 =over 4
11454
11455 =item Methods you should implement
11456
11457 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11458
11459 =item Other methods defined in Encode::Encodings
11460
11461 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11462
11463 =item Example: Encode::ROT13
11464
11465 =back
11466
11467 =item Why the heck Encode API is different?
11468
11469 =over 4
11470
11471 =item Compiled Encodings
11472
11473 =back
11474
11475 =item SEE ALSO
11476
11477 Scheme 1, Scheme 2, Other Schemes
11478
11479 =back
11480
11481 =head2 Encode::Guess -- Guesses encoding from data
11482
11483 =over 4
11484
11485 =item SYNOPSIS
11486
11487 =item ABSTRACT
11488
11489 =item DESCRIPTION
11490
11491 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11492 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11493 guess_encoding($data, [, I<list of suspects>])
11494
11495 =item CAVEATS
11496
11497 =item TO DO
11498
11499 =item SEE ALSO
11500
11501 =back
11502
11503 =head2 Encode::JP - Japanese Encodings
11504
11505 =over 4
11506
11507 =item SYNOPSIS
11508
11509 =item ABSTRACT
11510
11511 =item DESCRIPTION
11512
11513 =item Note on ISO-2022-JP(-1)?
11514
11515 =item BUGS
11516
11517 =item SEE ALSO
11518
11519 =back
11520
11521 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11522
11523 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11524
11525 =head2 Encode::KR - Korean Encodings
11526
11527 =over 4
11528
11529 =item SYNOPSIS
11530
11531 =item DESCRIPTION
11532
11533 =item BUGS
11534
11535 =item SEE ALSO
11536
11537 =back
11538
11539 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11540
11541 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11542
11543 =over 4
11544
11545 =item SYNOPSIS
11546
11547 =item ABSTRACT
11548
11549 =item DESCRIPTION
11550
11551 =item BUGS
11552
11553 =item SEE ALSO
11554
11555 =back
11556
11557 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11558
11559 =over 4
11560
11561 =item Overview
11562
11563 =item How does it work?
11564
11565 =item BUGS
11566
11567 =over 4
11568
11569 =item Workaround
11570
11571 =item How can I tell whether my encoding fully supports PerlIO ?
11572
11573 =back
11574
11575 =item SEE ALSO
11576
11577 =back
11578
11579 =head2 Encode::Supported -- Encodings supported by Encode
11580
11581 =over 4
11582
11583 =item DESCRIPTION
11584
11585 =over 4
11586
11587 =item Encoding Names
11588
11589 =back
11590
11591 =item Supported Encodings
11592
11593 =over 4
11594
11595 =item Built-in Encodings
11596
11597 =item Encode::Unicode -- other Unicode encodings
11598
11599 =item Encode::Byte -- Extended ASCII
11600
11601 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11602 the Cyrillic world, gsm0338 - Hentai Latin 1
11603
11604 =item CJK: Chinese, Japanese, Korean (Multibyte)
11605
11606 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11607 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11608 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11609
11610 =item Miscellaneous encodings
11611
11612 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11613
11614 =back
11615
11616 =item Unsupported encodings
11617
11618   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11619 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11620 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11621 Various Mac encodings, (Mac) Indic encodings
11622
11623 =item Encoding vs. Charset -- terminology
11624
11625 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11626
11627 =over 4
11628
11629 =item Microsoft-related naming mess
11630
11631 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11632
11633 =back
11634
11635 =item Glossary
11636
11637 character repertoire, coded character set (CCS), character encoding scheme
11638 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11639 UTF-16
11640
11641 =item See Also
11642
11643 =item References
11644
11645 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11646 RFC, UC, Unicode Glossary
11647
11648 =over 4
11649
11650 =item Other Notable Sites
11651
11652 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11653 "Introduction to i18n"
11654
11655 =item Offline sources
11656
11657 C<CJKV Information Processing> by Ken Lunde
11658
11659 =back
11660
11661 =back
11662
11663 =head2 Encode::Symbol - Symbol Encodings
11664
11665 =over 4
11666
11667 =item SYNOPSIS
11668
11669 =item ABSTRACT
11670
11671 =item DESCRIPTION
11672
11673 =item SEE ALSO
11674
11675 =back
11676
11677 =head2 Encode::TW - Taiwan-based Chinese Encodings
11678
11679 =over 4
11680
11681 =item SYNOPSIS
11682
11683 =item DESCRIPTION
11684
11685 =item NOTES
11686
11687 =item BUGS
11688
11689 =item SEE ALSO
11690
11691 =back
11692
11693 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11694
11695 =over 4
11696
11697 =item SYNOPSIS
11698
11699 =item ABSTRACT
11700
11701 L<http://www.unicode.org/glossary/> says:, Quick Reference
11702
11703 =item Size, Endianness, and BOM
11704
11705 =over 4
11706
11707 =item by size
11708
11709 =item by endianness
11710
11711 BOM as integer when fetched in network byte order
11712
11713 =back
11714
11715 =item Surrogate Pairs
11716
11717 =item SEE ALSO
11718
11719 =back
11720
11721 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11722 encodings
11723
11724 =over 4
11725
11726 =item SYNOPSIS
11727
11728 =item DESCRIPTION
11729
11730 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11731 reference, e.g.:
11732
11733 =over 4
11734
11735 =item Alias overloading
11736
11737 =back
11738
11739 =item SEE ALSO
11740
11741 =back
11742
11743 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11744 Internally used by Encode::??::ISO_2022_*
11745
11746 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11747 Encode::CN
11748
11749 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11750 Encode
11751
11752 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11753 Implementation Base Class
11754
11755 =over 4
11756
11757 =item SYNOPSIS
11758
11759 =item DESCRIPTION
11760
11761 =over 4
11762
11763 =item Methods you should implement
11764
11765 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11766
11767 =item Other methods defined in Encode::Encodings
11768
11769 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11770
11771 =item Example: Encode::ROT13
11772
11773 =back
11774
11775 =item Why the heck Encode API is different?
11776
11777 =over 4
11778
11779 =item Compiled Encodings
11780
11781 =back
11782
11783 =item SEE ALSO
11784
11785 Scheme 1, Scheme 2, Other Schemes
11786
11787 =back
11788
11789 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11790 data
11791
11792 =over 4
11793
11794 =item SYNOPSIS
11795
11796 =item ABSTRACT
11797
11798 =item DESCRIPTION
11799
11800 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11801 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11802 guess_encoding($data, [, I<list of suspects>])
11803
11804 =item CAVEATS
11805
11806 =item TO DO
11807
11808 =item SEE ALSO
11809
11810 =back
11811
11812 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11813 Encode::JP::2022_JP*
11814
11815 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11816 by Encode::JP
11817
11818 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11819 used by Encode::KR
11820
11821 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11822 and 'Q' header encoding
11823
11824 =over 4
11825
11826 =item SYNOPSIS
11827
11828 =item ABSTRACT
11829
11830 =item DESCRIPTION
11831
11832 =item BUGS
11833
11834 =item SEE ALSO
11835
11836 =back
11837
11838 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11839 on Encode and PerlIO
11840
11841 =over 4
11842
11843 =item Overview
11844
11845 =item How does it work?
11846
11847 =item BUGS
11848
11849 =over 4
11850
11851 =item Workaround
11852
11853 =item How can I tell whether my encoding fully supports PerlIO ?
11854
11855 =back
11856
11857 =item SEE ALSO
11858
11859 =back
11860
11861 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11862 supported by Encode
11863
11864 =over 4
11865
11866 =item DESCRIPTION
11867
11868 =over 4
11869
11870 =item Encoding Names
11871
11872 =back
11873
11874 =item Supported Encodings
11875
11876 =over 4
11877
11878 =item Built-in Encodings
11879
11880 =item Encode::Unicode -- other Unicode encodings
11881
11882 =item Encode::Byte -- Extended ASCII
11883
11884 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11885 the Cyrillic world, gsm0338 - Hentai Latin 1
11886
11887 =item CJK: Chinese, Japanese, Korean (Multibyte)
11888
11889 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11890 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11891 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11892
11893 =item Miscellaneous encodings
11894
11895 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11896
11897 =back
11898
11899 =item Unsupported encodings
11900
11901   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11902 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11903 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11904 Various Mac encodings, (Mac) Indic encodings
11905
11906 =item Encoding vs. Charset -- terminology
11907
11908 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11909
11910 =over 4
11911
11912 =item Microsoft-related naming mess
11913
11914 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11915
11916 =back
11917
11918 =item Glossary
11919
11920 character repertoire, coded character set (CCS), character encoding scheme
11921 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11922 UTF-16
11923
11924 =item See Also
11925
11926 =item References
11927
11928 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11929 RFC, UC, Unicode Glossary
11930
11931 =over 4
11932
11933 =item Other Notable Sites
11934
11935 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11936 "Introduction to i18n"
11937
11938 =item Offline sources
11939
11940 C<CJKV Information Processing> by Ken Lunde
11941
11942 =back
11943
11944 =back
11945
11946 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11947
11948 =over 4
11949
11950 =item SYNOPSIS
11951
11952   use Encode::Encoder;
11953   # Encode::encode("ISO-8859-1", $data); 
11954   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11955   # shortcut
11956   use Encode::Encoder qw(encoder);
11957   encoder($data)->iso_8859_1;
11958   # you can stack them!
11959   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11960   # you can use it as a decoder as well
11961   encoder($base64)->bytes('base64')->latin1;
11962   # stringified
11963   print encoder($data)->utf8->latin1;  # prints the string in latin1
11964   # numified
11965   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11966
11967 =item ABSTRACT
11968
11969 =item Description
11970
11971 =over 4
11972
11973 =item Predefined Methods
11974
11975 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11976 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11977 $e-E<gt>bytes([$encoding])
11978
11979 =item Example: base64 transcoder
11980
11981 =item Operator Overloading
11982
11983 =back
11984
11985 =item SEE ALSO
11986
11987 =back
11988
11989 =head2 Encodencoding, encoding - allows you to write your script in
11990 non-ascii or non-utf8
11991
11992 =over 4
11993
11994 =item SYNOPSIS
11995
11996 =item ABSTRACT
11997
11998 =item USAGE
11999
12000 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12001 I<ENCNAME_IN> ...] ;, no encoding;
12002
12003 =item CAVEATS
12004
12005 =over 4
12006
12007 =item NOT SCOPED
12008
12009 =item DO NOT MIX MULTIPLE ENCODINGS
12010
12011 =back
12012
12013 =item Non-ASCII Identifiers and Filter option
12014
12015 use encoding I<ENCNAME> Filter=E<gt>1;
12016
12017 =item EXAMPLE - Greekperl
12018
12019 =item KNOWN PROBLEMS
12020
12021 =item SEE ALSO
12022
12023 =back
12024
12025 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12026
12027 =over 4
12028
12029 =item SYNOPSIS
12030
12031   use Encode::Encoder;
12032   # Encode::encode("ISO-8859-1", $data); 
12033   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12034   # shortcut
12035   use Encode::Encoder qw(encoder);
12036   encoder($data)->iso_8859_1;
12037   # you can stack them!
12038   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12039   # you can use it as a decoder as well
12040   encoder($base64)->bytes('base64')->latin1;
12041   # stringified
12042   print encoder($data)->utf8->latin1;  # prints the string in latin1
12043   # numified
12044   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12045
12046 =item ABSTRACT
12047
12048 =item Description
12049
12050 =over 4
12051
12052 =item Predefined Methods
12053
12054 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12055 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12056 $e-E<gt>bytes([$encoding])
12057
12058 =item Example: base64 transcoder
12059
12060 =item Operator Overloading
12061
12062 =back
12063
12064 =item SEE ALSO
12065
12066 =back
12067
12068 =head2 English - use nice English (or awk) names for ugly punctuation
12069 variables
12070
12071 =over 4
12072
12073 =item SYNOPSIS
12074
12075 =item DESCRIPTION
12076
12077 =item PERFORMANCE
12078
12079 =back
12080
12081 =head2 Env - perl module that imports environment variables as scalars or
12082 arrays
12083
12084 =over 4
12085
12086 =item SYNOPSIS
12087
12088 =item DESCRIPTION
12089
12090 =item LIMITATIONS
12091
12092 =item AUTHOR
12093
12094 =back
12095
12096 =head2 Errno - System errno constants
12097
12098 =over 4
12099
12100 =item SYNOPSIS
12101
12102 =item DESCRIPTION
12103
12104 =item CAVEATS
12105
12106 =item AUTHOR
12107
12108 =item COPYRIGHT
12109
12110 =back
12111
12112 =head2 Exporter - Implements default import method for modules
12113
12114 =over 4
12115
12116 =item SYNOPSIS
12117
12118 =item DESCRIPTION
12119
12120 =over 4
12121
12122 =item How to Export
12123
12124 =item Selecting What To Export
12125
12126 =item How to Import
12127
12128 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12129
12130 =back
12131
12132 =item Advanced features
12133
12134 =over 4
12135
12136 =item Specialised Import Lists
12137
12138 =item Exporting without using Exporter's import method
12139
12140 =item Module Version Checking
12141
12142 =item Managing Unknown Symbols
12143
12144 =item Tag Handling Utility Functions
12145
12146 =item Generating combined tags
12147
12148 =item C<AUTOLOAD>ed Constants
12149
12150 =back
12151
12152 =back
12153
12154 =head2 Exporter::Heavy - Exporter guts
12155
12156 =over 4
12157
12158 =item SYNOPSIS
12159
12160 =item DESCRIPTION
12161
12162 =back
12163
12164 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12165 Makefiles etc.
12166
12167 =over 4
12168
12169 =item SYNOPSIS
12170
12171 =item DESCRIPTION
12172
12173 =back
12174
12175 cat
12176
12177 eqtime src dst
12178
12179 rm_rf files...
12180
12181 rm_f files...
12182
12183 touch files ..
12184
12185 mv source... destination
12186
12187 cp source... destination
12188
12189 chmod mode files..
12190
12191 mkpath directory..
12192
12193 test_f file
12194
12195 =over 4
12196
12197 =item BUGS
12198
12199 =item SEE ALSO 
12200
12201 =item AUTHOR
12202
12203 =back
12204
12205 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12206
12207 =over 4
12208
12209 =item SYNOPSIS
12210
12211 =item DESCRIPTION
12212
12213 B<test_harness>
12214
12215 =back
12216
12217 =head2 ExtUtils::Constant - generate XS code to import C header constants
12218
12219 =over 4
12220
12221 =item SYNOPSIS
12222
12223 =item DESCRIPTION
12224
12225 =item USAGE
12226
12227 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12228
12229 =item FUNCTIONS
12230
12231 =back
12232
12233 C_stringify NAME
12234
12235 perl_stringify NAME
12236
12237 constant_types
12238
12239 memEQ_clause NAME, CHECKED_AT, INDENT
12240
12241 assign INDENT, TYPE, PRE, POST, VALUE..
12242
12243 return_clause
12244
12245 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12246
12247 params WHAT
12248
12249 dump_names
12250
12251 dogfood
12252
12253 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12254 def_post, utf8
12255
12256 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12257
12258 autoload PACKAGE, VERSION, AUTOLOADER
12259
12260 WriteMakefileSnippet
12261
12262 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12263 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12264
12265 =over 4
12266
12267 =item AUTHOR
12268
12269 =back
12270
12271 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12272
12273 =over 4
12274
12275 =item SYNOPSIS
12276
12277 =item DESCRIPTION
12278
12279 =item @EXPORT
12280
12281 =item FUNCTIONS
12282
12283 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12284 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12285
12286 =item EXAMPLES
12287
12288 =item SEE ALSO
12289
12290 =item AUTHOR
12291
12292 =back
12293
12294 =head2 ExtUtils::Install - install files from here to there
12295
12296 =over 4
12297
12298 =item SYNOPSIS
12299
12300 =item DESCRIPTION
12301
12302 =back
12303
12304 =head2 ExtUtils::Installed - Inventory management of installed modules
12305
12306 =over 4
12307
12308 =item SYNOPSIS
12309
12310 =item DESCRIPTION
12311
12312 =item USAGE
12313
12314 =item FUNCTIONS
12315
12316 new(), modules(), files(), directories(), directory_tree(), validate(),
12317 packlist(), version()
12318
12319 =item EXAMPLE
12320
12321 =item AUTHOR
12322
12323 =back
12324
12325 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12326
12327 =over 4
12328
12329 =item SYNOPSIS
12330
12331 =item DESCRIPTION
12332
12333 For static extensions, For dynamic extensions at build/link time, For
12334 dynamic extensions at load time
12335
12336 =over 4
12337
12338 =item EXTRALIBS
12339
12340 =item LDLOADLIBS and LD_RUN_PATH
12341
12342 =item BSLOADLIBS
12343
12344 =back
12345
12346 =item PORTABILITY
12347
12348 =over 4
12349
12350 =item VMS implementation
12351
12352 =item Win32 implementation
12353
12354 =back
12355
12356 =item SEE ALSO
12357
12358 =back
12359
12360 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12361
12362 =over 4
12363
12364 =item SYNOPSIS
12365
12366 =item DESCRIPTION
12367
12368 =back
12369
12370 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12371
12372 =over 4
12373
12374 =item SYNOPSIS
12375
12376 =item DESCRIPTION
12377
12378 =item Inherently Cross-Platform Methods
12379
12380 =over 4
12381
12382 =item File::Spec wrappers  B<DEPRECATED>
12383
12384 canonpath
12385
12386 =back
12387
12388 =back
12389
12390 catdir
12391
12392 catfile
12393
12394 curdir
12395
12396 file_name_is_absolute
12397
12398 path
12399
12400 rootdir
12401
12402 updir
12403
12404 =over 4
12405
12406 =item Thought To Be Cross-Platform Methods
12407
12408 test_via_harness
12409
12410 =back
12411
12412 test_via_script
12413
12414 =over 4
12415
12416 =item AUTHOR
12417
12418 =back
12419
12420 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12421 ExtUtils::MakeMaker
12422
12423 =over 4
12424
12425 =item SYNOPSIS
12426
12427 =item DESCRIPTION
12428
12429 =back
12430
12431 perl_archive
12432
12433 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12434 ExtUtils::MakeMaker
12435
12436 =over 4
12437
12438 =item SYNOPSIS
12439
12440 =item DESCRIPTION
12441
12442 canonpath, cflags, manifypods, perl_archive
12443
12444 =back
12445
12446 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12447
12448 =over 4
12449
12450 =item SYNOPSIS
12451
12452 =item DESCRIPTION
12453
12454 =over 4
12455
12456 =item Overridden methods
12457
12458 B<replace_manpage_separator>
12459
12460 =back
12461
12462 =back
12463
12464 =over 4
12465
12466 =item AUTHOR
12467
12468 =item SEE ALSO
12469
12470 =back
12471
12472 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12473 ExtUtils::MakeMaker
12474
12475 =over 4
12476
12477 =item SYNOPSIS
12478
12479 =item DESCRIPTION
12480
12481 =back
12482
12483 maybe_command
12484
12485 guess_name
12486
12487 macify
12488
12489 patternify
12490
12491 init_main
12492
12493 init_others
12494
12495 init_dirscan
12496
12497 libscan (o)
12498
12499 constants (o)
12500
12501 static (o)
12502
12503 dlsyms (o)
12504
12505 dynamic (o)
12506
12507 clean (o)
12508
12509 realclean (o)
12510
12511 rulez (o)
12512
12513 processPL (o)
12514
12515 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12516 ExtUtils::MakeMaker
12517
12518 =over 4
12519
12520 =item SYNOPSIS
12521
12522 =item DESCRIPTION
12523
12524 =back
12525
12526 constants (o)
12527
12528 static_lib (o)
12529
12530 dynamic_lib (o)
12531
12532 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12533 ExtUtils::MakeMaker
12534
12535 =over 4
12536
12537 =item SYNOPSIS
12538
12539 =item DESCRIPTION
12540
12541 =item METHODS
12542
12543 =back
12544
12545 perl_archive_after
12546
12547 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12548
12549 =over 4
12550
12551 =item SYNOPSIS
12552
12553 =item DESCRIPTION
12554
12555 =over 4
12556
12557 =item Overridden methods
12558
12559 B<replace_manpage_separator>
12560
12561 =back
12562
12563 =back
12564
12565 =over 4
12566
12567 =item AUTHOR
12568
12569 =item SEE ALSO
12570
12571 =back
12572
12573 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12574
12575 =over 4
12576
12577 =item SYNOPSIS
12578
12579 =item DESCRIPTION
12580
12581 =item METHODS
12582
12583 =back
12584
12585 =over 4
12586
12587 =item SelfLoaded methods
12588
12589 c_o (o)
12590
12591 =back
12592
12593 cflags (o)
12594
12595 clean (o)
12596
12597 const_cccmd (o)
12598
12599 const_config (o)
12600
12601 const_loadlibs (o)
12602
12603 constants (o)
12604
12605 depend (o)
12606
12607 dir_target (o)
12608
12609 dist (o)
12610
12611 dist_basics (o)
12612
12613 dist_ci (o)
12614
12615 dist_core (o)
12616
12617 dist_dir
12618
12619 dist_test
12620
12621 dlsyms (o)
12622
12623 dynamic (o)
12624
12625 dynamic_bs (o)
12626
12627 dynamic_lib (o)
12628
12629 exescan
12630
12631 extliblist
12632
12633 find_perl
12634
12635 find_tests
12636
12637 =over 4
12638
12639 =item Methods to actually produce chunks of text for the Makefile
12640
12641 fixin
12642
12643 =back
12644
12645 force (o)
12646
12647 guess_name
12648
12649 has_link_code
12650
12651 init_dirscan
12652
12653 init_main
12654
12655 init_others
12656
12657 init_INST
12658
12659 init_INSTALL
12660
12661 init_lib2arch
12662
12663 init_PERL
12664
12665 init_PERM
12666
12667 install (o)
12668
12669 installbin (o)
12670
12671 libscan (o)
12672
12673 linkext (o)
12674
12675 lsdir
12676
12677 macro (o)
12678
12679 makeaperl (o)
12680
12681 makefile (o)
12682
12683 manifypods (o)
12684
12685 maybe_command
12686
12687 maybe_command_in_dirs
12688
12689 needs_linking (o)
12690
12691 nicetext
12692
12693 parse_abstract
12694
12695 parse_version
12696
12697 pasthru (o)
12698
12699 perl_script
12700
12701 perldepend (o)
12702
12703 perm_rw (o)
12704
12705 perm_rwx (o)
12706
12707 pm_to_blib
12708
12709 post_constants (o)
12710
12711 post_initialize (o)
12712
12713 postamble (o)
12714
12715 ppd
12716
12717 prefixify
12718
12719 processPL (o)
12720
12721 quote_paren
12722
12723 realclean (o)
12724
12725 replace_manpage_separator
12726
12727 static (o)
12728
12729 static_lib (o)
12730
12731 staticmake (o)
12732
12733 subdir_x (o)
12734
12735 subdirs (o)
12736
12737 test (o)
12738
12739 test_via_harness (override)
12740
12741 test_via_script (override)
12742
12743 tool_autosplit (o)
12744
12745 tools_other (o)
12746
12747 tool_xsubpp (o)
12748
12749 top_targets (o)
12750
12751 writedoc
12752
12753 xs_c (o)
12754
12755 xs_cpp (o)
12756
12757 xs_o (o)
12758
12759 perl_archive
12760
12761 perl_archive_after
12762
12763 export_list
12764
12765 =over 4
12766
12767 =item SEE ALSO
12768
12769 =back
12770
12771 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12772 ExtUtils::MakeMaker
12773
12774 =over 4
12775
12776 =item SYNOPSIS
12777
12778 =item DESCRIPTION
12779
12780 =over 4
12781
12782 =item Methods always loaded
12783
12784 wraplist
12785
12786 =back
12787
12788 =back
12789
12790 =over 4
12791
12792 =item Methods
12793
12794 guess_name (override)
12795
12796 =back
12797
12798 find_perl (override)
12799
12800 maybe_command (override)
12801
12802 maybe_command_in_dirs (override)
12803
12804 perl_script (override)
12805
12806 replace_manpage_separator
12807
12808 init_main (override)
12809
12810 init_others (override)
12811
12812 constants (override)
12813
12814 cflags (override)
12815
12816 const_cccmd (override)
12817
12818 pm_to_blib (override)
12819
12820 tool_autosplit (override)
12821
12822 tool_sxubpp (override)
12823
12824 xsubpp_version (override)
12825
12826 tools_other (override)
12827
12828 dist (override)
12829
12830 c_o (override)
12831
12832 xs_c (override)
12833
12834 xs_o (override)
12835
12836 top_targets (override)
12837
12838 dlsyms (override)
12839
12840 dynamic_lib (override)
12841
12842 dynamic_bs (override)
12843
12844 static_lib (override)
12845
12846 manifypods (override)
12847
12848 processPL (override)
12849
12850 installbin (override)
12851
12852 subdir_x (override)
12853
12854 clean (override)
12855
12856 realclean (override)
12857
12858 dist_core (override)
12859
12860 dist_test (override)
12861
12862 install (override)
12863
12864 perldepend (override)
12865
12866 makefile (override)
12867
12868 find_tests (override)
12869
12870 test (override)
12871
12872 makeaperl (override)
12873
12874 nicetext (override)
12875
12876 prefixify (override)
12877
12878 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12879 ExtUtils::MakeMaker
12880
12881 =over 4
12882
12883 =item SYNOPSIS
12884
12885 =item DESCRIPTION
12886
12887 =back
12888
12889 constants (o)
12890
12891 static_lib (o)
12892
12893 dynamic_bs (o)
12894
12895 dynamic_lib (o)
12896
12897 perl_script
12898
12899 pm_to_blib
12900
12901 tool_autosplit (override)
12902
12903 tools_other (o)
12904
12905 xs_o (o)
12906
12907 top_targets (o)
12908
12909 manifypods (o)
12910
12911 dist_ci (o)
12912
12913 dist_core (o)
12914
12915 pasthru (o)
12916
12917 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12918
12919 =over 4
12920
12921 =item SYNOPSIS
12922
12923 =item DESCRIPTION
12924
12925 =back
12926
12927 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12928
12929 =over 4
12930
12931 =item SYNOPSIS
12932
12933 =item DESCRIPTION
12934
12935 =back
12936
12937 =head2 ExtUtils::MakeMaker - create an extension Makefile
12938
12939 =over 4
12940
12941 =item SYNOPSIS
12942
12943 =item DESCRIPTION
12944
12945 =over 4
12946
12947 =item How To Write A Makefile.PL
12948
12949 =item Default Makefile Behaviour
12950
12951 =item make test
12952
12953 =item make testdb
12954
12955 =item make install
12956
12957 =item PREFIX and LIB attribute
12958
12959 =item AFS users
12960
12961 =item Static Linking of a new Perl Binary
12962
12963 =item Determination of Perl Library and Installation Locations
12964
12965 =item Which architecture dependent directory?
12966
12967 =item Using Attributes and Parameters
12968
12969 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12970 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12971 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12972 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12973 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12974 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12975 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12976 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12977 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
12978 LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
12979 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
12980 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
12981 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
12982 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
12983 PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
12984 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
12985 XSPROTOARG, XS_VERSION
12986
12987 =item Additional lowercase attributes
12988
12989 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12990 tool_autosplit
12991
12992 =item Overriding MakeMaker Methods
12993
12994 =item Hintsfile support
12995
12996 =item Distribution Support
12997
12998    make distcheck,    make skipcheck,    make distclean,    make manifest, 
12999   make distdir,   make disttest,    make tardist,    make dist,    make
13000 uutardist,    make shdist,    make zipdist,    make ci
13001
13002 =item Disabling an extension
13003
13004 =back
13005
13006 =item ENVIRONMENT
13007
13008 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13009
13010 =item SEE ALSO
13011
13012 =item AUTHORS
13013
13014 =back
13015
13016 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13017
13018 =over 4
13019
13020 =item SYNOPSIS
13021
13022 =item DESCRIPTION
13023
13024 =item MANIFEST.SKIP
13025
13026 =item EXPORT_OK
13027
13028 =item GLOBAL VARIABLES
13029
13030 =item DIAGNOSTICS
13031
13032 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13033 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13034
13035 =item ENVIRONMENT
13036
13037 B<PERL_MM_MANIFEST_DEBUG>
13038
13039 =item SEE ALSO
13040
13041 =item AUTHOR
13042
13043 =back
13044
13045 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13046
13047 =over 4
13048
13049 =item SYNOPSIS
13050
13051 =item DESCRIPTION
13052
13053 =item SEE ALSO
13054
13055 =back
13056
13057 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13058
13059 =over 4
13060
13061 =item SYNOPSIS
13062
13063 =item DESCRIPTION
13064
13065 =back
13066
13067 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13068 extension
13069
13070 =over 4
13071
13072 =item SYNOPSIS
13073
13074 =item DESCRIPTION
13075
13076 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13077
13078 =item AUTHOR
13079
13080 =item REVISION
13081
13082 =back
13083
13084 =head2 ExtUtils::Packlist - manage .packlist files
13085
13086 =over 4
13087
13088 =item SYNOPSIS
13089
13090 =item DESCRIPTION
13091
13092 =item USAGE
13093
13094 =item FUNCTIONS
13095
13096 new(), read(), write(), validate(), packlist_file()
13097
13098 =item EXAMPLE
13099
13100 =item AUTHOR
13101
13102 =back
13103
13104 =head2 ExtUtils::testlib - add blib/* directories to @INC
13105
13106 =over 4
13107
13108 =item SYNOPSIS
13109
13110 =item DESCRIPTION
13111
13112 =back
13113
13114 =head2 Fatal - replace functions with equivalents which succeed or die
13115
13116 =over 4
13117
13118 =item SYNOPSIS
13119
13120 =item DESCRIPTION
13121
13122 =item AUTHOR
13123
13124 =back
13125
13126 =head2 Fcntl - load the C Fcntl.h defines
13127
13128 =over 4
13129
13130 =item SYNOPSIS
13131
13132 =item DESCRIPTION
13133
13134 =item NOTE
13135
13136 =item EXPORTED SYMBOLS
13137
13138 =back
13139
13140 =head2 File::Basename, fileparse - split a pathname into pieces
13141
13142 =over 4
13143
13144 =item SYNOPSIS
13145
13146 =item DESCRIPTION
13147
13148 fileparse_set_fstype, fileparse
13149
13150 =item EXAMPLES
13151
13152 C<basename>, C<dirname>
13153
13154 =back
13155
13156 =head2 File::CheckTree, validate - run many filetest checks on a tree
13157
13158 =over 4
13159
13160 =item SYNOPSIS
13161
13162 =item DESCRIPTION
13163
13164 =item AUTHOR
13165
13166 =item HISTORY
13167
13168 =back
13169
13170 =head2 File::Compare - Compare files or filehandles
13171
13172 =over 4
13173
13174 =item SYNOPSIS
13175
13176 =item DESCRIPTION
13177
13178 =item RETURN
13179
13180 =item AUTHOR
13181
13182 =back
13183
13184 =head2 File::Copy - Copy files or filehandles
13185
13186 =over 4
13187
13188 =item SYNOPSIS
13189
13190 =item DESCRIPTION
13191
13192 =over 4
13193
13194 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13195
13196 rmscopy($from,$to[,$date_flag])
13197
13198 =back
13199
13200 =item RETURN
13201
13202 =item NOTES
13203
13204 =item AUTHOR
13205
13206 =back
13207
13208 =head2 File::DosGlob - DOS like globbing and then some
13209
13210 =over 4
13211
13212 =item SYNOPSIS
13213
13214 =item DESCRIPTION
13215
13216 =item NOTES
13217
13218 =item EXPORTS (by request only)
13219
13220 =item BUGS
13221
13222 =item AUTHOR
13223
13224 =item HISTORY
13225
13226 =item SEE ALSO
13227
13228 =back
13229
13230 =head2 File::Find - Traverse a directory tree.
13231
13232 =over 4
13233
13234 =item SYNOPSIS
13235
13236 =item DESCRIPTION
13237
13238 B<find>, B<finddepth>
13239
13240 =over 4
13241
13242 =item %options
13243
13244 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13245 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13246 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13247
13248 =item The wanted function
13249
13250 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13251 filename within that directory, C<$File::Find::name> is the complete
13252 pathname to the file
13253
13254 =back
13255
13256 =item WARNINGS
13257
13258 =item CAVEAT
13259
13260 $dont_use_nlink, symlinks
13261
13262 =item NOTES
13263
13264 =item HISTORY
13265
13266 =back
13267
13268 =head2 File::Glob - Perl extension for BSD glob routine
13269
13270 =over 4
13271
13272 =item SYNOPSIS
13273
13274 =item DESCRIPTION
13275
13276 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13277 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13278 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13279
13280 =item DIAGNOSTICS
13281
13282 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13283
13284 =item NOTES
13285
13286 =item AUTHOR
13287
13288 =back
13289
13290 =head2 File::Path - create or remove directory trees
13291
13292 =over 4
13293
13294 =item SYNOPSIS
13295
13296 =item DESCRIPTION
13297
13298 =item AUTHORS
13299
13300 =back
13301
13302 =head2 File::Spec - portably perform operations on file names
13303
13304 =over 4
13305
13306 =item SYNOPSIS
13307
13308 =item DESCRIPTION
13309
13310 =item METHODS
13311
13312 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13313 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13314 splitdir, catpath(), abs2rel, rel2abs()
13315
13316 =item SEE ALSO
13317
13318 =item AUTHORS
13319
13320 =back
13321
13322 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13323
13324 =over 4
13325
13326 =item SYNOPSIS
13327
13328 =item DESCRIPTION
13329
13330 =back
13331
13332 =head2 File::Spec::Epoc - methods for Epoc file specs
13333
13334 =over 4
13335
13336 =item SYNOPSIS
13337
13338 =item DESCRIPTION
13339
13340 canonpath()
13341
13342 =back
13343
13344 =over 4
13345
13346 =item SEE ALSO
13347
13348 =back
13349
13350 =head2 File::Spec::Functions - portably perform operations on file names
13351
13352 =over 4
13353
13354 =item SYNOPSIS
13355
13356 =item DESCRIPTION
13357
13358 =over 4
13359
13360 =item Exports
13361
13362 =back
13363
13364 =item SEE ALSO
13365
13366 =back
13367
13368 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13369
13370 =over 4
13371
13372 =item SYNOPSIS
13373
13374 =item DESCRIPTION
13375
13376 =item METHODS
13377
13378 canonpath
13379
13380 =back
13381
13382 catdir()
13383
13384 catfile
13385
13386 curdir
13387
13388 devnull
13389
13390 rootdir
13391
13392 tmpdir
13393
13394 updir
13395
13396 file_name_is_absolute
13397
13398 path
13399
13400 splitpath
13401
13402 splitdir
13403
13404 catpath
13405
13406 abs2rel
13407
13408 rel2abs
13409
13410 =over 4
13411
13412 =item AUTHORS
13413
13414 =item SEE ALSO
13415
13416 =back
13417
13418 =head2 File::Spec::NW5 - methods for NW5 file specs
13419
13420 =over 4
13421
13422 =item SYNOPSIS
13423
13424 =item DESCRIPTION
13425
13426 devnull
13427
13428 =back
13429
13430 tmpdir
13431
13432 catfile
13433
13434 canonpath
13435
13436 splitpath
13437
13438 splitdir
13439
13440 catpath
13441
13442 =over 4
13443
13444 =item SEE ALSO
13445
13446 =back
13447
13448 canonpath
13449
13450 splitpath
13451
13452 splitdir
13453
13454 catpath
13455
13456 =head2 File::Spec::OS2 - methods for OS/2 file specs
13457
13458 =over 4
13459
13460 =item SYNOPSIS
13461
13462 =item DESCRIPTION
13463
13464 =back
13465
13466 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13467 modules
13468
13469 =over 4
13470
13471 =item SYNOPSIS
13472
13473 =item DESCRIPTION
13474
13475 =item METHODS
13476
13477 canonpath()
13478
13479 =back
13480
13481 catdir()
13482
13483 catfile
13484
13485 curdir
13486
13487 devnull
13488
13489 rootdir
13490
13491 tmpdir
13492
13493 updir
13494
13495 no_upwards
13496
13497 case_tolerant
13498
13499 file_name_is_absolute
13500
13501 path
13502
13503 join
13504
13505 splitpath
13506
13507 splitdir
13508
13509 catpath()
13510
13511 abs2rel
13512
13513 rel2abs()
13514
13515 =over 4
13516
13517 =item SEE ALSO
13518
13519 =back
13520
13521 =head2 File::Spec::VMS - methods for VMS file specs
13522
13523 =over 4
13524
13525 =item SYNOPSIS
13526
13527 =item DESCRIPTION
13528
13529 eliminate_macros
13530
13531 =back
13532
13533 fixpath
13534
13535 =over 4
13536
13537 =item Methods always loaded
13538
13539 canonpath (override)
13540
13541 =back
13542
13543 catdir
13544
13545 catfile
13546
13547 curdir (override)
13548
13549 devnull (override)
13550
13551 rootdir (override)
13552
13553 tmpdir (override)
13554
13555 updir (override)
13556
13557 case_tolerant (override)
13558
13559 path (override)
13560
13561 file_name_is_absolute (override)
13562
13563 splitpath (override)
13564
13565 splitdir (override)
13566
13567 catpath (override)
13568
13569 abs2rel (override)
13570
13571 rel2abs (override)
13572
13573 =over 4
13574
13575 =item SEE ALSO
13576
13577 =back
13578
13579 =head2 File::Spec::Win32 - methods for Win32 file specs
13580
13581 =over 4
13582
13583 =item SYNOPSIS
13584
13585 =item DESCRIPTION
13586
13587 devnull
13588
13589 =back
13590
13591 tmpdir
13592
13593 catfile
13594
13595 canonpath
13596
13597 splitpath
13598
13599 splitdir
13600
13601 catpath
13602
13603 =over 4
13604
13605 =item SEE ALSO
13606
13607 =back
13608
13609 =head2 File::Temp - return name and handle of a temporary file safely
13610
13611 =over 4
13612
13613 =item PORTABILITY
13614
13615 =item SYNOPSIS
13616
13617 =item DESCRIPTION
13618
13619 =back
13620
13621 =over 4
13622
13623 =item FUNCTIONS
13624
13625 B<tempfile>
13626
13627 =back
13628
13629 B<tempdir>
13630
13631 =over 4
13632
13633 =item MKTEMP FUNCTIONS
13634
13635 B<mkstemp>
13636
13637 =back
13638
13639 B<mkstemps>
13640
13641 B<mkdtemp>
13642
13643 B<mktemp>
13644
13645 =over 4
13646
13647 =item POSIX FUNCTIONS
13648
13649 B<tmpnam>
13650
13651 =back
13652
13653 B<tmpfile>
13654
13655 =over 4
13656
13657 =item ADDITIONAL FUNCTIONS
13658
13659 B<tempnam>
13660
13661 =back
13662
13663 =over 4
13664
13665 =item UTILITY FUNCTIONS
13666
13667 B<unlink0>
13668
13669 =back
13670
13671 =over 4
13672
13673 =item PACKAGE VARIABLES
13674
13675 B<safe_level>, STANDARD, MEDIUM, HIGH
13676
13677 =back
13678
13679 TopSystemUID
13680
13681 =over 4
13682
13683 =item WARNING
13684
13685 =over 4
13686
13687 =item Temporary files and NFS
13688
13689 =back
13690
13691 =item HISTORY
13692
13693 =item SEE ALSO
13694
13695 =item AUTHOR
13696
13697 =back
13698
13699 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13700
13701 =over 4
13702
13703 =item SYNOPSIS
13704
13705 =item DESCRIPTION
13706
13707 =item NOTE
13708
13709 =item AUTHOR
13710
13711 =back
13712
13713 =head2 FileCache - keep more files open than the system permits
13714
13715 =over 4
13716
13717 =item SYNOPSIS
13718
13719 =item DESCRIPTION
13720
13721 cacheout EXPR, cacheout MODE, EXPR
13722
13723 =item CAVEATS
13724
13725 =item BUGS
13726
13727 =back
13728
13729 =head2 FileHandle - supply object methods for filehandles
13730
13731 =over 4
13732
13733 =item SYNOPSIS
13734
13735 =item DESCRIPTION
13736
13737 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13738
13739 =item SEE ALSO
13740
13741 =back
13742
13743 =head2 Filter::Simple - Simplified source filtering
13744
13745 =over 4
13746
13747 =item SYNOPSIS
13748
13749 =item DESCRIPTION
13750
13751 =over 4
13752
13753 =item The Problem
13754
13755 =item A Solution
13756
13757 =item Disabling or changing <no> behaviour
13758
13759 =item All-in-one interface
13760
13761 =item Filtering only specific components of source code
13762
13763 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13764 C<"all">
13765
13766 =item Filtering only the code parts of source code
13767
13768 Most source code ceases to be grammatically correct when it is broken up
13769 into the pieces between string literals and regexes. So the C<'code'>
13770 component filter behaves slightly differently from the other partial
13771 filters
13772 described in the previous section.
13773
13774 =item Using Filter::Simple with an explicit C<import> subroutine
13775
13776 =item Using Filter::Simple and Exporter together
13777
13778 =item How it works
13779
13780 =back
13781
13782 =item AUTHOR
13783
13784 =item COPYRIGHT
13785
13786 =back
13787
13788 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13789
13790 =over 4
13791
13792 =item SYNOPSIS
13793
13794 =item DESCRIPTION
13795
13796 =over 4
13797
13798 =item B<use Filter::Util::Call>
13799
13800 =item B<import()>
13801
13802 =item B<filter() and anonymous sub>
13803
13804 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13805
13806 =back
13807
13808 =item EXAMPLES
13809
13810 =over 4
13811
13812 =item Example 1: A simple filter.
13813
13814 =item Example 2: Using the context
13815
13816 =item Example 3: Using the context within the filter
13817
13818 =item Example 4: Using filter_del
13819
13820 =back
13821
13822 =item Filter::Simple
13823
13824 =item AUTHOR
13825
13826 =item DATE
13827
13828 =back
13829
13830 =head2 FindBin - Locate directory of original perl script
13831
13832 =over 4
13833
13834 =item SYNOPSIS
13835
13836 =item DESCRIPTION
13837
13838 =item EXPORTABLE VARIABLES
13839
13840 =item KNOWN ISSUES
13841
13842 =item KNOWN BUGS
13843
13844 =item AUTHORS
13845
13846 =item COPYRIGHT
13847
13848 =back
13849
13850 =head2 GDBM_File - Perl5 access to the gdbm library.
13851
13852 =over 4
13853
13854 =item SYNOPSIS
13855
13856 =item DESCRIPTION
13857
13858 =item AVAILABILITY
13859
13860 =item BUGS
13861
13862 =item SEE ALSO
13863
13864 =back
13865
13866 =head2 Getopt::Long - Extended processing of command line options
13867
13868 =over 4
13869
13870 =item SYNOPSIS
13871
13872 =item DESCRIPTION
13873
13874 =item Command Line Options, an Introduction
13875
13876 =item Getting Started with Getopt::Long
13877
13878 =over 4
13879
13880 =item Simple options
13881
13882 =item A little bit less simple options
13883
13884 =item Mixing command line option with other arguments
13885
13886 =item Options with values
13887
13888 =item Options with multiple values
13889
13890 =item Options with hash values
13891
13892 =item User-defined subroutines to handle options
13893
13894 =item Options with multiple names
13895
13896 =item Case and abbreviations
13897
13898 =item Summary of Option Specifications
13899
13900 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13901 + [ I<desttype> ]
13902
13903 =back
13904
13905 =item Advanced Possibilities
13906
13907 =over 4
13908
13909 =item Object oriented interface
13910
13911 =item Documentation and help texts
13912
13913 =item Storing options in a hash
13914
13915 =item Bundling
13916
13917 =item The lonesome dash
13918
13919 =item Argument callback
13920
13921 =back
13922
13923 =item Configuring Getopt::Long
13924
13925 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13926 require_order, permute, bundling (default: disabled), bundling_override
13927 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13928 (default: disabled), pass_through (default: disabled), prefix,
13929 prefix_pattern, debug (default: disabled)
13930
13931 =item Return values and Errors
13932
13933 =item Legacy
13934
13935 =over 4
13936
13937 =item Default destinations
13938
13939 =item Alternative option starters
13940
13941 =item Configuration variables
13942
13943 =back
13944
13945 =item Trouble Shooting
13946
13947 =over 4
13948
13949 =item Warning: Ignoring '!' modifier for short option
13950
13951 =item GetOptions does not return a false result when an option is not
13952 supplied
13953
13954 =item GetOptions does not split the command line correctly
13955
13956 =item How do I put a "-?" option into a Getopt::Long?
13957
13958 =back
13959
13960 =item AUTHOR
13961
13962 =item COPYRIGHT AND DISCLAIMER
13963
13964 =back
13965
13966 =head2 Getopt::Std, getopt - Process single-character switches with switch
13967 clustering
13968
13969 =over 4
13970
13971 =item SYNOPSIS
13972
13973 =item DESCRIPTION
13974
13975 =back
13976
13977 =head2 Hash::Util - A selection of general-utility hash subroutines
13978
13979 =over 4
13980
13981 =item SYNOPSIS
13982
13983 =item DESCRIPTION
13984
13985 =over 4
13986
13987 =item Restricted hashes
13988
13989 lock_keys, unlock_keys
13990
13991 =back
13992
13993 =back
13994
13995 lock_value, unlock_value
13996
13997 B<lock_hash>, B<unlock_hash>
13998
13999 =over 4
14000
14001 =item AUTHOR
14002
14003 =item SEE ALSO
14004
14005 =back
14006
14007 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14008 locale
14009
14010 =over 4
14011
14012 =item SYNOPSIS
14013
14014 =item DESCRIPTION
14015
14016 =back
14017
14018 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14019 tags
14020
14021 =over 4
14022
14023 =item SYNOPSIS
14024
14025 =item DESCRIPTION
14026
14027 =back
14028
14029 the function is_language_tag($lang1)
14030
14031 the function extract_language_tags($whatever)
14032
14033 the function same_language_tag($lang1, $lang2)
14034
14035 the function similarity_language_tag($lang1, $lang2)
14036
14037 the function is_dialect_of($lang1, $lang2)
14038
14039 the function super_languages($lang1)
14040
14041 the function locale2language_tag($locale_identifier)
14042
14043 the function encode_language_tag($lang1)
14044
14045 the function alternate_language_tags($lang1)
14046
14047 the function @langs = panic_languages(@accept_languages)
14048
14049 =over 4
14050
14051 =item ABOUT LOWERCASING
14052
14053 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14054
14055 =item SEE ALSO
14056
14057 =item COPYRIGHT
14058
14059 =item AUTHOR
14060
14061 =back
14062
14063 =head2 I18N::LangTags::List -- tags and names for human languages
14064
14065 =over 4
14066
14067 =item SYNOPSIS
14068
14069 =item DESCRIPTION
14070
14071 =item ABOUT LANGUAGE TAGS
14072
14073 =item LIST OF LANGUAGES
14074
14075 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14076 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14077 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14078 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14079 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14080 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14081 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14082 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14083 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14084 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14085 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14086 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14087 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14088 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14089 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14090 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14091 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14092 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14093 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14094 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14095 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14096 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14097 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14098 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14099 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14100 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14101 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14102 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14103 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14104 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14105 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14106 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14107 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14108 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14109 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14110 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14111 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14112 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14113 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14114 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14115 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14116 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14117 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14118 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14119 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14120 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14121 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14122 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14123 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14124 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14125 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14126 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14127 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14128 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14129 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14130 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14131 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14132 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14133 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14134 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14135 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14136 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14137 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14138 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14139 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14140 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14141 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14142 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14143 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14144 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14145 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14146 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14147 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14148 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14149 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14150 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14151 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14152 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14153 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14154 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14155 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14156 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14157 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14158 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14159 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14160 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14161 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14162 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14163 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14164 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14165 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14166 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14167 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14168 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14169 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14170 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14171 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14172 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14173 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14174 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14175 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14176 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14177 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14178 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14179 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14180 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14181 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14182 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14183 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14184 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14185 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14186 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14187 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14188 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14189 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14190 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14191 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14192 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14193 Zhuang, {zu} : Zulu, {zun} : Zuni
14194
14195 =item SEE ALSO
14196
14197 =item COPYRIGHT AND DISCLAIMER
14198
14199 =item AUTHOR
14200
14201 =back
14202
14203 =head2 I18N::Langinfo - query locale information
14204
14205 =over 4
14206
14207 =item SYNOPSIS
14208
14209 =item DESCRIPTION
14210
14211 =over 4
14212
14213 =item EXPORT
14214
14215 =back
14216
14217 =item SEE ALSO
14218
14219 =item AUTHOR
14220
14221 =item COPYRIGHT AND LICENSE
14222
14223 =back
14224
14225 =head2 IO - load various IO modules
14226
14227 =over 4
14228
14229 =item SYNOPSIS
14230
14231 =item DESCRIPTION
14232
14233 =back
14234
14235 =head2 IO::Dir - supply object methods for directory handles
14236
14237 =over 4
14238
14239 =item SYNOPSIS
14240
14241 =item DESCRIPTION
14242
14243 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14244 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14245
14246 =item SEE ALSO
14247
14248 =item AUTHOR
14249
14250 =item COPYRIGHT
14251
14252 =back
14253
14254 =head2 IO::File - supply object methods for filehandles
14255
14256 =over 4
14257
14258 =item SYNOPSIS
14259
14260 =item DESCRIPTION
14261
14262 =item CONSTRUCTOR
14263
14264 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14265
14266 =item METHODS
14267
14268 open( FILENAME [,MODE [,PERMS]] )
14269
14270 =item SEE ALSO
14271
14272 =item HISTORY
14273
14274 =back
14275
14276 =head2 IO::Handle - supply object methods for I/O handles
14277
14278 =over 4
14279
14280 =item SYNOPSIS
14281
14282 =item DESCRIPTION
14283
14284 =item CONSTRUCTOR
14285
14286 new (), new_from_fd ( FD, MODE )
14287
14288 =item METHODS
14289
14290 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14291 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14292 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14293 $io->blocking ( [ BOOL ] ), $io->untaint
14294
14295 =item NOTE
14296
14297 =item SEE ALSO
14298
14299 =item BUGS
14300
14301 =item HISTORY
14302
14303 =back
14304
14305 =head2 IO::Pipe - supply object methods for pipes
14306
14307 =over 4
14308
14309 =item SYNOPSIS
14310
14311 =item DESCRIPTION
14312
14313 =item CONSTRUCTOR
14314
14315 new ( [READER, WRITER] )
14316
14317 =item METHODS
14318
14319 reader ([ARGS]), writer ([ARGS]), handles ()
14320
14321 =item SEE ALSO
14322
14323 =item AUTHOR
14324
14325 =item COPYRIGHT
14326
14327 =back
14328
14329 =head2 IO::Poll - Object interface to system poll call
14330
14331 =over 4
14332
14333 =item SYNOPSIS
14334
14335 =item DESCRIPTION
14336
14337 =item METHODS
14338
14339 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14340 IO ), handles( [ EVENT_MASK ] )
14341
14342 =item SEE ALSO
14343
14344 =item AUTHOR
14345
14346 =item COPYRIGHT
14347
14348 =back
14349
14350 =head2 IO::Seekable - supply seek based methods for I/O objects
14351
14352 =over 4
14353
14354 =item SYNOPSIS
14355
14356 =item DESCRIPTION
14357
14358 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14359 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14360 $io->tell
14361
14362 =item SEE ALSO
14363
14364 =item HISTORY
14365
14366 =back
14367
14368 =head2 IO::Select - OO interface to the select system call
14369
14370 =over 4
14371
14372 =item SYNOPSIS
14373
14374 =item DESCRIPTION
14375
14376 =item CONSTRUCTOR
14377
14378 new ( [ HANDLES ] )
14379
14380 =item METHODS
14381
14382 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14383 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14384 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14385
14386 =item EXAMPLE
14387
14388 =item AUTHOR
14389
14390 =item COPYRIGHT
14391
14392 =back
14393
14394 =head2 IO::Socket - Object interface to socket communications
14395
14396 =over 4
14397
14398 =item SYNOPSIS
14399
14400 =item DESCRIPTION
14401
14402 =item CONSTRUCTOR
14403
14404 new ( [ARGS] )
14405
14406 =item METHODS
14407
14408 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14409 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14410
14411 =item SEE ALSO
14412
14413 =item AUTHOR
14414
14415 =item COPYRIGHT
14416
14417 =back
14418
14419 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14420
14421 =over 4
14422
14423 =item SYNOPSIS
14424
14425 =item DESCRIPTION
14426
14427 =item CONSTRUCTOR
14428
14429 new ( [ARGS] )
14430
14431 =over 4
14432
14433 =item METHODS
14434
14435 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14436 ()
14437
14438 =back
14439
14440 =item SEE ALSO
14441
14442 =item AUTHOR
14443
14444 =item COPYRIGHT
14445
14446 =back
14447
14448 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14449
14450 =over 4
14451
14452 =item SYNOPSIS
14453
14454 =item DESCRIPTION
14455
14456 =item CONSTRUCTOR
14457
14458 new ( [ARGS] )
14459
14460 =item METHODS
14461
14462 hostpath(), peerpath()
14463
14464 =item SEE ALSO
14465
14466 =item AUTHOR
14467
14468 =item COPYRIGHT
14469
14470 =back
14471
14472 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14473 handles
14474
14475 =over 4
14476
14477 =item SYNOPSIS
14478
14479 =item DESCRIPTION
14480
14481 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14482 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14483
14484 =item SEE ALSO
14485
14486 =item AUTHOR
14487
14488 =item COPYRIGHT
14489
14490 =back
14491
14492 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14493
14494 =over 4
14495
14496 =item SYNOPSIS
14497
14498 =item DESCRIPTION
14499
14500 =item CONSTRUCTOR
14501
14502 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14503
14504 =item METHODS
14505
14506 open( FILENAME [,MODE [,PERMS]] )
14507
14508 =item SEE ALSO
14509
14510 =item HISTORY
14511
14512 =back
14513
14514 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14515 handles
14516
14517 =over 4
14518
14519 =item SYNOPSIS
14520
14521 =item DESCRIPTION
14522
14523 =item CONSTRUCTOR
14524
14525 new (), new_from_fd ( FD, MODE )
14526
14527 =item METHODS
14528
14529 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14530 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14531 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14532 $io->blocking ( [ BOOL ] ), $io->untaint
14533
14534 =item NOTE
14535
14536 =item SEE ALSO
14537
14538 =item BUGS
14539
14540 =item HISTORY
14541
14542 =back
14543
14544 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14545
14546 =over 4
14547
14548 =item SYNOPSIS
14549
14550 =item DESCRIPTION
14551
14552 =item CONSTRUCTOR
14553
14554 new ( [READER, WRITER] )
14555
14556 =item METHODS
14557
14558 reader ([ARGS]), writer ([ARGS]), handles ()
14559
14560 =item SEE ALSO
14561
14562 =item AUTHOR
14563
14564 =item COPYRIGHT
14565
14566 =back
14567
14568 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14569
14570 =over 4
14571
14572 =item SYNOPSIS
14573
14574 =item DESCRIPTION
14575
14576 =item METHODS
14577
14578 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14579 IO ), handles( [ EVENT_MASK ] )
14580
14581 =item SEE ALSO
14582
14583 =item AUTHOR
14584
14585 =item COPYRIGHT
14586
14587 =back
14588
14589 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14590 I/O objects
14591
14592 =over 4
14593
14594 =item SYNOPSIS
14595
14596 =item DESCRIPTION
14597
14598 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14599 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14600 $io->tell
14601
14602 =item SEE ALSO
14603
14604 =item HISTORY
14605
14606 =back
14607
14608 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14609 call
14610
14611 =over 4
14612
14613 =item SYNOPSIS
14614
14615 =item DESCRIPTION
14616
14617 =item CONSTRUCTOR
14618
14619 new ( [ HANDLES ] )
14620
14621 =item METHODS
14622
14623 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14624 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14625 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14626
14627 =item EXAMPLE
14628
14629 =item AUTHOR
14630
14631 =item COPYRIGHT
14632
14633 =back
14634
14635 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14636 communications
14637
14638 =over 4
14639
14640 =item SYNOPSIS
14641
14642 =item DESCRIPTION
14643
14644 =item CONSTRUCTOR
14645
14646 new ( [ARGS] )
14647
14648 =item METHODS
14649
14650 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14651 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14652
14653 =item SEE ALSO
14654
14655 =item AUTHOR
14656
14657 =item COPYRIGHT
14658
14659 =back
14660
14661 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14662 AF_INET domain sockets
14663
14664 =over 4
14665
14666 =item SYNOPSIS
14667
14668 =item DESCRIPTION
14669
14670 =item CONSTRUCTOR
14671
14672 new ( [ARGS] )
14673
14674 =over 4
14675
14676 =item METHODS
14677
14678 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14679 ()
14680
14681 =back
14682
14683 =item SEE ALSO
14684
14685 =item AUTHOR
14686
14687 =item COPYRIGHT
14688
14689 =back
14690
14691 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14692 AF_UNIX domain sockets
14693
14694 =over 4
14695
14696 =item SYNOPSIS
14697
14698 =item DESCRIPTION
14699
14700 =item CONSTRUCTOR
14701
14702 new ( [ARGS] )
14703
14704 =item METHODS
14705
14706 hostpath(), peerpath()
14707
14708 =item SEE ALSO
14709
14710 =item AUTHOR
14711
14712 =item COPYRIGHT
14713
14714 =back
14715
14716 =head2 IPC::Msg - SysV Msg IPC object class
14717
14718 =over 4
14719
14720 =item SYNOPSIS
14721
14722 =item DESCRIPTION
14723
14724 =item METHODS
14725
14726 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14727 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14728 FLAGS ] ), stat
14729
14730 =item SEE ALSO
14731
14732 =item AUTHOR
14733
14734 =item COPYRIGHT
14735
14736 =back
14737
14738 =head2 IPC::Open2, open2 - open a process for both reading and writing
14739
14740 =over 4
14741
14742 =item SYNOPSIS
14743
14744 =item DESCRIPTION
14745
14746 =item WARNING 
14747
14748 =item SEE ALSO
14749
14750 =back
14751
14752 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14753 handling
14754
14755 =over 4
14756
14757 =item SYNOPSIS
14758
14759 =item DESCRIPTION
14760
14761 =item WARNING
14762
14763 =back
14764
14765 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14766
14767 =over 4
14768
14769 =item SYNOPSIS
14770
14771 =item DESCRIPTION
14772
14773 =item METHODS
14774
14775 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14776 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14777 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14778 , VALUE ), stat
14779
14780 =item SEE ALSO
14781
14782 =item AUTHOR
14783
14784 =item COPYRIGHT
14785
14786 =back
14787
14788 =head2 IPC::SysV - SysV IPC constants
14789
14790 =over 4
14791
14792 =item SYNOPSIS
14793
14794 =item DESCRIPTION
14795
14796 ftok( PATH, ID )
14797
14798 =item SEE ALSO
14799
14800 =item AUTHORS
14801
14802 =item COPYRIGHT
14803
14804 =back
14805
14806 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14807
14808 =over 4
14809
14810 =item SYNOPSIS
14811
14812 =item DESCRIPTION
14813
14814 =item METHODS
14815
14816 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14817 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14818 FLAGS ] ), stat
14819
14820 =item SEE ALSO
14821
14822 =item AUTHOR
14823
14824 =item COPYRIGHT
14825
14826 =back
14827
14828 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14829 class
14830
14831 =over 4
14832
14833 =item SYNOPSIS
14834
14835 =item DESCRIPTION
14836
14837 =item METHODS
14838
14839 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14840 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14841 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14842 , VALUE ), stat
14843
14844 =item SEE ALSO
14845
14846 =item AUTHOR
14847
14848 =item COPYRIGHT
14849
14850 =back
14851
14852 =head2 List::Util - A selection of general-utility list subroutines
14853
14854 =over 4
14855
14856 =item SYNOPSIS
14857
14858 =item DESCRIPTION
14859
14860 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14861 BLOCK LIST, shuffle LIST, sum LIST
14862
14863 =item KNOWN BUGS
14864
14865 =item SUGGESTED ADDITIONS
14866
14867 =item COPYRIGHT
14868
14869 =back
14870
14871 =head2 List::Utilib::List::Util, List::Util - A selection of
14872 general-utility list subroutines
14873
14874 =over 4
14875
14876 =item SYNOPSIS
14877
14878 =item DESCRIPTION
14879
14880 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14881 BLOCK LIST, shuffle LIST, sum LIST
14882
14883 =item KNOWN BUGS
14884
14885 =item SUGGESTED ADDITIONS
14886
14887 =item COPYRIGHT
14888
14889 =back
14890
14891 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14892 general-utility scalar subroutines
14893
14894 =over 4
14895
14896 =item SYNOPSIS
14897
14898 =item DESCRIPTION
14899
14900 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14901 EXPR, tainted EXPR, weaken REF
14902
14903 =item KNOWN BUGS
14904
14905 =item COPYRIGHT
14906
14907 =item BLATANT PLUG
14908
14909 =back
14910
14911 =head2 Locale::Constants - constants for Locale codes
14912
14913 =over 4
14914
14915 =item SYNOPSIS
14916
14917 =item DESCRIPTION
14918
14919 =item KNOWN BUGS AND LIMITATIONS
14920
14921 =item SEE ALSO
14922
14923 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14924
14925 =item AUTHOR
14926
14927 =item COPYRIGHT
14928
14929 =back
14930
14931 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14932
14933 =over 4
14934
14935 =item SYNOPSIS
14936
14937 =item DESCRIPTION
14938
14939 B<alpha-2>, B<alpha-3>, B<numeric>
14940
14941 =item CONVERSION ROUTINES
14942
14943 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14944 country_code2code( CODE, CODESET, CODESET )
14945
14946 =item QUERY ROUTINES
14947
14948 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14949
14950 =item SEMI-PRIVATE ROUTINES
14951
14952 =over 4
14953
14954 =item alias_code
14955
14956 =item rename_country
14957
14958 =back
14959
14960 =item EXAMPLES
14961
14962 =item DOMAIN NAMES
14963
14964 =item KNOWN BUGS AND LIMITATIONS
14965
14966 =item SEE ALSO
14967
14968 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14969 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14970 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14971 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14972
14973 =item AUTHOR
14974
14975 =item COPYRIGHT
14976
14977 =back
14978
14979 =head2 Locale::Currency - ISO three letter codes for currency
14980 identification (ISO 4217)
14981
14982 =over 4
14983
14984 =item SYNOPSIS
14985
14986 =item DESCRIPTION
14987
14988 XTS, XXX
14989
14990 =item CONVERSION ROUTINES
14991
14992 code2currency(), currency2code()
14993
14994 =item QUERY ROUTINES
14995
14996 C<all_currency_codes()>, C<all_currency_names()>
14997
14998 =item EXAMPLES
14999
15000 =item KNOWN BUGS AND LIMITATIONS
15001
15002 =item SEE ALSO
15003
15004 Locale::Country, Locale::Script, ISO 4217:1995,
15005 http://www.bsi-global.com/iso4217currency
15006
15007 =item AUTHOR
15008
15009 =item COPYRIGHT
15010
15011 =back
15012
15013 =head2 Locale::Language - ISO two letter codes for language identification
15014 (ISO 639)
15015
15016 =over 4
15017
15018 =item SYNOPSIS
15019
15020 =item DESCRIPTION
15021
15022 =item CONVERSION ROUTINES
15023
15024 code2language(), language2code()
15025
15026 =item QUERY ROUTINES
15027
15028 C<all_language_codes()>, C<all_language_names()>
15029
15030 =item EXAMPLES
15031
15032 =item KNOWN BUGS AND LIMITATIONS
15033
15034 =item SEE ALSO
15035
15036 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15037 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15038
15039 =item AUTHOR
15040
15041 =item COPYRIGHT
15042
15043 =back
15044
15045 =head2 Locale::Maketext -- framework for localization
15046
15047 =over 4
15048
15049 =item SYNOPSIS
15050
15051 =item DESCRIPTION
15052
15053 =item QUICK OVERVIEW
15054
15055 =item METHODS
15056
15057 =over 4
15058
15059 =item Construction Methods
15060
15061 =item The "maketext" Method
15062
15063 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15064
15065 =item Utility Methods
15066
15067 $language->quant($number, $singular), $language->quant($number, $singular,
15068 $plural), $language->quant($number, $singular, $plural, $negative),
15069 $language->numf($number), $language->sprintf($format, @items),
15070 $language->language_tag(), $language->encoding()
15071
15072 =item Language Handle Attributes and Internals
15073
15074 =back
15075
15076 =item LANGUAGE CLASS HIERARCHIES
15077
15078 =item ENTRIES IN EACH LEXICON
15079
15080 =item BRACKET NOTATION
15081
15082 =item AUTO LEXICONS
15083
15084 =item CONTROLLING LOOKUP FAILURE
15085
15086 =item HOW TO USE MAKETEXT
15087
15088 =item SEE ALSO
15089
15090 =item COPYRIGHT AND DISCLAIMER
15091
15092 =item AUTHOR
15093
15094 =back
15095
15096 =head2 Locale::Maketext::TPJ13 -- article about software localization
15097
15098 =over 4
15099
15100 =item SYNOPSIS
15101
15102 =item DESCRIPTION
15103
15104 =item Localization and Perl: gettext breaks, Maketext fixes
15105
15106 =over 4
15107
15108 =item A Localization Horror Story: It Could Happen To You
15109
15110 =item The Linguistic View
15111
15112 =item Breaking gettext
15113
15114 =item Replacing gettext
15115
15116 =item Buzzwords: Abstraction and Encapsulation
15117
15118 =item Buzzword: Isomorphism
15119
15120 =item Buzzword: Inheritance
15121
15122 =item Buzzword: Concision
15123
15124 =item The Devil in the Details
15125
15126 =item The Proof in the Pudding: Localizing Web Sites
15127
15128 =item References
15129
15130 =back
15131
15132 =back
15133
15134 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15135
15136 =over 4
15137
15138 =item SYNOPSIS
15139
15140 =item DESCRIPTION
15141
15142 B<alpha-2>, B<alpha-3>, B<numeric>
15143
15144 =over 4
15145
15146 =item SPECIAL CODES
15147
15148 =back
15149
15150 =item CONVERSION ROUTINES
15151
15152 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15153 script_code2code( CODE, CODESET, CODESET )
15154
15155 =item QUERY ROUTINES
15156
15157 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15158
15159 =item EXAMPLES
15160
15161 =item KNOWN BUGS AND LIMITATIONS
15162
15163 =item SEE ALSO
15164
15165 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15166 http://www.evertype.com/standards/iso15924/
15167
15168 =item AUTHOR
15169
15170 =item COPYRIGHT
15171
15172 =back
15173
15174 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15175
15176 =over 4
15177
15178 =item SYNOPSIS
15179
15180 =item DESCRIPTION
15181
15182 encode_base64($str, [$eol]), decode_base64($str)
15183
15184 =item DIAGNOSTICS
15185
15186 Premature end of base64 data, Premature padding of base64 data
15187
15188 =item EXAMPLES
15189
15190 =item COPYRIGHT
15191
15192 =back
15193
15194 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15195 of quoted-printable strings
15196
15197 =over 4
15198
15199 =item SYNOPSIS
15200
15201 =item DESCRIPTION
15202
15203 encode_qp($str), decode_qp($str);
15204
15205 =item COPYRIGHT
15206
15207 =back
15208
15209 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15210 strings
15211
15212 =over 4
15213
15214 =item SYNOPSIS
15215
15216 =item DESCRIPTION
15217
15218 encode_qp($str), decode_qp($str);
15219
15220 =item COPYRIGHT
15221
15222 =back
15223
15224 =head2 Math::BigFloat - Arbitrary size floating point math package
15225
15226 =over 4
15227
15228 =item SYNOPSIS
15229
15230 =item DESCRIPTION
15231
15232 =over 4
15233
15234 =item Canonical notation
15235
15236 =item Output
15237
15238 =item C<mantissa()>, C<exponent()> and C<parts()>
15239
15240 =item Accuracy vs. Precision
15241
15242 =item Rounding
15243
15244 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15245 ), fround  ( -$scale ) and fround ( 0 )
15246
15247 =back
15248
15249 =item EXAMPLES
15250
15251   # not ready yet
15252
15253 =item Autocreating constants
15254
15255 =over 4
15256
15257 =item Math library
15258
15259 =item Using Math::BigInt::Lite
15260
15261 =back
15262
15263 =item BUGS
15264
15265 =item CAVEAT
15266
15267 stringify, bstr(), bdiv, Modifying and =, bpow
15268
15269 =item LICENSE
15270
15271 =item AUTHORS
15272
15273 =back
15274
15275 =head2 Math::BigInt - Arbitrary size integer math package
15276
15277 =over 4
15278
15279 =item SYNOPSIS
15280
15281 =item DESCRIPTION
15282
15283 Canonical notation, Input, Output
15284
15285 =item METHODS
15286
15287 =over 4
15288
15289 =item config
15290
15291 =item accuracy
15292
15293 =item brsft
15294
15295 =item new
15296
15297 =item bnan
15298
15299 =item bzero
15300
15301 =item binf
15302
15303 =item bone
15304
15305 =item is_one()/is_zero()/is_nan()/is_inf()
15306
15307 =item is_positive()/is_negative()
15308
15309         $x->is_positive();              # true if >= 0
15310         $x->is_negative();              # true if <  0
15311
15312 =item is_odd()/is_even()/is_int()
15313
15314 =item bcmp
15315
15316 =item bacmp
15317
15318 =item sign
15319
15320 =item bcmp
15321
15322 =item bneg
15323
15324 =item babs
15325
15326 =item bnorm
15327
15328 =item bnot
15329
15330 =item binc
15331
15332 =item bdec
15333
15334 =item badd
15335
15336 =item bsub
15337
15338 =item bmul
15339
15340 =item bdiv
15341
15342 =item bmod
15343
15344 =item bmodinv
15345
15346 =item bmodpow
15347
15348 =item bpow
15349
15350 =item blsft
15351
15352 =item brsft
15353
15354 =item band
15355
15356 =item bior
15357
15358 =item bxor
15359
15360 =item bnot
15361
15362 =item bsqrt
15363
15364 =item bfac
15365
15366 =item round
15367
15368 =item bround
15369
15370 =item bfround
15371
15372 =item bfloor
15373
15374 =item bceil
15375
15376 =item bgcd
15377
15378 =item blcm
15379
15380 =item exponent
15381
15382 =item mantissa
15383
15384 =item parts
15385
15386 =item copy
15387
15388 =item as_number
15389
15390 =item bsstr
15391
15392 =item as_hex
15393
15394 =item as_bin
15395
15396 =back
15397
15398 =item ACCURACY and PRECISION
15399
15400 =over 4
15401
15402 =item Precision P
15403
15404 =item Accuracy A
15405
15406 =item Fallback F
15407
15408 =item Rounding mode R
15409
15410 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15411 (significant digits), Setting/Accessing, Creating numbers, Usage,
15412 Precedence, Overriding globals, Local settings, Rounding, Default values,
15413 Remarks
15414
15415 =back
15416
15417 =item INTERNALS
15418
15419 =over 4
15420
15421 =item MATH LIBRARY
15422
15423 =item SIGN
15424
15425 =item mantissa(), exponent() and parts()
15426
15427 =back
15428
15429 =item EXAMPLES
15430
15431   use Math::BigInt;
15432
15433 =item Autocreating constants
15434
15435 =item PERFORMANCE
15436
15437 =over 4
15438
15439 =item Alternative math libraries
15440
15441 =item SUBCLASSING
15442
15443 =back
15444
15445 =item Subclassing Math::BigInt
15446
15447 =item UPGRADING
15448
15449 =over 4
15450
15451 =item Auto-upgrade
15452
15453 bsqrt(), div(), blog()
15454
15455 =back
15456
15457 =item BUGS
15458
15459 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15460
15461 =item CAVEATS
15462
15463 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15464 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15465 types, bsqrt(), brsft()
15466
15467 =item LICENSE
15468
15469 =item SEE ALSO
15470
15471 =item AUTHORS
15472
15473 =back
15474
15475 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15476
15477 =over 4
15478
15479 =item SYNOPSIS
15480
15481 =item DESCRIPTION
15482
15483 =item EXPORT
15484
15485 =item WRAP YOUR OWN
15486
15487 =item LICENSE
15488
15489 This program is free software; you may redistribute it and/or modify it
15490 under
15491 the same terms as Perl itself. 
15492
15493 =item AUTHORS
15494
15495 =item SEE ALSO
15496
15497 =back
15498
15499 =head2 Math::BigRat - arbitrarily big rationals
15500
15501 =over 4
15502
15503 =item SYNOPSIS
15504
15505 =item DESCRIPTION
15506
15507 =over 4
15508
15509 =item MATH LIBRARY
15510
15511 =back
15512
15513 =item METHODS
15514
15515 =over 4
15516
15517 =item new()
15518
15519 =item numerator()
15520
15521 =item denominator()
15522
15523         $d = $x->denominator();
15524
15525 =item parts()
15526
15527 =item as_number()
15528
15529 =item bfac()
15530
15531 =item blog()
15532
15533 =item bround()/round()/bfround()
15534
15535 =back
15536
15537 =item BUGS
15538
15539 =item LICENSE
15540
15541 =item SEE ALSO
15542
15543 =item AUTHORS
15544
15545 =back
15546
15547 =head2 Math::Complex - complex numbers and associated mathematical
15548 functions
15549
15550 =over 4
15551
15552 =item SYNOPSIS
15553
15554 =item DESCRIPTION
15555
15556 =item OPERATIONS
15557
15558 =item CREATION
15559
15560 =item STRINGIFICATION
15561
15562 =over 4
15563
15564 =item CHANGED IN PERL 5.6
15565
15566 =back
15567
15568 =item USAGE
15569
15570 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15571
15572 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15573
15574 =item BUGS
15575
15576 =item AUTHORS
15577
15578 =back
15579
15580 =head2 Math::Trig - trigonometric functions
15581
15582 =over 4
15583
15584 =item SYNOPSIS
15585
15586 =item DESCRIPTION
15587
15588 =item TRIGONOMETRIC FUNCTIONS
15589
15590 B<tan>
15591
15592 =over 4
15593
15594 =item ERRORS DUE TO DIVISION BY ZERO
15595
15596 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15597
15598 =back
15599
15600 =item PLANE ANGLE CONVERSIONS
15601
15602 =item RADIAL COORDINATE CONVERSIONS
15603
15604 =over 4
15605
15606 =item COORDINATE SYSTEMS
15607
15608 =item 3-D ANGLE CONVERSIONS
15609
15610 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15611 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15612
15613 =back
15614
15615 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15616
15617 =item EXAMPLES
15618
15619 =over 4
15620
15621 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15622
15623 =back
15624
15625 =item BUGS
15626
15627 =item AUTHORS
15628
15629 =back
15630
15631 =head2 Memoize - Make functions faster by trading space for time
15632
15633 =over 4
15634
15635 =item SYNOPSIS
15636
15637 =item DESCRIPTION
15638
15639 =item DETAILS
15640
15641 =item OPTIONS
15642
15643 =over 4
15644
15645 =item INSTALL
15646
15647 =item NORMALIZER
15648
15649 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15650
15651 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15652
15653 =back
15654
15655 =item OTHER FACILITIES
15656
15657 =over 4
15658
15659 =item C<unmemoize>
15660
15661 =item C<flush_cache>
15662
15663 =back
15664
15665 =item CAVEATS
15666
15667 =item PERSISTENT CACHE SUPPORT
15668
15669 =item EXPIRATION SUPPORT
15670
15671 =item BUGS
15672
15673 =item MAILING LIST
15674
15675 =item AUTHOR
15676
15677 =item COPYRIGHT AND LICENSE
15678
15679 =item THANK YOU
15680
15681 =back
15682
15683 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15684 Storable use
15685
15686 =over 4
15687
15688 =item DESCRIPTION
15689
15690 =back
15691
15692 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15693 memoized values
15694
15695 =over 4
15696
15697 =item SYNOPSIS
15698
15699 =item DESCRIPTION
15700
15701 =item INTERFACE
15702
15703  TIEHASH,  EXISTS,  STORE
15704
15705 =item ALTERNATIVES
15706
15707 =item CAVEATS
15708
15709 =item AUTHOR
15710
15711 =item SEE ALSO
15712
15713 =back
15714
15715 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15716
15717 =over 4
15718
15719 =item DESCRIPTION
15720
15721 =back
15722
15723 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15724
15725 =over 4
15726
15727 =item DESCRIPTION
15728
15729 =back
15730
15731 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15732 Storable use
15733
15734 =over 4
15735
15736 =item DESCRIPTION
15737
15738 =back
15739
15740 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15741 Storable use
15742
15743 =over 4
15744
15745 =item DESCRIPTION
15746
15747 =back
15748
15749 =head2 Memoize::Storable - store Memoized data in Storable database
15750
15751 =over 4
15752
15753 =item DESCRIPTION
15754
15755 =back
15756
15757 =head2 NDBM_File - Tied access to ndbm files
15758
15759 =over 4
15760
15761 =item SYNOPSIS
15762
15763 =item DESCRIPTION
15764
15765 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15766
15767 =item DIAGNOSTICS
15768
15769 =over 4
15770
15771 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15772
15773 =back
15774
15775 =item BUGS AND WARNINGS
15776
15777 =back
15778
15779 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15780
15781 =over 4
15782
15783 =item SYNOPSIS
15784
15785 =item DESCRIPTION
15786
15787 =over 4
15788
15789 =item Enforcing redispatch
15790
15791 =item Avoiding repetitions
15792
15793 =back
15794
15795 =item AUTHOR
15796
15797 =item BUGS AND IRRITATIONS
15798
15799 =item COPYRIGHT
15800
15801 =back
15802
15803 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15804
15805 =over 4
15806
15807 =item SYNOPSIS
15808
15809 =item DESCRIPTION
15810
15811 =item USER METHODS
15812
15813 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15814 dataend ()
15815
15816 =item CLASS METHODS
15817
15818 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15819 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15820 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15821
15822 =item EXPORTS
15823
15824 =item AUTHOR
15825
15826 =item COPYRIGHT
15827
15828 =back
15829
15830 =head2 Net::Config - Local configuration data for libnet
15831
15832 =over 4
15833
15834 =item SYNOPSYS
15835
15836 =item DESCRIPTION
15837
15838 =item METHODS
15839
15840 requires_firewall HOST
15841
15842 =item NetConfig VALUES
15843
15844 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15845 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15846 ftp_int_pasive, local_netmask, test_hosts, test_exists
15847
15848 =back
15849
15850 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15851 and domain
15852
15853 =over 4
15854
15855 =item SYNOPSIS
15856
15857 =item DESCRIPTION
15858
15859 hostfqdn (), hostname (), hostdomain ()
15860
15861 =item AUTHOR
15862
15863 =item COPYRIGHT
15864
15865 =back
15866
15867 =head2 Net::FTP - FTP Client class
15868
15869 =over 4
15870
15871 =item SYNOPSIS
15872
15873 =item DESCRIPTION
15874
15875 =item OVERVIEW
15876
15877 =item CONSTRUCTOR
15878
15879 new (HOST [,OPTIONS])
15880
15881 =item METHODS
15882
15883 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15884 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15885 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15886 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15887 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15888 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15889 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15890 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15891 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15892 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15893 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15894 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15895 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15896
15897 =over 4
15898
15899 =item Methods for the adventurous
15900
15901 quot (CMD [,ARGS])
15902
15903 =back
15904
15905 =item THE dataconn CLASS
15906
15907 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15908 bytes_read (), abort (), close ()
15909
15910 =item UNIMPLEMENTED
15911
15912 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15913
15914 =item REPORTING BUGS
15915
15916 =item AUTHOR
15917
15918 =item SEE ALSO
15919
15920 =item USE EXAMPLES
15921
15922 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15923
15924 =item CREDITS
15925
15926 =item COPYRIGHT
15927
15928 =back
15929
15930 =head2 Net::NNTP - NNTP Client class
15931
15932 =over 4
15933
15934 =item SYNOPSIS
15935
15936 =item DESCRIPTION
15937
15938 =item CONSTRUCTOR
15939
15940 new ( [ HOST ] [, OPTIONS ])
15941
15942 =item METHODS
15943
15944 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15945 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15946 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15947 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15948 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15949 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15950 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15951
15952 =over 4
15953
15954 =item Extension methods
15955
15956 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15957 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15958 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15959 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15960 GROUP ] ), reader
15961
15962 =back
15963
15964 =item UNSUPPORTED
15965
15966 =item DEFINITIONS
15967
15968 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15969
15970 =item SEE ALSO
15971
15972 =item AUTHOR
15973
15974 =item COPYRIGHT
15975
15976 =back
15977
15978 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15979
15980 =over 4
15981
15982 =item SYNOPSIS
15983
15984 =item DESCRIPTION
15985
15986 =item EXAMPLES
15987
15988 =item CONSTRUCTOR
15989
15990 new ( [ HOST, ] [ OPTIONS ] )
15991
15992 =item METHODS
15993
15994 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15995 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15996 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15997 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15998
15999 =item NOTES
16000
16001 =item SEE ALSO
16002
16003 =item AUTHOR
16004
16005 =item COPYRIGHT
16006
16007 =back
16008
16009 =head2 Net::Ping - check a remote host for reachability
16010
16011 =over 4
16012
16013 =item SYNOPSIS
16014
16015 =item DESCRIPTION
16016
16017 =over 4
16018
16019 =item Functions
16020
16021 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( {
16022 0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host
16023 [, $timeout]);, $p->open($host);, $p->close();, pingecho($host [,
16024 $timeout]);
16025
16026 =back
16027
16028 =item WARNING
16029
16030 =item NOTES
16031
16032 =item AUTHORS
16033
16034 =item COPYRIGHT
16035
16036 =back
16037
16038 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16039
16040 =over 4
16041
16042 =item SYNOPSIS
16043
16044 =item DESCRIPTION
16045
16046 =item EXAMPLES
16047
16048 =item CONSTRUCTOR
16049
16050 new Net::SMTP [ HOST, ] [ OPTIONS ]
16051
16052 =item METHODS
16053
16054 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16055 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16056 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16057 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16058 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16059 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16060 quit ()
16061
16062 =item ADDRESSES
16063
16064 =item SEE ALSO
16065
16066 =item AUTHOR
16067
16068 =item COPYRIGHT
16069
16070 =back
16071
16072 =head2 Net::Time - time and daytime network client interface
16073
16074 =over 4
16075
16076 =item SYNOPSIS
16077
16078 =item DESCRIPTION
16079
16080 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16081 PROTOCOL [, TIMEOUT]]])
16082
16083 =item AUTHOR
16084
16085 =item COPYRIGHT
16086
16087 =back
16088
16089 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16090 functions
16091
16092 =over 4
16093
16094 =item SYNOPSIS
16095
16096 =item DESCRIPTION
16097
16098 =item EXAMPLES
16099
16100 =item NOTE
16101
16102 =item AUTHOR
16103
16104 =back
16105
16106 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16107
16108 =over 4
16109
16110 =item DESCRIPTION
16111
16112 =over 4
16113
16114 =item Where to get this document
16115
16116 =item How to contribute to this document
16117
16118 =back
16119
16120 =item Author and Copyright Information
16121
16122 =over 4
16123
16124 =item Disclaimer
16125
16126 =back
16127
16128 =item Obtaining and installing libnet
16129
16130 =over 4
16131
16132 =item What is libnet ?
16133
16134 =item Which version of perl do I need ?
16135
16136 =item What other modules do I need ?
16137
16138 =item What machines support libnet ?
16139
16140 =item Where can I get the latest libnet release
16141
16142 =back
16143
16144 =item Using Net::FTP
16145
16146 =over 4
16147
16148 =item How do I download files from an FTP server ?
16149
16150 =item How do I transfer files in binary mode ?
16151
16152 =item How can I get the size of a file on a remote FTP server ?
16153
16154 =item How can I get the modification time of a file on a remote FTP server
16155 ?
16156
16157 =item How can I change the permissions of a file on a remote server ?
16158
16159 =item Can I do a reget operation like the ftp command ?
16160
16161 =item How do I get a directory listing from an FTP server ?
16162
16163 =item Changing directory to "" does not fail ?
16164
16165 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16166
16167 =item I am behind an FTP proxy firewall, but cannot access machines outside
16168 ?
16169
16170 =item My ftp proxy firewall does not listen on port 21
16171
16172 =item Is it possible to change the file permissions of a file on an FTP
16173 server ?
16174
16175 =item I have seen scripts call a method message, but cannot find it
16176 documented ?
16177
16178 =item Why does Net::FTP not implement mput and mget methods
16179
16180 =back
16181
16182 =item Using Net::SMTP
16183
16184 =over 4
16185
16186 =item Why can't the part of an Email address after the @ be used as the
16187 hostname ?
16188
16189 =item Why does Net::SMTP not do DNS MX lookups ?
16190
16191 =item The verify method always returns true ?
16192
16193 =back
16194
16195 =item Debugging scripts
16196
16197 =over 4
16198
16199 =item How can I debug my scripts that use Net::* modules ?
16200
16201 =back
16202
16203 =item AUTHOR AND COPYRIGHT
16204
16205 =back
16206
16207 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16208 functions
16209
16210 =over 4
16211
16212 =item SYNOPSIS
16213
16214 =item DESCRIPTION
16215
16216 =item EXAMPLES
16217
16218 =item NOTE
16219
16220 =item AUTHOR
16221
16222 =back
16223
16224 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16225 functions
16226
16227 =over 4
16228
16229 =item SYNOPSIS
16230
16231 =item DESCRIPTION
16232
16233 =item NOTE
16234
16235 =item AUTHOR
16236
16237 =back
16238
16239 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16240 functions
16241
16242 =over 4
16243
16244 =item SYNOPSIS
16245
16246 =item DESCRIPTION
16247
16248 =item EXAMPLES
16249
16250 =item NOTE
16251
16252 =item AUTHOR
16253
16254 =back
16255
16256 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16257
16258 =over 4
16259
16260 =item SYNOPSIS
16261
16262 =item DESCRIPTION
16263
16264 =item THE .netrc FILE
16265
16266 machine name, default, login name, password string, account string, macdef
16267 name
16268
16269 =item CONSTRUCTOR
16270
16271 lookup ( MACHINE [, LOGIN ])
16272
16273 =item METHODS
16274
16275 login (), password (), account (), lpa ()
16276
16277 =item AUTHOR
16278
16279 =item SEE ALSO
16280
16281 =item COPYRIGHT
16282
16283 =back
16284
16285 =head2 O - Generic interface to Perl Compiler backends
16286
16287 =over 4
16288
16289 =item SYNOPSIS
16290
16291 =item DESCRIPTION
16292
16293 =item CONVENTIONS
16294
16295 =item IMPLEMENTATION
16296
16297 =item BUGS
16298
16299 =item AUTHOR
16300
16301 =back
16302
16303 =head2 ODBM_File - Tied access to odbm files
16304
16305 =over 4
16306
16307 =item SYNOPSIS
16308
16309 =item DESCRIPTION
16310
16311 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16312
16313 =item DIAGNOSTICS
16314
16315 =over 4
16316
16317 =item C<odbm store returned -1, errno 22, key "..." at ...>
16318
16319 =back
16320
16321 =item BUGS AND WARNINGS
16322
16323 =back
16324
16325 =head2 Opcode - Disable named opcodes when compiling perl code
16326
16327 =over 4
16328
16329 =item SYNOPSIS
16330
16331 =item DESCRIPTION
16332
16333 =item NOTE
16334
16335 =item WARNING
16336
16337 =item Operator Names and Operator Lists
16338
16339 an operator name (opname), an operator tag name (optag), a negated opname
16340 or optag, an operator set (opset)
16341
16342 =item Opcode Functions
16343
16344 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16345 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16346 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16347 opdump (PAT)
16348
16349 =item Manipulating Opsets
16350
16351 =item TO DO (maybe)
16352
16353 =back
16354
16355 =over 4
16356
16357 =item Predefined Opcode Tags
16358
16359 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16360 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16361 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16362 :dangerous
16363
16364 =item SEE ALSO
16365
16366 =item AUTHORS
16367
16368 =back
16369
16370 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16371 compartments
16372
16373 =over 4
16374
16375 =item SYNOPSIS
16376
16377 =item DESCRIPTION
16378
16379 a new namespace, an operator mask
16380
16381 =item WARNING
16382
16383 =over 4
16384
16385 =item RECENT CHANGES
16386
16387 =item Methods in class Safe
16388
16389 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16390 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16391 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16392 root (NAMESPACE), mask (MASK)
16393
16394 =item Some Safety Issues
16395
16396 Memory, CPU, Snooping, Signals, State Changes
16397
16398 =item AUTHOR
16399
16400 =back
16401
16402 =back
16403
16404 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16405 compiling
16406
16407 =over 4
16408
16409 =item SYNOPSIS  
16410
16411 =item DESCRIPTION
16412
16413 =item SEE ALSO
16414
16415 =back
16416
16417 =head2 POSIX - Perl interface to IEEE Std 1003.1
16418
16419 =over 4
16420
16421 =item SYNOPSIS
16422
16423 =item DESCRIPTION
16424
16425 =item NOTE
16426
16427 =item CAVEATS 
16428
16429 =item FUNCTIONS
16430
16431 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16432 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16433 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16434 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16435 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16436 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16437 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16438 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16439 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16440 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16441 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16442 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16443 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16444 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16445 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16446 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16447 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16448 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16449 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16450 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16451 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16452 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16453 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16454 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16455 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16456 wctomb, write
16457
16458 =item CLASSES
16459
16460 =over 4
16461
16462 =item POSIX::SigAction
16463
16464 new
16465
16466 =item POSIX::SigSet
16467
16468 new, addset, delset, emptyset, fillset, ismember
16469
16470 =item POSIX::Termios
16471
16472 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16473 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16474 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16475 field values, c_cflag field values, c_iflag field values, c_lflag field
16476 values, c_oflag field values
16477
16478 =back
16479
16480 =item PATHNAME CONSTANTS
16481
16482 Constants
16483
16484 =item POSIX CONSTANTS
16485
16486 Constants
16487
16488 =item SYSTEM CONFIGURATION
16489
16490 Constants
16491
16492 =item ERRNO
16493
16494 Constants
16495
16496 =item FCNTL
16497
16498 Constants
16499
16500 =item FLOAT
16501
16502 Constants
16503
16504 =item LIMITS
16505
16506 Constants
16507
16508 =item LOCALE
16509
16510 Constants
16511
16512 =item MATH
16513
16514 Constants
16515
16516 =item SIGNAL
16517
16518 Constants
16519
16520 =item STAT
16521
16522 Constants, Macros
16523
16524 =item STDLIB
16525
16526 Constants
16527
16528 =item STDIO
16529
16530 Constants
16531
16532 =item TIME
16533
16534 Constants
16535
16536 =item UNISTD
16537
16538 Constants
16539
16540 =item WAIT
16541
16542 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16543 WTERMSIG, WIFSTOPPED, WSTOPSIG
16544
16545 =back
16546
16547 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16548 name space
16549
16550 =over 4
16551
16552 =item SYNOPSIS
16553
16554 =item DESCRIPTION
16555
16556 unix, stdio, perlio, crlf, utf8, bytes, raw
16557
16558 =over 4
16559
16560 =item Defaults and how to override them
16561
16562 =back
16563
16564 =item AUTHOR
16565
16566 =item SEE ALSO
16567
16568 =back
16569
16570 =head2 PerlIO::Scalar - support module for in-memory IO.
16571
16572 =over 4
16573
16574 =item SYNOPSIS
16575
16576 =item DESCRIPTION
16577
16578 =back
16579
16580 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
16581
16582 =over 4
16583
16584 =item SYNOPSIS
16585
16586 =item DESCRIPTION
16587
16588 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16589 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
16590 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
16591 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16592 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16593 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16594 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16595
16596 =over 4
16597
16598 =item Example - a Hexadecimal Handle
16599
16600 =back
16601
16602 =back
16603
16604 =head2 PerlIO::encoding - encoding layer
16605
16606 =over 4
16607
16608 =item SYNOPSIS
16609
16610 =item DESCRIPTION
16611
16612 =item SEE ALSO
16613
16614 =back
16615
16616 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16617
16618 =over 4
16619
16620 =item SYNOPSIS
16621
16622 =item OPTIONS/ARGUMENTS
16623
16624 =over 4
16625
16626 =item podchecker()
16627
16628 B<-warnings> =E<gt> I<val>
16629
16630 =back
16631
16632 =item DESCRIPTION
16633
16634 =item DIAGNOSTICS
16635
16636 =over 4
16637
16638 =item Errors
16639
16640 empty =headn, =over on line I<N> without closing =back, =item without
16641 previous =over, =back without previous =over, No argument for =begin, =end
16642 without =begin, Nested =begin's, =for without formatter specification,
16643 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16644 interior-sequence "I<SEQ>", nested commands
16645 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16646 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16647 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16648 after =back
16649
16650 =item Warnings
16651
16652 multiple occurrence of link target I<name>, line containing nothing but
16653 whitespace in paragraph, file does not start with =head, previous =item has
16654 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16655 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16656 items in =over, No argument for =item, empty section in previous paragraph,
16657 Verbatim paragraph in NAME section
16658
16659 =item Hyperlinks
16660
16661 ignoring leading/trailing whitespace in link, (section) in '$page'
16662 deprecated, alternative text/node '%s' contains non-escaped | or /
16663
16664 =back
16665
16666 =item RETURN VALUE
16667
16668 =item EXAMPLES
16669
16670 =item INTERFACE
16671
16672 =back
16673
16674 C<Pod::Checker-E<gt>new( %options )>
16675
16676 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16677 @args )>
16678
16679 C<$checker-E<gt>num_errors()>
16680
16681 C<$checker-E<gt>name()>
16682
16683 C<$checker-E<gt>node()>
16684
16685 C<$checker-E<gt>idx()>
16686
16687 C<$checker-E<gt>hyperlink()>
16688
16689 =over 4
16690
16691 =item AUTHOR
16692
16693 =back
16694
16695 =head2 Pod::Find - find POD documents in directory trees
16696
16697 =over 4
16698
16699 =item SYNOPSIS
16700
16701 =item DESCRIPTION
16702
16703 =back
16704
16705 =over 4
16706
16707 =item C<pod_find( { %opts } , @directories )>
16708
16709 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16710 1>
16711
16712 =back
16713
16714 =over 4
16715
16716 =item C<simplify_name( $str )>
16717
16718 =back
16719
16720 =over 4
16721
16722 =item C<pod_where( { %opts }, $pod )>
16723
16724 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16725 1>
16726
16727 =back
16728
16729 =over 4
16730
16731 =item C<contains_pod( $file , $verbose )>
16732
16733 =back
16734
16735 =over 4
16736
16737 =item AUTHOR
16738
16739 =item SEE ALSO
16740
16741 =back
16742
16743 =head2 Pod::Html - module to convert pod files to HTML
16744
16745 =over 4
16746
16747 =item SYNOPSIS
16748
16749 =item DESCRIPTION
16750
16751 =item ARGUMENTS
16752
16753 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16754 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16755 title, verbose
16756
16757 =item EXAMPLE
16758
16759 =item ENVIRONMENT
16760
16761 =item AUTHOR
16762
16763 =item SEE ALSO
16764
16765 =item COPYRIGHT
16766
16767 =back
16768
16769 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16770 commands, etc.
16771
16772 =over 4
16773
16774 =item SYNOPSIS
16775
16776 =item REQUIRES
16777
16778 =item EXPORTS
16779
16780 =item DESCRIPTION
16781
16782 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16783 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16784
16785 =back
16786
16787 =over 4
16788
16789 =item B<Pod::InputSource>
16790
16791 =back
16792
16793 =over 4
16794
16795 =item B<new()>
16796
16797 =back
16798
16799 =over 4
16800
16801 =item B<name()>
16802
16803 =back
16804
16805 =over 4
16806
16807 =item B<handle()>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item B<was_cutting()>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item B<Pod::Paragraph>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item Pod::Paragraph-E<gt>B<new()>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item $pod_para-E<gt>B<cmd_name()>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item $pod_para-E<gt>B<text()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item $pod_para-E<gt>B<raw_text()>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item $pod_para-E<gt>B<cmd_prefix()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item $pod_para-E<gt>B<cmd_separator()>
16856
16857 =back
16858
16859 =over 4
16860
16861 =item $pod_para-E<gt>B<parse_tree()>
16862
16863 =back
16864
16865 =over 4
16866
16867 =item $pod_para-E<gt>B<file_line()>
16868
16869 =back
16870
16871 =over 4
16872
16873 =item B<Pod::InteriorSequence>
16874
16875 =back
16876
16877 =over 4
16878
16879 =item Pod::InteriorSequence-E<gt>B<new()>
16880
16881 =back
16882
16883 =over 4
16884
16885 =item $pod_seq-E<gt>B<cmd_name()>
16886
16887 =back
16888
16889 =over 4
16890
16891 =item $pod_seq-E<gt>B<prepend()>
16892
16893 =back
16894
16895 =over 4
16896
16897 =item $pod_seq-E<gt>B<append()>
16898
16899 =back
16900
16901 =over 4
16902
16903 =item $pod_seq-E<gt>B<nested()>
16904
16905 =back
16906
16907 =over 4
16908
16909 =item $pod_seq-E<gt>B<raw_text()>
16910
16911 =back
16912
16913 =over 4
16914
16915 =item $pod_seq-E<gt>B<left_delimiter()>
16916
16917 =back
16918
16919 =over 4
16920
16921 =item $pod_seq-E<gt>B<right_delimiter()>
16922
16923 =back
16924
16925 =over 4
16926
16927 =item $pod_seq-E<gt>B<parse_tree()>
16928
16929 =back
16930
16931 =over 4
16932
16933 =item $pod_seq-E<gt>B<file_line()>
16934
16935 =back
16936
16937 =over 4
16938
16939 =item Pod::InteriorSequence::B<DESTROY()>
16940
16941 =back
16942
16943 =over 4
16944
16945 =item B<Pod::ParseTree>
16946
16947 =back
16948
16949 =over 4
16950
16951 =item Pod::ParseTree-E<gt>B<new()>
16952
16953 =back
16954
16955 =over 4
16956
16957 =item $ptree-E<gt>B<top()>
16958
16959 =back
16960
16961 =over 4
16962
16963 =item $ptree-E<gt>B<children()>
16964
16965 =back
16966
16967 =over 4
16968
16969 =item $ptree-E<gt>B<prepend()>
16970
16971 =back
16972
16973 =over 4
16974
16975 =item $ptree-E<gt>B<append()>
16976
16977 =back
16978
16979 =over 4
16980
16981 =item $ptree-E<gt>B<raw_text()>
16982
16983 =back
16984
16985 =over 4
16986
16987 =item Pod::ParseTree::B<DESTROY()>
16988
16989 =back
16990
16991 =over 4
16992
16993 =item SEE ALSO
16994
16995 =item AUTHOR
16996
16997 =back
16998
16999 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17000
17001 =over 4
17002
17003 =item SYNOPSIS
17004
17005 =item DESCRIPTION
17006
17007 =back
17008
17009 =over 4
17010
17011 =item OBJECT METHODS
17012
17013 C<initialize>
17014
17015 =back
17016
17017 =over 4
17018
17019 =item Data Accessors
17020
17021 B<AddPreamble>
17022
17023 =back
17024
17025 B<AddPostamble>
17026
17027 B<Head1Level>
17028
17029 B<Label>
17030
17031 B<LevelNoNum>
17032
17033 B<MakeIndex>
17034
17035 B<ReplaceNAMEwithSection>
17036
17037 B<StartWithNewPage>
17038
17039 B<TableOfContents>
17040
17041 B<UniqueLabels>
17042
17043 B<UserPreamble>
17044
17045 B<UserPostamble>
17046
17047 B<Lists>
17048
17049 =over 4
17050
17051 =item Subclassed methods
17052
17053 =back
17054
17055 B<begin_pod>
17056
17057 B<end_pod>
17058
17059 B<command>
17060
17061 B<verbatim>
17062
17063 B<textblock>
17064
17065 B<interior_sequence>
17066
17067 =over 4
17068
17069 =item List Methods
17070
17071 B<begin_list>
17072
17073 =back
17074
17075 B<end_list>
17076
17077 B<add_item>
17078
17079 =over 4
17080
17081 =item Methods for headings
17082
17083 B<head>
17084
17085 =back
17086
17087 =over 4
17088
17089 =item Internal methods
17090
17091 B<_output>
17092
17093 =back
17094
17095 B<_replace_special_chars>
17096
17097 B<_replace_special_chars_late>
17098
17099 B<_create_label>
17100
17101 B<_create_index>
17102
17103 B<_clean_latex_commands>
17104
17105 B<_split_delimited>
17106
17107 =over 4
17108
17109 =item NOTES
17110
17111 =item SEE ALSO
17112
17113 =item AUTHORS
17114
17115 =item COPYRIGHT
17116
17117 =item REVISION
17118
17119 =back
17120
17121 =head2 Pod::Man - Convert POD data to formatted *roff input
17122
17123 =over 4
17124
17125 =item SYNOPSIS
17126
17127 =item DESCRIPTION
17128
17129 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17130 release, section
17131
17132 =item DIAGNOSTICS
17133
17134 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17135 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17136 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17137 =back
17138
17139 =item BUGS
17140
17141 =item CAVEATS
17142
17143 =item SEE ALSO
17144
17145 =item AUTHOR
17146
17147 =item COPYRIGHT AND LICENSE
17148
17149 =back
17150
17151 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17152
17153 =over 4
17154
17155 =item SYNOPSIS
17156
17157 =item DESCRIPTION
17158
17159 =item AUTHOR
17160
17161 =item COPYRIGHT AND LICENSE
17162
17163 =back
17164
17165 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17166
17167 =over 4
17168
17169 =item SYNOPSIS
17170
17171 =item DESCRIPTION
17172
17173 =back
17174
17175 =over 4
17176
17177 =item Pod::List
17178
17179 Pod::List-E<gt>new()
17180
17181 =back
17182
17183 $list-E<gt>file()
17184
17185 $list-E<gt>start()
17186
17187 $list-E<gt>indent()
17188
17189 $list-E<gt>type()
17190
17191 $list-E<gt>rx()
17192
17193 $list-E<gt>item()
17194
17195 $list-E<gt>parent()
17196
17197 $list-E<gt>tag()
17198
17199 =over 4
17200
17201 =item Pod::Hyperlink
17202
17203 Pod::Hyperlink-E<gt>new()
17204
17205 =back
17206
17207 $link-E<gt>parse($string)
17208
17209 $link-E<gt>markup($string)
17210
17211 $link-E<gt>text()
17212
17213 $link-E<gt>warning()
17214
17215 $link-E<gt>file(), $link-E<gt>line()
17216
17217 $link-E<gt>page()
17218
17219 $link-E<gt>node()
17220
17221 $link-E<gt>alttext()
17222
17223 $link-E<gt>type()
17224
17225 $link-E<gt>link()
17226
17227 =over 4
17228
17229 =item Pod::Cache
17230
17231 Pod::Cache-E<gt>new()
17232
17233 =back
17234
17235 $cache-E<gt>item()
17236
17237 $cache-E<gt>find_page($name)
17238
17239 =over 4
17240
17241 =item Pod::Cache::Item
17242
17243 Pod::Cache::Item-E<gt>new()
17244
17245 =back
17246
17247 $cacheitem-E<gt>page()
17248
17249 $cacheitem-E<gt>description()
17250
17251 $cacheitem-E<gt>path()
17252
17253 $cacheitem-E<gt>file()
17254
17255 $cacheitem-E<gt>nodes()
17256
17257 $cacheitem-E<gt>find_node($name)
17258
17259 $cacheitem-E<gt>idx()
17260
17261 =over 4
17262
17263 =item AUTHOR
17264
17265 =item SEE ALSO
17266
17267 =back
17268
17269 =head2 Pod::Parser - base class for creating POD filters and translators
17270
17271 =over 4
17272
17273 =item SYNOPSIS
17274
17275 =item REQUIRES
17276
17277 =item EXPORTS
17278
17279 =item DESCRIPTION
17280
17281 =item QUICK OVERVIEW
17282
17283 =item PARSING OPTIONS
17284
17285 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17286 B<-warnings> (default: unset)
17287
17288 =back
17289
17290 =over 4
17291
17292 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17293
17294 =back
17295
17296 =over 4
17297
17298 =item B<command()>
17299
17300 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17301
17302 =back
17303
17304 =over 4
17305
17306 =item B<verbatim()>
17307
17308 C<$text>, C<$line_num>, C<$pod_para>
17309
17310 =back
17311
17312 =over 4
17313
17314 =item B<textblock()>
17315
17316 C<$text>, C<$line_num>, C<$pod_para>
17317
17318 =back
17319
17320 =over 4
17321
17322 =item B<interior_sequence()>
17323
17324 =back
17325
17326 =over 4
17327
17328 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17329
17330 =back
17331
17332 =over 4
17333
17334 =item B<new()>
17335
17336 =back
17337
17338 =over 4
17339
17340 =item B<initialize()>
17341
17342 =back
17343
17344 =over 4
17345
17346 =item B<begin_pod()>
17347
17348 =back
17349
17350 =over 4
17351
17352 =item B<begin_input()>
17353
17354 =back
17355
17356 =over 4
17357
17358 =item B<end_input()>
17359
17360 =back
17361
17362 =over 4
17363
17364 =item B<end_pod()>
17365
17366 =back
17367
17368 =over 4
17369
17370 =item B<preprocess_line()>
17371
17372 =back
17373
17374 =over 4
17375
17376 =item B<preprocess_paragraph()>
17377
17378 =back
17379
17380 =over 4
17381
17382 =item METHODS FOR PARSING AND PROCESSING
17383
17384 =back
17385
17386 =over 4
17387
17388 =item B<parse_text()>
17389
17390 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17391 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17392 I<code-ref>|I<method-name>
17393
17394 =back
17395
17396 =over 4
17397
17398 =item B<interpolate()>
17399
17400 =back
17401
17402 =over 4
17403
17404 =item B<parse_paragraph()>
17405
17406 =back
17407
17408 =over 4
17409
17410 =item B<parse_from_filehandle()>
17411
17412 =back
17413
17414 =over 4
17415
17416 =item B<parse_from_file()>
17417
17418 =back
17419
17420 =over 4
17421
17422 =item ACCESSOR METHODS
17423
17424 =back
17425
17426 =over 4
17427
17428 =item B<errorsub()>
17429
17430 =back
17431
17432 =over 4
17433
17434 =item B<cutting()>
17435
17436 =back
17437
17438 =over 4
17439
17440 =item B<parseopts()>
17441
17442 =back
17443
17444 =over 4
17445
17446 =item B<output_file()>
17447
17448 =back
17449
17450 =over 4
17451
17452 =item B<output_handle()>
17453
17454 =back
17455
17456 =over 4
17457
17458 =item B<input_file()>
17459
17460 =back
17461
17462 =over 4
17463
17464 =item B<input_handle()>
17465
17466 =back
17467
17468 =over 4
17469
17470 =item B<input_streams()>
17471
17472 =back
17473
17474 =over 4
17475
17476 =item B<top_stream()>
17477
17478 =back
17479
17480 =over 4
17481
17482 =item PRIVATE METHODS AND DATA
17483
17484 =back
17485
17486 =over 4
17487
17488 =item B<_push_input_stream()>
17489
17490 =back
17491
17492 =over 4
17493
17494 =item B<_pop_input_stream()>
17495
17496 =back
17497
17498 =over 4
17499
17500 =item TREE-BASED PARSING
17501
17502 =item SEE ALSO
17503
17504 =item AUTHOR
17505
17506 =back
17507
17508 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17509
17510 =over 4
17511
17512 =item SYNOPSIS
17513
17514 =item DESCRIPTION
17515
17516 =over 4
17517
17518 =item EXPORT
17519
17520 =back
17521
17522 =item AUTHOR
17523
17524 =item SEE ALSO
17525
17526 =back
17527
17528 =head2 Pod::Select, podselect() - extract selected sections of POD from
17529 input
17530
17531 =over 4
17532
17533 =item SYNOPSIS
17534
17535 =item REQUIRES
17536
17537 =item EXPORTS
17538
17539 =item DESCRIPTION
17540
17541 =item SECTION SPECIFICATIONS
17542
17543 =item RANGE SPECIFICATIONS
17544
17545 =back
17546
17547 =over 4
17548
17549 =item OBJECT METHODS
17550
17551 =back
17552
17553 =over 4
17554
17555 =item B<curr_headings()>
17556
17557 =back
17558
17559 =over 4
17560
17561 =item B<select()>
17562
17563 =back
17564
17565 =over 4
17566
17567 =item B<add_selection()>
17568
17569 =back
17570
17571 =over 4
17572
17573 =item B<clear_selections()>
17574
17575 =back
17576
17577 =over 4
17578
17579 =item B<match_section()>
17580
17581 =back
17582
17583 =over 4
17584
17585 =item B<is_selected()>
17586
17587 =back
17588
17589 =over 4
17590
17591 =item EXPORTED FUNCTIONS
17592
17593 =back
17594
17595 =over 4
17596
17597 =item B<podselect()>
17598
17599 B<-output>, B<-sections>, B<-ranges>
17600
17601 =back
17602
17603 =over 4
17604
17605 =item PRIVATE METHODS AND DATA
17606
17607 =back
17608
17609 =over 4
17610
17611 =item B<_compile_section_spec()>
17612
17613 =back
17614
17615 =over 4
17616
17617 =item $self->{_SECTION_HEADINGS}
17618
17619 =back
17620
17621 =over 4
17622
17623 =item $self->{_SELECTED_SECTIONS}
17624
17625 =back
17626
17627 =over 4
17628
17629 =item SEE ALSO
17630
17631 =item AUTHOR
17632
17633 =back
17634
17635 =head2 Pod::Text - Convert POD data to formatted ASCII text
17636
17637 =over 4
17638
17639 =item SYNOPSIS
17640
17641 =item DESCRIPTION
17642
17643 alt, code, indent, loose, quotes, sentence, width
17644
17645 =item DIAGNOSTICS
17646
17647 Bizarre space in item, Item called without tag, Can't open %s for reading:
17648 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17649 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17650 Unmatched =back
17651
17652 =item RESTRICTIONS
17653
17654 =item NOTES
17655
17656 =item SEE ALSO
17657
17658 =item AUTHOR
17659
17660 =item COPYRIGHT AND LICENSE
17661
17662 =back
17663
17664 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17665
17666 =over 4
17667
17668 =item SYNOPSIS
17669
17670 =item DESCRIPTION
17671
17672 =item BUGS
17673
17674 =item SEE ALSO
17675
17676 =item AUTHOR
17677
17678 =item COPYRIGHT AND LICENSE
17679
17680 =back
17681
17682 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17683 text
17684
17685 =over 4
17686
17687 =item SYNOPSIS
17688
17689 =item DESCRIPTION
17690
17691 =item BUGS
17692
17693 =item SEE ALSO
17694
17695 =item AUTHOR
17696
17697 =item COPYRIGHT AND LICENSE
17698
17699 =back
17700
17701 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17702 text with format escapes
17703
17704 =over 4
17705
17706 =item SYNOPSIS
17707
17708 =item DESCRIPTION
17709
17710 =item NOTES
17711
17712 =item SEE ALSO
17713
17714 =item AUTHOR
17715
17716 =item COPYRIGHT AND LICENSE
17717
17718 =back
17719
17720 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17721 documentation
17722
17723 =over 4
17724
17725 =item SYNOPSIS
17726
17727 =item ARGUMENTS
17728
17729 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17730 C<-pathlist>
17731
17732 =item DESCRIPTION
17733
17734 =item EXAMPLES
17735
17736 =over 4
17737
17738 =item Recommended Use
17739
17740 =back
17741
17742 =item CAVEATS
17743
17744 =item AUTHOR
17745
17746 =item ACKNOWLEDGEMENTS
17747
17748 =back
17749
17750 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17751 translators.
17752
17753 =over 4
17754
17755 =item HEADINGS
17756
17757 =item This C<is> a "level 1" heading
17758
17759 =over 4
17760
17761 =item ``Level'' "2 I<heading>
17762
17763 =back
17764
17765 =item This C<is> a "level 1" heading
17766
17767 =over 4
17768
17769 =item ``Level'' 2 I<heading>
17770
17771 =back
17772
17773 =item LINKS
17774
17775 =item OVER AND ITEMS
17776
17777 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17778 text
17779
17780 =item FORMATTING CODES
17781
17782 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17783
17784 =item VERBATIM
17785
17786 =item CONCLUSION
17787
17788 =back
17789
17790 =head2 Pod::t::htmlescp, Escape Sequences Test
17791
17792 =over 4
17793
17794 =item DESCRIPTION
17795
17796 =back
17797
17798 =head2 Pod::t::htmlview, Test HTML Rendering
17799
17800 =over 4
17801
17802 =item SYNOPSIS
17803
17804 =item DESCRIPTION
17805
17806 =item METHODS =E<gt> OTHER STUFF
17807
17808 =over 4
17809
17810 =item new()
17811
17812 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17813 Sat, 3 Mat
17814
17815 =item old()
17816
17817 =back
17818
17819 =item TESTING FOR AND BEGIN
17820
17821 =item TESTING URLs hyperlinking
17822
17823 =item SEE ALSO
17824
17825 =back
17826
17827 =head2 SDBM_File - Tied access to sdbm files
17828
17829 =over 4
17830
17831 =item SYNOPSIS
17832
17833 =item DESCRIPTION
17834
17835 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17836
17837 =item DIAGNOSTICS
17838
17839 =over 4
17840
17841 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17842
17843 =back
17844
17845 =item BUGS AND WARNINGS
17846
17847 =back
17848
17849 =head2 Safe - Compile and execute code in restricted compartments
17850
17851 =over 4
17852
17853 =item SYNOPSIS
17854
17855 =item DESCRIPTION
17856
17857 a new namespace, an operator mask
17858
17859 =item WARNING
17860
17861 =over 4
17862
17863 =item RECENT CHANGES
17864
17865 =item Methods in class Safe
17866
17867 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17868 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17869 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17870 root (NAMESPACE), mask (MASK)
17871
17872 =item Some Safety Issues
17873
17874 Memory, CPU, Snooping, Signals, State Changes
17875
17876 =item AUTHOR
17877
17878 =back
17879
17880 =back
17881
17882 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17883
17884 =over 4
17885
17886 =item SYNOPSIS
17887
17888 =item DESCRIPTION
17889
17890 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17891 EXPR, tainted EXPR, weaken REF
17892
17893 =item KNOWN BUGS
17894
17895 =item COPYRIGHT
17896
17897 =item BLATANT PLUG
17898
17899 =back
17900
17901 =head2 Search::Dict, look - search for key in dictionary file
17902
17903 =over 4
17904
17905 =item SYNOPSIS
17906
17907 =item DESCRIPTION
17908
17909 =back
17910
17911 =head2 SelectSaver - save and restore selected file handle
17912
17913 =over 4
17914
17915 =item SYNOPSIS
17916
17917 =item DESCRIPTION
17918
17919 =back
17920
17921 =head2 SelfLoader - load functions only on demand
17922
17923 =over 4
17924
17925 =item SYNOPSIS
17926
17927 =item DESCRIPTION
17928
17929 =over 4
17930
17931 =item The __DATA__ token
17932
17933 =item SelfLoader autoloading
17934
17935 =item Autoloading and package lexicals
17936
17937 =item SelfLoader and AutoLoader
17938
17939 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17940
17941 =item Classes and inherited methods.
17942
17943 =back
17944
17945 =item Multiple packages and fully qualified subroutine names
17946
17947 =back
17948
17949 =head2 Shell - run shell commands transparently within perl
17950
17951 =over 4
17952
17953 =item SYNOPSIS
17954
17955 =item DESCRIPTION
17956
17957 =over 4
17958
17959 =item OBJECT ORIENTED SYNTAX
17960
17961 =back
17962
17963 =item AUTHOR
17964
17965 =back
17966
17967 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17968 socket.h defines and structure manipulators 
17969
17970 =over 4
17971
17972 =item SYNOPSIS
17973
17974 =item DESCRIPTION
17975
17976 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17977 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17978 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17979 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17980 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17981
17982 =back
17983
17984 =head2 Storable - persistence for Perl data structures
17985
17986 =over 4
17987
17988 =item SYNOPSIS
17989
17990 =item DESCRIPTION
17991
17992 =item MEMORY STORE
17993
17994 =item ADVISORY LOCKING
17995
17996 =item SPEED
17997
17998 =item CANONICAL REPRESENTATION
17999
18000 =item FORWARD COMPATIBILITY
18001
18002 utf8 data, restricted hashes, files from future versions of Storable
18003
18004 =item ERROR REPORTING
18005
18006 =item WIZARDS ONLY
18007
18008 =over 4
18009
18010 =item Hooks
18011
18012 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18013 I<serialized>, ..
18014
18015 =item Predicates
18016
18017 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18018 C<Storable::is_retrieving>
18019
18020 =item Recursion
18021
18022 =item Deep Cloning
18023
18024 =back
18025
18026 =item Storable magic
18027
18028 =item EXAMPLES
18029
18030 =item WARNING
18031
18032 =item BUGS
18033
18034 =over 4
18035
18036 =item 64 bit data in perl 5.6.0 and 5.6.1
18037
18038 =back
18039
18040 =item CREDITS
18041
18042 =item AUTHOR
18043
18044 =item SEE ALSO
18045
18046 =back
18047
18048 =head2 Switch - A switch statement for Perl
18049
18050 =over 4
18051
18052 =item VERSION
18053
18054 =item SYNOPSIS
18055
18056 =item BACKGROUND
18057
18058 =item DESCRIPTION
18059
18060 =over 4
18061
18062 =item Allowing fall-through
18063
18064 =item Automating fall-through
18065
18066 =item Alternative syntax
18067
18068 =item Higher-order Operations
18069
18070 =back
18071
18072 =item DEPENDENCIES
18073
18074 =item AUTHOR
18075
18076 =item BUGS
18077
18078 =item LIMITATION
18079
18080 =item COPYRIGHT
18081
18082 =back
18083
18084 =head2 Symbol - manipulate Perl symbols and their names
18085
18086 =over 4
18087
18088 =item SYNOPSIS
18089
18090 =item DESCRIPTION
18091
18092 =back
18093
18094 =head2 Sys::Hostname - Try every conceivable way to get hostname
18095
18096 =over 4
18097
18098 =item SYNOPSIS
18099
18100 =item DESCRIPTION
18101
18102 =item AUTHOR
18103
18104 =back
18105
18106 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18107 interface to the UNIX syslog(3) calls
18108
18109 =over 4
18110
18111 =item SYNOPSIS
18112
18113 =item DESCRIPTION
18114
18115 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18116 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18117 in 5.004_02), closelog
18118
18119 =item EXAMPLES
18120
18121 =item SEE ALSO
18122
18123 =item AUTHOR
18124
18125 =back
18126
18127 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18128 Perl interface to the UNIX syslog(3) calls
18129
18130 =over 4
18131
18132 =item SYNOPSIS
18133
18134 =item DESCRIPTION
18135
18136 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18137 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18138 in 5.004_02), closelog
18139
18140 =item EXAMPLES
18141
18142 =item SEE ALSO
18143
18144 =item AUTHOR
18145
18146 =back
18147
18148 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18149
18150 =over 4
18151
18152 =item SYNOPSIS
18153
18154 =item DESCRIPTION
18155
18156 =item DIAGNOSTICS
18157
18158 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18159 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18160 comma allowed after filehandle, No name for escape sequence %s
18161
18162 =item ENVIRONMENT
18163
18164 ANSI_COLORS_DISABLED
18165
18166 =item RESTRICTIONS
18167
18168 =item NOTES
18169
18170 =item SEE ALSO
18171
18172 =item AUTHORS
18173
18174 =item LICENSE
18175
18176 =back
18177
18178 =head2 Term::Cap - Perl termcap interface
18179
18180 =over 4
18181
18182 =item SYNOPSIS
18183
18184 =item DESCRIPTION
18185
18186 =over 4
18187
18188 =item METHODS
18189
18190 =back
18191
18192 =back
18193
18194 B<Tgetent>, OSPEED, TERM
18195
18196 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18197
18198 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18199
18200 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18201
18202 B<Trequire>
18203
18204 =over 4
18205
18206 =item EXAMPLES
18207
18208 =item COPYRIGHT AND LICENSE
18209
18210 =item AUTHOR
18211
18212 =item SEE ALSO
18213
18214 =back
18215
18216 =head2 Term::Complete - Perl word completion module
18217
18218 =over 4
18219
18220 =item SYNOPSIS
18221
18222 =item DESCRIPTION
18223
18224 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18225
18226 =item DIAGNOSTICS
18227
18228 =item BUGS
18229
18230 =item AUTHOR
18231
18232 =back
18233
18234 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18235 no real package is found, substitutes stubs instead of basic functions.
18236
18237 =over 4
18238
18239 =item SYNOPSIS
18240
18241 =item DESCRIPTION
18242
18243 =item Minimal set of supported functions
18244
18245 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18246 C<MinLine>, C<findConsole>, Attribs, C<Features>
18247
18248 =item Additional supported functions
18249
18250 C<tkRunning>, C<ornaments>, C<newTTY>
18251
18252 =item EXPORTS
18253
18254 =item ENVIRONMENT
18255
18256 =item CAVEATS
18257
18258 =back
18259
18260 =head2 Test - provides a simple framework for writing test scripts
18261
18262 =over 4
18263
18264 =item SYNOPSIS
18265
18266 =item DESCRIPTION
18267
18268 =over 4
18269
18270 =item Functions
18271
18272 B<plan>
18273
18274 =back
18275
18276 =back
18277
18278 B<_to_value>
18279
18280 B<ok>
18281
18282 =over 4
18283
18284 =item TEST TYPES
18285
18286 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18287
18288 =item ONFAIL
18289
18290 =item BUGS and CAVEATS
18291
18292 =item NOTE
18293
18294 =item SEE ALSO
18295
18296 =item AUTHOR
18297
18298 =back
18299
18300 =head2 Test::Builder - Backend for building test libraries
18301
18302 =over 4
18303
18304 =item SYNOPSIS
18305
18306 =item DESCRIPTION
18307
18308 =over 4
18309
18310 =item Construction
18311
18312 B<new>
18313
18314 =back
18315
18316 =back
18317
18318 =over 4
18319
18320 =item Setting up tests
18321
18322 B<exported_to>
18323
18324 =back
18325
18326 B<plan>
18327
18328 B<expected_tests>
18329
18330 B<no_plan>
18331
18332 B<skip_all>
18333
18334 =over 4
18335
18336 =item Running tests
18337
18338 B<ok>
18339
18340 =back
18341
18342 B<is_eq>, B<is_num>
18343
18344 B<isnt_eq>, B<isnt_num>
18345
18346 B<like>, B<unlike>
18347
18348 B<maybe_regex>
18349
18350 B<cmp_ok>
18351
18352 B<BAILOUT>
18353
18354 B<skip>
18355
18356 B<todo_skip>
18357
18358 B<skip_rest>
18359
18360 =over 4
18361
18362 =item Test style
18363
18364 B<level>
18365
18366 =back
18367
18368 B<use_numbers>
18369
18370 B<no_header>, B<no_ending>
18371
18372 =over 4
18373
18374 =item Output
18375
18376 B<diag>
18377
18378 =back
18379
18380 B<_print>
18381
18382 B<output>, B<failure_output>, B<todo_output>
18383
18384 =over 4
18385
18386 =item Test Status and Info
18387
18388 B<current_test>
18389
18390 =back
18391
18392 B<summary>
18393
18394 B<details>  I<UNIMPLEMENTED>, B<todo>
18395
18396 B<caller>
18397
18398 B<_sanity_check>
18399
18400 B<_whoa>
18401
18402 B<_my_exit>
18403
18404 =over 4
18405
18406 =item EXAMPLES
18407
18408 =item SEE ALSO
18409
18410 =item AUTHORS
18411
18412 =item COPYRIGHT
18413
18414 =back
18415
18416 =head2 Test::Harness - run perl standard test scripts with statistics
18417
18418 =over 4
18419
18420 =item SYNOPSIS
18421
18422 =item DESCRIPTION
18423
18424 =over 4
18425
18426 =item The test script output
18427
18428 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18429 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18430 else>
18431
18432 =item Taint mode
18433
18434 =item Configuration variables.
18435
18436 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18437
18438 =item Failure
18439
18440 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18441 Failed>
18442
18443 =item Functions
18444
18445 B<runtests>
18446
18447 =back
18448
18449 =back
18450
18451 B<_all_ok>
18452
18453 B<_globdir>
18454
18455 B<_run_all_tests>
18456
18457 B<_mk_leader>
18458
18459 B<_leader_width>
18460
18461 =over 4
18462
18463 =item EXPORT
18464
18465 =item DIAGNOSTICS
18466
18467 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18468 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18469 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18470 %s>, C<FAILED--Further testing stopped: %s>
18471
18472 =item ENVIRONMENT
18473
18474 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18475 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18476 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18477
18478 =item EXAMPLE
18479
18480 =item SEE ALSO
18481
18482 =item AUTHORS
18483
18484 =item TODO
18485
18486 =item BUGS
18487
18488 =back
18489
18490 =head2 Test::Harness::Assert - simple assert
18491
18492 =over 4
18493
18494 =item SYNOPSIS
18495
18496 =item DESCRIPTION
18497
18498 =over 4
18499
18500 =item Functions
18501
18502 B<assert>
18503
18504 =back
18505
18506 =back
18507
18508 =over 4
18509
18510 =item AUTHOR
18511
18512 =item SEE ALSO
18513
18514 =back
18515
18516 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18517
18518 =over 4
18519
18520 =item SYNOPSIS
18521
18522 =item DESCRIPTION
18523
18524 =back
18525
18526 =head2 Test::Harness::Straps - detailed analysis of test results
18527
18528 =over 4
18529
18530 =item SYNOPSIS
18531
18532 =item DESCRIPTION
18533
18534 =over 4
18535
18536 =item Construction
18537
18538 B<new>
18539
18540 =back
18541
18542 =back
18543
18544 B<_init>
18545
18546 =over 4
18547
18548 =item Analysis
18549
18550 B<analyze>
18551
18552 =back
18553
18554 B<analyze_fh>
18555
18556 B<analyze_file>
18557
18558 B<_switches>
18559
18560 B<_INC2PERL5LIB>
18561
18562 B<_filtered_INC>
18563
18564 B<_restore_PERL5LIB>
18565
18566 =over 4
18567
18568 =item Parsing
18569
18570 B<_is_comment>
18571
18572 =back
18573
18574 B<_is_header>
18575
18576 B<_is_test>
18577
18578 B<_is_bail_out>
18579
18580 B<_reset_file_state>
18581
18582 =over 4
18583
18584 =item Results
18585
18586 B<_detailize>
18587
18588 =back
18589
18590 =over 4
18591
18592 =item EXAMPLES
18593
18594 =item AUTHOR
18595
18596 =item SEE ALSO
18597
18598 =back
18599
18600 =head2 Test::More - yet another framework for writing test scripts
18601
18602 =over 4
18603
18604 =item SYNOPSIS
18605
18606 =item DESCRIPTION
18607
18608 =over 4
18609
18610 =item I love it when a plan comes together
18611
18612 =back
18613
18614 =back
18615
18616 =over 4
18617
18618 =item Test names
18619
18620 =item I'm ok, you're not ok.
18621
18622 B<ok>
18623
18624 =back
18625
18626 B<is>, B<isnt>
18627
18628 B<like>
18629
18630 B<unlike>
18631
18632 B<cmp_ok>
18633
18634 B<can_ok>
18635
18636 B<isa_ok>
18637
18638 B<pass>, B<fail>
18639
18640 =over 4
18641
18642 =item Diagnostics
18643
18644 B<diag>
18645
18646 =back
18647
18648 =over 4
18649
18650 =item Module tests
18651
18652 B<use_ok>
18653
18654 =back
18655
18656 B<require_ok>
18657
18658 =over 4
18659
18660 =item Conditional tests
18661
18662 B<SKIP: BLOCK>
18663
18664 =back
18665
18666 B<TODO: BLOCK>, B<todo_skip>
18667
18668 =over 4
18669
18670 =item Comparison functions
18671
18672 B<is_deeply>
18673
18674 =back
18675
18676 B<eq_array>
18677
18678 B<eq_hash>
18679
18680 B<eq_set>
18681
18682 =over 4
18683
18684 =item Extending and Embedding Test::More
18685
18686 B<builder>
18687
18688 =back
18689
18690 =over 4
18691
18692 =item NOTES
18693
18694 =item BUGS and CAVEATS
18695
18696 Making your own ok(), The eq_* family has some caveats, Test::Harness
18697 upgrades
18698
18699 =item HISTORY
18700
18701 =item SEE ALSO
18702
18703 =item AUTHORS
18704
18705 =item COPYRIGHT
18706
18707 =back
18708
18709 =head2 Test::Simple - Basic utilities for writing tests.
18710
18711 =over 4
18712
18713 =item SYNOPSIS
18714
18715 =item DESCRIPTION
18716
18717 B<ok>
18718
18719 =back
18720
18721 =over 4
18722
18723 =item EXAMPLE
18724
18725 =item CAVEATS
18726
18727 =item NOTES
18728
18729 =item HISTORY
18730
18731 =item SEE ALSO
18732
18733 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18734 L<Test::Harness>
18735
18736 =item AUTHORS
18737
18738 =item COPYRIGHT
18739
18740 =back
18741
18742 =head2 Test::Tutorial - A tutorial about writing really basic tests
18743
18744 =over 4
18745
18746 =item DESCRIPTION
18747
18748 =over 4
18749
18750 =item Nuts and bolts of testing.
18751
18752 =item Where to start?
18753
18754 =item Names
18755
18756 =item Test the manual
18757
18758 =item Sometimes the tests are wrong
18759
18760 =item Testing lots of values
18761
18762 =item Informative names
18763
18764 =item Skipping tests
18765
18766 =item Todo tests
18767
18768 =item Testing with taint mode.
18769
18770 =back
18771
18772 =item FOOTNOTES
18773
18774 =item AUTHORS
18775
18776 =item COPYRIGHT
18777
18778 =back
18779
18780 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18781
18782 =over 4
18783
18784 =item SYNOPSIS
18785
18786 =item DESCRIPTION
18787
18788 =item EXAMPLE
18789
18790 =back
18791
18792 =head2 Text::Balanced - Extract delimited text sequences from strings.
18793
18794 =over 4
18795
18796 =item SYNOPSIS
18797
18798 =item DESCRIPTION
18799
18800 =over 4
18801
18802 =item General behaviour in list contexts
18803
18804 [0], [1], [2]
18805
18806 =item General behaviour in scalar and void contexts
18807
18808 =item A note about prefixes
18809
18810 =item C<extract_delimited>
18811
18812 =item C<extract_bracketed>
18813
18814 =item C<extract_tagged>
18815
18816 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18817 [0], [1], [2], [3], [4], [5]
18818
18819 =item C<gen_extract_tagged>
18820
18821 =item C<extract_quotelike>
18822
18823 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18824
18825 =item C<extract_quotelike> and "here documents"
18826
18827 [0], [1], [2], [3], [4], [5], [6], [7..10]
18828
18829 =item C<extract_codeblock>
18830
18831 =item C<extract_multiple>
18832
18833 =item C<gen_delimited_pat>
18834
18835 =back
18836
18837 =item DIAGNOSTICS
18838
18839  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
18840 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18841 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
18842 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18843 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18844 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18845 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18846 after dereferencer>, C<Did not find expected opening bracket at %s>,
18847 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18848 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18849 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18850 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18851 tag>
18852
18853 =item AUTHOR
18854
18855 =item BUGS AND IRRITATIONS
18856
18857 =item COPYRIGHT
18858
18859 =back
18860
18861 =head2 Text::ParseWords - parse text into an array of tokens or array of
18862 arrays
18863
18864 =over 4
18865
18866 =item SYNOPSIS
18867
18868 =item DESCRIPTION
18869
18870 =item EXAMPLES
18871
18872 =item AUTHORS
18873
18874 =back
18875
18876 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18877 by Knuth
18878
18879 =over 4
18880
18881 =item SYNOPSIS
18882
18883 =item DESCRIPTION
18884
18885 =item EXAMPLES
18886
18887 =item LIMITATIONS
18888
18889 =item AUTHOR
18890
18891 =back
18892
18893 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18894 unexpand(1)
18895
18896 =over 4
18897
18898 =item SYNOPSIS
18899
18900 =item DESCRIPTION
18901
18902 =item BUGS
18903
18904 =item AUTHOR
18905
18906 =back
18907
18908 =head2 Text::Wrap - line wrapping to form simple paragraphs
18909
18910 =over 4
18911
18912 =item SYNOPSIS 
18913
18914 =item DESCRIPTION
18915
18916 =item OVERRIDES
18917
18918 =item EXAMPLE
18919
18920 =item AUTHOR
18921
18922 =back
18923
18924 =head2 Thread - manipulate threads in Perl (for old code only)
18925
18926 =over 4
18927
18928 =item CAVEAT
18929
18930 =item SYNOPSIS
18931
18932 =item DESCRIPTION
18933
18934 =item FUNCTIONS
18935
18936 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18937 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18938 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18939
18940 =item METHODS
18941
18942 join, eval, detach, equal, tid, flags, done
18943
18944 =item LIMITATIONS
18945
18946 =item SEE ALSO
18947
18948 =back
18949
18950 =head2 Thread::Queue - thread-safe queues (for old code only)
18951
18952 =over 4
18953
18954 =item CAVEAT
18955
18956 =item SYNOPSIS
18957
18958 =item DESCRIPTION
18959
18960 =item FUNCTIONS AND METHODS
18961
18962 new, enqueue LIST, dequeue, dequeue_nb, pending
18963
18964 =item SEE ALSO
18965
18966 =back
18967
18968 =head2 Thread::Semaphore - thread-safe semaphores (for old code only)
18969
18970 =over 4
18971
18972 =item CAVEAT
18973
18974 =item SYNOPSIS
18975
18976 =item DESCRIPTION
18977
18978 =item FUNCTIONS AND METHODS
18979
18980 new, new NUMBER, down, down NUMBER, up, up NUMBER
18981
18982 =back
18983
18984 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18985
18986 =over 4
18987
18988 =item SYNOPSIS
18989
18990 =item DESCRIPTION
18991
18992 =item BUGS
18993
18994 =back
18995
18996 =head2 Thread::Specific - thread-specific keys
18997
18998 =over 4
18999
19000 =item SYNOPSIS
19001
19002 =item DESCRIPTION
19003
19004 =back
19005
19006 =head2 Tie::Array - base class for tied arrays
19007
19008 =over 4
19009
19010 =item SYNOPSIS
19011
19012 =item DESCRIPTION
19013
19014 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19015 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19016 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19017 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19018
19019 =item CAVEATS
19020
19021 =item AUTHOR
19022
19023 =back
19024
19025 =head2 Tie::File - Access the lines of a disk file via a Perl array
19026
19027 =over 4
19028
19029 =item SYNOPSIS
19030
19031 =item DESCRIPTION
19032
19033 =over 4
19034
19035 =item C<recsep>
19036
19037 =item C<autochomp>
19038
19039 =item C<mode>
19040
19041 =item C<memory>
19042
19043 =item C<dw_size>
19044
19045 =item Option Format
19046
19047 =back
19048
19049 =item Public Methods
19050
19051 =over 4
19052
19053 =item C<flock>
19054
19055 =item C<autochomp>
19056
19057 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19058
19059 =back
19060
19061 =item Tying to an already-opened filehandle
19062
19063 =item Deferred Writing
19064
19065 =over 4
19066
19067 =item Autodeferring
19068
19069 =back
19070
19071 =item CAVEATS
19072
19073 =item SUBCLASSING
19074
19075 =item WHAT ABOUT C<DB_File>?
19076
19077 =item AUTHOR
19078
19079 =item LICENSE
19080
19081 =item WARRANTY
19082
19083 =item THANKS
19084
19085 =item TODO
19086
19087 =back
19088
19089 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19090 handles
19091
19092 =over 4
19093
19094 =item SYNOPSIS
19095
19096 =item DESCRIPTION
19097
19098 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19099 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19100 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19101 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19102
19103 =item MORE INFORMATION
19104
19105 =item COMPATIBILITY
19106
19107 =back
19108
19109 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19110 tied hashes
19111
19112 =over 4
19113
19114 =item SYNOPSIS
19115
19116 =item DESCRIPTION
19117
19118 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19119 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19120
19121 =item Inheriting from B<Tie::StdHash>
19122
19123 =item Inheriting from B<Tie::ExtraHash>
19124
19125 =item C<UNTIE> and C<DESTROY>
19126
19127 =item MORE INFORMATION
19128
19129 =back
19130
19131 =head2 Tie::Memoize - add data to hash when needed
19132
19133 =over 4
19134
19135 =item SYNOPSIS
19136
19137 =item DESCRIPTION
19138
19139 =item Inheriting from B<Tie::Memoize>
19140
19141 =item EXAMPLE
19142
19143 =item BUGS
19144
19145 =item AUTHOR
19146
19147 =back
19148
19149 =head2 Tie::RefHash - use references as hash keys
19150
19151 =over 4
19152
19153 =item SYNOPSIS
19154
19155 =item DESCRIPTION
19156
19157 =item EXAMPLE
19158
19159 =item AUTHOR
19160
19161 =item VERSION
19162
19163 =item SEE ALSO
19164
19165 =back
19166
19167 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19168 scalars
19169
19170 =over 4
19171
19172 =item SYNOPSIS
19173
19174 =item DESCRIPTION
19175
19176 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19177
19178 =item MORE INFORMATION
19179
19180 =back
19181
19182 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19183
19184 =over 4
19185
19186 =item SYNOPSIS
19187
19188 =item DESCRIPTION
19189
19190 =item CAVEATS
19191
19192 =back
19193
19194 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19195 timers
19196
19197 =over 4
19198
19199 =item SYNOPSIS
19200
19201 =item DESCRIPTION
19202
19203 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19204 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19205 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19206 getitimer ( $which )
19207
19208 =item EXAMPLES
19209
19210 =item C API
19211
19212 =item CAVEATS
19213
19214 =item AUTHORS
19215
19216 =item REVISION
19217
19218 =item COPYRIGHT
19219
19220 =back
19221
19222 =head2 Time::Local - efficiently compute time from local and GMT time
19223
19224 =over 4
19225
19226 =item SYNOPSIS
19227
19228 =item DESCRIPTION
19229
19230 =item IMPLEMENTATION
19231
19232 =item BUGS
19233
19234 =back
19235
19236 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19237 function
19238
19239 =over 4
19240
19241 =item SYNOPSIS
19242
19243 =item DESCRIPTION
19244
19245 =item NOTE
19246
19247 =item AUTHOR
19248
19249 =back
19250
19251 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19252 function
19253
19254 =over 4
19255
19256 =item SYNOPSIS
19257
19258 =item DESCRIPTION
19259
19260 =item NOTE
19261
19262 =item AUTHOR
19263
19264 =back
19265
19266 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19267
19268 =over 4
19269
19270 =item SYNOPSIS
19271
19272 =item DESCRIPTION
19273
19274 =item AUTHOR
19275
19276 =back
19277
19278 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19279
19280 =over 4
19281
19282 =item SYNOPSIS
19283
19284 =item DESCRIPTION
19285
19286 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19287 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19288
19289 =back
19290
19291 =head2 Unicode::Collate - Unicode Collation Algorithm
19292
19293 =over 4
19294
19295 =item SYNOPSIS
19296
19297 =item DESCRIPTION
19298
19299 =over 4
19300
19301 =item Constructor and Tailoring
19302
19303 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19304 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19305 undefChar, katakana_before_hiragana, upper_before_lower
19306
19307 =item Methods for Collation
19308
19309 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19310 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19311 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19312 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19313 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19314 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19315 $Collator-E<gt>viewSortKey($string)>, C<$position =
19316 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19317 $Collator-E<gt>index($string, $substring)>
19318
19319 =item Other Methods
19320
19321 UCA_Version, Base_Unicode_Version
19322
19323 =item EXPORT
19324
19325 =item TODO
19326
19327 =item CAVEAT
19328
19329 =item BUGS
19330
19331 =back
19332
19333 =item AUTHOR
19334
19335 =item SEE ALSO
19336
19337 http://www.unicode.org/unicode/reports/tr10/,
19338 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19339 http://www.unicode.org/unicode/reports/tr15/,
19340 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19341
19342 =back
19343
19344 =head2 Unicode::Normalize - Unicode Normalization Forms
19345
19346 =over 4
19347
19348 =item SYNOPSIS
19349
19350 =item DESCRIPTION
19351
19352 =over 4
19353
19354 =item Normalization Forms
19355
19356 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19357 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19358 C<$normalized_string = normalize($form_name, $string)>
19359
19360 =item Decomposition and Composition
19361
19362 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19363 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19364 reorder($string)>, C<$composed_string   = compose($string)>
19365
19366 =item Quick Check
19367
19368 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19369 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19370 check($form_name, $string)>
19371
19372 =item Character Data
19373
19374 C<$canonical_decomposed = getCanon($codepoint)>,
19375 C<$compatibility_decomposed = getCompat($codepoint)>,
19376 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19377 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19378 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19379 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19380 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19381
19382 =item EXPORT
19383
19384 =back
19385
19386 =item AUTHOR
19387
19388 =item SEE ALSO
19389
19390 http://www.unicode.org/unicode/reports/tr15/,
19391 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19392
19393 =back
19394
19395 =head2 Unicode::UCD - Unicode character database
19396
19397 =over 4
19398
19399 =item SYNOPSIS
19400
19401 =item DESCRIPTION
19402
19403 =back
19404
19405 =over 4
19406
19407 =item charinfo
19408
19409 =back
19410
19411 =over 4
19412
19413 =item charblock
19414
19415 =back
19416
19417 =over 4
19418
19419 =item charscript
19420
19421 =back
19422
19423 =over 4
19424
19425 =item charblocks
19426
19427 =back
19428
19429 =over 4
19430
19431 =item charscripts
19432
19433 =back
19434
19435 =over 4
19436
19437 =item Blocks versus Scripts
19438
19439 =item Matching Scripts and Blocks
19440
19441 =item Code Point Arguments
19442
19443 =item charinrange
19444
19445 =back
19446
19447 =over 4
19448
19449 =item compexcl
19450
19451 =back
19452
19453 =over 4
19454
19455 =item casefold
19456
19457 =back
19458
19459 =over 4
19460
19461 =item casespec
19462
19463 =back
19464
19465 =over 4
19466
19467 =item Unicode::UCD::UnicodeVersion
19468
19469 =back
19470
19471 =over 4
19472
19473 =item Implementation Note
19474
19475 =back
19476
19477 =over 4
19478
19479 =item BUGS
19480
19481 =item AUTHOR
19482
19483 =back
19484
19485 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19486 functions
19487
19488 =over 4
19489
19490 =item SYNOPSIS
19491
19492 =item DESCRIPTION
19493
19494 =item NOTE
19495
19496 =item AUTHOR
19497
19498 =back
19499
19500 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19501 functions
19502
19503 =over 4
19504
19505 =item SYNOPSIS
19506
19507 =item DESCRIPTION
19508
19509 =over 4
19510
19511 =item System Specifics
19512
19513 =back
19514
19515 =item NOTE
19516
19517 =item AUTHOR
19518
19519 =item HISTORY
19520
19521 March 18th, 2000
19522
19523 =back
19524
19525 =head2 Win32 - Interfaces to some Win32 API Functions
19526
19527 =over 4
19528
19529 =item DESCRIPTION
19530
19531 =over 4
19532
19533 =item Alphabetical Listing of Win32 Functions
19534
19535 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19536 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19537 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19538 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19539 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19540 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19541 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19542 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19543 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19544 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19545 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19546 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19547 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19548 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19549 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19550 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19551 Win32::UnregisterServer(LIBRARYNAME)
19552
19553 =back
19554
19555 =back
19556
19557 =head2 XS::APItest - Test the perl C API
19558
19559 =over 4
19560
19561 =item SYNOPSIS
19562
19563 =item ABSTRACT
19564
19565 =item DESCRIPTION
19566
19567 =over 4
19568
19569 =item EXPORT
19570
19571 B<print_double>, B<print_long_double>, B<have_long_double>, B<print_nv>,
19572 B<print_iv>, B<print_uv>, B<print_int>, B<print_long>, B<print_float>
19573
19574 =back
19575
19576 =item SEE ALSO
19577
19578 =item AUTHORS
19579
19580 =item COPYRIGHT AND LICENSE
19581
19582 =back
19583
19584 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
19585
19586 =over 4
19587
19588 =item SYNOPSIS
19589
19590 =item DESCRIPTION
19591
19592 =back
19593
19594 =over 4
19595
19596 =item NOTES
19597
19598 =item AUTHOR
19599
19600 =back
19601
19602 =head2 XSLoader - Dynamically load C libraries into Perl code
19603
19604 =over 4
19605
19606 =item SYNOPSIS
19607
19608 =item DESCRIPTION
19609
19610 =item AUTHOR
19611
19612 =back
19613
19614 =head1 AUXILIARY DOCUMENTATION
19615
19616 Here should be listed all the extra programs' documentation, but they
19617 don't all have manual pages yet:
19618
19619 =over 4
19620
19621 =item a2p
19622
19623 =item s2p
19624
19625 =item find2perl
19626
19627 =item h2ph
19628
19629 =item c2ph
19630
19631 =item h2xs
19632
19633 =item xsubpp
19634
19635 =item pod2man
19636
19637 =item wrapsuid
19638
19639 =back
19640
19641 =head1 AUTHOR
19642
19643 Larry Wall <F<larry@wall.org>>, with the help of oodles
19644 of other folks.
19645