Tiny tweaks.
[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,mode)>, B<PerlIO_exportFILE(f,mode)>,
4708 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4709
4710 =item "Fast gets" Functions
4711
4712 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4713 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4714 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4715 B<PerlIO_get_bufsiz(f)>
4716
4717 =item Other Functions
4718
4719 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4720 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4721
4722 =back
4723
4724 =back
4725
4726 =head2 perltodo - Perl TO-DO List
4727
4728 =over 4
4729
4730 =item DESCRIPTION
4731
4732 =item To do during 5.6.x
4733
4734 =over 4
4735
4736 =item Support for I/O disciplines
4737
4738 =item Autoload bytes.pm
4739
4740 =item Make "\u{XXXX}" et al work
4741
4742 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4743
4744 =item Overloadable regex assertions
4745
4746 =item Unicode
4747
4748 =item Work out exit/die semantics for threads
4749
4750 =item Better support for nonpreemptive threading systems like GNU pth
4751
4752 =item Typed lexicals for compiler
4753
4754 =item Compiler workarounds for Win32
4755
4756 =item AUTOLOADing in the compiler
4757
4758 =item Fixing comppadlist when compiling
4759
4760 =item Cleaning up exported namespace
4761
4762 =item Complete signal handling
4763
4764 =item Out-of-source builds
4765
4766 =item POSIX realtime support
4767
4768 =item UNIX98 support
4769
4770 =item IPv6 Support
4771
4772 =item Long double conversion
4773
4774 =item Locales
4775
4776 =item Arithmetic on non-Arabic numerals
4777
4778 =item POSIX Unicode character classes
4779
4780 =item Factoring out common suffices/prefices in regexps (trie optimization)
4781
4782 =item Security audit shipped utilities
4783
4784 =item Sort out the uid-setting mess
4785
4786 =item Custom opcodes
4787
4788 =item DLL Versioning
4789
4790 =item Introduce @( and @)
4791
4792 =item Floating point handling
4793
4794 =item IV/UV preservation
4795
4796 =item Replace pod2html with something using Pod::Parser
4797
4798 =item Automate module testing on CPAN
4799
4800 =item sendmsg and recvmsg
4801
4802 =item Rewrite perlre documentation
4803
4804 =item Convert example code to IO::Handle filehandles
4805
4806 =item Document Win32 choices
4807
4808 =item Check new modules
4809
4810 =item Make roffitall find pods and libs itself
4811
4812 =back
4813
4814 =item To do at some point
4815
4816 =over 4
4817
4818 =item Remove regular expression recursion
4819
4820 =item Memory leaks after failed eval
4821
4822 =item bitfields in pack
4823
4824 =item Cross compilation
4825
4826 =item Perl preprocessor / macros
4827
4828 =item Perl lexer in Perl
4829
4830 =item Using POSIX calls internally
4831
4832 =item -i rename file when changed
4833
4834 =item All ARGV input should act like E<lt>E<gt>
4835
4836 =item Support for rerunning debugger
4837
4838 =item Test Suite for the Debugger
4839
4840 =item my sub foo { }
4841
4842 =item One-pass global destruction
4843
4844 =item Rewrite regexp parser
4845
4846 =item Cache recently used regexps
4847
4848 =item Cross-compilation support
4849
4850 =item Bit-shifting bitvectors
4851
4852 =item debugger pragma
4853
4854 =item use less pragma
4855
4856 =item switch structures
4857
4858 =item Cache eval tree
4859
4860 =item rcatmaybe
4861
4862 =item Shrink opcode tables
4863
4864 =item Optimize away @_
4865
4866 =item Prototypes versus indirect objects
4867
4868 =item Install HTML
4869
4870 =item Prototype method calls
4871
4872 =item Return context prototype declarations
4873
4874 =item magic_setisa
4875
4876 =item Garbage collection
4877
4878 =item IO tutorial
4879
4880 =item Rewrite perldoc
4881
4882 =item Install .3p manpages
4883
4884 =item Unicode tutorial
4885
4886 =item Update POSIX.pm for 1003.1-2
4887
4888 =item Retargetable installation
4889
4890 =item POSIX emulation on non-POSIX systems
4891
4892 =item Rename Win32 headers
4893
4894 =item Finish off lvalue functions
4895
4896 =item Update sprintf documentation
4897
4898 =item Use fchown/fchmod internally
4899
4900 =item Make v-strings overloaded objects
4901
4902 =item Allow restricted hash assignment
4903
4904 =item Should overload be inheritable?
4905
4906 =item Taint rethink
4907
4908 =back
4909
4910 =item Vague ideas
4911
4912 =over 4
4913
4914 =item ref() in list context
4915
4916 =item Make tr/// return histogram of characters in list context
4917
4918 =item Compile to real threaded code
4919
4920 =item Structured types
4921
4922 =item Modifiable $1 et al.
4923
4924 =item Procedural interfaces for IO::*, etc.
4925
4926 =item RPC modules
4927
4928 =item Attach/detach debugger from running program
4929
4930 =item GUI::Native
4931
4932 =item foreach(reverse ...)
4933
4934 =item Constant function cache
4935
4936 =item Approximate regular expression matching
4937
4938 =back
4939
4940 =item Ongoing
4941
4942 =over 4
4943
4944 =item Update guts documentation
4945
4946 =item Add more tests
4947
4948 =item Update auxiliary tools
4949
4950 =item Create debugging macros
4951
4952 =item truncate to the people
4953
4954 =item Unicode in Filenames
4955
4956 =back
4957
4958 =item Recently done things
4959
4960 =over 4
4961
4962 =item Alternative RE syntax module
4963
4964 =item Safe signal handling
4965
4966 =item Tie Modules
4967
4968 =item gettimeofday
4969
4970 =item setitimer and getimiter
4971
4972 =item Testing __DIE__ hook
4973
4974 =item CPP equivalent in Perl
4975
4976 =item Explicit switch statements
4977
4978 =item autocroak
4979
4980 =item UTF/EBCDIC
4981
4982 =item UTF Regexes
4983
4984 =item perlcc to produce executable
4985
4986 =item END blocks saved in compiled output
4987
4988 =item Secure temporary file module
4989
4990 =item Integrate Time::HiRes
4991
4992 =item Turn Cwd into XS
4993
4994 =item Mmap for input
4995
4996 =item Byte to/from UTF8 and UTF8 to/from local conversion
4997
4998 =item Add sockatmark support
4999
5000 =item Mailing list archives
5001
5002 =item Bug tracking
5003
5004 =item Integrate MacPerl
5005
5006 =item Web "nerve center" for Perl
5007
5008 =item Regular expression tutorial
5009
5010 =item Debugging Tutorial
5011
5012 =item Integrate new modules
5013
5014 =item Integrate profiler
5015
5016 =item Y2K error detection
5017
5018 =item Regular expression debugger
5019
5020 =item POD checker
5021
5022 =item "Dynamic" lexicals
5023
5024 =item Cache precompiled modules
5025
5026 =back
5027
5028 =item Deprecated Wishes
5029
5030 =over 4
5031
5032 =item Loop control on do{}
5033
5034 =item Lexically scoped typeglobs
5035
5036 =item format BOTTOM
5037
5038 =item report HANDLE
5039
5040 =item Generalised want()/caller())
5041
5042 =item Named prototypes
5043
5044 =item Built-in globbing
5045
5046 =item Regression tests for suidperl
5047
5048 =item Cached hash values
5049
5050 =item Add compression modules
5051
5052 =item Reorganise documentation into tutorials/references
5053
5054 =item Remove distinction between functions and operators
5055
5056 =item Make XS easier to use
5057
5058 =item Make embedding easier to use
5059
5060 =item man for perl
5061
5062 =item my $Package::variable
5063
5064 =item "or" tests defined, not truth
5065
5066 =item "class"-based lexicals
5067
5068 =item byteperl
5069
5070 =item Lazy evaluation / tail recursion removal
5071
5072 =item Make "use utf8" the default
5073
5074 =item Unicode collation and normalization
5075
5076 =item pack/unpack tutorial
5077
5078 =back
5079
5080 =back
5081
5082 =head2 perlhack - How to hack at the Perl internals
5083
5084 =over 4
5085
5086 =item DESCRIPTION
5087
5088 Does concept match the general goals of Perl?, Where is the
5089 implementation?, Backwards compatibility, Could it be a module instead?, Is
5090 the feature generic enough?, Does it potentially introduce new bugs?, Does
5091 it preclude other desirable features?, Is the implementation robust?, Is
5092 the implementation generic enough to be portable?, Is the implementation
5093 tested?, Is there enough documentation?, Is there another way to do it?,
5094 Does it create too much work?, Patches speak louder than words
5095
5096 =over 4
5097
5098 =item Keeping in sync
5099
5100 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5101 NFS, rsync'ing the patches
5102
5103 =item Why rsync the source tree
5104
5105 It's easier to rsync the source tree, It's more reliable
5106
5107 =item Why rsync the patches
5108
5109 It's easier to rsync the patches, It's a good reference, Finding a start
5110 point, Finding how to fix a bug, Finding the source of misbehaviour
5111
5112 =item Perlbug remote interface
5113
5114 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5115 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5116
5117 =item Submitting patches
5118
5119 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5120 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5121
5122 =item Finding Your Way Around
5123
5124 Core modules, Tests, Documentation, Configure, Interpreter
5125
5126 =item Elements of the interpreter
5127
5128 Startup, Parsing, Optimization, Running
5129
5130 =item Internal Variable Types
5131
5132 =item Op Trees
5133
5134 =item Stacks
5135
5136 Argument stack, Mark stack, Save stack
5137
5138 =item Millions of Macros
5139
5140 =item Poking at Perl
5141
5142 =item Using a source-level debugger
5143
5144 run [args], break function_name, break source.c:xxx, step, next, continue,
5145 finish, 'enter', print
5146
5147 =item Dumping Perl Data Structures
5148
5149 =item Patching
5150
5151 =item Patching a core module
5152
5153 =item Adding a new function to the core
5154
5155 =item Writing a test
5156
5157 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5158 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5159
5160 =item Special Make Test Targets
5161
5162 coretest, test.deparse, minitest, test.third check.third utest.third
5163 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5164
5165 =back
5166
5167 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5168
5169 =over 4
5170
5171 =item Rational Software's Purify
5172
5173 =item Purify on Unix
5174
5175 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5176
5177 =item Purify on NT
5178
5179 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5180
5181 =item Compaq's/Digital's/HP's Third Degree
5182
5183 =item PERL_DESTRUCT_LEVEL
5184
5185 =item Profiling
5186
5187 =item Gprof Profiling
5188
5189 -a, -b, -e routine, -f routine, -s, -z
5190
5191 =item GCC gcov Profiling
5192
5193 =item Pixie Profiling
5194
5195 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5196 -z[ero]
5197
5198 =item Miscellaneous tricks
5199
5200 =item CONCLUSION
5201
5202 I<The Road goes ever on and on, down from the door where it began.>
5203
5204 =back
5205
5206 =item AUTHOR
5207
5208 =back
5209
5210 =head2 perlhist - the Perl history records
5211
5212 =over 4
5213
5214 =item DESCRIPTION
5215
5216 =item INTRODUCTION
5217
5218 =item THE KEEPERS OF THE PUMPKIN
5219
5220 =over 4
5221
5222 =item PUMPKIN?
5223
5224 =back
5225
5226 =item THE RECORDS
5227
5228 =over 4
5229
5230 =item SELECTED RELEASE SIZES
5231
5232 =item SELECTED PATCH SIZES
5233
5234 =back
5235
5236 =item THE KEEPERS OF THE RECORDS
5237
5238 =back
5239
5240 =head2 perldelta - what is new for perl v5.8.0
5241
5242 =over 4
5243
5244 =item DESCRIPTION
5245
5246 =item Highlights In 5.8.0
5247
5248 =item Incompatible Changes
5249
5250 =over 4
5251
5252 =item Binary Incompatibility
5253
5254 =item 64-bit platforms and malloc
5255
5256 =item AIX Dynaloading
5257
5258 =item Attributes for C<my> variables now handled at run-time.
5259
5260 =item Socket Extension Dynamic in VMS
5261
5262 =item IEEE-format Floating Point Default on OpenVMS Alpha
5263
5264 =item New Unicode Properties
5265
5266 =item REF(...) Instead Of SCALAR(...)
5267
5268 =item pack/unpack D/F recycled
5269
5270 =item Deprecations
5271
5272 =back
5273
5274 =item Core Enhancements
5275
5276 =over 4
5277
5278 =item PerlIO is Now The Default
5279
5280 =item Restricted Hashes
5281
5282 =item Safe Signals
5283
5284 =item Unicode Overhaul
5285
5286 =item Understanding of Numbers
5287
5288 =item Arrays now always interpolate into double-quoted strings [561]
5289
5290 =item Miscellaneous Changes
5291
5292 =back
5293
5294 =item Modules and Pragmata
5295
5296 =over 4
5297
5298 =item New Modules and Pragmata
5299
5300 =item Updated And Improved Modules and Pragmata
5301
5302 =back
5303
5304 =item Utility Changes
5305
5306 =item New Documentation
5307
5308 =item Performance Enhancements
5309
5310 =item Installation and Configuration Improvements
5311
5312 =over 4
5313
5314 =item Generic Improvements
5315
5316 =item New Or Improved Platforms
5317
5318 =back
5319
5320 =item Selected Bug Fixes
5321
5322 =over 4
5323
5324 =item Platform Specific Changes and Fixes
5325
5326 =back
5327
5328 =item New or Changed Diagnostics
5329
5330 =item Changed Internals
5331
5332 =item Security Vulnerability Closed [561]
5333
5334 =item New Tests
5335
5336 =item Known Problems
5337
5338 =over 4
5339
5340 =item AIX
5341
5342 =item Alpha systems with old gccs fail several tests
5343
5344 =item AmigaOS
5345
5346 =item BeOS
5347
5348 =item Cygwin "unable to remap"
5349
5350 =item 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 OS/2 Test Failures
5375
5376 =item op/sprintf tests 91, 129, and 130
5377
5378 =item Solaris 2.5
5379
5380 =item Solaris x86 Fails Tests With -Duse64bitint
5381
5382 =item SUPER-UX (NEC SX)
5383
5384 =item PDL failing some tests
5385
5386 =item Term::ReadKey not working on Win32
5387
5388 =item Failure of Thread (5.005-style) tests
5389
5390 =item Timing problems
5391
5392 =item UNICOS/mk
5393
5394 =item UTS
5395
5396 =item VOS (Stratus)
5397
5398 =item VMS
5399
5400 =item Win32
5401
5402 =item XML::Parser not working
5403
5404 =item z/OS (OS/390)
5405
5406 =item Localising Tied Arrays and Hashes Is Broken
5407
5408 =item Self-tying Problems
5409
5410 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5411
5412 =item Building Extensions Can Fail Because Of Largefiles
5413
5414 =item Unicode Support on EBCDIC Still Spotty
5415
5416 =item The Compiler Suite Is Still Very Experimental
5417
5418 =item The Long Double Support Is Still Experimental
5419
5420 =item Seen In Perl 5.7 But Gone Now
5421
5422 =back
5423
5424 =item Reporting Bugs
5425
5426 =item SEE ALSO
5427
5428 =item HISTORY
5429
5430 =back
5431
5432 =head2 perl572delta - what's new for perl v5.7.2
5433
5434 =over 4
5435
5436 =item DESCRIPTION
5437
5438 =item Security Vulnerability Closed
5439
5440 =item Incompatible Changes
5441
5442 =over 4
5443
5444 =item 64-bit platforms and malloc
5445
5446 =item AIX Dynaloading
5447
5448 =item Socket Extension Dynamic in VMS
5449
5450 =item Different Definition of the Unicode Character Classes \p{In...}
5451
5452 =item Deprecations
5453
5454 =back
5455
5456 =item Core Enhancements
5457
5458 =item Modules and Pragmata
5459
5460 =over 4
5461
5462 =item New Modules and Distributions
5463
5464 =item Updated And Improved Modules and Pragmata
5465
5466 =back
5467
5468 =item Utility Changes
5469
5470 =item New Documentation
5471
5472 =item Installation and Configuration Improvements
5473
5474 =over 4
5475
5476 =item New Or Improved Platforms
5477
5478 =item Generic Improvements
5479
5480 =back
5481
5482 =item Selected Bug Fixes
5483
5484 =over 4
5485
5486 =item Platform Specific Changes and Fixes
5487
5488 =back
5489
5490 =item New or Changed Diagnostics
5491
5492 =item Source Code Enhancements
5493
5494 =over 4
5495
5496 =item MAGIC constants
5497
5498 =item Better commented code
5499
5500 =item Regex pre-/post-compilation items matched up
5501
5502 =item gcc -Wall
5503
5504 =back
5505
5506 =item New Tests
5507
5508 =item Known Problems
5509
5510 =over 4
5511
5512 =item AIX
5513
5514 =item Amiga Perl Invoking Mystery
5515
5516 =item lib/ftmp-security tests warn 'system possibly insecure'
5517
5518 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5519
5520 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5521
5522 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5523
5524 =item Linux With Sfio Fails op/misc Test 48
5525
5526 =item OS/390
5527
5528 =item op/sprintf tests 129 and 130
5529
5530 =item  Failure of Thread tests
5531
5532 =item UNICOS
5533
5534 =item UTS
5535
5536 =item VMS
5537
5538 =item Win32
5539
5540 =item Localising a Tied Variable Leaks Memory
5541
5542 =item Self-tying of Arrays and Hashes Is Forbidden
5543
5544 =item Variable Attributes are not Currently Usable for Tieing
5545
5546 =item Building Extensions Can Fail Because Of Largefiles
5547
5548 =item The Compiler Suite Is Still Experimental
5549
5550 =item The Long Double Support is Still Experimental
5551
5552 =back
5553
5554 =item Reporting Bugs
5555
5556 =item SEE ALSO
5557
5558 =item HISTORY
5559
5560 =back
5561
5562 =head2 perl571delta - what's new for perl v5.7.1
5563
5564 =over 4
5565
5566 =item DESCRIPTION
5567
5568 =item Security Vulnerability Closed
5569
5570 =item Incompatible Changes
5571
5572 =item Core Enhancements
5573
5574 =over 4
5575
5576 =item AUTOLOAD Is Now Lvaluable
5577
5578 =item PerlIO is Now The Default
5579
5580 =item Signals Are Now Safe
5581
5582 =back
5583
5584 =item Modules and Pragmata
5585
5586 =over 4
5587
5588 =item New Modules
5589
5590 =item Updated And Improved Modules and Pragmata
5591
5592 =back
5593
5594 =item Performance Enhancements
5595
5596 =item Utility Changes
5597
5598 =item New Documentation
5599
5600 =over 4
5601
5602 =item perlclib
5603
5604 =item perliol
5605
5606 =item README.aix
5607
5608 =item README.bs2000
5609
5610 =item README.macos
5611
5612 =item README.mpeix
5613
5614 =item README.solaris
5615
5616 =item README.vos
5617
5618 =item Porting/repository.pod
5619
5620 =back
5621
5622 =item Installation and Configuration Improvements
5623
5624 =over 4
5625
5626 =item New Or Improved Platforms
5627
5628 =item Generic Improvements
5629
5630 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5631 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5632 d_strtoq, d_u32align, d_ualarm, d_usleep
5633
5634 =back
5635
5636 =item Selected Bug Fixes
5637
5638 =over 4
5639
5640 =item Platform Specific Changes and Fixes
5641
5642 =back
5643
5644 =item New or Changed Diagnostics
5645
5646 =item Changed Internals
5647
5648 =item New Tests
5649
5650 =item Known Problems
5651
5652 =over 4
5653
5654 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5655
5656 =item lib/ftmp-security tests warn 'system possibly insecure'
5657
5658 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5659
5660 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5661
5662 =item lib/b test 19
5663
5664 =item Linux With Sfio Fails op/misc Test 48
5665
5666 =item sigaction test 13 in VMS
5667
5668 =item sprintf tests 129 and 130
5669
5670 =item  Failure of Thread tests
5671
5672 =item Localising a Tied Variable Leaks Memory
5673
5674 =item Self-tying of Arrays and Hashes Is Forbidden
5675
5676 =item Building Extensions Can Fail Because Of Largefiles
5677
5678 =item The Compiler Suite Is Still Experimental
5679
5680 =back
5681
5682 =item Reporting Bugs
5683
5684 =item SEE ALSO
5685
5686 =item HISTORY
5687
5688 =back
5689
5690 =head2 perl570delta - what's new for perl v5.7.0
5691
5692 =over 4
5693
5694 =item DESCRIPTION
5695
5696 =item Security Vulnerability Closed
5697
5698 =item Incompatible Changes
5699
5700 =item Core Enhancements
5701
5702 =item Modules and Pragmata
5703
5704 =over 4
5705
5706 =item New Modules
5707
5708 =item Updated And Improved Modules and Pragmata
5709
5710 =back
5711
5712 =item Utility Changes
5713
5714 =item New Documentation
5715
5716 =item Performance Enhancements
5717
5718 =item Installation and Configuration Improvements
5719
5720 =over 4
5721
5722 =item Generic Improvements
5723
5724 =back
5725
5726 =item Selected Bug Fixes
5727
5728 =over 4
5729
5730 =item Platform Specific Changes and Fixes
5731
5732 =back
5733
5734 =item New or Changed Diagnostics
5735
5736 =item Changed Internals
5737
5738 =item Known Problems
5739
5740 =over 4
5741
5742 =item Unicode Support Still Far From Perfect
5743
5744 =item EBCDIC Still A Lost Platform
5745
5746 =item Building Extensions Can Fail Because Of Largefiles
5747
5748 =item ftmp-security tests warn 'system possibly insecure'
5749
5750 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5751
5752 =item Long Doubles Still Don't Work In Solaris
5753
5754 =item Linux With Sfio Fails op/misc Test 48
5755
5756 =item Storable tests fail in some platforms
5757
5758 =item Threads Are Still Experimental
5759
5760 =item The Compiler Suite Is Still Experimental
5761
5762 =back
5763
5764 =item Reporting Bugs
5765
5766 =item SEE ALSO
5767
5768 =item HISTORY
5769
5770 =back
5771
5772 =head2 perl561delta - what's new for perl v5.6.x
5773
5774 =over 4
5775
5776 =item DESCRIPTION
5777
5778 =item Summary of changes between 5.6.0 and 5.6.1
5779
5780 =over 4
5781
5782 =item Security Issues
5783
5784 =item Core bug fixes
5785
5786 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5787 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5788 references to special variables, Lexical warnings, Spurious warnings and
5789 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5790 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5791 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5792 Module;>, Tests
5793
5794 =item Core features
5795
5796 =item Configuration issues
5797
5798 =item Documentation
5799
5800 =item Bundled modules
5801
5802 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5803 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5804 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5805 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5806
5807 =item Platform-specific improvements
5808
5809 NCR MP-RAS, NonStop-UX
5810
5811 =back
5812
5813 =item Core Enhancements
5814
5815 =over 4
5816
5817 =item Interpreter cloning, threads, and concurrency
5818
5819 =item Lexically scoped warning categories
5820
5821 =item Unicode and UTF-8 support
5822
5823 =item Support for interpolating named characters
5824
5825 =item "our" declarations
5826
5827 =item Support for strings represented as a vector of ordinals
5828
5829 =item Improved Perl version numbering system
5830
5831 =item New syntax for declaring subroutine attributes
5832
5833 =item File and directory handles can be autovivified
5834
5835 =item open() with more than two arguments
5836
5837 =item 64-bit support
5838
5839 =item Large file support
5840
5841 =item Long doubles
5842
5843 =item "more bits"
5844
5845 =item Enhanced support for sort() subroutines
5846
5847 =item C<sort $coderef @foo> allowed
5848
5849 =item File globbing implemented internally
5850
5851 =item Support for CHECK blocks
5852
5853 =item POSIX character class syntax [: :] supported
5854
5855 =item Better pseudo-random number generator
5856
5857 =item Improved C<qw//> operator
5858
5859 =item Better worst-case behavior of hashes
5860
5861 =item pack() format 'Z' supported
5862
5863 =item pack() format modifier '!' supported
5864
5865 =item pack() and unpack() support counted strings
5866
5867 =item Comments in pack() templates
5868
5869 =item Weak references
5870
5871 =item Binary numbers supported
5872
5873 =item Lvalue subroutines
5874
5875 =item Some arrows may be omitted in calls through references
5876
5877 =item Boolean assignment operators are legal lvalues
5878
5879 =item exists() is supported on subroutine names
5880
5881 =item exists() and delete() are supported on array elements
5882
5883 =item Pseudo-hashes work better
5884
5885 =item Automatic flushing of output buffers
5886
5887 =item Better diagnostics on meaningless filehandle operations
5888
5889 =item Where possible, buffered data discarded from duped input filehandle
5890
5891 =item eof() has the same old magic as <>
5892
5893 =item binmode() can be used to set :crlf and :raw modes
5894
5895 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5896
5897 =item system(), backticks and pipe open now reflect exec() failure
5898
5899 =item Improved diagnostics
5900
5901 =item Diagnostics follow STDERR
5902
5903 =item More consistent close-on-exec behavior
5904
5905 =item syswrite() ease-of-use
5906
5907 =item Better syntax checks on parenthesized unary operators
5908
5909 =item Bit operators support full native integer width
5910
5911 =item Improved security features
5912
5913 =item More functional bareword prototype (*)
5914
5915 =item C<require> and C<do> may be overridden
5916
5917 =item $^X variables may now have names longer than one character
5918
5919 =item New variable $^C reflects C<-c> switch
5920
5921 =item New variable $^V contains Perl version as a string
5922
5923 =item Optional Y2K warnings
5924
5925 =item Arrays now always interpolate into double-quoted strings
5926
5927 =back
5928
5929 =item Modules and Pragmata
5930
5931 =over 4
5932
5933 =item Modules
5934
5935 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5936 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5937 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5938 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5939 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5940 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5941 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5942 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5943
5944 =item Pragmata
5945
5946 =back
5947
5948 =item Utility Changes
5949
5950 =over 4
5951
5952 =item dprofpp
5953
5954 =item find2perl
5955
5956 =item h2xs
5957
5958 =item perlcc
5959
5960 =item perldoc
5961
5962 =item The Perl Debugger
5963
5964 =back
5965
5966 =item Improved Documentation
5967
5968 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5969 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5970 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5971 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5972
5973 =item Performance enhancements
5974
5975 =over 4
5976
5977 =item Simple sort() using { $a <=> $b } and the like are optimized
5978
5979 =item Optimized assignments to lexical variables
5980
5981 =item Faster subroutine calls
5982
5983 =item delete(), each(), values() and hash iteration are faster
5984
5985 =back
5986
5987 =item Installation and Configuration Improvements
5988
5989 =over 4
5990
5991 =item -Dusethreads means something different
5992
5993 =item New Configure flags
5994
5995 =item Threadedness and 64-bitness now more daring
5996
5997 =item Long Doubles
5998
5999 =item -Dusemorebits
6000
6001 =item -Duselargefiles
6002
6003 =item installusrbinperl
6004
6005 =item SOCKS support
6006
6007 =item C<-A> flag
6008
6009 =item Enhanced Installation Directories
6010
6011 =item gcc automatically tried if 'cc' does not seem to be working
6012
6013 =back
6014
6015 =item Platform specific changes
6016
6017 =over 4
6018
6019 =item Supported platforms
6020
6021 =item DOS
6022
6023 =item OS390 (OpenEdition MVS)
6024
6025 =item VMS
6026
6027 =item Win32
6028
6029 =back
6030
6031 =item Significant bug fixes
6032
6033 =over 4
6034
6035 =item <HANDLE> on empty files
6036
6037 =item C<eval '...'> improvements
6038
6039 =item All compilation errors are true errors
6040
6041 =item Implicitly closed filehandles are safer
6042
6043 =item Behavior of list slices is more consistent
6044
6045 =item C<(\$)> prototype and C<$foo{a}>
6046
6047 =item C<goto &sub> and AUTOLOAD
6048
6049 =item C<-bareword> allowed under C<use integer>
6050
6051 =item Failures in DESTROY()
6052
6053 =item Locale bugs fixed
6054
6055 =item Memory leaks
6056
6057 =item Spurious subroutine stubs after failed subroutine calls
6058
6059 =item Taint failures under C<-U>
6060
6061 =item END blocks and the C<-c> switch
6062
6063 =item Potential to leak DATA filehandles
6064
6065 =back
6066
6067 =item New or Changed Diagnostics
6068
6069 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6070 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6071 / cannot take a count, / must be followed by a, A or Z, / must be followed
6072 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6073 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6074 passed through, /%s/ should probably be written as "%s", %s() called too
6075 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6076 argument is not a HASH or ARRAY element or slice, %s argument is not a
6077 subroutine name, %s package attribute may clash with future reserved word:
6078 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6079 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6080 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6081 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6082 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6083 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6084 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6085 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6086 weaken a nonreference, Character class [:%s:] unknown, Character class
6087 syntax [%s] belongs inside character classes, Constant is not %s reference,
6088 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6089 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6090 "local" instead of "our"?), Document contains no data, entering effective
6091 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6092 output, flock() on closed filehandle %s, Global symbol "%s" requires
6093 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6094 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6095 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6096 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6097 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6098 separator character %s in attribute list, Invalid separator character %s in
6099 subroutine attribute list, leaving effective %s failed, Lvalue subs
6100 returning %s not implemented yet, Method %s not permitted, Missing
6101 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6102 No %s specified for -%c, No package name allowed for variable %s in "our",
6103 No space allowed after -%c, no UTC offset information; assuming local time
6104 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6105 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6106 around "%s" list, Possible unintended interpolation of %s in string,
6107 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6108 instead, Premature end of script headers, Repeat count in pack overflows,
6109 Repeat count in unpack overflows, realloc() of freed memory ignored,
6110 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6111 zero-length expression, switching effective %s is not implemented, This
6112 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6113 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6114 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6115 escape \\%c passed through, Unterminated attribute parameter in attribute
6116 list, Unterminated attribute list, Unterminated attribute parameter in
6117 subroutine attribute list, Unterminated subroutine attribute list, Value of
6118 CLI symbol "%s" too long, Version number must be a constant number
6119
6120 =item New tests
6121
6122 =item Incompatible Changes
6123
6124 =over 4
6125
6126 =item Perl Source Incompatibilities
6127
6128 CHECK is a new keyword, Treatment of list slices of undef has changed,
6129 Format of $English::PERL_VERSION is different, Literals of the form
6130 C<1.2.3> parse differently, Possibly changed pseudo-random number
6131 generator, Hashing function for hash keys has changed, C<undef> fails on
6132 read only values, Close-on-exec bit may be set on pipe and socket handles,
6133 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6134 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6135 Text of some diagnostic output has changed, C<%@> has been removed,
6136 Parenthesized not() behaves like a list operator, Semantics of bareword
6137 prototype C<(*)> have changed, Semantics of bit operators may have changed
6138 on 64-bit platforms, More builtins taint their results
6139
6140 =item C Source Incompatibilities
6141
6142 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6143
6144 =item Compatible C Source API Changes
6145
6146 C<PATCHLEVEL> is now C<PERL_VERSION>
6147
6148 =item Binary Incompatibilities
6149
6150 =back
6151
6152 =item Known Problems
6153
6154 =over 4
6155
6156 =item Localizing a tied hash element may leak memory
6157
6158 =item Known test failures
6159
6160 =item EBCDIC platforms not fully supported
6161
6162 =item UNICOS/mk CC failures during Configure run
6163
6164 =item Arrow operator and arrays
6165
6166 =item Experimental features
6167
6168 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6169 pseudo-hash data type, The Compiler suite, Internal implementation of file
6170 globbing, The DB module, The regular expression code constructs:
6171
6172 =back
6173
6174 =item Obsolete Diagnostics
6175
6176 Character class syntax [: :] is reserved for future extensions, Ill-formed
6177 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6178 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6179 to mean "${$}<digit>" is deprecated
6180
6181 =item Reporting Bugs
6182
6183 =item SEE ALSO
6184
6185 =item HISTORY
6186
6187 =back
6188
6189 =head2 perl56delta - what's new for perl v5.6.0
6190
6191 =over 4
6192
6193 =item DESCRIPTION
6194
6195 =item Core Enhancements
6196
6197 =over 4
6198
6199 =item Interpreter cloning, threads, and concurrency
6200
6201 =item Lexically scoped warning categories
6202
6203 =item Unicode and UTF-8 support
6204
6205 =item Support for interpolating named characters
6206
6207 =item "our" declarations
6208
6209 =item Support for strings represented as a vector of ordinals
6210
6211 =item Improved Perl version numbering system
6212
6213 =item New syntax for declaring subroutine attributes
6214
6215 =item File and directory handles can be autovivified
6216
6217 =item open() with more than two arguments
6218
6219 =item 64-bit support
6220
6221 =item Large file support
6222
6223 =item Long doubles
6224
6225 =item "more bits"
6226
6227 =item Enhanced support for sort() subroutines
6228
6229 =item C<sort $coderef @foo> allowed
6230
6231 =item File globbing implemented internally
6232
6233 =item Support for CHECK blocks
6234
6235 =item POSIX character class syntax [: :] supported
6236
6237 =item Better pseudo-random number generator
6238
6239 =item Improved C<qw//> operator
6240
6241 =item Better worst-case behavior of hashes
6242
6243 =item pack() format 'Z' supported
6244
6245 =item pack() format modifier '!' supported
6246
6247 =item pack() and unpack() support counted strings
6248
6249 =item Comments in pack() templates
6250
6251 =item Weak references
6252
6253 =item Binary numbers supported
6254
6255 =item Lvalue subroutines
6256
6257 =item Some arrows may be omitted in calls through references
6258
6259 =item Boolean assignment operators are legal lvalues
6260
6261 =item exists() is supported on subroutine names
6262
6263 =item exists() and delete() are supported on array elements
6264
6265 =item Pseudo-hashes work better
6266
6267 =item Automatic flushing of output buffers
6268
6269 =item Better diagnostics on meaningless filehandle operations
6270
6271 =item Where possible, buffered data discarded from duped input filehandle
6272
6273 =item eof() has the same old magic as <>
6274
6275 =item binmode() can be used to set :crlf and :raw modes
6276
6277 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6278
6279 =item system(), backticks and pipe open now reflect exec() failure
6280
6281 =item Improved diagnostics
6282
6283 =item Diagnostics follow STDERR
6284
6285 =item More consistent close-on-exec behavior
6286
6287 =item syswrite() ease-of-use
6288
6289 =item Better syntax checks on parenthesized unary operators
6290
6291 =item Bit operators support full native integer width
6292
6293 =item Improved security features
6294
6295 =item More functional bareword prototype (*)
6296
6297 =item C<require> and C<do> may be overridden
6298
6299 =item $^X variables may now have names longer than one character
6300
6301 =item New variable $^C reflects C<-c> switch
6302
6303 =item New variable $^V contains Perl version as a string
6304
6305 =item Optional Y2K warnings
6306
6307 =item Arrays now always interpolate into double-quoted strings
6308
6309 =back
6310
6311 =item Modules and Pragmata
6312
6313 =over 4
6314
6315 =item Modules
6316
6317 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6318 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6319 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6320 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6321 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6322 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6323 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6324 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6325
6326 =item Pragmata
6327
6328 =back
6329
6330 =item Utility Changes
6331
6332 =over 4
6333
6334 =item dprofpp
6335
6336 =item find2perl
6337
6338 =item h2xs
6339
6340 =item perlcc
6341
6342 =item perldoc
6343
6344 =item The Perl Debugger
6345
6346 =back
6347
6348 =item Improved Documentation
6349
6350 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6351 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6352 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6353 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6354
6355 =item Performance enhancements
6356
6357 =over 4
6358
6359 =item Simple sort() using { $a <=> $b } and the like are optimized
6360
6361 =item Optimized assignments to lexical variables
6362
6363 =item Faster subroutine calls
6364
6365 =item delete(), each(), values() and hash iteration are faster
6366
6367 =back
6368
6369 =item Installation and Configuration Improvements
6370
6371 =over 4
6372
6373 =item -Dusethreads means something different
6374
6375 =item New Configure flags
6376
6377 =item Threadedness and 64-bitness now more daring
6378
6379 =item Long Doubles
6380
6381 =item -Dusemorebits
6382
6383 =item -Duselargefiles
6384
6385 =item installusrbinperl
6386
6387 =item SOCKS support
6388
6389 =item C<-A> flag
6390
6391 =item Enhanced Installation Directories
6392
6393 =back
6394
6395 =item Platform specific changes
6396
6397 =over 4
6398
6399 =item Supported platforms
6400
6401 =item DOS
6402
6403 =item OS390 (OpenEdition MVS)
6404
6405 =item VMS
6406
6407 =item Win32
6408
6409 =back
6410
6411 =item Significant bug fixes
6412
6413 =over 4
6414
6415 =item <HANDLE> on empty files
6416
6417 =item C<eval '...'> improvements
6418
6419 =item All compilation errors are true errors
6420
6421 =item Implicitly closed filehandles are safer
6422
6423 =item Behavior of list slices is more consistent
6424
6425 =item C<(\$)> prototype and C<$foo{a}>
6426
6427 =item C<goto &sub> and AUTOLOAD
6428
6429 =item C<-bareword> allowed under C<use integer>
6430
6431 =item Failures in DESTROY()
6432
6433 =item Locale bugs fixed
6434
6435 =item Memory leaks
6436
6437 =item Spurious subroutine stubs after failed subroutine calls
6438
6439 =item Taint failures under C<-U>
6440
6441 =item END blocks and the C<-c> switch
6442
6443 =item Potential to leak DATA filehandles
6444
6445 =back
6446
6447 =item New or Changed Diagnostics
6448
6449 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6450 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6451 / cannot take a count, / must be followed by a, A or Z, / must be followed
6452 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6453 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6454 passed through, /%s/ should probably be written as "%s", %s() called too
6455 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6456 argument is not a HASH or ARRAY element or slice, %s argument is not a
6457 subroutine name, %s package attribute may clash with future reserved word:
6458 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6459 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6460 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6461 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6462 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6463 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6464 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6465 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6466 weaken a nonreference, Character class [:%s:] unknown, Character class
6467 syntax [%s] belongs inside character classes, Constant is not %s reference,
6468 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6469 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6470 "local" instead of "our"?), Document contains no data, entering effective
6471 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6472 output, flock() on closed filehandle %s, Global symbol "%s" requires
6473 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6474 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6475 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6476 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6477 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6478 separator character %s in attribute list, Invalid separator character %s in
6479 subroutine attribute list, leaving effective %s failed, Lvalue subs
6480 returning %s not implemented yet, Method %s not permitted, Missing
6481 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6482 No %s specified for -%c, No package name allowed for variable %s in "our",
6483 No space allowed after -%c, no UTC offset information; assuming local time
6484 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6485 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6486 around "%s" list, Possible unintended interpolation of %s in string,
6487 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6488 instead, Premature end of script headers, Repeat count in pack overflows,
6489 Repeat count in unpack overflows, realloc() of freed memory ignored,
6490 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6491 zero-length expression, switching effective %s is not implemented, This
6492 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6493 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6494 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6495 escape \\%c passed through, Unterminated attribute parameter in attribute
6496 list, Unterminated attribute list, Unterminated attribute parameter in
6497 subroutine attribute list, Unterminated subroutine attribute list, Value of
6498 CLI symbol "%s" too long, Version number must be a constant number
6499
6500 =item New tests
6501
6502 =item Incompatible Changes
6503
6504 =over 4
6505
6506 =item Perl Source Incompatibilities
6507
6508 CHECK is a new keyword, Treatment of list slices of undef has changed,
6509 Format of $English::PERL_VERSION is different, Literals of the form
6510 C<1.2.3> parse differently, Possibly changed pseudo-random number
6511 generator, Hashing function for hash keys has changed, C<undef> fails on
6512 read only values, Close-on-exec bit may be set on pipe and socket handles,
6513 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6514 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6515 Text of some diagnostic output has changed, C<%@> has been removed,
6516 Parenthesized not() behaves like a list operator, Semantics of bareword
6517 prototype C<(*)> have changed, Semantics of bit operators may have changed
6518 on 64-bit platforms, More builtins taint their results
6519
6520 =item C Source Incompatibilities
6521
6522 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6523
6524 =item Compatible C Source API Changes
6525
6526 C<PATCHLEVEL> is now C<PERL_VERSION>
6527
6528 =item Binary Incompatibilities
6529
6530 =back
6531
6532 =item Known Problems
6533
6534 =over 4
6535
6536 =item Thread test failures
6537
6538 =item EBCDIC platforms not supported
6539
6540 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6541
6542 =item NEXTSTEP 3.3 POSIX test failure
6543
6544 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6545 gcc
6546
6547 =item UNICOS/mk CC failures during Configure run
6548
6549 =item Arrow operator and arrays
6550
6551 =item Experimental features
6552
6553 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6554 pseudo-hash data type, The Compiler suite, Internal implementation of file
6555 globbing, The DB module, The regular expression code constructs:
6556
6557 =back
6558
6559 =item Obsolete Diagnostics
6560
6561 Character class syntax [: :] is reserved for future extensions, Ill-formed
6562 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6563 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6564 to mean "${$}<digit>" is deprecated
6565
6566 =item Reporting Bugs
6567
6568 =item SEE ALSO
6569
6570 =item HISTORY
6571
6572 =back
6573
6574 =head2 perl5005delta - what's new for perl5.005
6575
6576 =over 4
6577
6578 =item DESCRIPTION
6579
6580 =item About the new versioning system
6581
6582 =item Incompatible Changes
6583
6584 =over 4
6585
6586 =item WARNING:  This version is not binary compatible with Perl 5.004.
6587
6588 =item Default installation structure has changed
6589
6590 =item Perl Source Compatibility
6591
6592 =item C Source Compatibility
6593
6594 =item Binary Compatibility
6595
6596 =item Security fixes may affect compatibility
6597
6598 =item Relaxed new mandatory warnings introduced in 5.004
6599
6600 =item Licensing
6601
6602 =back
6603
6604 =item Core Changes
6605
6606 =over 4
6607
6608 =item Threads
6609
6610 =item Compiler
6611
6612 =item Regular Expressions
6613
6614 Many new and improved optimizations, Many bug fixes, New regular expression
6615 constructs, New operator for precompiled regular expressions, Other
6616 improvements, Incompatible changes
6617
6618 =item   Improved malloc()
6619
6620 =item Quicksort is internally implemented
6621
6622 =item Reliable signals
6623
6624 =item Reliable stack pointers
6625
6626 =item More generous treatment of carriage returns
6627
6628 =item Memory leaks
6629
6630 =item Better support for multiple interpreters
6631
6632 =item Behavior of local() on array and hash elements is now well-defined
6633
6634 =item C<%!> is transparently tied to the L<Errno> module
6635
6636 =item Pseudo-hashes are supported
6637
6638 =item C<EXPR foreach EXPR> is supported
6639
6640 =item Keywords can be globally overridden
6641
6642 =item C<$^E> is meaningful on Win32
6643
6644 =item C<foreach (1..1000000)> optimized
6645
6646 =item C<Foo::> can be used as implicitly quoted package name
6647
6648 =item C<exists $Foo::{Bar::}> tests existence of a package
6649
6650 =item Better locale support
6651
6652 =item Experimental support for 64-bit platforms
6653
6654 =item prototype() returns useful results on builtins
6655
6656 =item Extended support for exception handling
6657
6658 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6659
6660 =item All C<printf> format conversions are handled internally
6661
6662 =item New C<INIT> keyword
6663
6664 =item New C<lock> keyword
6665
6666 =item New C<qr//> operator
6667
6668 =item C<our> is now a reserved word
6669
6670 =item Tied arrays are now fully supported
6671
6672 =item Tied handles support is better
6673
6674 =item 4th argument to substr
6675
6676 =item Negative LENGTH argument to splice
6677
6678 =item Magic lvalues are now more magical
6679
6680 =item <> now reads in records
6681
6682 =back
6683
6684 =item Supported Platforms
6685
6686 =over 4
6687
6688 =item New Platforms
6689
6690 =item Changes in existing support
6691
6692 =back
6693
6694 =item Modules and Pragmata
6695
6696 =over 4
6697
6698 =item New Modules
6699
6700 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6701 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6702 Thread, attrs, fields, re
6703
6704 =item Changes in existing modules
6705
6706 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6707 MakeMaker, CPAN, Cwd
6708
6709 =back
6710
6711 =item Utility Changes
6712
6713 =item Documentation Changes
6714
6715 =item New Diagnostics
6716
6717 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6718 while coercing array into hash, Bareword "%s" refers to nonexistent
6719 package, Can't call method "%s" on an undefined value, Can't check
6720 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6721 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6722 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6723 for "%s", Character class syntax [. .] is reserved for future extensions,
6724 Character class syntax [: :] is reserved for future extensions, Character
6725 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6726 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6727 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6728 package main), Illegal hex digit ignored, No such array field, No such
6729 field "%s" in variable %s of type %s, Out of memory during ridiculously
6730 large request, Range iterator outside integer range, Recursive inheritance
6731 detected while looking for method '%s' %s, Reference found where even-sized
6732 list expected, Undefined value assigned to typeglob, Use of reserved word
6733 "%s" is deprecated, perl: warning: Setting locale failed
6734
6735 =item Obsolete Diagnostics
6736
6737 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6738 temporary file, regexp too big
6739
6740 =item Configuration Changes
6741
6742 =item BUGS
6743
6744 =item SEE ALSO
6745
6746 =item HISTORY
6747
6748 =back
6749
6750 =head2 perl5004delta - what's new for perl5.004
6751
6752 =over 4
6753
6754 =item DESCRIPTION
6755
6756 =item Supported Environments
6757
6758 =item Core Changes
6759
6760 =over 4
6761
6762 =item List assignment to %ENV works
6763
6764 =item Change to "Can't locate Foo.pm in @INC" error
6765
6766 =item Compilation option: Binary compatibility with 5.003
6767
6768 =item $PERL5OPT environment variable
6769
6770 =item Limitations on B<-M>, B<-m>, and B<-T> options
6771
6772 =item More precise warnings
6773
6774 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6775
6776 =item Previously deprecated %OVERLOAD is no longer usable
6777
6778 =item Subroutine arguments created only when they're modified
6779
6780 =item Group vector changeable with C<$)>
6781
6782 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6783
6784 =item Fixed localization of $<digit>, $&, etc.
6785
6786 =item No resetting of $. on implicit close
6787
6788 =item C<wantarray> may return undef
6789
6790 =item C<eval EXPR> determines value of EXPR in scalar context
6791
6792 =item Changes to tainting checks
6793
6794 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6795 spawning if tainted $TERM doesn't look like a terminal name
6796
6797 =item New Opcode module and revised Safe module
6798
6799 =item Embedding improvements
6800
6801 =item Internal change: FileHandle class based on IO::* classes
6802
6803 =item Internal change: PerlIO abstraction interface
6804
6805 =item New and changed syntax
6806
6807 $coderef->(PARAMS)
6808
6809 =item New and changed builtin constants
6810
6811 __PACKAGE__
6812
6813 =item New and changed builtin variables
6814
6815 $^E, $^H, $^M
6816
6817 =item New and changed builtin functions
6818
6819 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6820 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6821 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6822 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6823 nested C<sub{}> closures work now, formats work right on changing lexicals
6824
6825 =item New builtin methods
6826
6827 isa(CLASS), can(METHOD), VERSION( [NEED] )
6828
6829 =item TIEHANDLE now supported
6830
6831 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6832 LIST, READLINE this, GETC this, DESTROY this
6833
6834 =item Malloc enhancements
6835
6836 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6837
6838 =item Miscellaneous efficiency enhancements
6839
6840 =back
6841
6842 =item Support for More Operating Systems
6843
6844 =over 4
6845
6846 =item Win32
6847
6848 =item Plan 9
6849
6850 =item QNX
6851
6852 =item AmigaOS
6853
6854 =back
6855
6856 =item Pragmata
6857
6858 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6859 constant NAME => VALUE, use locale, use ops, use vmsish
6860
6861 =item Modules
6862
6863 =over 4
6864
6865 =item Required Updates
6866
6867 =item Installation directories
6868
6869 =item Module information summary
6870
6871 =item Fcntl
6872
6873 =item IO
6874
6875 =item Math::Complex
6876
6877 =item Math::Trig
6878
6879 =item DB_File
6880
6881 =item Net::Ping
6882
6883 =item Object-oriented overrides for builtin operators
6884
6885 =back
6886
6887 =item Utility Changes
6888
6889 =over 4
6890
6891 =item pod2html
6892
6893 Sends converted HTML to standard output
6894
6895 =item xsubpp
6896
6897 C<void> XSUBs now default to returning nothing
6898
6899 =back
6900
6901 =item C Language API Changes
6902
6903 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6904 manipulating hashes
6905
6906 =item Documentation Changes
6907
6908 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6909 L<perlmodlib>, L<perldebug>, L<perlsec>
6910
6911 =item New Diagnostics
6912
6913 "my" variable %s masks earlier declaration in same scope, %s argument is
6914 not a HASH element or slice, Allocation too large: %lx, Allocation too
6915 large, Applying %s to %s will act on scalar(%s), Attempt to free
6916 nonexistent shared string, Attempt to use reference as lvalue in substr,
6917 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6918 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6919 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6920 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6921 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6922 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6923 %s, Integer overflow in hex number, Integer overflow in octal number,
6924 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6925 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6926 possible typo, Null picture in formline, Offset outside string, Out of
6927 memory!, Out of memory during request for %s, panic: frexp, Possible
6928 attempt to put comments in qw() list, Possible attempt to separate words
6929 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6930 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6931 option, untie attempted while %d inner references still exist, Unrecognized
6932 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6933 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6934 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6935 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6936 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6937 long, Process terminated by SIG%s
6938
6939 =item BUGS
6940
6941 =item SEE ALSO
6942
6943 =item HISTORY
6944
6945 =back
6946
6947 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6948
6949 =over 4
6950
6951 =item DESCRIPTION
6952
6953 =over 4
6954
6955 =item Compiling Perl 5 on AIX
6956
6957 =item OS level
6958
6959 =item Building Dynamic Extensions on AIX
6960
6961 =item The IBM ANSI C Compiler
6962
6963 =item Using GNU's gcc for building perl
6964
6965 =item Using Large Files with Perl
6966
6967 =item Threaded Perl
6968
6969 =item 64-bit Perl
6970
6971 =item AIX 4.2 and extensions using C++ with statics
6972
6973 =back
6974
6975 =item AUTHOR
6976
6977 =item DATE
6978
6979 =back
6980
6981 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6982
6983 =over 4
6984
6985 =item DESCRIPTION
6986
6987 =item AUTHOR
6988
6989 =back
6990
6991 =head2 perlamiga - Perl under Amiga OS
6992
6993 =over 4
6994
6995 =item NOTE
6996
6997 =item SYNOPSIS
6998
6999 =back
7000
7001 =over 4
7002
7003 =item DESCRIPTION
7004
7005 =over 4
7006
7007 =item Prerequisites for Compiling Perl on AmigaOS
7008
7009 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7010
7011 =item Starting Perl programs under AmigaOS
7012
7013 =item Shortcomings of Perl under AmigaOS
7014
7015 =back
7016
7017 =item INSTALLATION
7018
7019 =item Accessing documentation
7020
7021 =over 4
7022
7023 =item Manpages for Perl on AmigaOS
7024
7025 =item Perl HTML Documentation on AmigaOS
7026
7027 =item Perl GNU Info Files on AmigaOS
7028
7029 =item Perl LaTeX Documentation on AmigaOS
7030
7031 =back
7032
7033 =item BUILDING PERL ON AMIGAOS
7034
7035 =over 4
7036
7037 =item Build Prerequisites for Perl on AmigaOS
7038
7039 =item Getting the Perl Source for AmigaOS
7040
7041 =item Making Perl on AmigaOS
7042
7043 =item Testing Perl on AmigaOS
7044
7045 =item Installing the built Perl on AmigaOS
7046
7047 =back
7048
7049 =item PERL 5.8.0 BROKEN IN AMIGAOS
7050
7051 =item AUTHORS
7052
7053 =item SEE ALSO
7054
7055 =back
7056
7057 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7058
7059 =over 4
7060
7061 =item DESCRIPTION
7062
7063 =over 4
7064
7065 =item General Issues with Perl on BeOS
7066
7067 =item BeOS Release-specific Notes
7068
7069 R4 x86, R4 PPC
7070
7071 =item Contact Information
7072
7073 =item Update 2002-05-30
7074
7075 =back
7076
7077 =back
7078
7079 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7080
7081 =over 4
7082
7083 =item SYNOPSIS
7084
7085 =item DESCRIPTION
7086
7087 =over 4
7088
7089 =item gzip on BS2000
7090
7091 =item bison on BS2000
7092
7093 =item Unpacking Perl Distribution on BS2000
7094
7095 =item Compiling Perl on BS2000
7096
7097 =item Testing Perl on BS2000
7098
7099 =item Installing Perl on BS2000
7100
7101 =item Using Perl in the Posix-Shell of BS2000
7102
7103 =item Using Perl in "native" BS2000
7104
7105 =item Floating point anomalies on BS2000
7106
7107 =back
7108
7109 =item AUTHORS
7110
7111 =item SEE ALSO
7112
7113 =over 4
7114
7115 =item Mailing list
7116
7117 =back
7118
7119 =item HISTORY
7120
7121 =back
7122
7123 =over 4
7124
7125 =item Name
7126
7127 =item Description
7128
7129 =item Build
7130
7131 =over 4
7132
7133 =item Tools & SDK
7134
7135 =item Make
7136
7137 =back
7138
7139 =item Acknowledgements
7140
7141 =item Author
7142
7143 =back
7144
7145 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7146
7147 =over 4
7148
7149 =item SYNOPSIS
7150
7151 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7152
7153 =over 4
7154
7155 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7156
7157 =item Cygwin Configuration
7158
7159 C<PATH>, I<nroff>, Permissions
7160
7161 =back
7162
7163 =item CONFIGURE PERL ON CYGWIN
7164
7165 =over 4
7166
7167 =item Stripping Perl Binaries on Cygwin
7168
7169 =item Optional Libraries for Perl on Cygwin
7170
7171 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7172 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7173
7174 =item Configure-time Options for Perl on Cygwin
7175
7176 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7177 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7178 C<-Dmksymlinks>
7179
7180 =item Suspicious Warnings on Cygwin
7181
7182 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7183
7184 =back
7185
7186 =item MAKE ON CYGWIN
7187
7188 =over 4
7189
7190 =item Warnings on Cygwin
7191
7192 =item ld2 on Cygwin
7193
7194 =back
7195
7196 =item TEST ON CYGWIN
7197
7198 =over 4
7199
7200 =item File Permissions on Cygwin
7201
7202 =item Script Portability on Cygwin
7203
7204 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7205
7206 =back
7207
7208 =item INSTALL PERL ON CYGWIN
7209
7210 =item MANIFEST ON CYGWIN
7211
7212 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7213 Source, Compiled Module Source, Perl Modules/Scripts
7214
7215 =item BUGS ON CYGWIN
7216
7217 =item AUTHORS
7218
7219 =item HISTORY
7220
7221 =back
7222
7223 =head2 perldgux - Perl under DG/UX.
7224
7225 =over 4
7226
7227 =item SYNOPSIS
7228
7229 =back
7230
7231 =over 4
7232
7233 =item DESCRIPTION
7234
7235 =item BUILDING PERL ON DG/UX
7236
7237 =over 4
7238
7239 =item Non-threaded Perl on DG/UX
7240
7241 =item Threaded Perl on DG/UX
7242
7243 =item Testing Perl on DG/UX
7244
7245 =item Installing the built perl on DG/UX
7246
7247 =back
7248
7249 =item AUTHOR
7250
7251 =item SEE ALSO
7252
7253 =back
7254
7255 =head2 perldos - Perl under DOS, W31, W95.
7256
7257 =over 4
7258
7259 =item SYNOPSIS
7260
7261 =item DESCRIPTION
7262
7263 =over 4
7264
7265 =item Prerequisites for Compiling Perl on DOS
7266
7267 DJGPP, Pthreads
7268
7269 =item Shortcomings of Perl under DOS
7270
7271 =item Building Perl on DOS
7272
7273 =item Testing Perl on DOS
7274
7275 =item Installation of Perl on DOS
7276
7277 =back
7278
7279 =item BUILDING AND INSTALLING MODULES ON DOS
7280
7281 =over 4
7282
7283 =item Building Prerequisites for Perl on DOS
7284
7285 =item Unpacking CPAN Modules on DOS
7286
7287 =item Building Non-XS Modules on DOS
7288
7289 =item Building XS Modules on DOS
7290
7291 =back
7292
7293 =item AUTHOR
7294
7295 =item SEE ALSO
7296
7297 =back
7298
7299 =head2 perlepoc, README.epoc - Perl for EPOC
7300
7301 =over 4
7302
7303 =item SYNOPSIS
7304
7305 =item INTRODUCTION
7306
7307 =item INSTALLING PERL ON EPOC
7308
7309 =item STARTING PERL ON EPOC
7310
7311 =over 4
7312
7313 =item Editors on Epoc
7314
7315 =item Features of Perl on Epoc
7316
7317 =item Restrictions of Perl on Epoc
7318
7319 =item Compiling Perl 5 on the EPOC cross compiling environment
7320
7321 =back
7322
7323 =item SUPPORT STATUS OF PERL ON EPOC
7324
7325 =item AUTHOR
7326
7327 =item LAST UPDATE
7328
7329 =back
7330
7331 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7332
7333 =over 4
7334
7335 =item DESCRIPTION
7336
7337 =over 4
7338
7339 =item FreeBSD core dumps from readdir_r with ithreads
7340
7341 =item $^X doesn't always contain a full path in FreeBSD
7342
7343 =item Perl will no more be part of "base FreeBSD"
7344
7345 =back
7346
7347 =item AUTHOR
7348
7349 =back
7350
7351 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7352 (HP-UX) systems
7353
7354 =over 4
7355
7356 =item DESCRIPTION
7357
7358 =over 4
7359
7360 =item Using perl as shipped with HP-UX
7361
7362 =item Compiling Perl 5 on HP-UX
7363
7364 =item PA-RISC
7365
7366 =item PA-RISC 1.0
7367
7368 =item PA-RISC 1.1
7369
7370 =item PA-RISC 2.0
7371
7372 =item Itanium
7373
7374 =item Portability Between PA-RISC Versions
7375
7376 =item Itanium Processor Family and HP-UX
7377
7378 =item Building Dynamic Extensions on HP-UX
7379
7380 =item The HP ANSI C Compiler
7381
7382 =item The GNU C Compiler
7383
7384 =item Using Large Files with Perl on HP-UX
7385
7386 =item Threaded Perl on HP-UX
7387
7388 =item 64-bit Perl on HP-UX
7389
7390 =item Oracle on HP-UX
7391
7392 =item GDBM and Threads on HP-UX
7393
7394 =item NFS filesystems and utime(2) on HP-UX
7395
7396 =item perl -P and // and HP-UX
7397
7398 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7399
7400 =back
7401
7402 =item nss_delete core dump from op/pwent or op/grent
7403
7404 =item AUTHOR
7405
7406 =item DATE
7407
7408 =back
7409
7410 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7411
7412 =over 4
7413
7414 =item DESCRIPTION
7415
7416 =over 4
7417
7418 =item Known Problems with Perl on Hurd 
7419
7420 =back
7421
7422 =item AUTHOR
7423
7424 =back
7425
7426 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7427
7428 =over 4
7429
7430 =item DESCRIPTION
7431
7432 =over 4
7433
7434 =item Building 32-bit Perl in Irix
7435
7436 =item Building 64-bit Perl in Irix
7437
7438 =item About Compiler Versions of Irix
7439
7440 =item Linker Problems in Irix
7441
7442 =item Malloc in Irix
7443
7444 =item Building with threads
7445
7446 =back
7447
7448 =item AUTHOR
7449
7450 =back
7451
7452 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7453 systems
7454
7455 =over 4
7456
7457 =item DESCRIPTION
7458
7459 =over 4
7460
7461 =item Compiling Perl 5 on MachTen
7462
7463 =item Failures during C<make test> on MachTen
7464
7465 op/lexassign.t, pragma/warnings.t
7466
7467 =item Building external modules on MachTen
7468
7469 =back
7470
7471 =item AUTHOR
7472
7473 =item DATE
7474
7475 =back
7476
7477 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7478
7479 =over 4
7480
7481 =item SYNOPSIS
7482
7483 =item DESCRIPTION
7484
7485 =item AUTHOR
7486
7487 =item DATE
7488
7489 =back
7490
7491 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7492
7493 =over 4
7494
7495 =item DESCRIPTION
7496
7497 =item Known problems with Perl on MiNT
7498
7499 =item AUTHOR
7500
7501 =back
7502
7503 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7504
7505 =over 4
7506
7507 =item SYNOPSIS
7508
7509 =item NOTE
7510
7511 =item Binary distribution from HP
7512
7513 =item What's New in Perl for MPE/iX
7514
7515 =item Welcome to Perl/iX
7516
7517 =item System Requirements for Perl/iX
7518
7519 =item How to Obtain Perl/iX
7520
7521 =item Perl/iX Distribution Contents Highlights
7522
7523 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7524 public_html/feedback.cgi, src/perl-5.6.0-mpe
7525
7526 =item How to Compile Perl/iX
7527
7528  4,  6
7529
7530 =item Getting Started with Perl/iX
7531
7532 =item MPE/iX Implementation Considerations
7533
7534 =item Known Perl/iX Bugs Under Investigation
7535
7536 =item Perl/iX To-Do List
7537
7538 =item Perl/iX Change History
7539
7540 =item AUTHOR
7541
7542 =item Name
7543
7544 =item Description
7545
7546 =item Build
7547
7548 =over 4
7549
7550 =item Tools & SDK
7551
7552 =item Setup
7553
7554 SetNWBld.bat, Buildtype.bat
7555
7556 =item Make
7557
7558 =item Interpreter
7559
7560 =item Extensions
7561
7562 =back
7563
7564 =item Install
7565
7566 =item Build new extensions
7567
7568 =item Acknowledgements
7569
7570 =item Authors
7571
7572 =item Date
7573
7574 =back
7575
7576 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7577
7578 =over 4
7579
7580 =item SYNOPSIS
7581
7582 =back
7583
7584 =over 4
7585
7586 =item DESCRIPTION
7587
7588 =over 4
7589
7590 =item Target
7591
7592 =item Other OSes
7593
7594 =item Prerequisites
7595
7596 EMX, RSX, HPFS, pdksh
7597
7598 =item Starting Perl programs under OS/2 (and DOS and...)
7599
7600 =item Starting OS/2 (and DOS) programs under Perl
7601
7602 =back
7603
7604 =item Frequently asked questions
7605
7606 =over 4
7607
7608 =item "It does not work"
7609
7610 =item I cannot run external programs
7611
7612 =item I cannot embed perl into my program, or use F<perl.dll> from my
7613 program. 
7614
7615 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7616 L<ExtUtils::Embed>?
7617
7618 =item C<``> and pipe-C<open> do not work under DOS.
7619
7620 =item Cannot start C<find.exe "pattern" file>
7621
7622 =back
7623
7624 =item INSTALLATION
7625
7626 =over 4
7627
7628 =item Automatic binary installation
7629
7630 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7631
7632 =item Manual binary installation
7633
7634 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7635 (statically linked), Executables for Perl utilities, Main Perl library,
7636 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7637 and utilities, Manpages for Perl modules, Source for Perl documentation,
7638 Perl manual in F<.INF> format, Pdksh
7639
7640 =item B<Warning>
7641
7642 =back
7643
7644 =item Accessing documentation
7645
7646 =over 4
7647
7648 =item OS/2 F<.INF> file
7649
7650 =item Plain text
7651
7652 =item Manpages
7653
7654 =item HTML
7655
7656 =item GNU C<info> files
7657
7658 =item F<PDF> files
7659
7660 =item C<LaTeX> docs
7661
7662 =back
7663
7664 =item BUILD
7665
7666 =over 4
7667
7668 =item The short story
7669
7670 =item Prerequisites
7671
7672 =item Getting perl source
7673
7674 =item Application of the patches
7675
7676 =item Hand-editing
7677
7678 =item Making
7679
7680 =item Testing
7681
7682 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7683 F<op/stat.t>
7684
7685 =item Installing the built perl
7686
7687 =item C<a.out>-style build
7688
7689 =back
7690
7691 =item Build FAQ
7692
7693 =over 4
7694
7695 =item Some C</> became C<\> in pdksh.
7696
7697 =item C<'errno'> - unresolved external
7698
7699 =item Problems with tr or sed
7700
7701 =item Some problem (forget which ;-)
7702
7703 =item Library ... not found
7704
7705 =item Segfault in make
7706
7707 =item op/sprintf test failure
7708
7709 =back
7710
7711 =item Specific (mis)features of OS/2 port
7712
7713 =over 4
7714
7715 =item C<setpriority>, C<getpriority>
7716
7717 =item C<system()>
7718
7719 =item C<extproc> on the first line
7720
7721 =item Additional modules:
7722
7723 =item Prebuilt methods:
7724
7725 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7726  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
7727 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
7728 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
7729 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
7730 C<Cwd::extLibpath_set( path [, type ] )>,
7731 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7732 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7733 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7734 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7735 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7736
7737 =item Prebuilt variables:
7738
7739 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7740
7741 =item Misfeatures
7742
7743 =item Modifications
7744
7745 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7746 C<flock>
7747
7748 =item Identifying DLLs
7749
7750 =item Centralized management of resources
7751
7752 C<HAB>, C<HMQ>
7753
7754 =back
7755
7756 =item Perl flavors
7757
7758 =over 4
7759
7760 =item F<perl.exe>
7761
7762 =item F<perl_.exe>
7763
7764 =item F<perl__.exe>
7765
7766 =item F<perl___.exe>
7767
7768 =item Why strange names?
7769
7770 =item Why dynamic linking?
7771
7772 =item Why chimera build?
7773
7774 =back
7775
7776 =item ENVIRONMENT
7777
7778 =over 4
7779
7780 =item C<PERLLIB_PREFIX>
7781
7782 =item C<PERL_BADLANG>
7783
7784 =item C<PERL_BADFREE>
7785
7786 =item C<PERL_SH_DIR>
7787
7788 =item C<USE_PERL_FLOCK>
7789
7790 =item C<TMP> or C<TEMP>
7791
7792 =back
7793
7794 =item Evolution
7795
7796 =over 4
7797
7798 =item Priorities
7799
7800 =item DLL name mangling: pre 5.6.2
7801
7802 =item DLL name mangling: 5.6.2 and beyond
7803
7804 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7805 C<LIBPATH>
7806
7807 =item DLL forwarder generation
7808
7809 =item Threading
7810
7811 =item Calls to external programs
7812
7813 =item Memory allocation
7814
7815 =item Threads
7816
7817 C<COND_WAIT>, F<os2.c>
7818
7819 =back
7820
7821 =item BUGS
7822
7823 =back
7824
7825 =over 4
7826
7827 =item AUTHOR
7828
7829 =item SEE ALSO
7830
7831 =back
7832
7833 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7834 and z/OS
7835
7836 =over 4
7837
7838 =item SYNOPSIS
7839
7840 =item DESCRIPTION
7841
7842 =over 4
7843
7844 =item Tools
7845
7846 =item Unpacking Perl distribution on OS/390
7847
7848 =item Setup and utilities for Perl on OS/390
7849
7850 =item Configure Perl on OS/390
7851
7852 =item Build, Test, Install Perl on OS/390
7853
7854 =item Build Anomalies with Perl on OS/390
7855
7856 =item Testing Anomalies with Perl on OS/390
7857
7858 =item Installation Anomalies with Perl on OS/390
7859
7860 =item Usage Hints for Perl on OS/390
7861
7862 =item Floating Point Anomalies with Perl on OS/390
7863
7864 =item Modules and Extensions for Perl on OS/390
7865
7866 =back
7867
7868 =item AUTHORS
7869
7870 =item SEE ALSO
7871
7872 =over 4
7873
7874 =item Mailing list for Perl on OS/390
7875
7876 =back
7877
7878 =item HISTORY
7879
7880 =back
7881
7882 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7883
7884 =over 4
7885
7886 =item DESCRIPTION
7887
7888 =over 4
7889
7890 =item Required Software for Compiling Perl on QNX4
7891
7892 /bin/sh, ar, nm, cpp, make
7893
7894 =item Outstanding Issues with Perl on QNX4
7895
7896 =item QNX auxiliary files
7897
7898 qnx/ar, qnx/cpp
7899
7900 =item Outstanding issues with perl under QNX6
7901
7902 =back
7903
7904 =item AUTHOR
7905
7906 =back
7907
7908 =head2 perlplan9 - Plan 9-specific documentation for Perl
7909
7910 =over 4
7911
7912 =item DESCRIPTION
7913
7914 =over 4
7915
7916 =item Invoking Perl
7917
7918 =item What's in Plan 9 Perl
7919
7920 =item What's not in Plan 9 Perl
7921
7922 =item Perl5 Functions not currently supported in Plan 9 Perl
7923
7924 =item Signals in Plan 9 Perl
7925
7926 =back
7927
7928 =item COMPILING AND INSTALLING PERL ON PLAN 9
7929
7930 =over 4
7931
7932 =item Installing Perl Documentation on Plan 9
7933
7934 =back
7935
7936 =item BUGS
7937
7938 =item Revision date
7939
7940 =item AUTHOR
7941
7942 =back
7943
7944 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7945
7946 =over 4
7947
7948 =item DESCRIPTION
7949
7950 =over 4
7951
7952 =item Solaris Version Numbers.
7953
7954 =back
7955
7956 =item RESOURCES
7957
7958 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7959
7960 =item SETTING UP
7961
7962 =over 4
7963
7964 =item File Extraction Problems on Solaris.
7965
7966 =item Compiler and Related Tools on Solaris.
7967
7968 =item Environment for Compiling Perl on Solaris
7969
7970 =back
7971
7972 =item RUN CONFIGURE.
7973
7974 =over 4
7975
7976 =item 64-bit Issues with Perl on Solaris.
7977
7978 =item Threads in Perl on Solaris.
7979
7980 =item Malloc Issues with Perl on Solaris.
7981
7982 =back
7983
7984 =item MAKE PROBLEMS.
7985
7986 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
7987 relocation error:, dlopen: stub interception failed, #error "No
7988 DATAMODEL_NATIVE specified", sh: ar: not found
7989
7990 =item MAKE TEST
7991
7992 =over 4
7993
7994 =item op/stat.t test 4 in Solaris
7995
7996 =item nss_delete core dump from op/pwent or op/grent
7997
7998 =back
7999
8000 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8001
8002 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8003
8004 =over 4
8005
8006 =item Limits on Numbers of Open Files on Solaris.
8007
8008 =back
8009
8010 =item SOLARIS-SPECIFIC MODULES.
8011
8012 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8013
8014 =over 4
8015
8016 =item Proc::ProcessTable on Solaris
8017
8018 =item BSD::Resource on Solaris
8019
8020 =item Net::SSLeay on Solaris
8021
8022 =back
8023
8024 =item AUTHOR
8025
8026 =item LAST MODIFIED
8027
8028 =back
8029
8030 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8031 Digital UNIX formerly known as DEC OSF/1) systems
8032
8033 =over 4
8034
8035 =item DESCRIPTION
8036
8037 =over 4
8038
8039 =item Compiling Perl 5 on Tru64
8040
8041 =item Using Large Files with Perl on Tru64
8042
8043 =item Threaded Perl on Tru64
8044
8045 =item Long Doubles on Tru64
8046
8047 =item 64-bit Perl on Tru64
8048
8049 =item Warnings about floating-point overflow when compiling Perl on Tru64
8050
8051 =back
8052
8053 =item Testing Perl on Tru64
8054
8055 =item ext/ODBM_File/odbm Test Failing With Static Builds
8056
8057 =item Perl Fails Because Of Unresolved Symbol sockatmark
8058
8059 =item AUTHOR
8060
8061 =back
8062
8063 =head2 perluts - Perl under UTS
8064
8065 =over 4
8066
8067 =item SYNOPSIS
8068
8069 =item DESCRIPTION
8070
8071 =item BUILDING PERL ON UTS
8072
8073 =item Installing the built perl on UTS
8074
8075 =item AUTHOR
8076
8077 =back
8078
8079 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8080
8081 =over 4
8082
8083 =item SYNOPSIS
8084
8085 =item DESCRIPTION
8086
8087 =over 4
8088
8089 =item Unpacking Perl Distribution on VM/ESA
8090
8091 =item Setup Perl and utilities on VM/ESA
8092
8093 =item Configure Perl on VM/ESA
8094
8095 =item Testing Anomalies of Perl on VM/ESA
8096
8097 =item Usage Hints for Perl on VM/ESA
8098
8099 =back
8100
8101 =item AUTHORS
8102
8103 =item SEE ALSO
8104
8105 =over 4
8106
8107 =item Mailing list for Perl on VM/ESA
8108
8109 =back
8110
8111 =back
8112
8113 =head2 perlvms - VMS-specific documentation for Perl
8114
8115 =over 4
8116
8117 =item DESCRIPTION
8118
8119 =item Installation
8120
8121 =item Organization of Perl Images
8122
8123 =over 4
8124
8125 =item Core Images
8126
8127 =item Perl Extensions
8128
8129 =item Installing static extensions
8130
8131 =item Installing dynamic extensions
8132
8133 =back
8134
8135 =item File specifications
8136
8137 =over 4
8138
8139 =item Syntax
8140
8141 =item Wildcard expansion
8142
8143 =item Pipes
8144
8145 =back
8146
8147 =item PERL5LIB and PERLLIB
8148
8149 =item Command line
8150
8151 =over 4
8152
8153 =item I/O redirection and backgrounding
8154
8155 =item Command line switches
8156
8157 -i, -S, -u
8158
8159 =back
8160
8161 =item Perl functions
8162
8163 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8164 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8165 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8166 LIST, waitpid PID,FLAGS
8167
8168 =item Perl variables
8169
8170 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8171
8172 =item Standard modules with VMS-specific differences
8173
8174 =over 4
8175
8176 =item SDBM_File
8177
8178 =back
8179
8180 =item Revision date
8181
8182 =item AUTHOR
8183
8184 =back
8185
8186 =head2 perlvos, README.vos - Perl for Stratus VOS
8187
8188 =over 4
8189
8190 =item SYNOPSIS
8191
8192 =over 4
8193
8194 =item Multiple methods to build perl for VOS
8195
8196 =item Stratus POSIX Support
8197
8198 =back
8199
8200 =item INSTALLING PERL IN VOS
8201
8202 =over 4
8203
8204 =item Compiling Perl 5 on VOS
8205
8206 =item Installing Perl 5 on VOS
8207
8208 =back
8209
8210 =item USING PERL IN VOS
8211
8212 =over 4
8213
8214 =item Unimplemented Features of Perl on VOS
8215
8216 =item Restrictions of Perl on VOS
8217
8218 =item Handling of underflow and overflow
8219
8220 =back
8221
8222 =item TEST STATUS
8223
8224 =item SUPPORT STATUS
8225
8226 =item AUTHOR
8227
8228 =item LAST UPDATE
8229
8230 =back
8231
8232 =head2 perlwin32 - Perl under Windows
8233
8234 =over 4
8235
8236 =item SYNOPSIS
8237
8238 =item DESCRIPTION
8239
8240 =over 4
8241
8242 =item Setting Up Perl on Win32
8243
8244 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8245 SDK 64-bit Compiler, Mingw32 with GCC
8246
8247 =item Building
8248
8249 =item Testing Perl on Win32
8250
8251 =item Installation of Perl on Win32
8252
8253 =item Usage Hints for Perl on Win32
8254
8255 Environment Variables, File Globbing, Using perl from the command line,
8256 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8257 Extensions, Notes on 64-bit Windows
8258
8259 =item Running Perl Scripts
8260
8261 Miscellaneous Things
8262
8263 =back
8264
8265 =item BUGS AND CAVEATS
8266
8267 =item AUTHORS
8268
8269 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8270 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8271 E<lt>nick@ing-simmons.netE<gt>
8272
8273 =item SEE ALSO
8274
8275 =item HISTORY
8276
8277 =back
8278
8279 =head1 PRAGMA DOCUMENTATION
8280
8281 =head2 attrs - set/get attributes of a subroutine (deprecated)
8282
8283 =over 4
8284
8285 =item SYNOPSIS
8286
8287 =item DESCRIPTION
8288
8289 method, locked
8290
8291 =back
8292
8293 =head2 re - Perl pragma to alter regular expression behaviour
8294
8295 =over 4
8296
8297 =item SYNOPSIS
8298
8299 =item DESCRIPTION
8300
8301 =back
8302
8303 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8304
8305 =over 4
8306
8307 =item SYNOPSIS
8308
8309 =item DESCRIPTION
8310
8311 =item FUNCTIONS AND METHODS
8312
8313 new, enqueue LIST, dequeue, dequeue_nb, pending
8314
8315 =item SEE ALSO
8316
8317 =back
8318
8319 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8320 semaphores
8321
8322 =over 4
8323
8324 =item SYNOPSIS
8325
8326 =item DESCRIPTION
8327
8328 =item FUNCTIONS AND METHODS
8329
8330 new, new NUMBER, down, down NUMBER, up, up NUMBER
8331
8332 =back
8333
8334 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8335 data structures between threads
8336
8337 =over 4
8338
8339 =item SYNOPSIS
8340
8341 =item DESCRIPTION
8342
8343 =item EXPORT
8344
8345 =item FUNCTIONS
8346
8347 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8348 cond_broadcast VARIABLE
8349
8350 =item NOTES
8351
8352 =item BUGS
8353
8354 =item AUTHOR
8355
8356 =item SEE ALSO
8357
8358 =back
8359
8360 =head2 threads - Perl extension allowing use of interpreter based threads
8361 from perl
8362
8363 =over 4
8364
8365 =item SYNOPSIS
8366
8367 =item DESCRIPTION
8368
8369 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8370 threads->self, $thread->tid, threads->yield();, threads->list();, async
8371 BLOCK;
8372
8373 =item WARNINGS
8374
8375 A thread exited while %d other threads were still running
8376
8377 =item BUGS / TODO
8378
8379 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8380 not threadsafe, will not be
8381
8382 =item AUTHOR and COPYRIGHT
8383
8384 =item SEE ALSO
8385
8386 =back
8387
8388 =head2 attributes - get/set subroutine or variable attributes
8389
8390 =over 4
8391
8392 =item SYNOPSIS
8393
8394 =item DESCRIPTION
8395
8396 =over 4
8397
8398 =item Built-in Attributes
8399
8400 locked, method, lvalue
8401
8402 =item Available Subroutines
8403
8404 get, reftype
8405
8406 =item Package-specific Attribute Handling
8407
8408 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8409
8410 =item Syntax of Attribute Lists
8411
8412 =back
8413
8414 =item EXPORTS
8415
8416 =over 4
8417
8418 =item Default exports
8419
8420 =item Available exports
8421
8422 =item Export tags defined
8423
8424 =back
8425
8426 =item EXAMPLES
8427
8428 =item SEE ALSO
8429
8430 =back
8431
8432 =head2 attrs - set/get attributes of a subroutine (deprecated)
8433
8434 =over 4
8435
8436 =item SYNOPSIS
8437
8438 =item DESCRIPTION
8439
8440 method, locked
8441
8442 =back
8443
8444 =head2 autouse - postpone load of modules until a function is used
8445
8446 =over 4
8447
8448 =item SYNOPSIS
8449
8450 =item DESCRIPTION
8451
8452 =item WARNING
8453
8454 =item AUTHOR
8455
8456 =item SEE ALSO
8457
8458 =back
8459
8460 =head2 base - Establish IS-A relationship with base class at compile time
8461
8462 =over 4
8463
8464 =item SYNOPSIS
8465
8466 =item DESCRIPTION
8467
8468 =item HISTORY
8469
8470 =item SEE ALSO
8471
8472 =back
8473
8474 =head2 bigint - Transparent big integer support for Perl
8475
8476 =over 4
8477
8478 =item SYNOPSIS
8479
8480 =item DESCRIPTION
8481
8482 =over 4
8483
8484 =item OPTIONS
8485
8486 a or accuracy, p or precision, t or trace, l or lib, v or version
8487
8488 =item MATH LIBRARY
8489
8490 =item INTERNAL FORMAT
8491
8492 =item SIGN
8493
8494 =item METHODS
8495
8496 =back
8497
8498 =item MODULES USED
8499
8500 =item EXAMPLES
8501
8502 =item LICENSE
8503
8504 =item SEE ALSO
8505
8506 =item AUTHORS
8507
8508 =back
8509
8510 =head2 bignum - Transparent BigNumber support for Perl
8511
8512 =over 4
8513
8514 =item SYNOPSIS
8515
8516 =item DESCRIPTION
8517
8518 =over 4
8519
8520 =item OPTIONS
8521
8522 a or accuracy, p or precision, t or trace, l or lib, v or version
8523
8524 =item MATH LIBRARY
8525
8526 =item INTERNAL FORMAT
8527
8528 =item SIGN
8529
8530 =item METHODS
8531
8532 =back
8533
8534 =item MODULES USED
8535
8536 =item EXAMPLES
8537
8538 =item LICENSE
8539
8540 =item SEE ALSO
8541
8542 =item AUTHORS
8543
8544 =back
8545
8546 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8547
8548 =over 4
8549
8550 =item SYNOPSIS
8551
8552 =item DESCRIPTION
8553
8554 =over 4
8555
8556 =item MODULES USED
8557
8558 =item MATH LIBRARY
8559
8560 =item SIGN
8561
8562 =item METHODS
8563
8564 =back
8565
8566 =item EXAMPLES
8567
8568         perl -Mbigrat -le 'print sqrt(33)'
8569         perl -Mbigrat -le 'print 2*255'
8570         perl -Mbigrat -le 'print 4.5+2*255'
8571         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
8572         perl -Mbigrat -le 'print 12->is_odd()';
8573
8574 =item LICENSE
8575
8576 =item SEE ALSO
8577
8578 =item AUTHORS
8579
8580 =back
8581
8582 =head2 blib - Use MakeMaker's uninstalled version of a package
8583
8584 =over 4
8585
8586 =item SYNOPSIS
8587
8588 =item DESCRIPTION
8589
8590 =item BUGS
8591
8592 =item AUTHOR
8593
8594 =back
8595
8596 =head2 bytes - Perl pragma to force byte semantics rather than character
8597 semantics
8598
8599 =over 4
8600
8601 =item SYNOPSIS
8602
8603 =item DESCRIPTION
8604
8605 =item SEE ALSO
8606
8607 =back
8608
8609 =head2 charnames - define character names for C<\N{named}> string literal
8610 escapes
8611
8612 =over 4
8613
8614 =item SYNOPSIS
8615
8616 =item DESCRIPTION
8617
8618 =item CUSTOM TRANSLATORS
8619
8620 =item charnames::viacode(code)
8621
8622 =item charnames::vianame(name)
8623
8624 =item ALIASES
8625
8626 =item ILLEGAL CHARACTERS
8627
8628 =item BUGS
8629
8630 =back
8631
8632 =head2 constant - Perl pragma to declare constants
8633
8634 =over 4
8635
8636 =item SYNOPSIS
8637
8638 =item DESCRIPTION
8639
8640 =item NOTES
8641
8642 =over 4
8643
8644 =item List constants
8645
8646 =item Defining multiple constants at once
8647
8648 =item Magic constants
8649
8650 =back
8651
8652 =item TECHNICAL NOTES
8653
8654 =item BUGS
8655
8656 =item AUTHOR
8657
8658 =item COPYRIGHT
8659
8660 =back
8661
8662 =head2 diagnostics - Perl compiler pragma to force verbose warning
8663 diagnostics
8664
8665 =over 4
8666
8667 =item SYNOPSIS
8668
8669 =item DESCRIPTION
8670
8671 =over 4
8672
8673 =item The C<diagnostics> Pragma
8674
8675 =item The I<splain> Program
8676
8677 =back
8678
8679 =item EXAMPLES
8680
8681 =item INTERNALS
8682
8683 =item BUGS
8684
8685 =item AUTHOR
8686
8687 =back
8688
8689 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8690
8691 =over 4
8692
8693 =item SYNOPSIS
8694
8695 =item ABSTRACT
8696
8697 =item USAGE
8698
8699 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8700 I<ENCNAME_IN> ...] ;, no encoding;
8701
8702 =item CAVEATS
8703
8704 =over 4
8705
8706 =item NOT SCOPED
8707
8708 =item DO NOT MIX MULTIPLE ENCODINGS
8709
8710 =back
8711
8712 =item Non-ASCII Identifiers and Filter option
8713
8714 use encoding I<ENCNAME> Filter=E<gt>1;
8715
8716 =item EXAMPLE - Greekperl
8717
8718 =item KNOWN PROBLEMS
8719
8720 =item SEE ALSO
8721
8722 =back
8723
8724 =head2 fields - compile-time class fields
8725
8726 =over 4
8727
8728 =item SYNOPSIS
8729
8730 =item DESCRIPTION
8731
8732 new, phash
8733
8734 =item SEE ALSO
8735
8736 =back
8737
8738 =head2 filetest - Perl pragma to control the filetest permission operators
8739
8740 =over 4
8741
8742 =item SYNOPSIS
8743
8744 =item DESCRIPTION
8745
8746 =over 4
8747
8748 =item subpragma access
8749
8750 =back
8751
8752 =back
8753
8754 =head2 if - C<use> a Perl module if a condition holds
8755
8756 =over 4
8757
8758 =item SYNOPSIS
8759
8760 =item DESCRIPTION
8761
8762 =item BUGS
8763
8764 =item AUTHOR
8765
8766 =back
8767
8768 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8769 point
8770
8771 =over 4
8772
8773 =item SYNOPSIS
8774
8775 =item DESCRIPTION
8776
8777 =back
8778
8779 =head2 less - perl pragma to request less of something from the compiler
8780
8781 =over 4
8782
8783 =item SYNOPSIS
8784
8785 =item DESCRIPTION
8786
8787 =back
8788
8789 =head2 lib - manipulate @INC at compile time
8790
8791 =over 4
8792
8793 =item SYNOPSIS
8794
8795 =item DESCRIPTION
8796
8797 =over 4
8798
8799 =item Adding directories to @INC
8800
8801 =item Deleting directories from @INC
8802
8803 =item Restoring original @INC
8804
8805 =back
8806
8807 =item CAVEATS
8808
8809 =item NOTES
8810
8811 =item SEE ALSO
8812
8813 =item AUTHOR
8814
8815 =back
8816
8817 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8818 operations
8819
8820 =over 4
8821
8822 =item SYNOPSIS
8823
8824 =item DESCRIPTION
8825
8826 =back
8827
8828 =head2 open - perl pragma to set default disciplines for input and output
8829
8830 =over 4
8831
8832 =item SYNOPSIS
8833
8834 =item DESCRIPTION
8835
8836 =item NONPERLIO FUNCTIONALITY
8837
8838 =item IMPLEMENTATION DETAILS
8839
8840 =item SEE ALSO
8841
8842 =back
8843
8844 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8845
8846 =over 4
8847
8848 =item SYNOPSIS  
8849
8850 =item DESCRIPTION
8851
8852 =item SEE ALSO
8853
8854 =back
8855
8856 =head2 overload - Package for overloading perl operations
8857
8858 =over 4
8859
8860 =item SYNOPSIS
8861
8862 =item DESCRIPTION
8863
8864 =over 4
8865
8866 =item Declaration of overloaded functions
8867
8868 =item Calling Conventions for Binary Operations
8869
8870 FALSE, TRUE, C<undef>
8871
8872 =item Calling Conventions for Unary Operations
8873
8874 =item Calling Conventions for Mutators
8875
8876 C<++> and C<-->, C<x=> and other assignment versions
8877
8878 =item Overloadable Operations
8879
8880 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8881 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8882 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8883
8884 =item Inheritance and overloading
8885
8886 Strings as values of C<use overload> directive, Overloading of an operation
8887 is inherited by derived classes
8888
8889 =back
8890
8891 =item SPECIAL SYMBOLS FOR C<use overload>
8892
8893 =over 4
8894
8895 =item Last Resort
8896
8897 =item Fallback
8898
8899 C<undef>, TRUE, defined, but FALSE
8900
8901 =item Copy Constructor
8902
8903 B<Example>
8904
8905 =back
8906
8907 =item MAGIC AUTOGENERATION
8908
8909 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8910 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8911 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8912 I<Copy operator>
8913
8914 =item Losing overloading
8915
8916 =item Run-time Overloading
8917
8918 =item Public functions
8919
8920 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8921
8922 =item Overloading constants
8923
8924 integer, float, binary, q, qr
8925
8926 =item IMPLEMENTATION
8927
8928 =item Metaphor clash
8929
8930 =item Cookbook
8931
8932 =over 4
8933
8934 =item Two-face scalars
8935
8936 =item Two-face references
8937
8938 =item Symbolic calculator
8939
8940 =item I<Really> symbolic calculator
8941
8942 =back
8943
8944 =item AUTHOR
8945
8946 =item DIAGNOSTICS
8947
8948 Odd number of arguments for overload::constant, `%s' is not an overloadable
8949 type, `%s' is not a code reference
8950
8951 =item BUGS
8952
8953 =back
8954
8955 =head2 re - Perl pragma to alter regular expression behaviour
8956
8957 =over 4
8958
8959 =item SYNOPSIS
8960
8961 =item DESCRIPTION
8962
8963 =back
8964
8965 =head2 sigtrap - Perl pragma to enable simple signal handling
8966
8967 =over 4
8968
8969 =item SYNOPSIS
8970
8971 =item DESCRIPTION
8972
8973 =item OPTIONS
8974
8975 =over 4
8976
8977 =item SIGNAL HANDLERS
8978
8979 B<stack-trace>, B<die>, B<handler> I<your-handler>
8980
8981 =item SIGNAL LISTS
8982
8983 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8984
8985 =item OTHER
8986
8987 B<untrapped>, B<any>, I<signal>, I<number>
8988
8989 =back
8990
8991 =item EXAMPLES
8992
8993 =back
8994
8995 =head2 sort - perl pragma to control sort() behaviour
8996
8997 =over 4
8998
8999 =item SYNOPSIS
9000
9001 =item DESCRIPTION
9002
9003 =item CAVEATS
9004
9005 =back
9006
9007 =head2 strict - Perl pragma to restrict unsafe constructs
9008
9009 =over 4
9010
9011 =item SYNOPSIS
9012
9013 =item DESCRIPTION
9014
9015 C<strict refs>, C<strict vars>, C<strict subs>
9016
9017 =back
9018
9019 =head2 subs - Perl pragma to predeclare sub names
9020
9021 =over 4
9022
9023 =item SYNOPSIS
9024
9025 =item DESCRIPTION
9026
9027 =back
9028
9029 =head2 threads - Perl extension allowing use of interpreter based threads
9030 from perl
9031
9032 =over 4
9033
9034 =item SYNOPSIS
9035
9036 =item DESCRIPTION
9037
9038 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9039 threads->self, $thread->tid, threads->yield();, threads->list();, async
9040 BLOCK;
9041
9042 =item WARNINGS
9043
9044 A thread exited while %d other threads were still running
9045
9046 =item BUGS / TODO
9047
9048 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
9049 not threadsafe, will not be
9050
9051 =item AUTHOR and COPYRIGHT
9052
9053 =item SEE ALSO
9054
9055 =back
9056
9057 =head2 threadshared, threads::shared - Perl extension for sharing data
9058 structures between threads
9059
9060 =over 4
9061
9062 =item SYNOPSIS
9063
9064 =item DESCRIPTION
9065
9066 =item EXPORT
9067
9068 =item FUNCTIONS
9069
9070 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9071 cond_broadcast VARIABLE
9072
9073 =item NOTES
9074
9075 =item BUGS
9076
9077 =item AUTHOR
9078
9079 =item SEE ALSO
9080
9081 =back
9082
9083 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
9084
9085 =over 4
9086
9087 =item SYNOPSIS
9088
9089 =item DESCRIPTION
9090
9091 =item FUNCTIONS AND METHODS
9092
9093 new, enqueue LIST, dequeue, dequeue_nb, pending
9094
9095 =item SEE ALSO
9096
9097 =back
9098
9099 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
9100 semaphores
9101
9102 =over 4
9103
9104 =item SYNOPSIS
9105
9106 =item DESCRIPTION
9107
9108 =item FUNCTIONS AND METHODS
9109
9110 new, new NUMBER, down, down NUMBER, up, up NUMBER
9111
9112 =back
9113
9114 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9115 code
9116
9117 =over 4
9118
9119 =item SYNOPSIS
9120
9121 =item DESCRIPTION
9122
9123 =over 4
9124
9125 =item Utility functions
9126
9127 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9128 utf8::encode($string), $flag = utf8::decode($string), $flag =
9129 utf8::valid(STRING)
9130
9131 =back
9132
9133 =item SEE ALSO
9134
9135 =back
9136
9137 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9138
9139 =over 4
9140
9141 =item SYNOPSIS
9142
9143 =item DESCRIPTION
9144
9145 =back
9146
9147 =head2 vmsish - Perl pragma to control VMS-specific language features
9148
9149 =over 4
9150
9151 =item SYNOPSIS
9152
9153 =item DESCRIPTION
9154
9155 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9156
9157 =back
9158
9159 =head2 warnings - Perl pragma to control optional warnings
9160
9161 =over 4
9162
9163 =item SYNOPSIS
9164
9165 =item DESCRIPTION
9166
9167 use warnings::register, warnings::enabled(), warnings::enabled($category),
9168 warnings::enabled($object), warnings::warn($message),
9169 warnings::warn($category, $message), warnings::warn($object, $message),
9170 warnings::warnif($message), warnings::warnif($category, $message),
9171 warnings::warnif($object, $message)
9172
9173 =back
9174
9175 =head2 warnings::register - warnings import function
9176
9177 =over 4
9178
9179 =item SYNOPSIS
9180
9181 =item DESCRIPTION
9182
9183 =back
9184
9185 =head1 MODULE DOCUMENTATION
9186
9187 =head2 AnyDBM_File - provide framework for multiple DBMs
9188
9189 =over 4
9190
9191 =item SYNOPSIS
9192
9193 =item DESCRIPTION
9194
9195 =over 4
9196
9197 =item DBM Comparisons
9198
9199 [0], [1], [2], [3]
9200
9201 =back
9202
9203 =item SEE ALSO
9204
9205 =back
9206
9207 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9208
9209 =over 4
9210
9211 =item VERSION
9212
9213 =item SYNOPSIS
9214
9215 =item DESCRIPTION
9216
9217 [0], [1], [2], [3], [4], [5]
9218
9219 =over 4
9220
9221 =item Typed lexicals
9222
9223 =item Type-specific attribute handlers
9224
9225 =item Non-interpretive attribute handlers
9226
9227 =item Phase-specific attribute handlers
9228
9229 =item Attributes as C<tie> interfaces
9230
9231 =back
9232
9233 =item EXAMPLES
9234
9235 =item DIAGNOSTICS
9236
9237 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9238 attributes>, C<Declaration of %s attribute in package %s may clash with
9239 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9240 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9241 be able to apply END handler>
9242
9243 =item AUTHOR
9244
9245 =item BUGS
9246
9247 =item COPYRIGHT
9248
9249 =back
9250
9251 =head2 AutoLoader - load subroutines only on demand
9252
9253 =over 4
9254
9255 =item SYNOPSIS
9256
9257 =item DESCRIPTION
9258
9259 =over 4
9260
9261 =item Subroutine Stubs
9262
9263 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9264
9265 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9266
9267 =item Package Lexicals
9268
9269 =item Not Using AutoLoader
9270
9271 =item B<AutoLoader> vs. B<SelfLoader>
9272
9273 =back
9274
9275 =item CAVEATS
9276
9277 =item SEE ALSO
9278
9279 =back
9280
9281 =head2 AutoSplit - split a package for autoloading
9282
9283 =over 4
9284
9285 =item SYNOPSIS
9286
9287 =item DESCRIPTION
9288
9289 $keep, $check, $modtime
9290
9291 =over 4
9292
9293 =item Multiple packages
9294
9295 =back
9296
9297 =item DIAGNOSTICS
9298
9299 =back
9300
9301 =head2 B - The Perl Compiler
9302
9303 =over 4
9304
9305 =item SYNOPSIS
9306
9307 =item DESCRIPTION
9308
9309 =item OVERVIEW OF CLASSES
9310
9311 =over 4
9312
9313 =item SV-RELATED CLASSES
9314
9315 =item B::SV METHODS
9316
9317 REFCNT, FLAGS
9318
9319 =item B::IV METHODS
9320
9321 IV, IVX, UVX, int_value, needs64bits, packiv
9322
9323 =item B::NV METHODS
9324
9325 NV, NVX
9326
9327 =item B::RV METHODS
9328
9329 RV
9330
9331 =item B::PV METHODS
9332
9333 PV, RV, PVX
9334
9335 =item B::PVMG METHODS
9336
9337 MAGIC, SvSTASH
9338
9339 =item B::MAGIC METHODS
9340
9341 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9342
9343 =item B::PVLV METHODS
9344
9345 TARGOFF, TARGLEN, TYPE, TARG
9346
9347 =item B::BM METHODS
9348
9349 USEFUL, PREVIOUS, RARE, TABLE
9350
9351 =item B::GV METHODS
9352
9353 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9354 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9355
9356 =item B::IO METHODS
9357
9358 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9359 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9360
9361 =item B::AV METHODS
9362
9363 FILL, MAX, OFF, ARRAY, AvFLAGS
9364
9365 =item B::CV METHODS
9366
9367 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9368 CvFLAGS, const_sv
9369
9370 =item B::HV METHODS
9371
9372 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9373
9374 =item OP-RELATED CLASSES
9375
9376 =item B::OP METHODS
9377
9378 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9379
9380 =item B::UNOP METHOD
9381
9382 first
9383
9384 =item B::BINOP METHOD
9385
9386 last
9387
9388 =item B::LOGOP METHOD
9389
9390 other
9391
9392 =item B::LISTOP METHOD
9393
9394 children
9395
9396 =item B::PMOP METHODS
9397
9398 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9399 pmpermflags, precomp, pmoffet
9400
9401 =item B::SVOP METHOD
9402
9403 sv, gv
9404
9405 =item B::PADOP METHOD
9406
9407 padix
9408
9409 =item B::PVOP METHOD
9410
9411 pv
9412
9413 =item B::LOOP METHODS
9414
9415 redoop, nextop, lastop
9416
9417 =item B::COP METHODS
9418
9419 label, stash, file, cop_seq, arybase, line
9420
9421 =back
9422
9423 =item FUNCTIONS EXPORTED BY C<B>
9424
9425 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9426 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9427 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9428 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9429 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9430
9431 =item AUTHOR
9432
9433 =back
9434
9435 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9436 bytecode
9437
9438 =over 4
9439
9440 =item SYNOPSIS
9441
9442 =item DESCRIPTION
9443
9444 %insn_data, @insn_name, @optype, @specialsv_name
9445
9446 =item AUTHOR
9447
9448 =back
9449
9450 =head2 B::Assembler - Assemble Perl bytecode
9451
9452 =over 4
9453
9454 =item SYNOPSIS
9455
9456 =item DESCRIPTION
9457
9458 =item AUTHORS
9459
9460 =back
9461
9462 =head2 B::Bblock - Walk basic blocks
9463
9464 =over 4
9465
9466 =item SYNOPSIS
9467
9468 =item DESCRIPTION
9469
9470 =over 4
9471
9472 =item Functions
9473
9474 B<find_leaders>
9475
9476 =back
9477
9478 =item AUTHOR
9479
9480 =back
9481
9482 =head2 B::Bytecode - Perl compiler's bytecode backend
9483
9484 =over 4
9485
9486 =item SYNOPSIS
9487
9488 =item DESCRIPTION
9489
9490 =item OPTIONS
9491
9492 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9493 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9494 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9495
9496 =item EXAMPLES
9497
9498 =item BUGS
9499
9500 =item AUTHORS
9501
9502 =back
9503
9504 =head2 B::C - Perl compiler's C backend
9505
9506 =over 4
9507
9508 =item SYNOPSIS
9509
9510 =item DESCRIPTION
9511
9512 =item OPTIONS
9513
9514 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9515 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9516 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9517 B<-llimit>
9518
9519 =item EXAMPLES
9520
9521 =item BUGS
9522
9523 =item AUTHOR
9524
9525 =back
9526
9527 =head2 B::CC - Perl compiler's optimized C translation backend
9528
9529 =over 4
9530
9531 =item SYNOPSIS
9532
9533 =item DESCRIPTION
9534
9535 =item OPTIONS
9536
9537 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9538 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9539 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9540
9541 =item EXAMPLES
9542
9543 =item BUGS
9544
9545 =item DIFFERENCES
9546
9547 =over 4
9548
9549 =item Loops
9550
9551 =item Context of ".."
9552
9553 =item Arithmetic
9554
9555 =item Deprecated features
9556
9557 =back
9558
9559 =item AUTHOR
9560
9561 =back
9562
9563 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9564
9565 =over 4
9566
9567 =item SYNOPSIS
9568
9569 =item DESCRIPTION
9570
9571 =item EXAMPLE
9572
9573 =item OPTIONS
9574
9575 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9576 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9577 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9578
9579 =item FORMATTING SPECIFICATIONS
9580
9581 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9582 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9583 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9584 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9585 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9586 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9587 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9588 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9589
9590 =item ABBREVIATIONS
9591
9592 =over 4
9593
9594 =item OP flags abbreviations
9595
9596 =item OP class abbreviations
9597
9598 =back
9599
9600 =item Using B::Concise outside of the O framework
9601
9602 =item AUTHOR
9603
9604 =back
9605
9606 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9607
9608 =over 4
9609
9610 =item SYNOPSIS
9611
9612 =item DESCRIPTION
9613
9614 =item AUTHOR
9615
9616 =back
9617
9618 =head2 B::Deparse - Perl compiler backend to produce perl code
9619
9620 =over 4
9621
9622 =item SYNOPSIS
9623
9624 =item DESCRIPTION
9625
9626 =item OPTIONS
9627
9628 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9629 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9630
9631 =item USING B::Deparse AS A MODULE
9632
9633 =over 4
9634
9635 =item Synopsis
9636
9637 =item Description
9638
9639 =item new
9640
9641 =item ambient_pragmas
9642
9643 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9644
9645 =item coderef2text
9646
9647 =back
9648
9649 =item BUGS
9650
9651 =item AUTHOR
9652
9653 =back
9654
9655 =head2 B::Disassembler - Disassemble Perl bytecode
9656
9657 =over 4
9658
9659 =item SYNOPSIS
9660
9661 =item DESCRIPTION
9662
9663 =item AUTHOR
9664
9665 =back
9666
9667 =head2 B::Lint - Perl lint
9668
9669 =over 4
9670
9671 =item SYNOPSIS
9672
9673 =item DESCRIPTION
9674
9675 =item OPTIONS AND LINT CHECKS
9676
9677 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9678 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9679
9680 =item NON LINT-CHECK OPTIONS
9681
9682 B<-u Package>
9683
9684 =item BUGS
9685
9686 =item AUTHOR
9687
9688 =back
9689
9690 =head2 B::O, O - Generic interface to Perl Compiler backends
9691
9692 =over 4
9693
9694 =item SYNOPSIS
9695
9696 =item DESCRIPTION
9697
9698 =item CONVENTIONS
9699
9700 =item IMPLEMENTATION
9701
9702 =item BUGS
9703
9704 =item AUTHOR
9705
9706 =back
9707
9708 =head2 B::Showlex - Show lexical variables used in functions or files
9709
9710 =over 4
9711
9712 =item SYNOPSIS
9713
9714 =item DESCRIPTION
9715
9716 =item AUTHOR
9717
9718 =back
9719
9720 =head2 B::Stackobj - Helper module for CC backend
9721
9722 =over 4
9723
9724 =item SYNOPSIS
9725
9726 =item DESCRIPTION
9727
9728 =item AUTHOR
9729
9730 =back
9731
9732 =head2 B::Stash - show what stashes are loaded
9733
9734 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9735
9736 =over 4
9737
9738 =item SYNOPSIS
9739
9740 =item DESCRIPTION
9741
9742 =item AUTHOR
9743
9744 =back
9745
9746 =head2 B::Xref - Generates cross reference reports for Perl programs
9747
9748 =over 4
9749
9750 =item SYNOPSIS
9751
9752 =item DESCRIPTION
9753
9754 =item OPTIONS
9755
9756 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9757
9758 =item BUGS
9759
9760 =item AUTHOR
9761
9762 =back
9763
9764 =head2 Bblock, B::Bblock - Walk basic blocks
9765
9766 =over 4
9767
9768 =item SYNOPSIS
9769
9770 =item DESCRIPTION
9771
9772 =over 4
9773
9774 =item Functions
9775
9776 B<find_leaders>
9777
9778 =back
9779
9780 =item AUTHOR
9781
9782 =back
9783
9784 =head2 Benchmark - benchmark running times of Perl code
9785
9786 =over 4
9787
9788 =item SYNOPSIS
9789
9790 =item DESCRIPTION
9791
9792 =over 4
9793
9794 =item Methods
9795
9796 new, debug, iters
9797
9798 =item Standard Exports
9799
9800 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9801 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9802 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9803
9804 =item Optional Exports
9805
9806 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9807 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9808 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9809
9810 =back
9811
9812 =item NOTES
9813
9814 =item EXAMPLES
9815
9816 =item INHERITANCE
9817
9818 =item CAVEATS
9819
9820 =item SEE ALSO
9821
9822 =item AUTHORS
9823
9824 =item MODIFICATION HISTORY
9825
9826 =back
9827
9828 =head2 ByteLoader - load byte compiled perl code
9829
9830 =over 4
9831
9832 =item SYNOPSIS
9833
9834 =item DESCRIPTION
9835
9836 =item AUTHOR
9837
9838 =item SEE ALSO
9839
9840 =back
9841
9842 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9843
9844 =over 4
9845
9846 =item SYNOPSIS
9847
9848 =item DESCRIPTION
9849
9850 =item OPTIONS
9851
9852 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9853 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9854 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9855
9856 =item EXAMPLES
9857
9858 =item BUGS
9859
9860 =item AUTHORS
9861
9862 =back
9863
9864 =head2 CGI - Simple Common Gateway Interface Class
9865
9866 =over 4
9867
9868 =item SYNOPSIS
9869
9870 =item ABSTRACT
9871
9872 =item DESCRIPTION
9873
9874 =over 4
9875
9876 =item PROGRAMMING STYLE
9877
9878 =item CALLING CGI.PM ROUTINES
9879
9880 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9881
9882 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9883
9884 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9885
9886 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9887
9888 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9889
9890 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9891
9892 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9893
9894 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9895
9896 =item DELETING A PARAMETER COMPLETELY:
9897
9898 =item DELETING ALL PARAMETERS:
9899
9900 =item DIRECT ACCESS TO THE PARAMETER LIST:
9901
9902 =item FETCHING THE PARAMETER LIST AS A HASH:
9903
9904 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9905
9906 =item RETRIEVING CGI ERRORS
9907
9908 =item USING THE FUNCTION-ORIENTED INTERFACE
9909
9910 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9911 B<:standard>, B<:all>
9912
9913 =item PRAGMAS
9914
9915 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9916 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9917 -private_tempfiles
9918
9919 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9920
9921 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9922 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9923 a </ul> tag)
9924
9925 =back
9926
9927 =item GENERATING DYNAMIC DOCUMENTS
9928
9929 =over 4
9930
9931 =item CREATING A STANDARD HTTP HEADER:
9932
9933 =item GENERATING A REDIRECTION HEADER
9934
9935 =item CREATING THE HTML DOCUMENT HEADER
9936
9937 B<Parameters:>, 4, 5, 6..
9938
9939 =item ENDING THE HTML DOCUMENT:
9940
9941 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9942
9943 =item OBTAINING THE SCRIPT'S URL
9944
9945 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9946 (B<-query_string>), B<-base>
9947
9948 =item MIXING POST AND URL PARAMETERS
9949
9950 =back
9951
9952 =item CREATING STANDARD HTML ELEMENTS:
9953
9954 =over 4
9955
9956 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9957
9958 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9959
9960 =item HTML SHORTCUTS AND LIST INTERPOLATION
9961
9962 =item NON-STANDARD HTML SHORTCUTS
9963
9964 =item AUTOESCAPING HTML
9965
9966 $escaped_string = escapeHTML("unescaped string");, $charset =
9967 charset([$charset]);, $flag = autoEscape([$flag]);
9968
9969 =item PRETTY-PRINTING HTML
9970
9971 =back
9972
9973 =item CREATING FILL-OUT FORMS:
9974
9975 =over 4
9976
9977 =item CREATING AN ISINDEX TAG
9978
9979 =item STARTING AND ENDING A FORM
9980
9981 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9982
9983 =item CREATING A TEXT FIELD
9984
9985 B<Parameters>
9986
9987 =item CREATING A BIG TEXT FIELD
9988
9989 =item CREATING A PASSWORD FIELD
9990
9991 =item CREATING A FILE UPLOAD FIELD
9992
9993 B<Parameters>
9994
9995 =item CREATING A POPUP MENU
9996
9997 =item CREATING A SCROLLING LIST
9998
9999 B<Parameters:>
10000
10001 =item CREATING A GROUP OF RELATED CHECKBOXES
10002
10003 B<Parameters:>
10004
10005 =item CREATING A STANDALONE CHECKBOX
10006
10007 B<Parameters:>
10008
10009 =item CREATING A RADIO BUTTON GROUP
10010
10011 B<Parameters:>
10012
10013 =item CREATING A SUBMIT BUTTON 
10014
10015 B<Parameters:>
10016
10017 =item CREATING A RESET BUTTON
10018
10019 =item CREATING A DEFAULT BUTTON
10020
10021 =item CREATING A HIDDEN FIELD
10022
10023 B<Parameters:>
10024
10025 =item CREATING A CLICKABLE IMAGE BUTTON
10026
10027 B<Parameters:>
10028
10029 =item CREATING A JAVASCRIPT ACTION BUTTON
10030
10031 =back
10032
10033 =item HTTP COOKIES
10034
10035 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10036 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10037
10038 =item WORKING WITH FRAMES
10039
10040 1. Create a <Frameset> document, 2. Specify the destination for the
10041 document in the HTTP header, 3. Specify the destination for the document in
10042 the <form> tag
10043
10044 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10045
10046 =item DEBUGGING
10047
10048 =over 4
10049
10050 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10051
10052 =back
10053
10054 =item FETCHING ENVIRONMENT VARIABLES
10055
10056 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10057 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10058 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10059 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10060 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10061
10062 =item USING NPH SCRIPTS
10063
10064 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10065 parameters
10066
10067 =item Server Push
10068
10069 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10070
10071 =item Avoiding Denial of Service Attacks
10072
10073 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10074 basis>, B<2. Globally for all scripts>
10075
10076 =item COMPATIBILITY WITH CGI-LIB.PL
10077
10078 =item AUTHOR INFORMATION
10079
10080 =item CREDITS
10081
10082 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10083 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10084 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10085 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10086 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10087 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10088 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10089 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10090 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10091 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10092 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10093 ...and many many more..
10094
10095 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10096
10097 =item BUGS
10098
10099 =item SEE ALSO
10100
10101 =back
10102
10103 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10104
10105 =over 4
10106
10107 =item SYNOPSIS
10108
10109 =item ABSTRACT
10110
10111 =item DESCRIPTION
10112
10113 =item AUTHOR INFORMATION
10114
10115 =item BUGS
10116
10117 =item SEE ALSO
10118
10119 =back
10120
10121 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10122 other) error log
10123
10124 =over 4
10125
10126 =item SYNOPSIS
10127
10128 =item DESCRIPTION
10129
10130 =item REDIRECTING ERROR MESSAGES
10131
10132 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10133
10134 =over 4
10135
10136 =item Changing the default message
10137
10138 =back
10139
10140 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10141
10142 =item CHANGE LOG
10143
10144 =item AUTHORS
10145
10146 =item SEE ALSO
10147
10148 =back
10149
10150 =head2 CGI::Cookie - Interface to Netscape Cookies
10151
10152 =over 4
10153
10154 =item SYNOPSIS
10155
10156 =item DESCRIPTION
10157
10158 =item USING CGI::Cookie
10159
10160 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10161
10162 =over 4
10163
10164 =item Creating New Cookies
10165
10166 =item Sending the Cookie to the Browser
10167
10168 =item Recovering Previous Cookies
10169
10170 =item Manipulating Cookies
10171
10172 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10173
10174 =back
10175
10176 =item AUTHOR INFORMATION
10177
10178 =item BUGS
10179
10180 =item SEE ALSO
10181
10182 =back
10183
10184 =head2 CGI::Fast - CGI Interface for Fast CGI
10185
10186 =over 4
10187
10188 =item SYNOPSIS
10189
10190 =item DESCRIPTION
10191
10192 =item OTHER PIECES OF THE PUZZLE
10193
10194 =item WRITING FASTCGI PERL SCRIPTS
10195
10196 =item INSTALLING FASTCGI SCRIPTS
10197
10198 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10199
10200 =item EXTERNAL FASTCGI SERVER INVOCATION
10201
10202 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10203
10204 =item CAVEATS
10205
10206 =item AUTHOR INFORMATION
10207
10208 =item BUGS
10209
10210 =item SEE ALSO
10211
10212 =back
10213
10214 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10215
10216 =over 4
10217
10218 =item SYNOPSIS
10219
10220 =item DESCRIPTION
10221
10222 =over 4
10223
10224 =item Tags that won't be formatted
10225
10226 =item Customizing the Indenting
10227
10228 =back
10229
10230 =item BUGS
10231
10232 =item AUTHOR
10233
10234 =item SEE ALSO
10235
10236 =back
10237
10238 =head2 CGI::Push - Simple Interface to Server Push
10239
10240 =over 4
10241
10242 =item SYNOPSIS
10243
10244 =item DESCRIPTION
10245
10246 =item USING CGI::Push
10247
10248 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10249
10250 =over 4
10251
10252 =item Heterogeneous Pages
10253
10254 =item Changing the Page Delay on the Fly
10255
10256 =back
10257
10258 =item INSTALLING CGI::Push SCRIPTS
10259
10260 =item AUTHOR INFORMATION
10261
10262 =item BUGS
10263
10264 =item SEE ALSO
10265
10266 =back
10267
10268 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10269
10270 =over 4
10271
10272 =item SYNOPSIS
10273
10274 =item ABSTRACT
10275
10276 =item DESCRIPTION
10277
10278 =item AUTHOR INFORMATION
10279
10280 =item BUGS
10281
10282 =item SEE ALSO
10283
10284 =back
10285
10286 =head2 CGI::Util - Internal utilities used by CGI module
10287
10288 =over 4
10289
10290 =item SYNOPSIS
10291
10292 =item DESCRIPTION
10293
10294 =item AUTHOR INFORMATION
10295
10296 =item SEE ALSO
10297
10298 =back
10299
10300 =head2 CPAN - query, download and build perl modules from CPAN sites
10301
10302 =over 4
10303
10304 =item SYNOPSIS
10305
10306 =item DESCRIPTION
10307
10308 =over 4
10309
10310 =item Interactive Mode
10311
10312 Searching for authors, bundles, distribution files and modules, make, test,
10313 install, clean  modules or distributions, get, readme, look module or
10314 distribution, ls author, Signals
10315
10316 =item CPAN::Shell
10317
10318 =item autobundle
10319
10320 =item recompile
10321
10322 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10323
10324 =item Programmer's interface
10325
10326 expand($type,@things), expandany(@things), Programming Examples
10327
10328 =item Methods in the other Classes
10329
10330 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10331 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10332 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10333 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10334 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10335 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10336 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10337 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10338 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10339 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10340 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10341 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10342 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10343 CPAN::Distribution::look(), CPAN::Distribution::make(),
10344 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10345 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10346 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10347 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10348 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10349 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10350 CPAN::Module::description(), CPAN::Module::force($method,@args),
10351 CPAN::Module::get(), CPAN::Module::inst_file(),
10352 CPAN::Module::inst_version(), CPAN::Module::install(),
10353 CPAN::Module::look(), CPAN::Module::make(),
10354 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10355 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10356
10357 =item Cache Manager
10358
10359 =item Bundles
10360
10361 =item Prerequisites
10362
10363 =item Finding packages and VERSION
10364
10365 =item Debugging
10366
10367 =item Floppy, Zip, Offline Mode
10368
10369 =back
10370
10371 =item CONFIGURATION
10372
10373 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10374 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10375 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10376 [unshift|push|splice] E<lt>listE<gt>>
10377
10378 =over 4
10379
10380 =item Note on urllist parameter's format
10381
10382 =item urllist parameter has CD-ROM support
10383
10384 =back
10385
10386 =item SECURITY
10387
10388 =item EXPORT
10389
10390 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10391
10392 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10393
10394 =over 4
10395
10396 =item Three basic types of firewalls
10397
10398 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10399
10400 =item Configuring lynx or ncftp for going through a firewall
10401
10402 =back
10403
10404 =item FAQ
10405
10406 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10407
10408 =item BUGS
10409
10410 =item AUTHOR
10411
10412 =item TRANSLATIONS
10413
10414 =item SEE ALSO
10415
10416 =back
10417
10418 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10419
10420 =over 4
10421
10422 =item SYNOPSIS
10423
10424 =item DESCRIPTION
10425
10426 =back
10427
10428 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10429 module
10430
10431 =over 4
10432
10433 =item SYNOPSIS
10434
10435 =item DESCRIPTION
10436
10437 =item  SEE ALSO
10438
10439 =back
10440
10441 =head2 Carp, carp    - warn of errors (from perspective of caller)
10442
10443 =over 4
10444
10445 =item SYNOPSIS
10446
10447 =item DESCRIPTION
10448
10449 =over 4
10450
10451 =item Forcing a Stack Trace
10452
10453 =back
10454
10455 =item BUGS
10456
10457 =back
10458
10459 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10460
10461 =head2 Class::ISA -- report the search path for a class's ISA tree
10462
10463 =over 4
10464
10465 =item SYNOPSIS
10466
10467 =item DESCRIPTION
10468
10469 =item FUNCTIONS
10470
10471 the function Class::ISA::super_path($CLASS), the function
10472 Class::ISA::self_and_super_path($CLASS), the function
10473 Class::ISA::self_and_super_versions($CLASS)
10474
10475 =item CAUTIONARY NOTES
10476
10477 =item COPYRIGHT
10478
10479 =item AUTHOR
10480
10481 =back
10482
10483 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10484
10485 =over 4
10486
10487 =item SYNOPSIS
10488
10489 =item DESCRIPTION
10490
10491 =over 4
10492
10493 =item The C<struct()> function
10494
10495 =item Class Creation at Compile Time
10496
10497 =item Element Types and Accessor Methods
10498
10499 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10500 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10501
10502 =item Initializing with C<new>
10503
10504 =back
10505
10506 =item EXAMPLES
10507
10508 Example 1, Example 2, Example 3
10509
10510 =item Author and Modification History
10511
10512 =back
10513
10514 =head2 Config - access Perl configuration information
10515
10516 =over 4
10517
10518 =item SYNOPSIS
10519
10520 =item DESCRIPTION
10521
10522 myconfig(), config_sh(), config_vars(@names)
10523
10524 =item EXAMPLE
10525
10526 =item WARNING
10527
10528 =item GLOSSARY
10529
10530 =over 4
10531
10532 =item _
10533
10534 C<_a>, C<_exe>, C<_o>
10535
10536 =item a
10537
10538 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10539 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10540 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10541 C<asctime_r_proto>, C<awk>
10542
10543 =item b
10544
10545 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10546
10547 =item c
10548
10549 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10550 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10551 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10552 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10553 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10554 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10555 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10556
10557 =item d
10558
10559 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10560 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10561 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10562 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10563 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10564 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10565 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10566 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10567 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10568 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10569 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10570 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10571 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10572 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10573 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10574 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10575 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10576 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10577 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10578 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10579 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10580 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10581 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10582 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10583 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10584 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10585 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10586 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10587 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10588 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10589 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10590 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10591 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10592 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10593 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10594 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10595 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10596 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10597 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10598 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10599 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10600 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10601 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10602 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10603 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10604 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10605 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10606 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10607 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10608 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10609 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10610 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10611 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10612 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10613 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10614 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10615 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10616 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10617 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10618 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10619 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10620 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10621 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10622 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10623 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10624 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10625 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10626 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10627 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10628 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10629 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10630 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10631 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10632 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10633 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10634 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10635 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10636 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10637 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10638 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10639 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10640 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10641 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10642 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10643 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10644 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10645 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10646 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10647 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10648 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10649
10650 =item e
10651
10652 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10653 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10654 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10655 C<expr>, C<extensions>, C<extras>
10656
10657 =item f
10658
10659 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10660 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10661 C<full_sed>
10662
10663 =item g
10664
10665 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10666 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10667 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10668 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10669 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10670 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10671 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10672 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10673 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10674 C<gzip>
10675
10676 =item h
10677
10678 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10679
10680 =item i
10681
10682 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10683 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10684 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10685 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10686 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10687 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10688 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10689 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10690 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10691 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10692 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10693 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10694 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10695 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10696 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10697 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10698 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10699 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10700 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10701 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10702 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10703 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10704 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10705 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10706
10707 =item k
10708
10709 C<known_extensions>, C<ksh>
10710
10711 =item l
10712
10713 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10714 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10715 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10716 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10717 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10718 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10719 C<lseektype>
10720
10721 =item m
10722
10723 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10724 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10725 C<man3direxp>, C<man3ext>
10726
10727 =item M
10728
10729 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10730 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10731
10732 =item n
10733
10734 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10735 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10736 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10737 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10738 C<nvsize>, C<nvtype>
10739
10740 =item o
10741
10742 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10743 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10744
10745 =item p
10746
10747 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10748 C<perl>, C<perl_patchlevel>
10749
10750 =item P
10751
10752 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10753 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10754 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10755 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10756
10757 =item q
10758
10759 C<quadkind>, C<quadtype>
10760
10761 =item r
10762
10763 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10764 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10765 C<rmail>, C<run>, C<runnm>
10766
10767 =item s
10768
10769 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10770 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10771 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10772 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10773 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10774 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10775 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10776 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10777 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10778 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10779 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10780 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10781 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10782 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10783 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10784 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10785 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10786
10787 =item t
10788
10789 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10790 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10791 C<ttyname_r_proto>
10792
10793 =item u
10794
10795 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10796 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10797 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10798 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10799 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10800 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10801 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10802 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10803 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10804
10805 =item v
10806
10807 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10808 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10809 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10810 C<versiononly>, C<vi>, C<voidflags>
10811
10812 =item x
10813
10814 C<xlibpth>, C<xs_apiversion>
10815
10816 =item y
10817
10818 C<yacc>, C<yaccflags>
10819
10820 =item z
10821
10822 C<zcat>, C<zip>
10823
10824 =back
10825
10826 =item NOTE
10827
10828 =back
10829
10830 =head2 Cwd - get pathname of current working directory
10831
10832 =over 4
10833
10834 =item SYNOPSIS
10835
10836 =item DESCRIPTION
10837
10838 =over 4
10839
10840 =item getcwd and friends
10841
10842 getcwd, cwd, fastcwd, fastgetcwd
10843
10844 =item abs_path and friends
10845
10846 abs_path, realpath, fast_abs_path
10847
10848 =item $ENV{PWD}
10849
10850 =back
10851
10852 =item NOTES
10853
10854 =item SEE ALSO
10855
10856 =back
10857
10858 =head2 DB - programmatic interface to the Perl debugging API (draft,
10859 subject to
10860 change)
10861
10862 =over 4
10863
10864 =item SYNOPSIS
10865
10866 =item DESCRIPTION
10867
10868 =over 4
10869
10870 =item Global Variables
10871
10872  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
10873 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
10874 $DB::lineno
10875
10876 =item API Methods
10877
10878 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10879 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10880
10881 =item Client Callback Methods
10882
10883 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10884 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10885 CLIENT->output(LIST)
10886
10887 =back
10888
10889 =item BUGS
10890
10891 =item AUTHOR
10892
10893 =back
10894
10895 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10896
10897 =over 4
10898
10899 =item SYNOPSIS
10900
10901 =item DESCRIPTION
10902
10903 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10904
10905 =over 4
10906
10907 =item Using DB_File with Berkeley DB version 2 or greater
10908
10909 =item Interface to Berkeley DB
10910
10911 =item Opening a Berkeley DB Database File
10912
10913 =item Default Parameters
10914
10915 =item In Memory Databases
10916
10917 =back
10918
10919 =item DB_HASH
10920
10921 =over 4
10922
10923 =item A Simple Example
10924
10925 =back
10926
10927 =item DB_BTREE
10928
10929 =over 4
10930
10931 =item Changing the BTREE sort order
10932
10933 =item Handling Duplicate Keys 
10934
10935 =item The get_dup() Method
10936
10937 =item The find_dup() Method
10938
10939 =item The del_dup() Method
10940
10941 =item Matching Partial Keys 
10942
10943 =back
10944
10945 =item DB_RECNO
10946
10947 =over 4
10948
10949 =item The 'bval' Option
10950
10951 =item A Simple Example
10952
10953 =item Extra RECNO Methods
10954
10955 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10956 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10957 length, elements);>
10958
10959 =item Another Example
10960
10961 =back
10962
10963 =item THE API INTERFACE
10964
10965 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10966 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10967 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10968 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10969
10970 =item DBM FILTERS
10971
10972 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10973 B<filter_fetch_value>
10974
10975 =over 4
10976
10977 =item The Filter
10978
10979 =item An Example -- the NULL termination problem.
10980
10981 =item Another Example -- Key is a C int.
10982
10983 =back
10984
10985 =item HINTS AND TIPS 
10986
10987 =over 4
10988
10989 =item Locking: The Trouble with fd
10990
10991 =item Safe ways to lock a database
10992
10993 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10994
10995 =item Sharing Databases With C Applications
10996
10997 =item The untie() Gotcha
10998
10999 =back
11000
11001 =item COMMON QUESTIONS
11002
11003 =over 4
11004
11005 =item Why is there Perl source in my database?
11006
11007 =item How do I store complex data structures with DB_File?
11008
11009 =item What does "Invalid Argument" mean?
11010
11011 =item What does "Bareword 'DB_File' not allowed" mean? 
11012
11013 =back
11014
11015 =item REFERENCES
11016
11017 =item HISTORY
11018
11019 =item BUGS
11020
11021 =item AVAILABILITY
11022
11023 =item COPYRIGHT
11024
11025 =item SEE ALSO
11026
11027 =item AUTHOR
11028
11029 =back
11030
11031 =head2 Data::Dumper - stringified perl data structures, suitable for both
11032 printing and C<eval>
11033
11034 =over 4
11035
11036 =item SYNOPSIS
11037
11038 =item DESCRIPTION
11039
11040 =over 4
11041
11042 =item Methods
11043
11044 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
11045 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11046 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11047 I<$OBJ>->Reset
11048
11049 =item Functions
11050
11051 Dumper(I<LIST>)
11052
11053 =item Configuration Variables or Methods
11054
11055 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11056 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11057 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11058 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11059 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11060 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11061 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11062 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11063 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11064 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11065 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11066 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11067 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11068 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11069 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11070
11071 =item Exports
11072
11073 Dumper
11074
11075 =back
11076
11077 =item EXAMPLES
11078
11079 =item BUGS
11080
11081 =item AUTHOR
11082
11083 =item VERSION
11084
11085 =item SEE ALSO
11086
11087 =back
11088
11089 =head2 Devel::DProf - a Perl code profiler
11090
11091 =over 4
11092
11093 =item SYNOPSIS
11094
11095 =item DESCRIPTION
11096
11097 =item PROFILE FORMAT
11098
11099 =item AUTOLOAD
11100
11101 =item ENVIRONMENT
11102
11103 =item BUGS
11104
11105 =item SEE ALSO
11106
11107 =back
11108
11109 =head2 Devel::PPPort, Perl/Pollution/Portability
11110
11111 =over 4
11112
11113 =item SYNOPSIS
11114
11115 =item DESCRIPTION
11116
11117 =over 4
11118
11119 =item WriteFile
11120
11121 =back
11122
11123 =item ppport.h
11124
11125 =item AUTHOR
11126
11127 =item SEE ALSO
11128
11129 =back
11130
11131 =head2 Devel::Peek - A data debugging tool for the XS programmer
11132
11133 =over 4
11134
11135 =item SYNOPSIS
11136
11137 =item DESCRIPTION
11138
11139 =over 4
11140
11141 =item Runtime debugging
11142
11143 =item Memory footprint debugging
11144
11145 =back
11146
11147 =item EXAMPLES
11148
11149 =over 4
11150
11151 =item A simple scalar string
11152
11153 =item A simple scalar number
11154
11155 =item A simple scalar with an extra reference
11156
11157 =item A reference to a simple scalar
11158
11159 =item A reference to an array
11160
11161 =item A reference to a hash
11162
11163 =item Dumping a large array or hash
11164
11165 =item A reference to an SV which holds a C pointer
11166
11167 =item A reference to a subroutine
11168
11169 =back
11170
11171 =item EXPORTS
11172
11173 =item BUGS
11174
11175 =item AUTHOR
11176
11177 =item SEE ALSO
11178
11179 =back
11180
11181 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11182
11183 =over 4
11184
11185 =item SYNOPSIS
11186
11187 =item DESCRIPTION
11188
11189 =back
11190
11191 =head2 Digest:: - Modules that calculate message digests
11192
11193 =over 4
11194
11195 =item SYNOPSIS
11196
11197 =item DESCRIPTION
11198
11199 I<binary>, I<hex>, I<base64>
11200
11201 =item OO INTERFACE
11202
11203 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11204 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11205 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11206
11207 =item SEE ALSO
11208
11209 =item AUTHOR
11210
11211 =back
11212
11213 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11214
11215 =over 4
11216
11217 =item SYNOPSIS
11218
11219 =item DESCRIPTION
11220
11221 =item FUNCTIONS
11222
11223 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11224
11225 =item METHODS
11226
11227 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11228 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11229
11230 =item EXAMPLES
11231
11232 =item SEE ALSO
11233
11234 =item COPYRIGHT
11235
11236 =item AUTHORS
11237
11238 =back
11239
11240 =head2 DirHandle - supply object methods for directory handles
11241
11242 =over 4
11243
11244 =item SYNOPSIS
11245
11246 =item DESCRIPTION
11247
11248 =item NOTES
11249
11250 =back
11251
11252 =head2 Dumpvalue - provides screen dump of Perl data.
11253
11254 =over 4
11255
11256 =item SYNOPSIS
11257
11258 =item DESCRIPTION
11259
11260 =over 4
11261
11262 =item Creation
11263
11264 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11265 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11266 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11267 stopDbSignal
11268
11269 =item Methods
11270
11271 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11272 compactDump, veryCompact, set, get
11273
11274 =back
11275
11276 =back
11277
11278 =head2 DynaLoader - Dynamically load C libraries into Perl code
11279
11280 =over 4
11281
11282 =item SYNOPSIS
11283
11284 =item DESCRIPTION
11285
11286 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11287 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11288 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11289 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11290 bootstrap()
11291
11292 =item AUTHOR
11293
11294 =back
11295
11296 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11297 Perl code
11298
11299 =over 4
11300
11301 =item SYNOPSIS
11302
11303 =item DESCRIPTION
11304
11305 =item AUTHOR
11306
11307 =back
11308
11309 =head2 Encode - character encodings
11310
11311 =over 4
11312
11313 =item SYNOPSIS
11314
11315 =over 4
11316
11317 =item Table of Contents
11318
11319 =back
11320
11321 =item DESCRIPTION
11322
11323 =over 4
11324
11325 =item TERMINOLOGY
11326
11327 =back
11328
11329 =item PERL ENCODING API
11330
11331 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11332 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11333 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11334 CHECK]);
11335
11336 =over 4
11337
11338 =item Listing available encodings
11339
11340 =item Defining Aliases
11341
11342 =back
11343
11344 =item Encoding via PerlIO
11345
11346 =item Handling Malformed Data
11347
11348 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11349 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11350 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11351 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11352 bitmask
11353
11354 =over 4
11355
11356 =item Unimplemented fallback schemes
11357
11358 =back
11359
11360 =item Defining Encodings
11361
11362 =item The UTF-8 flag
11363
11364 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11365
11366 =over 4
11367
11368 =item Messing with Perl's Internals
11369
11370 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11371
11372 =back
11373
11374 =item SEE ALSO
11375
11376 =item MAINTAINER
11377
11378 =back
11379
11380 =head2 Encode::Alias - alias definitions to encodings
11381
11382 =over 4
11383
11384 =item SYNOPSIS
11385
11386 =item DESCRIPTION
11387
11388 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11389 reference, e.g.:
11390
11391 =over 4
11392
11393 =item Alias overloading
11394
11395 =back
11396
11397 =item SEE ALSO
11398
11399 =back
11400
11401 =head2 Encode::Byte - Single Byte Encodings
11402
11403 =over 4
11404
11405 =item SYNOPSIS
11406
11407 =item ABSTRACT
11408
11409 =item DESCRIPTION
11410
11411 =item SEE ALSO
11412
11413 =back
11414
11415 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11416
11417 =head2 Encode::CN - China-based Chinese Encodings
11418
11419 =over 4
11420
11421 =item SYNOPSIS
11422
11423 =item DESCRIPTION
11424
11425 =item NOTES
11426
11427 =item BUGS
11428
11429 =item SEE ALSO
11430
11431 =back
11432
11433 =head2 Encode::CN::HZ -- internally used by Encode::CN
11434
11435 =head2 Encode::Config -- internally used by Encode
11436
11437 =head2 Encode::EBCDIC - EBCDIC Encodings
11438
11439 =over 4
11440
11441 =item SYNOPSIS
11442
11443 =item ABSTRACT
11444
11445 =item DESCRIPTION
11446
11447 =item SEE ALSO
11448
11449 =back
11450
11451 =head2 Encode::Encoding - Encode Implementation Base Class
11452
11453 =over 4
11454
11455 =item SYNOPSIS
11456
11457 =item DESCRIPTION
11458
11459 =over 4
11460
11461 =item Methods you should implement
11462
11463 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11464
11465 =item Other methods defined in Encode::Encodings
11466
11467 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11468
11469 =item Example: Encode::ROT13
11470
11471 =back
11472
11473 =item Why the heck Encode API is different?
11474
11475 =over 4
11476
11477 =item Compiled Encodings
11478
11479 =back
11480
11481 =item SEE ALSO
11482
11483 Scheme 1, Scheme 2, Other Schemes
11484
11485 =back
11486
11487 =head2 Encode::Guess -- Guesses encoding from data
11488
11489 =over 4
11490
11491 =item SYNOPSIS
11492
11493 =item ABSTRACT
11494
11495 =item DESCRIPTION
11496
11497 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11498 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11499 guess_encoding($data, [, I<list of suspects>])
11500
11501 =item CAVEATS
11502
11503 =item TO DO
11504
11505 =item SEE ALSO
11506
11507 =back
11508
11509 =head2 Encode::JP - Japanese Encodings
11510
11511 =over 4
11512
11513 =item SYNOPSIS
11514
11515 =item ABSTRACT
11516
11517 =item DESCRIPTION
11518
11519 =item Note on ISO-2022-JP(-1)?
11520
11521 =item BUGS
11522
11523 =item SEE ALSO
11524
11525 =back
11526
11527 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11528
11529 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11530
11531 =head2 Encode::KR - Korean Encodings
11532
11533 =over 4
11534
11535 =item SYNOPSIS
11536
11537 =item DESCRIPTION
11538
11539 =item BUGS
11540
11541 =item SEE ALSO
11542
11543 =back
11544
11545 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11546
11547 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11548
11549 =over 4
11550
11551 =item SYNOPSIS
11552
11553 =item ABSTRACT
11554
11555 =item DESCRIPTION
11556
11557 =item BUGS
11558
11559 =item SEE ALSO
11560
11561 =back
11562
11563 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11564
11565 =over 4
11566
11567 =item Overview
11568
11569 =item How does it work?
11570
11571 =item BUGS
11572
11573 =over 4
11574
11575 =item Workaround
11576
11577 =item How can I tell whether my encoding fully supports PerlIO ?
11578
11579 =back
11580
11581 =item SEE ALSO
11582
11583 =back
11584
11585 =head2 Encode::Supported -- Encodings supported by Encode
11586
11587 =over 4
11588
11589 =item DESCRIPTION
11590
11591 =over 4
11592
11593 =item Encoding Names
11594
11595 =back
11596
11597 =item Supported Encodings
11598
11599 =over 4
11600
11601 =item Built-in Encodings
11602
11603 =item Encode::Unicode -- other Unicode encodings
11604
11605 =item Encode::Byte -- Extended ASCII
11606
11607 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11608 the Cyrillic world, gsm0338 - Hentai Latin 1
11609
11610 =item CJK: Chinese, Japanese, Korean (Multibyte)
11611
11612 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11613 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11614 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11615
11616 =item Miscellaneous encodings
11617
11618 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11619
11620 =back
11621
11622 =item Unsupported encodings
11623
11624   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11625 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11626 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11627 Various Mac encodings, (Mac) Indic encodings
11628
11629 =item Encoding vs. Charset -- terminology
11630
11631 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11632
11633 =over 4
11634
11635 =item Microsoft-related naming mess
11636
11637 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11638
11639 =back
11640
11641 =item Glossary
11642
11643 character repertoire, coded character set (CCS), character encoding scheme
11644 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11645 UTF-16
11646
11647 =item See Also
11648
11649 =item References
11650
11651 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11652 RFC, UC, Unicode Glossary
11653
11654 =over 4
11655
11656 =item Other Notable Sites
11657
11658 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11659 "Introduction to i18n"
11660
11661 =item Offline sources
11662
11663 C<CJKV Information Processing> by Ken Lunde
11664
11665 =back
11666
11667 =back
11668
11669 =head2 Encode::Symbol - Symbol Encodings
11670
11671 =over 4
11672
11673 =item SYNOPSIS
11674
11675 =item ABSTRACT
11676
11677 =item DESCRIPTION
11678
11679 =item SEE ALSO
11680
11681 =back
11682
11683 =head2 Encode::TW - Taiwan-based Chinese Encodings
11684
11685 =over 4
11686
11687 =item SYNOPSIS
11688
11689 =item DESCRIPTION
11690
11691 =item NOTES
11692
11693 =item BUGS
11694
11695 =item SEE ALSO
11696
11697 =back
11698
11699 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11700
11701 =over 4
11702
11703 =item SYNOPSIS
11704
11705 =item ABSTRACT
11706
11707 L<http://www.unicode.org/glossary/> says:, Quick Reference
11708
11709 =item Size, Endianness, and BOM
11710
11711 =over 4
11712
11713 =item by size
11714
11715 =item by endianness
11716
11717 BOM as integer when fetched in network byte order
11718
11719 =back
11720
11721 =item Surrogate Pairs
11722
11723 =item SEE ALSO
11724
11725 =back
11726
11727 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11728 encodings
11729
11730 =over 4
11731
11732 =item SYNOPSIS
11733
11734 =item DESCRIPTION
11735
11736 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11737 reference, e.g.:
11738
11739 =over 4
11740
11741 =item Alias overloading
11742
11743 =back
11744
11745 =item SEE ALSO
11746
11747 =back
11748
11749 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11750 Internally used by Encode::??::ISO_2022_*
11751
11752 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11753 Encode::CN
11754
11755 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11756 Encode
11757
11758 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11759 Implementation Base Class
11760
11761 =over 4
11762
11763 =item SYNOPSIS
11764
11765 =item DESCRIPTION
11766
11767 =over 4
11768
11769 =item Methods you should implement
11770
11771 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11772
11773 =item Other methods defined in Encode::Encodings
11774
11775 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11776
11777 =item Example: Encode::ROT13
11778
11779 =back
11780
11781 =item Why the heck Encode API is different?
11782
11783 =over 4
11784
11785 =item Compiled Encodings
11786
11787 =back
11788
11789 =item SEE ALSO
11790
11791 Scheme 1, Scheme 2, Other Schemes
11792
11793 =back
11794
11795 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11796 data
11797
11798 =over 4
11799
11800 =item SYNOPSIS
11801
11802 =item ABSTRACT
11803
11804 =item DESCRIPTION
11805
11806 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11807 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11808 guess_encoding($data, [, I<list of suspects>])
11809
11810 =item CAVEATS
11811
11812 =item TO DO
11813
11814 =item SEE ALSO
11815
11816 =back
11817
11818 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11819 Encode::JP::2022_JP*
11820
11821 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11822 by Encode::JP
11823
11824 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11825 used by Encode::KR
11826
11827 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11828 and 'Q' header encoding
11829
11830 =over 4
11831
11832 =item SYNOPSIS
11833
11834 =item ABSTRACT
11835
11836 =item DESCRIPTION
11837
11838 =item BUGS
11839
11840 =item SEE ALSO
11841
11842 =back
11843
11844 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11845 on Encode and PerlIO
11846
11847 =over 4
11848
11849 =item Overview
11850
11851 =item How does it work?
11852
11853 =item BUGS
11854
11855 =over 4
11856
11857 =item Workaround
11858
11859 =item How can I tell whether my encoding fully supports PerlIO ?
11860
11861 =back
11862
11863 =item SEE ALSO
11864
11865 =back
11866
11867 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11868 supported by Encode
11869
11870 =over 4
11871
11872 =item DESCRIPTION
11873
11874 =over 4
11875
11876 =item Encoding Names
11877
11878 =back
11879
11880 =item Supported Encodings
11881
11882 =over 4
11883
11884 =item Built-in Encodings
11885
11886 =item Encode::Unicode -- other Unicode encodings
11887
11888 =item Encode::Byte -- Extended ASCII
11889
11890 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11891 the Cyrillic world, gsm0338 - Hentai Latin 1
11892
11893 =item CJK: Chinese, Japanese, Korean (Multibyte)
11894
11895 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11896 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11897 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11898
11899 =item Miscellaneous encodings
11900
11901 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11902
11903 =back
11904
11905 =item Unsupported encodings
11906
11907   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11908 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11909 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11910 Various Mac encodings, (Mac) Indic encodings
11911
11912 =item Encoding vs. Charset -- terminology
11913
11914 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11915
11916 =over 4
11917
11918 =item Microsoft-related naming mess
11919
11920 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11921
11922 =back
11923
11924 =item Glossary
11925
11926 character repertoire, coded character set (CCS), character encoding scheme
11927 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11928 UTF-16
11929
11930 =item See Also
11931
11932 =item References
11933
11934 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11935 RFC, UC, Unicode Glossary
11936
11937 =over 4
11938
11939 =item Other Notable Sites
11940
11941 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11942 "Introduction to i18n"
11943
11944 =item Offline sources
11945
11946 C<CJKV Information Processing> by Ken Lunde
11947
11948 =back
11949
11950 =back
11951
11952 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11953
11954 =over 4
11955
11956 =item SYNOPSIS
11957
11958   use Encode::Encoder;
11959   # Encode::encode("ISO-8859-1", $data); 
11960   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11961   # shortcut
11962   use Encode::Encoder qw(encoder);
11963   encoder($data)->iso_8859_1;
11964   # you can stack them!
11965   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11966   # you can use it as a decoder as well
11967   encoder($base64)->bytes('base64')->latin1;
11968   # stringified
11969   print encoder($data)->utf8->latin1;  # prints the string in latin1
11970   # numified
11971   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11972
11973 =item ABSTRACT
11974
11975 =item Description
11976
11977 =over 4
11978
11979 =item Predefined Methods
11980
11981 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11982 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11983 $e-E<gt>bytes([$encoding])
11984
11985 =item Example: base64 transcoder
11986
11987 =item Operator Overloading
11988
11989 =back
11990
11991 =item SEE ALSO
11992
11993 =back
11994
11995 =head2 Encodencoding, encoding - allows you to write your script in
11996 non-ascii or non-utf8
11997
11998 =over 4
11999
12000 =item SYNOPSIS
12001
12002 =item ABSTRACT
12003
12004 =item USAGE
12005
12006 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12007 I<ENCNAME_IN> ...] ;, no encoding;
12008
12009 =item CAVEATS
12010
12011 =over 4
12012
12013 =item NOT SCOPED
12014
12015 =item DO NOT MIX MULTIPLE ENCODINGS
12016
12017 =back
12018
12019 =item Non-ASCII Identifiers and Filter option
12020
12021 use encoding I<ENCNAME> Filter=E<gt>1;
12022
12023 =item EXAMPLE - Greekperl
12024
12025 =item KNOWN PROBLEMS
12026
12027 =item SEE ALSO
12028
12029 =back
12030
12031 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12032
12033 =over 4
12034
12035 =item SYNOPSIS
12036
12037   use Encode::Encoder;
12038   # Encode::encode("ISO-8859-1", $data); 
12039   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12040   # shortcut
12041   use Encode::Encoder qw(encoder);
12042   encoder($data)->iso_8859_1;
12043   # you can stack them!
12044   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12045   # you can use it as a decoder as well
12046   encoder($base64)->bytes('base64')->latin1;
12047   # stringified
12048   print encoder($data)->utf8->latin1;  # prints the string in latin1
12049   # numified
12050   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12051
12052 =item ABSTRACT
12053
12054 =item Description
12055
12056 =over 4
12057
12058 =item Predefined Methods
12059
12060 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12061 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12062 $e-E<gt>bytes([$encoding])
12063
12064 =item Example: base64 transcoder
12065
12066 =item Operator Overloading
12067
12068 =back
12069
12070 =item SEE ALSO
12071
12072 =back
12073
12074 =head2 English - use nice English (or awk) names for ugly punctuation
12075 variables
12076
12077 =over 4
12078
12079 =item SYNOPSIS
12080
12081 =item DESCRIPTION
12082
12083 =item PERFORMANCE
12084
12085 =back
12086
12087 =head2 Env - perl module that imports environment variables as scalars or
12088 arrays
12089
12090 =over 4
12091
12092 =item SYNOPSIS
12093
12094 =item DESCRIPTION
12095
12096 =item LIMITATIONS
12097
12098 =item AUTHOR
12099
12100 =back
12101
12102 =head2 Errno - System errno constants
12103
12104 =over 4
12105
12106 =item SYNOPSIS
12107
12108 =item DESCRIPTION
12109
12110 =item CAVEATS
12111
12112 =item AUTHOR
12113
12114 =item COPYRIGHT
12115
12116 =back
12117
12118 =head2 Exporter - Implements default import method for modules
12119
12120 =over 4
12121
12122 =item SYNOPSIS
12123
12124 =item DESCRIPTION
12125
12126 =over 4
12127
12128 =item How to Export
12129
12130 =item Selecting What To Export
12131
12132 =item How to Import
12133
12134 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12135
12136 =back
12137
12138 =item Advanced features
12139
12140 =over 4
12141
12142 =item Specialised Import Lists
12143
12144 =item Exporting without using Exporter's import method
12145
12146 =item Module Version Checking
12147
12148 =item Managing Unknown Symbols
12149
12150 =item Tag Handling Utility Functions
12151
12152 =item Generating combined tags
12153
12154 =item C<AUTOLOAD>ed Constants
12155
12156 =back
12157
12158 =back
12159
12160 =head2 Exporter::Heavy - Exporter guts
12161
12162 =over 4
12163
12164 =item SYNOPSIS
12165
12166 =item DESCRIPTION
12167
12168 =back
12169
12170 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12171 Makefiles etc.
12172
12173 =over 4
12174
12175 =item SYNOPSIS
12176
12177 =item DESCRIPTION
12178
12179 =back
12180
12181 cat
12182
12183 eqtime src dst
12184
12185 rm_rf files...
12186
12187 rm_f files...
12188
12189 touch files ..
12190
12191 mv source... destination
12192
12193 cp source... destination
12194
12195 chmod mode files..
12196
12197 mkpath directory..
12198
12199 test_f file
12200
12201 =over 4
12202
12203 =item BUGS
12204
12205 =item SEE ALSO 
12206
12207 =item AUTHOR
12208
12209 =back
12210
12211 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12212
12213 =over 4
12214
12215 =item SYNOPSIS
12216
12217 =item DESCRIPTION
12218
12219 B<test_harness>
12220
12221 =back
12222
12223 =head2 ExtUtils::Constant - generate XS code to import C header constants
12224
12225 =over 4
12226
12227 =item SYNOPSIS
12228
12229 =item DESCRIPTION
12230
12231 =item USAGE
12232
12233 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12234
12235 =item FUNCTIONS
12236
12237 =back
12238
12239 C_stringify NAME
12240
12241 perl_stringify NAME
12242
12243 constant_types
12244
12245 memEQ_clause NAME, CHECKED_AT, INDENT
12246
12247 assign INDENT, TYPE, PRE, POST, VALUE..
12248
12249 return_clause
12250
12251 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12252
12253 params WHAT
12254
12255 dump_names
12256
12257 dogfood
12258
12259 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12260 def_post, utf8
12261
12262 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12263
12264 autoload PACKAGE, VERSION, AUTOLOADER
12265
12266 WriteMakefileSnippet
12267
12268 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12269 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12270
12271 =over 4
12272
12273 =item AUTHOR
12274
12275 =back
12276
12277 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12278
12279 =over 4
12280
12281 =item SYNOPSIS
12282
12283 =item DESCRIPTION
12284
12285 =item @EXPORT
12286
12287 =item FUNCTIONS
12288
12289 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12290 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12291
12292 =item EXAMPLES
12293
12294 =item SEE ALSO
12295
12296 =item AUTHOR
12297
12298 =back
12299
12300 =head2 ExtUtils::Install - install files from here to there
12301
12302 =over 4
12303
12304 =item SYNOPSIS
12305
12306 =item DESCRIPTION
12307
12308 =back
12309
12310 =head2 ExtUtils::Installed - Inventory management of installed modules
12311
12312 =over 4
12313
12314 =item SYNOPSIS
12315
12316 =item DESCRIPTION
12317
12318 =item USAGE
12319
12320 =item FUNCTIONS
12321
12322 new(), modules(), files(), directories(), directory_tree(), validate(),
12323 packlist(), version()
12324
12325 =item EXAMPLE
12326
12327 =item AUTHOR
12328
12329 =back
12330
12331 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12332
12333 =over 4
12334
12335 =item SYNOPSIS
12336
12337 =item DESCRIPTION
12338
12339 For static extensions, For dynamic extensions at build/link time, For
12340 dynamic extensions at load time
12341
12342 =over 4
12343
12344 =item EXTRALIBS
12345
12346 =item LDLOADLIBS and LD_RUN_PATH
12347
12348 =item BSLOADLIBS
12349
12350 =back
12351
12352 =item PORTABILITY
12353
12354 =over 4
12355
12356 =item VMS implementation
12357
12358 =item Win32 implementation
12359
12360 =back
12361
12362 =item SEE ALSO
12363
12364 =back
12365
12366 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12367
12368 =over 4
12369
12370 =item SYNOPSIS
12371
12372 =item DESCRIPTION
12373
12374 =back
12375
12376 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12377
12378 =over 4
12379
12380 =item SYNOPSIS
12381
12382 =item DESCRIPTION
12383
12384 =item Inherently Cross-Platform Methods
12385
12386 =over 4
12387
12388 =item File::Spec wrappers  B<DEPRECATED>
12389
12390 canonpath
12391
12392 =back
12393
12394 =back
12395
12396 catdir
12397
12398 catfile
12399
12400 curdir
12401
12402 file_name_is_absolute
12403
12404 path
12405
12406 rootdir
12407
12408 updir
12409
12410 =over 4
12411
12412 =item Thought To Be Cross-Platform Methods
12413
12414 test_via_harness
12415
12416 =back
12417
12418 test_via_script
12419
12420 =over 4
12421
12422 =item AUTHOR
12423
12424 =back
12425
12426 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12427 ExtUtils::MakeMaker
12428
12429 =over 4
12430
12431 =item SYNOPSIS
12432
12433 =item DESCRIPTION
12434
12435 =back
12436
12437 perl_archive
12438
12439 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12440 ExtUtils::MakeMaker
12441
12442 =over 4
12443
12444 =item SYNOPSIS
12445
12446 =item DESCRIPTION
12447
12448 canonpath, cflags, manifypods, perl_archive
12449
12450 =back
12451
12452 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12453
12454 =over 4
12455
12456 =item SYNOPSIS
12457
12458 =item DESCRIPTION
12459
12460 =over 4
12461
12462 =item Overridden methods
12463
12464 B<replace_manpage_separator>
12465
12466 =back
12467
12468 =back
12469
12470 =over 4
12471
12472 =item AUTHOR
12473
12474 =item SEE ALSO
12475
12476 =back
12477
12478 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12479 ExtUtils::MakeMaker
12480
12481 =over 4
12482
12483 =item SYNOPSIS
12484
12485 =item DESCRIPTION
12486
12487 =back
12488
12489 maybe_command
12490
12491 guess_name
12492
12493 macify
12494
12495 patternify
12496
12497 init_main
12498
12499 init_others
12500
12501 init_dirscan
12502
12503 libscan (o)
12504
12505 constants (o)
12506
12507 static (o)
12508
12509 dlsyms (o)
12510
12511 dynamic (o)
12512
12513 clean (o)
12514
12515 realclean (o)
12516
12517 rulez (o)
12518
12519 processPL (o)
12520
12521 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12522 ExtUtils::MakeMaker
12523
12524 =over 4
12525
12526 =item SYNOPSIS
12527
12528 =item DESCRIPTION
12529
12530 =back
12531
12532 constants (o)
12533
12534 static_lib (o)
12535
12536 dynamic_lib (o)
12537
12538 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12539 ExtUtils::MakeMaker
12540
12541 =over 4
12542
12543 =item SYNOPSIS
12544
12545 =item DESCRIPTION
12546
12547 =item METHODS
12548
12549 =back
12550
12551 perl_archive_after
12552
12553 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12554
12555 =over 4
12556
12557 =item SYNOPSIS
12558
12559 =item DESCRIPTION
12560
12561 =over 4
12562
12563 =item Overridden methods
12564
12565 B<replace_manpage_separator>
12566
12567 =back
12568
12569 =back
12570
12571 =over 4
12572
12573 =item AUTHOR
12574
12575 =item SEE ALSO
12576
12577 =back
12578
12579 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12580
12581 =over 4
12582
12583 =item SYNOPSIS
12584
12585 =item DESCRIPTION
12586
12587 =item METHODS
12588
12589 =back
12590
12591 =over 4
12592
12593 =item SelfLoaded methods
12594
12595 c_o (o)
12596
12597 =back
12598
12599 cflags (o)
12600
12601 clean (o)
12602
12603 const_cccmd (o)
12604
12605 const_config (o)
12606
12607 const_loadlibs (o)
12608
12609 constants (o)
12610
12611 depend (o)
12612
12613 dir_target (o)
12614
12615 dist (o)
12616
12617 dist_basics (o)
12618
12619 dist_ci (o)
12620
12621 dist_core (o)
12622
12623 dist_dir
12624
12625 dist_test
12626
12627 dlsyms (o)
12628
12629 dynamic (o)
12630
12631 dynamic_bs (o)
12632
12633 dynamic_lib (o)
12634
12635 exescan
12636
12637 extliblist
12638
12639 find_perl
12640
12641 find_tests
12642
12643 =over 4
12644
12645 =item Methods to actually produce chunks of text for the Makefile
12646
12647 fixin
12648
12649 =back
12650
12651 force (o)
12652
12653 guess_name
12654
12655 has_link_code
12656
12657 init_dirscan
12658
12659 init_main
12660
12661 init_others
12662
12663 init_INST
12664
12665 init_INSTALL
12666
12667 init_lib2arch
12668
12669 init_PERL
12670
12671 init_PERM
12672
12673 install (o)
12674
12675 installbin (o)
12676
12677 libscan (o)
12678
12679 linkext (o)
12680
12681 lsdir
12682
12683 macro (o)
12684
12685 makeaperl (o)
12686
12687 makefile (o)
12688
12689 manifypods (o)
12690
12691 maybe_command
12692
12693 maybe_command_in_dirs
12694
12695 needs_linking (o)
12696
12697 nicetext
12698
12699 parse_abstract
12700
12701 parse_version
12702
12703 pasthru (o)
12704
12705 perl_script
12706
12707 perldepend (o)
12708
12709 perm_rw (o)
12710
12711 perm_rwx (o)
12712
12713 pm_to_blib
12714
12715 post_constants (o)
12716
12717 post_initialize (o)
12718
12719 postamble (o)
12720
12721 ppd
12722
12723 prefixify
12724
12725 processPL (o)
12726
12727 quote_paren
12728
12729 realclean (o)
12730
12731 replace_manpage_separator
12732
12733 static (o)
12734
12735 static_lib (o)
12736
12737 staticmake (o)
12738
12739 subdir_x (o)
12740
12741 subdirs (o)
12742
12743 test (o)
12744
12745 test_via_harness (override)
12746
12747 test_via_script (override)
12748
12749 tool_autosplit (o)
12750
12751 tools_other (o)
12752
12753 tool_xsubpp (o)
12754
12755 top_targets (o)
12756
12757 writedoc
12758
12759 xs_c (o)
12760
12761 xs_cpp (o)
12762
12763 xs_o (o)
12764
12765 perl_archive
12766
12767 perl_archive_after
12768
12769 export_list
12770
12771 =over 4
12772
12773 =item SEE ALSO
12774
12775 =back
12776
12777 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12778 ExtUtils::MakeMaker
12779
12780 =over 4
12781
12782 =item SYNOPSIS
12783
12784 =item DESCRIPTION
12785
12786 =over 4
12787
12788 =item Methods always loaded
12789
12790 wraplist
12791
12792 =back
12793
12794 =back
12795
12796 =over 4
12797
12798 =item Methods
12799
12800 guess_name (override)
12801
12802 =back
12803
12804 find_perl (override)
12805
12806 maybe_command (override)
12807
12808 maybe_command_in_dirs (override)
12809
12810 perl_script (override)
12811
12812 replace_manpage_separator
12813
12814 init_main (override)
12815
12816 init_others (override)
12817
12818 constants (override)
12819
12820 cflags (override)
12821
12822 const_cccmd (override)
12823
12824 pm_to_blib (override)
12825
12826 tool_autosplit (override)
12827
12828 tool_sxubpp (override)
12829
12830 xsubpp_version (override)
12831
12832 tools_other (override)
12833
12834 dist (override)
12835
12836 c_o (override)
12837
12838 xs_c (override)
12839
12840 xs_o (override)
12841
12842 top_targets (override)
12843
12844 dlsyms (override)
12845
12846 dynamic_lib (override)
12847
12848 dynamic_bs (override)
12849
12850 static_lib (override)
12851
12852 manifypods (override)
12853
12854 processPL (override)
12855
12856 installbin (override)
12857
12858 subdir_x (override)
12859
12860 clean (override)
12861
12862 realclean (override)
12863
12864 dist_core (override)
12865
12866 dist_test (override)
12867
12868 install (override)
12869
12870 perldepend (override)
12871
12872 makefile (override)
12873
12874 find_tests (override)
12875
12876 test (override)
12877
12878 makeaperl (override)
12879
12880 nicetext (override)
12881
12882 prefixify (override)
12883
12884 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12885 ExtUtils::MakeMaker
12886
12887 =over 4
12888
12889 =item SYNOPSIS
12890
12891 =item DESCRIPTION
12892
12893 =back
12894
12895 constants (o)
12896
12897 static_lib (o)
12898
12899 dynamic_bs (o)
12900
12901 dynamic_lib (o)
12902
12903 perl_script
12904
12905 pm_to_blib
12906
12907 tool_autosplit (override)
12908
12909 tools_other (o)
12910
12911 xs_o (o)
12912
12913 top_targets (o)
12914
12915 manifypods (o)
12916
12917 dist_ci (o)
12918
12919 dist_core (o)
12920
12921 pasthru (o)
12922
12923 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12924
12925 =over 4
12926
12927 =item SYNOPSIS
12928
12929 =item DESCRIPTION
12930
12931 =back
12932
12933 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12934
12935 =over 4
12936
12937 =item SYNOPSIS
12938
12939 =item DESCRIPTION
12940
12941 =back
12942
12943 =head2 ExtUtils::MakeMaker - create an extension Makefile
12944
12945 =over 4
12946
12947 =item SYNOPSIS
12948
12949 =item DESCRIPTION
12950
12951 =over 4
12952
12953 =item How To Write A Makefile.PL
12954
12955 =item Default Makefile Behaviour
12956
12957 =item make test
12958
12959 =item make testdb
12960
12961 =item make install
12962
12963 =item PREFIX and LIB attribute
12964
12965 =item AFS users
12966
12967 =item Static Linking of a new Perl Binary
12968
12969 =item Determination of Perl Library and Installation Locations
12970
12971 =item Which architecture dependent directory?
12972
12973 =item Using Attributes and Parameters
12974
12975 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12976 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12977 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12978 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12979 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12980 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12981 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12982 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12983 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
12984 LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
12985 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
12986 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
12987 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
12988 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
12989 PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
12990 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
12991 XSPROTOARG, XS_VERSION
12992
12993 =item Additional lowercase attributes
12994
12995 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12996 tool_autosplit
12997
12998 =item Overriding MakeMaker Methods
12999
13000 =item Hintsfile support
13001
13002 =item Distribution Support
13003
13004    make distcheck,    make skipcheck,    make distclean,    make manifest, 
13005   make distdir,   make disttest,    make tardist,    make dist,    make
13006 uutardist,    make shdist,    make zipdist,    make ci
13007
13008 =item Disabling an extension
13009
13010 =back
13011
13012 =item ENVIRONMENT
13013
13014 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13015
13016 =item SEE ALSO
13017
13018 =item AUTHORS
13019
13020 =back
13021
13022 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13023
13024 =over 4
13025
13026 =item SYNOPSIS
13027
13028 =item DESCRIPTION
13029
13030 =item MANIFEST.SKIP
13031
13032 =item EXPORT_OK
13033
13034 =item GLOBAL VARIABLES
13035
13036 =item DIAGNOSTICS
13037
13038 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13039 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13040
13041 =item ENVIRONMENT
13042
13043 B<PERL_MM_MANIFEST_DEBUG>
13044
13045 =item SEE ALSO
13046
13047 =item AUTHOR
13048
13049 =back
13050
13051 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13052
13053 =over 4
13054
13055 =item SYNOPSIS
13056
13057 =item DESCRIPTION
13058
13059 =item SEE ALSO
13060
13061 =back
13062
13063 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13064
13065 =over 4
13066
13067 =item SYNOPSIS
13068
13069 =item DESCRIPTION
13070
13071 =back
13072
13073 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13074 extension
13075
13076 =over 4
13077
13078 =item SYNOPSIS
13079
13080 =item DESCRIPTION
13081
13082 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13083
13084 =item AUTHOR
13085
13086 =item REVISION
13087
13088 =back
13089
13090 =head2 ExtUtils::Packlist - manage .packlist files
13091
13092 =over 4
13093
13094 =item SYNOPSIS
13095
13096 =item DESCRIPTION
13097
13098 =item USAGE
13099
13100 =item FUNCTIONS
13101
13102 new(), read(), write(), validate(), packlist_file()
13103
13104 =item EXAMPLE
13105
13106 =item AUTHOR
13107
13108 =back
13109
13110 =head2 ExtUtils::testlib - add blib/* directories to @INC
13111
13112 =over 4
13113
13114 =item SYNOPSIS
13115
13116 =item DESCRIPTION
13117
13118 =back
13119
13120 =head2 Fatal - replace functions with equivalents which succeed or die
13121
13122 =over 4
13123
13124 =item SYNOPSIS
13125
13126 =item DESCRIPTION
13127
13128 =item AUTHOR
13129
13130 =back
13131
13132 =head2 Fcntl - load the C Fcntl.h defines
13133
13134 =over 4
13135
13136 =item SYNOPSIS
13137
13138 =item DESCRIPTION
13139
13140 =item NOTE
13141
13142 =item EXPORTED SYMBOLS
13143
13144 =back
13145
13146 =head2 File::Basename, fileparse - split a pathname into pieces
13147
13148 =over 4
13149
13150 =item SYNOPSIS
13151
13152 =item DESCRIPTION
13153
13154 fileparse_set_fstype, fileparse
13155
13156 =item EXAMPLES
13157
13158 C<basename>, C<dirname>
13159
13160 =back
13161
13162 =head2 File::CheckTree, validate - run many filetest checks on a tree
13163
13164 =over 4
13165
13166 =item SYNOPSIS
13167
13168 =item DESCRIPTION
13169
13170 =item AUTHOR
13171
13172 =item HISTORY
13173
13174 =back
13175
13176 =head2 File::Compare - Compare files or filehandles
13177
13178 =over 4
13179
13180 =item SYNOPSIS
13181
13182 =item DESCRIPTION
13183
13184 =item RETURN
13185
13186 =item AUTHOR
13187
13188 =back
13189
13190 =head2 File::Copy - Copy files or filehandles
13191
13192 =over 4
13193
13194 =item SYNOPSIS
13195
13196 =item DESCRIPTION
13197
13198 =over 4
13199
13200 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13201
13202 rmscopy($from,$to[,$date_flag])
13203
13204 =back
13205
13206 =item RETURN
13207
13208 =item NOTES
13209
13210 =item AUTHOR
13211
13212 =back
13213
13214 =head2 File::DosGlob - DOS like globbing and then some
13215
13216 =over 4
13217
13218 =item SYNOPSIS
13219
13220 =item DESCRIPTION
13221
13222 =item NOTES
13223
13224 =item EXPORTS (by request only)
13225
13226 =item BUGS
13227
13228 =item AUTHOR
13229
13230 =item HISTORY
13231
13232 =item SEE ALSO
13233
13234 =back
13235
13236 =head2 File::Find - Traverse a directory tree.
13237
13238 =over 4
13239
13240 =item SYNOPSIS
13241
13242 =item DESCRIPTION
13243
13244 B<find>, B<finddepth>
13245
13246 =over 4
13247
13248 =item %options
13249
13250 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13251 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13252 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13253
13254 =item The wanted function
13255
13256 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13257 filename within that directory, C<$File::Find::name> is the complete
13258 pathname to the file
13259
13260 =back
13261
13262 =item WARNINGS
13263
13264 =item CAVEAT
13265
13266 $dont_use_nlink, symlinks
13267
13268 =item NOTES
13269
13270 =item HISTORY
13271
13272 =back
13273
13274 =head2 File::Glob - Perl extension for BSD glob routine
13275
13276 =over 4
13277
13278 =item SYNOPSIS
13279
13280 =item DESCRIPTION
13281
13282 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13283 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13284 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13285
13286 =item DIAGNOSTICS
13287
13288 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13289
13290 =item NOTES
13291
13292 =item AUTHOR
13293
13294 =back
13295
13296 =head2 File::Path - create or remove directory trees
13297
13298 =over 4
13299
13300 =item SYNOPSIS
13301
13302 =item DESCRIPTION
13303
13304 =item AUTHORS
13305
13306 =back
13307
13308 =head2 File::Spec - portably perform operations on file names
13309
13310 =over 4
13311
13312 =item SYNOPSIS
13313
13314 =item DESCRIPTION
13315
13316 =item METHODS
13317
13318 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13319 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13320 splitdir, catpath(), abs2rel, rel2abs()
13321
13322 =item SEE ALSO
13323
13324 =item AUTHORS
13325
13326 =back
13327
13328 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13329
13330 =over 4
13331
13332 =item SYNOPSIS
13333
13334 =item DESCRIPTION
13335
13336 =back
13337
13338 =head2 File::Spec::Epoc - methods for Epoc file specs
13339
13340 =over 4
13341
13342 =item SYNOPSIS
13343
13344 =item DESCRIPTION
13345
13346 canonpath()
13347
13348 =back
13349
13350 =over 4
13351
13352 =item SEE ALSO
13353
13354 =back
13355
13356 =head2 File::Spec::Functions - portably perform operations on file names
13357
13358 =over 4
13359
13360 =item SYNOPSIS
13361
13362 =item DESCRIPTION
13363
13364 =over 4
13365
13366 =item Exports
13367
13368 =back
13369
13370 =item SEE ALSO
13371
13372 =back
13373
13374 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13375
13376 =over 4
13377
13378 =item SYNOPSIS
13379
13380 =item DESCRIPTION
13381
13382 =item METHODS
13383
13384 canonpath
13385
13386 =back
13387
13388 catdir()
13389
13390 catfile
13391
13392 curdir
13393
13394 devnull
13395
13396 rootdir
13397
13398 tmpdir
13399
13400 updir
13401
13402 file_name_is_absolute
13403
13404 path
13405
13406 splitpath
13407
13408 splitdir
13409
13410 catpath
13411
13412 abs2rel
13413
13414 rel2abs
13415
13416 =over 4
13417
13418 =item AUTHORS
13419
13420 =item SEE ALSO
13421
13422 =back
13423
13424 =head2 File::Spec::NW5 - methods for NW5 file specs
13425
13426 =over 4
13427
13428 =item SYNOPSIS
13429
13430 =item DESCRIPTION
13431
13432 devnull
13433
13434 =back
13435
13436 tmpdir
13437
13438 catfile
13439
13440 canonpath
13441
13442 splitpath
13443
13444 splitdir
13445
13446 catpath
13447
13448 =over 4
13449
13450 =item SEE ALSO
13451
13452 =back
13453
13454 canonpath
13455
13456 splitpath
13457
13458 splitdir
13459
13460 catpath
13461
13462 =head2 File::Spec::OS2 - methods for OS/2 file specs
13463
13464 =over 4
13465
13466 =item SYNOPSIS
13467
13468 =item DESCRIPTION
13469
13470 =back
13471
13472 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13473 modules
13474
13475 =over 4
13476
13477 =item SYNOPSIS
13478
13479 =item DESCRIPTION
13480
13481 =item METHODS
13482
13483 canonpath()
13484
13485 =back
13486
13487 catdir()
13488
13489 catfile
13490
13491 curdir
13492
13493 devnull
13494
13495 rootdir
13496
13497 tmpdir
13498
13499 updir
13500
13501 no_upwards
13502
13503 case_tolerant
13504
13505 file_name_is_absolute
13506
13507 path
13508
13509 join
13510
13511 splitpath
13512
13513 splitdir
13514
13515 catpath()
13516
13517 abs2rel
13518
13519 rel2abs()
13520
13521 =over 4
13522
13523 =item SEE ALSO
13524
13525 =back
13526
13527 =head2 File::Spec::VMS - methods for VMS file specs
13528
13529 =over 4
13530
13531 =item SYNOPSIS
13532
13533 =item DESCRIPTION
13534
13535 eliminate_macros
13536
13537 =back
13538
13539 fixpath
13540
13541 =over 4
13542
13543 =item Methods always loaded
13544
13545 canonpath (override)
13546
13547 =back
13548
13549 catdir
13550
13551 catfile
13552
13553 curdir (override)
13554
13555 devnull (override)
13556
13557 rootdir (override)
13558
13559 tmpdir (override)
13560
13561 updir (override)
13562
13563 case_tolerant (override)
13564
13565 path (override)
13566
13567 file_name_is_absolute (override)
13568
13569 splitpath (override)
13570
13571 splitdir (override)
13572
13573 catpath (override)
13574
13575 abs2rel (override)
13576
13577 rel2abs (override)
13578
13579 =over 4
13580
13581 =item SEE ALSO
13582
13583 =back
13584
13585 =head2 File::Spec::Win32 - methods for Win32 file specs
13586
13587 =over 4
13588
13589 =item SYNOPSIS
13590
13591 =item DESCRIPTION
13592
13593 devnull
13594
13595 =back
13596
13597 tmpdir
13598
13599 catfile
13600
13601 canonpath
13602
13603 splitpath
13604
13605 splitdir
13606
13607 catpath
13608
13609 =over 4
13610
13611 =item SEE ALSO
13612
13613 =back
13614
13615 =head2 File::Temp - return name and handle of a temporary file safely
13616
13617 =over 4
13618
13619 =item PORTABILITY
13620
13621 =item SYNOPSIS
13622
13623 =item DESCRIPTION
13624
13625 =back
13626
13627 =over 4
13628
13629 =item FUNCTIONS
13630
13631 B<tempfile>
13632
13633 =back
13634
13635 B<tempdir>
13636
13637 =over 4
13638
13639 =item MKTEMP FUNCTIONS
13640
13641 B<mkstemp>
13642
13643 =back
13644
13645 B<mkstemps>
13646
13647 B<mkdtemp>
13648
13649 B<mktemp>
13650
13651 =over 4
13652
13653 =item POSIX FUNCTIONS
13654
13655 B<tmpnam>
13656
13657 =back
13658
13659 B<tmpfile>
13660
13661 =over 4
13662
13663 =item ADDITIONAL FUNCTIONS
13664
13665 B<tempnam>
13666
13667 =back
13668
13669 =over 4
13670
13671 =item UTILITY FUNCTIONS
13672
13673 B<unlink0>
13674
13675 =back
13676
13677 =over 4
13678
13679 =item PACKAGE VARIABLES
13680
13681 B<safe_level>, STANDARD, MEDIUM, HIGH
13682
13683 =back
13684
13685 TopSystemUID
13686
13687 =over 4
13688
13689 =item WARNING
13690
13691 =over 4
13692
13693 =item Temporary files and NFS
13694
13695 =back
13696
13697 =item HISTORY
13698
13699 =item SEE ALSO
13700
13701 =item AUTHOR
13702
13703 =back
13704
13705 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13706
13707 =over 4
13708
13709 =item SYNOPSIS
13710
13711 =item DESCRIPTION
13712
13713 =item NOTE
13714
13715 =item AUTHOR
13716
13717 =back
13718
13719 =head2 FileCache - keep more files open than the system permits
13720
13721 =over 4
13722
13723 =item SYNOPSIS
13724
13725 =item DESCRIPTION
13726
13727 cacheout EXPR, cacheout MODE, EXPR
13728
13729 =item CAVEATS
13730
13731 =item BUGS
13732
13733 =back
13734
13735 =head2 FileHandle - supply object methods for filehandles
13736
13737 =over 4
13738
13739 =item SYNOPSIS
13740
13741 =item DESCRIPTION
13742
13743 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13744
13745 =item SEE ALSO
13746
13747 =back
13748
13749 =head2 Filter::Simple - Simplified source filtering
13750
13751 =over 4
13752
13753 =item SYNOPSIS
13754
13755 =item DESCRIPTION
13756
13757 =over 4
13758
13759 =item The Problem
13760
13761 =item A Solution
13762
13763 =item Disabling or changing <no> behaviour
13764
13765 =item All-in-one interface
13766
13767 =item Filtering only specific components of source code
13768
13769 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13770 C<"all">
13771
13772 =item Filtering only the code parts of source code
13773
13774 Most source code ceases to be grammatically correct when it is broken up
13775 into the pieces between string literals and regexes. So the C<'code'>
13776 component filter behaves slightly differently from the other partial
13777 filters
13778 described in the previous section.
13779
13780 =item Using Filter::Simple with an explicit C<import> subroutine
13781
13782 =item Using Filter::Simple and Exporter together
13783
13784 =item How it works
13785
13786 =back
13787
13788 =item AUTHOR
13789
13790 =item COPYRIGHT
13791
13792 =back
13793
13794 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13795
13796 =over 4
13797
13798 =item SYNOPSIS
13799
13800 =item DESCRIPTION
13801
13802 =over 4
13803
13804 =item B<use Filter::Util::Call>
13805
13806 =item B<import()>
13807
13808 =item B<filter() and anonymous sub>
13809
13810 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13811
13812 =back
13813
13814 =item EXAMPLES
13815
13816 =over 4
13817
13818 =item Example 1: A simple filter.
13819
13820 =item Example 2: Using the context
13821
13822 =item Example 3: Using the context within the filter
13823
13824 =item Example 4: Using filter_del
13825
13826 =back
13827
13828 =item Filter::Simple
13829
13830 =item AUTHOR
13831
13832 =item DATE
13833
13834 =back
13835
13836 =head2 FindBin - Locate directory of original perl script
13837
13838 =over 4
13839
13840 =item SYNOPSIS
13841
13842 =item DESCRIPTION
13843
13844 =item EXPORTABLE VARIABLES
13845
13846 =item KNOWN ISSUES
13847
13848 =item KNOWN BUGS
13849
13850 =item AUTHORS
13851
13852 =item COPYRIGHT
13853
13854 =back
13855
13856 =head2 GDBM_File - Perl5 access to the gdbm library.
13857
13858 =over 4
13859
13860 =item SYNOPSIS
13861
13862 =item DESCRIPTION
13863
13864 =item AVAILABILITY
13865
13866 =item BUGS
13867
13868 =item SEE ALSO
13869
13870 =back
13871
13872 =head2 Getopt::Long - Extended processing of command line options
13873
13874 =over 4
13875
13876 =item SYNOPSIS
13877
13878 =item DESCRIPTION
13879
13880 =item Command Line Options, an Introduction
13881
13882 =item Getting Started with Getopt::Long
13883
13884 =over 4
13885
13886 =item Simple options
13887
13888 =item A little bit less simple options
13889
13890 =item Mixing command line option with other arguments
13891
13892 =item Options with values
13893
13894 =item Options with multiple values
13895
13896 =item Options with hash values
13897
13898 =item User-defined subroutines to handle options
13899
13900 =item Options with multiple names
13901
13902 =item Case and abbreviations
13903
13904 =item Summary of Option Specifications
13905
13906 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13907 + [ I<desttype> ]
13908
13909 =back
13910
13911 =item Advanced Possibilities
13912
13913 =over 4
13914
13915 =item Object oriented interface
13916
13917 =item Documentation and help texts
13918
13919 =item Storing options in a hash
13920
13921 =item Bundling
13922
13923 =item The lonesome dash
13924
13925 =item Argument callback
13926
13927 =back
13928
13929 =item Configuring Getopt::Long
13930
13931 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13932 require_order, permute, bundling (default: disabled), bundling_override
13933 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13934 (default: disabled), pass_through (default: disabled), prefix,
13935 prefix_pattern, debug (default: disabled)
13936
13937 =item Return values and Errors
13938
13939 =item Legacy
13940
13941 =over 4
13942
13943 =item Default destinations
13944
13945 =item Alternative option starters
13946
13947 =item Configuration variables
13948
13949 =back
13950
13951 =item Trouble Shooting
13952
13953 =over 4
13954
13955 =item Warning: Ignoring '!' modifier for short option
13956
13957 =item GetOptions does not return a false result when an option is not
13958 supplied
13959
13960 =item GetOptions does not split the command line correctly
13961
13962 =item How do I put a "-?" option into a Getopt::Long?
13963
13964 =back
13965
13966 =item AUTHOR
13967
13968 =item COPYRIGHT AND DISCLAIMER
13969
13970 =back
13971
13972 =head2 Getopt::Std, getopt - Process single-character switches with switch
13973 clustering
13974
13975 =over 4
13976
13977 =item SYNOPSIS
13978
13979 =item DESCRIPTION
13980
13981 =back
13982
13983 =head2 Hash::Util - A selection of general-utility hash subroutines
13984
13985 =over 4
13986
13987 =item SYNOPSIS
13988
13989 =item DESCRIPTION
13990
13991 =over 4
13992
13993 =item Restricted hashes
13994
13995 lock_keys, unlock_keys
13996
13997 =back
13998
13999 =back
14000
14001 lock_value, unlock_value
14002
14003 B<lock_hash>, B<unlock_hash>
14004
14005 =over 4
14006
14007 =item AUTHOR
14008
14009 =item SEE ALSO
14010
14011 =back
14012
14013 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14014 locale
14015
14016 =over 4
14017
14018 =item SYNOPSIS
14019
14020 =item DESCRIPTION
14021
14022 =back
14023
14024 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14025 tags
14026
14027 =over 4
14028
14029 =item SYNOPSIS
14030
14031 =item DESCRIPTION
14032
14033 =back
14034
14035 the function is_language_tag($lang1)
14036
14037 the function extract_language_tags($whatever)
14038
14039 the function same_language_tag($lang1, $lang2)
14040
14041 the function similarity_language_tag($lang1, $lang2)
14042
14043 the function is_dialect_of($lang1, $lang2)
14044
14045 the function super_languages($lang1)
14046
14047 the function locale2language_tag($locale_identifier)
14048
14049 the function encode_language_tag($lang1)
14050
14051 the function alternate_language_tags($lang1)
14052
14053 the function @langs = panic_languages(@accept_languages)
14054
14055 =over 4
14056
14057 =item ABOUT LOWERCASING
14058
14059 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14060
14061 =item SEE ALSO
14062
14063 =item COPYRIGHT
14064
14065 =item AUTHOR
14066
14067 =back
14068
14069 =head2 I18N::LangTags::List -- tags and names for human languages
14070
14071 =over 4
14072
14073 =item SYNOPSIS
14074
14075 =item DESCRIPTION
14076
14077 =item ABOUT LANGUAGE TAGS
14078
14079 =item LIST OF LANGUAGES
14080
14081 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14082 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14083 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14084 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14085 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14086 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14087 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14088 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14089 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14090 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14091 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14092 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14093 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14094 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14095 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14096 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14097 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14098 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14099 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14100 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14101 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14102 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14103 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14104 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14105 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14106 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14107 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14108 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14109 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14110 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14111 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14112 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14113 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14114 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14115 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14116 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14117 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14118 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14119 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14120 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14121 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14122 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14123 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14124 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14125 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14126 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14127 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14128 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14129 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14130 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14131 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14132 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14133 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14134 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14135 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14136 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14137 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14138 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14139 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14140 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14141 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14142 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14143 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14144 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14145 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14146 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14147 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14148 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14149 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14150 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14151 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14152 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14153 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14154 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14155 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14156 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14157 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14158 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14159 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14160 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14161 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14162 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14163 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14164 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14165 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14166 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14167 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14168 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14169 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14170 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14171 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14172 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14173 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14174 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14175 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14176 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14177 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14178 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14179 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14180 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14181 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14182 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14183 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14184 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14185 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14186 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14187 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14188 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14189 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14190 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14191 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14192 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14193 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14194 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14195 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14196 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14197 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14198 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14199 Zhuang, {zu} : Zulu, {zun} : Zuni
14200
14201 =item SEE ALSO
14202
14203 =item COPYRIGHT AND DISCLAIMER
14204
14205 =item AUTHOR
14206
14207 =back
14208
14209 =head2 I18N::Langinfo - query locale information
14210
14211 =over 4
14212
14213 =item SYNOPSIS
14214
14215 =item DESCRIPTION
14216
14217 =over 4
14218
14219 =item EXPORT
14220
14221 =back
14222
14223 =item SEE ALSO
14224
14225 =item AUTHOR
14226
14227 =item COPYRIGHT AND LICENSE
14228
14229 =back
14230
14231 =head2 IO - load various IO modules
14232
14233 =over 4
14234
14235 =item SYNOPSIS
14236
14237 =item DESCRIPTION
14238
14239 =back
14240
14241 =head2 IO::Dir - supply object methods for directory handles
14242
14243 =over 4
14244
14245 =item SYNOPSIS
14246
14247 =item DESCRIPTION
14248
14249 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14250 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14251
14252 =item SEE ALSO
14253
14254 =item AUTHOR
14255
14256 =item COPYRIGHT
14257
14258 =back
14259
14260 =head2 IO::File - supply object methods for filehandles
14261
14262 =over 4
14263
14264 =item SYNOPSIS
14265
14266 =item DESCRIPTION
14267
14268 =item CONSTRUCTOR
14269
14270 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14271
14272 =item METHODS
14273
14274 open( FILENAME [,MODE [,PERMS]] )
14275
14276 =item SEE ALSO
14277
14278 =item HISTORY
14279
14280 =back
14281
14282 =head2 IO::Handle - supply object methods for I/O handles
14283
14284 =over 4
14285
14286 =item SYNOPSIS
14287
14288 =item DESCRIPTION
14289
14290 =item CONSTRUCTOR
14291
14292 new (), new_from_fd ( FD, MODE )
14293
14294 =item METHODS
14295
14296 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14297 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14298 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14299 $io->blocking ( [ BOOL ] ), $io->untaint
14300
14301 =item NOTE
14302
14303 =item SEE ALSO
14304
14305 =item BUGS
14306
14307 =item HISTORY
14308
14309 =back
14310
14311 =head2 IO::Pipe - supply object methods for pipes
14312
14313 =over 4
14314
14315 =item SYNOPSIS
14316
14317 =item DESCRIPTION
14318
14319 =item CONSTRUCTOR
14320
14321 new ( [READER, WRITER] )
14322
14323 =item METHODS
14324
14325 reader ([ARGS]), writer ([ARGS]), handles ()
14326
14327 =item SEE ALSO
14328
14329 =item AUTHOR
14330
14331 =item COPYRIGHT
14332
14333 =back
14334
14335 =head2 IO::Poll - Object interface to system poll call
14336
14337 =over 4
14338
14339 =item SYNOPSIS
14340
14341 =item DESCRIPTION
14342
14343 =item METHODS
14344
14345 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14346 IO ), handles( [ EVENT_MASK ] )
14347
14348 =item SEE ALSO
14349
14350 =item AUTHOR
14351
14352 =item COPYRIGHT
14353
14354 =back
14355
14356 =head2 IO::Seekable - supply seek based methods for I/O objects
14357
14358 =over 4
14359
14360 =item SYNOPSIS
14361
14362 =item DESCRIPTION
14363
14364 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14365 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14366 $io->tell
14367
14368 =item SEE ALSO
14369
14370 =item HISTORY
14371
14372 =back
14373
14374 =head2 IO::Select - OO interface to the select system call
14375
14376 =over 4
14377
14378 =item SYNOPSIS
14379
14380 =item DESCRIPTION
14381
14382 =item CONSTRUCTOR
14383
14384 new ( [ HANDLES ] )
14385
14386 =item METHODS
14387
14388 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14389 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14390 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14391
14392 =item EXAMPLE
14393
14394 =item AUTHOR
14395
14396 =item COPYRIGHT
14397
14398 =back
14399
14400 =head2 IO::Socket - Object interface to socket communications
14401
14402 =over 4
14403
14404 =item SYNOPSIS
14405
14406 =item DESCRIPTION
14407
14408 =item CONSTRUCTOR
14409
14410 new ( [ARGS] )
14411
14412 =item METHODS
14413
14414 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14415 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14416
14417 =item SEE ALSO
14418
14419 =item AUTHOR
14420
14421 =item COPYRIGHT
14422
14423 =back
14424
14425 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14426
14427 =over 4
14428
14429 =item SYNOPSIS
14430
14431 =item DESCRIPTION
14432
14433 =item CONSTRUCTOR
14434
14435 new ( [ARGS] )
14436
14437 =over 4
14438
14439 =item METHODS
14440
14441 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14442 ()
14443
14444 =back
14445
14446 =item SEE ALSO
14447
14448 =item AUTHOR
14449
14450 =item COPYRIGHT
14451
14452 =back
14453
14454 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14455
14456 =over 4
14457
14458 =item SYNOPSIS
14459
14460 =item DESCRIPTION
14461
14462 =item CONSTRUCTOR
14463
14464 new ( [ARGS] )
14465
14466 =item METHODS
14467
14468 hostpath(), peerpath()
14469
14470 =item SEE ALSO
14471
14472 =item AUTHOR
14473
14474 =item COPYRIGHT
14475
14476 =back
14477
14478 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14479 handles
14480
14481 =over 4
14482
14483 =item SYNOPSIS
14484
14485 =item DESCRIPTION
14486
14487 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14488 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14489
14490 =item SEE ALSO
14491
14492 =item AUTHOR
14493
14494 =item COPYRIGHT
14495
14496 =back
14497
14498 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14499
14500 =over 4
14501
14502 =item SYNOPSIS
14503
14504 =item DESCRIPTION
14505
14506 =item CONSTRUCTOR
14507
14508 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14509
14510 =item METHODS
14511
14512 open( FILENAME [,MODE [,PERMS]] )
14513
14514 =item SEE ALSO
14515
14516 =item HISTORY
14517
14518 =back
14519
14520 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14521 handles
14522
14523 =over 4
14524
14525 =item SYNOPSIS
14526
14527 =item DESCRIPTION
14528
14529 =item CONSTRUCTOR
14530
14531 new (), new_from_fd ( FD, MODE )
14532
14533 =item METHODS
14534
14535 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14536 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14537 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14538 $io->blocking ( [ BOOL ] ), $io->untaint
14539
14540 =item NOTE
14541
14542 =item SEE ALSO
14543
14544 =item BUGS
14545
14546 =item HISTORY
14547
14548 =back
14549
14550 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14551
14552 =over 4
14553
14554 =item SYNOPSIS
14555
14556 =item DESCRIPTION
14557
14558 =item CONSTRUCTOR
14559
14560 new ( [READER, WRITER] )
14561
14562 =item METHODS
14563
14564 reader ([ARGS]), writer ([ARGS]), handles ()
14565
14566 =item SEE ALSO
14567
14568 =item AUTHOR
14569
14570 =item COPYRIGHT
14571
14572 =back
14573
14574 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14575
14576 =over 4
14577
14578 =item SYNOPSIS
14579
14580 =item DESCRIPTION
14581
14582 =item METHODS
14583
14584 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14585 IO ), handles( [ EVENT_MASK ] )
14586
14587 =item SEE ALSO
14588
14589 =item AUTHOR
14590
14591 =item COPYRIGHT
14592
14593 =back
14594
14595 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14596 I/O objects
14597
14598 =over 4
14599
14600 =item SYNOPSIS
14601
14602 =item DESCRIPTION
14603
14604 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14605 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14606 $io->tell
14607
14608 =item SEE ALSO
14609
14610 =item HISTORY
14611
14612 =back
14613
14614 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14615 call
14616
14617 =over 4
14618
14619 =item SYNOPSIS
14620
14621 =item DESCRIPTION
14622
14623 =item CONSTRUCTOR
14624
14625 new ( [ HANDLES ] )
14626
14627 =item METHODS
14628
14629 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14630 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14631 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14632
14633 =item EXAMPLE
14634
14635 =item AUTHOR
14636
14637 =item COPYRIGHT
14638
14639 =back
14640
14641 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14642 communications
14643
14644 =over 4
14645
14646 =item SYNOPSIS
14647
14648 =item DESCRIPTION
14649
14650 =item CONSTRUCTOR
14651
14652 new ( [ARGS] )
14653
14654 =item METHODS
14655
14656 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14657 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14658
14659 =item SEE ALSO
14660
14661 =item AUTHOR
14662
14663 =item COPYRIGHT
14664
14665 =back
14666
14667 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14668 AF_INET domain sockets
14669
14670 =over 4
14671
14672 =item SYNOPSIS
14673
14674 =item DESCRIPTION
14675
14676 =item CONSTRUCTOR
14677
14678 new ( [ARGS] )
14679
14680 =over 4
14681
14682 =item METHODS
14683
14684 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14685 ()
14686
14687 =back
14688
14689 =item SEE ALSO
14690
14691 =item AUTHOR
14692
14693 =item COPYRIGHT
14694
14695 =back
14696
14697 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14698 AF_UNIX domain sockets
14699
14700 =over 4
14701
14702 =item SYNOPSIS
14703
14704 =item DESCRIPTION
14705
14706 =item CONSTRUCTOR
14707
14708 new ( [ARGS] )
14709
14710 =item METHODS
14711
14712 hostpath(), peerpath()
14713
14714 =item SEE ALSO
14715
14716 =item AUTHOR
14717
14718 =item COPYRIGHT
14719
14720 =back
14721
14722 =head2 IPC::Msg - SysV Msg IPC object class
14723
14724 =over 4
14725
14726 =item SYNOPSIS
14727
14728 =item DESCRIPTION
14729
14730 =item METHODS
14731
14732 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14733 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14734 FLAGS ] ), stat
14735
14736 =item SEE ALSO
14737
14738 =item AUTHOR
14739
14740 =item COPYRIGHT
14741
14742 =back
14743
14744 =head2 IPC::Open2, open2 - open a process for both reading and writing
14745
14746 =over 4
14747
14748 =item SYNOPSIS
14749
14750 =item DESCRIPTION
14751
14752 =item WARNING 
14753
14754 =item SEE ALSO
14755
14756 =back
14757
14758 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14759 handling
14760
14761 =over 4
14762
14763 =item SYNOPSIS
14764
14765 =item DESCRIPTION
14766
14767 =item WARNING
14768
14769 =back
14770
14771 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14772
14773 =over 4
14774
14775 =item SYNOPSIS
14776
14777 =item DESCRIPTION
14778
14779 =item METHODS
14780
14781 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14782 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14783 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14784 , VALUE ), stat
14785
14786 =item SEE ALSO
14787
14788 =item AUTHOR
14789
14790 =item COPYRIGHT
14791
14792 =back
14793
14794 =head2 IPC::SysV - SysV IPC constants
14795
14796 =over 4
14797
14798 =item SYNOPSIS
14799
14800 =item DESCRIPTION
14801
14802 ftok( PATH, ID )
14803
14804 =item SEE ALSO
14805
14806 =item AUTHORS
14807
14808 =item COPYRIGHT
14809
14810 =back
14811
14812 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14813
14814 =over 4
14815
14816 =item SYNOPSIS
14817
14818 =item DESCRIPTION
14819
14820 =item METHODS
14821
14822 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14823 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14824 FLAGS ] ), stat
14825
14826 =item SEE ALSO
14827
14828 =item AUTHOR
14829
14830 =item COPYRIGHT
14831
14832 =back
14833
14834 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14835 class
14836
14837 =over 4
14838
14839 =item SYNOPSIS
14840
14841 =item DESCRIPTION
14842
14843 =item METHODS
14844
14845 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14846 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14847 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14848 , VALUE ), stat
14849
14850 =item SEE ALSO
14851
14852 =item AUTHOR
14853
14854 =item COPYRIGHT
14855
14856 =back
14857
14858 =head2 List::Util - A selection of general-utility list subroutines
14859
14860 =over 4
14861
14862 =item SYNOPSIS
14863
14864 =item DESCRIPTION
14865
14866 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14867 BLOCK LIST, shuffle LIST, sum LIST
14868
14869 =item KNOWN BUGS
14870
14871 =item SUGGESTED ADDITIONS
14872
14873 =item COPYRIGHT
14874
14875 =back
14876
14877 =head2 List::Utilib::List::Util, List::Util - A selection of
14878 general-utility list subroutines
14879
14880 =over 4
14881
14882 =item SYNOPSIS
14883
14884 =item DESCRIPTION
14885
14886 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14887 BLOCK LIST, shuffle LIST, sum LIST
14888
14889 =item KNOWN BUGS
14890
14891 =item SUGGESTED ADDITIONS
14892
14893 =item COPYRIGHT
14894
14895 =back
14896
14897 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14898 general-utility scalar subroutines
14899
14900 =over 4
14901
14902 =item SYNOPSIS
14903
14904 =item DESCRIPTION
14905
14906 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14907 EXPR, tainted EXPR, weaken REF
14908
14909 =item KNOWN BUGS
14910
14911 =item COPYRIGHT
14912
14913 =item BLATANT PLUG
14914
14915 =back
14916
14917 =head2 Locale::Constants - constants for Locale codes
14918
14919 =over 4
14920
14921 =item SYNOPSIS
14922
14923 =item DESCRIPTION
14924
14925 =item KNOWN BUGS AND LIMITATIONS
14926
14927 =item SEE ALSO
14928
14929 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14930
14931 =item AUTHOR
14932
14933 =item COPYRIGHT
14934
14935 =back
14936
14937 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14938
14939 =over 4
14940
14941 =item SYNOPSIS
14942
14943 =item DESCRIPTION
14944
14945 B<alpha-2>, B<alpha-3>, B<numeric>
14946
14947 =item CONVERSION ROUTINES
14948
14949 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14950 country_code2code( CODE, CODESET, CODESET )
14951
14952 =item QUERY ROUTINES
14953
14954 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14955
14956 =item SEMI-PRIVATE ROUTINES
14957
14958 =over 4
14959
14960 =item alias_code
14961
14962 =item rename_country
14963
14964 =back
14965
14966 =item EXAMPLES
14967
14968 =item DOMAIN NAMES
14969
14970 =item KNOWN BUGS AND LIMITATIONS
14971
14972 =item SEE ALSO
14973
14974 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14975 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14976 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14977 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14978
14979 =item AUTHOR
14980
14981 =item COPYRIGHT
14982
14983 =back
14984
14985 =head2 Locale::Currency - ISO three letter codes for currency
14986 identification (ISO 4217)
14987
14988 =over 4
14989
14990 =item SYNOPSIS
14991
14992 =item DESCRIPTION
14993
14994 XTS, XXX
14995
14996 =item CONVERSION ROUTINES
14997
14998 code2currency(), currency2code()
14999
15000 =item QUERY ROUTINES
15001
15002 C<all_currency_codes()>, C<all_currency_names()>
15003
15004 =item EXAMPLES
15005
15006 =item KNOWN BUGS AND LIMITATIONS
15007
15008 =item SEE ALSO
15009
15010 Locale::Country, Locale::Script, ISO 4217:1995,
15011 http://www.bsi-global.com/iso4217currency
15012
15013 =item AUTHOR
15014
15015 =item COPYRIGHT
15016
15017 =back
15018
15019 =head2 Locale::Language - ISO two letter codes for language identification
15020 (ISO 639)
15021
15022 =over 4
15023
15024 =item SYNOPSIS
15025
15026 =item DESCRIPTION
15027
15028 =item CONVERSION ROUTINES
15029
15030 code2language(), language2code()
15031
15032 =item QUERY ROUTINES
15033
15034 C<all_language_codes()>, C<all_language_names()>
15035
15036 =item EXAMPLES
15037
15038 =item KNOWN BUGS AND LIMITATIONS
15039
15040 =item SEE ALSO
15041
15042 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15043 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15044
15045 =item AUTHOR
15046
15047 =item COPYRIGHT
15048
15049 =back
15050
15051 =head2 Locale::Maketext -- framework for localization
15052
15053 =over 4
15054
15055 =item SYNOPSIS
15056
15057 =item DESCRIPTION
15058
15059 =item QUICK OVERVIEW
15060
15061 =item METHODS
15062
15063 =over 4
15064
15065 =item Construction Methods
15066
15067 =item The "maketext" Method
15068
15069 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15070
15071 =item Utility Methods
15072
15073 $language->quant($number, $singular), $language->quant($number, $singular,
15074 $plural), $language->quant($number, $singular, $plural, $negative),
15075 $language->numf($number), $language->sprintf($format, @items),
15076 $language->language_tag(), $language->encoding()
15077
15078 =item Language Handle Attributes and Internals
15079
15080 =back
15081
15082 =item LANGUAGE CLASS HIERARCHIES
15083
15084 =item ENTRIES IN EACH LEXICON
15085
15086 =item BRACKET NOTATION
15087
15088 =item AUTO LEXICONS
15089
15090 =item CONTROLLING LOOKUP FAILURE
15091
15092 =item HOW TO USE MAKETEXT
15093
15094 =item SEE ALSO
15095
15096 =item COPYRIGHT AND DISCLAIMER
15097
15098 =item AUTHOR
15099
15100 =back
15101
15102 =head2 Locale::Maketext::TPJ13 -- article about software localization
15103
15104 =over 4
15105
15106 =item SYNOPSIS
15107
15108 =item DESCRIPTION
15109
15110 =item Localization and Perl: gettext breaks, Maketext fixes
15111
15112 =over 4
15113
15114 =item A Localization Horror Story: It Could Happen To You
15115
15116 =item The Linguistic View
15117
15118 =item Breaking gettext
15119
15120 =item Replacing gettext
15121
15122 =item Buzzwords: Abstraction and Encapsulation
15123
15124 =item Buzzword: Isomorphism
15125
15126 =item Buzzword: Inheritance
15127
15128 =item Buzzword: Concision
15129
15130 =item The Devil in the Details
15131
15132 =item The Proof in the Pudding: Localizing Web Sites
15133
15134 =item References
15135
15136 =back
15137
15138 =back
15139
15140 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15141
15142 =over 4
15143
15144 =item SYNOPSIS
15145
15146 =item DESCRIPTION
15147
15148 B<alpha-2>, B<alpha-3>, B<numeric>
15149
15150 =over 4
15151
15152 =item SPECIAL CODES
15153
15154 =back
15155
15156 =item CONVERSION ROUTINES
15157
15158 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15159 script_code2code( CODE, CODESET, CODESET )
15160
15161 =item QUERY ROUTINES
15162
15163 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15164
15165 =item EXAMPLES
15166
15167 =item KNOWN BUGS AND LIMITATIONS
15168
15169 =item SEE ALSO
15170
15171 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15172 http://www.evertype.com/standards/iso15924/
15173
15174 =item AUTHOR
15175
15176 =item COPYRIGHT
15177
15178 =back
15179
15180 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15181
15182 =over 4
15183
15184 =item SYNOPSIS
15185
15186 =item DESCRIPTION
15187
15188 encode_base64($str, [$eol]), decode_base64($str)
15189
15190 =item DIAGNOSTICS
15191
15192 Premature end of base64 data, Premature padding of base64 data
15193
15194 =item EXAMPLES
15195
15196 =item COPYRIGHT
15197
15198 =back
15199
15200 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15201 of quoted-printable strings
15202
15203 =over 4
15204
15205 =item SYNOPSIS
15206
15207 =item DESCRIPTION
15208
15209 encode_qp($str), decode_qp($str);
15210
15211 =item COPYRIGHT
15212
15213 =back
15214
15215 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15216 strings
15217
15218 =over 4
15219
15220 =item SYNOPSIS
15221
15222 =item DESCRIPTION
15223
15224 encode_qp($str), decode_qp($str);
15225
15226 =item COPYRIGHT
15227
15228 =back
15229
15230 =head2 Math::BigFloat - Arbitrary size floating point math package
15231
15232 =over 4
15233
15234 =item SYNOPSIS
15235
15236 =item DESCRIPTION
15237
15238 =over 4
15239
15240 =item Canonical notation
15241
15242 =item Output
15243
15244 =item C<mantissa()>, C<exponent()> and C<parts()>
15245
15246 =item Accuracy vs. Precision
15247
15248 =item Rounding
15249
15250 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15251 ), fround  ( -$scale ) and fround ( 0 )
15252
15253 =back
15254
15255 =item EXAMPLES
15256
15257   # not ready yet
15258
15259 =item Autocreating constants
15260
15261 =over 4
15262
15263 =item Math library
15264
15265 =item Using Math::BigInt::Lite
15266
15267 =back
15268
15269 =item BUGS
15270
15271 =item CAVEAT
15272
15273 stringify, bstr(), bdiv, Modifying and =, bpow
15274
15275 =item LICENSE
15276
15277 =item AUTHORS
15278
15279 =back
15280
15281 =head2 Math::BigInt - Arbitrary size integer math package
15282
15283 =over 4
15284
15285 =item SYNOPSIS
15286
15287 =item DESCRIPTION
15288
15289 Canonical notation, Input, Output
15290
15291 =item METHODS
15292
15293 =over 4
15294
15295 =item config
15296
15297 =item accuracy
15298
15299 =item brsft
15300
15301 =item new
15302
15303 =item bnan
15304
15305 =item bzero
15306
15307 =item binf
15308
15309 =item bone
15310
15311 =item is_one()/is_zero()/is_nan()/is_inf()
15312
15313 =item is_positive()/is_negative()
15314
15315         $x->is_positive();              # true if >= 0
15316         $x->is_negative();              # true if <  0
15317
15318 =item is_odd()/is_even()/is_int()
15319
15320 =item bcmp
15321
15322 =item bacmp
15323
15324 =item sign
15325
15326 =item bcmp
15327
15328 =item bneg
15329
15330 =item babs
15331
15332 =item bnorm
15333
15334 =item bnot
15335
15336 =item binc
15337
15338 =item bdec
15339
15340 =item badd
15341
15342 =item bsub
15343
15344 =item bmul
15345
15346 =item bdiv
15347
15348 =item bmod
15349
15350 =item bmodinv
15351
15352 =item bmodpow
15353
15354 =item bpow
15355
15356 =item blsft
15357
15358 =item brsft
15359
15360 =item band
15361
15362 =item bior
15363
15364 =item bxor
15365
15366 =item bnot
15367
15368 =item bsqrt
15369
15370 =item bfac
15371
15372 =item round
15373
15374 =item bround
15375
15376 =item bfround
15377
15378 =item bfloor
15379
15380 =item bceil
15381
15382 =item bgcd
15383
15384 =item blcm
15385
15386 =item exponent
15387
15388 =item mantissa
15389
15390 =item parts
15391
15392 =item copy
15393
15394 =item as_number
15395
15396 =item bsstr
15397
15398 =item as_hex
15399
15400 =item as_bin
15401
15402 =back
15403
15404 =item ACCURACY and PRECISION
15405
15406 =over 4
15407
15408 =item Precision P
15409
15410 =item Accuracy A
15411
15412 =item Fallback F
15413
15414 =item Rounding mode R
15415
15416 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15417 (significant digits), Setting/Accessing, Creating numbers, Usage,
15418 Precedence, Overriding globals, Local settings, Rounding, Default values,
15419 Remarks
15420
15421 =back
15422
15423 =item INTERNALS
15424
15425 =over 4
15426
15427 =item MATH LIBRARY
15428
15429 =item SIGN
15430
15431 =item mantissa(), exponent() and parts()
15432
15433 =back
15434
15435 =item EXAMPLES
15436
15437   use Math::BigInt;
15438
15439 =item Autocreating constants
15440
15441 =item PERFORMANCE
15442
15443 =over 4
15444
15445 =item Alternative math libraries
15446
15447 =item SUBCLASSING
15448
15449 =back
15450
15451 =item Subclassing Math::BigInt
15452
15453 =item UPGRADING
15454
15455 =over 4
15456
15457 =item Auto-upgrade
15458
15459 bsqrt(), div(), blog()
15460
15461 =back
15462
15463 =item BUGS
15464
15465 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15466
15467 =item CAVEATS
15468
15469 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15470 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15471 types, bsqrt(), brsft()
15472
15473 =item LICENSE
15474
15475 =item SEE ALSO
15476
15477 =item AUTHORS
15478
15479 =back
15480
15481 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15482
15483 =over 4
15484
15485 =item SYNOPSIS
15486
15487 =item DESCRIPTION
15488
15489 =item EXPORT
15490
15491 =item WRAP YOUR OWN
15492
15493 =item LICENSE
15494
15495 This program is free software; you may redistribute it and/or modify it
15496 under
15497 the same terms as Perl itself. 
15498
15499 =item AUTHORS
15500
15501 =item SEE ALSO
15502
15503 =back
15504
15505 =head2 Math::BigRat - arbitrarily big rationals
15506
15507 =over 4
15508
15509 =item SYNOPSIS
15510
15511 =item DESCRIPTION
15512
15513 =over 4
15514
15515 =item MATH LIBRARY
15516
15517 =back
15518
15519 =item METHODS
15520
15521 =over 4
15522
15523 =item new()
15524
15525 =item numerator()
15526
15527 =item denominator()
15528
15529         $d = $x->denominator();
15530
15531 =item parts()
15532
15533 =item as_number()
15534
15535 =item bfac()
15536
15537 =item blog()
15538
15539 =item bround()/round()/bfround()
15540
15541 =back
15542
15543 =item BUGS
15544
15545 =item LICENSE
15546
15547 =item SEE ALSO
15548
15549 =item AUTHORS
15550
15551 =back
15552
15553 =head2 Math::Complex - complex numbers and associated mathematical
15554 functions
15555
15556 =over 4
15557
15558 =item SYNOPSIS
15559
15560 =item DESCRIPTION
15561
15562 =item OPERATIONS
15563
15564 =item CREATION
15565
15566 =item STRINGIFICATION
15567
15568 =over 4
15569
15570 =item CHANGED IN PERL 5.6
15571
15572 =back
15573
15574 =item USAGE
15575
15576 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15577
15578 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15579
15580 =item BUGS
15581
15582 =item AUTHORS
15583
15584 =back
15585
15586 =head2 Math::Trig - trigonometric functions
15587
15588 =over 4
15589
15590 =item SYNOPSIS
15591
15592 =item DESCRIPTION
15593
15594 =item TRIGONOMETRIC FUNCTIONS
15595
15596 B<tan>
15597
15598 =over 4
15599
15600 =item ERRORS DUE TO DIVISION BY ZERO
15601
15602 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15603
15604 =back
15605
15606 =item PLANE ANGLE CONVERSIONS
15607
15608 =item RADIAL COORDINATE CONVERSIONS
15609
15610 =over 4
15611
15612 =item COORDINATE SYSTEMS
15613
15614 =item 3-D ANGLE CONVERSIONS
15615
15616 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15617 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15618
15619 =back
15620
15621 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15622
15623 =item EXAMPLES
15624
15625 =over 4
15626
15627 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15628
15629 =back
15630
15631 =item BUGS
15632
15633 =item AUTHORS
15634
15635 =back
15636
15637 =head2 Memoize - Make functions faster by trading space for time
15638
15639 =over 4
15640
15641 =item SYNOPSIS
15642
15643 =item DESCRIPTION
15644
15645 =item DETAILS
15646
15647 =item OPTIONS
15648
15649 =over 4
15650
15651 =item INSTALL
15652
15653 =item NORMALIZER
15654
15655 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15656
15657 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15658
15659 =back
15660
15661 =item OTHER FACILITIES
15662
15663 =over 4
15664
15665 =item C<unmemoize>
15666
15667 =item C<flush_cache>
15668
15669 =back
15670
15671 =item CAVEATS
15672
15673 =item PERSISTENT CACHE SUPPORT
15674
15675 =item EXPIRATION SUPPORT
15676
15677 =item BUGS
15678
15679 =item MAILING LIST
15680
15681 =item AUTHOR
15682
15683 =item COPYRIGHT AND LICENSE
15684
15685 =item THANK YOU
15686
15687 =back
15688
15689 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15690 Storable use
15691
15692 =over 4
15693
15694 =item DESCRIPTION
15695
15696 =back
15697
15698 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15699 memoized values
15700
15701 =over 4
15702
15703 =item SYNOPSIS
15704
15705 =item DESCRIPTION
15706
15707 =item INTERFACE
15708
15709  TIEHASH,  EXISTS,  STORE
15710
15711 =item ALTERNATIVES
15712
15713 =item CAVEATS
15714
15715 =item AUTHOR
15716
15717 =item SEE ALSO
15718
15719 =back
15720
15721 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15722
15723 =over 4
15724
15725 =item DESCRIPTION
15726
15727 =back
15728
15729 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15730
15731 =over 4
15732
15733 =item DESCRIPTION
15734
15735 =back
15736
15737 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15738 Storable use
15739
15740 =over 4
15741
15742 =item DESCRIPTION
15743
15744 =back
15745
15746 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15747 Storable use
15748
15749 =over 4
15750
15751 =item DESCRIPTION
15752
15753 =back
15754
15755 =head2 Memoize::Storable - store Memoized data in Storable database
15756
15757 =over 4
15758
15759 =item DESCRIPTION
15760
15761 =back
15762
15763 =head2 NDBM_File - Tied access to ndbm files
15764
15765 =over 4
15766
15767 =item SYNOPSIS
15768
15769 =item DESCRIPTION
15770
15771 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15772
15773 =item DIAGNOSTICS
15774
15775 =over 4
15776
15777 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15778
15779 =back
15780
15781 =item BUGS AND WARNINGS
15782
15783 =back
15784
15785 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15786
15787 =over 4
15788
15789 =item SYNOPSIS
15790
15791 =item DESCRIPTION
15792
15793 =over 4
15794
15795 =item Enforcing redispatch
15796
15797 =item Avoiding repetitions
15798
15799 =back
15800
15801 =item AUTHOR
15802
15803 =item BUGS AND IRRITATIONS
15804
15805 =item COPYRIGHT
15806
15807 =back
15808
15809 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15810
15811 =over 4
15812
15813 =item SYNOPSIS
15814
15815 =item DESCRIPTION
15816
15817 =item USER METHODS
15818
15819 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15820 dataend ()
15821
15822 =item CLASS METHODS
15823
15824 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15825 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15826 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15827
15828 =item EXPORTS
15829
15830 =item AUTHOR
15831
15832 =item COPYRIGHT
15833
15834 =back
15835
15836 =head2 Net::Config - Local configuration data for libnet
15837
15838 =over 4
15839
15840 =item SYNOPSYS
15841
15842 =item DESCRIPTION
15843
15844 =item METHODS
15845
15846 requires_firewall HOST
15847
15848 =item NetConfig VALUES
15849
15850 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15851 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15852 ftp_int_pasive, local_netmask, test_hosts, test_exists
15853
15854 =back
15855
15856 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15857 and domain
15858
15859 =over 4
15860
15861 =item SYNOPSIS
15862
15863 =item DESCRIPTION
15864
15865 hostfqdn (), hostname (), hostdomain ()
15866
15867 =item AUTHOR
15868
15869 =item COPYRIGHT
15870
15871 =back
15872
15873 =head2 Net::FTP - FTP Client class
15874
15875 =over 4
15876
15877 =item SYNOPSIS
15878
15879 =item DESCRIPTION
15880
15881 =item OVERVIEW
15882
15883 =item CONSTRUCTOR
15884
15885 new (HOST [,OPTIONS])
15886
15887 =item METHODS
15888
15889 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15890 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15891 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15892 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15893 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15894 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15895 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15896 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15897 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15898 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15899 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15900 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15901 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15902
15903 =over 4
15904
15905 =item Methods for the adventurous
15906
15907 quot (CMD [,ARGS])
15908
15909 =back
15910
15911 =item THE dataconn CLASS
15912
15913 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15914 bytes_read (), abort (), close ()
15915
15916 =item UNIMPLEMENTED
15917
15918 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15919
15920 =item REPORTING BUGS
15921
15922 =item AUTHOR
15923
15924 =item SEE ALSO
15925
15926 =item USE EXAMPLES
15927
15928 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15929
15930 =item CREDITS
15931
15932 =item COPYRIGHT
15933
15934 =back
15935
15936 =head2 Net::NNTP - NNTP Client class
15937
15938 =over 4
15939
15940 =item SYNOPSIS
15941
15942 =item DESCRIPTION
15943
15944 =item CONSTRUCTOR
15945
15946 new ( [ HOST ] [, OPTIONS ])
15947
15948 =item METHODS
15949
15950 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15951 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15952 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15953 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15954 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15955 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15956 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15957
15958 =over 4
15959
15960 =item Extension methods
15961
15962 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15963 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15964 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15965 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15966 GROUP ] ), reader
15967
15968 =back
15969
15970 =item UNSUPPORTED
15971
15972 =item DEFINITIONS
15973
15974 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15975
15976 =item SEE ALSO
15977
15978 =item AUTHOR
15979
15980 =item COPYRIGHT
15981
15982 =back
15983
15984 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15985
15986 =over 4
15987
15988 =item SYNOPSIS
15989
15990 =item DESCRIPTION
15991
15992 =item EXAMPLES
15993
15994 =item CONSTRUCTOR
15995
15996 new ( [ HOST, ] [ OPTIONS ] )
15997
15998 =item METHODS
15999
16000 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16001 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16002 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16003 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16004
16005 =item NOTES
16006
16007 =item SEE ALSO
16008
16009 =item AUTHOR
16010
16011 =item COPYRIGHT
16012
16013 =back
16014
16015 =head2 Net::Ping - check a remote host for reachability
16016
16017 =over 4
16018
16019 =item SYNOPSIS
16020
16021 =item DESCRIPTION
16022
16023 =over 4
16024
16025 =item Functions
16026
16027 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( {
16028 0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host
16029 [, $timeout]);, $p->open($host);, $p->close();, pingecho($host [,
16030 $timeout]);
16031
16032 =back
16033
16034 =item WARNING
16035
16036 =item NOTES
16037
16038 =item AUTHORS
16039
16040 =item COPYRIGHT
16041
16042 =back
16043
16044 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16045
16046 =over 4
16047
16048 =item SYNOPSIS
16049
16050 =item DESCRIPTION
16051
16052 =item EXAMPLES
16053
16054 =item CONSTRUCTOR
16055
16056 new Net::SMTP [ HOST, ] [ OPTIONS ]
16057
16058 =item METHODS
16059
16060 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16061 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16062 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16063 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16064 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16065 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16066 quit ()
16067
16068 =item ADDRESSES
16069
16070 =item SEE ALSO
16071
16072 =item AUTHOR
16073
16074 =item COPYRIGHT
16075
16076 =back
16077
16078 =head2 Net::Time - time and daytime network client interface
16079
16080 =over 4
16081
16082 =item SYNOPSIS
16083
16084 =item DESCRIPTION
16085
16086 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16087 PROTOCOL [, TIMEOUT]]])
16088
16089 =item AUTHOR
16090
16091 =item COPYRIGHT
16092
16093 =back
16094
16095 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16096 functions
16097
16098 =over 4
16099
16100 =item SYNOPSIS
16101
16102 =item DESCRIPTION
16103
16104 =item EXAMPLES
16105
16106 =item NOTE
16107
16108 =item AUTHOR
16109
16110 =back
16111
16112 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16113
16114 =over 4
16115
16116 =item DESCRIPTION
16117
16118 =over 4
16119
16120 =item Where to get this document
16121
16122 =item How to contribute to this document
16123
16124 =back
16125
16126 =item Author and Copyright Information
16127
16128 =over 4
16129
16130 =item Disclaimer
16131
16132 =back
16133
16134 =item Obtaining and installing libnet
16135
16136 =over 4
16137
16138 =item What is libnet ?
16139
16140 =item Which version of perl do I need ?
16141
16142 =item What other modules do I need ?
16143
16144 =item What machines support libnet ?
16145
16146 =item Where can I get the latest libnet release
16147
16148 =back
16149
16150 =item Using Net::FTP
16151
16152 =over 4
16153
16154 =item How do I download files from an FTP server ?
16155
16156 =item How do I transfer files in binary mode ?
16157
16158 =item How can I get the size of a file on a remote FTP server ?
16159
16160 =item How can I get the modification time of a file on a remote FTP server
16161 ?
16162
16163 =item How can I change the permissions of a file on a remote server ?
16164
16165 =item Can I do a reget operation like the ftp command ?
16166
16167 =item How do I get a directory listing from an FTP server ?
16168
16169 =item Changing directory to "" does not fail ?
16170
16171 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16172
16173 =item I am behind an FTP proxy firewall, but cannot access machines outside
16174 ?
16175
16176 =item My ftp proxy firewall does not listen on port 21
16177
16178 =item Is it possible to change the file permissions of a file on an FTP
16179 server ?
16180
16181 =item I have seen scripts call a method message, but cannot find it
16182 documented ?
16183
16184 =item Why does Net::FTP not implement mput and mget methods
16185
16186 =back
16187
16188 =item Using Net::SMTP
16189
16190 =over 4
16191
16192 =item Why can't the part of an Email address after the @ be used as the
16193 hostname ?
16194
16195 =item Why does Net::SMTP not do DNS MX lookups ?
16196
16197 =item The verify method always returns true ?
16198
16199 =back
16200
16201 =item Debugging scripts
16202
16203 =over 4
16204
16205 =item How can I debug my scripts that use Net::* modules ?
16206
16207 =back
16208
16209 =item AUTHOR AND COPYRIGHT
16210
16211 =back
16212
16213 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16214 functions
16215
16216 =over 4
16217
16218 =item SYNOPSIS
16219
16220 =item DESCRIPTION
16221
16222 =item EXAMPLES
16223
16224 =item NOTE
16225
16226 =item AUTHOR
16227
16228 =back
16229
16230 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16231 functions
16232
16233 =over 4
16234
16235 =item SYNOPSIS
16236
16237 =item DESCRIPTION
16238
16239 =item NOTE
16240
16241 =item AUTHOR
16242
16243 =back
16244
16245 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16246 functions
16247
16248 =over 4
16249
16250 =item SYNOPSIS
16251
16252 =item DESCRIPTION
16253
16254 =item EXAMPLES
16255
16256 =item NOTE
16257
16258 =item AUTHOR
16259
16260 =back
16261
16262 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16263
16264 =over 4
16265
16266 =item SYNOPSIS
16267
16268 =item DESCRIPTION
16269
16270 =item THE .netrc FILE
16271
16272 machine name, default, login name, password string, account string, macdef
16273 name
16274
16275 =item CONSTRUCTOR
16276
16277 lookup ( MACHINE [, LOGIN ])
16278
16279 =item METHODS
16280
16281 login (), password (), account (), lpa ()
16282
16283 =item AUTHOR
16284
16285 =item SEE ALSO
16286
16287 =item COPYRIGHT
16288
16289 =back
16290
16291 =head2 O - Generic interface to Perl Compiler backends
16292
16293 =over 4
16294
16295 =item SYNOPSIS
16296
16297 =item DESCRIPTION
16298
16299 =item CONVENTIONS
16300
16301 =item IMPLEMENTATION
16302
16303 =item BUGS
16304
16305 =item AUTHOR
16306
16307 =back
16308
16309 =head2 ODBM_File - Tied access to odbm files
16310
16311 =over 4
16312
16313 =item SYNOPSIS
16314
16315 =item DESCRIPTION
16316
16317 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16318
16319 =item DIAGNOSTICS
16320
16321 =over 4
16322
16323 =item C<odbm store returned -1, errno 22, key "..." at ...>
16324
16325 =back
16326
16327 =item BUGS AND WARNINGS
16328
16329 =back
16330
16331 =head2 Opcode - Disable named opcodes when compiling perl code
16332
16333 =over 4
16334
16335 =item SYNOPSIS
16336
16337 =item DESCRIPTION
16338
16339 =item NOTE
16340
16341 =item WARNING
16342
16343 =item Operator Names and Operator Lists
16344
16345 an operator name (opname), an operator tag name (optag), a negated opname
16346 or optag, an operator set (opset)
16347
16348 =item Opcode Functions
16349
16350 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16351 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16352 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16353 opdump (PAT)
16354
16355 =item Manipulating Opsets
16356
16357 =item TO DO (maybe)
16358
16359 =back
16360
16361 =over 4
16362
16363 =item Predefined Opcode Tags
16364
16365 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16366 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16367 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16368 :dangerous
16369
16370 =item SEE ALSO
16371
16372 =item AUTHORS
16373
16374 =back
16375
16376 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16377 compartments
16378
16379 =over 4
16380
16381 =item SYNOPSIS
16382
16383 =item DESCRIPTION
16384
16385 a new namespace, an operator mask
16386
16387 =item WARNING
16388
16389 =over 4
16390
16391 =item RECENT CHANGES
16392
16393 =item Methods in class Safe
16394
16395 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16396 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16397 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16398 root (NAMESPACE), mask (MASK)
16399
16400 =item Some Safety Issues
16401
16402 Memory, CPU, Snooping, Signals, State Changes
16403
16404 =item AUTHOR
16405
16406 =back
16407
16408 =back
16409
16410 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16411 compiling
16412
16413 =over 4
16414
16415 =item SYNOPSIS  
16416
16417 =item DESCRIPTION
16418
16419 =item SEE ALSO
16420
16421 =back
16422
16423 =head2 POSIX - Perl interface to IEEE Std 1003.1
16424
16425 =over 4
16426
16427 =item SYNOPSIS
16428
16429 =item DESCRIPTION
16430
16431 =item NOTE
16432
16433 =item CAVEATS 
16434
16435 =item FUNCTIONS
16436
16437 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16438 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16439 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16440 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16441 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16442 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16443 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16444 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16445 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16446 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16447 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16448 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16449 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16450 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16451 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16452 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16453 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16454 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16455 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16456 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16457 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16458 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16459 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16460 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16461 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16462 wctomb, write
16463
16464 =item CLASSES
16465
16466 =over 4
16467
16468 =item POSIX::SigAction
16469
16470 new
16471
16472 =item POSIX::SigSet
16473
16474 new, addset, delset, emptyset, fillset, ismember
16475
16476 =item POSIX::Termios
16477
16478 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16479 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16480 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16481 field values, c_cflag field values, c_iflag field values, c_lflag field
16482 values, c_oflag field values
16483
16484 =back
16485
16486 =item PATHNAME CONSTANTS
16487
16488 Constants
16489
16490 =item POSIX CONSTANTS
16491
16492 Constants
16493
16494 =item SYSTEM CONFIGURATION
16495
16496 Constants
16497
16498 =item ERRNO
16499
16500 Constants
16501
16502 =item FCNTL
16503
16504 Constants
16505
16506 =item FLOAT
16507
16508 Constants
16509
16510 =item LIMITS
16511
16512 Constants
16513
16514 =item LOCALE
16515
16516 Constants
16517
16518 =item MATH
16519
16520 Constants
16521
16522 =item SIGNAL
16523
16524 Constants
16525
16526 =item STAT
16527
16528 Constants, Macros
16529
16530 =item STDLIB
16531
16532 Constants
16533
16534 =item STDIO
16535
16536 Constants
16537
16538 =item TIME
16539
16540 Constants
16541
16542 =item UNISTD
16543
16544 Constants
16545
16546 =item WAIT
16547
16548 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16549 WTERMSIG, WIFSTOPPED, WSTOPSIG
16550
16551 =back
16552
16553 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16554 name space
16555
16556 =over 4
16557
16558 =item SYNOPSIS
16559
16560 =item DESCRIPTION
16561
16562 unix, stdio, perlio, crlf, utf8, bytes, raw
16563
16564 =over 4
16565
16566 =item Defaults and how to override them
16567
16568 =back
16569
16570 =item AUTHOR
16571
16572 =item SEE ALSO
16573
16574 =back
16575
16576 =head2 PerlIO::Scalar - support module for in-memory IO.
16577
16578 =over 4
16579
16580 =item SYNOPSIS
16581
16582 =item DESCRIPTION
16583
16584 =back
16585
16586 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
16587
16588 =over 4
16589
16590 =item SYNOPSIS
16591
16592 =item DESCRIPTION
16593
16594 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16595 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
16596 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
16597 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16598 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16599 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16600 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16601
16602 =over 4
16603
16604 =item Example - a Hexadecimal Handle
16605
16606 =back
16607
16608 =back
16609
16610 =head2 PerlIO::encoding - encoding layer
16611
16612 =over 4
16613
16614 =item SYNOPSIS
16615
16616 =item DESCRIPTION
16617
16618 =item SEE ALSO
16619
16620 =back
16621
16622 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16623
16624 =over 4
16625
16626 =item SYNOPSIS
16627
16628 =item OPTIONS/ARGUMENTS
16629
16630 =over 4
16631
16632 =item podchecker()
16633
16634 B<-warnings> =E<gt> I<val>
16635
16636 =back
16637
16638 =item DESCRIPTION
16639
16640 =item DIAGNOSTICS
16641
16642 =over 4
16643
16644 =item Errors
16645
16646 empty =headn, =over on line I<N> without closing =back, =item without
16647 previous =over, =back without previous =over, No argument for =begin, =end
16648 without =begin, Nested =begin's, =for without formatter specification,
16649 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16650 interior-sequence "I<SEQ>", nested commands
16651 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16652 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16653 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16654 after =back
16655
16656 =item Warnings
16657
16658 multiple occurrence of link target I<name>, line containing nothing but
16659 whitespace in paragraph, file does not start with =head, previous =item has
16660 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16661 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16662 items in =over, No argument for =item, empty section in previous paragraph,
16663 Verbatim paragraph in NAME section
16664
16665 =item Hyperlinks
16666
16667 ignoring leading/trailing whitespace in link, (section) in '$page'
16668 deprecated, alternative text/node '%s' contains non-escaped | or /
16669
16670 =back
16671
16672 =item RETURN VALUE
16673
16674 =item EXAMPLES
16675
16676 =item INTERFACE
16677
16678 =back
16679
16680 C<Pod::Checker-E<gt>new( %options )>
16681
16682 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16683 @args )>
16684
16685 C<$checker-E<gt>num_errors()>
16686
16687 C<$checker-E<gt>name()>
16688
16689 C<$checker-E<gt>node()>
16690
16691 C<$checker-E<gt>idx()>
16692
16693 C<$checker-E<gt>hyperlink()>
16694
16695 =over 4
16696
16697 =item AUTHOR
16698
16699 =back
16700
16701 =head2 Pod::Find - find POD documents in directory trees
16702
16703 =over 4
16704
16705 =item SYNOPSIS
16706
16707 =item DESCRIPTION
16708
16709 =back
16710
16711 =over 4
16712
16713 =item C<pod_find( { %opts } , @directories )>
16714
16715 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16716 1>
16717
16718 =back
16719
16720 =over 4
16721
16722 =item C<simplify_name( $str )>
16723
16724 =back
16725
16726 =over 4
16727
16728 =item C<pod_where( { %opts }, $pod )>
16729
16730 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16731 1>
16732
16733 =back
16734
16735 =over 4
16736
16737 =item C<contains_pod( $file , $verbose )>
16738
16739 =back
16740
16741 =over 4
16742
16743 =item AUTHOR
16744
16745 =item SEE ALSO
16746
16747 =back
16748
16749 =head2 Pod::Html - module to convert pod files to HTML
16750
16751 =over 4
16752
16753 =item SYNOPSIS
16754
16755 =item DESCRIPTION
16756
16757 =item ARGUMENTS
16758
16759 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16760 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16761 title, verbose
16762
16763 =item EXAMPLE
16764
16765 =item ENVIRONMENT
16766
16767 =item AUTHOR
16768
16769 =item SEE ALSO
16770
16771 =item COPYRIGHT
16772
16773 =back
16774
16775 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16776 commands, etc.
16777
16778 =over 4
16779
16780 =item SYNOPSIS
16781
16782 =item REQUIRES
16783
16784 =item EXPORTS
16785
16786 =item DESCRIPTION
16787
16788 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16789 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16790
16791 =back
16792
16793 =over 4
16794
16795 =item B<Pod::InputSource>
16796
16797 =back
16798
16799 =over 4
16800
16801 =item B<new()>
16802
16803 =back
16804
16805 =over 4
16806
16807 =item B<name()>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item B<handle()>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item B<was_cutting()>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item B<Pod::Paragraph>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item Pod::Paragraph-E<gt>B<new()>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item $pod_para-E<gt>B<cmd_name()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item $pod_para-E<gt>B<text()>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item $pod_para-E<gt>B<raw_text()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item $pod_para-E<gt>B<cmd_prefix()>
16856
16857 =back
16858
16859 =over 4
16860
16861 =item $pod_para-E<gt>B<cmd_separator()>
16862
16863 =back
16864
16865 =over 4
16866
16867 =item $pod_para-E<gt>B<parse_tree()>
16868
16869 =back
16870
16871 =over 4
16872
16873 =item $pod_para-E<gt>B<file_line()>
16874
16875 =back
16876
16877 =over 4
16878
16879 =item B<Pod::InteriorSequence>
16880
16881 =back
16882
16883 =over 4
16884
16885 =item Pod::InteriorSequence-E<gt>B<new()>
16886
16887 =back
16888
16889 =over 4
16890
16891 =item $pod_seq-E<gt>B<cmd_name()>
16892
16893 =back
16894
16895 =over 4
16896
16897 =item $pod_seq-E<gt>B<prepend()>
16898
16899 =back
16900
16901 =over 4
16902
16903 =item $pod_seq-E<gt>B<append()>
16904
16905 =back
16906
16907 =over 4
16908
16909 =item $pod_seq-E<gt>B<nested()>
16910
16911 =back
16912
16913 =over 4
16914
16915 =item $pod_seq-E<gt>B<raw_text()>
16916
16917 =back
16918
16919 =over 4
16920
16921 =item $pod_seq-E<gt>B<left_delimiter()>
16922
16923 =back
16924
16925 =over 4
16926
16927 =item $pod_seq-E<gt>B<right_delimiter()>
16928
16929 =back
16930
16931 =over 4
16932
16933 =item $pod_seq-E<gt>B<parse_tree()>
16934
16935 =back
16936
16937 =over 4
16938
16939 =item $pod_seq-E<gt>B<file_line()>
16940
16941 =back
16942
16943 =over 4
16944
16945 =item Pod::InteriorSequence::B<DESTROY()>
16946
16947 =back
16948
16949 =over 4
16950
16951 =item B<Pod::ParseTree>
16952
16953 =back
16954
16955 =over 4
16956
16957 =item Pod::ParseTree-E<gt>B<new()>
16958
16959 =back
16960
16961 =over 4
16962
16963 =item $ptree-E<gt>B<top()>
16964
16965 =back
16966
16967 =over 4
16968
16969 =item $ptree-E<gt>B<children()>
16970
16971 =back
16972
16973 =over 4
16974
16975 =item $ptree-E<gt>B<prepend()>
16976
16977 =back
16978
16979 =over 4
16980
16981 =item $ptree-E<gt>B<append()>
16982
16983 =back
16984
16985 =over 4
16986
16987 =item $ptree-E<gt>B<raw_text()>
16988
16989 =back
16990
16991 =over 4
16992
16993 =item Pod::ParseTree::B<DESTROY()>
16994
16995 =back
16996
16997 =over 4
16998
16999 =item SEE ALSO
17000
17001 =item AUTHOR
17002
17003 =back
17004
17005 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17006
17007 =over 4
17008
17009 =item SYNOPSIS
17010
17011 =item DESCRIPTION
17012
17013 =back
17014
17015 =over 4
17016
17017 =item OBJECT METHODS
17018
17019 C<initialize>
17020
17021 =back
17022
17023 =over 4
17024
17025 =item Data Accessors
17026
17027 B<AddPreamble>
17028
17029 =back
17030
17031 B<AddPostamble>
17032
17033 B<Head1Level>
17034
17035 B<Label>
17036
17037 B<LevelNoNum>
17038
17039 B<MakeIndex>
17040
17041 B<ReplaceNAMEwithSection>
17042
17043 B<StartWithNewPage>
17044
17045 B<TableOfContents>
17046
17047 B<UniqueLabels>
17048
17049 B<UserPreamble>
17050
17051 B<UserPostamble>
17052
17053 B<Lists>
17054
17055 =over 4
17056
17057 =item Subclassed methods
17058
17059 =back
17060
17061 B<begin_pod>
17062
17063 B<end_pod>
17064
17065 B<command>
17066
17067 B<verbatim>
17068
17069 B<textblock>
17070
17071 B<interior_sequence>
17072
17073 =over 4
17074
17075 =item List Methods
17076
17077 B<begin_list>
17078
17079 =back
17080
17081 B<end_list>
17082
17083 B<add_item>
17084
17085 =over 4
17086
17087 =item Methods for headings
17088
17089 B<head>
17090
17091 =back
17092
17093 =over 4
17094
17095 =item Internal methods
17096
17097 B<_output>
17098
17099 =back
17100
17101 B<_replace_special_chars>
17102
17103 B<_replace_special_chars_late>
17104
17105 B<_create_label>
17106
17107 B<_create_index>
17108
17109 B<_clean_latex_commands>
17110
17111 B<_split_delimited>
17112
17113 =over 4
17114
17115 =item NOTES
17116
17117 =item SEE ALSO
17118
17119 =item AUTHORS
17120
17121 =item COPYRIGHT
17122
17123 =item REVISION
17124
17125 =back
17126
17127 =head2 Pod::Man - Convert POD data to formatted *roff input
17128
17129 =over 4
17130
17131 =item SYNOPSIS
17132
17133 =item DESCRIPTION
17134
17135 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17136 release, section
17137
17138 =item DIAGNOSTICS
17139
17140 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17141 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17142 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17143 =back
17144
17145 =item BUGS
17146
17147 =item CAVEATS
17148
17149 =item SEE ALSO
17150
17151 =item AUTHOR
17152
17153 =item COPYRIGHT AND LICENSE
17154
17155 =back
17156
17157 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17158
17159 =over 4
17160
17161 =item SYNOPSIS
17162
17163 =item DESCRIPTION
17164
17165 =item AUTHOR
17166
17167 =item COPYRIGHT AND LICENSE
17168
17169 =back
17170
17171 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17172
17173 =over 4
17174
17175 =item SYNOPSIS
17176
17177 =item DESCRIPTION
17178
17179 =back
17180
17181 =over 4
17182
17183 =item Pod::List
17184
17185 Pod::List-E<gt>new()
17186
17187 =back
17188
17189 $list-E<gt>file()
17190
17191 $list-E<gt>start()
17192
17193 $list-E<gt>indent()
17194
17195 $list-E<gt>type()
17196
17197 $list-E<gt>rx()
17198
17199 $list-E<gt>item()
17200
17201 $list-E<gt>parent()
17202
17203 $list-E<gt>tag()
17204
17205 =over 4
17206
17207 =item Pod::Hyperlink
17208
17209 Pod::Hyperlink-E<gt>new()
17210
17211 =back
17212
17213 $link-E<gt>parse($string)
17214
17215 $link-E<gt>markup($string)
17216
17217 $link-E<gt>text()
17218
17219 $link-E<gt>warning()
17220
17221 $link-E<gt>file(), $link-E<gt>line()
17222
17223 $link-E<gt>page()
17224
17225 $link-E<gt>node()
17226
17227 $link-E<gt>alttext()
17228
17229 $link-E<gt>type()
17230
17231 $link-E<gt>link()
17232
17233 =over 4
17234
17235 =item Pod::Cache
17236
17237 Pod::Cache-E<gt>new()
17238
17239 =back
17240
17241 $cache-E<gt>item()
17242
17243 $cache-E<gt>find_page($name)
17244
17245 =over 4
17246
17247 =item Pod::Cache::Item
17248
17249 Pod::Cache::Item-E<gt>new()
17250
17251 =back
17252
17253 $cacheitem-E<gt>page()
17254
17255 $cacheitem-E<gt>description()
17256
17257 $cacheitem-E<gt>path()
17258
17259 $cacheitem-E<gt>file()
17260
17261 $cacheitem-E<gt>nodes()
17262
17263 $cacheitem-E<gt>find_node($name)
17264
17265 $cacheitem-E<gt>idx()
17266
17267 =over 4
17268
17269 =item AUTHOR
17270
17271 =item SEE ALSO
17272
17273 =back
17274
17275 =head2 Pod::Parser - base class for creating POD filters and translators
17276
17277 =over 4
17278
17279 =item SYNOPSIS
17280
17281 =item REQUIRES
17282
17283 =item EXPORTS
17284
17285 =item DESCRIPTION
17286
17287 =item QUICK OVERVIEW
17288
17289 =item PARSING OPTIONS
17290
17291 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17292 B<-warnings> (default: unset)
17293
17294 =back
17295
17296 =over 4
17297
17298 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17299
17300 =back
17301
17302 =over 4
17303
17304 =item B<command()>
17305
17306 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17307
17308 =back
17309
17310 =over 4
17311
17312 =item B<verbatim()>
17313
17314 C<$text>, C<$line_num>, C<$pod_para>
17315
17316 =back
17317
17318 =over 4
17319
17320 =item B<textblock()>
17321
17322 C<$text>, C<$line_num>, C<$pod_para>
17323
17324 =back
17325
17326 =over 4
17327
17328 =item B<interior_sequence()>
17329
17330 =back
17331
17332 =over 4
17333
17334 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17335
17336 =back
17337
17338 =over 4
17339
17340 =item B<new()>
17341
17342 =back
17343
17344 =over 4
17345
17346 =item B<initialize()>
17347
17348 =back
17349
17350 =over 4
17351
17352 =item B<begin_pod()>
17353
17354 =back
17355
17356 =over 4
17357
17358 =item B<begin_input()>
17359
17360 =back
17361
17362 =over 4
17363
17364 =item B<end_input()>
17365
17366 =back
17367
17368 =over 4
17369
17370 =item B<end_pod()>
17371
17372 =back
17373
17374 =over 4
17375
17376 =item B<preprocess_line()>
17377
17378 =back
17379
17380 =over 4
17381
17382 =item B<preprocess_paragraph()>
17383
17384 =back
17385
17386 =over 4
17387
17388 =item METHODS FOR PARSING AND PROCESSING
17389
17390 =back
17391
17392 =over 4
17393
17394 =item B<parse_text()>
17395
17396 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17397 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17398 I<code-ref>|I<method-name>
17399
17400 =back
17401
17402 =over 4
17403
17404 =item B<interpolate()>
17405
17406 =back
17407
17408 =over 4
17409
17410 =item B<parse_paragraph()>
17411
17412 =back
17413
17414 =over 4
17415
17416 =item B<parse_from_filehandle()>
17417
17418 =back
17419
17420 =over 4
17421
17422 =item B<parse_from_file()>
17423
17424 =back
17425
17426 =over 4
17427
17428 =item ACCESSOR METHODS
17429
17430 =back
17431
17432 =over 4
17433
17434 =item B<errorsub()>
17435
17436 =back
17437
17438 =over 4
17439
17440 =item B<cutting()>
17441
17442 =back
17443
17444 =over 4
17445
17446 =item B<parseopts()>
17447
17448 =back
17449
17450 =over 4
17451
17452 =item B<output_file()>
17453
17454 =back
17455
17456 =over 4
17457
17458 =item B<output_handle()>
17459
17460 =back
17461
17462 =over 4
17463
17464 =item B<input_file()>
17465
17466 =back
17467
17468 =over 4
17469
17470 =item B<input_handle()>
17471
17472 =back
17473
17474 =over 4
17475
17476 =item B<input_streams()>
17477
17478 =back
17479
17480 =over 4
17481
17482 =item B<top_stream()>
17483
17484 =back
17485
17486 =over 4
17487
17488 =item PRIVATE METHODS AND DATA
17489
17490 =back
17491
17492 =over 4
17493
17494 =item B<_push_input_stream()>
17495
17496 =back
17497
17498 =over 4
17499
17500 =item B<_pop_input_stream()>
17501
17502 =back
17503
17504 =over 4
17505
17506 =item TREE-BASED PARSING
17507
17508 =item SEE ALSO
17509
17510 =item AUTHOR
17511
17512 =back
17513
17514 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17515
17516 =over 4
17517
17518 =item SYNOPSIS
17519
17520 =item DESCRIPTION
17521
17522 =over 4
17523
17524 =item EXPORT
17525
17526 =back
17527
17528 =item AUTHOR
17529
17530 =item SEE ALSO
17531
17532 =back
17533
17534 =head2 Pod::Select, podselect() - extract selected sections of POD from
17535 input
17536
17537 =over 4
17538
17539 =item SYNOPSIS
17540
17541 =item REQUIRES
17542
17543 =item EXPORTS
17544
17545 =item DESCRIPTION
17546
17547 =item SECTION SPECIFICATIONS
17548
17549 =item RANGE SPECIFICATIONS
17550
17551 =back
17552
17553 =over 4
17554
17555 =item OBJECT METHODS
17556
17557 =back
17558
17559 =over 4
17560
17561 =item B<curr_headings()>
17562
17563 =back
17564
17565 =over 4
17566
17567 =item B<select()>
17568
17569 =back
17570
17571 =over 4
17572
17573 =item B<add_selection()>
17574
17575 =back
17576
17577 =over 4
17578
17579 =item B<clear_selections()>
17580
17581 =back
17582
17583 =over 4
17584
17585 =item B<match_section()>
17586
17587 =back
17588
17589 =over 4
17590
17591 =item B<is_selected()>
17592
17593 =back
17594
17595 =over 4
17596
17597 =item EXPORTED FUNCTIONS
17598
17599 =back
17600
17601 =over 4
17602
17603 =item B<podselect()>
17604
17605 B<-output>, B<-sections>, B<-ranges>
17606
17607 =back
17608
17609 =over 4
17610
17611 =item PRIVATE METHODS AND DATA
17612
17613 =back
17614
17615 =over 4
17616
17617 =item B<_compile_section_spec()>
17618
17619 =back
17620
17621 =over 4
17622
17623 =item $self->{_SECTION_HEADINGS}
17624
17625 =back
17626
17627 =over 4
17628
17629 =item $self->{_SELECTED_SECTIONS}
17630
17631 =back
17632
17633 =over 4
17634
17635 =item SEE ALSO
17636
17637 =item AUTHOR
17638
17639 =back
17640
17641 =head2 Pod::Text - Convert POD data to formatted ASCII text
17642
17643 =over 4
17644
17645 =item SYNOPSIS
17646
17647 =item DESCRIPTION
17648
17649 alt, code, indent, loose, quotes, sentence, width
17650
17651 =item DIAGNOSTICS
17652
17653 Bizarre space in item, Item called without tag, Can't open %s for reading:
17654 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17655 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17656 Unmatched =back
17657
17658 =item RESTRICTIONS
17659
17660 =item NOTES
17661
17662 =item SEE ALSO
17663
17664 =item AUTHOR
17665
17666 =item COPYRIGHT AND LICENSE
17667
17668 =back
17669
17670 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17671
17672 =over 4
17673
17674 =item SYNOPSIS
17675
17676 =item DESCRIPTION
17677
17678 =item BUGS
17679
17680 =item SEE ALSO
17681
17682 =item AUTHOR
17683
17684 =item COPYRIGHT AND LICENSE
17685
17686 =back
17687
17688 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17689 text
17690
17691 =over 4
17692
17693 =item SYNOPSIS
17694
17695 =item DESCRIPTION
17696
17697 =item BUGS
17698
17699 =item SEE ALSO
17700
17701 =item AUTHOR
17702
17703 =item COPYRIGHT AND LICENSE
17704
17705 =back
17706
17707 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17708 text with format escapes
17709
17710 =over 4
17711
17712 =item SYNOPSIS
17713
17714 =item DESCRIPTION
17715
17716 =item NOTES
17717
17718 =item SEE ALSO
17719
17720 =item AUTHOR
17721
17722 =item COPYRIGHT AND LICENSE
17723
17724 =back
17725
17726 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17727 documentation
17728
17729 =over 4
17730
17731 =item SYNOPSIS
17732
17733 =item ARGUMENTS
17734
17735 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17736 C<-pathlist>
17737
17738 =item DESCRIPTION
17739
17740 =item EXAMPLES
17741
17742 =over 4
17743
17744 =item Recommended Use
17745
17746 =back
17747
17748 =item CAVEATS
17749
17750 =item AUTHOR
17751
17752 =item ACKNOWLEDGEMENTS
17753
17754 =back
17755
17756 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17757 translators.
17758
17759 =over 4
17760
17761 =item HEADINGS
17762
17763 =item This C<is> a "level 1" heading
17764
17765 =over 4
17766
17767 =item ``Level'' "2 I<heading>
17768
17769 =back
17770
17771 =item This C<is> a "level 1" heading
17772
17773 =over 4
17774
17775 =item ``Level'' 2 I<heading>
17776
17777 =back
17778
17779 =item LINKS
17780
17781 =item OVER AND ITEMS
17782
17783 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17784 text
17785
17786 =item FORMATTING CODES
17787
17788 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17789
17790 =item VERBATIM
17791
17792 =item CONCLUSION
17793
17794 =back
17795
17796 =head2 Pod::t::htmlescp, Escape Sequences Test
17797
17798 =over 4
17799
17800 =item DESCRIPTION
17801
17802 =back
17803
17804 =head2 Pod::t::htmlview, Test HTML Rendering
17805
17806 =over 4
17807
17808 =item SYNOPSIS
17809
17810 =item DESCRIPTION
17811
17812 =item METHODS =E<gt> OTHER STUFF
17813
17814 =over 4
17815
17816 =item new()
17817
17818 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17819 Sat, 3 Mat
17820
17821 =item old()
17822
17823 =back
17824
17825 =item TESTING FOR AND BEGIN
17826
17827 =item TESTING URLs hyperlinking
17828
17829 =item SEE ALSO
17830
17831 =back
17832
17833 =head2 SDBM_File - Tied access to sdbm files
17834
17835 =over 4
17836
17837 =item SYNOPSIS
17838
17839 =item DESCRIPTION
17840
17841 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17842
17843 =item DIAGNOSTICS
17844
17845 =over 4
17846
17847 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17848
17849 =back
17850
17851 =item BUGS AND WARNINGS
17852
17853 =back
17854
17855 =head2 Safe - Compile and execute code in restricted compartments
17856
17857 =over 4
17858
17859 =item SYNOPSIS
17860
17861 =item DESCRIPTION
17862
17863 a new namespace, an operator mask
17864
17865 =item WARNING
17866
17867 =over 4
17868
17869 =item RECENT CHANGES
17870
17871 =item Methods in class Safe
17872
17873 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17874 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17875 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17876 root (NAMESPACE), mask (MASK)
17877
17878 =item Some Safety Issues
17879
17880 Memory, CPU, Snooping, Signals, State Changes
17881
17882 =item AUTHOR
17883
17884 =back
17885
17886 =back
17887
17888 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17889
17890 =over 4
17891
17892 =item SYNOPSIS
17893
17894 =item DESCRIPTION
17895
17896 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17897 EXPR, tainted EXPR, weaken REF
17898
17899 =item KNOWN BUGS
17900
17901 =item COPYRIGHT
17902
17903 =item BLATANT PLUG
17904
17905 =back
17906
17907 =head2 Search::Dict, look - search for key in dictionary file
17908
17909 =over 4
17910
17911 =item SYNOPSIS
17912
17913 =item DESCRIPTION
17914
17915 =back
17916
17917 =head2 SelectSaver - save and restore selected file handle
17918
17919 =over 4
17920
17921 =item SYNOPSIS
17922
17923 =item DESCRIPTION
17924
17925 =back
17926
17927 =head2 SelfLoader - load functions only on demand
17928
17929 =over 4
17930
17931 =item SYNOPSIS
17932
17933 =item DESCRIPTION
17934
17935 =over 4
17936
17937 =item The __DATA__ token
17938
17939 =item SelfLoader autoloading
17940
17941 =item Autoloading and package lexicals
17942
17943 =item SelfLoader and AutoLoader
17944
17945 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17946
17947 =item Classes and inherited methods.
17948
17949 =back
17950
17951 =item Multiple packages and fully qualified subroutine names
17952
17953 =back
17954
17955 =head2 Shell - run shell commands transparently within perl
17956
17957 =over 4
17958
17959 =item SYNOPSIS
17960
17961 =item DESCRIPTION
17962
17963 =over 4
17964
17965 =item OBJECT ORIENTED SYNTAX
17966
17967 =back
17968
17969 =item AUTHOR
17970
17971 =back
17972
17973 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17974 socket.h defines and structure manipulators 
17975
17976 =over 4
17977
17978 =item SYNOPSIS
17979
17980 =item DESCRIPTION
17981
17982 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17983 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17984 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17985 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17986 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17987
17988 =back
17989
17990 =head2 Storable - persistence for Perl data structures
17991
17992 =over 4
17993
17994 =item SYNOPSIS
17995
17996 =item DESCRIPTION
17997
17998 =item MEMORY STORE
17999
18000 =item ADVISORY LOCKING
18001
18002 =item SPEED
18003
18004 =item CANONICAL REPRESENTATION
18005
18006 =item FORWARD COMPATIBILITY
18007
18008 utf8 data, restricted hashes, files from future versions of Storable
18009
18010 =item ERROR REPORTING
18011
18012 =item WIZARDS ONLY
18013
18014 =over 4
18015
18016 =item Hooks
18017
18018 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18019 I<serialized>, ..
18020
18021 =item Predicates
18022
18023 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18024 C<Storable::is_retrieving>
18025
18026 =item Recursion
18027
18028 =item Deep Cloning
18029
18030 =back
18031
18032 =item Storable magic
18033
18034 =item EXAMPLES
18035
18036 =item WARNING
18037
18038 =item BUGS
18039
18040 =over 4
18041
18042 =item 64 bit data in perl 5.6.0 and 5.6.1
18043
18044 =back
18045
18046 =item CREDITS
18047
18048 =item AUTHOR
18049
18050 =item SEE ALSO
18051
18052 =back
18053
18054 =head2 Switch - A switch statement for Perl
18055
18056 =over 4
18057
18058 =item VERSION
18059
18060 =item SYNOPSIS
18061
18062 =item BACKGROUND
18063
18064 =item DESCRIPTION
18065
18066 =over 4
18067
18068 =item Allowing fall-through
18069
18070 =item Automating fall-through
18071
18072 =item Alternative syntax
18073
18074 =item Higher-order Operations
18075
18076 =back
18077
18078 =item DEPENDENCIES
18079
18080 =item AUTHOR
18081
18082 =item BUGS
18083
18084 =item LIMITATION
18085
18086 =item COPYRIGHT
18087
18088 =back
18089
18090 =head2 Symbol - manipulate Perl symbols and their names
18091
18092 =over 4
18093
18094 =item SYNOPSIS
18095
18096 =item DESCRIPTION
18097
18098 =back
18099
18100 =head2 Sys::Hostname - Try every conceivable way to get hostname
18101
18102 =over 4
18103
18104 =item SYNOPSIS
18105
18106 =item DESCRIPTION
18107
18108 =item AUTHOR
18109
18110 =back
18111
18112 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18113 interface to the UNIX syslog(3) calls
18114
18115 =over 4
18116
18117 =item SYNOPSIS
18118
18119 =item DESCRIPTION
18120
18121 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18122 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18123 in 5.004_02), closelog
18124
18125 =item EXAMPLES
18126
18127 =item SEE ALSO
18128
18129 =item AUTHOR
18130
18131 =back
18132
18133 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18134 Perl interface to the UNIX syslog(3) calls
18135
18136 =over 4
18137
18138 =item SYNOPSIS
18139
18140 =item DESCRIPTION
18141
18142 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18143 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18144 in 5.004_02), closelog
18145
18146 =item EXAMPLES
18147
18148 =item SEE ALSO
18149
18150 =item AUTHOR
18151
18152 =back
18153
18154 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18155
18156 =over 4
18157
18158 =item SYNOPSIS
18159
18160 =item DESCRIPTION
18161
18162 =item DIAGNOSTICS
18163
18164 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18165 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18166 comma allowed after filehandle, No name for escape sequence %s
18167
18168 =item ENVIRONMENT
18169
18170 ANSI_COLORS_DISABLED
18171
18172 =item RESTRICTIONS
18173
18174 =item NOTES
18175
18176 =item SEE ALSO
18177
18178 =item AUTHORS
18179
18180 =item LICENSE
18181
18182 =back
18183
18184 =head2 Term::Cap - Perl termcap interface
18185
18186 =over 4
18187
18188 =item SYNOPSIS
18189
18190 =item DESCRIPTION
18191
18192 =over 4
18193
18194 =item METHODS
18195
18196 =back
18197
18198 =back
18199
18200 B<Tgetent>, OSPEED, TERM
18201
18202 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18203
18204 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18205
18206 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18207
18208 B<Trequire>
18209
18210 =over 4
18211
18212 =item EXAMPLES
18213
18214 =item COPYRIGHT AND LICENSE
18215
18216 =item AUTHOR
18217
18218 =item SEE ALSO
18219
18220 =back
18221
18222 =head2 Term::Complete - Perl word completion module
18223
18224 =over 4
18225
18226 =item SYNOPSIS
18227
18228 =item DESCRIPTION
18229
18230 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18231
18232 =item DIAGNOSTICS
18233
18234 =item BUGS
18235
18236 =item AUTHOR
18237
18238 =back
18239
18240 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18241 no real package is found, substitutes stubs instead of basic functions.
18242
18243 =over 4
18244
18245 =item SYNOPSIS
18246
18247 =item DESCRIPTION
18248
18249 =item Minimal set of supported functions
18250
18251 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18252 C<MinLine>, C<findConsole>, Attribs, C<Features>
18253
18254 =item Additional supported functions
18255
18256 C<tkRunning>, C<ornaments>, C<newTTY>
18257
18258 =item EXPORTS
18259
18260 =item ENVIRONMENT
18261
18262 =item CAVEATS
18263
18264 =back
18265
18266 =head2 Test - provides a simple framework for writing test scripts
18267
18268 =over 4
18269
18270 =item SYNOPSIS
18271
18272 =item DESCRIPTION
18273
18274 =over 4
18275
18276 =item Functions
18277
18278 B<plan>
18279
18280 =back
18281
18282 =back
18283
18284 B<_to_value>
18285
18286 B<ok>
18287
18288 =over 4
18289
18290 =item TEST TYPES
18291
18292 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18293
18294 =item ONFAIL
18295
18296 =item BUGS and CAVEATS
18297
18298 =item NOTE
18299
18300 =item SEE ALSO
18301
18302 =item AUTHOR
18303
18304 =back
18305
18306 =head2 Test::Builder - Backend for building test libraries
18307
18308 =over 4
18309
18310 =item SYNOPSIS
18311
18312 =item DESCRIPTION
18313
18314 =over 4
18315
18316 =item Construction
18317
18318 B<new>
18319
18320 =back
18321
18322 =back
18323
18324 =over 4
18325
18326 =item Setting up tests
18327
18328 B<exported_to>
18329
18330 =back
18331
18332 B<plan>
18333
18334 B<expected_tests>
18335
18336 B<no_plan>
18337
18338 B<skip_all>
18339
18340 =over 4
18341
18342 =item Running tests
18343
18344 B<ok>
18345
18346 =back
18347
18348 B<is_eq>, B<is_num>
18349
18350 B<isnt_eq>, B<isnt_num>
18351
18352 B<like>, B<unlike>
18353
18354 B<maybe_regex>
18355
18356 B<cmp_ok>
18357
18358 B<BAILOUT>
18359
18360 B<skip>
18361
18362 B<todo_skip>
18363
18364 B<skip_rest>
18365
18366 =over 4
18367
18368 =item Test style
18369
18370 B<level>
18371
18372 =back
18373
18374 B<use_numbers>
18375
18376 B<no_header>, B<no_ending>
18377
18378 =over 4
18379
18380 =item Output
18381
18382 B<diag>
18383
18384 =back
18385
18386 B<_print>
18387
18388 B<output>, B<failure_output>, B<todo_output>
18389
18390 =over 4
18391
18392 =item Test Status and Info
18393
18394 B<current_test>
18395
18396 =back
18397
18398 B<summary>
18399
18400 B<details>  I<UNIMPLEMENTED>, B<todo>
18401
18402 B<caller>
18403
18404 B<_sanity_check>
18405
18406 B<_whoa>
18407
18408 B<_my_exit>
18409
18410 =over 4
18411
18412 =item EXAMPLES
18413
18414 =item SEE ALSO
18415
18416 =item AUTHORS
18417
18418 =item COPYRIGHT
18419
18420 =back
18421
18422 =head2 Test::Harness - run perl standard test scripts with statistics
18423
18424 =over 4
18425
18426 =item SYNOPSIS
18427
18428 =item DESCRIPTION
18429
18430 =over 4
18431
18432 =item The test script output
18433
18434 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18435 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18436 else>
18437
18438 =item Taint mode
18439
18440 =item Configuration variables.
18441
18442 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18443
18444 =item Failure
18445
18446 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18447 Failed>
18448
18449 =item Functions
18450
18451 B<runtests>
18452
18453 =back
18454
18455 =back
18456
18457 B<_all_ok>
18458
18459 B<_globdir>
18460
18461 B<_run_all_tests>
18462
18463 B<_mk_leader>
18464
18465 B<_leader_width>
18466
18467 =over 4
18468
18469 =item EXPORT
18470
18471 =item DIAGNOSTICS
18472
18473 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18474 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18475 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18476 %s>, C<FAILED--Further testing stopped: %s>
18477
18478 =item ENVIRONMENT
18479
18480 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18481 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18482 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18483
18484 =item EXAMPLE
18485
18486 =item SEE ALSO
18487
18488 =item AUTHORS
18489
18490 =item TODO
18491
18492 =item BUGS
18493
18494 =back
18495
18496 =head2 Test::Harness::Assert - simple assert
18497
18498 =over 4
18499
18500 =item SYNOPSIS
18501
18502 =item DESCRIPTION
18503
18504 =over 4
18505
18506 =item Functions
18507
18508 B<assert>
18509
18510 =back
18511
18512 =back
18513
18514 =over 4
18515
18516 =item AUTHOR
18517
18518 =item SEE ALSO
18519
18520 =back
18521
18522 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18523
18524 =over 4
18525
18526 =item SYNOPSIS
18527
18528 =item DESCRIPTION
18529
18530 =back
18531
18532 =head2 Test::Harness::Straps - detailed analysis of test results
18533
18534 =over 4
18535
18536 =item SYNOPSIS
18537
18538 =item DESCRIPTION
18539
18540 =over 4
18541
18542 =item Construction
18543
18544 B<new>
18545
18546 =back
18547
18548 =back
18549
18550 B<_init>
18551
18552 =over 4
18553
18554 =item Analysis
18555
18556 B<analyze>
18557
18558 =back
18559
18560 B<analyze_fh>
18561
18562 B<analyze_file>
18563
18564 B<_switches>
18565
18566 B<_INC2PERL5LIB>
18567
18568 B<_filtered_INC>
18569
18570 B<_restore_PERL5LIB>
18571
18572 =over 4
18573
18574 =item Parsing
18575
18576 B<_is_comment>
18577
18578 =back
18579
18580 B<_is_header>
18581
18582 B<_is_test>
18583
18584 B<_is_bail_out>
18585
18586 B<_reset_file_state>
18587
18588 =over 4
18589
18590 =item Results
18591
18592 B<_detailize>
18593
18594 =back
18595
18596 =over 4
18597
18598 =item EXAMPLES
18599
18600 =item AUTHOR
18601
18602 =item SEE ALSO
18603
18604 =back
18605
18606 =head2 Test::More - yet another framework for writing test scripts
18607
18608 =over 4
18609
18610 =item SYNOPSIS
18611
18612 =item DESCRIPTION
18613
18614 =over 4
18615
18616 =item I love it when a plan comes together
18617
18618 =back
18619
18620 =back
18621
18622 =over 4
18623
18624 =item Test names
18625
18626 =item I'm ok, you're not ok.
18627
18628 B<ok>
18629
18630 =back
18631
18632 B<is>, B<isnt>
18633
18634 B<like>
18635
18636 B<unlike>
18637
18638 B<cmp_ok>
18639
18640 B<can_ok>
18641
18642 B<isa_ok>
18643
18644 B<pass>, B<fail>
18645
18646 =over 4
18647
18648 =item Diagnostics
18649
18650 B<diag>
18651
18652 =back
18653
18654 =over 4
18655
18656 =item Module tests
18657
18658 B<use_ok>
18659
18660 =back
18661
18662 B<require_ok>
18663
18664 =over 4
18665
18666 =item Conditional tests
18667
18668 B<SKIP: BLOCK>
18669
18670 =back
18671
18672 B<TODO: BLOCK>, B<todo_skip>
18673
18674 =over 4
18675
18676 =item Comparison functions
18677
18678 B<is_deeply>
18679
18680 =back
18681
18682 B<eq_array>
18683
18684 B<eq_hash>
18685
18686 B<eq_set>
18687
18688 =over 4
18689
18690 =item Extending and Embedding Test::More
18691
18692 B<builder>
18693
18694 =back
18695
18696 =over 4
18697
18698 =item NOTES
18699
18700 =item BUGS and CAVEATS
18701
18702 Making your own ok(), The eq_* family has some caveats, Test::Harness
18703 upgrades
18704
18705 =item HISTORY
18706
18707 =item SEE ALSO
18708
18709 =item AUTHORS
18710
18711 =item COPYRIGHT
18712
18713 =back
18714
18715 =head2 Test::Simple - Basic utilities for writing tests.
18716
18717 =over 4
18718
18719 =item SYNOPSIS
18720
18721 =item DESCRIPTION
18722
18723 B<ok>
18724
18725 =back
18726
18727 =over 4
18728
18729 =item EXAMPLE
18730
18731 =item CAVEATS
18732
18733 =item NOTES
18734
18735 =item HISTORY
18736
18737 =item SEE ALSO
18738
18739 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18740 L<Test::Harness>
18741
18742 =item AUTHORS
18743
18744 =item COPYRIGHT
18745
18746 =back
18747
18748 =head2 Test::Tutorial - A tutorial about writing really basic tests
18749
18750 =over 4
18751
18752 =item DESCRIPTION
18753
18754 =over 4
18755
18756 =item Nuts and bolts of testing.
18757
18758 =item Where to start?
18759
18760 =item Names
18761
18762 =item Test the manual
18763
18764 =item Sometimes the tests are wrong
18765
18766 =item Testing lots of values
18767
18768 =item Informative names
18769
18770 =item Skipping tests
18771
18772 =item Todo tests
18773
18774 =item Testing with taint mode.
18775
18776 =back
18777
18778 =item FOOTNOTES
18779
18780 =item AUTHORS
18781
18782 =item COPYRIGHT
18783
18784 =back
18785
18786 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18787
18788 =over 4
18789
18790 =item SYNOPSIS
18791
18792 =item DESCRIPTION
18793
18794 =item EXAMPLE
18795
18796 =back
18797
18798 =head2 Text::Balanced - Extract delimited text sequences from strings.
18799
18800 =over 4
18801
18802 =item SYNOPSIS
18803
18804 =item DESCRIPTION
18805
18806 =over 4
18807
18808 =item General behaviour in list contexts
18809
18810 [0], [1], [2]
18811
18812 =item General behaviour in scalar and void contexts
18813
18814 =item A note about prefixes
18815
18816 =item C<extract_delimited>
18817
18818 =item C<extract_bracketed>
18819
18820 =item C<extract_tagged>
18821
18822 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18823 [0], [1], [2], [3], [4], [5]
18824
18825 =item C<gen_extract_tagged>
18826
18827 =item C<extract_quotelike>
18828
18829 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18830
18831 =item C<extract_quotelike> and "here documents"
18832
18833 [0], [1], [2], [3], [4], [5], [6], [7..10]
18834
18835 =item C<extract_codeblock>
18836
18837 =item C<extract_multiple>
18838
18839 =item C<gen_delimited_pat>
18840
18841 =back
18842
18843 =item DIAGNOSTICS
18844
18845  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
18846 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18847 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
18848 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18849 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18850 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18851 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18852 after dereferencer>, C<Did not find expected opening bracket at %s>,
18853 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18854 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18855 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18856 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18857 tag>
18858
18859 =item AUTHOR
18860
18861 =item BUGS AND IRRITATIONS
18862
18863 =item COPYRIGHT
18864
18865 =back
18866
18867 =head2 Text::ParseWords - parse text into an array of tokens or array of
18868 arrays
18869
18870 =over 4
18871
18872 =item SYNOPSIS
18873
18874 =item DESCRIPTION
18875
18876 =item EXAMPLES
18877
18878 =item AUTHORS
18879
18880 =back
18881
18882 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18883 by Knuth
18884
18885 =over 4
18886
18887 =item SYNOPSIS
18888
18889 =item DESCRIPTION
18890
18891 =item EXAMPLES
18892
18893 =item LIMITATIONS
18894
18895 =item AUTHOR
18896
18897 =back
18898
18899 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18900 unexpand(1)
18901
18902 =over 4
18903
18904 =item SYNOPSIS
18905
18906 =item DESCRIPTION
18907
18908 =item BUGS
18909
18910 =item AUTHOR
18911
18912 =back
18913
18914 =head2 Text::Wrap - line wrapping to form simple paragraphs
18915
18916 =over 4
18917
18918 =item SYNOPSIS 
18919
18920 =item DESCRIPTION
18921
18922 =item OVERRIDES
18923
18924 =item EXAMPLE
18925
18926 =item AUTHOR
18927
18928 =back
18929
18930 =head2 Thread - manipulate threads in Perl (for old code only)
18931
18932 =over 4
18933
18934 =item CAVEAT
18935
18936 =item SYNOPSIS
18937
18938 =item DESCRIPTION
18939
18940 =item FUNCTIONS
18941
18942 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18943 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18944 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18945
18946 =item METHODS
18947
18948 join, eval, detach, equal, tid, flags, done
18949
18950 =item LIMITATIONS
18951
18952 =item SEE ALSO
18953
18954 =back
18955
18956 =head2 Thread::Queue - thread-safe queues (for old code only)
18957
18958 =over 4
18959
18960 =item CAVEAT
18961
18962 =item SYNOPSIS
18963
18964 =item DESCRIPTION
18965
18966 =item FUNCTIONS AND METHODS
18967
18968 new, enqueue LIST, dequeue, dequeue_nb, pending
18969
18970 =item SEE ALSO
18971
18972 =back
18973
18974 =head2 Thread::Semaphore - thread-safe semaphores (for old code only)
18975
18976 =over 4
18977
18978 =item CAVEAT
18979
18980 =item SYNOPSIS
18981
18982 =item DESCRIPTION
18983
18984 =item FUNCTIONS AND METHODS
18985
18986 new, new NUMBER, down, down NUMBER, up, up NUMBER
18987
18988 =back
18989
18990 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18991
18992 =over 4
18993
18994 =item SYNOPSIS
18995
18996 =item DESCRIPTION
18997
18998 =item BUGS
18999
19000 =back
19001
19002 =head2 Thread::Specific - thread-specific keys
19003
19004 =over 4
19005
19006 =item SYNOPSIS
19007
19008 =item DESCRIPTION
19009
19010 =back
19011
19012 =head2 Tie::Array - base class for tied arrays
19013
19014 =over 4
19015
19016 =item SYNOPSIS
19017
19018 =item DESCRIPTION
19019
19020 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19021 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19022 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19023 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19024
19025 =item CAVEATS
19026
19027 =item AUTHOR
19028
19029 =back
19030
19031 =head2 Tie::File - Access the lines of a disk file via a Perl array
19032
19033 =over 4
19034
19035 =item SYNOPSIS
19036
19037 =item DESCRIPTION
19038
19039 =over 4
19040
19041 =item C<recsep>
19042
19043 =item C<autochomp>
19044
19045 =item C<mode>
19046
19047 =item C<memory>
19048
19049 =item C<dw_size>
19050
19051 =item Option Format
19052
19053 =back
19054
19055 =item Public Methods
19056
19057 =over 4
19058
19059 =item C<flock>
19060
19061 =item C<autochomp>
19062
19063 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19064
19065 =back
19066
19067 =item Tying to an already-opened filehandle
19068
19069 =item Deferred Writing
19070
19071 =over 4
19072
19073 =item Autodeferring
19074
19075 =back
19076
19077 =item CAVEATS
19078
19079 =item SUBCLASSING
19080
19081 =item WHAT ABOUT C<DB_File>?
19082
19083 =item AUTHOR
19084
19085 =item LICENSE
19086
19087 =item WARRANTY
19088
19089 =item THANKS
19090
19091 =item TODO
19092
19093 =back
19094
19095 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19096 handles
19097
19098 =over 4
19099
19100 =item SYNOPSIS
19101
19102 =item DESCRIPTION
19103
19104 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19105 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19106 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19107 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19108
19109 =item MORE INFORMATION
19110
19111 =item COMPATIBILITY
19112
19113 =back
19114
19115 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19116 tied hashes
19117
19118 =over 4
19119
19120 =item SYNOPSIS
19121
19122 =item DESCRIPTION
19123
19124 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19125 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19126
19127 =item Inheriting from B<Tie::StdHash>
19128
19129 =item Inheriting from B<Tie::ExtraHash>
19130
19131 =item C<UNTIE> and C<DESTROY>
19132
19133 =item MORE INFORMATION
19134
19135 =back
19136
19137 =head2 Tie::Memoize - add data to hash when needed
19138
19139 =over 4
19140
19141 =item SYNOPSIS
19142
19143 =item DESCRIPTION
19144
19145 =item Inheriting from B<Tie::Memoize>
19146
19147 =item EXAMPLE
19148
19149 =item BUGS
19150
19151 =item AUTHOR
19152
19153 =back
19154
19155 =head2 Tie::RefHash - use references as hash keys
19156
19157 =over 4
19158
19159 =item SYNOPSIS
19160
19161 =item DESCRIPTION
19162
19163 =item EXAMPLE
19164
19165 =item AUTHOR
19166
19167 =item VERSION
19168
19169 =item SEE ALSO
19170
19171 =back
19172
19173 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19174 scalars
19175
19176 =over 4
19177
19178 =item SYNOPSIS
19179
19180 =item DESCRIPTION
19181
19182 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19183
19184 =item MORE INFORMATION
19185
19186 =back
19187
19188 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19189
19190 =over 4
19191
19192 =item SYNOPSIS
19193
19194 =item DESCRIPTION
19195
19196 =item CAVEATS
19197
19198 =back
19199
19200 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19201 timers
19202
19203 =over 4
19204
19205 =item SYNOPSIS
19206
19207 =item DESCRIPTION
19208
19209 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19210 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19211 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19212 getitimer ( $which )
19213
19214 =item EXAMPLES
19215
19216 =item C API
19217
19218 =item CAVEATS
19219
19220 =item AUTHORS
19221
19222 =item REVISION
19223
19224 =item COPYRIGHT
19225
19226 =back
19227
19228 =head2 Time::Local - efficiently compute time from local and GMT time
19229
19230 =over 4
19231
19232 =item SYNOPSIS
19233
19234 =item DESCRIPTION
19235
19236 =item IMPLEMENTATION
19237
19238 =item BUGS
19239
19240 =back
19241
19242 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19243 function
19244
19245 =over 4
19246
19247 =item SYNOPSIS
19248
19249 =item DESCRIPTION
19250
19251 =item NOTE
19252
19253 =item AUTHOR
19254
19255 =back
19256
19257 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19258 function
19259
19260 =over 4
19261
19262 =item SYNOPSIS
19263
19264 =item DESCRIPTION
19265
19266 =item NOTE
19267
19268 =item AUTHOR
19269
19270 =back
19271
19272 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19273
19274 =over 4
19275
19276 =item SYNOPSIS
19277
19278 =item DESCRIPTION
19279
19280 =item AUTHOR
19281
19282 =back
19283
19284 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19285
19286 =over 4
19287
19288 =item SYNOPSIS
19289
19290 =item DESCRIPTION
19291
19292 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19293 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19294
19295 =back
19296
19297 =head2 Unicode::Collate - Unicode Collation Algorithm
19298
19299 =over 4
19300
19301 =item SYNOPSIS
19302
19303 =item DESCRIPTION
19304
19305 =over 4
19306
19307 =item Constructor and Tailoring
19308
19309 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19310 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19311 undefChar, katakana_before_hiragana, upper_before_lower
19312
19313 =item Methods for Collation
19314
19315 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19316 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19317 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19318 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19319 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19320 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19321 $Collator-E<gt>viewSortKey($string)>, C<$position =
19322 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19323 $Collator-E<gt>index($string, $substring)>
19324
19325 =item Other Methods
19326
19327 UCA_Version, Base_Unicode_Version
19328
19329 =item EXPORT
19330
19331 =item TODO
19332
19333 =item CAVEAT
19334
19335 =item BUGS
19336
19337 =back
19338
19339 =item AUTHOR
19340
19341 =item SEE ALSO
19342
19343 http://www.unicode.org/unicode/reports/tr10/,
19344 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19345 http://www.unicode.org/unicode/reports/tr15/,
19346 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19347
19348 =back
19349
19350 =head2 Unicode::Normalize - Unicode Normalization Forms
19351
19352 =over 4
19353
19354 =item SYNOPSIS
19355
19356 =item DESCRIPTION
19357
19358 =over 4
19359
19360 =item Normalization Forms
19361
19362 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19363 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19364 C<$normalized_string = normalize($form_name, $string)>
19365
19366 =item Decomposition and Composition
19367
19368 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19369 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19370 reorder($string)>, C<$composed_string   = compose($string)>
19371
19372 =item Quick Check
19373
19374 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19375 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19376 check($form_name, $string)>
19377
19378 =item Character Data
19379
19380 C<$canonical_decomposed = getCanon($codepoint)>,
19381 C<$compatibility_decomposed = getCompat($codepoint)>,
19382 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19383 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19384 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19385 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19386 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19387
19388 =item EXPORT
19389
19390 =back
19391
19392 =item AUTHOR
19393
19394 =item SEE ALSO
19395
19396 http://www.unicode.org/unicode/reports/tr15/,
19397 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19398
19399 =back
19400
19401 =head2 Unicode::UCD - Unicode character database
19402
19403 =over 4
19404
19405 =item SYNOPSIS
19406
19407 =item DESCRIPTION
19408
19409 =back
19410
19411 =over 4
19412
19413 =item charinfo
19414
19415 =back
19416
19417 =over 4
19418
19419 =item charblock
19420
19421 =back
19422
19423 =over 4
19424
19425 =item charscript
19426
19427 =back
19428
19429 =over 4
19430
19431 =item charblocks
19432
19433 =back
19434
19435 =over 4
19436
19437 =item charscripts
19438
19439 =back
19440
19441 =over 4
19442
19443 =item Blocks versus Scripts
19444
19445 =item Matching Scripts and Blocks
19446
19447 =item Code Point Arguments
19448
19449 =item charinrange
19450
19451 =back
19452
19453 =over 4
19454
19455 =item compexcl
19456
19457 =back
19458
19459 =over 4
19460
19461 =item casefold
19462
19463 =back
19464
19465 =over 4
19466
19467 =item casespec
19468
19469 =back
19470
19471 =over 4
19472
19473 =item Unicode::UCD::UnicodeVersion
19474
19475 =back
19476
19477 =over 4
19478
19479 =item Implementation Note
19480
19481 =back
19482
19483 =over 4
19484
19485 =item BUGS
19486
19487 =item AUTHOR
19488
19489 =back
19490
19491 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19492 functions
19493
19494 =over 4
19495
19496 =item SYNOPSIS
19497
19498 =item DESCRIPTION
19499
19500 =item NOTE
19501
19502 =item AUTHOR
19503
19504 =back
19505
19506 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19507 functions
19508
19509 =over 4
19510
19511 =item SYNOPSIS
19512
19513 =item DESCRIPTION
19514
19515 =over 4
19516
19517 =item System Specifics
19518
19519 =back
19520
19521 =item NOTE
19522
19523 =item AUTHOR
19524
19525 =item HISTORY
19526
19527 March 18th, 2000
19528
19529 =back
19530
19531 =head2 Win32 - Interfaces to some Win32 API Functions
19532
19533 =over 4
19534
19535 =item DESCRIPTION
19536
19537 =over 4
19538
19539 =item Alphabetical Listing of Win32 Functions
19540
19541 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19542 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19543 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19544 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19545 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19546 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19547 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19548 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19549 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19550 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19551 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19552 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19553 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19554 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19555 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19556 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19557 Win32::UnregisterServer(LIBRARYNAME)
19558
19559 =back
19560
19561 =back
19562
19563 =head2 XS::APItest - Test the perl C API
19564
19565 =over 4
19566
19567 =item SYNOPSIS
19568
19569 =item ABSTRACT
19570
19571 =item DESCRIPTION
19572
19573 =over 4
19574
19575 =item EXPORT
19576
19577 B<print_double>, B<print_long_double>, B<have_long_double>, B<print_nv>,
19578 B<print_iv>, B<print_uv>, B<print_int>, B<print_long>, B<print_float>
19579
19580 =back
19581
19582 =item SEE ALSO
19583
19584 =item AUTHORS
19585
19586 =item COPYRIGHT AND LICENSE
19587
19588 =back
19589
19590 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
19591
19592 =over 4
19593
19594 =item SYNOPSIS
19595
19596 =item DESCRIPTION
19597
19598 =back
19599
19600 =over 4
19601
19602 =item NOTES
19603
19604 =item AUTHOR
19605
19606 =back
19607
19608 =head2 XSLoader - Dynamically load C libraries into Perl code
19609
19610 =over 4
19611
19612 =item SYNOPSIS
19613
19614 =item DESCRIPTION
19615
19616 =item AUTHOR
19617
19618 =back
19619
19620 =head1 AUXILIARY DOCUMENTATION
19621
19622 Here should be listed all the extra programs' documentation, but they
19623 don't all have manual pages yet:
19624
19625 =over 4
19626
19627 =item a2p
19628
19629 =item s2p
19630
19631 =item find2perl
19632
19633 =item h2ph
19634
19635 =item c2ph
19636
19637 =item h2xs
19638
19639 =item xsubpp
19640
19641 =item pod2man
19642
19643 =item wrapsuid
19644
19645 =back
19646
19647 =head1 AUTHOR
19648
19649 Larry Wall <F<larry@wall.org>>, with the help of oodles
19650 of other folks.
19651