Constant.t for EBCDIC platforms
[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 EXPR : ATTRIBUTES,
432 next LABEL, next, no Module VERSION LIST, no Module VERSION, no Module
433 LIST, no Module, oct EXPR, oct, open FILEHANDLE,EXPR, open
434 FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
435 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
436 EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package
437 NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
438 SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
439 FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
440 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
441 quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
442 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
443 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
444 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
445 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
446 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
447 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
448 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
449 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
450 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
451 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
452 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
453 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
454 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
455 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
456 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
457 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
458 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
459 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
460 study, sub BLOCK, sub NAME, sub NAME BLOCK, substr
461 EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
462 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
463 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
464 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
465 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
466 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
467 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
468 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
469 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
470 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
471 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
472 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
473 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
474 LIST, write FILEHANDLE, write EXPR, write, y///
475
476 =back
477
478 =back
479
480 =head2 perlreftut - Mark's very short tutorial about references
481
482 =over 4
483
484 =item DESCRIPTION
485
486 =item Who Needs Complicated Data Structures?
487
488 =item The Solution
489
490 =item Syntax
491
492 =over 4
493
494 =item Making References
495
496 =item Using References
497
498 =back
499
500 =item An Example
501
502 =item Arrow Rule
503
504 =item Solution
505
506 =item The Rest
507
508 =item Summary
509
510 =item Credits
511
512 =over 4
513
514 =item Distribution Conditions
515
516 =back
517
518 =back
519
520 =head2 perldsc - Perl Data Structures Cookbook
521
522 =over 4
523
524 =item DESCRIPTION
525
526 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
527 more elaborate constructs
528
529 =item REFERENCES
530
531 =item COMMON MISTAKES
532
533 =item CAVEAT ON PRECEDENCE
534
535 =item WHY YOU SHOULD ALWAYS C<use strict>
536
537 =item DEBUGGING
538
539 =item CODE EXAMPLES
540
541 =item ARRAYS OF ARRAYS
542
543 =over 4
544
545 =item Declaration of an ARRAY OF ARRAYS
546
547 =item Generation of an ARRAY OF ARRAYS
548
549 =item Access and Printing of an ARRAY OF ARRAYS
550
551 =back
552
553 =item HASHES OF ARRAYS
554
555 =over 4
556
557 =item Declaration of a HASH OF ARRAYS
558
559 =item Generation of a HASH OF ARRAYS
560
561 =item Access and Printing of a HASH OF ARRAYS
562
563 =back
564
565 =item ARRAYS OF HASHES
566
567 =over 4
568
569 =item Declaration of an ARRAY OF HASHES
570
571 =item Generation of an ARRAY OF HASHES
572
573 =item Access and Printing of an ARRAY OF HASHES
574
575 =back
576
577 =item HASHES OF HASHES
578
579 =over 4
580
581 =item Declaration of a HASH OF HASHES
582
583 =item Generation of a HASH OF HASHES
584
585 =item Access and Printing of a HASH OF HASHES
586
587 =back
588
589 =item MORE ELABORATE RECORDS
590
591 =over 4
592
593 =item Declaration of MORE ELABORATE RECORDS
594
595 =item Declaration of a HASH OF COMPLEX RECORDS
596
597 =item Generation of a HASH OF COMPLEX RECORDS
598
599 =back
600
601 =item Database Ties
602
603 =item SEE ALSO
604
605 =item AUTHOR
606
607 =back
608
609 =head2 perlrequick - Perl regular expressions quick start
610
611 =over 4
612
613 =item DESCRIPTION
614
615 =item The Guide
616
617 =over 4
618
619 =item Simple word matching
620
621 =item Using character classes
622
623 =item Matching this or that
624
625 =item Grouping things and hierarchical matching
626
627 =item Extracting matches
628
629 =item Matching repetitions
630
631 =item More matching
632
633 =item Search and replace
634
635 =item The split operator
636
637 =back
638
639 =item BUGS
640
641 =item SEE ALSO
642
643 =item AUTHOR AND COPYRIGHT
644
645 =over 4
646
647 =item Acknowledgments
648
649 =back
650
651 =back
652
653 =head2 perlpod - the Plain Old Documentation format
654
655 =over 4
656
657 =item DESCRIPTION
658
659 =over 4
660
661 =item Ordinary Paragraph
662
663 =item Verbatim Paragraph
664
665 =item Command Paragraph
666
667 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
668 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
669 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
670 I<formatname>>, C<=for I<formatname> I<text...>>
671
672 =item Formatting Codes
673
674 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
675 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
676 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
677 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
678 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
679 (zero-effect) formatting code
680
681 =item The Intent
682
683 =item Embedding Pods in Perl Modules
684
685 =item Hints for Writing Pod
686
687 =back
688
689 =item SEE ALSO
690
691 =item AUTHOR
692
693 =back
694
695 =head2 perlpodspec - Plain Old Documentation: format specification and
696 notes
697
698 =over 4
699
700 =item DESCRIPTION
701
702 =item Pod Definitions
703
704 =item Pod Commands
705
706 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
707 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
708
709 =item Pod Formatting Codes
710
711 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
712 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
713 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
714 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
715 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
716 contains non-breaking spaces
717
718 =item Notes on Implementing Pod Processors
719
720 =item About LE<lt>...E<gt> Codes
721
722 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
723
724 =item About =over...=back Regions
725
726 =item About Data Paragraphs and "=begin/=end" Regions
727
728 =item SEE ALSO
729
730 =item AUTHOR
731
732 =back
733
734 =head2 perlstyle - Perl style guide
735
736 =over 4
737
738 =item DESCRIPTION
739
740 =back
741
742 =head2 perltrap - Perl traps for the unwary
743
744 =over 4
745
746 =item DESCRIPTION
747
748 =over 4
749
750 =item Awk Traps
751
752 =item C Traps
753
754 =item Sed Traps
755
756 =item Shell Traps
757
758 =item Perl Traps
759
760 =item Perl4 to Perl5 Traps
761
762 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
763 Traps, General data type traps, Context Traps - scalar, list contexts,
764 Precedence Traps, General Regular Expression Traps using s///, etc,
765 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
766
767 =item Discontinuance, Deprecation, and BugFix traps
768
769 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
770 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
771 Discontinuance, Deprecation, Discontinuance, Discontinuance
772
773 =item Parsing Traps
774
775 Parsing, Parsing, Parsing, Parsing, Parsing
776
777 =item Numerical Traps
778
779 Numerical, Numerical, Numerical, Bitwise string ops
780
781 =item General data type traps
782
783 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
784 (Constants), (Scalars), (Variable Suicide)
785
786 =item Context Traps - scalar, list contexts
787
788 (list context), (scalar context), (scalar context), (list, builtin)
789
790 =item Precedence Traps
791
792 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
793 Precedence
794
795 =item General Regular Expression Traps using s///, etc.
796
797 Regular Expression, Regular Expression, Regular Expression, Regular
798 Expression, Regular Expression, Regular Expression, Regular Expression,
799 Regular Expression
800
801 =item Subroutine, Signal, Sorting Traps
802
803 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
804
805 =item OS Traps
806
807 (SysV), (SysV)
808
809 =item Interpolation Traps
810
811 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
812 Interpolation, Interpolation, Interpolation, Interpolation
813
814 =item DBM Traps
815
816 DBM, DBM
817
818 =item Unclassified Traps
819
820 C<require>/C<do> trap using returned value, C<split> on empty string with
821 LIMIT specified
822
823 =back
824
825 =back
826
827 =head2 perlrun - how to execute the Perl interpreter
828
829 =over 4
830
831 =item SYNOPSIS
832
833 =item DESCRIPTION
834
835 =over 4
836
837 =item #! and quoting on non-Unix systems
838
839 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
840
841 =item Location of Perl
842
843 =item Command Switches
844
845 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
846 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
847 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
848 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
849 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
850 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
851 B<-X>, B<-x> I<directory>
852
853 =back
854
855 =item ENVIRONMENT
856
857 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
858 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
859 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
860 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
861 SYS$LOGIN (specific to the VMS port)
862
863 =back
864
865 =head2 perldiag - various Perl diagnostics
866
867 =over 4
868
869 =item DESCRIPTION
870
871 =back
872
873 =head2 perllexwarn - Perl Lexical Warnings
874
875 =over 4
876
877 =item DESCRIPTION
878
879 =over 4
880
881 =item Default Warnings and Optional Warnings
882
883 =item What's wrong with B<-w> and C<$^W>
884
885 =item Controlling Warnings from the Command Line
886
887 B<-w>, B<-W>, B<-X>
888
889 =item Backward Compatibility
890
891 =item Category Hierarchy
892
893 =item Fatal Warnings
894
895 =item Reporting Warnings from a Module
896
897 =back
898
899 =item TODO
900
901 =item SEE ALSO
902
903 =item AUTHOR
904
905 =back
906
907 =head2 perldebtut - Perl debugging tutorial
908
909 =over 4
910
911 =item DESCRIPTION
912
913 =item use strict
914
915 =item Looking at data and -w and v
916
917 =item help
918
919 =item Stepping through code
920
921 =item Placeholder for a, w, t, T
922
923 =item REGULAR EXPRESSIONS
924
925 =item OUTPUT TIPS
926
927 =item CGI
928
929 =item GUIs
930
931 =item SUMMARY
932
933 =item SEE ALSO
934
935 =item AUTHOR
936
937 =item CONTRIBUTORS
938
939 =back
940
941 =head2 perldebug - Perl debugging
942
943 =over 4
944
945 =item DESCRIPTION
946
947 =item The Perl Debugger
948
949 =over 4
950
951 =item Debugger Commands
952
953 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
954 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
955 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
956 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
957 subname [condition], b postpone subname [condition], b load filename, b
958 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
959 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
960 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
961 command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or
962 ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
963
964 =item Configurable Options
965
966 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
967 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
968 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
969 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
970 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
971 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
972 C<NonStop>
973
974 =item Debugger input/output
975
976 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
977 listing
978
979 =item Debugging compile-time statements
980
981 =item Debugger Customization
982
983 =item Readline Support
984
985 =item Editor Support for Debugging
986
987 =item The Perl Profiler
988
989 =back
990
991 =item Debugging regular expressions
992
993 =item Debugging memory usage
994
995 =item SEE ALSO
996
997 =item BUGS
998
999 =back
1000
1001 =head2 perlvar - Perl predefined variables
1002
1003 =over 4
1004
1005 =item DESCRIPTION
1006
1007 =over 4
1008
1009 =item Predefined Names
1010
1011 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1012 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1013 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1014 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1015 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1016 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1017 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1018 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1019 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1020 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1021 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1022 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1023 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1024 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1025 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1026 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1027 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1028 IO::Handle->format_line_break_characters EXPR,
1029 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1030 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1031 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1032 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1033 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1034 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1035 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1036 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1037 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1038 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1039 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1040 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1041
1042 =item Error Indicators
1043
1044 =item Technical Note on the Syntax of Variable Names
1045
1046 =back
1047
1048 =item BUGS
1049
1050 =back
1051
1052 =head2 perllol - Manipulating Arrays of Arrays in Perl
1053
1054 =over 4
1055
1056 =item DESCRIPTION
1057
1058 =over 4
1059
1060 =item Declaration and Access of Arrays of Arrays
1061
1062 =item Growing Your Own
1063
1064 =item Access and Printing
1065
1066 =item Slices
1067
1068 =back
1069
1070 =item SEE ALSO
1071
1072 =item AUTHOR
1073
1074 =back
1075
1076 =head2 perlopentut - tutorial on opening things in Perl
1077
1078 =over 4
1079
1080 =item DESCRIPTION
1081
1082 =item Open E<agrave> la shell
1083
1084 =over 4
1085
1086 =item Simple Opens
1087
1088 =item Pipe Opens
1089
1090 =item The Minus File
1091
1092 =item Mixing Reads and Writes
1093
1094 =item Filters 
1095
1096 =back
1097
1098 =item Open E<agrave> la C
1099
1100 =over 4
1101
1102 =item Permissions E<agrave> la mode
1103
1104 =back
1105
1106 =item Obscure Open Tricks
1107
1108 =over 4
1109
1110 =item Re-Opening Files (dups)
1111
1112 =item Dispelling the Dweomer
1113
1114 =item Paths as Opens
1115
1116 =item Single Argument Open
1117
1118 =item Playing with STDIN and STDOUT
1119
1120 =back
1121
1122 =item Other I/O Issues
1123
1124 =over 4
1125
1126 =item Opening Non-File Files
1127
1128 =item Binary Files
1129
1130 =item File Locking
1131
1132 =back
1133
1134 =item SEE ALSO 
1135
1136 =item AUTHOR and COPYRIGHT
1137
1138 =item HISTORY
1139
1140 =back
1141
1142 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1143
1144 =over 4
1145
1146 =item DESCRIPTION
1147
1148 =item The Basic Principle
1149
1150 =item Packing Text
1151
1152 =item Packing Numbers
1153
1154 =over 4
1155
1156 =item Integers
1157
1158 =item Unpacking a Stack Frame
1159
1160 =item How to Eat an Egg on a Net
1161
1162 =item Floating point Numbers
1163
1164 =back
1165
1166 =item Exotic Templates
1167
1168 =over 4
1169
1170 =item Bit Strings
1171
1172 =item Uuencoding
1173
1174 =item Doing Sums
1175
1176 =item  Unicode
1177
1178 =item Another Portable Binary Encoding
1179
1180 =back
1181
1182 =item Lengths and Widths
1183
1184 =over 4
1185
1186 =item String Lengths
1187
1188 =item Dynamic Templates
1189
1190 =back
1191
1192 =item Packing and Unpacking C Structures
1193
1194 =over 4
1195
1196 =item The Alignment Pit
1197
1198 =item Alignment, Take 2
1199
1200 =item Alignment, Take 3
1201
1202 =item Pointers for How to Use Them
1203
1204 =back
1205
1206 =item Pack Recipes
1207
1208 =item Funnies Section
1209
1210 =item Authors
1211
1212 =back
1213
1214 =head2 perlretut - Perl regular expressions tutorial
1215
1216 =over 4
1217
1218 =item DESCRIPTION
1219
1220 =item Part 1: The basics
1221
1222 =over 4
1223
1224 =item Simple word matching
1225
1226 =item Using character classes
1227
1228 =item Matching this or that
1229
1230 =item Grouping things and hierarchical matching
1231
1232 =item Extracting matches
1233
1234 =item Matching repetitions
1235
1236 =item Building a regexp
1237
1238 =item Using regular expressions in Perl
1239
1240 =back
1241
1242 =item Part 2: Power tools
1243
1244 =over 4
1245
1246 =item More on characters, strings, and character classes
1247
1248 =item Compiling and saving regular expressions
1249
1250 =item Embedding comments and modifiers in a regular expression
1251
1252 =item Non-capturing groupings
1253
1254 =item Looking ahead and looking behind
1255
1256 =item Using independent subexpressions to prevent backtracking
1257
1258 =item Conditional expressions
1259
1260 =item A bit of magic: executing Perl code in a regular expression
1261
1262 =item Pragmas and debugging
1263
1264 =back
1265
1266 =item BUGS
1267
1268 =item SEE ALSO
1269
1270 =item AUTHOR AND COPYRIGHT
1271
1272 =over 4
1273
1274 =item Acknowledgments
1275
1276 =back
1277
1278 =back
1279
1280 =head2 perlre - Perl regular expressions
1281
1282 =over 4
1283
1284 =item DESCRIPTION
1285
1286 i, m, s, x
1287
1288 =over 4
1289
1290 =item Regular Expressions
1291
1292 [1], [2], [3], cntrl, graph, print, punct, xdigit
1293
1294 =item Extended Patterns
1295
1296 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1297 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1298 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1299 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1300
1301 =item Backtracking
1302
1303 =item Version 8 Regular Expressions
1304
1305 =item Warning on \1 vs $1
1306
1307 =item Repeated patterns matching zero-length substring
1308
1309 =item Combining pieces together
1310
1311 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1312 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1313 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1314 C<(?(condition)yes-pattern|no-pattern)>
1315
1316 =item Creating custom RE engines
1317
1318 =back
1319
1320 =item BUGS
1321
1322 =item SEE ALSO
1323
1324 =back
1325
1326 =head2 perlref - Perl references and nested data structures
1327
1328 =over 4
1329
1330 =item NOTE
1331
1332 =item DESCRIPTION
1333
1334 =over 4
1335
1336 =item Making References
1337
1338 =item Using References
1339
1340 =item Symbolic references
1341
1342 =item Not-so-symbolic references
1343
1344 =item Pseudo-hashes: Using an array as a hash
1345
1346 =item Function Templates
1347
1348 =back
1349
1350 =item WARNING
1351
1352 =item SEE ALSO
1353
1354 =back
1355
1356 =head2 perlform - Perl formats
1357
1358 =over 4
1359
1360 =item DESCRIPTION
1361
1362 =over 4
1363
1364 =item Format Variables
1365
1366 =back
1367
1368 =item NOTES
1369
1370 =over 4
1371
1372 =item Footers
1373
1374 =item Accessing Formatting Internals
1375
1376 =back
1377
1378 =item WARNINGS
1379
1380 =back
1381
1382 =head2 perlboot - Beginner's Object-Oriented Tutorial
1383
1384 =over 4
1385
1386 =item DESCRIPTION
1387
1388 =over 4
1389
1390 =item If we could talk to the animals...
1391
1392 =item Introducing the method invocation arrow
1393
1394 =item Invoking a barnyard
1395
1396 =item The extra parameter of method invocation
1397
1398 =item Calling a second method to simplify things
1399
1400 =item Inheriting the windpipes
1401
1402 =item A few notes about @ISA
1403
1404 =item Overriding the methods
1405
1406 =item Starting the search from a different place
1407
1408 =item The SUPER way of doing things
1409
1410 =item Where we're at so far...
1411
1412 =item A horse is a horse, of course of course -- or is it?
1413
1414 =item Invoking an instance method
1415
1416 =item Accessing the instance data
1417
1418 =item How to build a horse
1419
1420 =item Inheriting the constructor
1421
1422 =item Making a method work with either classes or instances
1423
1424 =item Adding parameters to a method
1425
1426 =item More interesting instances
1427
1428 =item A horse of a different color
1429
1430 =item Summary
1431
1432 =back
1433
1434 =item SEE ALSO
1435
1436 =item COPYRIGHT
1437
1438 =back
1439
1440 =head2 perltoot - Tom's object-oriented tutorial for perl
1441
1442 =over 4
1443
1444 =item DESCRIPTION
1445
1446 =item Creating a Class
1447
1448 =over 4
1449
1450 =item Object Representation
1451
1452 =item Class Interface
1453
1454 =item Constructors and Instance Methods
1455
1456 =item Planning for the Future: Better Constructors
1457
1458 =item Destructors
1459
1460 =item Other Object Methods
1461
1462 =back
1463
1464 =item Class Data
1465
1466 =over 4
1467
1468 =item Accessing Class Data
1469
1470 =item Debugging Methods
1471
1472 =item Class Destructors
1473
1474 =item Documenting the Interface
1475
1476 =back
1477
1478 =item Aggregation
1479
1480 =item Inheritance
1481
1482 =over 4
1483
1484 =item Overridden Methods
1485
1486 =item Multiple Inheritance
1487
1488 =item UNIVERSAL: The Root of All Objects
1489
1490 =back
1491
1492 =item Alternate Object Representations
1493
1494 =over 4
1495
1496 =item Arrays as Objects
1497
1498 =item Closures as Objects
1499
1500 =back
1501
1502 =item AUTOLOAD: Proxy Methods
1503
1504 =over 4
1505
1506 =item Autoloaded Data Methods
1507
1508 =item Inherited Autoloaded Data Methods
1509
1510 =back
1511
1512 =item Metaclassical Tools
1513
1514 =over 4
1515
1516 =item Class::Struct
1517
1518 =item Data Members as Variables
1519
1520 =back
1521
1522 =item NOTES
1523
1524 =over 4
1525
1526 =item Object Terminology
1527
1528 =back
1529
1530 =item SEE ALSO
1531
1532 =item AUTHOR AND COPYRIGHT
1533
1534 =item COPYRIGHT
1535
1536 =over 4
1537
1538 =item Acknowledgments
1539
1540 =back
1541
1542 =back
1543
1544 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1545
1546 =over 4
1547
1548 =item DESCRIPTION
1549
1550 =item Class Data in a Can
1551
1552 =item Class Data as Package Variables
1553
1554 =over 4
1555
1556 =item Putting All Your Eggs in One Basket
1557
1558 =item Inheritance Concerns
1559
1560 =item The Eponymous Meta-Object
1561
1562 =item Indirect References to Class Data
1563
1564 =item Monadic Classes
1565
1566 =item Translucent Attributes
1567
1568 =back
1569
1570 =item Class Data as Lexical Variables
1571
1572 =over 4
1573
1574 =item Privacy and Responsibility 
1575
1576 =item File-Scoped Lexicals
1577
1578 =item More Inheritance Concerns
1579
1580 =item Locking the Door and Throwing Away the Key
1581
1582 =item Translucency Revisited
1583
1584 =back
1585
1586 =item NOTES
1587
1588 =item SEE ALSO
1589
1590 =item AUTHOR AND COPYRIGHT
1591
1592 =item ACKNOWLEDGEMENTS
1593
1594 =item HISTORY
1595
1596 =back
1597
1598 =head2 perlobj - Perl objects
1599
1600 =over 4
1601
1602 =item DESCRIPTION
1603
1604 =over 4
1605
1606 =item An Object is Simply a Reference
1607
1608 =item A Class is Simply a Package
1609
1610 =item A Method is Simply a Subroutine
1611
1612 =item Method Invocation
1613
1614 =item Indirect Object Syntax
1615
1616 =item Default UNIVERSAL methods
1617
1618 isa(CLASS), can(METHOD), VERSION( [NEED] )
1619
1620 =item Destructors
1621
1622 =item Summary
1623
1624 =item Two-Phased Garbage Collection
1625
1626 =back
1627
1628 =item SEE ALSO
1629
1630 =back
1631
1632 =head2 perlbot - Bag'o Object Tricks (the BOT)
1633
1634 =over 4
1635
1636 =item DESCRIPTION
1637
1638 =item OO SCALING TIPS
1639
1640 =item INSTANCE VARIABLES
1641
1642 =item SCALAR INSTANCE VARIABLES
1643
1644 =item INSTANCE VARIABLE INHERITANCE
1645
1646 =item OBJECT RELATIONSHIPS
1647
1648 =item OVERRIDING SUPERCLASS METHODS
1649
1650 =item USING RELATIONSHIP WITH SDBM
1651
1652 =item THINKING OF CODE REUSE
1653
1654 =item CLASS CONTEXT AND THE OBJECT
1655
1656 =item INHERITING A CONSTRUCTOR
1657
1658 =item DELEGATION
1659
1660 =back
1661
1662 =head2 perltie - how to hide an object class in a simple variable
1663
1664 =over 4
1665
1666 =item SYNOPSIS
1667
1668 =item DESCRIPTION
1669
1670 =over 4
1671
1672 =item Tying Scalars
1673
1674 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1675 DESTROY this
1676
1677 =item Tying Arrays
1678
1679 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1680 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1681 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1682 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1683 this
1684
1685 =item Tying Hashes
1686
1687 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1688 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1689 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1690
1691 =item Tying FileHandles
1692
1693 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1694 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1695 DESTROY this
1696
1697 =item UNTIE this
1698
1699 =item The C<untie> Gotcha
1700
1701 =back
1702
1703 =item SEE ALSO
1704
1705 =item BUGS
1706
1707 =item AUTHOR
1708
1709 =back
1710
1711 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1712 safe subprocesses, sockets, and semaphores)
1713
1714 =over 4
1715
1716 =item DESCRIPTION
1717
1718 =item Signals
1719
1720 =over 4
1721
1722 =item Handling the SIGHUP Signal in Daemons
1723
1724 =back
1725
1726 =item Named Pipes
1727
1728 =over 4
1729
1730 =item Deferred Signals
1731
1732 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1733 triggered by operating system state
1734
1735 =back
1736
1737 =item Using open() for IPC
1738
1739 =over 4
1740
1741 =item Filehandles
1742
1743 =item Background Processes
1744
1745 =item Complete Dissociation of Child from Parent
1746
1747 =item Safe Pipe Opens
1748
1749 =item Bidirectional Communication with Another Process
1750
1751 =item Bidirectional Communication with Yourself
1752
1753 =back
1754
1755 =item Sockets: Client/Server Communication
1756
1757 =over 4
1758
1759 =item Internet Line Terminators
1760
1761 =item Internet TCP Clients and Servers
1762
1763 =item Unix-Domain TCP Clients and Servers
1764
1765 =back
1766
1767 =item TCP Clients with IO::Socket
1768
1769 =over 4
1770
1771 =item A Simple Client
1772
1773 C<Proto>, C<PeerAddr>, C<PeerPort>
1774
1775 =item A Webget Client
1776
1777 =item Interactive Client with IO::Socket
1778
1779 =back
1780
1781 =item TCP Servers with IO::Socket
1782
1783 Proto, LocalPort, Listen, Reuse
1784
1785 =item UDP: Message Passing
1786
1787 =item SysV IPC
1788
1789 =item NOTES
1790
1791 =item BUGS
1792
1793 =item AUTHOR
1794
1795 =item SEE ALSO
1796
1797 =back
1798
1799 =head2 perlfork - Perl's fork() emulation
1800
1801 =over 4
1802
1803 =item SYNOPSIS
1804
1805 =item DESCRIPTION
1806
1807 =over 4
1808
1809 =item Behavior of other Perl features in forked pseudo-processes
1810
1811 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1812 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1813 files, directories and network sockets
1814
1815 =item Resource limits
1816
1817 =item Killing the parent process
1818
1819 =item Lifetime of the parent process and pseudo-processes
1820
1821 =item CAVEATS AND LIMITATIONS
1822
1823 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1824 Global state maintained by XSUBs, Interpreter embedded in larger
1825 application, Thread-safety of extensions
1826
1827 =back
1828
1829 =item BUGS
1830
1831 =item AUTHOR
1832
1833 =item SEE ALSO
1834
1835 =back
1836
1837 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1838
1839 =over 4
1840
1841 =item SYNOPSIS
1842
1843 =item DESCRIPTION
1844
1845 =item Storing numbers
1846
1847 =item Numeric operators and numeric conversions
1848
1849 =item Flavors of Perl numeric operations
1850
1851 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1852 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1853 integer>, Operators which expect an integer, Operators which expect a
1854 string
1855
1856 =item AUTHOR
1857
1858 =item SEE ALSO
1859
1860 =back
1861
1862 =head2 perlthrtut - tutorial on threads in Perl
1863
1864 =over 4
1865
1866 =item DESCRIPTION
1867
1868 =item Status
1869
1870 =item What Is A Thread Anyway?
1871
1872 =item Threaded Program Models
1873
1874 =over 4
1875
1876 =item Boss/Worker
1877
1878 =item Work Crew
1879
1880 =item Pipeline
1881
1882 =back
1883
1884 =item Native threads
1885
1886 =item What kind of threads are Perl threads?
1887
1888 =item Threadsafe Modules
1889
1890 =item Thread Basics
1891
1892 =over 4
1893
1894 =item Basic Thread Support
1895
1896 =item A Note about the Examples
1897
1898 =item Creating Threads
1899
1900 =item Giving up control
1901
1902 =item Waiting For A Thread To Exit
1903
1904 =item Ignoring A Thread
1905
1906 =back
1907
1908 =item Threads And Data
1909
1910 =over 4
1911
1912 =item Shared And Unshared Data
1913
1914 =item Thread Pitfalls: Races
1915
1916 =back
1917
1918 =item Synchronization and control
1919
1920 =over 4
1921
1922 =item Controlling access: lock()
1923
1924 =item A Thread Pitfall: Deadlocks
1925
1926 =item Queues: Passing Data Around
1927
1928 =item Semaphores: Synchronizing Data Access
1929
1930 =item Basic semaphores
1931
1932 =item Advanced Semaphores
1933
1934 =item cond_wait() and cond_signal()
1935
1936 =back
1937
1938 =item General Thread Utility Routines
1939
1940 =over 4
1941
1942 =item What Thread Am I In?
1943
1944 =item Thread IDs
1945
1946 =item Are These Threads The Same?
1947
1948 =item What Threads Are Running?
1949
1950 =back
1951
1952 =item A Complete Example
1953
1954 =item Performance considerations
1955
1956 =item Threadsafety of System Libraries
1957
1958 =item Conclusion
1959
1960 =item Bibliography
1961
1962 =over 4
1963
1964 =item Introductory Texts
1965
1966 =item OS-Related References
1967
1968 =item Other References
1969
1970 =back
1971
1972 =item Acknowledgements
1973
1974 =item AUTHOR
1975
1976 =item Copyrights
1977
1978 =back
1979
1980 =head2 perlothrtut - old tutorial on threads in Perl
1981
1982 =over 4
1983
1984 =item DESCRIPTION
1985
1986 =item What Is A Thread Anyway?
1987
1988 =item Threaded Program Models
1989
1990 =over 4
1991
1992 =item Boss/Worker
1993
1994 =item Work Crew
1995
1996 =item Pipeline
1997
1998 =back
1999
2000 =item Native threads
2001
2002 =item What kind of threads are perl threads?
2003
2004 =item Threadsafe Modules
2005
2006 =item Thread Basics
2007
2008 =over 4
2009
2010 =item Basic Thread Support
2011
2012 =item Creating Threads
2013
2014 =item Giving up control
2015
2016 =item Waiting For A Thread To Exit
2017
2018 =item Errors In Threads
2019
2020 =item Ignoring A Thread
2021
2022 =back
2023
2024 =item Threads And Data
2025
2026 =over 4
2027
2028 =item Shared And Unshared Data
2029
2030 =item Thread Pitfall: Races
2031
2032 =item Controlling access: lock()
2033
2034 =item Thread Pitfall: Deadlocks
2035
2036 =item Queues: Passing Data Around
2037
2038 =back
2039
2040 =item Threads And Code
2041
2042 =over 4
2043
2044 =item Semaphores: Synchronizing Data Access
2045
2046 Basic semaphores, Advanced Semaphores
2047
2048 =item Attributes: Restricting Access To Subroutines
2049
2050 =item Subroutine Locks
2051
2052 =item Methods
2053
2054 =item Locking A Subroutine
2055
2056 =back
2057
2058 =item General Thread Utility Routines
2059
2060 =over 4
2061
2062 =item What Thread Am I In?
2063
2064 =item Thread IDs
2065
2066 =item Are These Threads The Same?
2067
2068 =item What Threads Are Running?
2069
2070 =back
2071
2072 =item A Complete Example
2073
2074 =item Conclusion
2075
2076 =item Bibliography
2077
2078 =over 4
2079
2080 =item Introductory Texts
2081
2082 =item OS-Related References
2083
2084 =item Other References
2085
2086 =back
2087
2088 =item Acknowledgements
2089
2090 =item AUTHOR
2091
2092 =item Copyrights
2093
2094 =back
2095
2096 =head2 perlport - Writing portable Perl
2097
2098 =over 4
2099
2100 =item DESCRIPTION
2101
2102 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2103 portable
2104
2105 =item ISSUES
2106
2107 =over 4
2108
2109 =item Newlines
2110
2111 =item Numbers endianness and Width
2112
2113 =item Files and Filesystems
2114
2115 =item System Interaction
2116
2117 =item Command names versus file pathnames
2118
2119 =item Interprocess Communication (IPC)
2120
2121 =item External Subroutines (XS)
2122
2123 =item Standard Modules
2124
2125 =item Time and Date
2126
2127 =item Character sets and character encoding
2128
2129 =item Internationalisation
2130
2131 =item System Resources
2132
2133 =item Security
2134
2135 =item Style
2136
2137 =back
2138
2139 =item CPAN Testers
2140
2141 Mailing list: cpan-testers@perl.org, Testing results:
2142 http://testers.cpan.org/
2143
2144 =item PLATFORMS
2145
2146 =over 4
2147
2148 =item Unix
2149
2150 =item DOS and Derivatives
2151
2152 =item S<Mac OS>
2153
2154 =item VMS
2155
2156 =item VOS
2157
2158 =item EBCDIC Platforms
2159
2160 =item Acorn RISC OS
2161
2162 =item Other perls
2163
2164 =back
2165
2166 =item FUNCTION IMPLEMENTATIONS
2167
2168 =over 4
2169
2170 =item Alphabetical Listing of Perl Functions
2171
2172 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2173 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2174 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2175 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2176 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2177 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2178 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2179 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2180 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2181 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2182 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2183 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2184 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2185 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2186 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2187 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2188 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2189 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2190 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2191 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2192 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2193 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2194 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2195 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2196 wait, waitpid PID,FLAGS
2197
2198 =back
2199
2200 =item CHANGES
2201
2202 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2203 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2204 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2205 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2206 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2207 v1.30, 03 August 1998, v1.23, 10 July 1998
2208
2209 =item Supported Platforms
2210
2211 =item SEE ALSO
2212
2213 =item AUTHORS / CONTRIBUTORS
2214
2215 =back
2216
2217 =head2 perllocale - Perl locale handling (internationalization and
2218 localization)
2219
2220 =over 4
2221
2222 =item DESCRIPTION
2223
2224 =item PREPARING TO USE LOCALES
2225
2226 =item USING LOCALES
2227
2228 =over 4
2229
2230 =item The use locale pragma
2231
2232 =item The setlocale function
2233
2234 =item Finding locales
2235
2236 =item LOCALE PROBLEMS
2237
2238 =item Temporarily fixing locale problems
2239
2240 =item Permanently fixing locale problems
2241
2242 =item Permanently fixing your system's locale configuration
2243
2244 =item Fixing system locale configuration
2245
2246 =item The localeconv function
2247
2248 =item I18N::Langinfo
2249
2250 =back
2251
2252 =item LOCALE CATEGORIES
2253
2254 =over 4
2255
2256 =item Category LC_COLLATE: Collation
2257
2258 =item Category LC_CTYPE: Character Types
2259
2260 =item Category LC_NUMERIC: Numeric Formatting
2261
2262 =item Category LC_MONETARY: Formatting of monetary amounts
2263
2264 =item LC_TIME
2265
2266 =item Other categories
2267
2268 =back
2269
2270 =item SECURITY
2271
2272 =item ENVIRONMENT
2273
2274 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2275 LC_NUMERIC, LC_TIME, LANG
2276
2277 =item NOTES
2278
2279 =over 4
2280
2281 =item Backward compatibility
2282
2283 =item I18N:Collate obsolete
2284
2285 =item Sort speed and memory use impacts
2286
2287 =item write() and LC_NUMERIC
2288
2289 =item Freely available locale definitions
2290
2291 =item I18n and l10n
2292
2293 =item An imperfect standard
2294
2295 =back
2296
2297 =item Unicode and UTF-8
2298
2299 =item BUGS
2300
2301 =over 4
2302
2303 =item Broken systems
2304
2305 =back
2306
2307 =item SEE ALSO
2308
2309 =item HISTORY
2310
2311 =back
2312
2313 =head2 perluniintro - Perl Unicode introduction
2314
2315 =over 4
2316
2317 =item DESCRIPTION
2318
2319 =over 4
2320
2321 =item Unicode
2322
2323 =item Perl's Unicode Support
2324
2325 =item Perl's Unicode Model
2326
2327 =item Unicode and EBCDIC
2328
2329 =item Creating Unicode
2330
2331 =item Handling Unicode
2332
2333 =item Legacy Encodings
2334
2335 =item Unicode I/O
2336
2337 =item Displaying Unicode As Text
2338
2339 =item Special Cases
2340
2341 =item Advanced Topics
2342
2343 =item Miscellaneous
2344
2345 =item Questions With Answers
2346
2347 =item Hexadecimal Notation
2348
2349 =item Further Resources
2350
2351 =back
2352
2353 =item UNICODE IN OLDER PERLS
2354
2355 =item SEE ALSO
2356
2357 =item ACKNOWLEDGMENTS
2358
2359 =item AUTHOR, COPYRIGHT, AND LICENSE
2360
2361 =back
2362
2363 =head2 perlunicode - Unicode support in Perl
2364
2365 =over 4
2366
2367 =item DESCRIPTION
2368
2369 =over 4
2370
2371 =item Important Caveats
2372
2373 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2374 to enable UTF-8/UTF-EBCDIC in scripts
2375
2376 =item Byte and Character Semantics
2377
2378 =item Effects of Character Semantics
2379
2380 =item Scripts
2381
2382 =item Blocks
2383
2384 =item User-Defined Character Properties
2385
2386 =item Character Encodings for Input and Output
2387
2388 =item Unicode Regular Expression Support Level
2389
2390 =item Unicode Encodings
2391
2392 =item Security Implications of Unicode
2393
2394 =item Unicode in Perl on EBCDIC
2395
2396 =item Locales
2397
2398 =item Using Unicode in XS
2399
2400 =back
2401
2402 =item BUGS
2403
2404 =over 4
2405
2406 =item Interaction with Locales
2407
2408 =item Interaction with Extensions
2409
2410 =item Speed
2411
2412 =back
2413
2414 =item SEE ALSO
2415
2416 =back
2417
2418 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2419
2420 =over 4
2421
2422 =item DESCRIPTION
2423
2424 =item COMMON CHARACTER CODE SETS
2425
2426 =over 4
2427
2428 =item ASCII
2429
2430 =item ISO 8859
2431
2432 =item Latin 1 (ISO 8859-1)
2433
2434 =item EBCDIC
2435
2436 =item 13 variant characters
2437
2438 =item 0037
2439
2440 =item 1047
2441
2442 =item POSIX-BC
2443
2444 =item Unicode code points versus EBCDIC code points
2445
2446 =item Remaining Perl Unicode problems in EBCDIC
2447
2448 =item Unicode and UTF
2449
2450 =item Using Encode
2451
2452 =back
2453
2454 =item SINGLE OCTET TABLES
2455
2456 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2457
2458 =item IDENTIFYING CHARACTER CODE SETS
2459
2460 =item CONVERSIONS
2461
2462 =over 4
2463
2464 =item tr///
2465
2466 =item iconv
2467
2468 =item C RTL
2469
2470 =back
2471
2472 =item OPERATOR DIFFERENCES
2473
2474 =item FUNCTION DIFFERENCES
2475
2476 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2477
2478 =item REGULAR EXPRESSION DIFFERENCES
2479
2480 =item SOCKETS
2481
2482 =item SORTING
2483
2484 =over 4
2485
2486 =item Ignore ASCII vs. EBCDIC sort differences.
2487
2488 =item MONO CASE then sort data.
2489
2490 =item Convert, sort data, then re convert.
2491
2492 =item Perform sorting on one type of machine only.
2493
2494 =back
2495
2496 =item TRANSFORMATION FORMATS
2497
2498 =over 4
2499
2500 =item URL decoding and encoding
2501
2502 =item uu encoding and decoding
2503
2504 =item Quoted-Printable encoding and decoding
2505
2506 =item Caesarian ciphers
2507
2508 =back
2509
2510 =item Hashing order and checksums
2511
2512 =item I18N AND L10N
2513
2514 =item MULTI OCTET CHARACTER SETS
2515
2516 =item OS ISSUES
2517
2518 =over 4
2519
2520 =item OS/400 
2521
2522 IFS access
2523
2524 =item OS/390, z/OS
2525
2526 chcp, dataset access, OS/390, z/OS iconv, locales
2527
2528 =item VM/ESA?
2529
2530 =item POSIX-BC?
2531
2532 =back
2533
2534 =item BUGS
2535
2536 =item SEE ALSO
2537
2538 =item REFERENCES
2539
2540 =item HISTORY
2541
2542 =item AUTHOR
2543
2544 =back
2545
2546 =head2 perlsec - Perl security
2547
2548 =over 4
2549
2550 =item DESCRIPTION
2551
2552 =over 4
2553
2554 =item Laundering and Detecting Tainted Data
2555
2556 =item Switches On the "#!" Line
2557
2558 =item Cleaning Up Your Path
2559
2560 =item Security Bugs
2561
2562 =item Protecting Your Programs
2563
2564 =item Unicode
2565
2566 =back
2567
2568 =item SEE ALSO
2569
2570 =back
2571
2572 =head2 perlmod - Perl modules (packages and symbol tables)
2573
2574 =over 4
2575
2576 =item DESCRIPTION
2577
2578 =over 4
2579
2580 =item Packages
2581
2582 =item Symbol Tables
2583
2584 =item Package Constructors and Destructors
2585
2586 =item Perl Classes
2587
2588 =item Perl Modules
2589
2590 =item Making your module threadsafe
2591
2592 =back
2593
2594 =item SEE ALSO
2595
2596 =back
2597
2598 =head2 perlmodinstall - Installing CPAN Modules
2599
2600 =over 4
2601
2602 =item DESCRIPTION
2603
2604 =over 4
2605
2606 =item PREAMBLE
2607
2608 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2609 module (sometimes unnecessary), B<INSTALL> the module
2610
2611 =back
2612
2613 =item PORTABILITY
2614
2615 =item HEY
2616
2617 =item AUTHOR
2618
2619 =item COPYRIGHT
2620
2621 =back
2622
2623 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2624
2625 =over 4
2626
2627 =item DESCRIPTION
2628
2629 =item THE PERL MODULE LIBRARY
2630
2631 =over 4
2632
2633 =item Pragmatic Modules
2634
2635 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2636 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2637 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2638 threads, utf8, vars, vmsish, warnings, warnings::register
2639
2640 =item Standard Modules
2641
2642 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2643 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2644 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2645 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2646 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2647 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2648 Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest,
2649 DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter,
2650 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
2651 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
2652 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
2653 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
2654 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
2655 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2656 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2657 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2658 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2659 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2660 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2661 File::Spec::Mac, File::Spec::NW5, File::Spec::OS2, File::Spec::Unix,
2662 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
2663 FileHandle, Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2664 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2665 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2666 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2667 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2668 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2669 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2670 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2671 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2672 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2673 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2674 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2675 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2676 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2677 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe,
2678 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
2679 Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
2680 Test::Builder, Test::Harness, Test::Harness::Assert,
2681 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2682 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2683 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2684 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2685 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2686 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2687 Unicode::UCD, User::grent, User::pwent, Win32
2688
2689 =item Extension Modules
2690
2691 =back
2692
2693 =item CPAN
2694
2695 =over 4
2696
2697 =item Africa
2698
2699 =item Asia
2700
2701 =item Central America
2702
2703 =item Europe
2704
2705 =item North America
2706
2707 =item Oceania
2708
2709 =item South America
2710
2711 =back
2712
2713 =item Modules: Creation, Use, and Abuse
2714
2715 =over 4
2716
2717 =item Guidelines for Module Creation
2718
2719 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2720
2721 =item Guidelines for Reusing Application Code
2722
2723 =back
2724
2725 =item NOTE
2726
2727 =back
2728
2729 =head2 perlmodstyle - Perl module style guide
2730
2731 =over 4
2732
2733 =item INTRODUCTION
2734
2735 =item QUICK CHECKLIST
2736
2737 =over 4
2738
2739 =item Before you start
2740
2741 =item The API
2742
2743 =item Stability
2744
2745 =item Documentation
2746
2747 =item Release considerations
2748
2749 =back
2750
2751 =item BEFORE YOU START WRITING A MODULE
2752
2753 =over 4
2754
2755 =item Has it been done before?
2756
2757 =item Do one thing and do it well
2758
2759 =item What's in a name?
2760
2761 =back
2762
2763 =item DESIGNING AND WRITING YOUR MODULE
2764
2765 =over 4
2766
2767 =item To OO or not to OO?
2768
2769 =item Designing your API
2770
2771 Write simple routines to do simple things, Separate functionality from
2772 output, Provide sensible shortcuts and defaults, Naming conventions,
2773 Parameter passing
2774
2775 =item Strictness and warnings
2776
2777 =item Backwards compatibility
2778
2779 =item Error handling and messages
2780
2781 =back
2782
2783 =item DOCUMENTING YOUR MODULE
2784
2785 =over 4
2786
2787 =item POD
2788
2789 =item README, INSTALL, release notes, changelogs
2790
2791 =back
2792
2793 =item RELEASE CONSIDERATIONS
2794
2795 =over 4
2796
2797 =item Version numbering
2798
2799 =item Pre-requisites
2800
2801 =item Testing
2802
2803 =item Packaging
2804
2805 =item Licensing
2806
2807 =back
2808
2809 =item COMMON PITFALLS
2810
2811 =over 4
2812
2813 =item Reinventing the wheel
2814
2815 =item Trying to do too much
2816
2817 =item Inappropriate documentation
2818
2819 =back
2820
2821 =item SEE ALSO
2822
2823 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2824 http://pause.perl.org/, Any good book on software engineering
2825
2826 =item AUTHOR
2827
2828 =back
2829
2830 =head2 perlnewmod - preparing a new module for distribution
2831
2832 =over 4
2833
2834 =item DESCRIPTION
2835
2836 =over 4
2837
2838 =item Warning
2839
2840 =item What should I make into a module?
2841
2842 =item Step-by-step: Preparing the ground
2843
2844 Look around, Check it's new, Discuss the need, Choose a name, Check again
2845
2846 =item Step-by-step: Making the module
2847
2848 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2849 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2850 documentation|perlpod>, Write tests, Write the README
2851
2852 =item Step-by-step: Distributing your module
2853
2854 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2855 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2856
2857 =back
2858
2859 =item AUTHOR
2860
2861 =item SEE ALSO
2862
2863 =back
2864
2865 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2866 2002/04/07 18:46:13 $)
2867
2868 =over 4
2869
2870 =item DESCRIPTION
2871
2872 =over 4
2873
2874 =item What is Perl?
2875
2876 =item Who supports Perl?  Who develops it?  Why is it free?
2877
2878 =item Which version of Perl should I use?
2879
2880 =item What are perl4 and perl5?
2881
2882 =item What is perl6?
2883
2884 =item How stable is Perl?
2885
2886 =item Is Perl difficult to learn?
2887
2888 =item How does Perl compare with other languages like Java, Python, REXX,
2889 Scheme, or Tcl?
2890
2891 =item Can I do [task] in Perl?
2892
2893 =item When shouldn't I program in Perl?
2894
2895 =item What's the difference between "perl" and "Perl"?
2896
2897 =item Is it a Perl program or a Perl script?
2898
2899 =item What is a JAPH?
2900
2901 =item Where can I get a list of Larry Wall witticisms?
2902
2903 =item How can I convince my sysadmin/supervisor/employees to use version
2904 5/5.6.1/Perl instead of some other language?
2905
2906 =back
2907
2908 =item AUTHOR AND COPYRIGHT
2909
2910 =back
2911
2912 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2913 $Date: 2002/04/26 16:56:35 $)
2914
2915 =over 4
2916
2917 =item DESCRIPTION
2918
2919 =over 4
2920
2921 =item What machines support Perl?  Where do I get it?
2922
2923 =item How can I get a binary version of Perl?
2924
2925 =item I don't have a C compiler on my system.  How can I compile perl?
2926
2927 =item I copied the Perl binary from one machine to another, but scripts
2928 don't work.
2929
2930 =item I grabbed the sources and tried to compile but gdbm/dynamic
2931 loading/malloc/linking/... failed.  How do I make it work?
2932
2933 =item What modules and extensions are available for Perl?  What is CPAN? 
2934 What does CPAN/src/... mean?
2935
2936 =item Is there an ISO or ANSI certified version of Perl?
2937
2938 =item Where can I get information on Perl?
2939
2940 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2941
2942 =item Where should I post source code?
2943
2944 =item Perl Books
2945
2946 References, Tutorials, Task-Oriented, Special Topics
2947
2948 =item Perl in Magazines
2949
2950 =item Perl on the Net: FTP and WWW Access
2951
2952 =item What mailing lists are there for Perl?
2953
2954 =item Archives of comp.lang.perl.misc
2955
2956 =item Where can I buy a commercial version of Perl?
2957
2958 =item Where do I send bug reports?
2959
2960 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2961
2962 =back
2963
2964 =item AUTHOR AND COPYRIGHT
2965
2966 =back
2967
2968 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
2969 13:11:13 $)
2970
2971 =over 4
2972
2973 =item DESCRIPTION
2974
2975 =over 4
2976
2977 =item How do I do (anything)?
2978
2979 =item How can I use Perl interactively?
2980
2981 =item Is there a Perl shell?
2982
2983 =item How do I debug my Perl programs?
2984
2985 =item How do I profile my Perl programs?
2986
2987 =item How do I cross-reference my Perl programs?
2988
2989 =item Is there a pretty-printer (formatter) for Perl?
2990
2991 =item Is there a ctags for Perl?
2992
2993 =item Is there an IDE or Windows Perl Editor?
2994
2995 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
2996 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2997 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2998
2999 =item Where can I get Perl macros for vi?
3000
3001 =item Where can I get perl-mode for emacs?
3002
3003 =item How can I use curses with Perl?
3004
3005 =item How can I use X or Tk with Perl?
3006
3007 =item How can I generate simple menus without using CGI or Tk?
3008
3009 =item How can I make my Perl program run faster?
3010
3011 =item How can I make my Perl program take less memory?
3012
3013 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3014 stringification, Pass by reference, Tie large variables to disk
3015
3016 =item Is it unsafe to return a pointer to local data?
3017
3018 =item How can I free an array or hash so my program shrinks?
3019
3020 =item How can I make my CGI script more efficient?
3021
3022 =item How can I hide the source for my Perl program?
3023
3024 =item How can I compile my Perl program into byte code or C?
3025
3026 =item How can I compile Perl into Java?
3027
3028 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3029
3030 =item Can I write useful Perl programs on the command line?
3031
3032 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3033
3034 =item Where can I learn about CGI or Web programming in Perl?
3035
3036 =item Where can I learn about object-oriented Perl programming?
3037
3038 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3039
3040 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3041 my C program; what am I doing wrong?
3042
3043 =item When I tried to run my script, I got this message. What does it mean?
3044
3045 =item What's MakeMaker?
3046
3047 =back
3048
3049 =item AUTHOR AND COPYRIGHT
3050
3051 =back
3052
3053 =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
3054 07:04:25 $)
3055
3056 =over 4
3057
3058 =item DESCRIPTION
3059
3060 =item Data: Numbers
3061
3062 =over 4
3063
3064 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3065 numbers I should be getting (eg, 19.95)?
3066
3067 =item Why isn't my octal data interpreted correctly?
3068
3069 =item Does Perl have a round() function?  What about ceil() and floor()? 
3070 Trig functions?
3071
3072 =item How do I convert between numeric representations?
3073
3074 How do I convert hexadecimal into decimal, How do I convert from decimal to
3075 hexadecimal, How do I convert from octal to decimal, How do I convert from
3076 decimal to octal, How do I convert from binary to decimal, How do I convert
3077 from decimal to binary
3078
3079 =item Why doesn't & work the way I want it to?
3080
3081 =item How do I multiply matrices?
3082
3083 =item How do I perform an operation on a series of integers?
3084
3085 =item How can I output Roman numerals?
3086
3087 =item Why aren't my random numbers random?
3088
3089 =item How do I get a random number between X and Y?
3090
3091 =back
3092
3093 =item Data: Dates
3094
3095 =over 4
3096
3097 =item How do I find the week-of-the-year/day-of-the-year?
3098
3099 =item How do I find the current century or millennium?
3100
3101 =item How can I compare two dates and find the difference?
3102
3103 =item How can I take a string and turn it into epoch seconds?
3104
3105 =item How can I find the Julian Day?
3106
3107 =item How do I find yesterday's date?
3108
3109 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3110
3111 =back
3112
3113 =item Data: Strings
3114
3115 =over 4
3116
3117 =item How do I validate input?
3118
3119 =item How do I unescape a string?
3120
3121 =item How do I remove consecutive pairs of characters?
3122
3123 =item How do I expand function calls in a string?
3124
3125 =item How do I find matching/nesting anything?
3126
3127 =item How do I reverse a string?
3128
3129 =item How do I expand tabs in a string?
3130
3131 =item How do I reformat a paragraph?
3132
3133 =item How can I access/change the first N letters of a string?
3134
3135 =item How do I change the Nth occurrence of something?
3136
3137 =item How can I count the number of occurrences of a substring within a
3138 string?
3139
3140 =item How do I capitalize all the words on one line?
3141
3142 =item How can I split a [character] delimited string except when inside
3143 [character]? (Comma-separated files)
3144
3145 =item How do I strip blank space from the beginning/end of a string?
3146
3147 =item How do I pad a string with blanks or pad a number with zeroes?
3148
3149 =item How do I extract selected columns from a string?
3150
3151 =item How do I find the soundex value of a string?
3152
3153 =item How can I expand variables in text strings?
3154
3155 =item What's wrong with always quoting "$vars"?
3156
3157 =item Why don't my <<HERE documents work?
3158
3159 1. There must be no space after the << part, 2. There (probably) should be
3160 a semicolon at the end, 3. You can't (easily) have any space in front of
3161 the tag
3162
3163 =back
3164
3165 =item Data: Arrays
3166
3167 =over 4
3168
3169 =item What is the difference between a list and an array?
3170
3171 =item What is the difference between $array[1] and @array[1]?
3172
3173 =item How can I remove duplicate elements from a list or array?
3174
3175 a), b), c), d), e)
3176
3177 =item How can I tell whether a certain element is contained in a list or
3178 array?
3179
3180 =item How do I compute the difference of two arrays?  How do I compute the
3181 intersection of two arrays?
3182
3183 =item How do I test whether two arrays or hashes are equal?
3184
3185 =item How do I find the first array element for which a condition is true?
3186
3187 =item How do I handle linked lists?
3188
3189 =item How do I handle circular lists?
3190
3191 =item How do I shuffle an array randomly?
3192
3193 =item How do I process/modify each element of an array?
3194
3195 =item How do I select a random element from an array?
3196
3197 =item How do I permute N elements of a list?
3198
3199 =item How do I sort an array by (anything)?
3200
3201 =item How do I manipulate arrays of bits?
3202
3203 =item Why does defined() return true on empty arrays and hashes?
3204
3205 =back
3206
3207 =item Data: Hashes (Associative Arrays)
3208
3209 =over 4
3210
3211 =item How do I process an entire hash?
3212
3213 =item What happens if I add or remove keys from a hash while iterating over
3214 it?
3215
3216 =item How do I look up a hash element by value?
3217
3218 =item How can I know how many entries are in a hash?
3219
3220 =item How do I sort a hash (optionally by value instead of key)?
3221
3222 =item How can I always keep my hash sorted?
3223
3224 =item What's the difference between "delete" and "undef" with hashes?
3225
3226 =item Why don't my tied hashes make the defined/exists distinction?
3227
3228 =item How do I reset an each() operation part-way through?
3229
3230 =item How can I get the unique keys from two hashes?
3231
3232 =item How can I store a multidimensional array in a DBM file?
3233
3234 =item How can I make my hash remember the order I put elements into it?
3235
3236 =item Why does passing a subroutine an undefined element in a hash create
3237 it?
3238
3239 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3240 array of hashes or arrays?
3241
3242 =item How can I use a reference as a hash key?
3243
3244 =back
3245
3246 =item Data: Misc
3247
3248 =over 4
3249
3250 =item How do I handle binary data correctly?
3251
3252 =item How do I determine whether a scalar is a number/whole/integer/float?
3253
3254 =item How do I keep persistent data across program calls?
3255
3256 =item How do I print out or copy a recursive data structure?
3257
3258 =item How do I define methods for every class/object?
3259
3260 =item How do I verify a credit card checksum?
3261
3262 =item How do I pack arrays of doubles or floats for XS code?
3263
3264 =back
3265
3266 =item AUTHOR AND COPYRIGHT
3267
3268 =back
3269
3270 =head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
3271 07:04:25 $)
3272
3273 =over 4
3274
3275 =item DESCRIPTION
3276
3277 =over 4
3278
3279 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3280
3281 =item How do I change one line in a file/delete a line in a file/insert a
3282 line in the middle of a file/append to the beginning of a file?
3283
3284 =item How do I count the number of lines in a file?
3285
3286 =item How do I make a temporary file name?
3287
3288 =item How can I manipulate fixed-record-length files?
3289
3290 =item How can I make a filehandle local to a subroutine?  How do I pass
3291 filehandles between subroutines?  How do I make an array of filehandles?
3292
3293 =item How can I use a filehandle indirectly?
3294
3295 =item How can I set up a footer format to be used with write()?
3296
3297 =item How can I write() into a string?
3298
3299 =item How can I output my numbers with commas added?
3300
3301 =item How can I translate tildes (~) in a filename?
3302
3303 =item How come when I open a file read-write it wipes it out?
3304
3305 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3306
3307 =item Is there a leak/bug in glob()?
3308
3309 =item How can I open a file with a leading ">" or trailing blanks?
3310
3311 =item How can I reliably rename a file?
3312
3313 =item How can I lock a file?
3314
3315 =item Why can't I just open(FH, ">file.lock")?
3316
3317 =item I still don't get locking.  I just want to increment the number in
3318 the file.  How can I do this?
3319
3320 =item All I want to do is append a small amount of text to the end of a
3321 file.  Do I still have to use locking?
3322
3323 =item How do I randomly update a binary file?
3324
3325 =item How do I get a file's timestamp in perl?
3326
3327 =item How do I set a file's timestamp in perl?
3328
3329 =item How do I print to more than one file at once?
3330
3331 =item How can I read in an entire file all at once?
3332
3333 =item How can I read in a file by paragraphs?
3334
3335 =item How can I read a single character from a file?  From the keyboard?
3336
3337 =item How can I tell whether there's a character waiting on a filehandle?
3338
3339 =item How do I do a C<tail -f> in perl?
3340
3341 =item How do I dup() a filehandle in Perl?
3342
3343 =item How do I close a file descriptor by number?
3344
3345 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3346 `C:\temp\foo.exe` work?
3347
3348 =item Why doesn't glob("*.*") get all the files?
3349
3350 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3351 protected files?  Isn't this a bug in Perl?
3352
3353 =item How do I select a random line from a file?
3354
3355 =item Why do I get weird spaces when I print an array of lines?
3356
3357 =back
3358
3359 =item AUTHOR AND COPYRIGHT
3360
3361 =back
3362
3363 =head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
3364 22:31:09 $)
3365
3366 =over 4
3367
3368 =item DESCRIPTION
3369
3370 =over 4
3371
3372 =item How can I hope to use regular expressions without creating illegible
3373 and unmaintainable code?
3374
3375 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3376
3377 =item I'm having trouble matching over more than one line.  What's wrong?
3378
3379 =item How can I pull out lines between two patterns that are themselves on
3380 different lines?
3381
3382 =item I put a regular expression into $/ but it didn't work. What's wrong?
3383
3384 =item How do I substitute case insensitively on the LHS while preserving
3385 case on the RHS?
3386
3387 =item How can I make C<\w> match national character sets?
3388
3389 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3390
3391 =item How can I quote a variable to use in a regex?
3392
3393 =item What is C</o> really for?
3394
3395 =item How do I use a regular expression to strip C style comments from a
3396 file?
3397
3398 =item Can I use Perl regular expressions to match balanced text?
3399
3400 =item What does it mean that regexes are greedy?  How can I get around it?
3401
3402 =item How do I process each word on each line?
3403
3404 =item How can I print out a word-frequency or line-frequency summary?
3405
3406 =item How can I do approximate matching?
3407
3408 =item How do I efficiently match many regular expressions at once?
3409
3410 =item Why don't word-boundary searches with C<\b> work for me?
3411
3412 =item Why does using $&, $`, or $' slow my program down?
3413
3414 =item What good is C<\G> in a regular expression?
3415
3416 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3417
3418 =item What's wrong with using grep or map in a void context?
3419
3420 =item How can I match strings with multibyte characters?
3421
3422 =item How do I match a pattern that is supplied by the user?
3423
3424 =back
3425
3426 =item AUTHOR AND COPYRIGHT
3427
3428 =back
3429
3430 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3431 2002/03/26 15:48:32 $)
3432
3433 =over 4
3434
3435 =item DESCRIPTION
3436
3437 =over 4
3438
3439 =item Can I get a BNF/yacc/RE for the Perl language?
3440
3441 =item What are all these $@%&* punctuation signs, and how do I know when to
3442 use them?
3443
3444 =item Do I always/never have to quote my strings or use semicolons and
3445 commas?
3446
3447 =item How do I skip some return values?
3448
3449 =item How do I temporarily block warnings?
3450
3451 =item What's an extension?
3452
3453 =item Why do Perl operators have different precedence than C operators?
3454
3455 =item How do I declare/create a structure?
3456
3457 =item How do I create a module?
3458
3459 =item How do I create a class?
3460
3461 =item How can I tell if a variable is tainted?
3462
3463 =item What's a closure?
3464
3465 =item What is variable suicide and how can I prevent it?
3466
3467 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3468 Regex}?
3469
3470 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3471 Passing Methods
3472
3473 =item How do I create a static variable?
3474
3475 =item What's the difference between dynamic and lexical (static) scoping? 
3476 Between local() and my()?
3477
3478 =item How can I access a dynamic variable while a similarly named lexical
3479 is in scope?
3480
3481 =item What's the difference between deep and shallow binding?
3482
3483 =item Why doesn't "my($foo) = <FILE>;" work right?
3484
3485 =item How do I redefine a builtin function, operator, or method?
3486
3487 =item What's the difference between calling a function as &foo and foo()?
3488
3489 =item How do I create a switch or case statement?
3490
3491 =item How can I catch accesses to undefined variables/functions/methods?
3492
3493 =item Why can't a method included in this same file be found?
3494
3495 =item How can I find out my current package?
3496
3497 =item How can I comment out a large block of perl code?
3498
3499 =item How do I clear a package?
3500
3501 =item How can I use a variable as a variable name?
3502
3503 =back
3504
3505 =item AUTHOR AND COPYRIGHT
3506
3507 =back
3508
3509 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3510 12:41:42 $)
3511
3512 =over 4
3513
3514 =item DESCRIPTION
3515
3516 =over 4
3517
3518 =item How do I find out which operating system I'm running under?
3519
3520 =item How come exec() doesn't return?
3521
3522 =item How do I do fancy stuff with the keyboard/screen/mouse?
3523
3524 Keyboard, Screen, Mouse
3525
3526 =item How do I print something out in color?
3527
3528 =item How do I read just one key without waiting for a return key?
3529
3530 =item How do I check whether input is ready on the keyboard?
3531
3532 =item How do I clear the screen?
3533
3534 =item How do I get the screen size?
3535
3536 =item How do I ask the user for a password?
3537
3538 =item How do I read and write the serial port?
3539
3540 lockfiles, open mode, end of line, flushing output, non-blocking input
3541
3542 =item How do I decode encrypted password files?
3543
3544 =item How do I start a process in the background?
3545
3546 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3547
3548 =item How do I trap control characters/signals?
3549
3550 =item How do I modify the shadow password file on a Unix system?
3551
3552 =item How do I set the time and date?
3553
3554 =item How can I sleep() or alarm() for under a second?
3555
3556 =item How can I measure time under a second?
3557
3558 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3559
3560 =item Why doesn't my sockets program work under System V (Solaris)?  What
3561 does the error message "Protocol not supported" mean?
3562
3563 =item How can I call my system's unique C functions from Perl?
3564
3565 =item Where do I get the include files to do ioctl() or syscall()?
3566
3567 =item Why do setuid perl scripts complain about kernel problems?
3568
3569 =item How can I open a pipe both to and from a command?
3570
3571 =item Why can't I get the output of a command with system()?
3572
3573 =item How can I capture STDERR from an external command?
3574
3575 =item Why doesn't open() return an error when a pipe open fails?
3576
3577 =item What's wrong with using backticks in a void context?
3578
3579 =item How can I call backticks without shell processing?
3580
3581 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3582 ^Z on MS-DOS)?
3583
3584 =item How can I convert my shell script to perl?
3585
3586 =item Can I use perl to run a telnet or ftp session?
3587
3588 =item How can I write expect in Perl?
3589
3590 =item Is there a way to hide perl's command line from programs such as
3591 "ps"?
3592
3593 =item I {changed directory, modified my environment} in a perl script.  How
3594 come the change disappeared when I exited the script?  How do I get my
3595 changes to be visible?
3596
3597 Unix
3598
3599 =item How do I close a process's filehandle without waiting for it to
3600 complete?
3601
3602 =item How do I fork a daemon process?
3603
3604 =item How do I find out if I'm running interactively or not?
3605
3606 =item How do I timeout a slow event?
3607
3608 =item How do I set CPU limits?
3609
3610 =item How do I avoid zombies on a Unix system?
3611
3612 =item How do I use an SQL database?
3613
3614 =item How do I make a system() exit on control-C?
3615
3616 =item How do I open a file without blocking?
3617
3618 =item How do I install a module from CPAN?
3619
3620 =item What's the difference between require and use?
3621
3622 =item How do I keep my own module/library directory?
3623
3624 =item How do I add the directory my program lives in to the module/library
3625 search path?
3626
3627 =item How do I add a directory to my include path at runtime?
3628
3629 =item What is socket.ph and where do I get it?
3630
3631 =back
3632
3633 =item AUTHOR AND COPYRIGHT
3634
3635 =back
3636
3637 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3638 $)
3639
3640 =over 4
3641
3642 =item DESCRIPTION
3643
3644 =over 4
3645
3646 =item What is the correct form of response from a CGI script?
3647
3648 =item My CGI script runs from the command line but not the browser.  (500
3649 Server Error)
3650
3651 =item How can I get better error messages from a CGI program?
3652
3653 =item How do I remove HTML from a string?
3654
3655 =item How do I extract URLs?
3656
3657 =item How do I download a file from the user's machine?  How do I open a
3658 file on another machine?
3659
3660 =item How do I make a pop-up menu in HTML?
3661
3662 =item How do I fetch an HTML file?
3663
3664 =item How do I automate an HTML form submission?
3665
3666 =item How do I decode or create those %-encodings on the web?
3667
3668 =item How do I redirect to another page?
3669
3670 =item How do I put a password on my web pages?
3671
3672 =item How do I edit my .htpasswd and .htgroup files with Perl?
3673
3674 =item How do I make sure users can't enter values into a form that cause my
3675 CGI script to do bad things?
3676
3677 =item How do I parse a mail header?
3678
3679 =item How do I decode a CGI form?
3680
3681 =item How do I check a valid mail address?
3682
3683 =item How do I decode a MIME/BASE64 string?
3684
3685 =item How do I return the user's mail address?
3686
3687 =item How do I send mail?
3688
3689 =item How do I use MIME to make an attachment to a mail message?
3690
3691 =item How do I read mail?
3692
3693 =item How do I find out my hostname/domainname/IP address?
3694
3695 =item How do I fetch a news article or the active newsgroups?
3696
3697 =item How do I fetch/put an FTP file?
3698
3699 =item How can I do RPC in Perl?
3700
3701 =back
3702
3703 =item AUTHOR AND COPYRIGHT
3704
3705 =back
3706
3707 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3708
3709 =over 4
3710
3711 =item DESCRIPTION
3712
3713 =over 4
3714
3715 =item Layout
3716
3717 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3718
3719 =back
3720
3721 =item Using The Back Ends
3722
3723 =over 4
3724
3725 =item The Cross Referencing Back End
3726
3727 i, &, s, r
3728
3729 =item The Decompiling Back End
3730
3731 =item The Lint Back End
3732
3733 =item The Simple C Back End
3734
3735 =item The Bytecode Back End
3736
3737 =item The Optimized C Back End
3738
3739 =back
3740
3741 =item Module List for the Compiler Suite
3742
3743 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3744 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3745 B::Stackobj, B::Stash, B::Terse, B::Xref
3746
3747 =item KNOWN PROBLEMS
3748
3749 =item AUTHOR
3750
3751 =back
3752
3753 =head2 perlembed - how to embed perl in your C program
3754
3755 =over 4
3756
3757 =item DESCRIPTION
3758
3759 =over 4
3760
3761 =item PREAMBLE
3762
3763 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3764 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3765
3766 =item ROADMAP
3767
3768 =item Compiling your C program
3769
3770 =item Adding a Perl interpreter to your C program
3771
3772 =item Calling a Perl subroutine from your C program
3773
3774 =item Evaluating a Perl statement from your C program
3775
3776 =item Performing Perl pattern matches and substitutions from your C program
3777
3778 =item Fiddling with the Perl stack from your C program
3779
3780 =item Maintaining a persistent interpreter
3781
3782 =item Execution of END blocks
3783
3784 =item Maintaining multiple interpreter instances
3785
3786 =item Using Perl modules, which themselves use C libraries, from your C
3787 program
3788
3789 =back
3790
3791 =item Embedding Perl under Win32
3792
3793 =item MORAL
3794
3795 =item AUTHOR
3796
3797 =item COPYRIGHT
3798
3799 =back
3800
3801 =head2 perldebguts - Guts of Perl debugging 
3802
3803 =over 4
3804
3805 =item DESCRIPTION
3806
3807 =item Debugger Internals
3808
3809 =over 4
3810
3811 =item Writing Your Own Debugger
3812
3813 =back
3814
3815 =item Frame Listing Output Examples
3816
3817 =item Debugging regular expressions
3818
3819 =over 4
3820
3821 =item Compile-time output
3822
3823 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3824 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3825 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3826 C<anchored(TYPE)>
3827
3828 =item Types of nodes
3829
3830 =item Run-time output
3831
3832 =back
3833
3834 =item Debugging Perl memory usage
3835
3836 =over 4
3837
3838 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3839
3840 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3841 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3842 6144>
3843
3844 =item Example of using B<-DL> switch
3845
3846 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3847
3848 =item B<-DL> details
3849
3850 C<!!!>, C<!!>, C<!>
3851
3852 =item Limitations of B<-DL> statistics
3853
3854 =back
3855
3856 =item SEE ALSO
3857
3858 =back
3859
3860 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3861
3862 =over 4
3863
3864 =item DESCRIPTION
3865
3866 =item SPECIAL NOTES
3867
3868 =over 4
3869
3870 =item make
3871
3872 =item Version caveat
3873
3874 =item Dynamic Loading versus Static Loading
3875
3876 =back
3877
3878 =item TUTORIAL
3879
3880 =over 4
3881
3882 =item EXAMPLE 1
3883
3884 =item EXAMPLE 2
3885
3886 =item What has gone on?
3887
3888 =item Writing good test scripts
3889
3890 =item EXAMPLE 3
3891
3892 =item What's new here?
3893
3894 =item Input and Output Parameters
3895
3896 =item The XSUBPP Program
3897
3898 =item The TYPEMAP file
3899
3900 =item Warning about Output Arguments
3901
3902 =item EXAMPLE 4
3903
3904 =item What has happened here?
3905
3906 =item Anatomy of .xs file
3907
3908 =item Getting the fat out of XSUBs
3909
3910 =item More about XSUB arguments
3911
3912 =item The Argument Stack
3913
3914 =item Extending your Extension
3915
3916 =item Documenting your Extension
3917
3918 =item Installing your Extension
3919
3920 =item EXAMPLE 5
3921
3922 =item New Things in this Example
3923
3924 =item EXAMPLE 6
3925
3926 =item New Things in this Example
3927
3928 =item EXAMPLE 7 (Coming Soon)
3929
3930 =item EXAMPLE 8 (Coming Soon)
3931
3932 =item EXAMPLE 9 Passing open files to XSes
3933
3934 =item Troubleshooting these Examples
3935
3936 =back
3937
3938 =item See also
3939
3940 =item Author
3941
3942 =over 4
3943
3944 =item Last Changed
3945
3946 =back
3947
3948 =back
3949
3950 =head2 perlxs - XS language reference manual
3951
3952 =over 4
3953
3954 =item DESCRIPTION
3955
3956 =over 4
3957
3958 =item Introduction
3959
3960 =item On The Road
3961
3962 =item The Anatomy of an XSUB
3963
3964 =item The Argument Stack
3965
3966 =item The RETVAL Variable
3967
3968 =item The MODULE Keyword
3969
3970 =item The PACKAGE Keyword
3971
3972 =item The PREFIX Keyword
3973
3974 =item The OUTPUT: Keyword
3975
3976 =item The NO_OUTPUT Keyword
3977
3978 =item The CODE: Keyword
3979
3980 =item The INIT: Keyword
3981
3982 =item The NO_INIT Keyword
3983
3984 =item Initializing Function Parameters
3985
3986 =item Default Parameter Values
3987
3988 =item The PREINIT: Keyword
3989
3990 =item The SCOPE: Keyword
3991
3992 =item The INPUT: Keyword
3993
3994 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3995
3996 =item The C<length(NAME)> Keyword
3997
3998 =item Variable-length Parameter Lists
3999
4000 =item The C_ARGS: Keyword
4001
4002 =item The PPCODE: Keyword
4003
4004 =item Returning Undef And Empty Lists
4005
4006 =item The REQUIRE: Keyword
4007
4008 =item The CLEANUP: Keyword
4009
4010 =item The POSTCALL: Keyword
4011
4012 =item The BOOT: Keyword
4013
4014 =item The VERSIONCHECK: Keyword
4015
4016 =item The PROTOTYPES: Keyword
4017
4018 =item The PROTOTYPE: Keyword
4019
4020 =item The ALIAS: Keyword
4021
4022 =item The OVERLOAD: Keyword
4023
4024 =item The INTERFACE: Keyword
4025
4026 =item The INTERFACE_MACRO: Keyword
4027
4028 =item The INCLUDE: Keyword
4029
4030 =item The CASE: Keyword
4031
4032 =item The & Unary Operator
4033
4034 =item Inserting POD, Comments and C Preprocessor Directives
4035
4036 =item Using XS With C++
4037
4038 =item Interface Strategy
4039
4040 =item Perl Objects And C Structures
4041
4042 =item The Typemap
4043
4044 =item Safely Storing Static Data in XS
4045
4046 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4047
4048 =back
4049
4050 =item EXAMPLES
4051
4052 =item XS VERSION
4053
4054 =item AUTHOR
4055
4056 =back
4057
4058 =head2 perlclib - Internal replacements for standard C library functions
4059
4060 =over 4
4061
4062 =item DESCRIPTION
4063
4064 =over 4
4065
4066 =item Conventions
4067
4068 C<t>, C<p>, C<n>, C<s>
4069
4070 =item File Operations
4071
4072 =item File Input and Output
4073
4074 =item File Positioning
4075
4076 =item Memory Management and String Handling
4077
4078 =item Character Class Tests
4079
4080 =item F<stdlib.h> functions
4081
4082 =item Miscellaneous functions
4083
4084 =back
4085
4086 =item SEE ALSO
4087
4088 =back
4089
4090 =head2 perlguts - Introduction to the Perl API
4091
4092 =over 4
4093
4094 =item DESCRIPTION
4095
4096 =item Variables
4097
4098 =over 4
4099
4100 =item Datatypes
4101
4102 =item What is an "IV"?
4103
4104 =item Working with SVs
4105
4106 =item Offsets
4107
4108 =item What's Really Stored in an SV?
4109
4110 =item Working with AVs
4111
4112 =item Working with HVs
4113
4114 =item Hash API Extensions
4115
4116 =item References
4117
4118 =item Blessed References and Class Objects
4119
4120 =item Creating New Variables
4121
4122 GV_ADDMULTI, GV_ADDWARN
4123
4124 =item Reference Counts and Mortality
4125
4126 =item Stashes and Globs
4127
4128 =item Double-Typed SVs
4129
4130 =item Magic Variables
4131
4132 =item Assigning Magic
4133
4134 =item Magic Virtual Tables
4135
4136 =item Finding Magic
4137
4138 =item Understanding the Magic of Tied Hashes and Arrays
4139
4140 =item Localizing changes
4141
4142 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4143 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4144 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4145 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4146 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4147 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4148 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4149 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4150 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4151 save_hptr(HV **hptr)>
4152
4153 =back
4154
4155 =item Subroutines
4156
4157 =over 4
4158
4159 =item XSUBs and the Argument Stack
4160
4161 =item Calling Perl Routines from within C Programs
4162
4163 =item Memory Allocation
4164
4165 =item PerlIO
4166
4167 =item Putting a C value on Perl stack
4168
4169 =item Scratchpads
4170
4171 =item Scratchpads and recursion
4172
4173 =back
4174
4175 =item Compiled code
4176
4177 =over 4
4178
4179 =item Code tree
4180
4181 =item Examining the tree
4182
4183 =item Compile pass 1: check routines
4184
4185 =item Compile pass 1a: constant folding
4186
4187 =item Compile pass 2: context propagation
4188
4189 =item Compile pass 3: peephole optimization
4190
4191 =item Pluggable runops
4192
4193 =back
4194
4195 =item Examining internal data structures with the C<dump> functions
4196
4197 =item How multiple interpreters and concurrency are supported
4198
4199 =over 4
4200
4201 =item Background and PERL_IMPLICIT_CONTEXT
4202
4203 =item So what happened to dTHR?
4204
4205 =item How do I use all this in extensions?
4206
4207 =item Should I do anything special if I call perl from multiple threads?
4208
4209 =item Future Plans and PERL_IMPLICIT_SYS
4210
4211 =back
4212
4213 =item Internal Functions
4214
4215 A, p, d, s, n, r, f, M, o, j, x
4216
4217 =over 4
4218
4219 =item Formatted Printing of IVs, UVs, and NVs
4220
4221 =item Pointer-To-Integer and Integer-To-Pointer
4222
4223 =item Source Documentation
4224
4225 =back
4226
4227 =item Unicode Support
4228
4229 =over 4
4230
4231 =item What B<is> Unicode, anyway?
4232
4233 =item How can I recognise a UTF8 string?
4234
4235 =item How does UTF8 represent Unicode characters?
4236
4237 =item How does Perl store UTF8 strings?
4238
4239 =item How do I convert a string to UTF8?
4240
4241 =item Is there anything else I need to know?
4242
4243 =back
4244
4245 =item Custom Operators
4246
4247 =item AUTHORS
4248
4249 =item SEE ALSO
4250
4251 =back
4252
4253 =head2 perlcall - Perl calling conventions from C
4254
4255 =over 4
4256
4257 =item DESCRIPTION
4258
4259 An Error Handler, An Event Driven Program
4260
4261 =item THE CALL_ FUNCTIONS
4262
4263 call_sv, call_pv, call_method, call_argv
4264
4265 =item FLAG VALUES
4266
4267 =over 4
4268
4269 =item  G_VOID
4270
4271 =item  G_SCALAR
4272
4273 =item G_ARRAY
4274
4275 =item G_DISCARD
4276
4277 =item G_NOARGS
4278
4279 =item G_EVAL
4280
4281 =item G_KEEPERR
4282
4283 =item Determining the Context
4284
4285 =back
4286
4287 =item KNOWN PROBLEMS
4288
4289 =item EXAMPLES
4290
4291 =over 4
4292
4293 =item No Parameters, Nothing returned
4294
4295 =item Passing Parameters
4296
4297 =item Returning a Scalar
4298
4299 =item Returning a list of values
4300
4301 =item Returning a list in a scalar context
4302
4303 =item Returning Data from Perl via the parameter list
4304
4305 =item Using G_EVAL
4306
4307 =item Using G_KEEPERR
4308
4309 =item Using call_sv
4310
4311 =item Using call_argv
4312
4313 =item Using call_method
4314
4315 =item Using GIMME_V
4316
4317 =item Using Perl to dispose of temporaries
4318
4319 =item Strategies for storing Callback Context Information
4320
4321 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4322 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4323 callback
4324
4325 =item Alternate Stack Manipulation
4326
4327 =item Creating and calling an anonymous subroutine in C
4328
4329 =back
4330
4331 =item SEE ALSO
4332
4333 =item AUTHOR
4334
4335 =item DATE
4336
4337 =back
4338
4339 =head2 perlutil - utilities packaged with the Perl distribution
4340
4341 =over 4
4342
4343 =item DESCRIPTION
4344
4345 =over 4
4346
4347 =item DOCUMENTATION
4348
4349 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4350 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4351 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4352 L<roffitall|roffitall>
4353
4354 =item CONVERTORS
4355
4356 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4357
4358 =item Administration
4359
4360 L<libnetcfg|libnetcfg>
4361
4362 =item Development
4363
4364 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4365 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4366
4367 =item SEE ALSO
4368
4369 =back
4370
4371 =back
4372
4373 =head2 perlfilter - Source Filters
4374
4375 =over 4
4376
4377 =item DESCRIPTION
4378
4379 =item CONCEPTS
4380
4381 =item USING FILTERS
4382
4383 =item WRITING A SOURCE FILTER
4384
4385 =item WRITING A SOURCE FILTER IN C
4386
4387 B<Decryption Filters>
4388
4389 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4390
4391 =item WRITING A SOURCE FILTER IN PERL
4392
4393 =item USING CONTEXT: THE DEBUG FILTER
4394
4395 =item CONCLUSION
4396
4397 =item REQUIREMENTS
4398
4399 =item AUTHOR
4400
4401 =item Copyrights
4402
4403 =back
4404
4405 =head2 perldbmfilter - Perl DBM Filters
4406
4407 =over 4
4408
4409 =item SYNOPSIS
4410
4411 =item DESCRIPTION
4412
4413 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4414 B<filter_fetch_value>
4415
4416 =over 4
4417
4418 =item The Filter
4419
4420 =item An Example -- the NULL termination problem.
4421
4422 =item Another Example -- Key is a C int.
4423
4424 =back
4425
4426 =item SEE ALSO
4427
4428 =item AUTHOR
4429
4430 =back
4431
4432 =head2 perlapi - autogenerated documentation for the perl public API
4433
4434 =over 4
4435
4436 =item DESCRIPTION
4437
4438 =item "Gimme" Values
4439
4440 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4441
4442 =item Array Manipulation Functions
4443
4444 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4445 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4446 get_av, newAV, Nullav, sortsv
4447
4448 =item Callback Functions
4449
4450 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4451 FREETMPS, LEAVE, SAVETMPS
4452
4453 =item Character classes
4454
4455 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4456
4457 =item Cloning an interpreter
4458
4459 perl_clone
4460
4461 =item CV Manipulation Functions
4462
4463 CvSTASH, get_cv, Nullcv
4464
4465 =item Embedding Functions
4466
4467 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4468 perl_free, perl_parse, perl_run, require_pv
4469
4470 =item Functions in file pp_pack.c
4471
4472 pack_cat, unpack_str
4473
4474 =item Global Variables
4475
4476 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4477
4478 =item GV Functions
4479
4480 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4481 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4482
4483 =item Handy Values
4484
4485 HEf_SVKEY, Nullch, Nullsv
4486
4487 =item Hash Manipulation Functions
4488
4489 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4490 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4491 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4492 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4493 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4494
4495 =item Magical Functions
4496
4497 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4498 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4499 SvSetSV, SvSetSV_nosteal, SvSHARE
4500
4501 =item Memory Management
4502
4503 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4504 savepv, savepvn, savesharedpv, StructCopy, Zero
4505
4506 =item Miscellaneous Functions
4507
4508 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4509 strNE, strnEQ, strnNE
4510
4511 =item Numeric functions
4512
4513 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4514 scan_hex, scan_oct
4515
4516 =item Optree Manipulation Functions
4517
4518 cv_const_sv, newCONSTSUB, newXS
4519
4520 =item Stack Manipulation Macros
4521
4522 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4523 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4524 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4525 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4526 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4527
4528 =item SV Flags
4529
4530 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4531
4532 =item SV Manipulation Functions
4533
4534 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4535 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4536 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4537 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4538 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4539 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4540 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4541 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4542 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4543 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4544 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4545 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4546 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4547 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4548 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4549 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4550 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4551 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4552 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4553 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4554 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4555 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4556 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4557 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4558 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4559 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4560 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4561 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4562 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4563 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4564 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4565 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4566 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4567
4568 =item Unicode Support
4569
4570 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4571 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4572 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4573 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4574 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4575
4576 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4577
4578 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4579 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4580
4581 =item Warning and Dieing
4582
4583 croak, warn
4584
4585 =item AUTHORS
4586
4587 =item SEE ALSO
4588
4589 =back
4590
4591 =head2 perlintern - autogenerated documentation of purely B<internal>
4592                  Perl functions
4593
4594 =over 4
4595
4596 =item DESCRIPTION
4597
4598 =item Global Variables
4599
4600 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4601 PL_rs
4602
4603 =item GV Functions
4604
4605 is_gv_magical
4606
4607 =item IO Functions
4608
4609 start_glob
4610
4611 =item Pad Data Structures
4612
4613 CvPADLIST
4614
4615 =item Stack Manipulation Macros
4616
4617 djSP, LVRET
4618
4619 =item SV Manipulation Functions
4620
4621 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4622
4623 =item AUTHORS
4624
4625 =item SEE ALSO
4626
4627 =back
4628
4629 =head2 perliol - C API for Perl's implementation of IO in Layers.
4630
4631 =over 4
4632
4633 =item SYNOPSIS
4634
4635 =item DESCRIPTION
4636
4637 =over 4
4638
4639 =item History and Background
4640
4641 =item Layers vs Disciplines
4642
4643 =item Data Structures
4644
4645 =item Functions and Attributes
4646
4647 =item Per-instance Data
4648
4649 =item Layers in action.
4650
4651 =item Per-instance flag bits
4652
4653 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4654 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4655 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4656 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4657
4658 =item Methods in Detail
4659
4660 name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
4661 PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
4662 Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
4663 Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
4664
4665 =item Core Layers
4666
4667 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4668
4669 =item Extension Layers
4670
4671 ":encoding", ":Scalar", ":Via"
4672
4673 =back
4674
4675 =item TODO
4676
4677 =back
4678
4679 =head2 perlapio - perl's IO abstraction interface.
4680
4681 =over 4
4682
4683 =item SYNOPSIS
4684
4685 =item DESCRIPTION
4686
4687 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4688 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4689 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4690 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4691 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4692 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4693 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4694 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4695 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4696 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4697 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4698
4699 =over 4
4700
4701 =item Co-existence with stdio
4702
4703 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4704 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4705
4706 =item "Fast gets" Functions
4707
4708 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4709 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4710 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4711 B<PerlIO_get_bufsiz(f)>
4712
4713 =item Other Functions
4714
4715 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4716 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4717
4718 =back
4719
4720 =back
4721
4722 =head2 perltodo - Perl TO-DO List
4723
4724 =over 4
4725
4726 =item DESCRIPTION
4727
4728 =item To do during 5.6.x
4729
4730 =over 4
4731
4732 =item Support for I/O disciplines
4733
4734 =item Autoload bytes.pm
4735
4736 =item Make "\u{XXXX}" et al work
4737
4738 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4739
4740 =item Overloadable regex assertions
4741
4742 =item Unicode
4743
4744 =item Work out exit/die semantics for threads
4745
4746 =item Better support for nonpreemptive threading systems like GNU pth
4747
4748 =item Typed lexicals for compiler
4749
4750 =item Compiler workarounds for Win32
4751
4752 =item AUTOLOADing in the compiler
4753
4754 =item Fixing comppadlist when compiling
4755
4756 =item Cleaning up exported namespace
4757
4758 =item Complete signal handling
4759
4760 =item Out-of-source builds
4761
4762 =item POSIX realtime support
4763
4764 =item UNIX98 support
4765
4766 =item IPv6 Support
4767
4768 =item Long double conversion
4769
4770 =item Locales
4771
4772 =item Arithmetic on non-Arabic numerals
4773
4774 =item POSIX Unicode character classes
4775
4776 =item Factoring out common suffices/prefices in regexps (trie optimization)
4777
4778 =item Security audit shipped utilities
4779
4780 =item Sort out the uid-setting mess
4781
4782 =item Custom opcodes
4783
4784 =item DLL Versioning
4785
4786 =item Introduce @( and @)
4787
4788 =item Floating point handling
4789
4790 =item IV/UV preservation
4791
4792 =item Replace pod2html with something using Pod::Parser
4793
4794 =item Automate module testing on CPAN
4795
4796 =item sendmsg and recvmsg
4797
4798 =item Rewrite perlre documentation
4799
4800 =item Convert example code to IO::Handle filehandles
4801
4802 =item Document Win32 choices
4803
4804 =item Check new modules
4805
4806 =item Make roffitall find pods and libs itself
4807
4808 =back
4809
4810 =item To do at some point
4811
4812 =over 4
4813
4814 =item Remove regular expression recursion
4815
4816 =item Memory leaks after failed eval
4817
4818 =item bitfields in pack
4819
4820 =item Cross compilation
4821
4822 =item Perl preprocessor / macros
4823
4824 =item Perl lexer in Perl
4825
4826 =item Using POSIX calls internally
4827
4828 =item -i rename file when changed
4829
4830 =item All ARGV input should act like E<lt>E<gt>
4831
4832 =item Support for rerunning debugger
4833
4834 =item Test Suite for the Debugger
4835
4836 =item my sub foo { }
4837
4838 =item One-pass global destruction
4839
4840 =item Rewrite regexp parser
4841
4842 =item Cache recently used regexps
4843
4844 =item Cross-compilation support
4845
4846 =item Bit-shifting bitvectors
4847
4848 =item debugger pragma
4849
4850 =item use less pragma
4851
4852 =item switch structures
4853
4854 =item Cache eval tree
4855
4856 =item rcatmaybe
4857
4858 =item Shrink opcode tables
4859
4860 =item Optimize away @_
4861
4862 =item Prototypes versus indirect objects
4863
4864 =item Install HTML
4865
4866 =item Prototype method calls
4867
4868 =item Return context prototype declarations
4869
4870 =item magic_setisa
4871
4872 =item Garbage collection
4873
4874 =item IO tutorial
4875
4876 =item Rewrite perldoc
4877
4878 =item Install .3p manpages
4879
4880 =item Unicode tutorial
4881
4882 =item Update POSIX.pm for 1003.1-2
4883
4884 =item Retargetable installation
4885
4886 =item POSIX emulation on non-POSIX systems
4887
4888 =item Rename Win32 headers
4889
4890 =item Finish off lvalue functions
4891
4892 =item Update sprintf documentation
4893
4894 =item Use fchown/fchmod internally
4895
4896 =item Make v-strings overloaded objects
4897
4898 =item Allow restricted hash assignment
4899
4900 =item Should overload be inheritable?
4901
4902 =item Taint rethink
4903
4904 =back
4905
4906 =item Vague ideas
4907
4908 =over 4
4909
4910 =item ref() in list context
4911
4912 =item Make tr/// return histogram of characters in list context
4913
4914 =item Compile to real threaded code
4915
4916 =item Structured types
4917
4918 =item Modifiable $1 et al.
4919
4920 =item Procedural interfaces for IO::*, etc.
4921
4922 =item RPC modules
4923
4924 =item Attach/detach debugger from running program
4925
4926 =item GUI::Native
4927
4928 =item foreach(reverse ...)
4929
4930 =item Constant function cache
4931
4932 =item Approximate regular expression matching
4933
4934 =back
4935
4936 =item Ongoing
4937
4938 =over 4
4939
4940 =item Update guts documentation
4941
4942 =item Add more tests
4943
4944 =item Update auxiliary tools
4945
4946 =item Create debugging macros
4947
4948 =item truncate to the people
4949
4950 =item Unicode in Filenames
4951
4952 =back
4953
4954 =item Recently done things
4955
4956 =over 4
4957
4958 =item Alternative RE syntax module
4959
4960 =item Safe signal handling
4961
4962 =item Tie Modules
4963
4964 =item gettimeofday
4965
4966 =item setitimer and getimiter
4967
4968 =item Testing __DIE__ hook
4969
4970 =item CPP equivalent in Perl
4971
4972 =item Explicit switch statements
4973
4974 =item autocroak
4975
4976 =item UTF/EBCDIC
4977
4978 =item UTF Regexes
4979
4980 =item perlcc to produce executable
4981
4982 =item END blocks saved in compiled output
4983
4984 =item Secure temporary file module
4985
4986 =item Integrate Time::HiRes
4987
4988 =item Turn Cwd into XS
4989
4990 =item Mmap for input
4991
4992 =item Byte to/from UTF8 and UTF8 to/from local conversion
4993
4994 =item Add sockatmark support
4995
4996 =item Mailing list archives
4997
4998 =item Bug tracking
4999
5000 =item Integrate MacPerl
5001
5002 =item Web "nerve center" for Perl
5003
5004 =item Regular expression tutorial
5005
5006 =item Debugging Tutorial
5007
5008 =item Integrate new modules
5009
5010 =item Integrate profiler
5011
5012 =item Y2K error detection
5013
5014 =item Regular expression debugger
5015
5016 =item POD checker
5017
5018 =item "Dynamic" lexicals
5019
5020 =item Cache precompiled modules
5021
5022 =back
5023
5024 =item Deprecated Wishes
5025
5026 =over 4
5027
5028 =item Loop control on do{}
5029
5030 =item Lexically scoped typeglobs
5031
5032 =item format BOTTOM
5033
5034 =item report HANDLE
5035
5036 =item Generalised want()/caller())
5037
5038 =item Named prototypes
5039
5040 =item Built-in globbing
5041
5042 =item Regression tests for suidperl
5043
5044 =item Cached hash values
5045
5046 =item Add compression modules
5047
5048 =item Reorganise documentation into tutorials/references
5049
5050 =item Remove distinction between functions and operators
5051
5052 =item Make XS easier to use
5053
5054 =item Make embedding easier to use
5055
5056 =item man for perl
5057
5058 =item my $Package::variable
5059
5060 =item "or" tests defined, not truth
5061
5062 =item "class"-based lexicals
5063
5064 =item byteperl
5065
5066 =item Lazy evaluation / tail recursion removal
5067
5068 =item Make "use utf8" the default
5069
5070 =item Unicode collation and normalization
5071
5072 =item pack/unpack tutorial
5073
5074 =back
5075
5076 =back
5077
5078 =head2 perlhack - How to hack at the Perl internals
5079
5080 =over 4
5081
5082 =item DESCRIPTION
5083
5084 Does concept match the general goals of Perl?, Where is the
5085 implementation?, Backwards compatibility, Could it be a module instead?, Is
5086 the feature generic enough?, Does it potentially introduce new bugs?, Does
5087 it preclude other desirable features?, Is the implementation robust?, Is
5088 the implementation generic enough to be portable?, Is the implementation
5089 tested?, Is there enough documentation?, Is there another way to do it?,
5090 Does it create too much work?, Patches speak louder than words
5091
5092 =over 4
5093
5094 =item Keeping in sync
5095
5096 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5097 NFS, rsync'ing the patches
5098
5099 =item Why rsync the source tree
5100
5101 It's easier to rsync the source tree, It's more reliable
5102
5103 =item Why rsync the patches
5104
5105 It's easier to rsync the patches, It's a good reference, Finding a start
5106 point, Finding how to fix a bug, Finding the source of misbehaviour
5107
5108 =item Perlbug remote interface
5109
5110 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5111 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5112
5113 =item Submitting patches
5114
5115 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5116 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5117
5118 =item Finding Your Way Around
5119
5120 Core modules, Tests, Documentation, Configure, Interpreter
5121
5122 =item Elements of the interpreter
5123
5124 Startup, Parsing, Optimization, Running
5125
5126 =item Internal Variable Types
5127
5128 =item Op Trees
5129
5130 =item Stacks
5131
5132 Argument stack, Mark stack, Save stack
5133
5134 =item Millions of Macros
5135
5136 =item Poking at Perl
5137
5138 =item Using a source-level debugger
5139
5140 run [args], break function_name, break source.c:xxx, step, next, continue,
5141 finish, 'enter', print
5142
5143 =item Dumping Perl Data Structures
5144
5145 =item Patching
5146
5147 =item Patching a core module
5148
5149 =item Adding a new function to the core
5150
5151 =item Writing a test
5152
5153 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5154 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5155
5156 =item Special Make Test Targets
5157
5158 coretest, test.deparse, minitest, test.third check.third utest.third
5159 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5160
5161 =back
5162
5163 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5164
5165 =over 4
5166
5167 =item Rational Software's Purify
5168
5169 =item Purify on Unix
5170
5171 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5172
5173 =item Purify on NT
5174
5175 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5176
5177 =item Compaq's/Digital's/HP's Third Degree
5178
5179 =item PERL_DESTRUCT_LEVEL
5180
5181 =item Profiling
5182
5183 =item Gprof Profiling
5184
5185 -a, -b, -e routine, -f routine, -s, -z
5186
5187 =item GCC gcov Profiling
5188
5189 =item Pixie Profiling
5190
5191 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5192 -z[ero]
5193
5194 =item Miscellaneous tricks
5195
5196 =item CONCLUSION
5197
5198 I<The Road goes ever on and on, down from the door where it began.>
5199
5200 =back
5201
5202 =item AUTHOR
5203
5204 =back
5205
5206 =head2 perlhist - the Perl history records
5207
5208 =over 4
5209
5210 =item DESCRIPTION
5211
5212 =item INTRODUCTION
5213
5214 =item THE KEEPERS OF THE PUMPKIN
5215
5216 =over 4
5217
5218 =item PUMPKIN?
5219
5220 =back
5221
5222 =item THE RECORDS
5223
5224 =over 4
5225
5226 =item SELECTED RELEASE SIZES
5227
5228 =item SELECTED PATCH SIZES
5229
5230 =back
5231
5232 =item THE KEEPERS OF THE RECORDS
5233
5234 =back
5235
5236 =head2 perldelta - what is new for perl v5.8.0
5237
5238 =over 4
5239
5240 =item DESCRIPTION
5241
5242 =item Highlights In 5.8.0
5243
5244 =item Incompatible Changes
5245
5246 =over 4
5247
5248 =item Binary Incompatibility
5249
5250 =item 64-bit platforms and malloc
5251
5252 =item AIX Dynaloading
5253
5254 =item Attributes for C<my> variables now handled at run-time.
5255
5256 =item Socket Extension Dynamic in VMS
5257
5258 =item IEEE-format Floating Point Default on OpenVMS Alpha
5259
5260 =item New Unicode Properties
5261
5262 =item REF(...) Instead Of SCALAR(...)
5263
5264 =item pack/unpack D/F recycled
5265
5266 =item Deprecations
5267
5268 =back
5269
5270 =item Core Enhancements
5271
5272 =over 4
5273
5274 =item PerlIO is Now The Default
5275
5276 =item Restricted Hashes
5277
5278 =item Safe Signals
5279
5280 =item Unicode Overhaul
5281
5282 =item Understanding of Numbers
5283
5284 =item Arrays now always interpolate into double-quoted strings [561]
5285
5286 =item Miscellaneous Changes
5287
5288 =back
5289
5290 =item Modules and Pragmata
5291
5292 =over 4
5293
5294 =item New Modules and Pragmata
5295
5296 =item Updated And Improved Modules and Pragmata
5297
5298 =back
5299
5300 =item Utility Changes
5301
5302 =item New Documentation
5303
5304 =item Performance Enhancements
5305
5306 =item Installation and Configuration Improvements
5307
5308 =over 4
5309
5310 =item Generic Improvements
5311
5312 =item New Or Improved Platforms
5313
5314 =back
5315
5316 =item Selected Bug Fixes
5317
5318 =over 4
5319
5320 =item Platform Specific Changes and Fixes
5321
5322 =back
5323
5324 =item New or Changed Diagnostics
5325
5326 =item Changed Internals
5327
5328 =item Security Vulnerability Closed [561]
5329
5330 =item New Tests
5331
5332 =item Known Problems
5333
5334 =over 4
5335
5336 =item AIX
5337
5338 =item Alpha systems with old gccs fail several tests
5339
5340 =item AmigaOS
5341
5342 =item BeOS
5343
5344 =item Cygwin "unable to remap"
5345
5346 =item ext/threads/t/libc
5347
5348 =item FreeBSD built with ithreads coredumps reading large directories
5349
5350 =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
5351
5352 =item IRIX fails ext/List/Util/t/shuffle.t
5353
5354 =item Modifying $_ Inside for(..)
5355
5356 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5357
5358 =item lib/ftmp-security tests warn 'system possibly insecure'
5359
5360 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5361
5362 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5363
5364 =item Linux With Sfio Fails op/misc Test 48
5365
5366 =item libwww-perl (LWP) fails base/date #51
5367
5368 =item Mac OS X
5369
5370 =item op/sprintf tests 91, 129, and 130
5371
5372 =item Solaris 2.5
5373
5374 =item SUPER-UX (NEC SX)
5375
5376 =item Term::ReadKey not working on Win32
5377
5378 =item Failure of Thread (5.005-style) tests
5379
5380 =item Timing problems
5381
5382 =item UNICOS
5383
5384 =item UNICOS/mk
5385
5386 =item UTS
5387
5388 =item VOS (Stratus)
5389
5390 =item VMS
5391
5392 =item Win32
5393
5394 =item XML::Parser not working
5395
5396 =item z/OS (OS/390)
5397
5398 =item Localising Tied Arrays and Hashes Is Broken
5399
5400 =item Self-tying Problems
5401
5402 =item Building Extensions Can Fail Because Of Largefiles
5403
5404 =item Unicode Support on EBCDIC Still Spotty
5405
5406 =item The Compiler Suite Is Still Very Experimental
5407
5408 =item The Long Double Support Is Still Experimental
5409
5410 =item Seen In Perl 5.7 But Gone Now
5411
5412 =back
5413
5414 =item Reporting Bugs
5415
5416 =item SEE ALSO
5417
5418 =item HISTORY
5419
5420 =back
5421
5422 =head2 perl572delta - what's new for perl v5.7.2
5423
5424 =over 4
5425
5426 =item DESCRIPTION
5427
5428 =item Security Vulnerability Closed
5429
5430 =item Incompatible Changes
5431
5432 =over 4
5433
5434 =item 64-bit platforms and malloc
5435
5436 =item AIX Dynaloading
5437
5438 =item Socket Extension Dynamic in VMS
5439
5440 =item Different Definition of the Unicode Character Classes \p{In...}
5441
5442 =item Deprecations
5443
5444 =back
5445
5446 =item Core Enhancements
5447
5448 =item Modules and Pragmata
5449
5450 =over 4
5451
5452 =item New Modules and Distributions
5453
5454 =item Updated And Improved Modules and Pragmata
5455
5456 =back
5457
5458 =item Utility Changes
5459
5460 =item New Documentation
5461
5462 =item Installation and Configuration Improvements
5463
5464 =over 4
5465
5466 =item New Or Improved Platforms
5467
5468 =item Generic Improvements
5469
5470 =back
5471
5472 =item Selected Bug Fixes
5473
5474 =over 4
5475
5476 =item Platform Specific Changes and Fixes
5477
5478 =back
5479
5480 =item New or Changed Diagnostics
5481
5482 =item Source Code Enhancements
5483
5484 =over 4
5485
5486 =item MAGIC constants
5487
5488 =item Better commented code
5489
5490 =item Regex pre-/post-compilation items matched up
5491
5492 =item gcc -Wall
5493
5494 =back
5495
5496 =item New Tests
5497
5498 =item Known Problems
5499
5500 =over 4
5501
5502 =item AIX
5503
5504 =item Amiga Perl Invoking Mystery
5505
5506 =item lib/ftmp-security tests warn 'system possibly insecure'
5507
5508 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5509
5510 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5511
5512 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5513
5514 =item Linux With Sfio Fails op/misc Test 48
5515
5516 =item OS/390
5517
5518 =item op/sprintf tests 129 and 130
5519
5520 =item  Failure of Thread tests
5521
5522 =item UNICOS
5523
5524 =item UTS
5525
5526 =item VMS
5527
5528 =item Win32
5529
5530 =item Localising a Tied Variable Leaks Memory
5531
5532 =item Self-tying of Arrays and Hashes Is Forbidden
5533
5534 =item Variable Attributes are not Currently Usable for Tieing
5535
5536 =item Building Extensions Can Fail Because Of Largefiles
5537
5538 =item The Compiler Suite Is Still Experimental
5539
5540 =item The Long Double Support is Still Experimental
5541
5542 =back
5543
5544 =item Reporting Bugs
5545
5546 =item SEE ALSO
5547
5548 =item HISTORY
5549
5550 =back
5551
5552 =head2 perl571delta - what's new for perl v5.7.1
5553
5554 =over 4
5555
5556 =item DESCRIPTION
5557
5558 =item Security Vulnerability Closed
5559
5560 =item Incompatible Changes
5561
5562 =item Core Enhancements
5563
5564 =over 4
5565
5566 =item AUTOLOAD Is Now Lvaluable
5567
5568 =item PerlIO is Now The Default
5569
5570 =item Signals Are Now Safe
5571
5572 =back
5573
5574 =item Modules and Pragmata
5575
5576 =over 4
5577
5578 =item New Modules
5579
5580 =item Updated And Improved Modules and Pragmata
5581
5582 =back
5583
5584 =item Performance Enhancements
5585
5586 =item Utility Changes
5587
5588 =item New Documentation
5589
5590 =over 4
5591
5592 =item perlclib
5593
5594 =item perliol
5595
5596 =item README.aix
5597
5598 =item README.bs2000
5599
5600 =item README.macos
5601
5602 =item README.mpeix
5603
5604 =item README.solaris
5605
5606 =item README.vos
5607
5608 =item Porting/repository.pod
5609
5610 =back
5611
5612 =item Installation and Configuration Improvements
5613
5614 =over 4
5615
5616 =item New Or Improved Platforms
5617
5618 =item Generic Improvements
5619
5620 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5621 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5622 d_strtoq, d_u32align, d_ualarm, d_usleep
5623
5624 =back
5625
5626 =item Selected Bug Fixes
5627
5628 =over 4
5629
5630 =item Platform Specific Changes and Fixes
5631
5632 =back
5633
5634 =item New or Changed Diagnostics
5635
5636 =item Changed Internals
5637
5638 =item New Tests
5639
5640 =item Known Problems
5641
5642 =over 4
5643
5644 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5645
5646 =item lib/ftmp-security tests warn 'system possibly insecure'
5647
5648 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5649
5650 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5651
5652 =item lib/b test 19
5653
5654 =item Linux With Sfio Fails op/misc Test 48
5655
5656 =item sigaction test 13 in VMS
5657
5658 =item sprintf tests 129 and 130
5659
5660 =item  Failure of Thread tests
5661
5662 =item Localising a Tied Variable Leaks Memory
5663
5664 =item Self-tying of Arrays and Hashes Is Forbidden
5665
5666 =item Building Extensions Can Fail Because Of Largefiles
5667
5668 =item The Compiler Suite Is Still Experimental
5669
5670 =back
5671
5672 =item Reporting Bugs
5673
5674 =item SEE ALSO
5675
5676 =item HISTORY
5677
5678 =back
5679
5680 =head2 perl570delta - what's new for perl v5.7.0
5681
5682 =over 4
5683
5684 =item DESCRIPTION
5685
5686 =item Security Vulnerability Closed
5687
5688 =item Incompatible Changes
5689
5690 =item Core Enhancements
5691
5692 =item Modules and Pragmata
5693
5694 =over 4
5695
5696 =item New Modules
5697
5698 =item Updated And Improved Modules and Pragmata
5699
5700 =back
5701
5702 =item Utility Changes
5703
5704 =item New Documentation
5705
5706 =item Performance Enhancements
5707
5708 =item Installation and Configuration Improvements
5709
5710 =over 4
5711
5712 =item Generic Improvements
5713
5714 =back
5715
5716 =item Selected Bug Fixes
5717
5718 =over 4
5719
5720 =item Platform Specific Changes and Fixes
5721
5722 =back
5723
5724 =item New or Changed Diagnostics
5725
5726 =item Changed Internals
5727
5728 =item Known Problems
5729
5730 =over 4
5731
5732 =item Unicode Support Still Far From Perfect
5733
5734 =item EBCDIC Still A Lost Platform
5735
5736 =item Building Extensions Can Fail Because Of Largefiles
5737
5738 =item ftmp-security tests warn 'system possibly insecure'
5739
5740 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5741
5742 =item Long Doubles Still Don't Work In Solaris
5743
5744 =item Linux With Sfio Fails op/misc Test 48
5745
5746 =item Storable tests fail in some platforms
5747
5748 =item Threads Are Still Experimental
5749
5750 =item The Compiler Suite Is Still Experimental
5751
5752 =back
5753
5754 =item Reporting Bugs
5755
5756 =item SEE ALSO
5757
5758 =item HISTORY
5759
5760 =back
5761
5762 =head2 perl561delta - what's new for perl v5.6.x
5763
5764 =over 4
5765
5766 =item DESCRIPTION
5767
5768 =item Summary of changes between 5.6.0 and 5.6.1
5769
5770 =over 4
5771
5772 =item Security Issues
5773
5774 =item Core bug fixes
5775
5776 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5777 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5778 references to special variables, Lexical warnings, Spurious warnings and
5779 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5780 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5781 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5782 Module;>, Tests
5783
5784 =item Core features
5785
5786 =item Configuration issues
5787
5788 =item Documentation
5789
5790 =item Bundled modules
5791
5792 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5793 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5794 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5795 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5796
5797 =item Platform-specific improvements
5798
5799 NCR MP-RAS, NonStop-UX
5800
5801 =back
5802
5803 =item Core Enhancements
5804
5805 =over 4
5806
5807 =item Interpreter cloning, threads, and concurrency
5808
5809 =item Lexically scoped warning categories
5810
5811 =item Unicode and UTF-8 support
5812
5813 =item Support for interpolating named characters
5814
5815 =item "our" declarations
5816
5817 =item Support for strings represented as a vector of ordinals
5818
5819 =item Improved Perl version numbering system
5820
5821 =item New syntax for declaring subroutine attributes
5822
5823 =item File and directory handles can be autovivified
5824
5825 =item open() with more than two arguments
5826
5827 =item 64-bit support
5828
5829 =item Large file support
5830
5831 =item Long doubles
5832
5833 =item "more bits"
5834
5835 =item Enhanced support for sort() subroutines
5836
5837 =item C<sort $coderef @foo> allowed
5838
5839 =item File globbing implemented internally
5840
5841 =item Support for CHECK blocks
5842
5843 =item POSIX character class syntax [: :] supported
5844
5845 =item Better pseudo-random number generator
5846
5847 =item Improved C<qw//> operator
5848
5849 =item Better worst-case behavior of hashes
5850
5851 =item pack() format 'Z' supported
5852
5853 =item pack() format modifier '!' supported
5854
5855 =item pack() and unpack() support counted strings
5856
5857 =item Comments in pack() templates
5858
5859 =item Weak references
5860
5861 =item Binary numbers supported
5862
5863 =item Lvalue subroutines
5864
5865 =item Some arrows may be omitted in calls through references
5866
5867 =item Boolean assignment operators are legal lvalues
5868
5869 =item exists() is supported on subroutine names
5870
5871 =item exists() and delete() are supported on array elements
5872
5873 =item Pseudo-hashes work better
5874
5875 =item Automatic flushing of output buffers
5876
5877 =item Better diagnostics on meaningless filehandle operations
5878
5879 =item Where possible, buffered data discarded from duped input filehandle
5880
5881 =item eof() has the same old magic as <>
5882
5883 =item binmode() can be used to set :crlf and :raw modes
5884
5885 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5886
5887 =item system(), backticks and pipe open now reflect exec() failure
5888
5889 =item Improved diagnostics
5890
5891 =item Diagnostics follow STDERR
5892
5893 =item More consistent close-on-exec behavior
5894
5895 =item syswrite() ease-of-use
5896
5897 =item Better syntax checks on parenthesized unary operators
5898
5899 =item Bit operators support full native integer width
5900
5901 =item Improved security features
5902
5903 =item More functional bareword prototype (*)
5904
5905 =item C<require> and C<do> may be overridden
5906
5907 =item $^X variables may now have names longer than one character
5908
5909 =item New variable $^C reflects C<-c> switch
5910
5911 =item New variable $^V contains Perl version as a string
5912
5913 =item Optional Y2K warnings
5914
5915 =item Arrays now always interpolate into double-quoted strings
5916
5917 =back
5918
5919 =item Modules and Pragmata
5920
5921 =over 4
5922
5923 =item Modules
5924
5925 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5926 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5927 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5928 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5929 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5930 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5931 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5932 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5933
5934 =item Pragmata
5935
5936 =back
5937
5938 =item Utility Changes
5939
5940 =over 4
5941
5942 =item dprofpp
5943
5944 =item find2perl
5945
5946 =item h2xs
5947
5948 =item perlcc
5949
5950 =item perldoc
5951
5952 =item The Perl Debugger
5953
5954 =back
5955
5956 =item Improved Documentation
5957
5958 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5959 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5960 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5961 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5962
5963 =item Performance enhancements
5964
5965 =over 4
5966
5967 =item Simple sort() using { $a <=> $b } and the like are optimized
5968
5969 =item Optimized assignments to lexical variables
5970
5971 =item Faster subroutine calls
5972
5973 =item delete(), each(), values() and hash iteration are faster
5974
5975 =back
5976
5977 =item Installation and Configuration Improvements
5978
5979 =over 4
5980
5981 =item -Dusethreads means something different
5982
5983 =item New Configure flags
5984
5985 =item Threadedness and 64-bitness now more daring
5986
5987 =item Long Doubles
5988
5989 =item -Dusemorebits
5990
5991 =item -Duselargefiles
5992
5993 =item installusrbinperl
5994
5995 =item SOCKS support
5996
5997 =item C<-A> flag
5998
5999 =item Enhanced Installation Directories
6000
6001 =item gcc automatically tried if 'cc' does not seem to be working
6002
6003 =back
6004
6005 =item Platform specific changes
6006
6007 =over 4
6008
6009 =item Supported platforms
6010
6011 =item DOS
6012
6013 =item OS390 (OpenEdition MVS)
6014
6015 =item VMS
6016
6017 =item Win32
6018
6019 =back
6020
6021 =item Significant bug fixes
6022
6023 =over 4
6024
6025 =item <HANDLE> on empty files
6026
6027 =item C<eval '...'> improvements
6028
6029 =item All compilation errors are true errors
6030
6031 =item Implicitly closed filehandles are safer
6032
6033 =item Behavior of list slices is more consistent
6034
6035 =item C<(\$)> prototype and C<$foo{a}>
6036
6037 =item C<goto &sub> and AUTOLOAD
6038
6039 =item C<-bareword> allowed under C<use integer>
6040
6041 =item Failures in DESTROY()
6042
6043 =item Locale bugs fixed
6044
6045 =item Memory leaks
6046
6047 =item Spurious subroutine stubs after failed subroutine calls
6048
6049 =item Taint failures under C<-U>
6050
6051 =item END blocks and the C<-c> switch
6052
6053 =item Potential to leak DATA filehandles
6054
6055 =back
6056
6057 =item New or Changed Diagnostics
6058
6059 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6060 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6061 / cannot take a count, / must be followed by a, A or Z, / must be followed
6062 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6063 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6064 passed through, /%s/ should probably be written as "%s", %s() called too
6065 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6066 argument is not a HASH or ARRAY element or slice, %s argument is not a
6067 subroutine name, %s package attribute may clash with future reserved word:
6068 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6069 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6070 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6071 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6072 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6073 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6074 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6075 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6076 weaken a nonreference, Character class [:%s:] unknown, Character class
6077 syntax [%s] belongs inside character classes, Constant is not %s reference,
6078 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6079 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6080 "local" instead of "our"?), Document contains no data, entering effective
6081 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6082 output, flock() on closed filehandle %s, Global symbol "%s" requires
6083 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6084 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6085 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6086 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6087 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6088 separator character %s in attribute list, Invalid separator character %s in
6089 subroutine attribute list, leaving effective %s failed, Lvalue subs
6090 returning %s not implemented yet, Method %s not permitted, Missing
6091 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6092 No %s specified for -%c, No package name allowed for variable %s in "our",
6093 No space allowed after -%c, no UTC offset information; assuming local time
6094 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6095 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6096 around "%s" list, Possible unintended interpolation of %s in string,
6097 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6098 instead, Premature end of script headers, Repeat count in pack overflows,
6099 Repeat count in unpack overflows, realloc() of freed memory ignored,
6100 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6101 zero-length expression, switching effective %s is not implemented, This
6102 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6103 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6104 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6105 escape \\%c passed through, Unterminated attribute parameter in attribute
6106 list, Unterminated attribute list, Unterminated attribute parameter in
6107 subroutine attribute list, Unterminated subroutine attribute list, Value of
6108 CLI symbol "%s" too long, Version number must be a constant number
6109
6110 =item New tests
6111
6112 =item Incompatible Changes
6113
6114 =over 4
6115
6116 =item Perl Source Incompatibilities
6117
6118 CHECK is a new keyword, Treatment of list slices of undef has changed,
6119 Format of $English::PERL_VERSION is different, Literals of the form
6120 C<1.2.3> parse differently, Possibly changed pseudo-random number
6121 generator, Hashing function for hash keys has changed, C<undef> fails on
6122 read only values, Close-on-exec bit may be set on pipe and socket handles,
6123 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6124 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6125 Text of some diagnostic output has changed, C<%@> has been removed,
6126 Parenthesized not() behaves like a list operator, Semantics of bareword
6127 prototype C<(*)> have changed, Semantics of bit operators may have changed
6128 on 64-bit platforms, More builtins taint their results
6129
6130 =item C Source Incompatibilities
6131
6132 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6133
6134 =item Compatible C Source API Changes
6135
6136 C<PATCHLEVEL> is now C<PERL_VERSION>
6137
6138 =item Binary Incompatibilities
6139
6140 =back
6141
6142 =item Known Problems
6143
6144 =over 4
6145
6146 =item Localizing a tied hash element may leak memory
6147
6148 =item Known test failures
6149
6150 =item EBCDIC platforms not fully supported
6151
6152 =item UNICOS/mk CC failures during Configure run
6153
6154 =item Arrow operator and arrays
6155
6156 =item Experimental features
6157
6158 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6159 pseudo-hash data type, The Compiler suite, Internal implementation of file
6160 globbing, The DB module, The regular expression code constructs:
6161
6162 =back
6163
6164 =item Obsolete Diagnostics
6165
6166 Character class syntax [: :] is reserved for future extensions, Ill-formed
6167 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6168 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6169 to mean "${$}<digit>" is deprecated
6170
6171 =item Reporting Bugs
6172
6173 =item SEE ALSO
6174
6175 =item HISTORY
6176
6177 =back
6178
6179 =head2 perl56delta - what's new for perl v5.6.0
6180
6181 =over 4
6182
6183 =item DESCRIPTION
6184
6185 =item Core Enhancements
6186
6187 =over 4
6188
6189 =item Interpreter cloning, threads, and concurrency
6190
6191 =item Lexically scoped warning categories
6192
6193 =item Unicode and UTF-8 support
6194
6195 =item Support for interpolating named characters
6196
6197 =item "our" declarations
6198
6199 =item Support for strings represented as a vector of ordinals
6200
6201 =item Improved Perl version numbering system
6202
6203 =item New syntax for declaring subroutine attributes
6204
6205 =item File and directory handles can be autovivified
6206
6207 =item open() with more than two arguments
6208
6209 =item 64-bit support
6210
6211 =item Large file support
6212
6213 =item Long doubles
6214
6215 =item "more bits"
6216
6217 =item Enhanced support for sort() subroutines
6218
6219 =item C<sort $coderef @foo> allowed
6220
6221 =item File globbing implemented internally
6222
6223 =item Support for CHECK blocks
6224
6225 =item POSIX character class syntax [: :] supported
6226
6227 =item Better pseudo-random number generator
6228
6229 =item Improved C<qw//> operator
6230
6231 =item Better worst-case behavior of hashes
6232
6233 =item pack() format 'Z' supported
6234
6235 =item pack() format modifier '!' supported
6236
6237 =item pack() and unpack() support counted strings
6238
6239 =item Comments in pack() templates
6240
6241 =item Weak references
6242
6243 =item Binary numbers supported
6244
6245 =item Lvalue subroutines
6246
6247 =item Some arrows may be omitted in calls through references
6248
6249 =item Boolean assignment operators are legal lvalues
6250
6251 =item exists() is supported on subroutine names
6252
6253 =item exists() and delete() are supported on array elements
6254
6255 =item Pseudo-hashes work better
6256
6257 =item Automatic flushing of output buffers
6258
6259 =item Better diagnostics on meaningless filehandle operations
6260
6261 =item Where possible, buffered data discarded from duped input filehandle
6262
6263 =item eof() has the same old magic as <>
6264
6265 =item binmode() can be used to set :crlf and :raw modes
6266
6267 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6268
6269 =item system(), backticks and pipe open now reflect exec() failure
6270
6271 =item Improved diagnostics
6272
6273 =item Diagnostics follow STDERR
6274
6275 =item More consistent close-on-exec behavior
6276
6277 =item syswrite() ease-of-use
6278
6279 =item Better syntax checks on parenthesized unary operators
6280
6281 =item Bit operators support full native integer width
6282
6283 =item Improved security features
6284
6285 =item More functional bareword prototype (*)
6286
6287 =item C<require> and C<do> may be overridden
6288
6289 =item $^X variables may now have names longer than one character
6290
6291 =item New variable $^C reflects C<-c> switch
6292
6293 =item New variable $^V contains Perl version as a string
6294
6295 =item Optional Y2K warnings
6296
6297 =item Arrays now always interpolate into double-quoted strings
6298
6299 =back
6300
6301 =item Modules and Pragmata
6302
6303 =over 4
6304
6305 =item Modules
6306
6307 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6308 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6309 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6310 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6311 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6312 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6313 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6314 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6315
6316 =item Pragmata
6317
6318 =back
6319
6320 =item Utility Changes
6321
6322 =over 4
6323
6324 =item dprofpp
6325
6326 =item find2perl
6327
6328 =item h2xs
6329
6330 =item perlcc
6331
6332 =item perldoc
6333
6334 =item The Perl Debugger
6335
6336 =back
6337
6338 =item Improved Documentation
6339
6340 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6341 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6342 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6343 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6344
6345 =item Performance enhancements
6346
6347 =over 4
6348
6349 =item Simple sort() using { $a <=> $b } and the like are optimized
6350
6351 =item Optimized assignments to lexical variables
6352
6353 =item Faster subroutine calls
6354
6355 =item delete(), each(), values() and hash iteration are faster
6356
6357 =back
6358
6359 =item Installation and Configuration Improvements
6360
6361 =over 4
6362
6363 =item -Dusethreads means something different
6364
6365 =item New Configure flags
6366
6367 =item Threadedness and 64-bitness now more daring
6368
6369 =item Long Doubles
6370
6371 =item -Dusemorebits
6372
6373 =item -Duselargefiles
6374
6375 =item installusrbinperl
6376
6377 =item SOCKS support
6378
6379 =item C<-A> flag
6380
6381 =item Enhanced Installation Directories
6382
6383 =back
6384
6385 =item Platform specific changes
6386
6387 =over 4
6388
6389 =item Supported platforms
6390
6391 =item DOS
6392
6393 =item OS390 (OpenEdition MVS)
6394
6395 =item VMS
6396
6397 =item Win32
6398
6399 =back
6400
6401 =item Significant bug fixes
6402
6403 =over 4
6404
6405 =item <HANDLE> on empty files
6406
6407 =item C<eval '...'> improvements
6408
6409 =item All compilation errors are true errors
6410
6411 =item Implicitly closed filehandles are safer
6412
6413 =item Behavior of list slices is more consistent
6414
6415 =item C<(\$)> prototype and C<$foo{a}>
6416
6417 =item C<goto &sub> and AUTOLOAD
6418
6419 =item C<-bareword> allowed under C<use integer>
6420
6421 =item Failures in DESTROY()
6422
6423 =item Locale bugs fixed
6424
6425 =item Memory leaks
6426
6427 =item Spurious subroutine stubs after failed subroutine calls
6428
6429 =item Taint failures under C<-U>
6430
6431 =item END blocks and the C<-c> switch
6432
6433 =item Potential to leak DATA filehandles
6434
6435 =back
6436
6437 =item New or Changed Diagnostics
6438
6439 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6440 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6441 / cannot take a count, / must be followed by a, A or Z, / must be followed
6442 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6443 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6444 passed through, /%s/ should probably be written as "%s", %s() called too
6445 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6446 argument is not a HASH or ARRAY element or slice, %s argument is not a
6447 subroutine name, %s package attribute may clash with future reserved word:
6448 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6449 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6450 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6451 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6452 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6453 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6454 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6455 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6456 weaken a nonreference, Character class [:%s:] unknown, Character class
6457 syntax [%s] belongs inside character classes, Constant is not %s reference,
6458 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6459 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6460 "local" instead of "our"?), Document contains no data, entering effective
6461 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6462 output, flock() on closed filehandle %s, Global symbol "%s" requires
6463 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6464 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6465 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6466 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6467 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6468 separator character %s in attribute list, Invalid separator character %s in
6469 subroutine attribute list, leaving effective %s failed, Lvalue subs
6470 returning %s not implemented yet, Method %s not permitted, Missing
6471 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6472 No %s specified for -%c, No package name allowed for variable %s in "our",
6473 No space allowed after -%c, no UTC offset information; assuming local time
6474 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6475 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6476 around "%s" list, Possible unintended interpolation of %s in string,
6477 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6478 instead, Premature end of script headers, Repeat count in pack overflows,
6479 Repeat count in unpack overflows, realloc() of freed memory ignored,
6480 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6481 zero-length expression, switching effective %s is not implemented, This
6482 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6483 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6484 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6485 escape \\%c passed through, Unterminated attribute parameter in attribute
6486 list, Unterminated attribute list, Unterminated attribute parameter in
6487 subroutine attribute list, Unterminated subroutine attribute list, Value of
6488 CLI symbol "%s" too long, Version number must be a constant number
6489
6490 =item New tests
6491
6492 =item Incompatible Changes
6493
6494 =over 4
6495
6496 =item Perl Source Incompatibilities
6497
6498 CHECK is a new keyword, Treatment of list slices of undef has changed,
6499 Format of $English::PERL_VERSION is different, Literals of the form
6500 C<1.2.3> parse differently, Possibly changed pseudo-random number
6501 generator, Hashing function for hash keys has changed, C<undef> fails on
6502 read only values, Close-on-exec bit may be set on pipe and socket handles,
6503 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6504 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6505 Text of some diagnostic output has changed, C<%@> has been removed,
6506 Parenthesized not() behaves like a list operator, Semantics of bareword
6507 prototype C<(*)> have changed, Semantics of bit operators may have changed
6508 on 64-bit platforms, More builtins taint their results
6509
6510 =item C Source Incompatibilities
6511
6512 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6513
6514 =item Compatible C Source API Changes
6515
6516 C<PATCHLEVEL> is now C<PERL_VERSION>
6517
6518 =item Binary Incompatibilities
6519
6520 =back
6521
6522 =item Known Problems
6523
6524 =over 4
6525
6526 =item Thread test failures
6527
6528 =item EBCDIC platforms not supported
6529
6530 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6531
6532 =item NEXTSTEP 3.3 POSIX test failure
6533
6534 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6535 gcc
6536
6537 =item UNICOS/mk CC failures during Configure run
6538
6539 =item Arrow operator and arrays
6540
6541 =item Experimental features
6542
6543 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6544 pseudo-hash data type, The Compiler suite, Internal implementation of file
6545 globbing, The DB module, The regular expression code constructs:
6546
6547 =back
6548
6549 =item Obsolete Diagnostics
6550
6551 Character class syntax [: :] is reserved for future extensions, Ill-formed
6552 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6553 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6554 to mean "${$}<digit>" is deprecated
6555
6556 =item Reporting Bugs
6557
6558 =item SEE ALSO
6559
6560 =item HISTORY
6561
6562 =back
6563
6564 =head2 perl5005delta - what's new for perl5.005
6565
6566 =over 4
6567
6568 =item DESCRIPTION
6569
6570 =item About the new versioning system
6571
6572 =item Incompatible Changes
6573
6574 =over 4
6575
6576 =item WARNING:  This version is not binary compatible with Perl 5.004.
6577
6578 =item Default installation structure has changed
6579
6580 =item Perl Source Compatibility
6581
6582 =item C Source Compatibility
6583
6584 =item Binary Compatibility
6585
6586 =item Security fixes may affect compatibility
6587
6588 =item Relaxed new mandatory warnings introduced in 5.004
6589
6590 =item Licensing
6591
6592 =back
6593
6594 =item Core Changes
6595
6596 =over 4
6597
6598 =item Threads
6599
6600 =item Compiler
6601
6602 =item Regular Expressions
6603
6604 Many new and improved optimizations, Many bug fixes, New regular expression
6605 constructs, New operator for precompiled regular expressions, Other
6606 improvements, Incompatible changes
6607
6608 =item   Improved malloc()
6609
6610 =item Quicksort is internally implemented
6611
6612 =item Reliable signals
6613
6614 =item Reliable stack pointers
6615
6616 =item More generous treatment of carriage returns
6617
6618 =item Memory leaks
6619
6620 =item Better support for multiple interpreters
6621
6622 =item Behavior of local() on array and hash elements is now well-defined
6623
6624 =item C<%!> is transparently tied to the L<Errno> module
6625
6626 =item Pseudo-hashes are supported
6627
6628 =item C<EXPR foreach EXPR> is supported
6629
6630 =item Keywords can be globally overridden
6631
6632 =item C<$^E> is meaningful on Win32
6633
6634 =item C<foreach (1..1000000)> optimized
6635
6636 =item C<Foo::> can be used as implicitly quoted package name
6637
6638 =item C<exists $Foo::{Bar::}> tests existence of a package
6639
6640 =item Better locale support
6641
6642 =item Experimental support for 64-bit platforms
6643
6644 =item prototype() returns useful results on builtins
6645
6646 =item Extended support for exception handling
6647
6648 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6649
6650 =item All C<printf> format conversions are handled internally
6651
6652 =item New C<INIT> keyword
6653
6654 =item New C<lock> keyword
6655
6656 =item New C<qr//> operator
6657
6658 =item C<our> is now a reserved word
6659
6660 =item Tied arrays are now fully supported
6661
6662 =item Tied handles support is better
6663
6664 =item 4th argument to substr
6665
6666 =item Negative LENGTH argument to splice
6667
6668 =item Magic lvalues are now more magical
6669
6670 =item <> now reads in records
6671
6672 =back
6673
6674 =item Supported Platforms
6675
6676 =over 4
6677
6678 =item New Platforms
6679
6680 =item Changes in existing support
6681
6682 =back
6683
6684 =item Modules and Pragmata
6685
6686 =over 4
6687
6688 =item New Modules
6689
6690 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6691 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6692 Thread, attrs, fields, re
6693
6694 =item Changes in existing modules
6695
6696 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6697 MakeMaker, CPAN, Cwd
6698
6699 =back
6700
6701 =item Utility Changes
6702
6703 =item Documentation Changes
6704
6705 =item New Diagnostics
6706
6707 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6708 while coercing array into hash, Bareword "%s" refers to nonexistent
6709 package, Can't call method "%s" on an undefined value, Can't check
6710 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6711 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6712 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6713 for "%s", Character class syntax [. .] is reserved for future extensions,
6714 Character class syntax [: :] is reserved for future extensions, Character
6715 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6716 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6717 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6718 package main), Illegal hex digit ignored, No such array field, No such
6719 field "%s" in variable %s of type %s, Out of memory during ridiculously
6720 large request, Range iterator outside integer range, Recursive inheritance
6721 detected while looking for method '%s' %s, Reference found where even-sized
6722 list expected, Undefined value assigned to typeglob, Use of reserved word
6723 "%s" is deprecated, perl: warning: Setting locale failed
6724
6725 =item Obsolete Diagnostics
6726
6727 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6728 temporary file, regexp too big
6729
6730 =item Configuration Changes
6731
6732 =item BUGS
6733
6734 =item SEE ALSO
6735
6736 =item HISTORY
6737
6738 =back
6739
6740 =head2 perl5004delta - what's new for perl5.004
6741
6742 =over 4
6743
6744 =item DESCRIPTION
6745
6746 =item Supported Environments
6747
6748 =item Core Changes
6749
6750 =over 4
6751
6752 =item List assignment to %ENV works
6753
6754 =item Change to "Can't locate Foo.pm in @INC" error
6755
6756 =item Compilation option: Binary compatibility with 5.003
6757
6758 =item $PERL5OPT environment variable
6759
6760 =item Limitations on B<-M>, B<-m>, and B<-T> options
6761
6762 =item More precise warnings
6763
6764 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6765
6766 =item Previously deprecated %OVERLOAD is no longer usable
6767
6768 =item Subroutine arguments created only when they're modified
6769
6770 =item Group vector changeable with C<$)>
6771
6772 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6773
6774 =item Fixed localization of $<digit>, $&, etc.
6775
6776 =item No resetting of $. on implicit close
6777
6778 =item C<wantarray> may return undef
6779
6780 =item C<eval EXPR> determines value of EXPR in scalar context
6781
6782 =item Changes to tainting checks
6783
6784 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6785 spawning if tainted $TERM doesn't look like a terminal name
6786
6787 =item New Opcode module and revised Safe module
6788
6789 =item Embedding improvements
6790
6791 =item Internal change: FileHandle class based on IO::* classes
6792
6793 =item Internal change: PerlIO abstraction interface
6794
6795 =item New and changed syntax
6796
6797 $coderef->(PARAMS)
6798
6799 =item New and changed builtin constants
6800
6801 __PACKAGE__
6802
6803 =item New and changed builtin variables
6804
6805 $^E, $^H, $^M
6806
6807 =item New and changed builtin functions
6808
6809 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6810 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6811 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6812 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6813 nested C<sub{}> closures work now, formats work right on changing lexicals
6814
6815 =item New builtin methods
6816
6817 isa(CLASS), can(METHOD), VERSION( [NEED] )
6818
6819 =item TIEHANDLE now supported
6820
6821 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6822 LIST, READLINE this, GETC this, DESTROY this
6823
6824 =item Malloc enhancements
6825
6826 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6827
6828 =item Miscellaneous efficiency enhancements
6829
6830 =back
6831
6832 =item Support for More Operating Systems
6833
6834 =over 4
6835
6836 =item Win32
6837
6838 =item Plan 9
6839
6840 =item QNX
6841
6842 =item AmigaOS
6843
6844 =back
6845
6846 =item Pragmata
6847
6848 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6849 constant NAME => VALUE, use locale, use ops, use vmsish
6850
6851 =item Modules
6852
6853 =over 4
6854
6855 =item Required Updates
6856
6857 =item Installation directories
6858
6859 =item Module information summary
6860
6861 =item Fcntl
6862
6863 =item IO
6864
6865 =item Math::Complex
6866
6867 =item Math::Trig
6868
6869 =item DB_File
6870
6871 =item Net::Ping
6872
6873 =item Object-oriented overrides for builtin operators
6874
6875 =back
6876
6877 =item Utility Changes
6878
6879 =over 4
6880
6881 =item pod2html
6882
6883 Sends converted HTML to standard output
6884
6885 =item xsubpp
6886
6887 C<void> XSUBs now default to returning nothing
6888
6889 =back
6890
6891 =item C Language API Changes
6892
6893 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6894 manipulating hashes
6895
6896 =item Documentation Changes
6897
6898 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6899 L<perlmodlib>, L<perldebug>, L<perlsec>
6900
6901 =item New Diagnostics
6902
6903 "my" variable %s masks earlier declaration in same scope, %s argument is
6904 not a HASH element or slice, Allocation too large: %lx, Allocation too
6905 large, Applying %s to %s will act on scalar(%s), Attempt to free
6906 nonexistent shared string, Attempt to use reference as lvalue in substr,
6907 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6908 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6909 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6910 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6911 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6912 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6913 %s, Integer overflow in hex number, Integer overflow in octal number,
6914 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6915 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6916 possible typo, Null picture in formline, Offset outside string, Out of
6917 memory!, Out of memory during request for %s, panic: frexp, Possible
6918 attempt to put comments in qw() list, Possible attempt to separate words
6919 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6920 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6921 option, untie attempted while %d inner references still exist, Unrecognized
6922 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6923 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6924 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6925 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6926 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6927 long, Process terminated by SIG%s
6928
6929 =item BUGS
6930
6931 =item SEE ALSO
6932
6933 =item HISTORY
6934
6935 =back
6936
6937 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6938
6939 =over 4
6940
6941 =item DESCRIPTION
6942
6943 =over 4
6944
6945 =item Compiling Perl 5 on AIX
6946
6947 =item OS level
6948
6949 =item Building Dynamic Extensions on AIX
6950
6951 =item The IBM ANSI C Compiler
6952
6953 =item Using GNU's gcc for building perl
6954
6955 =item Using Large Files with Perl
6956
6957 =item Threaded Perl
6958
6959 =item 64-bit Perl
6960
6961 =item AIX 4.2 and extensions using C++ with statics
6962
6963 =back
6964
6965 =item AUTHOR
6966
6967 =item DATE
6968
6969 =back
6970
6971 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6972
6973 =over 4
6974
6975 =item DESCRIPTION
6976
6977 =item AUTHOR
6978
6979 =back
6980
6981 =head2 perlamiga - Perl under Amiga OS
6982
6983 =over 4
6984
6985 =item SYNOPSIS
6986
6987 =back
6988
6989 =over 4
6990
6991 =item DESCRIPTION
6992
6993 =over 4
6994
6995 =item Prerequisites for Compiling Perl on AmigaOS
6996
6997 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
6998
6999 =item Starting Perl programs under AmigaOS
7000
7001 =item Shortcomings of Perl under AmigaOS
7002
7003 =back
7004
7005 =item INSTALLATION
7006
7007 =item Accessing documentation
7008
7009 =over 4
7010
7011 =item Manpages for Perl on AmigaOS
7012
7013 =item Perl HTML Documentation on AmigaOS
7014
7015 =item Perl GNU Info Files on AmigaOS
7016
7017 =item Perl LaTeX Documentation on AmigaOS
7018
7019 =back
7020
7021 =item BUILDING PERL ON AMIGAOS
7022
7023 =over 4
7024
7025 =item Build Prerequisites for Perl on AmigaOS
7026
7027 =item Getting the Perl Source for AmigaOS
7028
7029 =item Making Perl on AmigaOS
7030
7031 =item Testing Perl on AmigaOS
7032
7033 =item Installing the built Perl on AmigaOS
7034
7035 =back
7036
7037 =item AUTHORS
7038
7039 =item SEE ALSO
7040
7041 =back
7042
7043 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7044
7045 =over 4
7046
7047 =item DESCRIPTION
7048
7049 =over 4
7050
7051 =item General Issues with Perl on BeOS
7052
7053 =item BeOS Release-specific Notes
7054
7055 R4 x86, R4 PPC
7056
7057 =item Contact Information
7058
7059 =item Update 2002-05-30
7060
7061 =back
7062
7063 =back
7064
7065 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7066
7067 =over 4
7068
7069 =item SYNOPSIS
7070
7071 =item DESCRIPTION
7072
7073 =over 4
7074
7075 =item gzip on BS2000
7076
7077 =item bison on BS2000
7078
7079 =item Unpacking Perl Distribution on BS2000
7080
7081 =item Compiling Perl on BS2000
7082
7083 =item Testing Perl on BS2000
7084
7085 =item Installing Perl on BS2000
7086
7087 =item Using Perl in the Posix-Shell of BS2000
7088
7089 =item Using Perl in "native" BS2000
7090
7091 =item Floating point anomalies on BS2000
7092
7093 =back
7094
7095 =item AUTHORS
7096
7097 =item SEE ALSO
7098
7099 =over 4
7100
7101 =item Mailing list
7102
7103 =back
7104
7105 =item HISTORY
7106
7107 =back
7108
7109 =over 4
7110
7111 =item Name
7112
7113 =item Description
7114
7115 =item Build
7116
7117 =over 4
7118
7119 =item Tools & SDK
7120
7121 =item Make
7122
7123 =back
7124
7125 =item Acknowledgements
7126
7127 =item Author
7128
7129 =back
7130
7131 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7132
7133 =over 4
7134
7135 =item SYNOPSIS
7136
7137 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7138
7139 =over 4
7140
7141 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7142
7143 =item Cygwin Configuration
7144
7145 C<PATH>, I<nroff>, Permissions
7146
7147 =back
7148
7149 =item CONFIGURE PERL ON CYGWIN
7150
7151 =over 4
7152
7153 =item Stripping Perl Binaries on Cygwin
7154
7155 =item Optional Libraries for Perl on Cygwin
7156
7157 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7158 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7159
7160 =item Configure-time Options for Perl on Cygwin
7161
7162 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7163 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7164 C<-Dmksymlinks>
7165
7166 =item Suspicious Warnings on Cygwin
7167
7168 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7169
7170 =back
7171
7172 =item MAKE ON CYGWIN
7173
7174 =over 4
7175
7176 =item Warnings on Cygwin
7177
7178 =item ld2 on Cygwin
7179
7180 =back
7181
7182 =item TEST ON CYGWIN
7183
7184 =over 4
7185
7186 =item File Permissions on Cygwin
7187
7188 =item Script Portability on Cygwin
7189
7190 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7191
7192 =back
7193
7194 =item INSTALL PERL ON CYGWIN
7195
7196 =item MANIFEST ON CYGWIN
7197
7198 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7199 Source, Compiled Module Source, Perl Modules/Scripts
7200
7201 =item BUGS ON CYGWIN
7202
7203 =item AUTHORS
7204
7205 =item HISTORY
7206
7207 =back
7208
7209 =head2 perldgux - Perl under DG/UX.
7210
7211 =over 4
7212
7213 =item SYNOPSIS
7214
7215 =back
7216
7217 =over 4
7218
7219 =item DESCRIPTION
7220
7221 =item BUILDING PERL ON DG/UX
7222
7223 =over 4
7224
7225 =item Non-threaded Perl on DG/UX
7226
7227 =item Threaded Perl on DG/UX
7228
7229 =item Testing Perl on DG/UX
7230
7231 =item Installing the built perl on DG/UX
7232
7233 =back
7234
7235 =item AUTHOR
7236
7237 =item SEE ALSO
7238
7239 =back
7240
7241 =head2 perldos - Perl under DOS, W31, W95.
7242
7243 =over 4
7244
7245 =item SYNOPSIS
7246
7247 =item DESCRIPTION
7248
7249 =over 4
7250
7251 =item Prerequisites for Compiling Perl on DOS
7252
7253 DJGPP, Pthreads
7254
7255 =item Shortcomings of Perl under DOS
7256
7257 =item Building Perl on DOS
7258
7259 =item Testing Perl on DOS
7260
7261 =item Installation of Perl on DOS
7262
7263 =back
7264
7265 =item BUILDING AND INSTALLING MODULES ON DOS
7266
7267 =over 4
7268
7269 =item Building Prerequisites for Perl on DOS
7270
7271 =item Unpacking CPAN Modules on DOS
7272
7273 =item Building Non-XS Modules on DOS
7274
7275 =item Building XS Modules on DOS
7276
7277 =back
7278
7279 =item AUTHOR
7280
7281 =item SEE ALSO
7282
7283 =back
7284
7285 =head2 perlepoc, README.epoc - Perl for EPOC
7286
7287 =over 4
7288
7289 =item SYNOPSIS
7290
7291 =item INTRODUCTION
7292
7293 =item INSTALLING PERL ON EPOC
7294
7295 =item STARTING PERL ON EPOC
7296
7297 =over 4
7298
7299 =item Editors on Epoc
7300
7301 =item Features of Perl on Epoc
7302
7303 =item Restrictions of Perl on Epoc
7304
7305 =item Compiling Perl 5 on the EPOC cross compiling environment
7306
7307 =back
7308
7309 =item SUPPORT STATUS OF PERL ON EPOC
7310
7311 =item AUTHOR
7312
7313 =item LAST UPDATE
7314
7315 =back
7316
7317 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7318
7319 =over 4
7320
7321 =item DESCRIPTION
7322
7323 =over 4
7324
7325 =item FreeBSD core dumps from readdir_r with ithreads
7326
7327 =item $^X doesn't always contain a full path in FreeBSD
7328
7329 =item Perl will no more be part of "base FreeBSD"
7330
7331 =back
7332
7333 =item AUTHOR
7334
7335 =back
7336
7337 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7338 (HP-UX) systems
7339
7340 =over 4
7341
7342 =item DESCRIPTION
7343
7344 =over 4
7345
7346 =item Using perl as shipped with HP-UX
7347
7348 =item Compiling Perl 5 on HP-UX
7349
7350 =item PA-RISC
7351
7352 =item PA-RISC 1.0
7353
7354 =item PA-RISC 1.1
7355
7356 =item PA-RISC 2.0
7357
7358 =item Itanium
7359
7360 =item Portability Between PA-RISC Versions
7361
7362 =item Itanium Processor Family and HP-UX
7363
7364 =item Building Dynamic Extensions on HP-UX
7365
7366 =item The HP ANSI C Compiler
7367
7368 =item The GNU C Compiler
7369
7370 =item Using Large Files with Perl on HP-UX
7371
7372 =item Threaded Perl on HP-UX
7373
7374 =item 64-bit Perl on HP-UX
7375
7376 =item Oracle on HP-UX
7377
7378 =item GDBM and Threads on HP-UX
7379
7380 =item NFS filesystems and utime(2) on HP-UX
7381
7382 =item perl -P and // and HP-UX
7383
7384 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7385
7386 =back
7387
7388 =item nss_delete core dump from op/pwent or op/grent
7389
7390 =item AUTHOR
7391
7392 =item DATE
7393
7394 =back
7395
7396 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7397
7398 =over 4
7399
7400 =item DESCRIPTION
7401
7402 =over 4
7403
7404 =item Known Problems with Perl on Hurd 
7405
7406 =back
7407
7408 =item AUTHOR
7409
7410 =back
7411
7412 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7413
7414 =over 4
7415
7416 =item DESCRIPTION
7417
7418 =over 4
7419
7420 =item Building 32-bit Perl in Irix
7421
7422 =item Building 64-bit Perl in Irix
7423
7424 =item About Compiler Versions of Irix
7425
7426 =item Linker Problems in Irix
7427
7428 =item Malloc in Irix
7429
7430 =item Building with threads
7431
7432 =back
7433
7434 =item AUTHOR
7435
7436 =back
7437
7438 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7439 systems
7440
7441 =over 4
7442
7443 =item DESCRIPTION
7444
7445 =over 4
7446
7447 =item Compiling Perl 5 on MachTen
7448
7449 =item Failures during C<make test> on MachTen
7450
7451 op/lexassign.t, pragma/warnings.t
7452
7453 =item Building external modules on MachTen
7454
7455 =back
7456
7457 =item AUTHOR
7458
7459 =item DATE
7460
7461 =back
7462
7463 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7464
7465 =over 4
7466
7467 =item SYNOPSIS
7468
7469 =item DESCRIPTION
7470
7471 =item AUTHOR
7472
7473 =item DATE
7474
7475 =back
7476
7477 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7478
7479 =over 4
7480
7481 =item DESCRIPTION
7482
7483 =item Known problems with Perl on MiNT
7484
7485 =item AUTHOR
7486
7487 =back
7488
7489 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7490
7491 =over 4
7492
7493 =item SYNOPSIS
7494
7495 =item NOTE
7496
7497 =item Binary distribution from HP
7498
7499 =item What's New in Perl for MPE/iX
7500
7501 =item Welcome to Perl/iX
7502
7503 =item System Requirements for Perl/iX
7504
7505 =item How to Obtain Perl/iX
7506
7507 =item Perl/iX Distribution Contents Highlights
7508
7509 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7510 public_html/feedback.cgi, src/perl-5.6.0-mpe
7511
7512 =item How to Compile Perl/iX
7513
7514  4,  6
7515
7516 =item Getting Started with Perl/iX
7517
7518 =item MPE/iX Implementation Considerations
7519
7520 =item Known Perl/iX Bugs Under Investigation
7521
7522 =item Perl/iX To-Do List
7523
7524 =item Perl/iX Change History
7525
7526 =item AUTHOR
7527
7528 =item Name
7529
7530 =item Description
7531
7532 =item Build
7533
7534 =over 4
7535
7536 =item Tools & SDK
7537
7538 =item Setup
7539
7540 SetNWBld.bat, Buildtype.bat
7541
7542 =item Make
7543
7544 =item Interpreter
7545
7546 =item Extensions
7547
7548 =back
7549
7550 =item Install
7551
7552 =item Build new extensions
7553
7554 =item Acknowledgements
7555
7556 =item Authors
7557
7558 =item Date
7559
7560 =back
7561
7562 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7563
7564 =over 4
7565
7566 =item SYNOPSIS
7567
7568 =back
7569
7570 =over 4
7571
7572 =item DESCRIPTION
7573
7574 =over 4
7575
7576 =item Target
7577
7578 =item Other OSes
7579
7580 =item Prerequisites
7581
7582 EMX, RSX, HPFS, pdksh
7583
7584 =item Starting Perl programs under OS/2 (and DOS and...)
7585
7586 =item Starting OS/2 (and DOS) programs under Perl
7587
7588 =back
7589
7590 =item Frequently asked questions
7591
7592 =over 4
7593
7594 =item "It does not work"
7595
7596 =item I cannot run external programs
7597
7598 =item I cannot embed perl into my program, or use F<perl.dll> from my
7599 program. 
7600
7601 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7602 L<ExtUtils::Embed>?
7603
7604 =item C<``> and pipe-C<open> do not work under DOS.
7605
7606 =item Cannot start C<find.exe "pattern" file>
7607
7608 =back
7609
7610 =item INSTALLATION
7611
7612 =over 4
7613
7614 =item Automatic binary installation
7615
7616 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7617
7618 =item Manual binary installation
7619
7620 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7621 (statically linked), Executables for Perl utilities, Main Perl library,
7622 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7623 and utilities, Manpages for Perl modules, Source for Perl documentation,
7624 Perl manual in F<.INF> format, Pdksh
7625
7626 =item B<Warning>
7627
7628 =back
7629
7630 =item Accessing documentation
7631
7632 =over 4
7633
7634 =item OS/2 F<.INF> file
7635
7636 =item Plain text
7637
7638 =item Manpages
7639
7640 =item HTML
7641
7642 =item GNU C<info> files
7643
7644 =item F<PDF> files
7645
7646 =item C<LaTeX> docs
7647
7648 =back
7649
7650 =item BUILD
7651
7652 =over 4
7653
7654 =item The short story
7655
7656 =item Prerequisites
7657
7658 =item Getting perl source
7659
7660 =item Application of the patches
7661
7662 =item Hand-editing
7663
7664 =item Making
7665
7666 =item Testing
7667
7668 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7669 F<op/stat.t>
7670
7671 =item Installing the built perl
7672
7673 =item C<a.out>-style build
7674
7675 =back
7676
7677 =item Build FAQ
7678
7679 =over 4
7680
7681 =item Some C</> became C<\> in pdksh.
7682
7683 =item C<'errno'> - unresolved external
7684
7685 =item Problems with tr or sed
7686
7687 =item Some problem (forget which ;-)
7688
7689 =item Library ... not found
7690
7691 =item Segfault in make
7692
7693 =item op/sprintf test failure
7694
7695 =back
7696
7697 =item Specific (mis)features of OS/2 port
7698
7699 =over 4
7700
7701 =item C<setpriority>, C<getpriority>
7702
7703 =item C<system()>
7704
7705 =item C<extproc> on the first line
7706
7707 =item Additional modules:
7708
7709 =item Prebuilt methods:
7710
7711 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7712  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
7713 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
7714 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
7715 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
7716 C<Cwd::extLibpath_set( path [, type ] )>,
7717 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7718 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7719 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7720 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7721 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7722
7723 =item Prebuilt variables:
7724
7725 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7726
7727 =item Misfeatures
7728
7729 =item Modifications
7730
7731 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7732 C<flock>
7733
7734 =item Identifying DLLs
7735
7736 =item Centralized management of resources
7737
7738 C<HAB>, C<HMQ>
7739
7740 =back
7741
7742 =item Perl flavors
7743
7744 =over 4
7745
7746 =item F<perl.exe>
7747
7748 =item F<perl_.exe>
7749
7750 =item F<perl__.exe>
7751
7752 =item F<perl___.exe>
7753
7754 =item Why strange names?
7755
7756 =item Why dynamic linking?
7757
7758 =item Why chimera build?
7759
7760 =back
7761
7762 =item ENVIRONMENT
7763
7764 =over 4
7765
7766 =item C<PERLLIB_PREFIX>
7767
7768 =item C<PERL_BADLANG>
7769
7770 =item C<PERL_BADFREE>
7771
7772 =item C<PERL_SH_DIR>
7773
7774 =item C<USE_PERL_FLOCK>
7775
7776 =item C<TMP> or C<TEMP>
7777
7778 =back
7779
7780 =item Evolution
7781
7782 =over 4
7783
7784 =item Priorities
7785
7786 =item DLL name mangling: pre 5.6.2
7787
7788 =item DLL name mangling: 5.6.2 and beyond
7789
7790 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7791 C<LIBPATH>
7792
7793 =item DLL forwarder generation
7794
7795 =item Threading
7796
7797 =item Calls to external programs
7798
7799 =item Memory allocation
7800
7801 =item Threads
7802
7803 C<COND_WAIT>, F<os2.c>
7804
7805 =back
7806
7807 =item BUGS
7808
7809 =back
7810
7811 =over 4
7812
7813 =item AUTHOR
7814
7815 =item SEE ALSO
7816
7817 =back
7818
7819 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7820 and z/OS
7821
7822 =over 4
7823
7824 =item SYNOPSIS
7825
7826 =item DESCRIPTION
7827
7828 =over 4
7829
7830 =item Tools
7831
7832 =item Unpacking Perl distribution on OS/390
7833
7834 =item Setup and utilities for Perl on OS/390
7835
7836 =item Configure Perl on OS/390
7837
7838 =item Build, Test, Install Perl on OS/390
7839
7840 =item Build Anomalies with Perl on OS/390
7841
7842 =item Testing Anomalies with Perl on OS/390
7843
7844 =item Installation Anomalies with Perl on OS/390
7845
7846 =item Usage Hints for Perl on OS/390
7847
7848 =item Floating Point Anomalies with Perl on OS/390
7849
7850 =item Modules and Extensions for Perl on OS/390
7851
7852 =back
7853
7854 =item AUTHORS
7855
7856 =item SEE ALSO
7857
7858 =over 4
7859
7860 =item Mailing list for Perl on OS/390
7861
7862 =back
7863
7864 =item HISTORY
7865
7866 =back
7867
7868 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7869
7870 =over 4
7871
7872 =item DESCRIPTION
7873
7874 =over 4
7875
7876 =item Required Software for Compiling Perl on QNX4
7877
7878 /bin/sh, ar, nm, cpp, make
7879
7880 =item Outstanding Issues with Perl on QNX4
7881
7882 =item QNX auxiliary files
7883
7884 qnx/ar, qnx/cpp
7885
7886 =item Outstanding issues with perl under QNX6
7887
7888 =back
7889
7890 =item AUTHOR
7891
7892 =back
7893
7894 =head2 perlplan9 - Plan 9-specific documentation for Perl
7895
7896 =over 4
7897
7898 =item DESCRIPTION
7899
7900 =over 4
7901
7902 =item Invoking Perl
7903
7904 =item What's in Plan 9 Perl
7905
7906 =item What's not in Plan 9 Perl
7907
7908 =item Perl5 Functions not currently supported in Plan 9 Perl
7909
7910 =item Signals in Plan 9 Perl
7911
7912 =back
7913
7914 =item COMPILING AND INSTALLING PERL ON PLAN 9
7915
7916 =over 4
7917
7918 =item Installing Perl Documentation on Plan 9
7919
7920 =back
7921
7922 =item BUGS
7923
7924 =item Revision date
7925
7926 =item AUTHOR
7927
7928 =back
7929
7930 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7931
7932 =over 4
7933
7934 =item DESCRIPTION
7935
7936 =over 4
7937
7938 =item Solaris Version Numbers.
7939
7940 =back
7941
7942 =item RESOURCES
7943
7944 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7945
7946 =item SETTING UP
7947
7948 =over 4
7949
7950 =item File Extraction Problems on Solaris.
7951
7952 =item Compiler and Related Tools on Solaris.
7953
7954 =item Environment for Compiling Perl on Solaris
7955
7956 =back
7957
7958 =item RUN CONFIGURE.
7959
7960 =over 4
7961
7962 =item 64-bit Issues with Perl on Solaris.
7963
7964 =item Threads in Perl on Solaris.
7965
7966 =item Malloc Issues with Perl on Solaris.
7967
7968 =back
7969
7970 =item MAKE PROBLEMS.
7971
7972 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
7973 relocation error:, dlopen: stub interception failed, #error "No
7974 DATAMODEL_NATIVE specified", sh: ar: not found
7975
7976 =item MAKE TEST
7977
7978 =over 4
7979
7980 =item op/stat.t test 4 in Solaris
7981
7982 =item nss_delete core dump from op/pwent or op/grent
7983
7984 =back
7985
7986 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
7987
7988 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
7989
7990 =over 4
7991
7992 =item Limits on Numbers of Open Files on Solaris.
7993
7994 =back
7995
7996 =item SOLARIS-SPECIFIC MODULES.
7997
7998 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
7999
8000 =over 4
8001
8002 =item Proc::ProcessTable on Solaris
8003
8004 =item BSD::Resource on Solaris
8005
8006 =item Net::SSLeay on Solaris
8007
8008 =back
8009
8010 =item AUTHOR
8011
8012 =item LAST MODIFIED
8013
8014 =back
8015
8016 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8017 Digital UNIX formerly known as DEC OSF/1) systems
8018
8019 =over 4
8020
8021 =item DESCRIPTION
8022
8023 =over 4
8024
8025 =item Compiling Perl 5 on Tru64
8026
8027 =item Using Large Files with Perl on Tru64
8028
8029 =item Threaded Perl on Tru64
8030
8031 =item Long Doubles on Tru64
8032
8033 =item 64-bit Perl on Tru64
8034
8035 =item Warnings about floating-point overflow when compiling Perl on Tru64
8036
8037 =back
8038
8039 =item Testing Perl on Tru64
8040
8041 =item ext/ODBM_File/odbm Test Failing With Static Builds
8042
8043 =item Perl Fails Because Of Unresolved Symbol sockatmark
8044
8045 =item AUTHOR
8046
8047 =back
8048
8049 =head2 perluts - Perl under UTS
8050
8051 =over 4
8052
8053 =item SYNOPSIS
8054
8055 =item DESCRIPTION
8056
8057 =item BUILDING PERL ON UTS
8058
8059 =item Installing the built perl on UTS
8060
8061 =item AUTHOR
8062
8063 =back
8064
8065 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8066
8067 =over 4
8068
8069 =item SYNOPSIS
8070
8071 =item DESCRIPTION
8072
8073 =over 4
8074
8075 =item Unpacking Perl Distribution on VM/ESA
8076
8077 =item Setup Perl and utilities on VM/ESA
8078
8079 =item Configure Perl on VM/ESA
8080
8081 =item Testing Anomalies of Perl on VM/ESA
8082
8083 =item Usage Hints for Perl on VM/ESA
8084
8085 =back
8086
8087 =item AUTHORS
8088
8089 =item SEE ALSO
8090
8091 =over 4
8092
8093 =item Mailing list for Perl on VM/ESA
8094
8095 =back
8096
8097 =back
8098
8099 =head2 perlvms - VMS-specific documentation for Perl
8100
8101 =over 4
8102
8103 =item DESCRIPTION
8104
8105 =item Installation
8106
8107 =item Organization of Perl Images
8108
8109 =over 4
8110
8111 =item Core Images
8112
8113 =item Perl Extensions
8114
8115 =item Installing static extensions
8116
8117 =item Installing dynamic extensions
8118
8119 =back
8120
8121 =item File specifications
8122
8123 =over 4
8124
8125 =item Syntax
8126
8127 =item Wildcard expansion
8128
8129 =item Pipes
8130
8131 =back
8132
8133 =item PERL5LIB and PERLLIB
8134
8135 =item Command line
8136
8137 =over 4
8138
8139 =item I/O redirection and backgrounding
8140
8141 =item Command line switches
8142
8143 -i, -S, -u
8144
8145 =back
8146
8147 =item Perl functions
8148
8149 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8150 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8151 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8152 LIST, waitpid PID,FLAGS
8153
8154 =item Perl variables
8155
8156 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8157
8158 =item Standard modules with VMS-specific differences
8159
8160 =over 4
8161
8162 =item SDBM_File
8163
8164 =back
8165
8166 =item Revision date
8167
8168 =item AUTHOR
8169
8170 =back
8171
8172 =head2 perlvos, README.vos - Perl for Stratus VOS
8173
8174 =over 4
8175
8176 =item SYNOPSIS
8177
8178 =over 4
8179
8180 =item Multiple methods to build perl for VOS
8181
8182 =item Stratus POSIX Support
8183
8184 =back
8185
8186 =item INSTALLING PERL IN VOS
8187
8188 =over 4
8189
8190 =item Compiling Perl 5 on VOS
8191
8192 =item Installing Perl 5 on VOS
8193
8194 =back
8195
8196 =item USING PERL IN VOS
8197
8198 =over 4
8199
8200 =item Unimplemented Features of Perl on VOS
8201
8202 =item Restrictions of Perl on VOS
8203
8204 =item Handling of underflow and overflow
8205
8206 =back
8207
8208 =item TEST STATUS
8209
8210 =item SUPPORT STATUS
8211
8212 =item AUTHOR
8213
8214 =item LAST UPDATE
8215
8216 =back
8217
8218 =head2 perlwin32 - Perl under Windows
8219
8220 =over 4
8221
8222 =item SYNOPSIS
8223
8224 =item DESCRIPTION
8225
8226 =over 4
8227
8228 =item Setting Up Perl on Win32
8229
8230 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8231 SDK 64-bit Compiler, Mingw32 with GCC
8232
8233 =item Building
8234
8235 =item Testing Perl on Win32
8236
8237 =item Installation of Perl on Win32
8238
8239 =item Usage Hints for Perl on Win32
8240
8241 Environment Variables, File Globbing, Using perl from the command line,
8242 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8243 Extensions, Notes on 64-bit Windows
8244
8245 =item Running Perl Scripts
8246
8247 Miscellaneous Things
8248
8249 =back
8250
8251 =item BUGS AND CAVEATS
8252
8253 =item AUTHORS
8254
8255 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8256 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8257 E<lt>nick@ing-simmons.netE<gt>
8258
8259 =item SEE ALSO
8260
8261 =item HISTORY
8262
8263 =back
8264
8265 =head1 PRAGMA DOCUMENTATION
8266
8267 =head2 attrs - set/get attributes of a subroutine (deprecated)
8268
8269 =over 4
8270
8271 =item SYNOPSIS
8272
8273 =item DESCRIPTION
8274
8275 method, locked
8276
8277 =back
8278
8279 =head2 re - Perl pragma to alter regular expression behaviour
8280
8281 =over 4
8282
8283 =item SYNOPSIS
8284
8285 =item DESCRIPTION
8286
8287 =back
8288
8289 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8290
8291 =over 4
8292
8293 =item SYNOPSIS
8294
8295 =item DESCRIPTION
8296
8297 =item FUNCTIONS AND METHODS
8298
8299 new, enqueue LIST, dequeue, dequeue_nb, pending
8300
8301 =item SEE ALSO
8302
8303 =back
8304
8305 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8306 semaphores
8307
8308 =over 4
8309
8310 =item SYNOPSIS
8311
8312 =item DESCRIPTION
8313
8314 =item FUNCTIONS AND METHODS
8315
8316 new, new NUMBER, down, down NUMBER, up, up NUMBER
8317
8318 =back
8319
8320 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8321 data structures between threads
8322
8323 =over 4
8324
8325 =item SYNOPSIS
8326
8327 =item DESCRIPTION
8328
8329 =item EXPORT
8330
8331 =item FUNCTIONS
8332
8333 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8334 cond_broadcast VARIABLE
8335
8336 =item NOTES
8337
8338 =item BUGS
8339
8340 =item AUTHOR
8341
8342 =item SEE ALSO
8343
8344 =back
8345
8346 =head2 threads - Perl extension allowing use of interpreter based threads
8347 from perl
8348
8349 =over 4
8350
8351 =item SYNOPSIS
8352
8353 =item DESCRIPTION
8354
8355 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8356 threads->self, $thread->tid, threads->yield();, threads->list();, async
8357 BLOCK;
8358
8359 =item WARNINGS
8360
8361 A thread exited while %d other threads were still running
8362
8363 =item BUGS / TODO
8364
8365 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8366 not threadsafe, will not be
8367
8368 =item AUTHOR and COPYRIGHT
8369
8370 =item SEE ALSO
8371
8372 =back
8373
8374 =head2 attributes - get/set subroutine or variable attributes
8375
8376 =over 4
8377
8378 =item SYNOPSIS
8379
8380 =item DESCRIPTION
8381
8382 =over 4
8383
8384 =item Built-in Attributes
8385
8386 locked, method, lvalue
8387
8388 =item Available Subroutines
8389
8390 get, reftype
8391
8392 =item Package-specific Attribute Handling
8393
8394 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8395
8396 =item Syntax of Attribute Lists
8397
8398 =back
8399
8400 =item EXPORTS
8401
8402 =over 4
8403
8404 =item Default exports
8405
8406 =item Available exports
8407
8408 =item Export tags defined
8409
8410 =back
8411
8412 =item EXAMPLES
8413
8414 =item SEE ALSO
8415
8416 =back
8417
8418 =head2 attrs - set/get attributes of a subroutine (deprecated)
8419
8420 =over 4
8421
8422 =item SYNOPSIS
8423
8424 =item DESCRIPTION
8425
8426 method, locked
8427
8428 =back
8429
8430 =head2 autouse - postpone load of modules until a function is used
8431
8432 =over 4
8433
8434 =item SYNOPSIS
8435
8436 =item DESCRIPTION
8437
8438 =item WARNING
8439
8440 =item AUTHOR
8441
8442 =item SEE ALSO
8443
8444 =back
8445
8446 =head2 base - Establish IS-A relationship with base class at compile time
8447
8448 =over 4
8449
8450 =item SYNOPSIS
8451
8452 =item DESCRIPTION
8453
8454 =item HISTORY
8455
8456 =item SEE ALSO
8457
8458 =back
8459
8460 =head2 bigint - Transparent big integer support for Perl
8461
8462 =over 4
8463
8464 =item SYNOPSIS
8465
8466 =item DESCRIPTION
8467
8468 =over 4
8469
8470 =item OPTIONS
8471
8472 a or accuracy, p or precision, t or trace, l or lib, v or version
8473
8474 =item MATH LIBRARY
8475
8476 =item INTERNAL FORMAT
8477
8478 =item SIGN
8479
8480 =item METHODS
8481
8482 =back
8483
8484 =item MODULES USED
8485
8486 =item EXAMPLES
8487
8488 =item LICENSE
8489
8490 =item SEE ALSO
8491
8492 =item AUTHORS
8493
8494 =back
8495
8496 =head2 bignum - Transparent BigNumber support for Perl
8497
8498 =over 4
8499
8500 =item SYNOPSIS
8501
8502 =item DESCRIPTION
8503
8504 =over 4
8505
8506 =item OPTIONS
8507
8508 a or accuracy, p or precision, t or trace, l or lib, v or version
8509
8510 =item MATH LIBRARY
8511
8512 =item INTERNAL FORMAT
8513
8514 =item SIGN
8515
8516 =item METHODS
8517
8518 =back
8519
8520 =item MODULES USED
8521
8522 =item EXAMPLES
8523
8524 =item LICENSE
8525
8526 =item SEE ALSO
8527
8528 =item AUTHORS
8529
8530 =back
8531
8532 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8533
8534 =over 4
8535
8536 =item SYNOPSIS
8537
8538 =item DESCRIPTION
8539
8540 =over 4
8541
8542 =item MODULES USED
8543
8544 =item MATH LIBRARY
8545
8546 =item SIGN
8547
8548 =item METHODS
8549
8550 =back
8551
8552 =item EXAMPLES
8553
8554         perl -Mbigrat -le 'print sqrt(33)'
8555         perl -Mbigrat -le 'print 2*255'
8556         perl -Mbigrat -le 'print 4.5+2*255'
8557         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
8558         perl -Mbigrat -le 'print 12->is_odd()';
8559
8560 =item LICENSE
8561
8562 =item SEE ALSO
8563
8564 =item AUTHORS
8565
8566 =back
8567
8568 =head2 blib - Use MakeMaker's uninstalled version of a package
8569
8570 =over 4
8571
8572 =item SYNOPSIS
8573
8574 =item DESCRIPTION
8575
8576 =item BUGS
8577
8578 =item AUTHOR
8579
8580 =back
8581
8582 =head2 bytes - Perl pragma to force byte semantics rather than character
8583 semantics
8584
8585 =over 4
8586
8587 =item SYNOPSIS
8588
8589 =item DESCRIPTION
8590
8591 =item SEE ALSO
8592
8593 =back
8594
8595 =head2 charnames - define character names for C<\N{named}> string literal
8596 escapes
8597
8598 =over 4
8599
8600 =item SYNOPSIS
8601
8602 =item DESCRIPTION
8603
8604 =item CUSTOM TRANSLATORS
8605
8606 =item charnames::viacode(code)
8607
8608 =item charnames::vianame(name)
8609
8610 =item ALIASES
8611
8612 =item ILLEGAL CHARACTERS
8613
8614 =item BUGS
8615
8616 =back
8617
8618 =head2 constant - Perl pragma to declare constants
8619
8620 =over 4
8621
8622 =item SYNOPSIS
8623
8624 =item DESCRIPTION
8625
8626 =item NOTES
8627
8628 =over 4
8629
8630 =item List constants
8631
8632 =item Defining multiple constants at once
8633
8634 =item Magic constants
8635
8636 =back
8637
8638 =item TECHNICAL NOTES
8639
8640 =item BUGS
8641
8642 =item AUTHOR
8643
8644 =item COPYRIGHT
8645
8646 =back
8647
8648 =head2 diagnostics - Perl compiler pragma to force verbose warning
8649 diagnostics
8650
8651 =over 4
8652
8653 =item SYNOPSIS
8654
8655 =item DESCRIPTION
8656
8657 =over 4
8658
8659 =item The C<diagnostics> Pragma
8660
8661 =item The I<splain> Program
8662
8663 =back
8664
8665 =item EXAMPLES
8666
8667 =item INTERNALS
8668
8669 =item BUGS
8670
8671 =item AUTHOR
8672
8673 =back
8674
8675 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8676
8677 =over 4
8678
8679 =item SYNOPSIS
8680
8681 =item ABSTRACT
8682
8683 =item USAGE
8684
8685 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8686 I<ENCNAME_IN> ...] ;, no encoding;
8687
8688 =item CAVEATS
8689
8690 =over 4
8691
8692 =item NOT SCOPED
8693
8694 =item DO NOT MIX MULTIPLE ENCODINGS
8695
8696 =back
8697
8698 =item Non-ASCII Identifiers and Filter option
8699
8700 use encoding I<ENCNAME> Filter=E<gt>1;
8701
8702 =item EXAMPLE - Greekperl
8703
8704 =item KNOWN PROBLEMS
8705
8706 =item SEE ALSO
8707
8708 =back
8709
8710 =head2 fields - compile-time class fields
8711
8712 =over 4
8713
8714 =item SYNOPSIS
8715
8716 =item DESCRIPTION
8717
8718 new, phash
8719
8720 =item SEE ALSO
8721
8722 =back
8723
8724 =head2 filetest - Perl pragma to control the filetest permission operators
8725
8726 =over 4
8727
8728 =item SYNOPSIS
8729
8730 =item DESCRIPTION
8731
8732 =over 4
8733
8734 =item subpragma access
8735
8736 =back
8737
8738 =back
8739
8740 =head2 if - C<use> a Perl module if a condition holds
8741
8742 =over 4
8743
8744 =item SYNOPSIS
8745
8746 =item DESCRIPTION
8747
8748 =item BUGS
8749
8750 =item AUTHOR
8751
8752 =back
8753
8754 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8755 point
8756
8757 =over 4
8758
8759 =item SYNOPSIS
8760
8761 =item DESCRIPTION
8762
8763 =back
8764
8765 =head2 less - perl pragma to request less of something from the compiler
8766
8767 =over 4
8768
8769 =item SYNOPSIS
8770
8771 =item DESCRIPTION
8772
8773 =back
8774
8775 =head2 lib - manipulate @INC at compile time
8776
8777 =over 4
8778
8779 =item SYNOPSIS
8780
8781 =item DESCRIPTION
8782
8783 =over 4
8784
8785 =item Adding directories to @INC
8786
8787 =item Deleting directories from @INC
8788
8789 =item Restoring original @INC
8790
8791 =back
8792
8793 =item CAVEATS
8794
8795 =item NOTES
8796
8797 =item SEE ALSO
8798
8799 =item AUTHOR
8800
8801 =back
8802
8803 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8804 operations
8805
8806 =over 4
8807
8808 =item SYNOPSIS
8809
8810 =item DESCRIPTION
8811
8812 =back
8813
8814 =head2 open - perl pragma to set default disciplines for input and output
8815
8816 =over 4
8817
8818 =item SYNOPSIS
8819
8820 =item DESCRIPTION
8821
8822 =item NONPERLIO FUNCTIONALITY
8823
8824 =item IMPLEMENTATION DETAILS
8825
8826 =item SEE ALSO
8827
8828 =back
8829
8830 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8831
8832 =over 4
8833
8834 =item SYNOPSIS  
8835
8836 =item DESCRIPTION
8837
8838 =item SEE ALSO
8839
8840 =back
8841
8842 =head2 overload - Package for overloading perl operations
8843
8844 =over 4
8845
8846 =item SYNOPSIS
8847
8848 =item DESCRIPTION
8849
8850 =over 4
8851
8852 =item Declaration of overloaded functions
8853
8854 =item Calling Conventions for Binary Operations
8855
8856 FALSE, TRUE, C<undef>
8857
8858 =item Calling Conventions for Unary Operations
8859
8860 =item Calling Conventions for Mutators
8861
8862 C<++> and C<-->, C<x=> and other assignment versions
8863
8864 =item Overloadable Operations
8865
8866 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8867 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8868 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8869
8870 =item Inheritance and overloading
8871
8872 Strings as values of C<use overload> directive, Overloading of an operation
8873 is inherited by derived classes
8874
8875 =back
8876
8877 =item SPECIAL SYMBOLS FOR C<use overload>
8878
8879 =over 4
8880
8881 =item Last Resort
8882
8883 =item Fallback
8884
8885 C<undef>, TRUE, defined, but FALSE
8886
8887 =item Copy Constructor
8888
8889 B<Example>
8890
8891 =back
8892
8893 =item MAGIC AUTOGENERATION
8894
8895 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8896 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8897 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8898 I<Copy operator>
8899
8900 =item Losing overloading
8901
8902 =item Run-time Overloading
8903
8904 =item Public functions
8905
8906 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8907
8908 =item Overloading constants
8909
8910 integer, float, binary, q, qr
8911
8912 =item IMPLEMENTATION
8913
8914 =item Metaphor clash
8915
8916 =item Cookbook
8917
8918 =over 4
8919
8920 =item Two-face scalars
8921
8922 =item Two-face references
8923
8924 =item Symbolic calculator
8925
8926 =item I<Really> symbolic calculator
8927
8928 =back
8929
8930 =item AUTHOR
8931
8932 =item DIAGNOSTICS
8933
8934 Odd number of arguments for overload::constant, `%s' is not an overloadable
8935 type, `%s' is not a code reference
8936
8937 =item BUGS
8938
8939 =back
8940
8941 =head2 re - Perl pragma to alter regular expression behaviour
8942
8943 =over 4
8944
8945 =item SYNOPSIS
8946
8947 =item DESCRIPTION
8948
8949 =back
8950
8951 =head2 sigtrap - Perl pragma to enable simple signal handling
8952
8953 =over 4
8954
8955 =item SYNOPSIS
8956
8957 =item DESCRIPTION
8958
8959 =item OPTIONS
8960
8961 =over 4
8962
8963 =item SIGNAL HANDLERS
8964
8965 B<stack-trace>, B<die>, B<handler> I<your-handler>
8966
8967 =item SIGNAL LISTS
8968
8969 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8970
8971 =item OTHER
8972
8973 B<untrapped>, B<any>, I<signal>, I<number>
8974
8975 =back
8976
8977 =item EXAMPLES
8978
8979 =back
8980
8981 =head2 sort - perl pragma to control sort() behaviour
8982
8983 =over 4
8984
8985 =item SYNOPSIS
8986
8987 =item DESCRIPTION
8988
8989 =item CAVEATS
8990
8991 =back
8992
8993 =head2 strict - Perl pragma to restrict unsafe constructs
8994
8995 =over 4
8996
8997 =item SYNOPSIS
8998
8999 =item DESCRIPTION
9000
9001 C<strict refs>, C<strict vars>, C<strict subs>
9002
9003 =back
9004
9005 =head2 subs - Perl pragma to predeclare sub names
9006
9007 =over 4
9008
9009 =item SYNOPSIS
9010
9011 =item DESCRIPTION
9012
9013 =back
9014
9015 =head2 threads - Perl extension allowing use of interpreter based threads
9016 from perl
9017
9018 =over 4
9019
9020 =item SYNOPSIS
9021
9022 =item DESCRIPTION
9023
9024 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9025 threads->self, $thread->tid, threads->yield();, threads->list();, async
9026 BLOCK;
9027
9028 =item WARNINGS
9029
9030 A thread exited while %d other threads were still running
9031
9032 =item BUGS / TODO
9033
9034 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
9035 not threadsafe, will not be
9036
9037 =item AUTHOR and COPYRIGHT
9038
9039 =item SEE ALSO
9040
9041 =back
9042
9043 =head2 threadshared, threads::shared - Perl extension for sharing data
9044 structures between threads
9045
9046 =over 4
9047
9048 =item SYNOPSIS
9049
9050 =item DESCRIPTION
9051
9052 =item EXPORT
9053
9054 =item FUNCTIONS
9055
9056 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9057 cond_broadcast VARIABLE
9058
9059 =item NOTES
9060
9061 =item BUGS
9062
9063 =item AUTHOR
9064
9065 =item SEE ALSO
9066
9067 =back
9068
9069 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
9070
9071 =over 4
9072
9073 =item SYNOPSIS
9074
9075 =item DESCRIPTION
9076
9077 =item FUNCTIONS AND METHODS
9078
9079 new, enqueue LIST, dequeue, dequeue_nb, pending
9080
9081 =item SEE ALSO
9082
9083 =back
9084
9085 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
9086 semaphores
9087
9088 =over 4
9089
9090 =item SYNOPSIS
9091
9092 =item DESCRIPTION
9093
9094 =item FUNCTIONS AND METHODS
9095
9096 new, new NUMBER, down, down NUMBER, up, up NUMBER
9097
9098 =back
9099
9100 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9101 code
9102
9103 =over 4
9104
9105 =item SYNOPSIS
9106
9107 =item DESCRIPTION
9108
9109 =over 4
9110
9111 =item Utility functions
9112
9113 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9114 utf8::encode($string), $flag = utf8::decode($string), $flag =
9115 utf8::valid(STRING)
9116
9117 =back
9118
9119 =item SEE ALSO
9120
9121 =back
9122
9123 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9124
9125 =over 4
9126
9127 =item SYNOPSIS
9128
9129 =item DESCRIPTION
9130
9131 =back
9132
9133 =head2 vmsish - Perl pragma to control VMS-specific language features
9134
9135 =over 4
9136
9137 =item SYNOPSIS
9138
9139 =item DESCRIPTION
9140
9141 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9142
9143 =back
9144
9145 =head2 warnings - Perl pragma to control optional warnings
9146
9147 =over 4
9148
9149 =item SYNOPSIS
9150
9151 =item DESCRIPTION
9152
9153 use warnings::register, warnings::enabled(), warnings::enabled($category),
9154 warnings::enabled($object), warnings::warn($message),
9155 warnings::warn($category, $message), warnings::warn($object, $message),
9156 warnings::warnif($message), warnings::warnif($category, $message),
9157 warnings::warnif($object, $message)
9158
9159 =back
9160
9161 =head2 warnings::register - warnings import function
9162
9163 =over 4
9164
9165 =item SYNOPSIS
9166
9167 =item DESCRIPTION
9168
9169 =back
9170
9171 =head1 MODULE DOCUMENTATION
9172
9173 =head2 AnyDBM_File - provide framework for multiple DBMs
9174
9175 =over 4
9176
9177 =item SYNOPSIS
9178
9179 =item DESCRIPTION
9180
9181 =over 4
9182
9183 =item DBM Comparisons
9184
9185 [0], [1], [2], [3]
9186
9187 =back
9188
9189 =item SEE ALSO
9190
9191 =back
9192
9193 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9194
9195 =over 4
9196
9197 =item VERSION
9198
9199 =item SYNOPSIS
9200
9201 =item DESCRIPTION
9202
9203 [0], [1], [2], [3], [4], [5]
9204
9205 =over 4
9206
9207 =item Typed lexicals
9208
9209 =item Type-specific attribute handlers
9210
9211 =item Non-interpretive attribute handlers
9212
9213 =item Phase-specific attribute handlers
9214
9215 =item Attributes as C<tie> interfaces
9216
9217 =back
9218
9219 =item EXAMPLES
9220
9221 =item DIAGNOSTICS
9222
9223 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9224 attributes>, C<Declaration of %s attribute in package %s may clash with
9225 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9226 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9227 be able to apply END handler>
9228
9229 =item AUTHOR
9230
9231 =item BUGS
9232
9233 =item COPYRIGHT
9234
9235 =back
9236
9237 =head2 AutoLoader - load subroutines only on demand
9238
9239 =over 4
9240
9241 =item SYNOPSIS
9242
9243 =item DESCRIPTION
9244
9245 =over 4
9246
9247 =item Subroutine Stubs
9248
9249 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9250
9251 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9252
9253 =item Package Lexicals
9254
9255 =item Not Using AutoLoader
9256
9257 =item B<AutoLoader> vs. B<SelfLoader>
9258
9259 =back
9260
9261 =item CAVEATS
9262
9263 =item SEE ALSO
9264
9265 =back
9266
9267 =head2 AutoSplit - split a package for autoloading
9268
9269 =over 4
9270
9271 =item SYNOPSIS
9272
9273 =item DESCRIPTION
9274
9275 $keep, $check, $modtime
9276
9277 =over 4
9278
9279 =item Multiple packages
9280
9281 =back
9282
9283 =item DIAGNOSTICS
9284
9285 =back
9286
9287 =head2 B - The Perl Compiler
9288
9289 =over 4
9290
9291 =item SYNOPSIS
9292
9293 =item DESCRIPTION
9294
9295 =item OVERVIEW OF CLASSES
9296
9297 =over 4
9298
9299 =item SV-RELATED CLASSES
9300
9301 =item B::SV METHODS
9302
9303 REFCNT, FLAGS
9304
9305 =item B::IV METHODS
9306
9307 IV, IVX, UVX, int_value, needs64bits, packiv
9308
9309 =item B::NV METHODS
9310
9311 NV, NVX
9312
9313 =item B::RV METHODS
9314
9315 RV
9316
9317 =item B::PV METHODS
9318
9319 PV, RV, PVX
9320
9321 =item B::PVMG METHODS
9322
9323 MAGIC, SvSTASH
9324
9325 =item B::MAGIC METHODS
9326
9327 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9328
9329 =item B::PVLV METHODS
9330
9331 TARGOFF, TARGLEN, TYPE, TARG
9332
9333 =item B::BM METHODS
9334
9335 USEFUL, PREVIOUS, RARE, TABLE
9336
9337 =item B::GV METHODS
9338
9339 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9340 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9341
9342 =item B::IO METHODS
9343
9344 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9345 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9346
9347 =item B::AV METHODS
9348
9349 FILL, MAX, OFF, ARRAY, AvFLAGS
9350
9351 =item B::CV METHODS
9352
9353 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9354 CvFLAGS, const_sv
9355
9356 =item B::HV METHODS
9357
9358 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9359
9360 =item OP-RELATED CLASSES
9361
9362 =item B::OP METHODS
9363
9364 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9365
9366 =item B::UNOP METHOD
9367
9368 first
9369
9370 =item B::BINOP METHOD
9371
9372 last
9373
9374 =item B::LOGOP METHOD
9375
9376 other
9377
9378 =item B::LISTOP METHOD
9379
9380 children
9381
9382 =item B::PMOP METHODS
9383
9384 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9385 pmpermflags, precomp, pmoffet
9386
9387 =item B::SVOP METHOD
9388
9389 sv, gv
9390
9391 =item B::PADOP METHOD
9392
9393 padix
9394
9395 =item B::PVOP METHOD
9396
9397 pv
9398
9399 =item B::LOOP METHODS
9400
9401 redoop, nextop, lastop
9402
9403 =item B::COP METHODS
9404
9405 label, stash, file, cop_seq, arybase, line
9406
9407 =back
9408
9409 =item FUNCTIONS EXPORTED BY C<B>
9410
9411 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9412 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9413 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9414 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9415 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9416
9417 =item AUTHOR
9418
9419 =back
9420
9421 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9422 bytecode
9423
9424 =over 4
9425
9426 =item SYNOPSIS
9427
9428 =item DESCRIPTION
9429
9430 %insn_data, @insn_name, @optype, @specialsv_name
9431
9432 =item AUTHOR
9433
9434 =back
9435
9436 =head2 B::Assembler - Assemble Perl bytecode
9437
9438 =over 4
9439
9440 =item SYNOPSIS
9441
9442 =item DESCRIPTION
9443
9444 =item AUTHORS
9445
9446 =back
9447
9448 =head2 B::Bblock - Walk basic blocks
9449
9450 =over 4
9451
9452 =item SYNOPSIS
9453
9454 =item DESCRIPTION
9455
9456 =over 4
9457
9458 =item Functions
9459
9460 B<find_leaders>
9461
9462 =back
9463
9464 =item AUTHOR
9465
9466 =back
9467
9468 =head2 B::Bytecode - Perl compiler's bytecode backend
9469
9470 =over 4
9471
9472 =item SYNOPSIS
9473
9474 =item DESCRIPTION
9475
9476 =item OPTIONS
9477
9478 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9479 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9480 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9481
9482 =item EXAMPLES
9483
9484 =item BUGS
9485
9486 =item AUTHORS
9487
9488 =back
9489
9490 =head2 B::C - Perl compiler's C backend
9491
9492 =over 4
9493
9494 =item SYNOPSIS
9495
9496 =item DESCRIPTION
9497
9498 =item OPTIONS
9499
9500 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9501 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9502 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9503 B<-llimit>
9504
9505 =item EXAMPLES
9506
9507 =item BUGS
9508
9509 =item AUTHOR
9510
9511 =back
9512
9513 =head2 B::CC - Perl compiler's optimized C translation backend
9514
9515 =over 4
9516
9517 =item SYNOPSIS
9518
9519 =item DESCRIPTION
9520
9521 =item OPTIONS
9522
9523 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9524 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9525 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9526
9527 =item EXAMPLES
9528
9529 =item BUGS
9530
9531 =item DIFFERENCES
9532
9533 =over 4
9534
9535 =item Loops
9536
9537 =item Context of ".."
9538
9539 =item Arithmetic
9540
9541 =item Deprecated features
9542
9543 =back
9544
9545 =item AUTHOR
9546
9547 =back
9548
9549 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9550
9551 =over 4
9552
9553 =item SYNOPSIS
9554
9555 =item DESCRIPTION
9556
9557 =item EXAMPLE
9558
9559 =item OPTIONS
9560
9561 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9562 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9563 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9564
9565 =item FORMATTING SPECIFICATIONS
9566
9567 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9568 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9569 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9570 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9571 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9572 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9573 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9574 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9575
9576 =item ABBREVIATIONS
9577
9578 =over 4
9579
9580 =item OP flags abbreviations
9581
9582 =item OP class abbreviations
9583
9584 =back
9585
9586 =item Using B::Concise outside of the O framework
9587
9588 =item AUTHOR
9589
9590 =back
9591
9592 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9593
9594 =over 4
9595
9596 =item SYNOPSIS
9597
9598 =item DESCRIPTION
9599
9600 =item AUTHOR
9601
9602 =back
9603
9604 =head2 B::Deparse - Perl compiler backend to produce perl code
9605
9606 =over 4
9607
9608 =item SYNOPSIS
9609
9610 =item DESCRIPTION
9611
9612 =item OPTIONS
9613
9614 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9615 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9616
9617 =item USING B::Deparse AS A MODULE
9618
9619 =over 4
9620
9621 =item Synopsis
9622
9623 =item Description
9624
9625 =item new
9626
9627 =item ambient_pragmas
9628
9629 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9630
9631 =item coderef2text
9632
9633 =back
9634
9635 =item BUGS
9636
9637 =item AUTHOR
9638
9639 =back
9640
9641 =head2 B::Disassembler - Disassemble Perl bytecode
9642
9643 =over 4
9644
9645 =item SYNOPSIS
9646
9647 =item DESCRIPTION
9648
9649 =item AUTHOR
9650
9651 =back
9652
9653 =head2 B::Lint - Perl lint
9654
9655 =over 4
9656
9657 =item SYNOPSIS
9658
9659 =item DESCRIPTION
9660
9661 =item OPTIONS AND LINT CHECKS
9662
9663 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9664 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9665
9666 =item NON LINT-CHECK OPTIONS
9667
9668 B<-u Package>
9669
9670 =item BUGS
9671
9672 =item AUTHOR
9673
9674 =back
9675
9676 =head2 B::O, O - Generic interface to Perl Compiler backends
9677
9678 =over 4
9679
9680 =item SYNOPSIS
9681
9682 =item DESCRIPTION
9683
9684 =item CONVENTIONS
9685
9686 =item IMPLEMENTATION
9687
9688 =item BUGS
9689
9690 =item AUTHOR
9691
9692 =back
9693
9694 =head2 B::Showlex - Show lexical variables used in functions or files
9695
9696 =over 4
9697
9698 =item SYNOPSIS
9699
9700 =item DESCRIPTION
9701
9702 =item AUTHOR
9703
9704 =back
9705
9706 =head2 B::Stackobj - Helper module for CC backend
9707
9708 =over 4
9709
9710 =item SYNOPSIS
9711
9712 =item DESCRIPTION
9713
9714 =item AUTHOR
9715
9716 =back
9717
9718 =head2 B::Stash - show what stashes are loaded
9719
9720 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9721
9722 =over 4
9723
9724 =item SYNOPSIS
9725
9726 =item DESCRIPTION
9727
9728 =item AUTHOR
9729
9730 =back
9731
9732 =head2 B::Xref - Generates cross reference reports for Perl programs
9733
9734 =over 4
9735
9736 =item SYNOPSIS
9737
9738 =item DESCRIPTION
9739
9740 =item OPTIONS
9741
9742 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9743
9744 =item BUGS
9745
9746 =item AUTHOR
9747
9748 =back
9749
9750 =head2 Bblock, B::Bblock - Walk basic blocks
9751
9752 =over 4
9753
9754 =item SYNOPSIS
9755
9756 =item DESCRIPTION
9757
9758 =over 4
9759
9760 =item Functions
9761
9762 B<find_leaders>
9763
9764 =back
9765
9766 =item AUTHOR
9767
9768 =back
9769
9770 =head2 Benchmark - benchmark running times of Perl code
9771
9772 =over 4
9773
9774 =item SYNOPSIS
9775
9776 =item DESCRIPTION
9777
9778 =over 4
9779
9780 =item Methods
9781
9782 new, debug, iters
9783
9784 =item Standard Exports
9785
9786 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9787 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9788 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9789
9790 =item Optional Exports
9791
9792 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9793 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9794 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9795
9796 =back
9797
9798 =item NOTES
9799
9800 =item EXAMPLES
9801
9802 =item INHERITANCE
9803
9804 =item CAVEATS
9805
9806 =item SEE ALSO
9807
9808 =item AUTHORS
9809
9810 =item MODIFICATION HISTORY
9811
9812 =back
9813
9814 =head2 ByteLoader - load byte compiled perl code
9815
9816 =over 4
9817
9818 =item SYNOPSIS
9819
9820 =item DESCRIPTION
9821
9822 =item AUTHOR
9823
9824 =item SEE ALSO
9825
9826 =back
9827
9828 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9829
9830 =over 4
9831
9832 =item SYNOPSIS
9833
9834 =item DESCRIPTION
9835
9836 =item OPTIONS
9837
9838 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9839 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9840 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9841
9842 =item EXAMPLES
9843
9844 =item BUGS
9845
9846 =item AUTHORS
9847
9848 =back
9849
9850 =head2 CGI - Simple Common Gateway Interface Class
9851
9852 =over 4
9853
9854 =item SYNOPSIS
9855
9856 =item ABSTRACT
9857
9858 =item DESCRIPTION
9859
9860 =over 4
9861
9862 =item PROGRAMMING STYLE
9863
9864 =item CALLING CGI.PM ROUTINES
9865
9866 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9867
9868 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9869
9870 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9871
9872 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9873
9874 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9875
9876 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9877
9878 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9879
9880 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9881
9882 =item DELETING A PARAMETER COMPLETELY:
9883
9884 =item DELETING ALL PARAMETERS:
9885
9886 =item DIRECT ACCESS TO THE PARAMETER LIST:
9887
9888 =item FETCHING THE PARAMETER LIST AS A HASH:
9889
9890 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9891
9892 =item RETRIEVING CGI ERRORS
9893
9894 =item USING THE FUNCTION-ORIENTED INTERFACE
9895
9896 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9897 B<:standard>, B<:all>
9898
9899 =item PRAGMAS
9900
9901 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9902 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9903 -private_tempfiles
9904
9905 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9906
9907 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9908 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9909 a </ul> tag)
9910
9911 =back
9912
9913 =item GENERATING DYNAMIC DOCUMENTS
9914
9915 =over 4
9916
9917 =item CREATING A STANDARD HTTP HEADER:
9918
9919 =item GENERATING A REDIRECTION HEADER
9920
9921 =item CREATING THE HTML DOCUMENT HEADER
9922
9923 B<Parameters:>, 4, 5, 6..
9924
9925 =item ENDING THE HTML DOCUMENT:
9926
9927 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9928
9929 =item OBTAINING THE SCRIPT'S URL
9930
9931 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9932 (B<-query_string>), B<-base>
9933
9934 =item MIXING POST AND URL PARAMETERS
9935
9936 =back
9937
9938 =item CREATING STANDARD HTML ELEMENTS:
9939
9940 =over 4
9941
9942 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9943
9944 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9945
9946 =item HTML SHORTCUTS AND LIST INTERPOLATION
9947
9948 =item NON-STANDARD HTML SHORTCUTS
9949
9950 =item AUTOESCAPING HTML
9951
9952 $escaped_string = escapeHTML("unescaped string");, $charset =
9953 charset([$charset]);, $flag = autoEscape([$flag]);
9954
9955 =item PRETTY-PRINTING HTML
9956
9957 =back
9958
9959 =item CREATING FILL-OUT FORMS:
9960
9961 =over 4
9962
9963 =item CREATING AN ISINDEX TAG
9964
9965 =item STARTING AND ENDING A FORM
9966
9967 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9968
9969 =item CREATING A TEXT FIELD
9970
9971 B<Parameters>
9972
9973 =item CREATING A BIG TEXT FIELD
9974
9975 =item CREATING A PASSWORD FIELD
9976
9977 =item CREATING A FILE UPLOAD FIELD
9978
9979 B<Parameters>
9980
9981 =item CREATING A POPUP MENU
9982
9983 =item CREATING A SCROLLING LIST
9984
9985 B<Parameters:>
9986
9987 =item CREATING A GROUP OF RELATED CHECKBOXES
9988
9989 B<Parameters:>
9990
9991 =item CREATING A STANDALONE CHECKBOX
9992
9993 B<Parameters:>
9994
9995 =item CREATING A RADIO BUTTON GROUP
9996
9997 B<Parameters:>
9998
9999 =item CREATING A SUBMIT BUTTON 
10000
10001 B<Parameters:>
10002
10003 =item CREATING A RESET BUTTON
10004
10005 =item CREATING A DEFAULT BUTTON
10006
10007 =item CREATING A HIDDEN FIELD
10008
10009 B<Parameters:>
10010
10011 =item CREATING A CLICKABLE IMAGE BUTTON
10012
10013 B<Parameters:>
10014
10015 =item CREATING A JAVASCRIPT ACTION BUTTON
10016
10017 =back
10018
10019 =item HTTP COOKIES
10020
10021 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10022 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10023
10024 =item WORKING WITH FRAMES
10025
10026 1. Create a <Frameset> document, 2. Specify the destination for the
10027 document in the HTTP header, 3. Specify the destination for the document in
10028 the <form> tag
10029
10030 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10031
10032 =item DEBUGGING
10033
10034 =over 4
10035
10036 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10037
10038 =back
10039
10040 =item FETCHING ENVIRONMENT VARIABLES
10041
10042 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10043 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10044 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10045 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10046 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10047
10048 =item USING NPH SCRIPTS
10049
10050 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10051 parameters
10052
10053 =item Server Push
10054
10055 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10056
10057 =item Avoiding Denial of Service Attacks
10058
10059 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10060 basis>, B<2. Globally for all scripts>
10061
10062 =item COMPATIBILITY WITH CGI-LIB.PL
10063
10064 =item AUTHOR INFORMATION
10065
10066 =item CREDITS
10067
10068 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10069 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10070 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10071 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10072 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10073 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10074 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10075 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10076 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10077 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10078 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10079 ...and many many more..
10080
10081 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10082
10083 =item BUGS
10084
10085 =item SEE ALSO
10086
10087 =back
10088
10089 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10090
10091 =over 4
10092
10093 =item SYNOPSIS
10094
10095 =item ABSTRACT
10096
10097 =item DESCRIPTION
10098
10099 =item AUTHOR INFORMATION
10100
10101 =item BUGS
10102
10103 =item SEE ALSO
10104
10105 =back
10106
10107 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10108 other) error log
10109
10110 =over 4
10111
10112 =item SYNOPSIS
10113
10114 =item DESCRIPTION
10115
10116 =item REDIRECTING ERROR MESSAGES
10117
10118 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10119
10120 =over 4
10121
10122 =item Changing the default message
10123
10124 =back
10125
10126 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10127
10128 =item CHANGE LOG
10129
10130 =item AUTHORS
10131
10132 =item SEE ALSO
10133
10134 =back
10135
10136 =head2 CGI::Cookie - Interface to Netscape Cookies
10137
10138 =over 4
10139
10140 =item SYNOPSIS
10141
10142 =item DESCRIPTION
10143
10144 =item USING CGI::Cookie
10145
10146 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10147
10148 =over 4
10149
10150 =item Creating New Cookies
10151
10152 =item Sending the Cookie to the Browser
10153
10154 =item Recovering Previous Cookies
10155
10156 =item Manipulating Cookies
10157
10158 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10159
10160 =back
10161
10162 =item AUTHOR INFORMATION
10163
10164 =item BUGS
10165
10166 =item SEE ALSO
10167
10168 =back
10169
10170 =head2 CGI::Fast - CGI Interface for Fast CGI
10171
10172 =over 4
10173
10174 =item SYNOPSIS
10175
10176 =item DESCRIPTION
10177
10178 =item OTHER PIECES OF THE PUZZLE
10179
10180 =item WRITING FASTCGI PERL SCRIPTS
10181
10182 =item INSTALLING FASTCGI SCRIPTS
10183
10184 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10185
10186 =item EXTERNAL FASTCGI SERVER INVOCATION
10187
10188 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10189
10190 =item CAVEATS
10191
10192 =item AUTHOR INFORMATION
10193
10194 =item BUGS
10195
10196 =item SEE ALSO
10197
10198 =back
10199
10200 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10201
10202 =over 4
10203
10204 =item SYNOPSIS
10205
10206 =item DESCRIPTION
10207
10208 =over 4
10209
10210 =item Tags that won't be formatted
10211
10212 =item Customizing the Indenting
10213
10214 =back
10215
10216 =item BUGS
10217
10218 =item AUTHOR
10219
10220 =item SEE ALSO
10221
10222 =back
10223
10224 =head2 CGI::Push - Simple Interface to Server Push
10225
10226 =over 4
10227
10228 =item SYNOPSIS
10229
10230 =item DESCRIPTION
10231
10232 =item USING CGI::Push
10233
10234 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10235
10236 =over 4
10237
10238 =item Heterogeneous Pages
10239
10240 =item Changing the Page Delay on the Fly
10241
10242 =back
10243
10244 =item INSTALLING CGI::Push SCRIPTS
10245
10246 =item AUTHOR INFORMATION
10247
10248 =item BUGS
10249
10250 =item SEE ALSO
10251
10252 =back
10253
10254 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10255
10256 =over 4
10257
10258 =item SYNOPSIS
10259
10260 =item ABSTRACT
10261
10262 =item DESCRIPTION
10263
10264 =item AUTHOR INFORMATION
10265
10266 =item BUGS
10267
10268 =item SEE ALSO
10269
10270 =back
10271
10272 =head2 CGI::Util - Internal utilities used by CGI module
10273
10274 =over 4
10275
10276 =item SYNOPSIS
10277
10278 =item DESCRIPTION
10279
10280 =item AUTHOR INFORMATION
10281
10282 =item SEE ALSO
10283
10284 =back
10285
10286 =head2 CPAN - query, download and build perl modules from CPAN sites
10287
10288 =over 4
10289
10290 =item SYNOPSIS
10291
10292 =item DESCRIPTION
10293
10294 =over 4
10295
10296 =item Interactive Mode
10297
10298 Searching for authors, bundles, distribution files and modules, make, test,
10299 install, clean  modules or distributions, get, readme, look module or
10300 distribution, ls author, Signals
10301
10302 =item CPAN::Shell
10303
10304 =item autobundle
10305
10306 =item recompile
10307
10308 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10309
10310 =item Programmer's interface
10311
10312 expand($type,@things), expandany(@things), Programming Examples
10313
10314 =item Methods in the other Classes
10315
10316 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10317 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10318 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10319 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10320 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10321 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10322 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10323 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10324 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10325 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10326 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10327 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10328 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10329 CPAN::Distribution::look(), CPAN::Distribution::make(),
10330 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10331 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10332 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10333 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10334 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10335 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10336 CPAN::Module::description(), CPAN::Module::force($method,@args),
10337 CPAN::Module::get(), CPAN::Module::inst_file(),
10338 CPAN::Module::inst_version(), CPAN::Module::install(),
10339 CPAN::Module::look(), CPAN::Module::make(),
10340 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10341 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10342
10343 =item Cache Manager
10344
10345 =item Bundles
10346
10347 =item Prerequisites
10348
10349 =item Finding packages and VERSION
10350
10351 =item Debugging
10352
10353 =item Floppy, Zip, Offline Mode
10354
10355 =back
10356
10357 =item CONFIGURATION
10358
10359 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10360 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10361 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10362 [unshift|push|splice] E<lt>listE<gt>>
10363
10364 =over 4
10365
10366 =item Note on urllist parameter's format
10367
10368 =item urllist parameter has CD-ROM support
10369
10370 =back
10371
10372 =item SECURITY
10373
10374 =item EXPORT
10375
10376 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10377
10378 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10379
10380 =over 4
10381
10382 =item Three basic types of firewalls
10383
10384 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10385
10386 =item Configuring lynx or ncftp for going through a firewall
10387
10388 =back
10389
10390 =item FAQ
10391
10392 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10393
10394 =item BUGS
10395
10396 =item AUTHOR
10397
10398 =item TRANSLATIONS
10399
10400 =item SEE ALSO
10401
10402 =back
10403
10404 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10405
10406 =over 4
10407
10408 =item SYNOPSIS
10409
10410 =item DESCRIPTION
10411
10412 =back
10413
10414 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10415 module
10416
10417 =over 4
10418
10419 =item SYNOPSIS
10420
10421 =item DESCRIPTION
10422
10423 =item  SEE ALSO
10424
10425 =back
10426
10427 =head2 Carp, carp    - warn of errors (from perspective of caller)
10428
10429 =over 4
10430
10431 =item SYNOPSIS
10432
10433 =item DESCRIPTION
10434
10435 =over 4
10436
10437 =item Forcing a Stack Trace
10438
10439 =back
10440
10441 =item BUGS
10442
10443 =back
10444
10445 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10446
10447 =head2 Class::ISA -- report the search path for a class's ISA tree
10448
10449 =over 4
10450
10451 =item SYNOPSIS
10452
10453 =item DESCRIPTION
10454
10455 =item FUNCTIONS
10456
10457 the function Class::ISA::super_path($CLASS), the function
10458 Class::ISA::self_and_super_path($CLASS), the function
10459 Class::ISA::self_and_super_versions($CLASS)
10460
10461 =item CAUTIONARY NOTES
10462
10463 =item COPYRIGHT
10464
10465 =item AUTHOR
10466
10467 =back
10468
10469 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10470
10471 =over 4
10472
10473 =item SYNOPSIS
10474
10475 =item DESCRIPTION
10476
10477 =over 4
10478
10479 =item The C<struct()> function
10480
10481 =item Class Creation at Compile Time
10482
10483 =item Element Types and Accessor Methods
10484
10485 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10486 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10487
10488 =item Initializing with C<new>
10489
10490 =back
10491
10492 =item EXAMPLES
10493
10494 Example 1, Example 2, Example 3
10495
10496 =item Author and Modification History
10497
10498 =back
10499
10500 =head2 Config - access Perl configuration information
10501
10502 =over 4
10503
10504 =item SYNOPSIS
10505
10506 =item DESCRIPTION
10507
10508 myconfig(), config_sh(), config_vars(@names)
10509
10510 =item EXAMPLE
10511
10512 =item WARNING
10513
10514 =item GLOSSARY
10515
10516 =over 4
10517
10518 =item _
10519
10520 C<_a>, C<_exe>, C<_o>
10521
10522 =item a
10523
10524 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10525 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10526 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10527 C<asctime_r_proto>, C<awk>
10528
10529 =item b
10530
10531 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10532
10533 =item c
10534
10535 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10536 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10537 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10538 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10539 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10540 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10541 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10542
10543 =item d
10544
10545 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10546 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10547 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10548 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10549 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10550 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10551 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10552 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10553 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10554 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10555 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10556 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10557 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10558 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10559 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10560 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10561 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10562 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10563 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10564 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10565 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10566 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10567 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10568 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10569 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10570 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10571 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10572 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10573 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10574 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10575 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10576 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10577 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10578 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10579 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10580 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10581 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10582 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10583 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10584 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10585 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10586 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10587 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10588 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10589 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10590 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10591 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10592 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10593 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10594 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10595 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10596 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10597 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10598 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10599 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10600 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10601 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10602 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10603 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10604 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10605 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10606 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10607 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10608 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10609 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10610 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10611 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10612 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10613 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10614 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10615 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10616 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10617 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10618 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10619 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10620 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10621 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10622 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10623 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10624 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10625 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10626 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10627 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10628 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10629 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10630 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10631 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10632 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10633 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10634 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10635
10636 =item e
10637
10638 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10639 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10640 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10641 C<expr>, C<extensions>, C<extras>
10642
10643 =item f
10644
10645 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10646 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10647 C<full_sed>
10648
10649 =item g
10650
10651 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10652 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10653 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10654 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10655 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10656 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10657 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10658 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10659 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10660 C<gzip>
10661
10662 =item h
10663
10664 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10665
10666 =item i
10667
10668 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10669 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10670 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10671 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10672 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10673 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10674 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10675 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10676 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10677 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10678 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10679 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10680 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10681 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10682 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10683 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10684 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10685 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10686 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10687 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10688 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10689 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10690 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10691 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10692
10693 =item k
10694
10695 C<known_extensions>, C<ksh>
10696
10697 =item l
10698
10699 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10700 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10701 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10702 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10703 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10704 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10705 C<lseektype>
10706
10707 =item m
10708
10709 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10710 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10711 C<man3direxp>, C<man3ext>
10712
10713 =item M
10714
10715 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10716 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10717
10718 =item n
10719
10720 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10721 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10722 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10723 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10724 C<nvsize>, C<nvtype>
10725
10726 =item o
10727
10728 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10729 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10730
10731 =item p
10732
10733 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10734 C<perl>, C<perl_patchlevel>
10735
10736 =item P
10737
10738 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10739 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10740 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10741 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10742
10743 =item q
10744
10745 C<quadkind>, C<quadtype>
10746
10747 =item r
10748
10749 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10750 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10751 C<rmail>, C<run>, C<runnm>
10752
10753 =item s
10754
10755 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10756 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10757 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10758 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10759 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10760 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10761 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10762 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10763 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10764 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10765 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10766 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10767 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10768 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10769 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10770 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10771 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10772
10773 =item t
10774
10775 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10776 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10777 C<ttyname_r_proto>
10778
10779 =item u
10780
10781 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10782 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10783 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10784 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10785 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10786 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10787 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10788 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10789 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10790
10791 =item v
10792
10793 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10794 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10795 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10796 C<versiononly>, C<vi>, C<voidflags>
10797
10798 =item x
10799
10800 C<xlibpth>, C<xs_apiversion>
10801
10802 =item y
10803
10804 C<yacc>, C<yaccflags>
10805
10806 =item z
10807
10808 C<zcat>, C<zip>
10809
10810 =back
10811
10812 =item NOTE
10813
10814 =back
10815
10816 =head2 Cwd - get pathname of current working directory
10817
10818 =over 4
10819
10820 =item SYNOPSIS
10821
10822 =item DESCRIPTION
10823
10824 =over 4
10825
10826 =item getcwd and friends
10827
10828 getcwd, cwd, fastcwd, fastgetcwd
10829
10830 =item abs_path and friends
10831
10832 abs_path, realpath, fast_abs_path
10833
10834 =item $ENV{PWD}
10835
10836 =back
10837
10838 =item NOTES
10839
10840 =item SEE ALSO
10841
10842 =back
10843
10844 =head2 DB - programmatic interface to the Perl debugging API (draft,
10845 subject to
10846 change)
10847
10848 =over 4
10849
10850 =item SYNOPSIS
10851
10852 =item DESCRIPTION
10853
10854 =over 4
10855
10856 =item Global Variables
10857
10858  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
10859 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
10860 $DB::lineno
10861
10862 =item API Methods
10863
10864 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10865 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10866
10867 =item Client Callback Methods
10868
10869 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10870 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10871 CLIENT->output(LIST)
10872
10873 =back
10874
10875 =item BUGS
10876
10877 =item AUTHOR
10878
10879 =back
10880
10881 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10882
10883 =over 4
10884
10885 =item SYNOPSIS
10886
10887 =item DESCRIPTION
10888
10889 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10890
10891 =over 4
10892
10893 =item Using DB_File with Berkeley DB version 2 or greater
10894
10895 =item Interface to Berkeley DB
10896
10897 =item Opening a Berkeley DB Database File
10898
10899 =item Default Parameters
10900
10901 =item In Memory Databases
10902
10903 =back
10904
10905 =item DB_HASH
10906
10907 =over 4
10908
10909 =item A Simple Example
10910
10911 =back
10912
10913 =item DB_BTREE
10914
10915 =over 4
10916
10917 =item Changing the BTREE sort order
10918
10919 =item Handling Duplicate Keys 
10920
10921 =item The get_dup() Method
10922
10923 =item The find_dup() Method
10924
10925 =item The del_dup() Method
10926
10927 =item Matching Partial Keys 
10928
10929 =back
10930
10931 =item DB_RECNO
10932
10933 =over 4
10934
10935 =item The 'bval' Option
10936
10937 =item A Simple Example
10938
10939 =item Extra RECNO Methods
10940
10941 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10942 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10943 length, elements);>
10944
10945 =item Another Example
10946
10947 =back
10948
10949 =item THE API INTERFACE
10950
10951 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10952 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10953 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10954 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10955
10956 =item DBM FILTERS
10957
10958 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10959 B<filter_fetch_value>
10960
10961 =over 4
10962
10963 =item The Filter
10964
10965 =item An Example -- the NULL termination problem.
10966
10967 =item Another Example -- Key is a C int.
10968
10969 =back
10970
10971 =item HINTS AND TIPS 
10972
10973 =over 4
10974
10975 =item Locking: The Trouble with fd
10976
10977 =item Safe ways to lock a database
10978
10979 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10980
10981 =item Sharing Databases With C Applications
10982
10983 =item The untie() Gotcha
10984
10985 =back
10986
10987 =item COMMON QUESTIONS
10988
10989 =over 4
10990
10991 =item Why is there Perl source in my database?
10992
10993 =item How do I store complex data structures with DB_File?
10994
10995 =item What does "Invalid Argument" mean?
10996
10997 =item What does "Bareword 'DB_File' not allowed" mean? 
10998
10999 =back
11000
11001 =item REFERENCES
11002
11003 =item HISTORY
11004
11005 =item BUGS
11006
11007 =item AVAILABILITY
11008
11009 =item COPYRIGHT
11010
11011 =item SEE ALSO
11012
11013 =item AUTHOR
11014
11015 =back
11016
11017 =head2 Data::Dumper - stringified perl data structures, suitable for both
11018 printing and C<eval>
11019
11020 =over 4
11021
11022 =item SYNOPSIS
11023
11024 =item DESCRIPTION
11025
11026 =over 4
11027
11028 =item Methods
11029
11030 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
11031 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11032 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11033 I<$OBJ>->Reset
11034
11035 =item Functions
11036
11037 Dumper(I<LIST>)
11038
11039 =item Configuration Variables or Methods
11040
11041 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11042 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11043 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11044 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11045 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11046 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11047 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11048 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11049 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11050 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11051 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11052 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11053 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11054 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11055 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11056
11057 =item Exports
11058
11059 Dumper
11060
11061 =back
11062
11063 =item EXAMPLES
11064
11065 =item BUGS
11066
11067 =item AUTHOR
11068
11069 =item VERSION
11070
11071 =item SEE ALSO
11072
11073 =back
11074
11075 =head2 Devel::DProf - a Perl code profiler
11076
11077 =over 4
11078
11079 =item SYNOPSIS
11080
11081 =item DESCRIPTION
11082
11083 =item PROFILE FORMAT
11084
11085 =item AUTOLOAD
11086
11087 =item ENVIRONMENT
11088
11089 =item BUGS
11090
11091 =item SEE ALSO
11092
11093 =back
11094
11095 =head2 Devel::PPPort, Perl/Pollution/Portability
11096
11097 =over 4
11098
11099 =item SYNOPSIS
11100
11101 =item DESCRIPTION
11102
11103 =over 4
11104
11105 =item WriteFile
11106
11107 =back
11108
11109 =item ppport.h
11110
11111 =item AUTHOR
11112
11113 =item SEE ALSO
11114
11115 =back
11116
11117 =head2 Devel::Peek - A data debugging tool for the XS programmer
11118
11119 =over 4
11120
11121 =item SYNOPSIS
11122
11123 =item DESCRIPTION
11124
11125 =over 4
11126
11127 =item Runtime debugging
11128
11129 =item Memory footprint debugging
11130
11131 =back
11132
11133 =item EXAMPLES
11134
11135 =over 4
11136
11137 =item A simple scalar string
11138
11139 =item A simple scalar number
11140
11141 =item A simple scalar with an extra reference
11142
11143 =item A reference to a simple scalar
11144
11145 =item A reference to an array
11146
11147 =item A reference to a hash
11148
11149 =item Dumping a large array or hash
11150
11151 =item A reference to an SV which holds a C pointer
11152
11153 =item A reference to a subroutine
11154
11155 =back
11156
11157 =item EXPORTS
11158
11159 =item BUGS
11160
11161 =item AUTHOR
11162
11163 =item SEE ALSO
11164
11165 =back
11166
11167 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11168
11169 =over 4
11170
11171 =item SYNOPSIS
11172
11173 =item DESCRIPTION
11174
11175 =back
11176
11177 =head2 Digest:: - Modules that calculate message digests
11178
11179 =over 4
11180
11181 =item SYNOPSIS
11182
11183 =item DESCRIPTION
11184
11185 I<binary>, I<hex>, I<base64>
11186
11187 =item OO INTERFACE
11188
11189 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11190 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11191 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11192
11193 =item SEE ALSO
11194
11195 =item AUTHOR
11196
11197 =back
11198
11199 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11200
11201 =over 4
11202
11203 =item SYNOPSIS
11204
11205 =item DESCRIPTION
11206
11207 =item FUNCTIONS
11208
11209 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11210
11211 =item METHODS
11212
11213 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11214 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11215
11216 =item EXAMPLES
11217
11218 =item SEE ALSO
11219
11220 =item COPYRIGHT
11221
11222 =item AUTHORS
11223
11224 =back
11225
11226 =head2 DirHandle - supply object methods for directory handles
11227
11228 =over 4
11229
11230 =item SYNOPSIS
11231
11232 =item DESCRIPTION
11233
11234 =item NOTES
11235
11236 =back
11237
11238 =head2 Dumpvalue - provides screen dump of Perl data.
11239
11240 =over 4
11241
11242 =item SYNOPSIS
11243
11244 =item DESCRIPTION
11245
11246 =over 4
11247
11248 =item Creation
11249
11250 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11251 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11252 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11253 stopDbSignal
11254
11255 =item Methods
11256
11257 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11258 compactDump, veryCompact, set, get
11259
11260 =back
11261
11262 =back
11263
11264 =head2 DynaLoader - Dynamically load C libraries into Perl code
11265
11266 =over 4
11267
11268 =item SYNOPSIS
11269
11270 =item DESCRIPTION
11271
11272 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11273 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11274 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11275 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11276 bootstrap()
11277
11278 =item AUTHOR
11279
11280 =back
11281
11282 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11283 Perl code
11284
11285 =over 4
11286
11287 =item SYNOPSIS
11288
11289 =item DESCRIPTION
11290
11291 =item AUTHOR
11292
11293 =back
11294
11295 =head2 Encode - character encodings
11296
11297 =over 4
11298
11299 =item SYNOPSIS
11300
11301 =over 4
11302
11303 =item Table of Contents
11304
11305 =back
11306
11307 =item DESCRIPTION
11308
11309 =over 4
11310
11311 =item TERMINOLOGY
11312
11313 =back
11314
11315 =item PERL ENCODING API
11316
11317 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11318 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11319 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11320 CHECK]);
11321
11322 =over 4
11323
11324 =item Listing available encodings
11325
11326 =item Defining Aliases
11327
11328 =back
11329
11330 =item Encoding via PerlIO
11331
11332 =item Handling Malformed Data
11333
11334 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11335 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11336 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11337 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11338 bitmask
11339
11340 =over 4
11341
11342 =item Unimplemented fallback schemes
11343
11344 =back
11345
11346 =item Defining Encodings
11347
11348 =item The UTF-8 flag
11349
11350 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11351
11352 =over 4
11353
11354 =item Messing with Perl's Internals
11355
11356 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11357
11358 =back
11359
11360 =item SEE ALSO
11361
11362 =item MAINTAINER
11363
11364 =back
11365
11366 =head2 Encode::Alias - alias definitions to encodings
11367
11368 =over 4
11369
11370 =item SYNOPSIS
11371
11372 =item DESCRIPTION
11373
11374 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11375 reference, e.g.:
11376
11377 =over 4
11378
11379 =item Alias overloading
11380
11381 =back
11382
11383 =item SEE ALSO
11384
11385 =back
11386
11387 =head2 Encode::Byte - Single Byte Encodings
11388
11389 =over 4
11390
11391 =item SYNOPSIS
11392
11393 =item ABSTRACT
11394
11395 =item DESCRIPTION
11396
11397 =item SEE ALSO
11398
11399 =back
11400
11401 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11402
11403 =head2 Encode::CN - China-based Chinese Encodings
11404
11405 =over 4
11406
11407 =item SYNOPSIS
11408
11409 =item DESCRIPTION
11410
11411 =item NOTES
11412
11413 =item BUGS
11414
11415 =item SEE ALSO
11416
11417 =back
11418
11419 =head2 Encode::CN::HZ -- internally used by Encode::CN
11420
11421 =head2 Encode::Config -- internally used by Encode
11422
11423 =head2 Encode::EBCDIC - EBCDIC Encodings
11424
11425 =over 4
11426
11427 =item SYNOPSIS
11428
11429 =item ABSTRACT
11430
11431 =item DESCRIPTION
11432
11433 =item SEE ALSO
11434
11435 =back
11436
11437 =head2 Encode::Encoding - Encode Implementation Base Class
11438
11439 =over 4
11440
11441 =item SYNOPSIS
11442
11443 =item DESCRIPTION
11444
11445 =over 4
11446
11447 =item Methods you should implement
11448
11449 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11450
11451 =item Other methods defined in Encode::Encodings
11452
11453 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11454
11455 =item Example: Encode::ROT13
11456
11457 =back
11458
11459 =item Why the heck Encode API is different?
11460
11461 =over 4
11462
11463 =item Compiled Encodings
11464
11465 =back
11466
11467 =item SEE ALSO
11468
11469 Scheme 1, Scheme 2, Other Schemes
11470
11471 =back
11472
11473 =head2 Encode::Guess -- Guesses encoding from data
11474
11475 =over 4
11476
11477 =item SYNOPSIS
11478
11479 =item ABSTRACT
11480
11481 =item DESCRIPTION
11482
11483 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11484 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11485 guess_encoding($data, [, I<list of suspects>])
11486
11487 =item CAVEATS
11488
11489 =item TO DO
11490
11491 =item SEE ALSO
11492
11493 =back
11494
11495 =head2 Encode::JP - Japanese Encodings
11496
11497 =over 4
11498
11499 =item SYNOPSIS
11500
11501 =item ABSTRACT
11502
11503 =item DESCRIPTION
11504
11505 =item Note on ISO-2022-JP(-1)?
11506
11507 =item BUGS
11508
11509 =item SEE ALSO
11510
11511 =back
11512
11513 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11514
11515 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11516
11517 =head2 Encode::KR - Korean Encodings
11518
11519 =over 4
11520
11521 =item SYNOPSIS
11522
11523 =item DESCRIPTION
11524
11525 =item BUGS
11526
11527 =item SEE ALSO
11528
11529 =back
11530
11531 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11532
11533 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11534
11535 =over 4
11536
11537 =item SYNOPSIS
11538
11539 =item ABSTRACT
11540
11541 =item DESCRIPTION
11542
11543 =item BUGS
11544
11545 =item SEE ALSO
11546
11547 =back
11548
11549 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11550
11551 =over 4
11552
11553 =item Overview
11554
11555 =item How does it work?
11556
11557 =item BUGS
11558
11559 =over 4
11560
11561 =item Workaround
11562
11563 =item How can I tell whether my encoding fully supports PerlIO ?
11564
11565 =back
11566
11567 =item SEE ALSO
11568
11569 =back
11570
11571 =head2 Encode::Supported -- Encodings supported by Encode
11572
11573 =over 4
11574
11575 =item DESCRIPTION
11576
11577 =over 4
11578
11579 =item Encoding Names
11580
11581 =back
11582
11583 =item Supported Encodings
11584
11585 =over 4
11586
11587 =item Built-in Encodings
11588
11589 =item Encode::Unicode -- other Unicode encodings
11590
11591 =item Encode::Byte -- Extended ASCII
11592
11593 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11594 the Cyrillic world, gsm0338 - Hentai Latin 1
11595
11596 =item CJK: Chinese, Japanese, Korean (Multibyte)
11597
11598 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11599 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11600 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11601
11602 =item Miscellaneous encodings
11603
11604 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11605
11606 =back
11607
11608 =item Unsupported encodings
11609
11610   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11611 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11612 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11613 Various Mac encodings, (Mac) Indic encodings
11614
11615 =item Encoding vs. Charset -- terminology
11616
11617 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11618
11619 =over 4
11620
11621 =item Microsoft-related naming mess
11622
11623 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11624
11625 =back
11626
11627 =item Glossary
11628
11629 character repertoire, coded character set (CCS), character encoding scheme
11630 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11631 UTF-16
11632
11633 =item See Also
11634
11635 =item References
11636
11637 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11638 RFC, UC, Unicode Glossary
11639
11640 =over 4
11641
11642 =item Other Notable Sites
11643
11644 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11645 "Introduction to i18n"
11646
11647 =item Offline sources
11648
11649 C<CJKV Information Processing> by Ken Lunde
11650
11651 =back
11652
11653 =back
11654
11655 =head2 Encode::Symbol - Symbol Encodings
11656
11657 =over 4
11658
11659 =item SYNOPSIS
11660
11661 =item ABSTRACT
11662
11663 =item DESCRIPTION
11664
11665 =item SEE ALSO
11666
11667 =back
11668
11669 =head2 Encode::TW - Taiwan-based Chinese Encodings
11670
11671 =over 4
11672
11673 =item SYNOPSIS
11674
11675 =item DESCRIPTION
11676
11677 =item NOTES
11678
11679 =item BUGS
11680
11681 =item SEE ALSO
11682
11683 =back
11684
11685 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11686
11687 =over 4
11688
11689 =item SYNOPSIS
11690
11691 =item ABSTRACT
11692
11693 L<http://www.unicode.org/glossary/> says:, Quick Reference
11694
11695 =item Size, Endianness, and BOM
11696
11697 =over 4
11698
11699 =item by size
11700
11701 =item by endianness
11702
11703 BOM as integer when fetched in network byte order
11704
11705 =back
11706
11707 =item Surrogate Pairs
11708
11709 =item SEE ALSO
11710
11711 =back
11712
11713 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11714 encodings
11715
11716 =over 4
11717
11718 =item SYNOPSIS
11719
11720 =item DESCRIPTION
11721
11722 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11723 reference, e.g.:
11724
11725 =over 4
11726
11727 =item Alias overloading
11728
11729 =back
11730
11731 =item SEE ALSO
11732
11733 =back
11734
11735 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11736 Internally used by Encode::??::ISO_2022_*
11737
11738 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11739 Encode::CN
11740
11741 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11742 Encode
11743
11744 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11745 Implementation Base Class
11746
11747 =over 4
11748
11749 =item SYNOPSIS
11750
11751 =item DESCRIPTION
11752
11753 =over 4
11754
11755 =item Methods you should implement
11756
11757 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11758
11759 =item Other methods defined in Encode::Encodings
11760
11761 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11762
11763 =item Example: Encode::ROT13
11764
11765 =back
11766
11767 =item Why the heck Encode API is different?
11768
11769 =over 4
11770
11771 =item Compiled Encodings
11772
11773 =back
11774
11775 =item SEE ALSO
11776
11777 Scheme 1, Scheme 2, Other Schemes
11778
11779 =back
11780
11781 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11782 data
11783
11784 =over 4
11785
11786 =item SYNOPSIS
11787
11788 =item ABSTRACT
11789
11790 =item DESCRIPTION
11791
11792 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11793 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11794 guess_encoding($data, [, I<list of suspects>])
11795
11796 =item CAVEATS
11797
11798 =item TO DO
11799
11800 =item SEE ALSO
11801
11802 =back
11803
11804 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11805 Encode::JP::2022_JP*
11806
11807 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11808 by Encode::JP
11809
11810 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11811 used by Encode::KR
11812
11813 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11814 and 'Q' header encoding
11815
11816 =over 4
11817
11818 =item SYNOPSIS
11819
11820 =item ABSTRACT
11821
11822 =item DESCRIPTION
11823
11824 =item BUGS
11825
11826 =item SEE ALSO
11827
11828 =back
11829
11830 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11831 on Encode and PerlIO
11832
11833 =over 4
11834
11835 =item Overview
11836
11837 =item How does it work?
11838
11839 =item BUGS
11840
11841 =over 4
11842
11843 =item Workaround
11844
11845 =item How can I tell whether my encoding fully supports PerlIO ?
11846
11847 =back
11848
11849 =item SEE ALSO
11850
11851 =back
11852
11853 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11854 supported by Encode
11855
11856 =over 4
11857
11858 =item DESCRIPTION
11859
11860 =over 4
11861
11862 =item Encoding Names
11863
11864 =back
11865
11866 =item Supported Encodings
11867
11868 =over 4
11869
11870 =item Built-in Encodings
11871
11872 =item Encode::Unicode -- other Unicode encodings
11873
11874 =item Encode::Byte -- Extended ASCII
11875
11876 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11877 the Cyrillic world, gsm0338 - Hentai Latin 1
11878
11879 =item CJK: Chinese, Japanese, Korean (Multibyte)
11880
11881 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11882 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11883 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11884
11885 =item Miscellaneous encodings
11886
11887 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11888
11889 =back
11890
11891 =item Unsupported encodings
11892
11893   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11894 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11895 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11896 Various Mac encodings, (Mac) Indic encodings
11897
11898 =item Encoding vs. Charset -- terminology
11899
11900 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11901
11902 =over 4
11903
11904 =item Microsoft-related naming mess
11905
11906 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11907
11908 =back
11909
11910 =item Glossary
11911
11912 character repertoire, coded character set (CCS), character encoding scheme
11913 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11914 UTF-16
11915
11916 =item See Also
11917
11918 =item References
11919
11920 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11921 RFC, UC, Unicode Glossary
11922
11923 =over 4
11924
11925 =item Other Notable Sites
11926
11927 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11928 "Introduction to i18n"
11929
11930 =item Offline sources
11931
11932 C<CJKV Information Processing> by Ken Lunde
11933
11934 =back
11935
11936 =back
11937
11938 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11939
11940 =over 4
11941
11942 =item SYNOPSIS
11943
11944   use Encode::Encoder;
11945   # Encode::encode("ISO-8859-1", $data); 
11946   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11947   # shortcut
11948   use Encode::Encoder qw(encoder);
11949   encoder($data)->iso_8859_1;
11950   # you can stack them!
11951   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11952   # you can use it as a decoder as well
11953   encoder($base64)->bytes('base64')->latin1;
11954   # stringified
11955   print encoder($data)->utf8->latin1;  # prints the string in latin1
11956   # numified
11957   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11958
11959 =item ABSTRACT
11960
11961 =item Description
11962
11963 =over 4
11964
11965 =item Predefined Methods
11966
11967 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11968 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11969 $e-E<gt>bytes([$encoding])
11970
11971 =item Example: base64 transcoder
11972
11973 =item Operator Overloading
11974
11975 =back
11976
11977 =item SEE ALSO
11978
11979 =back
11980
11981 =head2 Encodencoding, encoding - allows you to write your script in
11982 non-ascii or non-utf8
11983
11984 =over 4
11985
11986 =item SYNOPSIS
11987
11988 =item ABSTRACT
11989
11990 =item USAGE
11991
11992 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11993 I<ENCNAME_IN> ...] ;, no encoding;
11994
11995 =item CAVEATS
11996
11997 =over 4
11998
11999 =item NOT SCOPED
12000
12001 =item DO NOT MIX MULTIPLE ENCODINGS
12002
12003 =back
12004
12005 =item Non-ASCII Identifiers and Filter option
12006
12007 use encoding I<ENCNAME> Filter=E<gt>1;
12008
12009 =item EXAMPLE - Greekperl
12010
12011 =item KNOWN PROBLEMS
12012
12013 =item SEE ALSO
12014
12015 =back
12016
12017 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12018
12019 =over 4
12020
12021 =item SYNOPSIS
12022
12023   use Encode::Encoder;
12024   # Encode::encode("ISO-8859-1", $data); 
12025   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12026   # shortcut
12027   use Encode::Encoder qw(encoder);
12028   encoder($data)->iso_8859_1;
12029   # you can stack them!
12030   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12031   # you can use it as a decoder as well
12032   encoder($base64)->bytes('base64')->latin1;
12033   # stringified
12034   print encoder($data)->utf8->latin1;  # prints the string in latin1
12035   # numified
12036   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12037
12038 =item ABSTRACT
12039
12040 =item Description
12041
12042 =over 4
12043
12044 =item Predefined Methods
12045
12046 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12047 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12048 $e-E<gt>bytes([$encoding])
12049
12050 =item Example: base64 transcoder
12051
12052 =item Operator Overloading
12053
12054 =back
12055
12056 =item SEE ALSO
12057
12058 =back
12059
12060 =head2 English - use nice English (or awk) names for ugly punctuation
12061 variables
12062
12063 =over 4
12064
12065 =item SYNOPSIS
12066
12067 =item DESCRIPTION
12068
12069 =item PERFORMANCE
12070
12071 =back
12072
12073 =head2 Env - perl module that imports environment variables as scalars or
12074 arrays
12075
12076 =over 4
12077
12078 =item SYNOPSIS
12079
12080 =item DESCRIPTION
12081
12082 =item LIMITATIONS
12083
12084 =item AUTHOR
12085
12086 =back
12087
12088 =head2 Errno - System errno constants
12089
12090 =over 4
12091
12092 =item SYNOPSIS
12093
12094 =item DESCRIPTION
12095
12096 =item CAVEATS
12097
12098 =item AUTHOR
12099
12100 =item COPYRIGHT
12101
12102 =back
12103
12104 =head2 Exporter - Implements default import method for modules
12105
12106 =over 4
12107
12108 =item SYNOPSIS
12109
12110 =item DESCRIPTION
12111
12112 =over 4
12113
12114 =item How to Export
12115
12116 =item Selecting What To Export
12117
12118 =item How to Import
12119
12120 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12121
12122 =back
12123
12124 =item Advanced features
12125
12126 =over 4
12127
12128 =item Specialised Import Lists
12129
12130 =item Exporting without using Exporter's import method
12131
12132 =item Module Version Checking
12133
12134 =item Managing Unknown Symbols
12135
12136 =item Tag Handling Utility Functions
12137
12138 =item Generating combined tags
12139
12140 =item C<AUTOLOAD>ed Constants
12141
12142 =back
12143
12144 =back
12145
12146 =head2 Exporter::Heavy - Exporter guts
12147
12148 =over 4
12149
12150 =item SYNOPSIS
12151
12152 =item DESCRIPTION
12153
12154 =back
12155
12156 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12157 Makefiles etc.
12158
12159 =over 4
12160
12161 =item SYNOPSIS
12162
12163 =item DESCRIPTION
12164
12165 =back
12166
12167 cat
12168
12169 eqtime src dst
12170
12171 rm_rf files...
12172
12173 rm_f files...
12174
12175 touch files ..
12176
12177 mv source... destination
12178
12179 cp source... destination
12180
12181 chmod mode files..
12182
12183 mkpath directory..
12184
12185 test_f file
12186
12187 =over 4
12188
12189 =item BUGS
12190
12191 =item SEE ALSO 
12192
12193 =item AUTHOR
12194
12195 =back
12196
12197 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12198
12199 =over 4
12200
12201 =item SYNOPSIS
12202
12203 =item DESCRIPTION
12204
12205 B<test_harness>
12206
12207 =back
12208
12209 =head2 ExtUtils::Constant - generate XS code to import C header constants
12210
12211 =over 4
12212
12213 =item SYNOPSIS
12214
12215 =item DESCRIPTION
12216
12217 =item USAGE
12218
12219 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12220
12221 =item FUNCTIONS
12222
12223 =back
12224
12225 C_stringify NAME
12226
12227 perl_stringify NAME
12228
12229 constant_types
12230
12231 memEQ_clause NAME, CHECKED_AT, INDENT
12232
12233 assign INDENT, TYPE, PRE, POST, VALUE..
12234
12235 return_clause
12236
12237 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12238
12239 params WHAT
12240
12241 dump_names
12242
12243 dogfood
12244
12245 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12246 def_post, utf8
12247
12248 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12249
12250 autoload PACKAGE, VERSION, AUTOLOADER
12251
12252 WriteMakefileSnippet
12253
12254 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12255 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12256
12257 =over 4
12258
12259 =item AUTHOR
12260
12261 =back
12262
12263 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12264
12265 =over 4
12266
12267 =item SYNOPSIS
12268
12269 =item DESCRIPTION
12270
12271 =item @EXPORT
12272
12273 =item FUNCTIONS
12274
12275 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12276 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12277
12278 =item EXAMPLES
12279
12280 =item SEE ALSO
12281
12282 =item AUTHOR
12283
12284 =back
12285
12286 =head2 ExtUtils::Install - install files from here to there
12287
12288 =over 4
12289
12290 =item SYNOPSIS
12291
12292 =item DESCRIPTION
12293
12294 =back
12295
12296 =head2 ExtUtils::Installed - Inventory management of installed modules
12297
12298 =over 4
12299
12300 =item SYNOPSIS
12301
12302 =item DESCRIPTION
12303
12304 =item USAGE
12305
12306 =item FUNCTIONS
12307
12308 new(), modules(), files(), directories(), directory_tree(), validate(),
12309 packlist(), version()
12310
12311 =item EXAMPLE
12312
12313 =item AUTHOR
12314
12315 =back
12316
12317 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12318
12319 =over 4
12320
12321 =item SYNOPSIS
12322
12323 =item DESCRIPTION
12324
12325 For static extensions, For dynamic extensions at build/link time, For
12326 dynamic extensions at load time
12327
12328 =over 4
12329
12330 =item EXTRALIBS
12331
12332 =item LDLOADLIBS and LD_RUN_PATH
12333
12334 =item BSLOADLIBS
12335
12336 =back
12337
12338 =item PORTABILITY
12339
12340 =over 4
12341
12342 =item VMS implementation
12343
12344 =item Win32 implementation
12345
12346 =back
12347
12348 =item SEE ALSO
12349
12350 =back
12351
12352 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12353
12354 =over 4
12355
12356 =item SYNOPSIS
12357
12358 =item DESCRIPTION
12359
12360 =back
12361
12362 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12363
12364 =over 4
12365
12366 =item SYNOPSIS
12367
12368 =item DESCRIPTION
12369
12370 =item Inherently Cross-Platform Methods
12371
12372 =over 4
12373
12374 =item File::Spec wrappers  B<DEPRECATED>
12375
12376 canonpath
12377
12378 =back
12379
12380 =back
12381
12382 catdir
12383
12384 catfile
12385
12386 curdir
12387
12388 file_name_is_absolute
12389
12390 path
12391
12392 rootdir
12393
12394 updir
12395
12396 =over 4
12397
12398 =item Thought To Be Cross-Platform Methods
12399
12400 test_via_harness
12401
12402 =back
12403
12404 test_via_script
12405
12406 =over 4
12407
12408 =item AUTHOR
12409
12410 =back
12411
12412 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12413 ExtUtils::MakeMaker
12414
12415 =over 4
12416
12417 =item SYNOPSIS
12418
12419 =item DESCRIPTION
12420
12421 =back
12422
12423 perl_archive
12424
12425 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12426 ExtUtils::MakeMaker
12427
12428 =over 4
12429
12430 =item SYNOPSIS
12431
12432 =item DESCRIPTION
12433
12434 canonpath, cflags, manifypods, perl_archive
12435
12436 =back
12437
12438 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12439
12440 =over 4
12441
12442 =item SYNOPSIS
12443
12444 =item DESCRIPTION
12445
12446 =over 4
12447
12448 =item Overridden methods
12449
12450 B<replace_manpage_separator>
12451
12452 =back
12453
12454 =back
12455
12456 =over 4
12457
12458 =item AUTHOR
12459
12460 =item SEE ALSO
12461
12462 =back
12463
12464 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12465 ExtUtils::MakeMaker
12466
12467 =over 4
12468
12469 =item SYNOPSIS
12470
12471 =item DESCRIPTION
12472
12473 =back
12474
12475 maybe_command
12476
12477 guess_name
12478
12479 macify
12480
12481 patternify
12482
12483 init_main
12484
12485 init_others
12486
12487 init_dirscan
12488
12489 libscan (o)
12490
12491 constants (o)
12492
12493 static (o)
12494
12495 dlsyms (o)
12496
12497 dynamic (o)
12498
12499 clean (o)
12500
12501 realclean (o)
12502
12503 rulez (o)
12504
12505 processPL (o)
12506
12507 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12508 ExtUtils::MakeMaker
12509
12510 =over 4
12511
12512 =item SYNOPSIS
12513
12514 =item DESCRIPTION
12515
12516 =back
12517
12518 constants (o)
12519
12520 static_lib (o)
12521
12522 dynamic_lib (o)
12523
12524 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12525 ExtUtils::MakeMaker
12526
12527 =over 4
12528
12529 =item SYNOPSIS
12530
12531 =item DESCRIPTION
12532
12533 =item METHODS
12534
12535 =back
12536
12537 perl_archive_after
12538
12539 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12540
12541 =over 4
12542
12543 =item SYNOPSIS
12544
12545 =item DESCRIPTION
12546
12547 =over 4
12548
12549 =item Overridden methods
12550
12551 B<replace_manpage_separator>
12552
12553 =back
12554
12555 =back
12556
12557 =over 4
12558
12559 =item AUTHOR
12560
12561 =item SEE ALSO
12562
12563 =back
12564
12565 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12566
12567 =over 4
12568
12569 =item SYNOPSIS
12570
12571 =item DESCRIPTION
12572
12573 =item METHODS
12574
12575 =back
12576
12577 =over 4
12578
12579 =item SelfLoaded methods
12580
12581 c_o (o)
12582
12583 =back
12584
12585 cflags (o)
12586
12587 clean (o)
12588
12589 const_cccmd (o)
12590
12591 const_config (o)
12592
12593 const_loadlibs (o)
12594
12595 constants (o)
12596
12597 depend (o)
12598
12599 dir_target (o)
12600
12601 dist (o)
12602
12603 dist_basics (o)
12604
12605 dist_ci (o)
12606
12607 dist_core (o)
12608
12609 dist_dir
12610
12611 dist_test
12612
12613 dlsyms (o)
12614
12615 dynamic (o)
12616
12617 dynamic_bs (o)
12618
12619 dynamic_lib (o)
12620
12621 exescan
12622
12623 extliblist
12624
12625 find_perl
12626
12627 find_tests
12628
12629 =over 4
12630
12631 =item Methods to actually produce chunks of text for the Makefile
12632
12633 fixin
12634
12635 =back
12636
12637 force (o)
12638
12639 guess_name
12640
12641 has_link_code
12642
12643 init_dirscan
12644
12645 init_main
12646
12647 init_others
12648
12649 init_INST
12650
12651 init_INSTALL
12652
12653 init_lib2arch
12654
12655 init_PERL
12656
12657 init_PERM
12658
12659 install (o)
12660
12661 installbin (o)
12662
12663 libscan (o)
12664
12665 linkext (o)
12666
12667 lsdir
12668
12669 macro (o)
12670
12671 makeaperl (o)
12672
12673 makefile (o)
12674
12675 manifypods (o)
12676
12677 maybe_command
12678
12679 maybe_command_in_dirs
12680
12681 needs_linking (o)
12682
12683 nicetext
12684
12685 parse_abstract
12686
12687 parse_version
12688
12689 pasthru (o)
12690
12691 perl_script
12692
12693 perldepend (o)
12694
12695 perm_rw (o)
12696
12697 perm_rwx (o)
12698
12699 pm_to_blib
12700
12701 post_constants (o)
12702
12703 post_initialize (o)
12704
12705 postamble (o)
12706
12707 ppd
12708
12709 prefixify
12710
12711 processPL (o)
12712
12713 quote_paren
12714
12715 realclean (o)
12716
12717 replace_manpage_separator
12718
12719 static (o)
12720
12721 static_lib (o)
12722
12723 staticmake (o)
12724
12725 subdir_x (o)
12726
12727 subdirs (o)
12728
12729 test (o)
12730
12731 test_via_harness (override)
12732
12733 test_via_script (override)
12734
12735 tool_autosplit (o)
12736
12737 tools_other (o)
12738
12739 tool_xsubpp (o)
12740
12741 top_targets (o)
12742
12743 writedoc
12744
12745 xs_c (o)
12746
12747 xs_cpp (o)
12748
12749 xs_o (o)
12750
12751 perl_archive
12752
12753 perl_archive_after
12754
12755 export_list
12756
12757 =over 4
12758
12759 =item SEE ALSO
12760
12761 =back
12762
12763 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12764 ExtUtils::MakeMaker
12765
12766 =over 4
12767
12768 =item SYNOPSIS
12769
12770 =item DESCRIPTION
12771
12772 =over 4
12773
12774 =item Methods always loaded
12775
12776 wraplist
12777
12778 =back
12779
12780 =back
12781
12782 =over 4
12783
12784 =item Methods
12785
12786 guess_name (override)
12787
12788 =back
12789
12790 find_perl (override)
12791
12792 maybe_command (override)
12793
12794 maybe_command_in_dirs (override)
12795
12796 perl_script (override)
12797
12798 replace_manpage_separator
12799
12800 init_main (override)
12801
12802 init_others (override)
12803
12804 constants (override)
12805
12806 cflags (override)
12807
12808 const_cccmd (override)
12809
12810 pm_to_blib (override)
12811
12812 tool_autosplit (override)
12813
12814 tool_sxubpp (override)
12815
12816 xsubpp_version (override)
12817
12818 tools_other (override)
12819
12820 dist (override)
12821
12822 c_o (override)
12823
12824 xs_c (override)
12825
12826 xs_o (override)
12827
12828 top_targets (override)
12829
12830 dlsyms (override)
12831
12832 dynamic_lib (override)
12833
12834 dynamic_bs (override)
12835
12836 static_lib (override)
12837
12838 manifypods (override)
12839
12840 processPL (override)
12841
12842 installbin (override)
12843
12844 subdir_x (override)
12845
12846 clean (override)
12847
12848 realclean (override)
12849
12850 dist_core (override)
12851
12852 dist_test (override)
12853
12854 install (override)
12855
12856 perldepend (override)
12857
12858 makefile (override)
12859
12860 find_tests (override)
12861
12862 test (override)
12863
12864 makeaperl (override)
12865
12866 nicetext (override)
12867
12868 prefixify (override)
12869
12870 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12871 ExtUtils::MakeMaker
12872
12873 =over 4
12874
12875 =item SYNOPSIS
12876
12877 =item DESCRIPTION
12878
12879 =back
12880
12881 constants (o)
12882
12883 static_lib (o)
12884
12885 dynamic_bs (o)
12886
12887 dynamic_lib (o)
12888
12889 perl_script
12890
12891 pm_to_blib
12892
12893 tool_autosplit (override)
12894
12895 tools_other (o)
12896
12897 xs_o (o)
12898
12899 top_targets (o)
12900
12901 manifypods (o)
12902
12903 dist_ci (o)
12904
12905 dist_core (o)
12906
12907 pasthru (o)
12908
12909 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12910
12911 =over 4
12912
12913 =item SYNOPSIS
12914
12915 =item DESCRIPTION
12916
12917 =back
12918
12919 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12920
12921 =over 4
12922
12923 =item SYNOPSIS
12924
12925 =item DESCRIPTION
12926
12927 =back
12928
12929 =head2 ExtUtils::MakeMaker - create an extension Makefile
12930
12931 =over 4
12932
12933 =item SYNOPSIS
12934
12935 =item DESCRIPTION
12936
12937 =over 4
12938
12939 =item How To Write A Makefile.PL
12940
12941 =item Default Makefile Behaviour
12942
12943 =item make test
12944
12945 =item make testdb
12946
12947 =item make install
12948
12949 =item PREFIX and LIB attribute
12950
12951 =item AFS users
12952
12953 =item Static Linking of a new Perl Binary
12954
12955 =item Determination of Perl Library and Installation Locations
12956
12957 =item Which architecture dependent directory?
12958
12959 =item Using Attributes and Parameters
12960
12961 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12962 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12963 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12964 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12965 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12966 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12967 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12968 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12969 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
12970 LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
12971 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
12972 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
12973 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
12974 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
12975 PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
12976 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
12977 XSPROTOARG, XS_VERSION
12978
12979 =item Additional lowercase attributes
12980
12981 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12982 tool_autosplit
12983
12984 =item Overriding MakeMaker Methods
12985
12986 =item Hintsfile support
12987
12988 =item Distribution Support
12989
12990    make distcheck,    make skipcheck,    make distclean,    make manifest, 
12991   make distdir,   make disttest,    make tardist,    make dist,    make
12992 uutardist,    make shdist,    make zipdist,    make ci
12993
12994 =item Disabling an extension
12995
12996 =back
12997
12998 =item ENVIRONMENT
12999
13000 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13001
13002 =item SEE ALSO
13003
13004 =item AUTHORS
13005
13006 =back
13007
13008 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13009
13010 =over 4
13011
13012 =item SYNOPSIS
13013
13014 =item DESCRIPTION
13015
13016 =item MANIFEST.SKIP
13017
13018 =item EXPORT_OK
13019
13020 =item GLOBAL VARIABLES
13021
13022 =item DIAGNOSTICS
13023
13024 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13025 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13026
13027 =item ENVIRONMENT
13028
13029 B<PERL_MM_MANIFEST_DEBUG>
13030
13031 =item SEE ALSO
13032
13033 =item AUTHOR
13034
13035 =back
13036
13037 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13038
13039 =over 4
13040
13041 =item SYNOPSIS
13042
13043 =item DESCRIPTION
13044
13045 =item SEE ALSO
13046
13047 =back
13048
13049 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13050
13051 =over 4
13052
13053 =item SYNOPSIS
13054
13055 =item DESCRIPTION
13056
13057 =back
13058
13059 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13060 extension
13061
13062 =over 4
13063
13064 =item SYNOPSIS
13065
13066 =item DESCRIPTION
13067
13068 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13069
13070 =item AUTHOR
13071
13072 =item REVISION
13073
13074 =back
13075
13076 =head2 ExtUtils::Packlist - manage .packlist files
13077
13078 =over 4
13079
13080 =item SYNOPSIS
13081
13082 =item DESCRIPTION
13083
13084 =item USAGE
13085
13086 =item FUNCTIONS
13087
13088 new(), read(), write(), validate(), packlist_file()
13089
13090 =item EXAMPLE
13091
13092 =item AUTHOR
13093
13094 =back
13095
13096 =head2 ExtUtils::testlib - add blib/* directories to @INC
13097
13098 =over 4
13099
13100 =item SYNOPSIS
13101
13102 =item DESCRIPTION
13103
13104 =back
13105
13106 =head2 Fatal - replace functions with equivalents which succeed or die
13107
13108 =over 4
13109
13110 =item SYNOPSIS
13111
13112 =item DESCRIPTION
13113
13114 =item AUTHOR
13115
13116 =back
13117
13118 =head2 Fcntl - load the C Fcntl.h defines
13119
13120 =over 4
13121
13122 =item SYNOPSIS
13123
13124 =item DESCRIPTION
13125
13126 =item NOTE
13127
13128 =item EXPORTED SYMBOLS
13129
13130 =back
13131
13132 =head2 File::Basename, fileparse - split a pathname into pieces
13133
13134 =over 4
13135
13136 =item SYNOPSIS
13137
13138 =item DESCRIPTION
13139
13140 fileparse_set_fstype, fileparse
13141
13142 =item EXAMPLES
13143
13144 C<basename>, C<dirname>
13145
13146 =back
13147
13148 =head2 File::CheckTree, validate - run many filetest checks on a tree
13149
13150 =over 4
13151
13152 =item SYNOPSIS
13153
13154 =item DESCRIPTION
13155
13156 =item AUTHOR
13157
13158 =item HISTORY
13159
13160 =back
13161
13162 =head2 File::Compare - Compare files or filehandles
13163
13164 =over 4
13165
13166 =item SYNOPSIS
13167
13168 =item DESCRIPTION
13169
13170 =item RETURN
13171
13172 =item AUTHOR
13173
13174 =back
13175
13176 =head2 File::Copy - Copy files or filehandles
13177
13178 =over 4
13179
13180 =item SYNOPSIS
13181
13182 =item DESCRIPTION
13183
13184 =over 4
13185
13186 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13187
13188 rmscopy($from,$to[,$date_flag])
13189
13190 =back
13191
13192 =item RETURN
13193
13194 =item NOTES
13195
13196 =item AUTHOR
13197
13198 =back
13199
13200 =head2 File::DosGlob - DOS like globbing and then some
13201
13202 =over 4
13203
13204 =item SYNOPSIS
13205
13206 =item DESCRIPTION
13207
13208 =item NOTES
13209
13210 =item EXPORTS (by request only)
13211
13212 =item BUGS
13213
13214 =item AUTHOR
13215
13216 =item HISTORY
13217
13218 =item SEE ALSO
13219
13220 =back
13221
13222 =head2 File::Find - Traverse a directory tree.
13223
13224 =over 4
13225
13226 =item SYNOPSIS
13227
13228 =item DESCRIPTION
13229
13230 B<find>, B<finddepth>
13231
13232 =over 4
13233
13234 =item %options
13235
13236 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13237 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13238 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13239
13240 =item The wanted function
13241
13242 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13243 filename within that directory, C<$File::Find::name> is the complete
13244 pathname to the file
13245
13246 =back
13247
13248 =item WARNINGS
13249
13250 =item CAVEAT
13251
13252 $dont_use_nlink, symlinks
13253
13254 =item NOTES
13255
13256 =item HISTORY
13257
13258 =back
13259
13260 =head2 File::Glob - Perl extension for BSD glob routine
13261
13262 =over 4
13263
13264 =item SYNOPSIS
13265
13266 =item DESCRIPTION
13267
13268 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13269 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13270 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13271
13272 =item DIAGNOSTICS
13273
13274 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13275
13276 =item NOTES
13277
13278 =item AUTHOR
13279
13280 =back
13281
13282 =head2 File::Path - create or remove directory trees
13283
13284 =over 4
13285
13286 =item SYNOPSIS
13287
13288 =item DESCRIPTION
13289
13290 =item AUTHORS
13291
13292 =back
13293
13294 =head2 File::Spec - portably perform operations on file names
13295
13296 =over 4
13297
13298 =item SYNOPSIS
13299
13300 =item DESCRIPTION
13301
13302 =item METHODS
13303
13304 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13305 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13306 splitdir, catpath(), abs2rel, rel2abs()
13307
13308 =item SEE ALSO
13309
13310 =item AUTHORS
13311
13312 =back
13313
13314 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13315
13316 =over 4
13317
13318 =item SYNOPSIS
13319
13320 =item DESCRIPTION
13321
13322 =back
13323
13324 =head2 File::Spec::Epoc - methods for Epoc file specs
13325
13326 =over 4
13327
13328 =item SYNOPSIS
13329
13330 =item DESCRIPTION
13331
13332 canonpath()
13333
13334 =back
13335
13336 =over 4
13337
13338 =item SEE ALSO
13339
13340 =back
13341
13342 =head2 File::Spec::Functions - portably perform operations on file names
13343
13344 =over 4
13345
13346 =item SYNOPSIS
13347
13348 =item DESCRIPTION
13349
13350 =over 4
13351
13352 =item Exports
13353
13354 =back
13355
13356 =item SEE ALSO
13357
13358 =back
13359
13360 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13361
13362 =over 4
13363
13364 =item SYNOPSIS
13365
13366 =item DESCRIPTION
13367
13368 =item METHODS
13369
13370 canonpath
13371
13372 =back
13373
13374 catdir()
13375
13376 catfile
13377
13378 curdir
13379
13380 devnull
13381
13382 rootdir
13383
13384 tmpdir
13385
13386 updir
13387
13388 file_name_is_absolute
13389
13390 path
13391
13392 splitpath
13393
13394 splitdir
13395
13396 catpath
13397
13398 abs2rel
13399
13400 rel2abs
13401
13402 =over 4
13403
13404 =item AUTHORS
13405
13406 =item SEE ALSO
13407
13408 =back
13409
13410 =head2 File::Spec::NW5 - methods for NW5 file specs
13411
13412 =over 4
13413
13414 =item SYNOPSIS
13415
13416 =item DESCRIPTION
13417
13418 devnull
13419
13420 =back
13421
13422 tmpdir
13423
13424 catfile
13425
13426 canonpath
13427
13428 splitpath
13429
13430 splitdir
13431
13432 catpath
13433
13434 =over 4
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 SEE ALSO
13598
13599 =back
13600
13601 =head2 File::Temp - return name and handle of a temporary file safely
13602
13603 =over 4
13604
13605 =item PORTABILITY
13606
13607 =item SYNOPSIS
13608
13609 =item DESCRIPTION
13610
13611 =back
13612
13613 =over 4
13614
13615 =item FUNCTIONS
13616
13617 B<tempfile>
13618
13619 =back
13620
13621 B<tempdir>
13622
13623 =over 4
13624
13625 =item MKTEMP FUNCTIONS
13626
13627 B<mkstemp>
13628
13629 =back
13630
13631 B<mkstemps>
13632
13633 B<mkdtemp>
13634
13635 B<mktemp>
13636
13637 =over 4
13638
13639 =item POSIX FUNCTIONS
13640
13641 B<tmpnam>
13642
13643 =back
13644
13645 B<tmpfile>
13646
13647 =over 4
13648
13649 =item ADDITIONAL FUNCTIONS
13650
13651 B<tempnam>
13652
13653 =back
13654
13655 =over 4
13656
13657 =item UTILITY FUNCTIONS
13658
13659 B<unlink0>
13660
13661 =back
13662
13663 =over 4
13664
13665 =item PACKAGE VARIABLES
13666
13667 B<safe_level>, STANDARD, MEDIUM, HIGH
13668
13669 =back
13670
13671 TopSystemUID
13672
13673 =over 4
13674
13675 =item WARNING
13676
13677 =over 4
13678
13679 =item Temporary files and NFS
13680
13681 =back
13682
13683 =item HISTORY
13684
13685 =item SEE ALSO
13686
13687 =item AUTHOR
13688
13689 =back
13690
13691 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13692
13693 =over 4
13694
13695 =item SYNOPSIS
13696
13697 =item DESCRIPTION
13698
13699 =item NOTE
13700
13701 =item AUTHOR
13702
13703 =back
13704
13705 =head2 FileCache - keep more files open than the system permits
13706
13707 =over 4
13708
13709 =item SYNOPSIS
13710
13711 =item DESCRIPTION
13712
13713 cacheout EXPR, cacheout MODE, EXPR
13714
13715 =item CAVEATS
13716
13717 =item BUGS
13718
13719 =back
13720
13721 =head2 FileHandle - supply object methods for filehandles
13722
13723 =over 4
13724
13725 =item SYNOPSIS
13726
13727 =item DESCRIPTION
13728
13729 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13730
13731 =item SEE ALSO
13732
13733 =back
13734
13735 =head2 Filter::Simple - Simplified source filtering
13736
13737 =over 4
13738
13739 =item SYNOPSIS
13740
13741 =item DESCRIPTION
13742
13743 =over 4
13744
13745 =item The Problem
13746
13747 =item A Solution
13748
13749 =item Disabling or changing <no> behaviour
13750
13751 =item All-in-one interface
13752
13753 =item Filtering only specific components of source code
13754
13755 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13756 C<"all">
13757
13758 =item Filtering only the code parts of source code
13759
13760 Most source code ceases to be grammatically correct when it is broken up
13761 into the pieces between string literals and regexes. So the C<'code'>
13762 component filter behaves slightly differently from the other partial
13763 filters
13764 described in the previous section.
13765
13766 =item Using Filter::Simple with an explicit C<import> subroutine
13767
13768 =item Using Filter::Simple and Exporter together
13769
13770 =item How it works
13771
13772 =back
13773
13774 =item AUTHOR
13775
13776 =item COPYRIGHT
13777
13778 =back
13779
13780 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13781
13782 =over 4
13783
13784 =item SYNOPSIS
13785
13786 =item DESCRIPTION
13787
13788 =over 4
13789
13790 =item B<use Filter::Util::Call>
13791
13792 =item B<import()>
13793
13794 =item B<filter() and anonymous sub>
13795
13796 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13797
13798 =back
13799
13800 =item EXAMPLES
13801
13802 =over 4
13803
13804 =item Example 1: A simple filter.
13805
13806 =item Example 2: Using the context
13807
13808 =item Example 3: Using the context within the filter
13809
13810 =item Example 4: Using filter_del
13811
13812 =back
13813
13814 =item Filter::Simple
13815
13816 =item AUTHOR
13817
13818 =item DATE
13819
13820 =back
13821
13822 =head2 FindBin - Locate directory of original perl script
13823
13824 =over 4
13825
13826 =item SYNOPSIS
13827
13828 =item DESCRIPTION
13829
13830 =item EXPORTABLE VARIABLES
13831
13832 =item KNOWN ISSUES
13833
13834 =item KNOWN BUGS
13835
13836 =item AUTHORS
13837
13838 =item COPYRIGHT
13839
13840 =back
13841
13842 =head2 GDBM_File - Perl5 access to the gdbm library.
13843
13844 =over 4
13845
13846 =item SYNOPSIS
13847
13848 =item DESCRIPTION
13849
13850 =item AVAILABILITY
13851
13852 =item BUGS
13853
13854 =item SEE ALSO
13855
13856 =back
13857
13858 =head2 Getopt::Long - Extended processing of command line options
13859
13860 =over 4
13861
13862 =item SYNOPSIS
13863
13864 =item DESCRIPTION
13865
13866 =item Command Line Options, an Introduction
13867
13868 =item Getting Started with Getopt::Long
13869
13870 =over 4
13871
13872 =item Simple options
13873
13874 =item A little bit less simple options
13875
13876 =item Mixing command line option with other arguments
13877
13878 =item Options with values
13879
13880 =item Options with multiple values
13881
13882 =item Options with hash values
13883
13884 =item User-defined subroutines to handle options
13885
13886 =item Options with multiple names
13887
13888 =item Case and abbreviations
13889
13890 =item Summary of Option Specifications
13891
13892 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13893 + [ I<desttype> ]
13894
13895 =back
13896
13897 =item Advanced Possibilities
13898
13899 =over 4
13900
13901 =item Object oriented interface
13902
13903 =item Documentation and help texts
13904
13905 =item Storing options in a hash
13906
13907 =item Bundling
13908
13909 =item The lonesome dash
13910
13911 =item Argument callback
13912
13913 =back
13914
13915 =item Configuring Getopt::Long
13916
13917 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13918 require_order, permute, bundling (default: disabled), bundling_override
13919 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13920 (default: disabled), pass_through (default: disabled), prefix,
13921 prefix_pattern, debug (default: disabled)
13922
13923 =item Return values and Errors
13924
13925 =item Legacy
13926
13927 =over 4
13928
13929 =item Default destinations
13930
13931 =item Alternative option starters
13932
13933 =item Configuration variables
13934
13935 =back
13936
13937 =item Trouble Shooting
13938
13939 =over 4
13940
13941 =item Warning: Ignoring '!' modifier for short option
13942
13943 =item GetOptions does not return a false result when an option is not
13944 supplied
13945
13946 =item GetOptions does not split the command line correctly
13947
13948 =item How do I put a "-?" option into a Getopt::Long?
13949
13950 =back
13951
13952 =item AUTHOR
13953
13954 =item COPYRIGHT AND DISCLAIMER
13955
13956 =back
13957
13958 =head2 Getopt::Std, getopt - Process single-character switches with switch
13959 clustering
13960
13961 =over 4
13962
13963 =item SYNOPSIS
13964
13965 =item DESCRIPTION
13966
13967 =back
13968
13969 =head2 Hash::Util - A selection of general-utility hash subroutines
13970
13971 =over 4
13972
13973 =item SYNOPSIS
13974
13975 =item DESCRIPTION
13976
13977 =over 4
13978
13979 =item Restricted hashes
13980
13981 lock_keys, unlock_keys
13982
13983 =back
13984
13985 =back
13986
13987 lock_value, unlock_value
13988
13989 B<lock_hash>, B<unlock_hash>
13990
13991 =over 4
13992
13993 =item AUTHOR
13994
13995 =item SEE ALSO
13996
13997 =back
13998
13999 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14000 locale
14001
14002 =over 4
14003
14004 =item SYNOPSIS
14005
14006 =item DESCRIPTION
14007
14008 =back
14009
14010 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14011 tags
14012
14013 =over 4
14014
14015 =item SYNOPSIS
14016
14017 =item DESCRIPTION
14018
14019 =back
14020
14021 the function is_language_tag($lang1)
14022
14023 the function extract_language_tags($whatever)
14024
14025 the function same_language_tag($lang1, $lang2)
14026
14027 the function similarity_language_tag($lang1, $lang2)
14028
14029 the function is_dialect_of($lang1, $lang2)
14030
14031 the function super_languages($lang1)
14032
14033 the function locale2language_tag($locale_identifier)
14034
14035 the function encode_language_tag($lang1)
14036
14037 the function alternate_language_tags($lang1)
14038
14039 the function @langs = panic_languages(@accept_languages)
14040
14041 =over 4
14042
14043 =item ABOUT LOWERCASING
14044
14045 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14046
14047 =item SEE ALSO
14048
14049 =item COPYRIGHT
14050
14051 =item AUTHOR
14052
14053 =back
14054
14055 =head2 I18N::LangTags::List -- tags and names for human languages
14056
14057 =over 4
14058
14059 =item SYNOPSIS
14060
14061 =item DESCRIPTION
14062
14063 =item ABOUT LANGUAGE TAGS
14064
14065 =item LIST OF LANGUAGES
14066
14067 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14068 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14069 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14070 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14071 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14072 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14073 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14074 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14075 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14076 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14077 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14078 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14079 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14080 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14081 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14082 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14083 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14084 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14085 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14086 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14087 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14088 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14089 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14090 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14091 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14092 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14093 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14094 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14095 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14096 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14097 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14098 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14099 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14100 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14101 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14102 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14103 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14104 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14105 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14106 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14107 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14108 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14109 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14110 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14111 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14112 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14113 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14114 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14115 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14116 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14117 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14118 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14119 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14120 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14121 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14122 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14123 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14124 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14125 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14126 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14127 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14128 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14129 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14130 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14131 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14132 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14133 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14134 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14135 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14136 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14137 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14138 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14139 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14140 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14141 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14142 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14143 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14144 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14145 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14146 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14147 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14148 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14149 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14150 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14151 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14152 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14153 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14154 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14155 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14156 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14157 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14158 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14159 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14160 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14161 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14162 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14163 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14164 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14165 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14166 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14167 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14168 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14169 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14170 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14171 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14172 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14173 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14174 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14175 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14176 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14177 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14178 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14179 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14180 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14181 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14182 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14183 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14184 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14185 Zhuang, {zu} : Zulu, {zun} : Zuni
14186
14187 =item SEE ALSO
14188
14189 =item COPYRIGHT AND DISCLAIMER
14190
14191 =item AUTHOR
14192
14193 =back
14194
14195 =head2 I18N::Langinfo - query locale information
14196
14197 =over 4
14198
14199 =item SYNOPSIS
14200
14201 =item DESCRIPTION
14202
14203 =over 4
14204
14205 =item EXPORT
14206
14207 =back
14208
14209 =item SEE ALSO
14210
14211 =item AUTHOR
14212
14213 =item COPYRIGHT AND LICENSE
14214
14215 =back
14216
14217 =head2 IO - load various IO modules
14218
14219 =over 4
14220
14221 =item SYNOPSIS
14222
14223 =item DESCRIPTION
14224
14225 =back
14226
14227 =head2 IO::Dir - supply object methods for directory handles
14228
14229 =over 4
14230
14231 =item SYNOPSIS
14232
14233 =item DESCRIPTION
14234
14235 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14236 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14237
14238 =item SEE ALSO
14239
14240 =item AUTHOR
14241
14242 =item COPYRIGHT
14243
14244 =back
14245
14246 =head2 IO::File - supply object methods for filehandles
14247
14248 =over 4
14249
14250 =item SYNOPSIS
14251
14252 =item DESCRIPTION
14253
14254 =item CONSTRUCTOR
14255
14256 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14257
14258 =item METHODS
14259
14260 open( FILENAME [,MODE [,PERMS]] )
14261
14262 =item SEE ALSO
14263
14264 =item HISTORY
14265
14266 =back
14267
14268 =head2 IO::Handle - supply object methods for I/O handles
14269
14270 =over 4
14271
14272 =item SYNOPSIS
14273
14274 =item DESCRIPTION
14275
14276 =item CONSTRUCTOR
14277
14278 new (), new_from_fd ( FD, MODE )
14279
14280 =item METHODS
14281
14282 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14283 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14284 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14285 $io->blocking ( [ BOOL ] ), $io->untaint
14286
14287 =item NOTE
14288
14289 =item SEE ALSO
14290
14291 =item BUGS
14292
14293 =item HISTORY
14294
14295 =back
14296
14297 =head2 IO::Pipe - supply object methods for pipes
14298
14299 =over 4
14300
14301 =item SYNOPSIS
14302
14303 =item DESCRIPTION
14304
14305 =item CONSTRUCTOR
14306
14307 new ( [READER, WRITER] )
14308
14309 =item METHODS
14310
14311 reader ([ARGS]), writer ([ARGS]), handles ()
14312
14313 =item SEE ALSO
14314
14315 =item AUTHOR
14316
14317 =item COPYRIGHT
14318
14319 =back
14320
14321 =head2 IO::Poll - Object interface to system poll call
14322
14323 =over 4
14324
14325 =item SYNOPSIS
14326
14327 =item DESCRIPTION
14328
14329 =item METHODS
14330
14331 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14332 IO ), handles( [ EVENT_MASK ] )
14333
14334 =item SEE ALSO
14335
14336 =item AUTHOR
14337
14338 =item COPYRIGHT
14339
14340 =back
14341
14342 =head2 IO::Seekable - supply seek based methods for I/O objects
14343
14344 =over 4
14345
14346 =item SYNOPSIS
14347
14348 =item DESCRIPTION
14349
14350 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14351 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14352 $io->tell
14353
14354 =item SEE ALSO
14355
14356 =item HISTORY
14357
14358 =back
14359
14360 =head2 IO::Select - OO interface to the select system call
14361
14362 =over 4
14363
14364 =item SYNOPSIS
14365
14366 =item DESCRIPTION
14367
14368 =item CONSTRUCTOR
14369
14370 new ( [ HANDLES ] )
14371
14372 =item METHODS
14373
14374 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14375 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14376 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14377
14378 =item EXAMPLE
14379
14380 =item AUTHOR
14381
14382 =item COPYRIGHT
14383
14384 =back
14385
14386 =head2 IO::Socket - Object interface to socket communications
14387
14388 =over 4
14389
14390 =item SYNOPSIS
14391
14392 =item DESCRIPTION
14393
14394 =item CONSTRUCTOR
14395
14396 new ( [ARGS] )
14397
14398 =item METHODS
14399
14400 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14401 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14402
14403 =item SEE ALSO
14404
14405 =item AUTHOR
14406
14407 =item COPYRIGHT
14408
14409 =back
14410
14411 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14412
14413 =over 4
14414
14415 =item SYNOPSIS
14416
14417 =item DESCRIPTION
14418
14419 =item CONSTRUCTOR
14420
14421 new ( [ARGS] )
14422
14423 =over 4
14424
14425 =item METHODS
14426
14427 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14428 ()
14429
14430 =back
14431
14432 =item SEE ALSO
14433
14434 =item AUTHOR
14435
14436 =item COPYRIGHT
14437
14438 =back
14439
14440 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14441
14442 =over 4
14443
14444 =item SYNOPSIS
14445
14446 =item DESCRIPTION
14447
14448 =item CONSTRUCTOR
14449
14450 new ( [ARGS] )
14451
14452 =item METHODS
14453
14454 hostpath(), peerpath()
14455
14456 =item SEE ALSO
14457
14458 =item AUTHOR
14459
14460 =item COPYRIGHT
14461
14462 =back
14463
14464 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14465 handles
14466
14467 =over 4
14468
14469 =item SYNOPSIS
14470
14471 =item DESCRIPTION
14472
14473 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14474 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14475
14476 =item SEE ALSO
14477
14478 =item AUTHOR
14479
14480 =item COPYRIGHT
14481
14482 =back
14483
14484 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14485
14486 =over 4
14487
14488 =item SYNOPSIS
14489
14490 =item DESCRIPTION
14491
14492 =item CONSTRUCTOR
14493
14494 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14495
14496 =item METHODS
14497
14498 open( FILENAME [,MODE [,PERMS]] )
14499
14500 =item SEE ALSO
14501
14502 =item HISTORY
14503
14504 =back
14505
14506 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14507 handles
14508
14509 =over 4
14510
14511 =item SYNOPSIS
14512
14513 =item DESCRIPTION
14514
14515 =item CONSTRUCTOR
14516
14517 new (), new_from_fd ( FD, MODE )
14518
14519 =item METHODS
14520
14521 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14522 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14523 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14524 $io->blocking ( [ BOOL ] ), $io->untaint
14525
14526 =item NOTE
14527
14528 =item SEE ALSO
14529
14530 =item BUGS
14531
14532 =item HISTORY
14533
14534 =back
14535
14536 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14537
14538 =over 4
14539
14540 =item SYNOPSIS
14541
14542 =item DESCRIPTION
14543
14544 =item CONSTRUCTOR
14545
14546 new ( [READER, WRITER] )
14547
14548 =item METHODS
14549
14550 reader ([ARGS]), writer ([ARGS]), handles ()
14551
14552 =item SEE ALSO
14553
14554 =item AUTHOR
14555
14556 =item COPYRIGHT
14557
14558 =back
14559
14560 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14561
14562 =over 4
14563
14564 =item SYNOPSIS
14565
14566 =item DESCRIPTION
14567
14568 =item METHODS
14569
14570 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14571 IO ), handles( [ EVENT_MASK ] )
14572
14573 =item SEE ALSO
14574
14575 =item AUTHOR
14576
14577 =item COPYRIGHT
14578
14579 =back
14580
14581 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14582 I/O objects
14583
14584 =over 4
14585
14586 =item SYNOPSIS
14587
14588 =item DESCRIPTION
14589
14590 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14591 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14592 $io->tell
14593
14594 =item SEE ALSO
14595
14596 =item HISTORY
14597
14598 =back
14599
14600 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14601 call
14602
14603 =over 4
14604
14605 =item SYNOPSIS
14606
14607 =item DESCRIPTION
14608
14609 =item CONSTRUCTOR
14610
14611 new ( [ HANDLES ] )
14612
14613 =item METHODS
14614
14615 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14616 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14617 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14618
14619 =item EXAMPLE
14620
14621 =item AUTHOR
14622
14623 =item COPYRIGHT
14624
14625 =back
14626
14627 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14628 communications
14629
14630 =over 4
14631
14632 =item SYNOPSIS
14633
14634 =item DESCRIPTION
14635
14636 =item CONSTRUCTOR
14637
14638 new ( [ARGS] )
14639
14640 =item METHODS
14641
14642 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14643 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14644
14645 =item SEE ALSO
14646
14647 =item AUTHOR
14648
14649 =item COPYRIGHT
14650
14651 =back
14652
14653 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14654 AF_INET domain sockets
14655
14656 =over 4
14657
14658 =item SYNOPSIS
14659
14660 =item DESCRIPTION
14661
14662 =item CONSTRUCTOR
14663
14664 new ( [ARGS] )
14665
14666 =over 4
14667
14668 =item METHODS
14669
14670 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14671 ()
14672
14673 =back
14674
14675 =item SEE ALSO
14676
14677 =item AUTHOR
14678
14679 =item COPYRIGHT
14680
14681 =back
14682
14683 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14684 AF_UNIX domain sockets
14685
14686 =over 4
14687
14688 =item SYNOPSIS
14689
14690 =item DESCRIPTION
14691
14692 =item CONSTRUCTOR
14693
14694 new ( [ARGS] )
14695
14696 =item METHODS
14697
14698 hostpath(), peerpath()
14699
14700 =item SEE ALSO
14701
14702 =item AUTHOR
14703
14704 =item COPYRIGHT
14705
14706 =back
14707
14708 =head2 IPC::Msg - SysV Msg IPC object class
14709
14710 =over 4
14711
14712 =item SYNOPSIS
14713
14714 =item DESCRIPTION
14715
14716 =item METHODS
14717
14718 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14719 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14720 FLAGS ] ), stat
14721
14722 =item SEE ALSO
14723
14724 =item AUTHOR
14725
14726 =item COPYRIGHT
14727
14728 =back
14729
14730 =head2 IPC::Open2, open2 - open a process for both reading and writing
14731
14732 =over 4
14733
14734 =item SYNOPSIS
14735
14736 =item DESCRIPTION
14737
14738 =item WARNING 
14739
14740 =item SEE ALSO
14741
14742 =back
14743
14744 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14745 handling
14746
14747 =over 4
14748
14749 =item SYNOPSIS
14750
14751 =item DESCRIPTION
14752
14753 =item WARNING
14754
14755 =back
14756
14757 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14758
14759 =over 4
14760
14761 =item SYNOPSIS
14762
14763 =item DESCRIPTION
14764
14765 =item METHODS
14766
14767 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14768 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14769 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14770 , VALUE ), stat
14771
14772 =item SEE ALSO
14773
14774 =item AUTHOR
14775
14776 =item COPYRIGHT
14777
14778 =back
14779
14780 =head2 IPC::SysV - SysV IPC constants
14781
14782 =over 4
14783
14784 =item SYNOPSIS
14785
14786 =item DESCRIPTION
14787
14788 ftok( PATH, ID )
14789
14790 =item SEE ALSO
14791
14792 =item AUTHORS
14793
14794 =item COPYRIGHT
14795
14796 =back
14797
14798 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14799
14800 =over 4
14801
14802 =item SYNOPSIS
14803
14804 =item DESCRIPTION
14805
14806 =item METHODS
14807
14808 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14809 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14810 FLAGS ] ), stat
14811
14812 =item SEE ALSO
14813
14814 =item AUTHOR
14815
14816 =item COPYRIGHT
14817
14818 =back
14819
14820 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14821 class
14822
14823 =over 4
14824
14825 =item SYNOPSIS
14826
14827 =item DESCRIPTION
14828
14829 =item METHODS
14830
14831 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14832 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14833 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14834 , VALUE ), stat
14835
14836 =item SEE ALSO
14837
14838 =item AUTHOR
14839
14840 =item COPYRIGHT
14841
14842 =back
14843
14844 =head2 List::Util - A selection of general-utility list subroutines
14845
14846 =over 4
14847
14848 =item SYNOPSIS
14849
14850 =item DESCRIPTION
14851
14852 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14853 BLOCK LIST, shuffle LIST, sum LIST
14854
14855 =item KNOWN BUGS
14856
14857 =item SUGGESTED ADDITIONS
14858
14859 =item COPYRIGHT
14860
14861 =back
14862
14863 =head2 List::Utilib::List::Util, List::Util - A selection of
14864 general-utility list subroutines
14865
14866 =over 4
14867
14868 =item SYNOPSIS
14869
14870 =item DESCRIPTION
14871
14872 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14873 BLOCK LIST, shuffle LIST, sum LIST
14874
14875 =item KNOWN BUGS
14876
14877 =item SUGGESTED ADDITIONS
14878
14879 =item COPYRIGHT
14880
14881 =back
14882
14883 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14884 general-utility scalar subroutines
14885
14886 =over 4
14887
14888 =item SYNOPSIS
14889
14890 =item DESCRIPTION
14891
14892 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14893 EXPR, tainted EXPR, weaken REF
14894
14895 =item KNOWN BUGS
14896
14897 =item COPYRIGHT
14898
14899 =item BLATANT PLUG
14900
14901 =back
14902
14903 =head2 Locale::Constants - constants for Locale codes
14904
14905 =over 4
14906
14907 =item SYNOPSIS
14908
14909 =item DESCRIPTION
14910
14911 =item KNOWN BUGS AND LIMITATIONS
14912
14913 =item SEE ALSO
14914
14915 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14916
14917 =item AUTHOR
14918
14919 =item COPYRIGHT
14920
14921 =back
14922
14923 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14924
14925 =over 4
14926
14927 =item SYNOPSIS
14928
14929 =item DESCRIPTION
14930
14931 B<alpha-2>, B<alpha-3>, B<numeric>
14932
14933 =item CONVERSION ROUTINES
14934
14935 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14936 country_code2code( CODE, CODESET, CODESET )
14937
14938 =item QUERY ROUTINES
14939
14940 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14941
14942 =item SEMI-PRIVATE ROUTINES
14943
14944 =over 4
14945
14946 =item alias_code
14947
14948 =item rename_country
14949
14950 =back
14951
14952 =item EXAMPLES
14953
14954 =item DOMAIN NAMES
14955
14956 =item KNOWN BUGS AND LIMITATIONS
14957
14958 =item SEE ALSO
14959
14960 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14961 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14962 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14963 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14964
14965 =item AUTHOR
14966
14967 =item COPYRIGHT
14968
14969 =back
14970
14971 =head2 Locale::Currency - ISO three letter codes for currency
14972 identification (ISO 4217)
14973
14974 =over 4
14975
14976 =item SYNOPSIS
14977
14978 =item DESCRIPTION
14979
14980 XTS, XXX
14981
14982 =item CONVERSION ROUTINES
14983
14984 code2currency(), currency2code()
14985
14986 =item QUERY ROUTINES
14987
14988 C<all_currency_codes()>, C<all_currency_names()>
14989
14990 =item EXAMPLES
14991
14992 =item KNOWN BUGS AND LIMITATIONS
14993
14994 =item SEE ALSO
14995
14996 Locale::Country, Locale::Script, ISO 4217:1995,
14997 http://www.bsi-global.com/iso4217currency
14998
14999 =item AUTHOR
15000
15001 =item COPYRIGHT
15002
15003 =back
15004
15005 =head2 Locale::Language - ISO two letter codes for language identification
15006 (ISO 639)
15007
15008 =over 4
15009
15010 =item SYNOPSIS
15011
15012 =item DESCRIPTION
15013
15014 =item CONVERSION ROUTINES
15015
15016 code2language(), language2code()
15017
15018 =item QUERY ROUTINES
15019
15020 C<all_language_codes()>, C<all_language_names()>
15021
15022 =item EXAMPLES
15023
15024 =item KNOWN BUGS AND LIMITATIONS
15025
15026 =item SEE ALSO
15027
15028 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15029 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15030
15031 =item AUTHOR
15032
15033 =item COPYRIGHT
15034
15035 =back
15036
15037 =head2 Locale::Maketext -- framework for localization
15038
15039 =over 4
15040
15041 =item SYNOPSIS
15042
15043 =item DESCRIPTION
15044
15045 =item QUICK OVERVIEW
15046
15047 =item METHODS
15048
15049 =over 4
15050
15051 =item Construction Methods
15052
15053 =item The "maketext" Method
15054
15055 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15056
15057 =item Utility Methods
15058
15059 $language->quant($number, $singular), $language->quant($number, $singular,
15060 $plural), $language->quant($number, $singular, $plural, $negative),
15061 $language->numf($number), $language->sprintf($format, @items),
15062 $language->language_tag(), $language->encoding()
15063
15064 =item Language Handle Attributes and Internals
15065
15066 =back
15067
15068 =item LANGUAGE CLASS HIERARCHIES
15069
15070 =item ENTRIES IN EACH LEXICON
15071
15072 =item BRACKET NOTATION
15073
15074 =item AUTO LEXICONS
15075
15076 =item CONTROLLING LOOKUP FAILURE
15077
15078 =item HOW TO USE MAKETEXT
15079
15080 =item SEE ALSO
15081
15082 =item COPYRIGHT AND DISCLAIMER
15083
15084 =item AUTHOR
15085
15086 =back
15087
15088 =head2 Locale::Maketext::TPJ13 -- article about software localization
15089
15090 =over 4
15091
15092 =item SYNOPSIS
15093
15094 =item DESCRIPTION
15095
15096 =item Localization and Perl: gettext breaks, Maketext fixes
15097
15098 =over 4
15099
15100 =item A Localization Horror Story: It Could Happen To You
15101
15102 =item The Linguistic View
15103
15104 =item Breaking gettext
15105
15106 =item Replacing gettext
15107
15108 =item Buzzwords: Abstraction and Encapsulation
15109
15110 =item Buzzword: Isomorphism
15111
15112 =item Buzzword: Inheritance
15113
15114 =item Buzzword: Concision
15115
15116 =item The Devil in the Details
15117
15118 =item The Proof in the Pudding: Localizing Web Sites
15119
15120 =item References
15121
15122 =back
15123
15124 =back
15125
15126 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15127
15128 =over 4
15129
15130 =item SYNOPSIS
15131
15132 =item DESCRIPTION
15133
15134 B<alpha-2>, B<alpha-3>, B<numeric>
15135
15136 =over 4
15137
15138 =item SPECIAL CODES
15139
15140 =back
15141
15142 =item CONVERSION ROUTINES
15143
15144 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15145 script_code2code( CODE, CODESET, CODESET )
15146
15147 =item QUERY ROUTINES
15148
15149 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15150
15151 =item EXAMPLES
15152
15153 =item KNOWN BUGS AND LIMITATIONS
15154
15155 =item SEE ALSO
15156
15157 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15158 http://www.evertype.com/standards/iso15924/
15159
15160 =item AUTHOR
15161
15162 =item COPYRIGHT
15163
15164 =back
15165
15166 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15167
15168 =over 4
15169
15170 =item SYNOPSIS
15171
15172 =item DESCRIPTION
15173
15174 encode_base64($str, [$eol]), decode_base64($str)
15175
15176 =item DIAGNOSTICS
15177
15178 Premature end of base64 data, Premature padding of base64 data
15179
15180 =item EXAMPLES
15181
15182 =item COPYRIGHT
15183
15184 =back
15185
15186 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15187 of quoted-printable strings
15188
15189 =over 4
15190
15191 =item SYNOPSIS
15192
15193 =item DESCRIPTION
15194
15195 encode_qp($str), decode_qp($str);
15196
15197 =item COPYRIGHT
15198
15199 =back
15200
15201 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15202 strings
15203
15204 =over 4
15205
15206 =item SYNOPSIS
15207
15208 =item DESCRIPTION
15209
15210 encode_qp($str), decode_qp($str);
15211
15212 =item COPYRIGHT
15213
15214 =back
15215
15216 =head2 Math::BigFloat - Arbitrary size floating point math package
15217
15218 =over 4
15219
15220 =item SYNOPSIS
15221
15222 =item DESCRIPTION
15223
15224 =over 4
15225
15226 =item Canonical notation
15227
15228 =item Output
15229
15230 =item C<mantissa()>, C<exponent()> and C<parts()>
15231
15232 =item Accuracy vs. Precision
15233
15234 =item Rounding
15235
15236 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15237 ), fround  ( -$scale ) and fround ( 0 )
15238
15239 =back
15240
15241 =item EXAMPLES
15242
15243   # not ready yet
15244
15245 =item Autocreating constants
15246
15247 =over 4
15248
15249 =item Math library
15250
15251 =item Using Math::BigInt::Lite
15252
15253 =back
15254
15255 =item BUGS
15256
15257 =item CAVEAT
15258
15259 stringify, bstr(), bdiv, Modifying and =, bpow
15260
15261 =item LICENSE
15262
15263 =item AUTHORS
15264
15265 =back
15266
15267 =head2 Math::BigInt - Arbitrary size integer math package
15268
15269 =over 4
15270
15271 =item SYNOPSIS
15272
15273 =item DESCRIPTION
15274
15275 Canonical notation, Input, Output
15276
15277 =item METHODS
15278
15279 =over 4
15280
15281 =item config
15282
15283 =item accuracy
15284
15285 =item brsft
15286
15287 =item new
15288
15289 =item bnan
15290
15291 =item bzero
15292
15293 =item binf
15294
15295 =item bone
15296
15297 =item is_one()/is_zero()/is_nan()/is_inf()
15298
15299 =item is_positive()/is_negative()
15300
15301         $x->is_positive();              # true if >= 0
15302         $x->is_negative();              # true if <  0
15303
15304 =item is_odd()/is_even()/is_int()
15305
15306 =item bcmp
15307
15308 =item bacmp
15309
15310 =item sign
15311
15312 =item bcmp
15313
15314 =item bneg
15315
15316 =item babs
15317
15318 =item bnorm
15319
15320 =item bnot
15321
15322 =item binc
15323
15324 =item bdec
15325
15326 =item badd
15327
15328 =item bsub
15329
15330 =item bmul
15331
15332 =item bdiv
15333
15334 =item bmod
15335
15336 =item bmodinv
15337
15338 =item bmodpow
15339
15340 =item bpow
15341
15342 =item blsft
15343
15344 =item brsft
15345
15346 =item band
15347
15348 =item bior
15349
15350 =item bxor
15351
15352 =item bnot
15353
15354 =item bsqrt
15355
15356 =item bfac
15357
15358 =item round
15359
15360 =item bround
15361
15362 =item bfround
15363
15364 =item bfloor
15365
15366 =item bceil
15367
15368 =item bgcd
15369
15370 =item blcm
15371
15372 =item exponent
15373
15374 =item mantissa
15375
15376 =item parts
15377
15378 =item copy
15379
15380 =item as_number
15381
15382 =item bsstr
15383
15384 =item as_hex
15385
15386 =item as_bin
15387
15388 =back
15389
15390 =item ACCURACY and PRECISION
15391
15392 =over 4
15393
15394 =item Precision P
15395
15396 =item Accuracy A
15397
15398 =item Fallback F
15399
15400 =item Rounding mode R
15401
15402 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15403 (significant digits), Setting/Accessing, Creating numbers, Usage,
15404 Precedence, Overriding globals, Local settings, Rounding, Default values,
15405 Remarks
15406
15407 =back
15408
15409 =item INTERNALS
15410
15411 =over 4
15412
15413 =item MATH LIBRARY
15414
15415 =item SIGN
15416
15417 =item mantissa(), exponent() and parts()
15418
15419 =back
15420
15421 =item EXAMPLES
15422
15423   use Math::BigInt;
15424
15425 =item Autocreating constants
15426
15427 =item PERFORMANCE
15428
15429 =over 4
15430
15431 =item Alternative math libraries
15432
15433 =item SUBCLASSING
15434
15435 =back
15436
15437 =item Subclassing Math::BigInt
15438
15439 =item UPGRADING
15440
15441 =over 4
15442
15443 =item Auto-upgrade
15444
15445 bsqrt(), div(), blog()
15446
15447 =back
15448
15449 =item BUGS
15450
15451 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15452
15453 =item CAVEATS
15454
15455 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15456 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15457 types, bsqrt(), brsft()
15458
15459 =item LICENSE
15460
15461 =item SEE ALSO
15462
15463 =item AUTHORS
15464
15465 =back
15466
15467 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15468
15469 =over 4
15470
15471 =item SYNOPSIS
15472
15473 =item DESCRIPTION
15474
15475 =item EXPORT
15476
15477 =item WRAP YOUR OWN
15478
15479 =item LICENSE
15480
15481 This program is free software; you may redistribute it and/or modify it
15482 under
15483 the same terms as Perl itself. 
15484
15485 =item AUTHORS
15486
15487 =item SEE ALSO
15488
15489 =back
15490
15491 =head2 Math::BigRat - arbitrarily big rationals
15492
15493 =over 4
15494
15495 =item SYNOPSIS
15496
15497 =item DESCRIPTION
15498
15499 =over 4
15500
15501 =item MATH LIBRARY
15502
15503 =back
15504
15505 =item METHODS
15506
15507 =over 4
15508
15509 =item new()
15510
15511 =item numerator()
15512
15513 =item denominator()
15514
15515         $d = $x->denominator();
15516
15517 =item parts()
15518
15519 =item as_number()
15520
15521 =item bfac()
15522
15523 =item blog()
15524
15525 =item bround()/round()/bfround()
15526
15527 =back
15528
15529 =item BUGS
15530
15531 =item LICENSE
15532
15533 =item SEE ALSO
15534
15535 =item AUTHORS
15536
15537 =back
15538
15539 =head2 Math::Complex - complex numbers and associated mathematical
15540 functions
15541
15542 =over 4
15543
15544 =item SYNOPSIS
15545
15546 =item DESCRIPTION
15547
15548 =item OPERATIONS
15549
15550 =item CREATION
15551
15552 =item STRINGIFICATION
15553
15554 =over 4
15555
15556 =item CHANGED IN PERL 5.6
15557
15558 =back
15559
15560 =item USAGE
15561
15562 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15563
15564 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15565
15566 =item BUGS
15567
15568 =item AUTHORS
15569
15570 =back
15571
15572 =head2 Math::Trig - trigonometric functions
15573
15574 =over 4
15575
15576 =item SYNOPSIS
15577
15578 =item DESCRIPTION
15579
15580 =item TRIGONOMETRIC FUNCTIONS
15581
15582 B<tan>
15583
15584 =over 4
15585
15586 =item ERRORS DUE TO DIVISION BY ZERO
15587
15588 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15589
15590 =back
15591
15592 =item PLANE ANGLE CONVERSIONS
15593
15594 =item RADIAL COORDINATE CONVERSIONS
15595
15596 =over 4
15597
15598 =item COORDINATE SYSTEMS
15599
15600 =item 3-D ANGLE CONVERSIONS
15601
15602 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15603 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15604
15605 =back
15606
15607 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15608
15609 =item EXAMPLES
15610
15611 =over 4
15612
15613 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15614
15615 =back
15616
15617 =item BUGS
15618
15619 =item AUTHORS
15620
15621 =back
15622
15623 =head2 Memoize - Make functions faster by trading space for time
15624
15625 =over 4
15626
15627 =item SYNOPSIS
15628
15629 =item DESCRIPTION
15630
15631 =item DETAILS
15632
15633 =item OPTIONS
15634
15635 =over 4
15636
15637 =item INSTALL
15638
15639 =item NORMALIZER
15640
15641 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15642
15643 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15644
15645 =back
15646
15647 =item OTHER FACILITIES
15648
15649 =over 4
15650
15651 =item C<unmemoize>
15652
15653 =item C<flush_cache>
15654
15655 =back
15656
15657 =item CAVEATS
15658
15659 =item PERSISTENT CACHE SUPPORT
15660
15661 =item EXPIRATION SUPPORT
15662
15663 =item BUGS
15664
15665 =item MAILING LIST
15666
15667 =item AUTHOR
15668
15669 =item COPYRIGHT AND LICENSE
15670
15671 =item THANK YOU
15672
15673 =back
15674
15675 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15676 Storable use
15677
15678 =over 4
15679
15680 =item DESCRIPTION
15681
15682 =back
15683
15684 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15685 memoized values
15686
15687 =over 4
15688
15689 =item SYNOPSIS
15690
15691 =item DESCRIPTION
15692
15693 =item INTERFACE
15694
15695  TIEHASH,  EXISTS,  STORE
15696
15697 =item ALTERNATIVES
15698
15699 =item CAVEATS
15700
15701 =item AUTHOR
15702
15703 =item SEE ALSO
15704
15705 =back
15706
15707 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15708
15709 =over 4
15710
15711 =item DESCRIPTION
15712
15713 =back
15714
15715 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15716
15717 =over 4
15718
15719 =item DESCRIPTION
15720
15721 =back
15722
15723 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15724 Storable use
15725
15726 =over 4
15727
15728 =item DESCRIPTION
15729
15730 =back
15731
15732 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15733 Storable use
15734
15735 =over 4
15736
15737 =item DESCRIPTION
15738
15739 =back
15740
15741 =head2 Memoize::Storable - store Memoized data in Storable database
15742
15743 =over 4
15744
15745 =item DESCRIPTION
15746
15747 =back
15748
15749 =head2 NDBM_File - Tied access to ndbm files
15750
15751 =over 4
15752
15753 =item SYNOPSIS
15754
15755 =item DESCRIPTION
15756
15757 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15758
15759 =item DIAGNOSTICS
15760
15761 =over 4
15762
15763 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15764
15765 =back
15766
15767 =item BUGS AND WARNINGS
15768
15769 =back
15770
15771 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15772
15773 =over 4
15774
15775 =item SYNOPSIS
15776
15777 =item DESCRIPTION
15778
15779 =over 4
15780
15781 =item Enforcing redispatch
15782
15783 =item Avoiding repetitions
15784
15785 =back
15786
15787 =item AUTHOR
15788
15789 =item BUGS AND IRRITATIONS
15790
15791 =item COPYRIGHT
15792
15793 =back
15794
15795 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15796
15797 =over 4
15798
15799 =item SYNOPSIS
15800
15801 =item DESCRIPTION
15802
15803 =item USER METHODS
15804
15805 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15806 dataend ()
15807
15808 =item CLASS METHODS
15809
15810 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15811 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15812 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15813
15814 =item EXPORTS
15815
15816 =item AUTHOR
15817
15818 =item COPYRIGHT
15819
15820 =back
15821
15822 =head2 Net::Config - Local configuration data for libnet
15823
15824 =over 4
15825
15826 =item SYNOPSYS
15827
15828 =item DESCRIPTION
15829
15830 =item METHODS
15831
15832 requires_firewall HOST
15833
15834 =item NetConfig VALUES
15835
15836 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15837 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15838 ftp_int_pasive, local_netmask, test_hosts, test_exists
15839
15840 =back
15841
15842 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15843 and domain
15844
15845 =over 4
15846
15847 =item SYNOPSIS
15848
15849 =item DESCRIPTION
15850
15851 hostfqdn (), hostname (), hostdomain ()
15852
15853 =item AUTHOR
15854
15855 =item COPYRIGHT
15856
15857 =back
15858
15859 =head2 Net::FTP - FTP Client class
15860
15861 =over 4
15862
15863 =item SYNOPSIS
15864
15865 =item DESCRIPTION
15866
15867 =item OVERVIEW
15868
15869 =item CONSTRUCTOR
15870
15871 new (HOST [,OPTIONS])
15872
15873 =item METHODS
15874
15875 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15876 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15877 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15878 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15879 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15880 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15881 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15882 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15883 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15884 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15885 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15886 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15887 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15888
15889 =over 4
15890
15891 =item Methods for the adventurous
15892
15893 quot (CMD [,ARGS])
15894
15895 =back
15896
15897 =item THE dataconn CLASS
15898
15899 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15900 bytes_read (), abort (), close ()
15901
15902 =item UNIMPLEMENTED
15903
15904 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15905
15906 =item REPORTING BUGS
15907
15908 =item AUTHOR
15909
15910 =item SEE ALSO
15911
15912 =item USE EXAMPLES
15913
15914 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15915
15916 =item CREDITS
15917
15918 =item COPYRIGHT
15919
15920 =back
15921
15922 =head2 Net::NNTP - NNTP Client class
15923
15924 =over 4
15925
15926 =item SYNOPSIS
15927
15928 =item DESCRIPTION
15929
15930 =item CONSTRUCTOR
15931
15932 new ( [ HOST ] [, OPTIONS ])
15933
15934 =item METHODS
15935
15936 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15937 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15938 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15939 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15940 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15941 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15942 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15943
15944 =over 4
15945
15946 =item Extension methods
15947
15948 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15949 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15950 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15951 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15952 GROUP ] ), reader
15953
15954 =back
15955
15956 =item UNSUPPORTED
15957
15958 =item DEFINITIONS
15959
15960 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15961
15962 =item SEE ALSO
15963
15964 =item AUTHOR
15965
15966 =item COPYRIGHT
15967
15968 =back
15969
15970 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15971
15972 =over 4
15973
15974 =item SYNOPSIS
15975
15976 =item DESCRIPTION
15977
15978 =item EXAMPLES
15979
15980 =item CONSTRUCTOR
15981
15982 new ( [ HOST, ] [ OPTIONS ] )
15983
15984 =item METHODS
15985
15986 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15987 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15988 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15989 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15990
15991 =item NOTES
15992
15993 =item SEE ALSO
15994
15995 =item AUTHOR
15996
15997 =item COPYRIGHT
15998
15999 =back
16000
16001 =head2 Net::Ping - check a remote host for reachability
16002
16003 =over 4
16004
16005 =item SYNOPSIS
16006
16007 =item DESCRIPTION
16008
16009 =over 4
16010
16011 =item Functions
16012
16013 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( {
16014 0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host
16015 [, $timeout]);, $p->open($host);, $p->close();, pingecho($host [,
16016 $timeout]);
16017
16018 =back
16019
16020 =item WARNING
16021
16022 =item NOTES
16023
16024 =item AUTHORS
16025
16026 =item COPYRIGHT
16027
16028 =back
16029
16030 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16031
16032 =over 4
16033
16034 =item SYNOPSIS
16035
16036 =item DESCRIPTION
16037
16038 =item EXAMPLES
16039
16040 =item CONSTRUCTOR
16041
16042 new Net::SMTP [ HOST, ] [ OPTIONS ]
16043
16044 =item METHODS
16045
16046 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16047 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16048 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16049 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16050 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16051 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16052 quit ()
16053
16054 =item ADDRESSES
16055
16056 =item SEE ALSO
16057
16058 =item AUTHOR
16059
16060 =item COPYRIGHT
16061
16062 =back
16063
16064 =head2 Net::Time - time and daytime network client interface
16065
16066 =over 4
16067
16068 =item SYNOPSIS
16069
16070 =item DESCRIPTION
16071
16072 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16073 PROTOCOL [, TIMEOUT]]])
16074
16075 =item AUTHOR
16076
16077 =item COPYRIGHT
16078
16079 =back
16080
16081 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16082 functions
16083
16084 =over 4
16085
16086 =item SYNOPSIS
16087
16088 =item DESCRIPTION
16089
16090 =item EXAMPLES
16091
16092 =item NOTE
16093
16094 =item AUTHOR
16095
16096 =back
16097
16098 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16099
16100 =over 4
16101
16102 =item DESCRIPTION
16103
16104 =over 4
16105
16106 =item Where to get this document
16107
16108 =item How to contribute to this document
16109
16110 =back
16111
16112 =item Author and Copyright Information
16113
16114 =over 4
16115
16116 =item Disclaimer
16117
16118 =back
16119
16120 =item Obtaining and installing libnet
16121
16122 =over 4
16123
16124 =item What is libnet ?
16125
16126 =item Which version of perl do I need ?
16127
16128 =item What other modules do I need ?
16129
16130 =item What machines support libnet ?
16131
16132 =item Where can I get the latest libnet release
16133
16134 =back
16135
16136 =item Using Net::FTP
16137
16138 =over 4
16139
16140 =item How do I download files from an FTP server ?
16141
16142 =item How do I transfer files in binary mode ?
16143
16144 =item How can I get the size of a file on a remote FTP server ?
16145
16146 =item How can I get the modification time of a file on a remote FTP server
16147 ?
16148
16149 =item How can I change the permissions of a file on a remote server ?
16150
16151 =item Can I do a reget operation like the ftp command ?
16152
16153 =item How do I get a directory listing from an FTP server ?
16154
16155 =item Changing directory to "" does not fail ?
16156
16157 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16158
16159 =item I am behind an FTP proxy firewall, but cannot access machines outside
16160 ?
16161
16162 =item My ftp proxy firewall does not listen on port 21
16163
16164 =item Is it possible to change the file permissions of a file on an FTP
16165 server ?
16166
16167 =item I have seen scripts call a method message, but cannot find it
16168 documented ?
16169
16170 =item Why does Net::FTP not implement mput and mget methods
16171
16172 =back
16173
16174 =item Using Net::SMTP
16175
16176 =over 4
16177
16178 =item Why can't the part of an Email address after the @ be used as the
16179 hostname ?
16180
16181 =item Why does Net::SMTP not do DNS MX lookups ?
16182
16183 =item The verify method always returns true ?
16184
16185 =back
16186
16187 =item Debugging scripts
16188
16189 =over 4
16190
16191 =item How can I debug my scripts that use Net::* modules ?
16192
16193 =back
16194
16195 =item AUTHOR AND COPYRIGHT
16196
16197 =back
16198
16199 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16200 functions
16201
16202 =over 4
16203
16204 =item SYNOPSIS
16205
16206 =item DESCRIPTION
16207
16208 =item EXAMPLES
16209
16210 =item NOTE
16211
16212 =item AUTHOR
16213
16214 =back
16215
16216 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16217 functions
16218
16219 =over 4
16220
16221 =item SYNOPSIS
16222
16223 =item DESCRIPTION
16224
16225 =item NOTE
16226
16227 =item AUTHOR
16228
16229 =back
16230
16231 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16232 functions
16233
16234 =over 4
16235
16236 =item SYNOPSIS
16237
16238 =item DESCRIPTION
16239
16240 =item EXAMPLES
16241
16242 =item NOTE
16243
16244 =item AUTHOR
16245
16246 =back
16247
16248 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16249
16250 =over 4
16251
16252 =item SYNOPSIS
16253
16254 =item DESCRIPTION
16255
16256 =item THE .netrc FILE
16257
16258 machine name, default, login name, password string, account string, macdef
16259 name
16260
16261 =item CONSTRUCTOR
16262
16263 lookup ( MACHINE [, LOGIN ])
16264
16265 =item METHODS
16266
16267 login (), password (), account (), lpa ()
16268
16269 =item AUTHOR
16270
16271 =item SEE ALSO
16272
16273 =item COPYRIGHT
16274
16275 =back
16276
16277 =head2 O - Generic interface to Perl Compiler backends
16278
16279 =over 4
16280
16281 =item SYNOPSIS
16282
16283 =item DESCRIPTION
16284
16285 =item CONVENTIONS
16286
16287 =item IMPLEMENTATION
16288
16289 =item BUGS
16290
16291 =item AUTHOR
16292
16293 =back
16294
16295 =head2 ODBM_File - Tied access to odbm files
16296
16297 =over 4
16298
16299 =item SYNOPSIS
16300
16301 =item DESCRIPTION
16302
16303 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16304
16305 =item DIAGNOSTICS
16306
16307 =over 4
16308
16309 =item C<odbm store returned -1, errno 22, key "..." at ...>
16310
16311 =back
16312
16313 =item BUGS AND WARNINGS
16314
16315 =back
16316
16317 =head2 Opcode - Disable named opcodes when compiling perl code
16318
16319 =over 4
16320
16321 =item SYNOPSIS
16322
16323 =item DESCRIPTION
16324
16325 =item NOTE
16326
16327 =item WARNING
16328
16329 =item Operator Names and Operator Lists
16330
16331 an operator name (opname), an operator tag name (optag), a negated opname
16332 or optag, an operator set (opset)
16333
16334 =item Opcode Functions
16335
16336 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16337 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16338 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16339 opdump (PAT)
16340
16341 =item Manipulating Opsets
16342
16343 =item TO DO (maybe)
16344
16345 =back
16346
16347 =over 4
16348
16349 =item Predefined Opcode Tags
16350
16351 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16352 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16353 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16354 :dangerous
16355
16356 =item SEE ALSO
16357
16358 =item AUTHORS
16359
16360 =back
16361
16362 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16363 compartments
16364
16365 =over 4
16366
16367 =item SYNOPSIS
16368
16369 =item DESCRIPTION
16370
16371 a new namespace, an operator mask
16372
16373 =item WARNING
16374
16375 =over 4
16376
16377 =item RECENT CHANGES
16378
16379 =item Methods in class Safe
16380
16381 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16382 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16383 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16384 root (NAMESPACE), mask (MASK)
16385
16386 =item Some Safety Issues
16387
16388 Memory, CPU, Snooping, Signals, State Changes
16389
16390 =item AUTHOR
16391
16392 =back
16393
16394 =back
16395
16396 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16397 compiling
16398
16399 =over 4
16400
16401 =item SYNOPSIS  
16402
16403 =item DESCRIPTION
16404
16405 =item SEE ALSO
16406
16407 =back
16408
16409 =head2 POSIX - Perl interface to IEEE Std 1003.1
16410
16411 =over 4
16412
16413 =item SYNOPSIS
16414
16415 =item DESCRIPTION
16416
16417 =item NOTE
16418
16419 =item CAVEATS 
16420
16421 =item FUNCTIONS
16422
16423 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16424 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16425 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16426 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16427 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16428 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16429 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16430 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16431 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16432 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16433 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16434 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16435 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16436 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16437 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16438 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16439 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16440 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16441 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16442 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16443 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16444 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16445 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16446 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16447 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16448 wctomb, write
16449
16450 =item CLASSES
16451
16452 =over 4
16453
16454 =item POSIX::SigAction
16455
16456 new
16457
16458 =item POSIX::SigSet
16459
16460 new, addset, delset, emptyset, fillset, ismember
16461
16462 =item POSIX::Termios
16463
16464 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16465 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16466 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16467 field values, c_cflag field values, c_iflag field values, c_lflag field
16468 values, c_oflag field values
16469
16470 =back
16471
16472 =item PATHNAME CONSTANTS
16473
16474 Constants
16475
16476 =item POSIX CONSTANTS
16477
16478 Constants
16479
16480 =item SYSTEM CONFIGURATION
16481
16482 Constants
16483
16484 =item ERRNO
16485
16486 Constants
16487
16488 =item FCNTL
16489
16490 Constants
16491
16492 =item FLOAT
16493
16494 Constants
16495
16496 =item LIMITS
16497
16498 Constants
16499
16500 =item LOCALE
16501
16502 Constants
16503
16504 =item MATH
16505
16506 Constants
16507
16508 =item SIGNAL
16509
16510 Constants
16511
16512 =item STAT
16513
16514 Constants, Macros
16515
16516 =item STDLIB
16517
16518 Constants
16519
16520 =item STDIO
16521
16522 Constants
16523
16524 =item TIME
16525
16526 Constants
16527
16528 =item UNISTD
16529
16530 Constants
16531
16532 =item WAIT
16533
16534 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16535 WTERMSIG, WIFSTOPPED, WSTOPSIG
16536
16537 =back
16538
16539 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16540 name space
16541
16542 =over 4
16543
16544 =item SYNOPSIS
16545
16546 =item DESCRIPTION
16547
16548 unix, stdio, perlio, crlf, utf8, bytes, raw
16549
16550 =over 4
16551
16552 =item Defaults and how to override them
16553
16554 =back
16555
16556 =item AUTHOR
16557
16558 =item SEE ALSO
16559
16560 =back
16561
16562 =head2 PerlIO::Scalar - support module for in-memory IO.
16563
16564 =over 4
16565
16566 =item SYNOPSIS
16567
16568 =item DESCRIPTION
16569
16570 =back
16571
16572 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
16573
16574 =over 4
16575
16576 =item SYNOPSIS
16577
16578 =item DESCRIPTION
16579
16580 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16581 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
16582 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
16583 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16584 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16585 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16586 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16587
16588 =over 4
16589
16590 =item Example - a Hexadecimal Handle
16591
16592 =back
16593
16594 =back
16595
16596 =head2 PerlIO::encoding - encoding layer
16597
16598 =over 4
16599
16600 =item SYNOPSIS
16601
16602 =item DESCRIPTION
16603
16604 =item SEE ALSO
16605
16606 =back
16607
16608 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16609
16610 =over 4
16611
16612 =item SYNOPSIS
16613
16614 =item OPTIONS/ARGUMENTS
16615
16616 =over 4
16617
16618 =item podchecker()
16619
16620 B<-warnings> =E<gt> I<val>
16621
16622 =back
16623
16624 =item DESCRIPTION
16625
16626 =item DIAGNOSTICS
16627
16628 =over 4
16629
16630 =item Errors
16631
16632 empty =headn, =over on line I<N> without closing =back, =item without
16633 previous =over, =back without previous =over, No argument for =begin, =end
16634 without =begin, Nested =begin's, =for without formatter specification,
16635 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16636 interior-sequence "I<SEQ>", nested commands
16637 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16638 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16639 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16640 after =back
16641
16642 =item Warnings
16643
16644 multiple occurrence of link target I<name>, line containing nothing but
16645 whitespace in paragraph, file does not start with =head, previous =item has
16646 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16647 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16648 items in =over, No argument for =item, empty section in previous paragraph,
16649 Verbatim paragraph in NAME section
16650
16651 =item Hyperlinks
16652
16653 ignoring leading/trailing whitespace in link, (section) in '$page'
16654 deprecated, alternative text/node '%s' contains non-escaped | or /
16655
16656 =back
16657
16658 =item RETURN VALUE
16659
16660 =item EXAMPLES
16661
16662 =item INTERFACE
16663
16664 =back
16665
16666 C<Pod::Checker-E<gt>new( %options )>
16667
16668 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16669 @args )>
16670
16671 C<$checker-E<gt>num_errors()>
16672
16673 C<$checker-E<gt>name()>
16674
16675 C<$checker-E<gt>node()>
16676
16677 C<$checker-E<gt>idx()>
16678
16679 C<$checker-E<gt>hyperlink()>
16680
16681 =over 4
16682
16683 =item AUTHOR
16684
16685 =back
16686
16687 =head2 Pod::Find - find POD documents in directory trees
16688
16689 =over 4
16690
16691 =item SYNOPSIS
16692
16693 =item DESCRIPTION
16694
16695 =back
16696
16697 =over 4
16698
16699 =item C<pod_find( { %opts } , @directories )>
16700
16701 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16702 1>
16703
16704 =back
16705
16706 =over 4
16707
16708 =item C<simplify_name( $str )>
16709
16710 =back
16711
16712 =over 4
16713
16714 =item C<pod_where( { %opts }, $pod )>
16715
16716 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16717 1>
16718
16719 =back
16720
16721 =over 4
16722
16723 =item C<contains_pod( $file , $verbose )>
16724
16725 =back
16726
16727 =over 4
16728
16729 =item AUTHOR
16730
16731 =item SEE ALSO
16732
16733 =back
16734
16735 =head2 Pod::Html - module to convert pod files to HTML
16736
16737 =over 4
16738
16739 =item SYNOPSIS
16740
16741 =item DESCRIPTION
16742
16743 =item ARGUMENTS
16744
16745 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16746 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16747 title, verbose
16748
16749 =item EXAMPLE
16750
16751 =item ENVIRONMENT
16752
16753 =item AUTHOR
16754
16755 =item SEE ALSO
16756
16757 =item COPYRIGHT
16758
16759 =back
16760
16761 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16762 commands, etc.
16763
16764 =over 4
16765
16766 =item SYNOPSIS
16767
16768 =item REQUIRES
16769
16770 =item EXPORTS
16771
16772 =item DESCRIPTION
16773
16774 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16775 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16776
16777 =back
16778
16779 =over 4
16780
16781 =item B<Pod::InputSource>
16782
16783 =back
16784
16785 =over 4
16786
16787 =item B<new()>
16788
16789 =back
16790
16791 =over 4
16792
16793 =item B<name()>
16794
16795 =back
16796
16797 =over 4
16798
16799 =item B<handle()>
16800
16801 =back
16802
16803 =over 4
16804
16805 =item B<was_cutting()>
16806
16807 =back
16808
16809 =over 4
16810
16811 =item B<Pod::Paragraph>
16812
16813 =back
16814
16815 =over 4
16816
16817 =item Pod::Paragraph-E<gt>B<new()>
16818
16819 =back
16820
16821 =over 4
16822
16823 =item $pod_para-E<gt>B<cmd_name()>
16824
16825 =back
16826
16827 =over 4
16828
16829 =item $pod_para-E<gt>B<text()>
16830
16831 =back
16832
16833 =over 4
16834
16835 =item $pod_para-E<gt>B<raw_text()>
16836
16837 =back
16838
16839 =over 4
16840
16841 =item $pod_para-E<gt>B<cmd_prefix()>
16842
16843 =back
16844
16845 =over 4
16846
16847 =item $pod_para-E<gt>B<cmd_separator()>
16848
16849 =back
16850
16851 =over 4
16852
16853 =item $pod_para-E<gt>B<parse_tree()>
16854
16855 =back
16856
16857 =over 4
16858
16859 =item $pod_para-E<gt>B<file_line()>
16860
16861 =back
16862
16863 =over 4
16864
16865 =item B<Pod::InteriorSequence>
16866
16867 =back
16868
16869 =over 4
16870
16871 =item Pod::InteriorSequence-E<gt>B<new()>
16872
16873 =back
16874
16875 =over 4
16876
16877 =item $pod_seq-E<gt>B<cmd_name()>
16878
16879 =back
16880
16881 =over 4
16882
16883 =item $pod_seq-E<gt>B<prepend()>
16884
16885 =back
16886
16887 =over 4
16888
16889 =item $pod_seq-E<gt>B<append()>
16890
16891 =back
16892
16893 =over 4
16894
16895 =item $pod_seq-E<gt>B<nested()>
16896
16897 =back
16898
16899 =over 4
16900
16901 =item $pod_seq-E<gt>B<raw_text()>
16902
16903 =back
16904
16905 =over 4
16906
16907 =item $pod_seq-E<gt>B<left_delimiter()>
16908
16909 =back
16910
16911 =over 4
16912
16913 =item $pod_seq-E<gt>B<right_delimiter()>
16914
16915 =back
16916
16917 =over 4
16918
16919 =item $pod_seq-E<gt>B<parse_tree()>
16920
16921 =back
16922
16923 =over 4
16924
16925 =item $pod_seq-E<gt>B<file_line()>
16926
16927 =back
16928
16929 =over 4
16930
16931 =item Pod::InteriorSequence::B<DESTROY()>
16932
16933 =back
16934
16935 =over 4
16936
16937 =item B<Pod::ParseTree>
16938
16939 =back
16940
16941 =over 4
16942
16943 =item Pod::ParseTree-E<gt>B<new()>
16944
16945 =back
16946
16947 =over 4
16948
16949 =item $ptree-E<gt>B<top()>
16950
16951 =back
16952
16953 =over 4
16954
16955 =item $ptree-E<gt>B<children()>
16956
16957 =back
16958
16959 =over 4
16960
16961 =item $ptree-E<gt>B<prepend()>
16962
16963 =back
16964
16965 =over 4
16966
16967 =item $ptree-E<gt>B<append()>
16968
16969 =back
16970
16971 =over 4
16972
16973 =item $ptree-E<gt>B<raw_text()>
16974
16975 =back
16976
16977 =over 4
16978
16979 =item Pod::ParseTree::B<DESTROY()>
16980
16981 =back
16982
16983 =over 4
16984
16985 =item SEE ALSO
16986
16987 =item AUTHOR
16988
16989 =back
16990
16991 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
16992
16993 =over 4
16994
16995 =item SYNOPSIS
16996
16997 =item DESCRIPTION
16998
16999 =back
17000
17001 =over 4
17002
17003 =item OBJECT METHODS
17004
17005 C<initialize>
17006
17007 =back
17008
17009 =over 4
17010
17011 =item Data Accessors
17012
17013 B<AddPreamble>
17014
17015 =back
17016
17017 B<AddPostamble>
17018
17019 B<Head1Level>
17020
17021 B<Label>
17022
17023 B<LevelNoNum>
17024
17025 B<MakeIndex>
17026
17027 B<ReplaceNAMEwithSection>
17028
17029 B<StartWithNewPage>
17030
17031 B<TableOfContents>
17032
17033 B<UniqueLabels>
17034
17035 B<UserPreamble>
17036
17037 B<UserPostamble>
17038
17039 B<Lists>
17040
17041 =over 4
17042
17043 =item Subclassed methods
17044
17045 =back
17046
17047 B<begin_pod>
17048
17049 B<end_pod>
17050
17051 B<command>
17052
17053 B<verbatim>
17054
17055 B<textblock>
17056
17057 B<interior_sequence>
17058
17059 =over 4
17060
17061 =item List Methods
17062
17063 B<begin_list>
17064
17065 =back
17066
17067 B<end_list>
17068
17069 B<add_item>
17070
17071 =over 4
17072
17073 =item Methods for headings
17074
17075 B<head>
17076
17077 =back
17078
17079 =over 4
17080
17081 =item Internal methods
17082
17083 B<_output>
17084
17085 =back
17086
17087 B<_replace_special_chars>
17088
17089 B<_replace_special_chars_late>
17090
17091 B<_create_label>
17092
17093 B<_create_index>
17094
17095 B<_clean_latex_commands>
17096
17097 B<_split_delimited>
17098
17099 =over 4
17100
17101 =item NOTES
17102
17103 =item SEE ALSO
17104
17105 =item AUTHORS
17106
17107 =item COPYRIGHT
17108
17109 =item REVISION
17110
17111 =back
17112
17113 =head2 Pod::Man - Convert POD data to formatted *roff input
17114
17115 =over 4
17116
17117 =item SYNOPSIS
17118
17119 =item DESCRIPTION
17120
17121 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17122 release, section
17123
17124 =item DIAGNOSTICS
17125
17126 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17127 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17128 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17129 =back
17130
17131 =item BUGS
17132
17133 =item CAVEATS
17134
17135 =item SEE ALSO
17136
17137 =item AUTHOR
17138
17139 =item COPYRIGHT AND LICENSE
17140
17141 =back
17142
17143 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17144
17145 =over 4
17146
17147 =item SYNOPSIS
17148
17149 =item DESCRIPTION
17150
17151 =item AUTHOR
17152
17153 =item COPYRIGHT AND LICENSE
17154
17155 =back
17156
17157 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17158
17159 =over 4
17160
17161 =item SYNOPSIS
17162
17163 =item DESCRIPTION
17164
17165 =back
17166
17167 =over 4
17168
17169 =item Pod::List
17170
17171 Pod::List-E<gt>new()
17172
17173 =back
17174
17175 $list-E<gt>file()
17176
17177 $list-E<gt>start()
17178
17179 $list-E<gt>indent()
17180
17181 $list-E<gt>type()
17182
17183 $list-E<gt>rx()
17184
17185 $list-E<gt>item()
17186
17187 $list-E<gt>parent()
17188
17189 $list-E<gt>tag()
17190
17191 =over 4
17192
17193 =item Pod::Hyperlink
17194
17195 Pod::Hyperlink-E<gt>new()
17196
17197 =back
17198
17199 $link-E<gt>parse($string)
17200
17201 $link-E<gt>markup($string)
17202
17203 $link-E<gt>text()
17204
17205 $link-E<gt>warning()
17206
17207 $link-E<gt>file(), $link-E<gt>line()
17208
17209 $link-E<gt>page()
17210
17211 $link-E<gt>node()
17212
17213 $link-E<gt>alttext()
17214
17215 $link-E<gt>type()
17216
17217 $link-E<gt>link()
17218
17219 =over 4
17220
17221 =item Pod::Cache
17222
17223 Pod::Cache-E<gt>new()
17224
17225 =back
17226
17227 $cache-E<gt>item()
17228
17229 $cache-E<gt>find_page($name)
17230
17231 =over 4
17232
17233 =item Pod::Cache::Item
17234
17235 Pod::Cache::Item-E<gt>new()
17236
17237 =back
17238
17239 $cacheitem-E<gt>page()
17240
17241 $cacheitem-E<gt>description()
17242
17243 $cacheitem-E<gt>path()
17244
17245 $cacheitem-E<gt>file()
17246
17247 $cacheitem-E<gt>nodes()
17248
17249 $cacheitem-E<gt>find_node($name)
17250
17251 $cacheitem-E<gt>idx()
17252
17253 =over 4
17254
17255 =item AUTHOR
17256
17257 =item SEE ALSO
17258
17259 =back
17260
17261 =head2 Pod::Parser - base class for creating POD filters and translators
17262
17263 =over 4
17264
17265 =item SYNOPSIS
17266
17267 =item REQUIRES
17268
17269 =item EXPORTS
17270
17271 =item DESCRIPTION
17272
17273 =item QUICK OVERVIEW
17274
17275 =item PARSING OPTIONS
17276
17277 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17278 B<-warnings> (default: unset)
17279
17280 =back
17281
17282 =over 4
17283
17284 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17285
17286 =back
17287
17288 =over 4
17289
17290 =item B<command()>
17291
17292 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17293
17294 =back
17295
17296 =over 4
17297
17298 =item B<verbatim()>
17299
17300 C<$text>, C<$line_num>, C<$pod_para>
17301
17302 =back
17303
17304 =over 4
17305
17306 =item B<textblock()>
17307
17308 C<$text>, C<$line_num>, C<$pod_para>
17309
17310 =back
17311
17312 =over 4
17313
17314 =item B<interior_sequence()>
17315
17316 =back
17317
17318 =over 4
17319
17320 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17321
17322 =back
17323
17324 =over 4
17325
17326 =item B<new()>
17327
17328 =back
17329
17330 =over 4
17331
17332 =item B<initialize()>
17333
17334 =back
17335
17336 =over 4
17337
17338 =item B<begin_pod()>
17339
17340 =back
17341
17342 =over 4
17343
17344 =item B<begin_input()>
17345
17346 =back
17347
17348 =over 4
17349
17350 =item B<end_input()>
17351
17352 =back
17353
17354 =over 4
17355
17356 =item B<end_pod()>
17357
17358 =back
17359
17360 =over 4
17361
17362 =item B<preprocess_line()>
17363
17364 =back
17365
17366 =over 4
17367
17368 =item B<preprocess_paragraph()>
17369
17370 =back
17371
17372 =over 4
17373
17374 =item METHODS FOR PARSING AND PROCESSING
17375
17376 =back
17377
17378 =over 4
17379
17380 =item B<parse_text()>
17381
17382 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17383 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17384 I<code-ref>|I<method-name>
17385
17386 =back
17387
17388 =over 4
17389
17390 =item B<interpolate()>
17391
17392 =back
17393
17394 =over 4
17395
17396 =item B<parse_paragraph()>
17397
17398 =back
17399
17400 =over 4
17401
17402 =item B<parse_from_filehandle()>
17403
17404 =back
17405
17406 =over 4
17407
17408 =item B<parse_from_file()>
17409
17410 =back
17411
17412 =over 4
17413
17414 =item ACCESSOR METHODS
17415
17416 =back
17417
17418 =over 4
17419
17420 =item B<errorsub()>
17421
17422 =back
17423
17424 =over 4
17425
17426 =item B<cutting()>
17427
17428 =back
17429
17430 =over 4
17431
17432 =item B<parseopts()>
17433
17434 =back
17435
17436 =over 4
17437
17438 =item B<output_file()>
17439
17440 =back
17441
17442 =over 4
17443
17444 =item B<output_handle()>
17445
17446 =back
17447
17448 =over 4
17449
17450 =item B<input_file()>
17451
17452 =back
17453
17454 =over 4
17455
17456 =item B<input_handle()>
17457
17458 =back
17459
17460 =over 4
17461
17462 =item B<input_streams()>
17463
17464 =back
17465
17466 =over 4
17467
17468 =item B<top_stream()>
17469
17470 =back
17471
17472 =over 4
17473
17474 =item PRIVATE METHODS AND DATA
17475
17476 =back
17477
17478 =over 4
17479
17480 =item B<_push_input_stream()>
17481
17482 =back
17483
17484 =over 4
17485
17486 =item B<_pop_input_stream()>
17487
17488 =back
17489
17490 =over 4
17491
17492 =item TREE-BASED PARSING
17493
17494 =item SEE ALSO
17495
17496 =item AUTHOR
17497
17498 =back
17499
17500 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17501
17502 =over 4
17503
17504 =item SYNOPSIS
17505
17506 =item DESCRIPTION
17507
17508 =over 4
17509
17510 =item EXPORT
17511
17512 =back
17513
17514 =item AUTHOR
17515
17516 =item SEE ALSO
17517
17518 =back
17519
17520 =head2 Pod::Select, podselect() - extract selected sections of POD from
17521 input
17522
17523 =over 4
17524
17525 =item SYNOPSIS
17526
17527 =item REQUIRES
17528
17529 =item EXPORTS
17530
17531 =item DESCRIPTION
17532
17533 =item SECTION SPECIFICATIONS
17534
17535 =item RANGE SPECIFICATIONS
17536
17537 =back
17538
17539 =over 4
17540
17541 =item OBJECT METHODS
17542
17543 =back
17544
17545 =over 4
17546
17547 =item B<curr_headings()>
17548
17549 =back
17550
17551 =over 4
17552
17553 =item B<select()>
17554
17555 =back
17556
17557 =over 4
17558
17559 =item B<add_selection()>
17560
17561 =back
17562
17563 =over 4
17564
17565 =item B<clear_selections()>
17566
17567 =back
17568
17569 =over 4
17570
17571 =item B<match_section()>
17572
17573 =back
17574
17575 =over 4
17576
17577 =item B<is_selected()>
17578
17579 =back
17580
17581 =over 4
17582
17583 =item EXPORTED FUNCTIONS
17584
17585 =back
17586
17587 =over 4
17588
17589 =item B<podselect()>
17590
17591 B<-output>, B<-sections>, B<-ranges>
17592
17593 =back
17594
17595 =over 4
17596
17597 =item PRIVATE METHODS AND DATA
17598
17599 =back
17600
17601 =over 4
17602
17603 =item B<_compile_section_spec()>
17604
17605 =back
17606
17607 =over 4
17608
17609 =item $self->{_SECTION_HEADINGS}
17610
17611 =back
17612
17613 =over 4
17614
17615 =item $self->{_SELECTED_SECTIONS}
17616
17617 =back
17618
17619 =over 4
17620
17621 =item SEE ALSO
17622
17623 =item AUTHOR
17624
17625 =back
17626
17627 =head2 Pod::Text - Convert POD data to formatted ASCII text
17628
17629 =over 4
17630
17631 =item SYNOPSIS
17632
17633 =item DESCRIPTION
17634
17635 alt, code, indent, loose, quotes, sentence, width
17636
17637 =item DIAGNOSTICS
17638
17639 Bizarre space in item, Item called without tag, Can't open %s for reading:
17640 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17641 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17642 Unmatched =back
17643
17644 =item RESTRICTIONS
17645
17646 =item NOTES
17647
17648 =item SEE ALSO
17649
17650 =item AUTHOR
17651
17652 =item COPYRIGHT AND LICENSE
17653
17654 =back
17655
17656 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17657
17658 =over 4
17659
17660 =item SYNOPSIS
17661
17662 =item DESCRIPTION
17663
17664 =item BUGS
17665
17666 =item SEE ALSO
17667
17668 =item AUTHOR
17669
17670 =item COPYRIGHT AND LICENSE
17671
17672 =back
17673
17674 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17675 text
17676
17677 =over 4
17678
17679 =item SYNOPSIS
17680
17681 =item DESCRIPTION
17682
17683 =item BUGS
17684
17685 =item SEE ALSO
17686
17687 =item AUTHOR
17688
17689 =item COPYRIGHT AND LICENSE
17690
17691 =back
17692
17693 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17694 text with format escapes
17695
17696 =over 4
17697
17698 =item SYNOPSIS
17699
17700 =item DESCRIPTION
17701
17702 =item NOTES
17703
17704 =item SEE ALSO
17705
17706 =item AUTHOR
17707
17708 =item COPYRIGHT AND LICENSE
17709
17710 =back
17711
17712 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17713 documentation
17714
17715 =over 4
17716
17717 =item SYNOPSIS
17718
17719 =item ARGUMENTS
17720
17721 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17722 C<-pathlist>
17723
17724 =item DESCRIPTION
17725
17726 =item EXAMPLES
17727
17728 =over 4
17729
17730 =item Recommended Use
17731
17732 =back
17733
17734 =item CAVEATS
17735
17736 =item AUTHOR
17737
17738 =item ACKNOWLEDGEMENTS
17739
17740 =back
17741
17742 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17743 translators.
17744
17745 =over 4
17746
17747 =item HEADINGS
17748
17749 =item This C<is> a "level 1" heading
17750
17751 =over 4
17752
17753 =item ``Level'' "2 I<heading>
17754
17755 =back
17756
17757 =item This C<is> a "level 1" heading
17758
17759 =over 4
17760
17761 =item ``Level'' 2 I<heading>
17762
17763 =back
17764
17765 =item LINKS
17766
17767 =item OVER AND ITEMS
17768
17769 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17770 text
17771
17772 =item FORMATTING CODES
17773
17774 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17775
17776 =item VERBATIM
17777
17778 =item CONCLUSION
17779
17780 =back
17781
17782 =head2 Pod::t::htmlescp, Escape Sequences Test
17783
17784 =over 4
17785
17786 =item DESCRIPTION
17787
17788 =back
17789
17790 =head2 Pod::t::htmlview, Test HTML Rendering
17791
17792 =over 4
17793
17794 =item SYNOPSIS
17795
17796 =item DESCRIPTION
17797
17798 =item METHODS =E<gt> OTHER STUFF
17799
17800 =over 4
17801
17802 =item new()
17803
17804 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17805 Sat, 3 Mat
17806
17807 =item old()
17808
17809 =back
17810
17811 =item TESTING FOR AND BEGIN
17812
17813 =item TESTING URLs hyperlinking
17814
17815 =item SEE ALSO
17816
17817 =back
17818
17819 =head2 SDBM_File - Tied access to sdbm files
17820
17821 =over 4
17822
17823 =item SYNOPSIS
17824
17825 =item DESCRIPTION
17826
17827 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17828
17829 =item DIAGNOSTICS
17830
17831 =over 4
17832
17833 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17834
17835 =back
17836
17837 =item BUGS AND WARNINGS
17838
17839 =back
17840
17841 =head2 Safe - Compile and execute code in restricted compartments
17842
17843 =over 4
17844
17845 =item SYNOPSIS
17846
17847 =item DESCRIPTION
17848
17849 a new namespace, an operator mask
17850
17851 =item WARNING
17852
17853 =over 4
17854
17855 =item RECENT CHANGES
17856
17857 =item Methods in class Safe
17858
17859 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17860 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17861 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17862 root (NAMESPACE), mask (MASK)
17863
17864 =item Some Safety Issues
17865
17866 Memory, CPU, Snooping, Signals, State Changes
17867
17868 =item AUTHOR
17869
17870 =back
17871
17872 =back
17873
17874 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17875
17876 =over 4
17877
17878 =item SYNOPSIS
17879
17880 =item DESCRIPTION
17881
17882 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17883 EXPR, tainted EXPR, weaken REF
17884
17885 =item KNOWN BUGS
17886
17887 =item COPYRIGHT
17888
17889 =item BLATANT PLUG
17890
17891 =back
17892
17893 =head2 Search::Dict, look - search for key in dictionary file
17894
17895 =over 4
17896
17897 =item SYNOPSIS
17898
17899 =item DESCRIPTION
17900
17901 =back
17902
17903 =head2 SelectSaver - save and restore selected file handle
17904
17905 =over 4
17906
17907 =item SYNOPSIS
17908
17909 =item DESCRIPTION
17910
17911 =back
17912
17913 =head2 SelfLoader - load functions only on demand
17914
17915 =over 4
17916
17917 =item SYNOPSIS
17918
17919 =item DESCRIPTION
17920
17921 =over 4
17922
17923 =item The __DATA__ token
17924
17925 =item SelfLoader autoloading
17926
17927 =item Autoloading and package lexicals
17928
17929 =item SelfLoader and AutoLoader
17930
17931 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17932
17933 =item Classes and inherited methods.
17934
17935 =back
17936
17937 =item Multiple packages and fully qualified subroutine names
17938
17939 =back
17940
17941 =head2 Shell - run shell commands transparently within perl
17942
17943 =over 4
17944
17945 =item SYNOPSIS
17946
17947 =item DESCRIPTION
17948
17949 =over 4
17950
17951 =item OBJECT ORIENTED SYNTAX
17952
17953 =back
17954
17955 =item AUTHOR
17956
17957 =back
17958
17959 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17960 socket.h defines and structure manipulators 
17961
17962 =over 4
17963
17964 =item SYNOPSIS
17965
17966 =item DESCRIPTION
17967
17968 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17969 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17970 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17971 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17972 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17973
17974 =back
17975
17976 =head2 Storable - persistence for Perl data structures
17977
17978 =over 4
17979
17980 =item SYNOPSIS
17981
17982 =item DESCRIPTION
17983
17984 =item MEMORY STORE
17985
17986 =item ADVISORY LOCKING
17987
17988 =item SPEED
17989
17990 =item CANONICAL REPRESENTATION
17991
17992 =item FORWARD COMPATIBILITY
17993
17994 utf8 data, restricted hashes, files from future versions of Storable
17995
17996 =item ERROR REPORTING
17997
17998 =item WIZARDS ONLY
17999
18000 =over 4
18001
18002 =item Hooks
18003
18004 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18005 I<serialized>, ..
18006
18007 =item Predicates
18008
18009 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18010 C<Storable::is_retrieving>
18011
18012 =item Recursion
18013
18014 =item Deep Cloning
18015
18016 =back
18017
18018 =item Storable magic
18019
18020 =item EXAMPLES
18021
18022 =item WARNING
18023
18024 =item BUGS
18025
18026 =over 4
18027
18028 =item 64 bit data in perl 5.6.0 and 5.6.1
18029
18030 =back
18031
18032 =item CREDITS
18033
18034 =item AUTHOR
18035
18036 =item SEE ALSO
18037
18038 =back
18039
18040 =head2 Switch - A switch statement for Perl
18041
18042 =over 4
18043
18044 =item VERSION
18045
18046 =item SYNOPSIS
18047
18048 =item BACKGROUND
18049
18050 =item DESCRIPTION
18051
18052 =over 4
18053
18054 =item Allowing fall-through
18055
18056 =item Automating fall-through
18057
18058 =item Alternative syntax
18059
18060 =item Higher-order Operations
18061
18062 =back
18063
18064 =item DEPENDENCIES
18065
18066 =item AUTHOR
18067
18068 =item BUGS
18069
18070 =item LIMITATION
18071
18072 =item COPYRIGHT
18073
18074 =back
18075
18076 =head2 Symbol - manipulate Perl symbols and their names
18077
18078 =over 4
18079
18080 =item SYNOPSIS
18081
18082 =item DESCRIPTION
18083
18084 =back
18085
18086 =head2 Sys::Hostname - Try every conceivable way to get hostname
18087
18088 =over 4
18089
18090 =item SYNOPSIS
18091
18092 =item DESCRIPTION
18093
18094 =item AUTHOR
18095
18096 =back
18097
18098 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18099 interface to the UNIX syslog(3) calls
18100
18101 =over 4
18102
18103 =item SYNOPSIS
18104
18105 =item DESCRIPTION
18106
18107 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18108 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18109 in 5.004_02), closelog
18110
18111 =item EXAMPLES
18112
18113 =item SEE ALSO
18114
18115 =item AUTHOR
18116
18117 =back
18118
18119 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18120 Perl interface to the UNIX syslog(3) calls
18121
18122 =over 4
18123
18124 =item SYNOPSIS
18125
18126 =item DESCRIPTION
18127
18128 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18129 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18130 in 5.004_02), closelog
18131
18132 =item EXAMPLES
18133
18134 =item SEE ALSO
18135
18136 =item AUTHOR
18137
18138 =back
18139
18140 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18141
18142 =over 4
18143
18144 =item SYNOPSIS
18145
18146 =item DESCRIPTION
18147
18148 =item DIAGNOSTICS
18149
18150 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18151 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18152 comma allowed after filehandle, No name for escape sequence %s
18153
18154 =item ENVIRONMENT
18155
18156 ANSI_COLORS_DISABLED
18157
18158 =item RESTRICTIONS
18159
18160 =item NOTES
18161
18162 =item SEE ALSO
18163
18164 =item AUTHORS
18165
18166 =item LICENSE
18167
18168 =back
18169
18170 =head2 Term::Cap - Perl termcap interface
18171
18172 =over 4
18173
18174 =item SYNOPSIS
18175
18176 =item DESCRIPTION
18177
18178 =over 4
18179
18180 =item METHODS
18181
18182 =back
18183
18184 =back
18185
18186 B<Tgetent>, OSPEED, TERM
18187
18188 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18189
18190 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18191
18192 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18193
18194 B<Trequire>
18195
18196 =over 4
18197
18198 =item EXAMPLES
18199
18200 =item COPYRIGHT AND LICENSE
18201
18202 =item AUTHOR
18203
18204 =item SEE ALSO
18205
18206 =back
18207
18208 =head2 Term::Complete - Perl word completion module
18209
18210 =over 4
18211
18212 =item SYNOPSIS
18213
18214 =item DESCRIPTION
18215
18216 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18217
18218 =item DIAGNOSTICS
18219
18220 =item BUGS
18221
18222 =item AUTHOR
18223
18224 =back
18225
18226 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18227 no real package is found, substitutes stubs instead of basic functions.
18228
18229 =over 4
18230
18231 =item SYNOPSIS
18232
18233 =item DESCRIPTION
18234
18235 =item Minimal set of supported functions
18236
18237 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18238 C<MinLine>, C<findConsole>, Attribs, C<Features>
18239
18240 =item Additional supported functions
18241
18242 C<tkRunning>, C<ornaments>, C<newTTY>
18243
18244 =item EXPORTS
18245
18246 =item ENVIRONMENT
18247
18248 =item CAVEATS
18249
18250 =back
18251
18252 =head2 Test - provides a simple framework for writing test scripts
18253
18254 =over 4
18255
18256 =item SYNOPSIS
18257
18258 =item DESCRIPTION
18259
18260 =over 4
18261
18262 =item Functions
18263
18264 B<plan>
18265
18266 =back
18267
18268 =back
18269
18270 B<_to_value>
18271
18272 B<ok>
18273
18274 =over 4
18275
18276 =item TEST TYPES
18277
18278 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18279
18280 =item ONFAIL
18281
18282 =item BUGS and CAVEATS
18283
18284 =item NOTE
18285
18286 =item SEE ALSO
18287
18288 =item AUTHOR
18289
18290 =back
18291
18292 =head2 Test::Builder - Backend for building test libraries
18293
18294 =over 4
18295
18296 =item SYNOPSIS
18297
18298 =item DESCRIPTION
18299
18300 =over 4
18301
18302 =item Construction
18303
18304 B<new>
18305
18306 =back
18307
18308 =back
18309
18310 =over 4
18311
18312 =item Setting up tests
18313
18314 B<exported_to>
18315
18316 =back
18317
18318 B<plan>
18319
18320 B<expected_tests>
18321
18322 B<no_plan>
18323
18324 B<skip_all>
18325
18326 =over 4
18327
18328 =item Running tests
18329
18330 B<ok>
18331
18332 =back
18333
18334 B<is_eq>, B<is_num>
18335
18336 B<isnt_eq>, B<isnt_num>
18337
18338 B<like>, B<unlike>
18339
18340 B<maybe_regex>
18341
18342 B<cmp_ok>
18343
18344 B<BAILOUT>
18345
18346 B<skip>
18347
18348 B<todo_skip>
18349
18350 B<skip_rest>
18351
18352 =over 4
18353
18354 =item Test style
18355
18356 B<level>
18357
18358 =back
18359
18360 B<use_numbers>
18361
18362 B<no_header>, B<no_ending>
18363
18364 =over 4
18365
18366 =item Output
18367
18368 B<diag>
18369
18370 =back
18371
18372 B<_print>
18373
18374 B<output>, B<failure_output>, B<todo_output>
18375
18376 =over 4
18377
18378 =item Test Status and Info
18379
18380 B<current_test>
18381
18382 =back
18383
18384 B<summary>
18385
18386 B<details>  I<UNIMPLEMENTED>, B<todo>
18387
18388 B<caller>
18389
18390 B<_sanity_check>
18391
18392 B<_whoa>
18393
18394 B<_my_exit>
18395
18396 =over 4
18397
18398 =item EXAMPLES
18399
18400 =item SEE ALSO
18401
18402 =item AUTHORS
18403
18404 =item COPYRIGHT
18405
18406 =back
18407
18408 =head2 Test::Harness - run perl standard test scripts with statistics
18409
18410 =over 4
18411
18412 =item SYNOPSIS
18413
18414 =item DESCRIPTION
18415
18416 =over 4
18417
18418 =item The test script output
18419
18420 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18421 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18422 else>
18423
18424 =item Taint mode
18425
18426 =item Configuration variables.
18427
18428 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18429
18430 =item Failure
18431
18432 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18433 Failed>
18434
18435 =item Functions
18436
18437 B<runtests>
18438
18439 =back
18440
18441 =back
18442
18443 B<_all_ok>
18444
18445 B<_globdir>
18446
18447 B<_run_all_tests>
18448
18449 B<_mk_leader>
18450
18451 B<_leader_width>
18452
18453 =over 4
18454
18455 =item EXPORT
18456
18457 =item DIAGNOSTICS
18458
18459 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18460 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18461 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18462 %s>, C<FAILED--Further testing stopped: %s>
18463
18464 =item ENVIRONMENT
18465
18466 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18467 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18468 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18469
18470 =item EXAMPLE
18471
18472 =item SEE ALSO
18473
18474 =item AUTHORS
18475
18476 =item TODO
18477
18478 =item BUGS
18479
18480 =back
18481
18482 =head2 Test::Harness::Assert - simple assert
18483
18484 =over 4
18485
18486 =item SYNOPSIS
18487
18488 =item DESCRIPTION
18489
18490 =over 4
18491
18492 =item Functions
18493
18494 B<assert>
18495
18496 =back
18497
18498 =back
18499
18500 =over 4
18501
18502 =item AUTHOR
18503
18504 =item SEE ALSO
18505
18506 =back
18507
18508 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18509
18510 =over 4
18511
18512 =item SYNOPSIS
18513
18514 =item DESCRIPTION
18515
18516 =back
18517
18518 =head2 Test::Harness::Straps - detailed analysis of test results
18519
18520 =over 4
18521
18522 =item SYNOPSIS
18523
18524 =item DESCRIPTION
18525
18526 =over 4
18527
18528 =item Construction
18529
18530 B<new>
18531
18532 =back
18533
18534 =back
18535
18536 B<_init>
18537
18538 =over 4
18539
18540 =item Analysis
18541
18542 B<analyze>
18543
18544 =back
18545
18546 B<analyze_fh>
18547
18548 B<analyze_file>
18549
18550 B<_switches>
18551
18552 B<_INC2PERL5LIB>
18553
18554 B<_filtered_INC>
18555
18556 B<_restore_PERL5LIB>
18557
18558 =over 4
18559
18560 =item Parsing
18561
18562 B<_is_comment>
18563
18564 =back
18565
18566 B<_is_header>
18567
18568 B<_is_test>
18569
18570 B<_is_bail_out>
18571
18572 B<_reset_file_state>
18573
18574 =over 4
18575
18576 =item Results
18577
18578 B<_detailize>
18579
18580 =back
18581
18582 =over 4
18583
18584 =item EXAMPLES
18585
18586 =item AUTHOR
18587
18588 =item SEE ALSO
18589
18590 =back
18591
18592 =head2 Test::More - yet another framework for writing test scripts
18593
18594 =over 4
18595
18596 =item SYNOPSIS
18597
18598 =item DESCRIPTION
18599
18600 =over 4
18601
18602 =item I love it when a plan comes together
18603
18604 =back
18605
18606 =back
18607
18608 =over 4
18609
18610 =item Test names
18611
18612 =item I'm ok, you're not ok.
18613
18614 B<ok>
18615
18616 =back
18617
18618 B<is>, B<isnt>
18619
18620 B<like>
18621
18622 B<unlike>
18623
18624 B<cmp_ok>
18625
18626 B<can_ok>
18627
18628 B<isa_ok>
18629
18630 B<pass>, B<fail>
18631
18632 =over 4
18633
18634 =item Diagnostics
18635
18636 B<diag>
18637
18638 =back
18639
18640 =over 4
18641
18642 =item Module tests
18643
18644 B<use_ok>
18645
18646 =back
18647
18648 B<require_ok>
18649
18650 =over 4
18651
18652 =item Conditional tests
18653
18654 B<SKIP: BLOCK>
18655
18656 =back
18657
18658 B<TODO: BLOCK>, B<todo_skip>
18659
18660 =over 4
18661
18662 =item Comparison functions
18663
18664 B<is_deeply>
18665
18666 =back
18667
18668 B<eq_array>
18669
18670 B<eq_hash>
18671
18672 B<eq_set>
18673
18674 =over 4
18675
18676 =item Extending and Embedding Test::More
18677
18678 B<builder>
18679
18680 =back
18681
18682 =over 4
18683
18684 =item NOTES
18685
18686 =item BUGS and CAVEATS
18687
18688 Making your own ok(), The eq_* family has some caveats, Test::Harness
18689 upgrades
18690
18691 =item HISTORY
18692
18693 =item SEE ALSO
18694
18695 =item AUTHORS
18696
18697 =item COPYRIGHT
18698
18699 =back
18700
18701 =head2 Test::Simple - Basic utilities for writing tests.
18702
18703 =over 4
18704
18705 =item SYNOPSIS
18706
18707 =item DESCRIPTION
18708
18709 B<ok>
18710
18711 =back
18712
18713 =over 4
18714
18715 =item EXAMPLE
18716
18717 =item CAVEATS
18718
18719 =item NOTES
18720
18721 =item HISTORY
18722
18723 =item SEE ALSO
18724
18725 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18726 L<Test::Harness>
18727
18728 =item AUTHORS
18729
18730 =item COPYRIGHT
18731
18732 =back
18733
18734 =head2 Test::Tutorial - A tutorial about writing really basic tests
18735
18736 =over 4
18737
18738 =item DESCRIPTION
18739
18740 =over 4
18741
18742 =item Nuts and bolts of testing.
18743
18744 =item Where to start?
18745
18746 =item Names
18747
18748 =item Test the manual
18749
18750 =item Sometimes the tests are wrong
18751
18752 =item Testing lots of values
18753
18754 =item Informative names
18755
18756 =item Skipping tests
18757
18758 =item Todo tests
18759
18760 =item Testing with taint mode.
18761
18762 =back
18763
18764 =item FOOTNOTES
18765
18766 =item AUTHORS
18767
18768 =item COPYRIGHT
18769
18770 =back
18771
18772 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18773
18774 =over 4
18775
18776 =item SYNOPSIS
18777
18778 =item DESCRIPTION
18779
18780 =item EXAMPLE
18781
18782 =back
18783
18784 =head2 Text::Balanced - Extract delimited text sequences from strings.
18785
18786 =over 4
18787
18788 =item SYNOPSIS
18789
18790 =item DESCRIPTION
18791
18792 =over 4
18793
18794 =item General behaviour in list contexts
18795
18796 [0], [1], [2]
18797
18798 =item General behaviour in scalar and void contexts
18799
18800 =item A note about prefixes
18801
18802 =item C<extract_delimited>
18803
18804 =item C<extract_bracketed>
18805
18806 =item C<extract_tagged>
18807
18808 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18809 [0], [1], [2], [3], [4], [5]
18810
18811 =item C<gen_extract_tagged>
18812
18813 =item C<extract_quotelike>
18814
18815 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18816
18817 =item C<extract_quotelike> and "here documents"
18818
18819 [0], [1], [2], [3], [4], [5], [6], [7..10]
18820
18821 =item C<extract_codeblock>
18822
18823 =item C<extract_multiple>
18824
18825 =item C<gen_delimited_pat>
18826
18827 =back
18828
18829 =item DIAGNOSTICS
18830
18831  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
18832 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18833 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
18834 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18835 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18836 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18837 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18838 after dereferencer>, C<Did not find expected opening bracket at %s>,
18839 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18840 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18841 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18842 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18843 tag>
18844
18845 =item AUTHOR
18846
18847 =item BUGS AND IRRITATIONS
18848
18849 =item COPYRIGHT
18850
18851 =back
18852
18853 =head2 Text::ParseWords - parse text into an array of tokens or array of
18854 arrays
18855
18856 =over 4
18857
18858 =item SYNOPSIS
18859
18860 =item DESCRIPTION
18861
18862 =item EXAMPLES
18863
18864 =item AUTHORS
18865
18866 =back
18867
18868 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18869 by Knuth
18870
18871 =over 4
18872
18873 =item SYNOPSIS
18874
18875 =item DESCRIPTION
18876
18877 =item EXAMPLES
18878
18879 =item LIMITATIONS
18880
18881 =item AUTHOR
18882
18883 =back
18884
18885 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18886 unexpand(1)
18887
18888 =over 4
18889
18890 =item SYNOPSIS
18891
18892 =item DESCRIPTION
18893
18894 =item BUGS
18895
18896 =item AUTHOR
18897
18898 =back
18899
18900 =head2 Text::Wrap - line wrapping to form simple paragraphs
18901
18902 =over 4
18903
18904 =item SYNOPSIS 
18905
18906 =item DESCRIPTION
18907
18908 =item OVERRIDES
18909
18910 =item EXAMPLE
18911
18912 =item AUTHOR
18913
18914 =back
18915
18916 =head2 Thread - manipulate threads in Perl (for old code only)
18917
18918 =over 4
18919
18920 =item CAVEAT
18921
18922 =item SYNOPSIS
18923
18924 =item DESCRIPTION
18925
18926 =item FUNCTIONS
18927
18928 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18929 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18930 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18931
18932 =item METHODS
18933
18934 join, eval, detach, equal, tid, flags, done
18935
18936 =item LIMITATIONS
18937
18938 =item SEE ALSO
18939
18940 =back
18941
18942 =head2 Thread::Queue - thread-safe queues (for old code only)
18943
18944 =over 4
18945
18946 =item CAVEAT
18947
18948 =item SYNOPSIS
18949
18950 =item DESCRIPTION
18951
18952 =item FUNCTIONS AND METHODS
18953
18954 new, enqueue LIST, dequeue, dequeue_nb, pending
18955
18956 =item SEE ALSO
18957
18958 =back
18959
18960 =head2 Thread::Semaphore - thread-safe semaphores (for old code only)
18961
18962 =over 4
18963
18964 =item CAVEAT
18965
18966 =item SYNOPSIS
18967
18968 =item DESCRIPTION
18969
18970 =item FUNCTIONS AND METHODS
18971
18972 new, new NUMBER, down, down NUMBER, up, up NUMBER
18973
18974 =back
18975
18976 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18977
18978 =over 4
18979
18980 =item SYNOPSIS
18981
18982 =item DESCRIPTION
18983
18984 =item BUGS
18985
18986 =back
18987
18988 =head2 Thread::Specific - thread-specific keys
18989
18990 =over 4
18991
18992 =item SYNOPSIS
18993
18994 =item DESCRIPTION
18995
18996 =back
18997
18998 =head2 Tie::Array - base class for tied arrays
18999
19000 =over 4
19001
19002 =item SYNOPSIS
19003
19004 =item DESCRIPTION
19005
19006 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19007 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19008 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19009 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19010
19011 =item CAVEATS
19012
19013 =item AUTHOR
19014
19015 =back
19016
19017 =head2 Tie::File - Access the lines of a disk file via a Perl array
19018
19019 =over 4
19020
19021 =item SYNOPSIS
19022
19023 =item DESCRIPTION
19024
19025 =over 4
19026
19027 =item C<recsep>
19028
19029 =item C<autochomp>
19030
19031 =item C<mode>
19032
19033 =item C<memory>
19034
19035 =item C<dw_size>
19036
19037 =item Option Format
19038
19039 =back
19040
19041 =item Public Methods
19042
19043 =over 4
19044
19045 =item C<flock>
19046
19047 =item C<autochomp>
19048
19049 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19050
19051 =back
19052
19053 =item Tying to an already-opened filehandle
19054
19055 =item Deferred Writing
19056
19057 =over 4
19058
19059 =item Autodeferring
19060
19061 =back
19062
19063 =item CAVEATS
19064
19065 =item SUBCLASSING
19066
19067 =item WHAT ABOUT C<DB_File>?
19068
19069 =item AUTHOR
19070
19071 =item LICENSE
19072
19073 =item WARRANTY
19074
19075 =item THANKS
19076
19077 =item TODO
19078
19079 =back
19080
19081 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19082 handles
19083
19084 =over 4
19085
19086 =item SYNOPSIS
19087
19088 =item DESCRIPTION
19089
19090 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19091 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19092 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19093 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19094
19095 =item MORE INFORMATION
19096
19097 =item COMPATIBILITY
19098
19099 =back
19100
19101 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19102 tied hashes
19103
19104 =over 4
19105
19106 =item SYNOPSIS
19107
19108 =item DESCRIPTION
19109
19110 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19111 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19112
19113 =item Inheriting from B<Tie::StdHash>
19114
19115 =item Inheriting from B<Tie::ExtraHash>
19116
19117 =item C<UNTIE> and C<DESTROY>
19118
19119 =item MORE INFORMATION
19120
19121 =back
19122
19123 =head2 Tie::Memoize - add data to hash when needed
19124
19125 =over 4
19126
19127 =item SYNOPSIS
19128
19129 =item DESCRIPTION
19130
19131 =item Inheriting from B<Tie::Memoize>
19132
19133 =item EXAMPLE
19134
19135 =item BUGS
19136
19137 =item AUTHOR
19138
19139 =back
19140
19141 =head2 Tie::RefHash - use references as hash keys
19142
19143 =over 4
19144
19145 =item SYNOPSIS
19146
19147 =item DESCRIPTION
19148
19149 =item EXAMPLE
19150
19151 =item AUTHOR
19152
19153 =item VERSION
19154
19155 =item SEE ALSO
19156
19157 =back
19158
19159 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19160 scalars
19161
19162 =over 4
19163
19164 =item SYNOPSIS
19165
19166 =item DESCRIPTION
19167
19168 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19169
19170 =item MORE INFORMATION
19171
19172 =back
19173
19174 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19175
19176 =over 4
19177
19178 =item SYNOPSIS
19179
19180 =item DESCRIPTION
19181
19182 =item CAVEATS
19183
19184 =back
19185
19186 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19187 timers
19188
19189 =over 4
19190
19191 =item SYNOPSIS
19192
19193 =item DESCRIPTION
19194
19195 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19196 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19197 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19198 getitimer ( $which )
19199
19200 =item EXAMPLES
19201
19202 =item C API
19203
19204 =item CAVEATS
19205
19206 =item AUTHORS
19207
19208 =item REVISION
19209
19210 =item COPYRIGHT
19211
19212 =back
19213
19214 =head2 Time::Local - efficiently compute time from local and GMT time
19215
19216 =over 4
19217
19218 =item SYNOPSIS
19219
19220 =item DESCRIPTION
19221
19222 =item IMPLEMENTATION
19223
19224 =item BUGS
19225
19226 =back
19227
19228 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19229 function
19230
19231 =over 4
19232
19233 =item SYNOPSIS
19234
19235 =item DESCRIPTION
19236
19237 =item NOTE
19238
19239 =item AUTHOR
19240
19241 =back
19242
19243 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
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::tm - internal object used by Time::gmtime and Time::localtime
19259
19260 =over 4
19261
19262 =item SYNOPSIS
19263
19264 =item DESCRIPTION
19265
19266 =item AUTHOR
19267
19268 =back
19269
19270 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19271
19272 =over 4
19273
19274 =item SYNOPSIS
19275
19276 =item DESCRIPTION
19277
19278 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19279 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19280
19281 =back
19282
19283 =head2 Unicode::Collate - Unicode Collation Algorithm
19284
19285 =over 4
19286
19287 =item SYNOPSIS
19288
19289 =item DESCRIPTION
19290
19291 =over 4
19292
19293 =item Constructor and Tailoring
19294
19295 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19296 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19297 undefChar, katakana_before_hiragana, upper_before_lower
19298
19299 =item Methods for Collation
19300
19301 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19302 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19303 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19304 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19305 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19306 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19307 $Collator-E<gt>viewSortKey($string)>, C<$position =
19308 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19309 $Collator-E<gt>index($string, $substring)>
19310
19311 =item Other Methods
19312
19313 UCA_Version, Base_Unicode_Version
19314
19315 =item EXPORT
19316
19317 =item TODO
19318
19319 =item CAVEAT
19320
19321 =item BUGS
19322
19323 =back
19324
19325 =item AUTHOR
19326
19327 =item SEE ALSO
19328
19329 http://www.unicode.org/unicode/reports/tr10/,
19330 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19331 http://www.unicode.org/unicode/reports/tr15/,
19332 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19333
19334 =back
19335
19336 =head2 Unicode::Normalize - Unicode Normalization Forms
19337
19338 =over 4
19339
19340 =item SYNOPSIS
19341
19342 =item DESCRIPTION
19343
19344 =over 4
19345
19346 =item Normalization Forms
19347
19348 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19349 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19350 C<$normalized_string = normalize($form_name, $string)>
19351
19352 =item Decomposition and Composition
19353
19354 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19355 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19356 reorder($string)>, C<$composed_string   = compose($string)>
19357
19358 =item Quick Check
19359
19360 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19361 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19362 check($form_name, $string)>
19363
19364 =item Character Data
19365
19366 C<$canonical_decomposed = getCanon($codepoint)>,
19367 C<$compatibility_decomposed = getCompat($codepoint)>,
19368 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19369 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19370 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19371 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19372 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19373
19374 =item EXPORT
19375
19376 =back
19377
19378 =item AUTHOR
19379
19380 =item SEE ALSO
19381
19382 http://www.unicode.org/unicode/reports/tr15/,
19383 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19384
19385 =back
19386
19387 =head2 Unicode::UCD - Unicode character database
19388
19389 =over 4
19390
19391 =item SYNOPSIS
19392
19393 =item DESCRIPTION
19394
19395 =back
19396
19397 =over 4
19398
19399 =item charinfo
19400
19401 =back
19402
19403 =over 4
19404
19405 =item charblock
19406
19407 =back
19408
19409 =over 4
19410
19411 =item charscript
19412
19413 =back
19414
19415 =over 4
19416
19417 =item charblocks
19418
19419 =back
19420
19421 =over 4
19422
19423 =item charscripts
19424
19425 =back
19426
19427 =over 4
19428
19429 =item Blocks versus Scripts
19430
19431 =item Matching Scripts and Blocks
19432
19433 =item Code Point Arguments
19434
19435 =item charinrange
19436
19437 =back
19438
19439 =over 4
19440
19441 =item compexcl
19442
19443 =back
19444
19445 =over 4
19446
19447 =item casefold
19448
19449 =back
19450
19451 =over 4
19452
19453 =item casespec
19454
19455 =back
19456
19457 =over 4
19458
19459 =item Unicode::UCD::UnicodeVersion
19460
19461 =back
19462
19463 =over 4
19464
19465 =item Implementation Note
19466
19467 =back
19468
19469 =over 4
19470
19471 =item BUGS
19472
19473 =item AUTHOR
19474
19475 =back
19476
19477 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19478 functions
19479
19480 =over 4
19481
19482 =item SYNOPSIS
19483
19484 =item DESCRIPTION
19485
19486 =item NOTE
19487
19488 =item AUTHOR
19489
19490 =back
19491
19492 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19493 functions
19494
19495 =over 4
19496
19497 =item SYNOPSIS
19498
19499 =item DESCRIPTION
19500
19501 =over 4
19502
19503 =item System Specifics
19504
19505 =back
19506
19507 =item NOTE
19508
19509 =item AUTHOR
19510
19511 =item HISTORY
19512
19513 March 18th, 2000
19514
19515 =back
19516
19517 =head2 Win32 - Interfaces to some Win32 API Functions
19518
19519 =over 4
19520
19521 =item DESCRIPTION
19522
19523 =over 4
19524
19525 =item Alphabetical Listing of Win32 Functions
19526
19527 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19528 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19529 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19530 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19531 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19532 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19533 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19534 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19535 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19536 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19537 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19538 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19539 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19540 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19541 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19542 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19543 Win32::UnregisterServer(LIBRARYNAME)
19544
19545 =back
19546
19547 =back
19548
19549 =head2 XS::APItest - Test the perl C API
19550
19551 =over 4
19552
19553 =item SYNOPSIS
19554
19555 =item ABSTRACT
19556
19557 =item DESCRIPTION
19558
19559 =over 4
19560
19561 =item EXPORT
19562
19563 B<print_double>, B<print_long_double>, B<have_long_double>, B<print_nv>,
19564 B<print_iv>, B<print_uv>, B<print_int>, B<print_long>, B<print_float>
19565
19566 =back
19567
19568 =item SEE ALSO
19569
19570 =item AUTHORS
19571
19572 =item COPYRIGHT AND LICENSE
19573
19574 =back
19575
19576 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
19577
19578 =over 4
19579
19580 =item SYNOPSIS
19581
19582 =item DESCRIPTION
19583
19584 =back
19585
19586 =over 4
19587
19588 =item NOTES
19589
19590 =item AUTHOR
19591
19592 =back
19593
19594 =head2 XSLoader - Dynamically load C libraries into Perl code
19595
19596 =over 4
19597
19598 =item SYNOPSIS
19599
19600 =item DESCRIPTION
19601
19602 =item AUTHOR
19603
19604 =back
19605
19606 =head1 AUXILIARY DOCUMENTATION
19607
19608 Here should be listed all the extra programs' documentation, but they
19609 don't all have manual pages yet:
19610
19611 =over 4
19612
19613 =item a2p
19614
19615 =item s2p
19616
19617 =item find2perl
19618
19619 =item h2ph
19620
19621 =item c2ph
19622
19623 =item h2xs
19624
19625 =item xsubpp
19626
19627 =item pod2man
19628
19629 =item wrapsuid
19630
19631 =back
19632
19633 =head1 AUTHOR
19634
19635 Larry Wall <F<larry@wall.org>>, with the help of oodles
19636 of other folks.
19637