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