Cleaner.
[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 Platform-Specific
33
34 =back
35
36 =item DESCRIPTION
37
38 =item AVAILABILITY
39
40 =item ENVIRONMENT
41
42 =item AUTHOR
43
44 =item FILES
45
46 =item SEE ALSO
47
48 =item DIAGNOSTICS
49
50 =item BUGS
51
52 =item NOTES
53
54 =back
55
56 =head2 perlintro -- a brief introduction and overview of Perl
57
58 =over 4
59
60 =item DESCRIPTION
61
62 =over 4
63
64 =item What is Perl?
65
66 =item Running Perl programs
67
68 =item Basic syntax overview
69
70 =item Perl variable types
71
72 Scalars, Arrays, Hashes
73
74 =item Variable scoping
75
76 =item Conditional and looping constructs
77
78 if, while, for, foreach
79
80 =item Builtin operators and functions
81
82 Arithmetic, Numeric comparison, String comparison, Boolean logic,
83 Miscellaneous
84
85 =item Files and I/O
86
87 =item Regular expressions
88
89 Simple matching, Simple substitution, More complex regular expressions,
90 Parentheses for capturing, Other regexp features
91
92 =item Writing subroutines
93
94 =item OO Perl
95
96 =item Using Perl modules
97
98 =back
99
100 =item AUTHOR
101
102 =back
103
104 =head2 perlfaq - frequently asked questions about Perl ($Date: 2002/01/31
105 04:27:54 $)
106
107 =over 4
108
109 =item DESCRIPTION
110
111 =over 4
112
113 =item perlfaq: Structural overview of the FAQ.
114
115 =item L<perlfaq1>: General Questions About Perl
116
117 =item L<perlfaq2>: Obtaining and Learning about Perl
118
119 =item L<perlfaq3>: Programming Tools
120
121 =item L<perlfaq4>: Data Manipulation
122
123 =item L<perlfaq5>: Files and Formats
124
125 =item L<perlfaq6>: Regular Expressions
126
127 =item L<perlfaq7>: General Perl Language Issues
128
129 =item L<perlfaq8>: System Interaction
130
131 =item L<perlfaq9>: Networking
132
133 =back
134
135 =item About the perlfaq documents
136
137 =over 4
138
139 =item Where to get the perlfaq
140
141 =item How to contribute to the perlfaq
142
143 =item What will happen if you mail your Perl programming problems to the
144 authors
145
146 =back
147
148 =item Credits
149
150 =item Author and Copyright Information
151
152 =over 4
153
154 =item Bundled Distributions
155
156 =item Disclaimer
157
158 =back
159
160 =item Changes
161
162 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98,
163 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
164 Initial Release: 11/March/97
165
166 =back
167
168 =head2 perlbook - Perl book information
169
170 =over 4
171
172 =item DESCRIPTION
173
174 =back
175
176 =head2 perlsyn - Perl syntax
177
178 =over 4
179
180 =item DESCRIPTION
181
182 =over 4
183
184 =item Declarations
185
186 =item Simple statements
187
188 =item Compound statements
189
190 =item Loop Control
191
192 =item For Loops
193
194 =item Foreach Loops
195
196 =item Basic BLOCKs and Switch Statements
197
198 =item Goto
199
200 =item PODs: Embedded Documentation
201
202 =item Plain Old Comments (Not!)
203
204 =back
205
206 =back
207
208 =head2 perldata - Perl data types
209
210 =over 4
211
212 =item DESCRIPTION
213
214 =over 4
215
216 =item Variable names
217
218 =item Context
219
220 =item Scalar values
221
222 =item Scalar value constructors
223
224 =item List value constructors
225
226 =item Slices
227
228 =item Typeglobs and Filehandles
229
230 =back
231
232 =item SEE ALSO
233
234 =back
235
236 =head2 perlop - Perl operators and precedence
237
238 =over 4
239
240 =item SYNOPSIS
241
242 =item DESCRIPTION
243
244 =over 4
245
246 =item Terms and List Operators (Leftward)
247
248 =item The Arrow Operator
249
250 =item Auto-increment and Auto-decrement
251
252 =item Exponentiation
253
254 =item Symbolic Unary Operators
255
256 =item Binding Operators
257
258 =item Multiplicative Operators
259
260 =item Additive Operators
261
262 =item Shift Operators
263
264 =item Named Unary Operators
265
266 =item Relational Operators
267
268 =item Equality Operators
269
270 =item Bitwise And
271
272 =item Bitwise Or and Exclusive Or
273
274 =item C-style Logical And
275
276 =item C-style Logical Or
277
278 =item Range Operators
279
280 =item Conditional Operator
281
282 =item Assignment Operators
283
284 =item Comma Operator
285
286 =item List Operators (Rightward)
287
288 =item Logical Not
289
290 =item Logical And
291
292 =item Logical or and Exclusive Or
293
294 =item C Operators Missing From Perl
295
296 unary &, unary *, (TYPE)
297
298 =item Quote and Quote-like Operators
299
300 =item Regexp Quote-Like Operators
301
302 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
303 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
304 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
305 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
306
307 =item Gory details of parsing quoted constructs
308
309 Finding the end, Removal of backslashes before delimiters, Interpolation,
310 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
311 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
312 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
313 regular expressions
314
315 =item I/O Operators
316
317 =item Constant Folding
318
319 =item Bitwise String Operators
320
321 =item Integer Arithmetic
322
323 =item Floating-point Arithmetic
324
325 =item Bigger Numbers
326
327 =back
328
329 =back
330
331 =head2 perlsub - Perl subroutines
332
333 =over 4
334
335 =item SYNOPSIS
336
337 =item DESCRIPTION
338
339 =over 4
340
341 =item Private Variables via my()
342
343 =item Persistent Private Variables
344
345 =item Temporary Values via local()
346
347 =item Lvalue subroutines
348
349 =item Passing Symbol Table Entries (typeglobs)
350
351 =item When to Still Use local()
352
353 =item Pass by Reference
354
355 =item Prototypes
356
357 =item Constant Functions
358
359 =item Overriding Built-in Functions
360
361 =item Autoloading
362
363 =item Subroutine Attributes
364
365 =back
366
367 =item SEE ALSO
368
369 =back
370
371 =head2 perlfunc - Perl builtin functions
372
373 =over 4
374
375 =item DESCRIPTION
376
377 =over 4
378
379 =item Perl Functions by Category
380
381 Functions for SCALARs or strings, Regular expressions and pattern matching,
382 Numeric functions, Functions for real @ARRAYs, Functions for list data,
383 Functions for real %HASHes, Input and output functions, Functions for fixed
384 length data or records, Functions for filehandles, files, or directories,
385 Keywords related to the control flow of your perl program, Keywords related
386 to scoping, Miscellaneous functions, Functions for processes and process
387 groups, Keywords related to perl modules, Keywords related to classes and
388 object-orientedness, Low-level socket functions, System V interprocess
389 communication functions, Fetching user and group info, Fetching network
390 info, Time-related functions, Functions new in perl5, Functions obsoleted
391 in perl5
392
393 =item Portability
394
395 =item Alphabetical Listing of Perl Functions
396
397 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
398 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
399 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
400 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
401 chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr
402 NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir
403 DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt
404 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR,
405 defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR,
406 dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval
407 BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp,
408 fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
409 FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE,
410 getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority
411 WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname
412 NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname
413 NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE,
414 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
415 gethostent, getnetent, getprotoent, getservent, setpwent, setgrent,
416 sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent
417 STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent,
418 endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR,
419 glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep
420 EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index
421 STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join
422 EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc,
423 lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen
424 SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock THING, log EXPR, log,
425 lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK,
426 mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv
427 ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES,
428 next LABEL, next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open
429 FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
430 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
431 EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package
432 NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
433 SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
434 FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
435 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
436 quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
437 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
438 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
439 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
440 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
441 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
442 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
443 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
444 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
445 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
446 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
447 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
448 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
449 EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL,
450 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort
451 BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice
452 ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split
453 /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf
454 FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat
455 EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK,
456 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
457 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
458 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
459 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
460 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
461 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
462 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
463 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
464 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
465 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
466 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
467 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
468 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
469 LIST, write FILEHANDLE, write EXPR, write, y///
470
471 =back
472
473 =back
474
475 =head2 perlreftut - Mark's very short tutorial about references
476
477 =over 4
478
479 =item DESCRIPTION
480
481 =item Who Needs Complicated Data Structures?
482
483 =item The Solution
484
485 =item Syntax
486
487 =over 4
488
489 =item Making References
490
491 =item Using References
492
493 =back
494
495 =item An Example
496
497 =item Arrow Rule
498
499 =item Solution
500
501 =item The Rest
502
503 =item Summary
504
505 =item Credits
506
507 =over 4
508
509 =item Distribution Conditions
510
511 =back
512
513 =back
514
515 =head2 perldsc - Perl Data Structures Cookbook
516
517 =over 4
518
519 =item DESCRIPTION
520
521 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
522 more elaborate constructs
523
524 =item REFERENCES
525
526 =item COMMON MISTAKES
527
528 =item CAVEAT ON PRECEDENCE
529
530 =item WHY YOU SHOULD ALWAYS C<use strict>
531
532 =item DEBUGGING
533
534 =item CODE EXAMPLES
535
536 =item ARRAYS OF ARRAYS
537
538 =over 4
539
540 =item Declaration of an ARRAY OF ARRAYS
541
542 =item Generation of an ARRAY OF ARRAYS
543
544 =item Access and Printing of an ARRAY OF ARRAYS
545
546 =back
547
548 =item HASHES OF ARRAYS
549
550 =over 4
551
552 =item Declaration of a HASH OF ARRAYS
553
554 =item Generation of a HASH OF ARRAYS
555
556 =item Access and Printing of a HASH OF ARRAYS
557
558 =back
559
560 =item ARRAYS OF HASHES
561
562 =over 4
563
564 =item Declaration of an ARRAY OF HASHES
565
566 =item Generation of an ARRAY OF HASHES
567
568 =item Access and Printing of an ARRAY OF HASHES
569
570 =back
571
572 =item HASHES OF HASHES
573
574 =over 4
575
576 =item Declaration of a HASH OF HASHES
577
578 =item Generation of a HASH OF HASHES
579
580 =item Access and Printing of a HASH OF HASHES
581
582 =back
583
584 =item MORE ELABORATE RECORDS
585
586 =over 4
587
588 =item Declaration of MORE ELABORATE RECORDS
589
590 =item Declaration of a HASH OF COMPLEX RECORDS
591
592 =item Generation of a HASH OF COMPLEX RECORDS
593
594 =back
595
596 =item Database Ties
597
598 =item SEE ALSO
599
600 =item AUTHOR
601
602 =back
603
604 =head2 perlrequick - Perl regular expressions quick start
605
606 =over 4
607
608 =item DESCRIPTION
609
610 =item The Guide
611
612 =over 4
613
614 =item Simple word matching
615
616 =item Using character classes
617
618 =item Matching this or that
619
620 =item Grouping things and hierarchical matching
621
622 =item Extracting matches
623
624 =item Matching repetitions
625
626 =item More matching
627
628 =item Search and replace
629
630 =item The split operator
631
632 =back
633
634 =item BUGS
635
636 =item SEE ALSO
637
638 =item AUTHOR AND COPYRIGHT
639
640 =over 4
641
642 =item Acknowledgments
643
644 =back
645
646 =back
647
648 =head2 perlpod - the Plain Old Documentation format
649
650 =over 4
651
652 =item DESCRIPTION
653
654 =over 4
655
656 =item Ordinary Paragraph
657
658 =item Verbatim Paragraph
659
660 =item Command Paragraph
661
662 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
663 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
664 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
665 I<formatname>>, C<=for I<formatname> I<text...>>
666
667 =item Formatting Codes
668
669 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
670 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
671 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
672 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
673 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
674 (zero-effect) formatting code
675
676 =item The Intent
677
678 =item Embedding Pods in Perl Modules
679
680 =item Hints for Writing Pod
681
682 =back
683
684 =item SEE ALSO
685
686 =item AUTHOR
687
688 =back
689
690 =head2 perlpodspec - Plain Old Documentation: format specification and
691 notes
692
693 =over 4
694
695 =item DESCRIPTION
696
697 =item Pod Definitions
698
699 =item Pod Commands
700
701 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
702 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
703
704 =item Pod Formatting Codes
705
706 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
707 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
708 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
709 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
710 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
711 contains non-breaking spaces
712
713 =item Notes on Implementing Pod Processors
714
715 =item About LE<lt>...E<gt> Codes
716
717 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
718
719 =item About =over...=back Regions
720
721 =item About Data Paragraphs and "=begin/=end" Regions
722
723 =item SEE ALSO
724
725 =item AUTHOR
726
727 =back
728
729 =head2 perlstyle - Perl style guide
730
731 =over 4
732
733 =item DESCRIPTION
734
735 =back
736
737 =head2 perltrap - Perl traps for the unwary
738
739 =over 4
740
741 =item DESCRIPTION
742
743 =over 4
744
745 =item Awk Traps
746
747 =item C Traps
748
749 =item Sed Traps
750
751 =item Shell Traps
752
753 =item Perl Traps
754
755 =item Perl4 to Perl5 Traps
756
757 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
758 Traps, General data type traps, Context Traps - scalar, list contexts,
759 Precedence Traps, General Regular Expression Traps using s///, etc,
760 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
761
762 =item Discontinuance, Deprecation, and BugFix traps
763
764 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
765 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
766 Discontinuance, Deprecation, Discontinuance, Discontinuance
767
768 =item Parsing Traps
769
770 Parsing, Parsing, Parsing, Parsing, Parsing
771
772 =item Numerical Traps
773
774 Numerical, Numerical, Numerical, Bitwise string ops
775
776 =item General data type traps
777
778 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
779 (Constants), (Scalars), (Variable Suicide)
780
781 =item Context Traps - scalar, list contexts
782
783 (list context), (scalar context), (scalar context), (list, builtin)
784
785 =item Precedence Traps
786
787 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
788 Precedence
789
790 =item General Regular Expression Traps using s///, etc.
791
792 Regular Expression, Regular Expression, Regular Expression, Regular
793 Expression, Regular Expression, Regular Expression, Regular Expression,
794 Regular Expression
795
796 =item Subroutine, Signal, Sorting Traps
797
798 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
799
800 =item OS Traps
801
802 (SysV), (SysV)
803
804 =item Interpolation Traps
805
806 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
807 Interpolation, Interpolation, Interpolation, Interpolation
808
809 =item DBM Traps
810
811 DBM, DBM
812
813 =item Unclassified Traps
814
815 C<require>/C<do> trap using returned value, C<split> on empty string with
816 LIMIT specified
817
818 =back
819
820 =back
821
822 =head2 perlrun - how to execute the Perl interpreter
823
824 =over 4
825
826 =item SYNOPSIS
827
828 =item DESCRIPTION
829
830 =over 4
831
832 =item #! and quoting on non-Unix systems
833
834 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
835
836 =item Location of Perl
837
838 =item Command Switches
839
840 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
841 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
842 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
843 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
844 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
845 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
846 B<-X>, B<-x> I<directory>
847
848 =back
849
850 =item ENVIRONMENT
851
852 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
853 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL,
854 PERL_ENCODING, PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to
855 the VMS port)
856
857 =item DESCRIPTION
858
859 accept() on closed socket %s, Allocation too large: %lx, '!' allowed only
860 after types %s, Ambiguous call resolved as CORE::%s(), qualify as such or
861 use &, Ambiguous range in transliteration operator, Ambiguous use of %s
862 resolved as %s, '|' and '<' may not both be specified on command line, '|'
863 and '>' may not both be specified on command line, Applying %s to %s will
864 act on scalar(%s), Args must match #! line, Arg too short for msgsnd, %s
865 argument is not a HASH or ARRAY element, %s argument is not a HASH or ARRAY
866 element or slice, %s argument is not a subroutine name, Argument "%s" isn't
867 numeric%s, Array @%s missing the @ in argument %d of %s(), assertion
868 botched: %s, Assertion failed: file "%s", Assignment to both a list and a
869 scalar, Attempt to access key '%_' in fixed hash, Attempt to bless into a
870 reference, Attempt to free non-arena SV: 0x%lx, Attempt to free nonexistent
871 shared string, Attempt to free temp prematurely, Attempt to free
872 unreferenced glob pointers, Attempt to free unreferenced scalar, Attempt to
873 join self, Attempt to pack pointer to temporary value, Attempt to use
874 reference as lvalue in substr, Bad arg length for %s, is %d, should be %s,
875 Bad evalled substitution pattern, Bad filehandle: %s, Bad free() ignored,
876 Bad hash, Bad index while coercing array into hash, Badly placed ()'s, Bad
877 name after %s::, Bad realloc() ignored, Bad symbol for array, Bad symbol
878 for filehandle, Bad symbol for hash, Bareword found in conditional,
879 Bareword "%s" not allowed while "strict subs" in use, Bareword "%s" refers
880 to nonexistent package, BEGIN failed--compilation aborted, BEGIN not safe
881 after errors--compilation aborted, \1 better written as $1, Binary number >
882 0b11111111111111111111111111111111 non-portable, bind() on closed socket
883 %s, binmode() on closed filehandle %s, Bit vector size > 32 non-portable,
884 Bizarre copy of %s in %s, B<-P> not allowed for setuid/setgid script,
885 Buffer overflow in prime_env_iter: %s, Callback called exit, %s() called
886 too early to check prototype, / cannot take a count, Can't bless
887 non-reference value, Can't call method "%s" in empty package "%s", Can't
888 call method "%s" on an undefined value, Can't call method "%s" on unblessed
889 reference, Can't call method "%s" without a package or object reference,
890 Can't chdir to %s, Can't check filesystem of script "%s" for nosuid, Can't
891 coerce array into hash, Can't coerce %s to integer in %s, Can't coerce %s
892 to number in %s, Can't coerce %s to string in %s, Can't create pipe
893 mailbox, Can't declare class for non-scalar %s in "%s", Can't declare %s in
894 "%s", Can't do inplace edit: %s is not a regular file, Can't do inplace
895 edit on %s: %s, Can't do inplace edit without backup, Can't do inplace
896 edit: %s would not be unique, Can't do {n,m} with n > m in regex; marked by
897 <-- HERE in m/%s/, Can't do setegid!, Can't do seteuid!, Can't do setuid,
898 Can't do waitpid with flags, Can't emulate -%s on #! line, Can't exec "%s":
899 %s, Can't exec %s, Can't execute %s, Can't find an opnumber for "%s", Can't
900 find %s character property "%s", Can't find label %s, Can't find %s on
901 PATH, Can't find %s on PATH, '.' not in PATH, Can't find string terminator
902 %s anywhere before EOF, Can't find %s property definition %s, Can't fork,
903 Can't get filespec - stale stat buffer?, Can't get pipe mailbox device
904 name, Can't get SYSGEN parameter value for MAXBUF, Can't "goto" into the
905 middle of a foreach loop, Can't "goto" out of a pseudo block, Can't goto
906 subroutine from an eval-string, Can't goto subroutine outside a subroutine,
907 Can't ignore signal CHLD, forcing to default, Can't "last" outside a loop
908 block, Can't localize lexical variable %s, Can't localize pseudo-hash
909 element, Can't localize through a reference, Can't locate %s, Can't locate
910 auto/%s.al in @INC, Can't locate object method "%s" via package "%s",
911 (perhaps you forgot to load "%s"?), Can't locate package %s for @%s::ISA,
912 Can't make list assignment to \%ENV on this system, Can't modify %s in %s,
913 Can't modify nonexistent substring, Can't modify non-lvalue subroutine
914 call, Can't msgrcv to read-only var, Can't "next" outside a loop block,
915 Can't open %s: %s, Can't open bidirectional pipe, Can't open error file %s
916 as stderr, Can't open input file %s as stdin, Can't open output file %s as
917 stdout, Can't open output pipe (name: %s), Can't open perl script%s: %s,
918 Can't read CRTL environ, Can't redefine active sort subroutine %s, Can't
919 "redo" outside a loop block, Can't remove %s: %s, skipping file, Can't
920 rename %s to %s: %s, skipping file, Can't reopen input pipe (name: %s) in
921 binary mode, Can't resolve method `%s' overloading `%s' in package `%s',
922 Can't reswap uid and euid, Can't return %s from lvalue subroutine, Can't
923 return %s to lvalue scalar context, Can't return outside a subroutine,
924 Can't stat script "%s", Can't swap uid and euid, Can't take log of %g,
925 Can't take sqrt of %g, Can't undef active subroutine, Can't unshift, Can't
926 upgrade that kind of scalar, Can't upgrade to undef, Can't use an undefined
927 value as %s reference, Can't use anonymous symbol table for method lookup,
928 Can't use bareword ("%s") as %s ref while "strict refs" in use, Can't use
929 %! because Errno.pm is not available, Can't use %s for loop variable, Can't
930 use global %s in "my", Can't use "my %s" in sort comparison, Can't use %s
931 ref as %s ref, Can't use string ("%s") as %s ref while "strict refs" in
932 use, Can't use subscript on %s, Can't use \%c to mean $%c in expression,
933 Can't weaken a nonreference, Can't x= to read-only value, Character in "C"
934 format wrapped, Character in "c" format wrapped, close() on unopened
935 filehandle %s, %s: Command not found, Compilation failed in require,
936 Complex regular subexpression recursion limit (%d) exceeded, connect() on
937 closed socket %s, Constant(%s)%s: %s, Constant is not %s reference,
938 Constant subroutine %s redefined, Constant subroutine %s undefined, Copy
939 method did not return a reference, CORE::%s is not a keyword, corrupted
940 regexp pointers, corrupted regexp program, Corrupt malloc ptr 0x%lx at
941 0x%lx, C<-p> destination: %s, C<-T> and C<-B> not implemented on
942 filehandles, Deep recursion on subroutine "%s", defined(@array) is
943 deprecated, defined(%hash) is deprecated, %s defines neither package nor
944 VERSION--version check failed, Delimiter for here document is too long, Did
945 not produce a valid header, %s did not return a true value, (Did you mean
946 &%s instead?), (Did you mean "local" instead of "our"?), (Did you mean $ or
947 @ instead of %?), Died, Document contains no data, %s does not define
948 %s::VERSION--version check failed, Don't know how to handle magic of type
949 '%s', do_study: out of memory, (Do you need to predeclare %s?), dump()
950 better written as CORE::dump(), Duplicate free() ignored, elseif should be
951 elsif, Empty %s, entering effective %s failed, Error converting file
952 specification %s, %s: Eval-group in insecure regular expression, %s:
953 Eval-group not allowed at run time, %s: Eval-group not allowed, use re
954 'eval', Excessively long <> operator, exec? I'm not *that* kind of
955 operating system, Execution of %s aborted due to compilation errors,
956 Exiting eval via %s, Exiting format via %s, Exiting pseudo-block via %s,
957 Exiting subroutine via %s, Exiting substitution via %s, Explicit blessing
958 to '' (assuming package main), %s: Expression syntax, %s failed--call queue
959 aborted, False [] range "%s" in regex; marked by <-- HERE in m/%s/, Fatal
960 VMS error at %s, line %d, fcntl is not implemented, Filehandle %s opened
961 only for input, Filehandle %s opened only for output, Final $ should be \$
962 or $name, Final @ should be \@ or @name, flock() on closed filehandle %s,
963 Quantifier follows nothing in regex;, Format not terminated, Format %s
964 redefined, Found = in conditional, should be ==, %s found where operator
965 expected, gdbm store returned %d, errno %d, key "%s", gethostent not
966 implemented, get%sname() on closed socket %s, getpwnam returned invalid UIC
967 %#o for user "%s", getsockopt() on closed socket %s, Global symbol "%s"
968 requires explicit package name, glob failed (%s), Glob not terminated, Got
969 an error from DosAllocMem, goto must have label, %s-group starts with a
970 count, %s had compilation errors, Had to create %s unexpectedly, Hash %%s
971 missing the % in argument %d of %s(), %s has too many errors, Hexadecimal
972 number > 0xffffffff non-portable, Identifier too long, Illegal binary digit
973 %s, Illegal binary digit %s ignored, Illegal character %s (carriage
974 return), Illegal character in prototype for %s : %s, Illegal division by
975 zero, Illegal hexadecimal digit %s ignored, Illegal modulus zero, Illegal
976 number of bits in vec, Illegal octal digit %s, Illegal octal digit %s
977 ignored, Illegal switch in PERL5OPT: %s, Ill-formed CRTL environ value
978 "%s", Ill-formed message in prime_env_iter: |%s|, (in cleanup) %s, In
979 EBCDIC the v-string components cannot exceed 2147483647, Insecure
980 dependency in %s, Insecure directory in %s, Insecure $ENV{%s} while running
981 %s, Integer overflow in %s number, Internal disaster in regex; marked by
982 <-- HERE in m/%s/, Internal inconsistency in tracking vforks, Internal urp
983 in regex; marked by <-- HERE in m/%s/, %s (...) interpreted as function,
984 Invalid %s attribute: %s, Invalid %s attributes: %s, Invalid conversion in
985 %s: "%s", Invalid [] range "%s" in regex; marked by <-- HERE in m/%s/,
986 Invalid [] range "%s" in transliteration operator, Invalid separator
987 character %s in attribute list, Invalid type in pack: '%s', Invalid type in
988 unpack: '%s', ioctl is not implemented, ioctl() on unopened %s,
989 IO::Socket::atmark not implemented on this architecture, `%s' is not a code
990 reference, `%s' is not an overloadable type, junk on end of regexp, Label
991 not found for "last %s", Label not found for "next %s", Label not found for
992 "redo %s", leaving effective %s failed, listen() on closed socket %s,
993 lstat() on filehandle %s, Lvalue subs returning %s not implemented yet,
994 Lookbehind longer than %d not implemented in regex;, Malformed
995 PERLLIB_PREFIX, Malformed prototype for %s: %s, Malformed UTF-8 character
996 (%s), Malformed UTF-16 surrogate, %s matches null string many times in
997 regex;, "%s" may clash with future reserved word, % may only be used in
998 unpack, Method for operation %s not found in package %s during blessing,
999 Method %s not permitted, Might be a runaway multi-line %s string starting
1000 on line %d, Misplaced _ in number, Missing %sbrace%s on \N{}, Missing comma
1001 after first argument to %s function, Missing command in piped open, Missing
1002 name in "my sub", Missing $ on loop variable, (Missing operator before
1003 %s?), Missing right brace on %s, Missing right curly or square bracket,
1004 (Missing semicolon on previous line?), Modification of a read-only value
1005 attempted, Modification of non-creatable array value attempted, %s,
1006 Modification of non-creatable hash value attempted, %s, Module name must be
1007 constant, Module name required with -%c option, More than one argument to
1008 open, msg%s not implemented, Multidimensional syntax %s not supported, /
1009 must be followed by a*, A* or Z*, / must be followed by a, A or Z, / must
1010 follow a numeric type, "my sub" not yet implemented, "my" variable %s can't
1011 be in a package, Name "%s::%s" used only once: possible typo, Negative
1012 length, Negative offset to vec in lvalue context, Nested quantifiers in
1013 regex; marked by <-- HERE in m/%s/, %s never introduced, No %s allowed
1014 while running setuid, No B<-e> allowed in setuid scripts, No comma allowed
1015 after %s, No command into which to pipe on command line, No DB::DB routine
1016 defined, No dbm on this machine, No DBsub routine, No error file after 2>
1017 or 2>> on command line, No input file after < on command line, No #! line,
1018 "no" not allowed in expression, No output file after > on command line, No
1019 output file after > or >> on command line, No package name allowed for
1020 variable %s in "our", No Perl script found in input, No setregid available,
1021 No setreuid available, No space allowed after -%c, No %s specified for -%c,
1022 No such class %s, No such pipe open, No such pseudo-hash field "%s", No
1023 such pseudo-hash field "%s" in variable %s of type %s, No such signal:
1024 SIG%s, Not a CODE reference, Not a format reference, Not a GLOB reference,
1025 Not a HASH reference, Not an ARRAY reference, Not a perl script, Not a
1026 SCALAR reference, Not a subroutine reference, Not a subroutine reference in
1027 overload table, Not enough arguments for %s, Not enough format arguments,
1028 %s: not found, %s not allowed in length fields, no UTC offset information;
1029 assuming local time is UTC, Null filename used, NULL OP IN RUN, Null
1030 picture in formline, Null realloc, NULL regexp argument, NULL regexp
1031 parameter, Number too long, Octal number in vector unsupported, Octal
1032 number > 037777777777 non-portable, Odd number of arguments for
1033 overload::constant, Odd number of elements in anonymous hash, Odd number of
1034 elements in hash assignment, Offset outside string, -%s on unopened
1035 filehandle %s, %s() on unopened %s, oops: oopsAV, oops: oopsHV, Operation
1036 `%s': no method found, %s, Operator or semicolon missing before %s, "our"
1037 variable %s redeclared, Out of memory!, Out of memory during "large"
1038 request for %s, Out of memory during request for %s, Out of memory during
1039 ridiculously large request, Out of memory for yacc stack, @ outside of
1040 string, %s package attribute may clash with future reserved word: %s, page
1041 overflow, panic: %s, panic: ck_grep, panic: ck_split, panic: corrupt saved
1042 stack index, panic: del_backref, panic: die %s, panic: pp_match%s, panic:
1043 do_subst, panic: do_trans_%s, panic: frexp, panic: goto, panic:
1044 INTERPCASEMOD, panic: INTERPCONCAT, panic: kid popen errno read, panic:
1045 last, panic: leave_scope clearsv, panic: leave_scope inconsistency, panic:
1046 magic_killbackrefs, panic: malloc, panic: mapstart, panic: null array,
1047 panic: pad_alloc, panic: pad_free curpad, panic: pad_free po, panic:
1048 pad_reset curpad, panic: pad_sv po, panic: pad_swipe curpad, panic:
1049 pad_swipe po, panic: pp_iter, panic: pp_split, panic: realloc, panic:
1050 restartop, panic: return, panic: scan_num, panic: sv_insert, panic:
1051 top_env, panic: yylex, panic: utf16_to_utf8: odd bytelen, Parentheses
1052 missing around "%s" list, Perl %s required--this is only version %s,
1053 stopped, PERL_SH_DIR too long, perl: warning: Setting locale failed,
1054 perlio: argument list not closed for layer "%s", perlio: invalid separator
1055 character %s in attribute list, perlio: unknown layer "%s", Permission
1056 denied, pid %x not a child, P must have an explicit size, POSIX syntax [%s]
1057 belongs inside character classes in regex;, POSIX syntax [. .] is reserved
1058 for future extensions in regex;, POSIX syntax [= =] is reserved for future
1059 extensions in regex;, POSIX class [:%s:] unknown in regex;, POSIX getpgrp
1060 can't take an argument, Possible attempt to put comments in qw() list,
1061 Possible attempt to separate words with commas, Possible memory corruption:
1062 %s overflowed 3rd argument, Possible unintended interpolation of %s in
1063 string, Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME :
1064 ATTRS" instead, Precedence problem: open %s should be open(%s), Premature
1065 end of script headers, printf() on closed filehandle %s, print() on closed
1066 filehandle %s, Process terminated by SIG%s, Prototype mismatch: %s vs %s,
1067 Prototype not terminated, Quantifier in {,} bigger than %d in regex;,
1068 Quantifier unexpected on zero-length expression;, Range iterator outside
1069 integer range, readline() on closed filehandle %s, Reallocation too large:
1070 %lx, realloc() of freed memory ignored, Recompile perl with B<-D>DEBUGGING
1071 to use B<-D> switch, Recursive inheritance detected in package '%s',
1072 Recursive inheritance detected while looking for method %s, Reference found
1073 where even-sized list expected, Reference is already weak, Reference
1074 miscount in sv_replace(), Reference to nonexistent group in regex;, regexp
1075 memory corruption, Regexp out of space, Repeat count in pack overflows,
1076 Repeat count in unpack overflows, Reversed %s= operator, Runaway format,
1077 Scalar value @%s[%s] better written as $%s[%s], Scalar value @%s{%s} better
1078 written as $%s{%s}, Scalars leaked: %d, Script is not setuid/setgid in
1079 suidperl, Search pattern not terminated, %sseek() on unopened filehandle,
1080 select not implemented, Self-ties of arrays and hashes are not supported,
1081 Semicolon seems to be missing, semi-panic: attempt to dup freed string,
1082 sem%s not implemented, send() on closed socket %s, Sequence (? incomplete
1083 in regex; marked by <-- HERE in m/%s/, Sequence (?{...}) not terminated or
1084 not {}-balanced in regex;, Sequence (?%s...) not implemented in regex;,
1085 Sequence (?%s...) not recognized in regex;, Sequence (?#... not terminated
1086 in regex;, 500 Server error, Server error, setegid() not implemented,
1087 seteuid() not implemented, setpgrp can't take arguments, setrgid() not
1088 implemented, setruid() not implemented, setsockopt() on closed socket %s,
1089 Setuid/gid script is writable by world, shm%s not implemented, <> should be
1090 quotes, /%s/ should probably be written as "%s", shutdown() on closed
1091 socket %s, SIG%s handler "%s" not defined, sort is now a reserved word,
1092 Sort subroutine didn't return a numeric value, Sort subroutine didn't
1093 return single value, splice() offset past end of array, Split loop,
1094 Statement unlikely to be reached, stat() on unopened filehandle %s, Stub
1095 found while resolving method `%s' overloading %s, Subroutine %s redefined,
1096 Substitution loop, Substitution pattern not terminated, Substitution
1097 replacement not terminated, substr outside of string, suidperl is no longer
1098 needed since %s, Switch (?(condition)... contains too many branches in
1099 regex;, Switch condition not recognized in regex;, switching effective %s
1100 is not implemented, syntax error, syntax error at line %d: `%s' unexpected,
1101 syntax error in file %s at line %d, next 2 tokens "%s", %s syntax OK,
1102 System V %s is not implemented on this machine, syswrite() on closed
1103 filehandle %s, Target of goto is too deeply nested, tell() on unopened
1104 filehandle, That use of $[ is unsupported, The crypt() function is
1105 unimplemented due to excessive paranoia, The %s function is unimplemented,
1106 The stat preceding %s wasn't an lstat, This Perl can't reset CRTL environ
1107 elements (%s), This Perl can't set CRTL environ elements (%s=%s), times not
1108 implemented, Too few args to syscall, Too late for "B<-T>" option, Too late
1109 for "-%s" option, Too late to run %s block, Too many args to syscall, Too
1110 many arguments for %s, Too many )'s, Too many ('s, Trailing \ in regex
1111 m/%s/, Transliteration pattern not terminated, Transliteration replacement
1112 not terminated, truncate not implemented, Type of arg %d to %s must be %s
1113 (not %s), umask not implemented, Unable to create sub named "%s",
1114 Unbalanced context: %d more PUSHes than POPs, Unbalanced saves: %d more
1115 saves than restores, Unbalanced scopes: %d more ENTERs than LEAVEs,
1116 Unbalanced tmps: %d more allocs than frees, Undefined format "%s" called,
1117 Undefined sort subroutine "%s" called, Undefined subroutine &%s called,
1118 Undefined subroutine called, Undefined subroutine in sort, Undefined top
1119 format "%s" called, Undefined value assigned to typeglob, %s: Undefined
1120 variable, unexec of %s into %s failed!, Unicode character %s is illegal,
1121 Unknown BYTEORDER, Unknown "re" subpragma '%s' (known ones are: %s),
1122 Unknown switch condition (?(%.2s in regex;, Unknown open() mode '%s',
1123 Unknown process %x sent message to prime_env_iter: %s, Unknown warnings
1124 category '%s', unmatched [ in regex; marked by <-- HERE in m/%s/, unmatched
1125 ( in regex; marked by <-- HERE in m/%s/, Unmatched right %s bracket,
1126 Unquoted string "%s" may clash with future reserved word, Unrecognized
1127 character %s, /%s/: Unrecognized escape \\%c in character class passed
1128 through, Unrecognized escape \\%c passed through in regex;, Unrecognized
1129 escape \\%c passed through, Unrecognized signal name "%s", Unrecognized
1130 switch: -%s  (-h will show valid options), Unsuccessful %s on filename
1131 containing newline, Unsupported directory function "%s" called, Unsupported
1132 function %s, Unsupported function fork, Unsupported script encoding,
1133 Unsupported socket function "%s" called, Unterminated attribute list,
1134 Unterminated attribute parameter in attribute list, Unterminated compressed
1135 integer, Unterminated <> operator, untie attempted while %d inner
1136 references still exist, Useless (?%s) - use /%s modifier in regex;, Useless
1137 (?-%s) - don't use /%s modifier in regex;, Useless use of %s in void
1138 context, Useless use of "re" pragma, Useless use of sort in scalar context,
1139 Useless use of %s with no values, "use" not allowed in expression, Use of
1140 bare << to mean <<"" is deprecated, Use of *glob{FILEHANDLE} is deprecated,
1141 Use of chdir('') or chdir(undef) as chdir() deprecated, Use of implicit
1142 split to @_ is deprecated, Use of inherited AUTOLOAD for non-method %s() is
1143 deprecated, Use of -l on filehandle %s, Use of "package" with no arguments
1144 is deprecated, Use of %s in printf format not supported, Use of $* is
1145 deprecated, Use of %s is deprecated, Use of $# is deprecated, Use of
1146 reference "%s" as array index, Use of reserved word "%s" is deprecated, Use
1147 of tainted arguments in %s is deprecated, Use of uninitialized value%s,
1148 Using a hash as a reference is deprecated, Using an array as a reference is
1149 deprecated, UTF-16 surrogate %s, Value of %s can be "0"; test with
1150 defined(), Value of CLI symbol "%s" too long, Variable "%s" is not
1151 imported%s, "%s" variable %s masks earlier declaration in same %s, Variable
1152 "%s" may be unavailable, Variable syntax, Variable "%s" will not stay
1153 shared, Variable length lookbehind not implemented in regex;, Version
1154 number must be a constant number, v-string in use/require is non-portable,
1155 Warning: something's wrong, Warning: unable to close filehandle %s
1156 properly, Warning: Use of "%s" without parentheses is ambiguous, Wide
1157 character in %s, write() on closed filehandle %s, X outside of string, x
1158 outside of string, Xsub "%s" called in sort, Xsub called in sort, YOU
1159 HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!, You need to quote "%s"
1160
1161 =back
1162
1163 =head2 perllexwarn - Perl Lexical Warnings
1164
1165 =over 4
1166
1167 =item DESCRIPTION
1168
1169 =over 4
1170
1171 =item Default Warnings and Optional Warnings
1172
1173 =item What's wrong with B<-w> and C<$^W>
1174
1175 =item Controlling Warnings from the Command Line
1176
1177 B<-w>, B<-W>, B<-X>
1178
1179 =item Backward Compatibility
1180
1181 =item Category Hierarchy
1182
1183 =item Fatal Warnings
1184
1185 =item Reporting Warnings from a Module
1186
1187 =back
1188
1189 =item TODO
1190
1191 =item SEE ALSO
1192
1193 =item AUTHOR
1194
1195 =back
1196
1197 =head2 perldebtut - Perl debugging tutorial
1198
1199 =over 4
1200
1201 =item DESCRIPTION
1202
1203 =item use strict
1204
1205 =item Looking at data and -w and v
1206
1207 =item help
1208
1209 =item Stepping through code
1210
1211 =item Placeholder for a, w, t, T
1212
1213 =item REGULAR EXPRESSIONS
1214
1215 =item OUTPUT TIPS
1216
1217 =item CGI
1218
1219 =item GUIs
1220
1221 =item SUMMARY
1222
1223 =item SEE ALSO
1224
1225 =item AUTHOR
1226
1227 =item CONTRIBUTORS
1228
1229 =back
1230
1231 =head2 perldebug - Perl debugging
1232
1233 =over 4
1234
1235 =item DESCRIPTION
1236
1237 =item The Perl Debugger
1238
1239 =over 4
1240
1241 =item Debugger Commands
1242
1243 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars],
1244 T, s [expr], n [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l
1245 line, l subname, -, v [line], f filename, /pattern/, ?pattern?, L [abw], S
1246 [[!]regex], t, t expr, b, b [line] [condition], b subname [condition], b
1247 postpone subname [condition], b load filename, b compile subname, B line, B
1248 *, a [line] command, A line, A *, w expr, W expr, W *, o, o booloption ..,
1249 o anyoption? .., o option=value .., < ?, < [ command ], << command, > ?, >
1250 command, >> command, { ?, { [ command ], {{ command, ! number, ! -number, !
1251 pattern, !! cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m
1252 expr, M, man [manpage]
1253
1254 =item Configurable Options
1255
1256 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
1257 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
1258 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
1259 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
1260 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
1261 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
1262 C<NonStop>
1263
1264 =item Debugger input/output
1265
1266 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
1267 listing
1268
1269 =item Debugging compile-time statements
1270
1271 =item Debugger Customization
1272
1273 =item Readline Support
1274
1275 =item Editor Support for Debugging
1276
1277 =item The Perl Profiler
1278
1279 =back
1280
1281 =item Debugging regular expressions
1282
1283 =item Debugging memory usage
1284
1285 =item SEE ALSO
1286
1287 =item BUGS
1288
1289 =back
1290
1291 =head2 perlvar - Perl predefined variables
1292
1293 =over 4
1294
1295 =item DESCRIPTION
1296
1297 =over 4
1298
1299 =item Predefined Names
1300
1301 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1302 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1303 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1304 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1305 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1306 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1307 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1308 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1309 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1310 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1311 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1312 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1313 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1314 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1315 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1316 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1317 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1318 IO::Handle->format_line_break_characters EXPR,
1319 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1320 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1321 $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1322 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1323 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1324 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1325 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1326 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1327 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1328 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1329 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1330 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1331
1332 =item Error Indicators
1333
1334 =item Technical Note on the Syntax of Variable Names
1335
1336 =back
1337
1338 =item BUGS
1339
1340 =back
1341
1342 =head2 perllol - Manipulating Arrays of Arrays in Perl
1343
1344 =over 4
1345
1346 =item DESCRIPTION
1347
1348 =over 4
1349
1350 =item Declaration and Access of Arrays of Arrays
1351
1352 =item Growing Your Own
1353
1354 =item Access and Printing
1355
1356 =item Slices
1357
1358 =back
1359
1360 =item SEE ALSO
1361
1362 =item AUTHOR
1363
1364 =back
1365
1366 =head2 perlopentut - tutorial on opening things in Perl
1367
1368 =over 4
1369
1370 =item DESCRIPTION
1371
1372 =item Open E<agrave> la shell
1373
1374 =over 4
1375
1376 =item Simple Opens
1377
1378 =item Pipe Opens
1379
1380 =item The Minus File
1381
1382 =item Mixing Reads and Writes
1383
1384 =item Filters 
1385
1386 =back
1387
1388 =item Open E<agrave> la C
1389
1390 =over 4
1391
1392 =item Permissions E<agrave> la mode
1393
1394 =back
1395
1396 =item Obscure Open Tricks
1397
1398 =over 4
1399
1400 =item Re-Opening Files (dups)
1401
1402 =item Dispelling the Dweomer
1403
1404 =item Paths as Opens
1405
1406 =item Single Argument Open
1407
1408 =item Playing with STDIN and STDOUT
1409
1410 =back
1411
1412 =item Other I/O Issues
1413
1414 =over 4
1415
1416 =item Opening Non-File Files
1417
1418 =item Binary Files
1419
1420 =item File Locking
1421
1422 =back
1423
1424 =item SEE ALSO 
1425
1426 =item AUTHOR and COPYRIGHT
1427
1428 =item HISTORY
1429
1430 =back
1431
1432 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1433
1434 =over 4
1435
1436 =item DESCRIPTION
1437
1438 =item The Basic Principle
1439
1440 =item Packing Text
1441
1442 =item Packing Numbers
1443
1444 =over 4
1445
1446 =item Integers
1447
1448 =item Unpacking a Stack Frame
1449
1450 =item How to Eat an Egg on a Net
1451
1452 =item Floating point Numbers
1453
1454 =back
1455
1456 =item Exotic Templates
1457
1458 =over 4
1459
1460 =item Bit Strings
1461
1462 =item Uuencoding
1463
1464 =item Doing Sums
1465
1466 =item  Unicode
1467
1468 =item Another Portable Binary Encoding
1469
1470 =back
1471
1472 =item Lengths and Widths
1473
1474 =over 4
1475
1476 =item String Lengths
1477
1478 =item Dynamic Templates
1479
1480 =back
1481
1482 =item Packing and Unpacking C Structures
1483
1484 =over 4
1485
1486 =item The Alignment Pit
1487
1488 =item Alignment, Take 2
1489
1490 =item Alignment, Take 3
1491
1492 =item Pointers for How to Use Them
1493
1494 =back
1495
1496 =item Pack Recipes
1497
1498 =item Funnies Section
1499
1500 =item Authors
1501
1502 =back
1503
1504 =head2 perlretut - Perl regular expressions tutorial
1505
1506 =over 4
1507
1508 =item DESCRIPTION
1509
1510 =item Part 1: The basics
1511
1512 =over 4
1513
1514 =item Simple word matching
1515
1516 =item Using character classes
1517
1518 =item Matching this or that
1519
1520 =item Grouping things and hierarchical matching
1521
1522 =item Extracting matches
1523
1524 =item Matching repetitions
1525
1526 =item Building a regexp
1527
1528 =item Using regular expressions in Perl
1529
1530 =back
1531
1532 =item Part 2: Power tools
1533
1534 =over 4
1535
1536 =item More on characters, strings, and character classes
1537
1538 =item Compiling and saving regular expressions
1539
1540 =item Embedding comments and modifiers in a regular expression
1541
1542 =item Non-capturing groupings
1543
1544 =item Looking ahead and looking behind
1545
1546 =item Using independent subexpressions to prevent backtracking
1547
1548 =item Conditional expressions
1549
1550 =item A bit of magic: executing Perl code in a regular expression
1551
1552 =item Pragmas and debugging
1553
1554 =back
1555
1556 =item BUGS
1557
1558 =item SEE ALSO
1559
1560 =item AUTHOR AND COPYRIGHT
1561
1562 =over 4
1563
1564 =item Acknowledgments
1565
1566 =back
1567
1568 =back
1569
1570 =head2 perlre - Perl regular expressions
1571
1572 =over 4
1573
1574 =item DESCRIPTION
1575
1576 i, m, s, x
1577
1578 =over 4
1579
1580 =item Regular Expressions
1581
1582 [1], [2], [3], cntrl, graph, print, punct, xdigit
1583
1584 =item Extended Patterns
1585
1586 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1587 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1588 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1589 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1590
1591 =item Backtracking
1592
1593 =item Version 8 Regular Expressions
1594
1595 =item Warning on \1 vs $1
1596
1597 =item Repeated patterns matching zero-length substring
1598
1599 =item Combining pieces together
1600
1601 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1602 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1603 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1604 C<(?(condition)yes-pattern|no-pattern)>
1605
1606 =item Creating custom RE engines
1607
1608 =back
1609
1610 =item BUGS
1611
1612 =item SEE ALSO
1613
1614 =back
1615
1616 =head2 perlref - Perl references and nested data structures
1617
1618 =over 4
1619
1620 =item NOTE
1621
1622 =item DESCRIPTION
1623
1624 =over 4
1625
1626 =item Making References
1627
1628 =item Using References
1629
1630 =item Symbolic references
1631
1632 =item Not-so-symbolic references
1633
1634 =item Pseudo-hashes: Using an array as a hash
1635
1636 =item Function Templates
1637
1638 =back
1639
1640 =item WARNING
1641
1642 =item SEE ALSO
1643
1644 =back
1645
1646 =head2 perlform - Perl formats
1647
1648 =over 4
1649
1650 =item DESCRIPTION
1651
1652 =over 4
1653
1654 =item Format Variables
1655
1656 =back
1657
1658 =item NOTES
1659
1660 =over 4
1661
1662 =item Footers
1663
1664 =item Accessing Formatting Internals
1665
1666 =back
1667
1668 =item WARNINGS
1669
1670 =back
1671
1672 =head2 perlboot - Beginner's Object-Oriented Tutorial
1673
1674 =over 4
1675
1676 =item DESCRIPTION
1677
1678 =over 4
1679
1680 =item If we could talk to the animals...
1681
1682 =item Introducing the method invocation arrow
1683
1684 =item Invoking a barnyard
1685
1686 =item The extra parameter of method invocation
1687
1688 =item Calling a second method to simplify things
1689
1690 =item Inheriting the windpipes
1691
1692 =item A few notes about @ISA
1693
1694 =item Overriding the methods
1695
1696 =item Starting the search from a different place
1697
1698 =item The SUPER way of doing things
1699
1700 =item Where we're at so far...
1701
1702 =item A horse is a horse, of course of course -- or is it?
1703
1704 =item Invoking an instance method
1705
1706 =item Accessing the instance data
1707
1708 =item How to build a horse
1709
1710 =item Inheriting the constructor
1711
1712 =item Making a method work with either classes or instances
1713
1714 =item Adding parameters to a method
1715
1716 =item More interesting instances
1717
1718 =item A horse of a different color
1719
1720 =item Summary
1721
1722 =back
1723
1724 =item SEE ALSO
1725
1726 =item COPYRIGHT
1727
1728 =back
1729
1730 =head2 perltoot - Tom's object-oriented tutorial for perl
1731
1732 =over 4
1733
1734 =item DESCRIPTION
1735
1736 =item Creating a Class
1737
1738 =over 4
1739
1740 =item Object Representation
1741
1742 =item Class Interface
1743
1744 =item Constructors and Instance Methods
1745
1746 =item Planning for the Future: Better Constructors
1747
1748 =item Destructors
1749
1750 =item Other Object Methods
1751
1752 =back
1753
1754 =item Class Data
1755
1756 =over 4
1757
1758 =item Accessing Class Data
1759
1760 =item Debugging Methods
1761
1762 =item Class Destructors
1763
1764 =item Documenting the Interface
1765
1766 =back
1767
1768 =item Aggregation
1769
1770 =item Inheritance
1771
1772 =over 4
1773
1774 =item Overridden Methods
1775
1776 =item Multiple Inheritance
1777
1778 =item UNIVERSAL: The Root of All Objects
1779
1780 =back
1781
1782 =item Alternate Object Representations
1783
1784 =over 4
1785
1786 =item Arrays as Objects
1787
1788 =item Closures as Objects
1789
1790 =back
1791
1792 =item AUTOLOAD: Proxy Methods
1793
1794 =over 4
1795
1796 =item Autoloaded Data Methods
1797
1798 =item Inherited Autoloaded Data Methods
1799
1800 =back
1801
1802 =item Metaclassical Tools
1803
1804 =over 4
1805
1806 =item Class::Struct
1807
1808 =item Data Members as Variables
1809
1810 =back
1811
1812 =item NOTES
1813
1814 =over 4
1815
1816 =item Object Terminology
1817
1818 =back
1819
1820 =item SEE ALSO
1821
1822 =item AUTHOR AND COPYRIGHT
1823
1824 =item COPYRIGHT
1825
1826 =over 4
1827
1828 =item Acknowledgments
1829
1830 =back
1831
1832 =back
1833
1834 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1835
1836 =over 4
1837
1838 =item DESCRIPTION
1839
1840 =item Class Data in a Can
1841
1842 =item Class Data as Package Variables
1843
1844 =over 4
1845
1846 =item Putting All Your Eggs in One Basket
1847
1848 =item Inheritance Concerns
1849
1850 =item The Eponymous Meta-Object
1851
1852 =item Indirect References to Class Data
1853
1854 =item Monadic Classes
1855
1856 =item Translucent Attributes
1857
1858 =back
1859
1860 =item Class Data as Lexical Variables
1861
1862 =over 4
1863
1864 =item Privacy and Responsibility 
1865
1866 =item File-Scoped Lexicals
1867
1868 =item More Inheritance Concerns
1869
1870 =item Locking the Door and Throwing Away the Key
1871
1872 =item Translucency Revisited
1873
1874 =back
1875
1876 =item NOTES
1877
1878 =item SEE ALSO
1879
1880 =item AUTHOR AND COPYRIGHT
1881
1882 =item ACKNOWLEDGEMENTS
1883
1884 =item HISTORY
1885
1886 =back
1887
1888 =head2 perlobj - Perl objects
1889
1890 =over 4
1891
1892 =item DESCRIPTION
1893
1894 =over 4
1895
1896 =item An Object is Simply a Reference
1897
1898 =item A Class is Simply a Package
1899
1900 =item A Method is Simply a Subroutine
1901
1902 =item Method Invocation
1903
1904 =item Indirect Object Syntax
1905
1906 =item Default UNIVERSAL methods
1907
1908 isa(CLASS), can(METHOD), VERSION( [NEED] )
1909
1910 =item Destructors
1911
1912 =item Summary
1913
1914 =item Two-Phased Garbage Collection
1915
1916 =back
1917
1918 =item SEE ALSO
1919
1920 =back
1921
1922 =head2 perlbot - Bag'o Object Tricks (the BOT)
1923
1924 =over 4
1925
1926 =item DESCRIPTION
1927
1928 =item OO SCALING TIPS
1929
1930 =item INSTANCE VARIABLES
1931
1932 =item SCALAR INSTANCE VARIABLES
1933
1934 =item INSTANCE VARIABLE INHERITANCE
1935
1936 =item OBJECT RELATIONSHIPS
1937
1938 =item OVERRIDING SUPERCLASS METHODS
1939
1940 =item USING RELATIONSHIP WITH SDBM
1941
1942 =item THINKING OF CODE REUSE
1943
1944 =item CLASS CONTEXT AND THE OBJECT
1945
1946 =item INHERITING A CONSTRUCTOR
1947
1948 =item DELEGATION
1949
1950 =back
1951
1952 =head2 perltie - how to hide an object class in a simple variable
1953
1954 =over 4
1955
1956 =item SYNOPSIS
1957
1958 =item DESCRIPTION
1959
1960 =over 4
1961
1962 =item Tying Scalars
1963
1964 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1965 DESTROY this
1966
1967 =item Tying Arrays
1968
1969 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1970 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1971 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1972 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1973 this
1974
1975 =item Tying Hashes
1976
1977 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1978 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1979 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1980
1981 =item Tying FileHandles
1982
1983 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1984 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1985 DESTROY this
1986
1987 =item UNTIE this
1988
1989 =item The C<untie> Gotcha
1990
1991 =back
1992
1993 =item SEE ALSO
1994
1995 =item BUGS
1996
1997 =item AUTHOR
1998
1999 =back
2000
2001 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2002 safe subprocesses, sockets, and semaphores)
2003
2004 =over 4
2005
2006 =item DESCRIPTION
2007
2008 =item Signals
2009
2010 =item Named Pipes
2011
2012 =over 4
2013
2014 =item WARNING
2015
2016 =back
2017
2018 =item Using open() for IPC
2019
2020 =over 4
2021
2022 =item Filehandles
2023
2024 =item Background Processes
2025
2026 =item Complete Dissociation of Child from Parent
2027
2028 =item Safe Pipe Opens
2029
2030 =item Bidirectional Communication with Another Process
2031
2032 =item Bidirectional Communication with Yourself
2033
2034 =back
2035
2036 =item Sockets: Client/Server Communication
2037
2038 =over 4
2039
2040 =item Internet Line Terminators
2041
2042 =item Internet TCP Clients and Servers
2043
2044 =item Unix-Domain TCP Clients and Servers
2045
2046 =back
2047
2048 =item TCP Clients with IO::Socket
2049
2050 =over 4
2051
2052 =item A Simple Client
2053
2054 C<Proto>, C<PeerAddr>, C<PeerPort>
2055
2056 =item A Webget Client
2057
2058 =item Interactive Client with IO::Socket
2059
2060 =back
2061
2062 =item TCP Servers with IO::Socket
2063
2064 Proto, LocalPort, Listen, Reuse
2065
2066 =item UDP: Message Passing
2067
2068 =item SysV IPC
2069
2070 =item NOTES
2071
2072 =item BUGS
2073
2074 =item AUTHOR
2075
2076 =item SEE ALSO
2077
2078 =back
2079
2080 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
2081
2082 =over 4
2083
2084 =item SYNOPSIS
2085
2086 =item DESCRIPTION
2087
2088 =over 4
2089
2090 =item Behavior of other Perl features in forked pseudo-processes
2091
2092 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2093 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2094 files, directories and network sockets
2095
2096 =item Resource limits
2097
2098 =item Killing the parent process
2099
2100 =item Lifetime of the parent process and pseudo-processes
2101
2102 =item CAVEATS AND LIMITATIONS
2103
2104 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2105 Global state maintained by XSUBs, Interpreter embedded in larger
2106 application, Thread-safety of extensions
2107
2108 =back
2109
2110 =item BUGS
2111
2112 =item AUTHOR
2113
2114 =item SEE ALSO
2115
2116 =back
2117
2118 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2119
2120 =over 4
2121
2122 =item SYNOPSIS
2123
2124 =item DESCRIPTION
2125
2126 =item Storing numbers
2127
2128 =item Numeric operators and numeric conversions
2129
2130 =item Flavors of Perl numeric operations
2131
2132 Arithmetic operators except, C<no integer>, Arithmetic operators except,
2133 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
2134 integer>, Operators which expect an integer, Operators which expect a
2135 string
2136
2137 =item AUTHOR
2138
2139 =item SEE ALSO
2140
2141 =back
2142
2143 =head2 perlthrtut - tutorial on threads in Perl
2144
2145 =over 4
2146
2147 =item DESCRIPTION
2148
2149 =back
2150
2151 =head2 perlothrtut - old tutorial on threads in Perl
2152
2153 =over 4
2154
2155 =item DESCRIPTION
2156
2157 =item What Is A Thread Anyway?
2158
2159 =item Threaded Program Models
2160
2161 =over 4
2162
2163 =item Boss/Worker
2164
2165 =item Work Crew
2166
2167 =item Pipeline
2168
2169 =back
2170
2171 =item Native threads
2172
2173 =item What kind of threads are perl threads?
2174
2175 =item Threadsafe Modules
2176
2177 =item Thread Basics
2178
2179 =over 4
2180
2181 =item Basic Thread Support
2182
2183 =item Creating Threads
2184
2185 =item Giving up control
2186
2187 =item Waiting For A Thread To Exit
2188
2189 =item Errors In Threads
2190
2191 =item Ignoring A Thread
2192
2193 =back
2194
2195 =item Threads And Data
2196
2197 =over 4
2198
2199 =item Shared And Unshared Data
2200
2201 =item Thread Pitfall: Races
2202
2203 =item Controlling access: lock()
2204
2205 =item Thread Pitfall: Deadlocks
2206
2207 =item Queues: Passing Data Around
2208
2209 =back
2210
2211 =item Threads And Code
2212
2213 =over 4
2214
2215 =item Semaphores: Synchronizing Data Access
2216
2217 Basic semaphores, Advanced Semaphores
2218
2219 =item Attributes: Restricting Access To Subroutines
2220
2221 =item Subroutine Locks
2222
2223 =item Methods
2224
2225 =item Locking A Subroutine
2226
2227 =back
2228
2229 =item General Thread Utility Routines
2230
2231 =over 4
2232
2233 =item What Thread Am I In?
2234
2235 =item Thread IDs
2236
2237 =item Are These Threads The Same?
2238
2239 =item What Threads Are Running?
2240
2241 =back
2242
2243 =item A Complete Example
2244
2245 =item Conclusion
2246
2247 =item Bibliography
2248
2249 =over 4
2250
2251 =item Introductory Texts
2252
2253 =item OS-Related References
2254
2255 =item Other References
2256
2257 =back
2258
2259 =item Acknowledgements
2260
2261 =item AUTHOR
2262
2263 =item Copyrights
2264
2265 =back
2266
2267 =head2 perlport - Writing portable Perl
2268
2269 =over 4
2270
2271 =item DESCRIPTION
2272
2273 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2274 portable
2275
2276 =item ISSUES
2277
2278 =over 4
2279
2280 =item Newlines
2281
2282 =item Numbers endianness and Width
2283
2284 =item Files and Filesystems
2285
2286 =item System Interaction
2287
2288 =item Interprocess Communication (IPC)
2289
2290 =item External Subroutines (XS)
2291
2292 =item Standard Modules
2293
2294 =item Time and Date
2295
2296 =item Character sets and character encoding
2297
2298 =item Internationalisation
2299
2300 =item System Resources
2301
2302 =item Security
2303
2304 =item Style
2305
2306 =back
2307
2308 =item CPAN Testers
2309
2310 Mailing list: cpan-testers@perl.org, Testing results:
2311 http://testers.cpan.org/
2312
2313 =item PLATFORMS
2314
2315 =over 4
2316
2317 =item Unix
2318
2319 =item DOS and Derivatives
2320
2321 =item S<Mac OS>
2322
2323 =item VMS
2324
2325 =item VOS
2326
2327 =item EBCDIC Platforms
2328
2329 =item Acorn RISC OS
2330
2331 =item Other perls
2332
2333 =back
2334
2335 =item FUNCTION IMPLEMENTATIONS
2336
2337 =over 4
2338
2339 =item Alphabetical Listing of Perl Functions
2340
2341 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2342 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2343 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2344 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2345 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2346 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2347 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2348 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2349 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
2350 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
2351 endhostent, endnetent, endprotoent, endservent, getsockopt
2352 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
2353 kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
2354 lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
2355 ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
2356 READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
2357 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
2358 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2359 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2360 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2361 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2362 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2363 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2364 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2365 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2366 wait, waitpid PID,FLAGS
2367
2368 =back
2369
2370 =item CHANGES
2371
2372 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2373 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2374 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2375 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2376 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2377 v1.30, 03 August 1998, v1.23, 10 July 1998
2378
2379 =item Supported Platforms
2380
2381 =item SEE ALSO
2382
2383 =item AUTHORS / CONTRIBUTORS
2384
2385 =item VERSION
2386
2387 =back
2388
2389 =head2 perllocale - Perl locale handling (internationalization and
2390 localization)
2391
2392 =over 4
2393
2394 =item DESCRIPTION
2395
2396 =item PREPARING TO USE LOCALES
2397
2398 =item USING LOCALES
2399
2400 =over 4
2401
2402 =item The use locale pragma
2403
2404 =item The setlocale function
2405
2406 =item Finding locales
2407
2408 =item LOCALE PROBLEMS
2409
2410 =item Temporarily fixing locale problems
2411
2412 =item Permanently fixing locale problems
2413
2414 =item Permanently fixing your system's locale configuration
2415
2416 =item Fixing system locale configuration
2417
2418 =item The localeconv function
2419
2420 =item I18N::Langinfo
2421
2422 =back
2423
2424 =item LOCALE CATEGORIES
2425
2426 =over 4
2427
2428 =item Category LC_COLLATE: Collation
2429
2430 =item Category LC_CTYPE: Character Types
2431
2432 =item Category LC_NUMERIC: Numeric Formatting
2433
2434 =item Category LC_MONETARY: Formatting of monetary amounts
2435
2436 =item LC_TIME
2437
2438 =item Other categories
2439
2440 =back
2441
2442 =item SECURITY
2443
2444 =item ENVIRONMENT
2445
2446 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2447 LC_NUMERIC, LC_TIME, LANG
2448
2449 =item NOTES
2450
2451 =over 4
2452
2453 =item Backward compatibility
2454
2455 =item I18N:Collate obsolete
2456
2457 =item Sort speed and memory use impacts
2458
2459 =item write() and LC_NUMERIC
2460
2461 =item Freely available locale definitions
2462
2463 =item I18n and l10n
2464
2465 =item An imperfect standard
2466
2467 =back
2468
2469 =item BUGS
2470
2471 =over 4
2472
2473 =item Broken systems
2474
2475 =back
2476
2477 =item SEE ALSO
2478
2479 =item HISTORY
2480
2481 =back
2482
2483 =head2 perluniintro - Perl Unicode introduction
2484
2485 =over 4
2486
2487 =item DESCRIPTION
2488
2489 =over 4
2490
2491 =item Unicode
2492
2493 =item Perl's Unicode Support
2494
2495 =item Perl's Unicode Model
2496
2497 =item Creating Unicode
2498
2499 =item Handling Unicode
2500
2501 =item Legacy Encodings
2502
2503 =item Unicode I/O
2504
2505 =item Displaying Unicode As Text
2506
2507 =item Special Cases
2508
2509 =item Advanced Topics
2510
2511 =item Miscellaneous
2512
2513 =item Questions With Answers
2514
2515 , , , , , , 
2516
2517 =item Hexadecimal Notation
2518
2519 =item Further Resources
2520
2521 =back
2522
2523 =item UNICODE IN OLDER PERLS
2524
2525 =item SEE ALSO
2526
2527 =item ACKNOWLEDGEMENTS
2528
2529 =item AUTHOR, COPYRIGHT, AND LICENSE
2530
2531 =back
2532
2533 =head2 perlunicode - Unicode support in Perl
2534
2535 =over 4
2536
2537 =item DESCRIPTION
2538
2539 =over 4
2540
2541 =item Important Caveats
2542
2543 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2544 to enable UTF-8/UTF-EBCDIC in scripts
2545
2546 =item Byte and Character semantics
2547
2548 =item Effects of character semantics
2549
2550 =item Scripts
2551
2552 =item Blocks
2553
2554 =item Character encodings for input and output
2555
2556 =back
2557
2558 =item CAVEATS
2559
2560 =item UNICODE REGULAR EXPRESSION SUPPORT LEVEL
2561
2562 =over 4
2563
2564 =item Unicode Encodings
2565
2566 =item Security Implications of Malformed UTF-8
2567
2568 =item Unicode in Perl on EBCDIC
2569
2570 =item Using Unicode in XS
2571
2572 =back
2573
2574 =item SEE ALSO
2575
2576 =back
2577
2578 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2579
2580 =over 4
2581
2582 =item DESCRIPTION
2583
2584 =item COMMON CHARACTER CODE SETS
2585
2586 =over 4
2587
2588 =item ASCII
2589
2590 =item ISO 8859
2591
2592 =item Latin 1 (ISO 8859-1)
2593
2594 =item EBCDIC
2595
2596 =item 13 variant characters
2597
2598 =item 0037
2599
2600 =item 1047
2601
2602 =item POSIX-BC
2603
2604 =item Unicode and UTF
2605
2606 =item Using Encode
2607
2608 =back
2609
2610 =item SINGLE OCTET TABLES
2611
2612 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2613
2614 =item IDENTIFYING CHARACTER CODE SETS
2615
2616 =item CONVERSIONS
2617
2618 =over 4
2619
2620 =item tr///
2621
2622 =item iconv
2623
2624 =item C RTL
2625
2626 =back
2627
2628 =item OPERATOR DIFFERENCES
2629
2630 =item FUNCTION DIFFERENCES
2631
2632 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2633
2634 =item REGULAR EXPRESSION DIFFERENCES
2635
2636 =item SOCKETS
2637
2638 =item SORTING
2639
2640 =over 4
2641
2642 =item Ignore ASCII vs. EBCDIC sort differences.
2643
2644 =item MONO CASE then sort data.
2645
2646 =item Convert, sort data, then re convert.
2647
2648 =item Perform sorting on one type of machine only.
2649
2650 =back
2651
2652 =item TRANSFORMATION FORMATS
2653
2654 =over 4
2655
2656 =item URL decoding and encoding
2657
2658 =item uu encoding and decoding
2659
2660 =item Quoted-Printable encoding and decoding
2661
2662 =item Caesarian ciphers
2663
2664 =back
2665
2666 =item Hashing order and checksums
2667
2668 =item I18N AND L10N
2669
2670 =item MULTI OCTET CHARACTER SETS
2671
2672 =item OS ISSUES
2673
2674 =over 4
2675
2676 =item OS/400 
2677
2678 IFS access
2679
2680 =item OS/390, z/OS
2681
2682 chcp, dataset access, OS/390, z/OS iconv, locales
2683
2684 =item VM/ESA?
2685
2686 =item POSIX-BC?
2687
2688 =back
2689
2690 =item BUGS
2691
2692 =item SEE ALSO
2693
2694 =item REFERENCES
2695
2696 =item HISTORY
2697
2698 =item AUTHOR
2699
2700 =back
2701
2702 =head2 perlsec - Perl security
2703
2704 =over 4
2705
2706 =item DESCRIPTION
2707
2708 =over 4
2709
2710 =item Laundering and Detecting Tainted Data
2711
2712 =item Switches On the "#!" Line
2713
2714 =item Cleaning Up Your Path
2715
2716 =item Security Bugs
2717
2718 =item Protecting Your Programs
2719
2720 =back
2721
2722 =item SEE ALSO
2723
2724 =back
2725
2726 =head2 perlmod - Perl modules (packages and symbol tables)
2727
2728 =over 4
2729
2730 =item DESCRIPTION
2731
2732 =over 4
2733
2734 =item Packages
2735
2736 =item Symbol Tables
2737
2738 =item Package Constructors and Destructors
2739
2740 =item Perl Classes
2741
2742 =item Perl Modules
2743
2744 =item Making your module threadsafe
2745
2746 =back
2747
2748 =item SEE ALSO
2749
2750 =back
2751
2752 =head2 perlmodinstall - Installing CPAN Modules
2753
2754 =over 4
2755
2756 =item DESCRIPTION
2757
2758 =over 4
2759
2760 =item PREAMBLE
2761
2762 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2763 module (sometimes unnecessary), B<INSTALL> the module
2764
2765 =back
2766
2767 =item PORTABILITY
2768
2769 =item HEY
2770
2771 =item AUTHOR
2772
2773 =item COPYRIGHT
2774
2775 =back
2776
2777 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2778
2779 =over 4
2780
2781 =item DESCRIPTION
2782
2783 =item THE PERL MODULE LIBRARY
2784
2785 =over 4
2786
2787 =item Pragmatic Modules
2788
2789 attributes, autouse, base, blib, bytes, charnames, constant, diagnostics,
2790 encoding, fields, filetest, integer, less, locale, open, overload, sigtrap,
2791 sort, strict, subs, utf8, vars, vmsish, warnings, warnings::register
2792
2793 =item Standard Modules
2794
2795 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, Benchmark, CGI,
2796 CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
2797 CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Nox, Carp,
2798 Carp::Heavy, Class::ISA, Class::Struct, Cwd, DB, Devel::SelfStubber,
2799 Digest, DirHandle, Dumpvalue, English, Env, Exporter, Exporter::Heavy,
2800 ExtUtils::Command, ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
2801 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM_Cygwin,
2802 ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
2803 ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest,
2804 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2805 ExtUtils::testlib, Fatal, File::Basename, File::CheckTree, File::Compare,
2806 File::Copy, File::DosGlob, File::Find, File::Path, File::Spec,
2807 File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2808 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2809 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2810 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate,
2811 I18N::LangTags, I18N::LangTags::List, IPC::Open2, IPC::Open3,
2812 Locale::Constants, Locale::Country, Locale::Currency, Locale::Language,
2813 Locale::Maketext, Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt,
2814 Math::BigInt::Calc, Math::Complex, Math::Trig, Memoize,
2815 Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile,
2816 Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File,
2817 Memoize::Storable, NEXT, Net::Cmd, Net::Config, Net::Domain, Net::FTP,
2818 Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, Net::SMTP, Net::Time,
2819 Net::hostent, Net::libnetFAQ, Net::netent, Net::protoent, Net::servent,
2820 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2821 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2822 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2823 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, Pod::t::basic,
2824 Search::Dict, SelectSaver, SelfLoader, Shell, Switch, Symbol,
2825 Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
2826 Test::Builder, Test::Harness, Test::More, Test::Simple, Test::Tutorial,
2827 Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs,
2828 Text::Wrap, Thread, Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash,
2829 Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime,
2830 Time::tm, UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent,
2831 User::pwent, Win32
2832
2833 =item Extension Modules
2834
2835 =back
2836
2837 =item CPAN
2838
2839 =over 4
2840
2841 =item Africa
2842
2843 =item Asia
2844
2845 =item Central America
2846
2847 =item Europe
2848
2849 =item North America
2850
2851 =item Oceania
2852
2853 =item South America
2854
2855 =back
2856
2857 =item Modules: Creation, Use, and Abuse
2858
2859 =over 4
2860
2861 =item Guidelines for Module Creation
2862
2863 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2864
2865 =item Guidelines for Reusing Application Code
2866
2867 =back
2868
2869 =item NOTE
2870
2871 =back
2872
2873 =head2 perlmodstyle - Perl module style guide
2874
2875 =over 4
2876
2877 =item INTRODUCTION
2878
2879 =item QUICK CHECKLIST
2880
2881 =over 4
2882
2883 =item Before you start
2884
2885 =item The API
2886
2887 =item Stability
2888
2889 =item Documentation
2890
2891 =item Release considerations
2892
2893 =back
2894
2895 =item BEFORE YOU START WRITING A MODULE
2896
2897 =over 4
2898
2899 =item Has it been done before?
2900
2901 =item Do one thing and do it well
2902
2903 =item What's in a name?
2904
2905 =back
2906
2907 =item DESIGNING AND WRITING YOUR MODULE
2908
2909 =over 4
2910
2911 =item To OO or not to OO?
2912
2913 =item Designing your API
2914
2915 Write simple routines to do simple things, Separate functionality from
2916 output, Provide sensible shortcuts and defaults, Naming conventions,
2917 Parameter passing
2918
2919 =item Strictness and warnings
2920
2921 =item Backwards compatibility
2922
2923 =item Error handling and messages
2924
2925 =back
2926
2927 =item DOCUMENTING YOUR MODULE
2928
2929 =over 4
2930
2931 =item POD
2932
2933 =item README, INSTALL, release notes, changelogs
2934
2935 =back
2936
2937 =item RELEASE CONSIDERATIONS
2938
2939 =over 4
2940
2941 =item Version numbering
2942
2943 =item Pre-requisites
2944
2945 =item Testing
2946
2947 =item Packaging
2948
2949 =item Licensing
2950
2951 =back
2952
2953 =item COMMON PITFALLS
2954
2955 =over 4
2956
2957 =item Reinventing the wheel
2958
2959 =item Trying to do too much
2960
2961 =item Inappropriate documentation
2962
2963 =back
2964
2965 =item SEE ALSO
2966
2967 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2968 http://pause.perl.org/, Any good book on software engineering
2969
2970 =item AUTHOR
2971
2972 =back
2973
2974 =head2 perlnewmod - preparing a new module for distribution
2975
2976 =over 4
2977
2978 =item DESCRIPTION
2979
2980 =over 4
2981
2982 =item Warning
2983
2984 =item What should I make into a module?
2985
2986 =item Step-by-step: Preparing the ground
2987
2988 Look around, Check it's new, Discuss the need, Choose a name, Check again
2989
2990 =item Step-by-step: Making the module
2991
2992 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2993 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2994 documentation|perlpod>, Write tests, Write the README
2995
2996 =item Step-by-step: Distributing your module
2997
2998 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2999 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3000
3001 =back
3002
3003 =item AUTHOR
3004
3005 =item SEE ALSO
3006
3007 =back
3008
3009 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.6 $, $Date:
3010 2002/01/31 01:46:23 $)
3011
3012 =over 4
3013
3014 =item DESCRIPTION
3015
3016 =over 4
3017
3018 =item What is Perl?
3019
3020 =item Who supports Perl?  Who develops it?  Why is it free?
3021
3022 =item Which version of Perl should I use?
3023
3024 =item What are perl4 and perl5?
3025
3026 =item What is perl6?
3027
3028 =item How stable is Perl?
3029
3030 =item Is Perl difficult to learn?
3031
3032 =item How does Perl compare with other languages like Java, Python, REXX,
3033 Scheme, or Tcl?
3034
3035 =item Can I do [task] in Perl?
3036
3037 =item When shouldn't I program in Perl?
3038
3039 =item What's the difference between "perl" and "Perl"?
3040
3041 =item Is it a Perl program or a Perl script?
3042
3043 =item What is a JAPH?
3044
3045 =item Where can I get a list of Larry Wall witticisms?
3046
3047 =item How can I convince my sysadmin/supervisor/employees to use version
3048 5/5.6.1/Perl instead of some other language?
3049
3050 =back
3051
3052 =item AUTHOR AND COPYRIGHT
3053
3054 =back
3055
3056 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.8 $,
3057 $Date: 2002/02/08 22:31:57 $)
3058
3059 =over 4
3060
3061 =item DESCRIPTION
3062
3063 =over 4
3064
3065 =item What machines support Perl?  Where do I get it?
3066
3067 =item How can I get a binary version of Perl?
3068
3069 =item I don't have a C compiler on my system.  How can I compile perl?
3070
3071 =item I copied the Perl binary from one machine to another, but scripts
3072 don't work.
3073
3074 =item I grabbed the sources and tried to compile but gdbm/dynamic
3075 loading/malloc/linking/... failed.  How do I make it work?
3076
3077 =item What modules and extensions are available for Perl?  What is CPAN? 
3078 What does CPAN/src/... mean?
3079
3080 =item Is there an ISO or ANSI certified version of Perl?
3081
3082 =item Where can I get information on Perl?
3083
3084 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
3085
3086 =item Where should I post source code?
3087
3088 =item Perl Books
3089
3090 References, Tutorials, Task-Oriented, Special Topics
3091
3092 =item Perl in Magazines
3093
3094 =item Perl on the Net: FTP and WWW Access
3095
3096 =item What mailing lists are there for Perl?
3097
3098 =item Archives of comp.lang.perl.misc
3099
3100 =item Where can I buy a commercial version of Perl?
3101
3102 =item Where do I send bug reports?
3103
3104 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
3105
3106 =back
3107
3108 =item AUTHOR AND COPYRIGHT
3109
3110 =back
3111
3112 =head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11
3113 19:29:52 $)
3114
3115 =over 4
3116
3117 =item DESCRIPTION
3118
3119 =over 4
3120
3121 =item How do I do (anything)?
3122
3123 =item How can I use Perl interactively?
3124
3125 =item Is there a Perl shell?
3126
3127 =item How do I debug my Perl programs?
3128
3129 =item How do I profile my Perl programs?
3130
3131 =item How do I cross-reference my Perl programs?
3132
3133 =item Is there a pretty-printer (formatter) for Perl?
3134
3135 =item Is there a ctags for Perl?
3136
3137 =item Is there an IDE or Windows Perl Editor?
3138
3139 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+,
3140 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
3141 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3142
3143 =item Where can I get Perl macros for vi?
3144
3145 =item Where can I get perl-mode for emacs?
3146
3147 =item How can I use curses with Perl?
3148
3149 =item How can I use X or Tk with Perl?
3150
3151 =item How can I generate simple menus without using CGI or Tk?
3152
3153 =item How can I make my Perl program run faster?
3154
3155 =item How can I make my Perl program take less memory?
3156
3157 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3158 stringification, Pass by reference, Tie large variables to disk
3159
3160 =item Is it unsafe to return a pointer to local data?
3161
3162 =item How can I free an array or hash so my program shrinks?
3163
3164 =item How can I make my CGI script more efficient?
3165
3166 =item How can I hide the source for my Perl program?
3167
3168 =item How can I compile my Perl program into byte code or C?
3169
3170 =item How can I compile Perl into Java?
3171
3172 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3173
3174 =item Can I write useful Perl programs on the command line?
3175
3176 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3177
3178 =item Where can I learn about CGI or Web programming in Perl?
3179
3180 =item Where can I learn about object-oriented Perl programming?
3181
3182 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3183
3184 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3185 my C program; what am I doing wrong?
3186
3187 =item When I tried to run my script, I got this message. What does it mean?
3188
3189 =item What's MakeMaker?
3190
3191 =back
3192
3193 =item AUTHOR AND COPYRIGHT
3194
3195 =back
3196
3197 =head2 perlfaq4 - Data Manipulation ($Revision: 1.14 $, $Date: 2002/02/08
3198 22:30:23 $)
3199
3200 =over 4
3201
3202 =item DESCRIPTION
3203
3204 =item Data: Numbers
3205
3206 =over 4
3207
3208 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3209 numbers I should be getting (eg, 19.95)?
3210
3211 =item Why isn't my octal data interpreted correctly?
3212
3213 =item Does Perl have a round() function?  What about ceil() and floor()? 
3214 Trig functions?
3215
3216 =item How do I convert between numeric representations?
3217
3218 B<How do I convert Hexadecimal into decimal:>, B<How do I convert from
3219 decimal to hexadecimal:>, B<How do I convert from octal to decimal:>, B<How
3220 do I convert from decimal to octal:>, B<How do I convert from binary to
3221 decimal:>, B<How do I convert from decimal to binary:>
3222
3223 =item Why doesn't & work the way I want it to?
3224
3225 =item How do I multiply matrices?
3226
3227 =item How do I perform an operation on a series of integers?
3228
3229 =item How can I output Roman numerals?
3230
3231 =item Why aren't my random numbers random?
3232
3233 =back
3234
3235 =item Data: Dates
3236
3237 =over 4
3238
3239 =item How do I find the week-of-the-year/day-of-the-year?
3240
3241 =item How do I find the current century or millennium?
3242
3243 =item How can I compare two dates and find the difference?
3244
3245 =item How can I take a string and turn it into epoch seconds?
3246
3247 =item How can I find the Julian Day?
3248
3249 =item How do I find yesterday's date?
3250
3251 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3252
3253 =back
3254
3255 =item Data: Strings
3256
3257 =over 4
3258
3259 =item How do I validate input?
3260
3261 =item How do I unescape a string?
3262
3263 =item How do I remove consecutive pairs of characters?
3264
3265 =item How do I expand function calls in a string?
3266
3267 =item How do I find matching/nesting anything?
3268
3269 =item How do I reverse a string?
3270
3271 =item How do I expand tabs in a string?
3272
3273 =item How do I reformat a paragraph?
3274
3275 =item How can I access/change the first N letters of a string?
3276
3277 =item How do I change the Nth occurrence of something?
3278
3279 =item How can I count the number of occurrences of a substring within a
3280 string?
3281
3282 =item How do I capitalize all the words on one line?
3283
3284 =item How can I split a [character] delimited string except when inside
3285 [character]? (Comma-separated files)
3286
3287 =item How do I strip blank space from the beginning/end of a string?
3288
3289 =item How do I pad a string with blanks or pad a number with zeroes?
3290
3291 =item How do I extract selected columns from a string?
3292
3293 =item How do I find the soundex value of a string?
3294
3295 =item How can I expand variables in text strings?
3296
3297 =item What's wrong with always quoting "$vars"?
3298
3299 =item Why don't my <<HERE documents work?
3300
3301 1. There must be no space after the << part, 2. There (probably) should be
3302 a semicolon at the end, 3. You can't (easily) have any space in front of
3303 the tag
3304
3305 =back
3306
3307 =item Data: Arrays
3308
3309 =over 4
3310
3311 =item What is the difference between a list and an array?
3312
3313 =item What is the difference between $array[1] and @array[1]?
3314
3315 =item How can I remove duplicate elements from a list or array?
3316
3317 a), b), c), d), e)
3318
3319 =item How can I tell whether a certain element is contained in a list or
3320 array?
3321
3322 =item How do I compute the difference of two arrays?  How do I compute the
3323 intersection of two arrays?
3324
3325 =item How do I test whether two arrays or hashes are equal?
3326
3327 =item How do I find the first array element for which a condition is true?
3328
3329 =item How do I handle linked lists?
3330
3331 =item How do I handle circular lists?
3332
3333 =item How do I shuffle an array randomly?
3334
3335 =item How do I process/modify each element of an array?
3336
3337 =item How do I select a random element from an array?
3338
3339 =item How do I permute N elements of a list?
3340
3341 =item How do I sort an array by (anything)?
3342
3343 =item How do I manipulate arrays of bits?
3344
3345 =item Why does defined() return true on empty arrays and hashes?
3346
3347 =back
3348
3349 =item Data: Hashes (Associative Arrays)
3350
3351 =over 4
3352
3353 =item How do I process an entire hash?
3354
3355 =item What happens if I add or remove keys from a hash while iterating over
3356 it?
3357
3358 =item How do I look up a hash element by value?
3359
3360 =item How can I know how many entries are in a hash?
3361
3362 =item How do I sort a hash (optionally by value instead of key)?
3363
3364 =item How can I always keep my hash sorted?
3365
3366 =item What's the difference between "delete" and "undef" with hashes?
3367
3368 =item Why don't my tied hashes make the defined/exists distinction?
3369
3370 =item How do I reset an each() operation part-way through?
3371
3372 =item How can I get the unique keys from two hashes?
3373
3374 =item How can I store a multidimensional array in a DBM file?
3375
3376 =item How can I make my hash remember the order I put elements into it?
3377
3378 =item Why does passing a subroutine an undefined element in a hash create
3379 it?
3380
3381 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3382 array of hashes or arrays?
3383
3384 =item How can I use a reference as a hash key?
3385
3386 =back
3387
3388 =item Data: Misc
3389
3390 =over 4
3391
3392 =item How do I handle binary data correctly?
3393
3394 =item How do I determine whether a scalar is a number/whole/integer/float?
3395
3396 =item How do I keep persistent data across program calls?
3397
3398 =item How do I print out or copy a recursive data structure?
3399
3400 =item How do I define methods for every class/object?
3401
3402 =item How do I verify a credit card checksum?
3403
3404 =item How do I pack arrays of doubles or floats for XS code?
3405
3406 =back
3407
3408 =item AUTHOR AND COPYRIGHT
3409
3410 =back
3411
3412 =head2 perlfaq5 - Files and Formats ($Revision: 1.9 $, $Date: 2002/02/11
3413 19:30:21 $)
3414
3415 =over 4
3416
3417 =item DESCRIPTION
3418
3419 =over 4
3420
3421 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3422
3423 =item How do I change one line in a file/delete a line in a file/insert a
3424 line in the middle of a file/append to the beginning of a file?
3425
3426 =item How do I count the number of lines in a file?
3427
3428 =item How do I make a temporary file name?
3429
3430 =item How can I manipulate fixed-record-length files?
3431
3432 =item How can I make a filehandle local to a subroutine?  How do I pass
3433 filehandles between subroutines?  How do I make an array of filehandles?
3434
3435 =item How can I use a filehandle indirectly?
3436
3437 =item How can I set up a footer format to be used with write()?
3438
3439 =item How can I write() into a string?
3440
3441 =item How can I output my numbers with commas added?
3442
3443 =item How can I translate tildes (~) in a filename?
3444
3445 =item How come when I open a file read-write it wipes it out?
3446
3447 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3448
3449 =item Is there a leak/bug in glob()?
3450
3451 =item How can I open a file with a leading ">" or trailing blanks?
3452
3453 =item How can I reliably rename a file?
3454
3455 =item How can I lock a file?
3456
3457 =item Why can't I just open(FH, ">file.lock")?
3458
3459 =item I still don't get locking.  I just want to increment the number in
3460 the file.  How can I do this?
3461
3462 =item All I want to do is append a small amount of text to the end of a
3463 file.  Do I still have to use locking?
3464
3465 =item How do I randomly update a binary file?
3466
3467 =item How do I get a file's timestamp in perl?
3468
3469 =item How do I set a file's timestamp in perl?
3470
3471 =item How do I print to more than one file at once?
3472
3473 =item How can I read in an entire file all at once?
3474
3475 =item How can I read in a file by paragraphs?
3476
3477 =item How can I read a single character from a file?  From the keyboard?
3478
3479 =item How can I tell whether there's a character waiting on a filehandle?
3480
3481 =item How do I do a C<tail -f> in perl?
3482
3483 =item How do I dup() a filehandle in Perl?
3484
3485 =item How do I close a file descriptor by number?
3486
3487 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
3488 `C:\temp\foo.exe` work?
3489
3490 =item Why doesn't glob("*.*") get all the files?
3491
3492 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3493 protected files?  Isn't this a bug in Perl?
3494
3495 =item How do I select a random line from a file?
3496
3497 =item Why do I get weird spaces when I print an array of lines?
3498
3499 =back
3500
3501 =item AUTHOR AND COPYRIGHT
3502
3503 =back
3504
3505 =head2 perlfaq6 - Regular Expressions ($Revision: 1.8 $, $Date: 2002/01/31
3506 04:27:55 $)
3507
3508 =over 4
3509
3510 =item DESCRIPTION
3511
3512 =over 4
3513
3514 =item How can I hope to use regular expressions without creating illegible
3515 and unmaintainable code?
3516
3517 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3518
3519 =item I'm having trouble matching over more than one line.  What's wrong?
3520
3521 =item How can I pull out lines between two patterns that are themselves on
3522 different lines?
3523
3524 =item I put a regular expression into $/ but it didn't work. What's wrong?
3525
3526 =item How do I substitute case insensitively on the LHS while preserving
3527 case on the RHS?
3528
3529 =item How can I make C<\w> match national character sets?
3530
3531 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3532
3533 =item How can I quote a variable to use in a regex?
3534
3535 =item What is C</o> really for?
3536
3537 =item How do I use a regular expression to strip C style comments from a
3538 file?
3539
3540 =item Can I use Perl regular expressions to match balanced text?
3541
3542 =item What does it mean that regexes are greedy?  How can I get around it?
3543
3544 =item How do I process each word on each line?
3545
3546 =item How can I print out a word-frequency or line-frequency summary?
3547
3548 =item How can I do approximate matching?
3549
3550 =item How do I efficiently match many regular expressions at once?
3551
3552 =item Why don't word-boundary searches with C<\b> work for me?
3553
3554 =item Why does using $&, $`, or $' slow my program down?
3555
3556 =item What good is C<\G> in a regular expression?
3557
3558 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3559
3560 =item What's wrong with using grep or map in a void context?
3561
3562 =item How can I match strings with multibyte characters?
3563
3564 =item How do I match a pattern that is supplied by the user?
3565
3566 =back
3567
3568 =item AUTHOR AND COPYRIGHT
3569
3570 =back
3571
3572 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date:
3573 2002/01/31 04:27:55 $)
3574
3575 =over 4
3576
3577 =item DESCRIPTION
3578
3579 =over 4
3580
3581 =item Can I get a BNF/yacc/RE for the Perl language?
3582
3583 =item What are all these $@%&* punctuation signs, and how do I know when to
3584 use them?
3585
3586 =item Do I always/never have to quote my strings or use semicolons and
3587 commas?
3588
3589 =item How do I skip some return values?
3590
3591 =item How do I temporarily block warnings?
3592
3593 =item What's an extension?
3594
3595 =item Why do Perl operators have different precedence than C operators?
3596
3597 =item How do I declare/create a structure?
3598
3599 =item How do I create a module?
3600
3601 =item How do I create a class?
3602
3603 =item How can I tell if a variable is tainted?
3604
3605 =item What's a closure?
3606
3607 =item What is variable suicide and how can I prevent it?
3608
3609 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3610 Regex}?
3611
3612 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3613 Passing Methods
3614
3615 =item How do I create a static variable?
3616
3617 =item What's the difference between dynamic and lexical (static) scoping? 
3618 Between local() and my()?
3619
3620 =item How can I access a dynamic variable while a similarly named lexical
3621 is in scope?
3622
3623 =item What's the difference between deep and shallow binding?
3624
3625 =item Why doesn't "my($foo) = <FILE>;" work right?
3626
3627 =item How do I redefine a builtin function, operator, or method?
3628
3629 =item What's the difference between calling a function as &foo and foo()?
3630
3631 =item How do I create a switch or case statement?
3632
3633 =item How can I catch accesses to undefined variables/functions/methods?
3634
3635 =item Why can't a method included in this same file be found?
3636
3637 =item How can I find out my current package?
3638
3639 =item How can I comment out a large block of perl code?
3640
3641 =item How do I clear a package?
3642
3643 =item How can I use a variable as a variable name?
3644
3645 =back
3646
3647 =item AUTHOR AND COPYRIGHT
3648
3649 =back
3650
3651 =head2 perlfaq8 - System Interaction ($Revision: 1.6 $, $Date: 2002/01/28
3652 04:17:27 $)
3653
3654 =over 4
3655
3656 =item DESCRIPTION
3657
3658 =over 4
3659
3660 =item How do I find out which operating system I'm running under?
3661
3662 =item How come exec() doesn't return?
3663
3664 =item How do I do fancy stuff with the keyboard/screen/mouse?
3665
3666 Keyboard, Screen, Mouse
3667
3668 =item How do I print something out in color?
3669
3670 =item How do I read just one key without waiting for a return key?
3671
3672 =item How do I check whether input is ready on the keyboard?
3673
3674 =item How do I clear the screen?
3675
3676 =item How do I get the screen size?
3677
3678 =item How do I ask the user for a password?
3679
3680 =item How do I read and write the serial port?
3681
3682 lockfiles, open mode, end of line, flushing output, non-blocking input
3683
3684 =item How do I decode encrypted password files?
3685
3686 =item How do I start a process in the background?
3687
3688 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3689
3690 =item How do I trap control characters/signals?
3691
3692 =item How do I modify the shadow password file on a Unix system?
3693
3694 =item How do I set the time and date?
3695
3696 =item How can I sleep() or alarm() for under a second?
3697
3698 =item How can I measure time under a second?
3699
3700 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3701
3702 =item Why doesn't my sockets program work under System V (Solaris)?  What
3703 does the error message "Protocol not supported" mean?
3704
3705 =item How can I call my system's unique C functions from Perl?
3706
3707 =item Where do I get the include files to do ioctl() or syscall()?
3708
3709 =item Why do setuid perl scripts complain about kernel problems?
3710
3711 =item How can I open a pipe both to and from a command?
3712
3713 =item Why can't I get the output of a command with system()?
3714
3715 =item How can I capture STDERR from an external command?
3716
3717 =item Why doesn't open() return an error when a pipe open fails?
3718
3719 =item What's wrong with using backticks in a void context?
3720
3721 =item How can I call backticks without shell processing?
3722
3723 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3724 ^Z on MS-DOS)?
3725
3726 =item How can I convert my shell script to perl?
3727
3728 =item Can I use perl to run a telnet or ftp session?
3729
3730 =item How can I write expect in Perl?
3731
3732 =item Is there a way to hide perl's command line from programs such as
3733 "ps"?
3734
3735 =item I {changed directory, modified my environment} in a perl script.  How
3736 come the change disappeared when I exited the script?  How do I get my
3737 changes to be visible?
3738
3739 Unix
3740
3741 =item How do I close a process's filehandle without waiting for it to
3742 complete?
3743
3744 =item How do I fork a daemon process?
3745
3746 =item How do I find out if I'm running interactively or not?
3747
3748 =item How do I timeout a slow event?
3749
3750 =item How do I set CPU limits?
3751
3752 =item How do I avoid zombies on a Unix system?
3753
3754 =item How do I use an SQL database?
3755
3756 =item How do I make a system() exit on control-C?
3757
3758 =item How do I open a file without blocking?
3759
3760 =item How do I install a module from CPAN?
3761
3762 =item What's the difference between require and use?
3763
3764 =item How do I keep my own module/library directory?
3765
3766 =item How do I add the directory my program lives in to the module/library
3767 search path?
3768
3769 =item How do I add a directory to my include path at runtime?
3770
3771 =item What is socket.ph and where do I get it?
3772
3773 =back
3774
3775 =item AUTHOR AND COPYRIGHT
3776
3777 =back
3778
3779 =head2 perlfaq9 - Networking ($Revision: 1.7 $, $Date: 2002/01/28 04:17:27
3780 $)
3781
3782 =over 4
3783
3784 =item DESCRIPTION
3785
3786 =over 4
3787
3788 =item What is the correct form of response from a CGI script?
3789
3790 =item My CGI script runs from the command line but not the browser.  (500
3791 Server Error)
3792
3793 =item How can I get better error messages from a CGI program?
3794
3795 =item How do I remove HTML from a string?
3796
3797 =item How do I extract URLs?
3798
3799 =item How do I download a file from the user's machine?  How do I open a
3800 file on another machine?
3801
3802 =item How do I make a pop-up menu in HTML?
3803
3804 =item How do I fetch an HTML file?
3805
3806 =item How do I automate an HTML form submission?
3807
3808 =item How do I decode or create those %-encodings on the web?
3809
3810 =item How do I redirect to another page?
3811
3812 =item How do I put a password on my web pages?
3813
3814 =item How do I edit my .htpasswd and .htgroup files with Perl?
3815
3816 =item How do I make sure users can't enter values into a form that cause my
3817 CGI script to do bad things?
3818
3819 =item How do I parse a mail header?
3820
3821 =item How do I decode a CGI form?
3822
3823 =item How do I check a valid mail address?
3824
3825 =item How do I decode a MIME/BASE64 string?
3826
3827 =item How do I return the user's mail address?
3828
3829 =item How do I send mail?
3830
3831 =item How do I use MIME to make an attachment to a mail message?
3832
3833 =item How do I read mail?
3834
3835 =item How do I find out my hostname/domainname/IP address?
3836
3837 =item How do I fetch a news article or the active newsgroups?
3838
3839 =item How do I fetch/put an FTP file?
3840
3841 =item How can I do RPC in Perl?
3842
3843 =back
3844
3845 =item AUTHOR AND COPYRIGHT
3846
3847 =back
3848
3849 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3850
3851 =over 4
3852
3853 =item DESCRIPTION
3854
3855 =over 4
3856
3857 =item Layout
3858
3859 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3860
3861 =back
3862
3863 =item Using The Back Ends
3864
3865 =over 4
3866
3867 =item The Cross Referencing Back End
3868
3869 i, &, s, r
3870
3871 =item The Decompiling Back End
3872
3873 =item The Lint Back End
3874
3875 =item The Simple C Back End
3876
3877 =item The Bytecode Back End
3878
3879 =item The Optimized C Back End
3880
3881 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3882 B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj,
3883 B::Stash, B::Terse, B::Xref
3884
3885 =back
3886
3887 =item KNOWN PROBLEMS
3888
3889 =item AUTHOR
3890
3891 =back
3892
3893 =head2 perlembed - how to embed perl in your C program
3894
3895 =over 4
3896
3897 =item DESCRIPTION
3898
3899 =over 4
3900
3901 =item PREAMBLE
3902
3903 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3904 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3905
3906 =item ROADMAP
3907
3908 =item Compiling your C program
3909
3910 =item Adding a Perl interpreter to your C program
3911
3912 =item Calling a Perl subroutine from your C program
3913
3914 =item Evaluating a Perl statement from your C program
3915
3916 =item Performing Perl pattern matches and substitutions from your C program
3917
3918 =item Fiddling with the Perl stack from your C program
3919
3920 =item Maintaining a persistent interpreter
3921
3922 =item Execution of END blocks
3923
3924 =item Maintaining multiple interpreter instances
3925
3926 =item Using Perl modules, which themselves use C libraries, from your C
3927 program
3928
3929 =back
3930
3931 =item Embedding Perl under Win32
3932
3933 =item MORAL
3934
3935 =item AUTHOR
3936
3937 =item COPYRIGHT
3938
3939 =back
3940
3941 =head2 perldebguts - Guts of Perl debugging 
3942
3943 =over 4
3944
3945 =item DESCRIPTION
3946
3947 =item Debugger Internals
3948
3949 =over 4
3950
3951 =item Writing Your Own Debugger
3952
3953 =back
3954
3955 =item Frame Listing Output Examples
3956
3957 =item Debugging regular expressions
3958
3959 =over 4
3960
3961 =item Compile-time output
3962
3963 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3964 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3965 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3966 C<anchored(TYPE)>
3967
3968 =item Types of nodes
3969
3970 =item Run-time output
3971
3972 =back
3973
3974 =item Debugging Perl memory usage
3975
3976 =over 4
3977
3978 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3979
3980 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3981 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3982 6144>
3983
3984 =item Example of using B<-DL> switch
3985
3986 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3987
3988 =item B<-DL> details
3989
3990 C<!!!>, C<!!>, C<!>
3991
3992 =item Limitations of B<-DL> statistics
3993
3994 =back
3995
3996 =item SEE ALSO
3997
3998 =back
3999
4000 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4001
4002 =over 4
4003
4004 =item DESCRIPTION
4005
4006 =item SPECIAL NOTES
4007
4008 =over 4
4009
4010 =item make
4011
4012 =item Version caveat
4013
4014 =item Dynamic Loading versus Static Loading
4015
4016 =back
4017
4018 =item TUTORIAL
4019
4020 =over 4
4021
4022 =item EXAMPLE 1
4023
4024 =item EXAMPLE 2
4025
4026 =item What has gone on?
4027
4028 =item Writing good test scripts
4029
4030 =item EXAMPLE 3
4031
4032 =item What's new here?
4033
4034 =item Input and Output Parameters
4035
4036 =item The XSUBPP Program
4037
4038 =item The TYPEMAP file
4039
4040 =item Warning about Output Arguments
4041
4042 =item EXAMPLE 4
4043
4044 =item What has happened here?
4045
4046 =item Anatomy of .xs file
4047
4048 =item Getting the fat out of XSUBs
4049
4050 =item More about XSUB arguments
4051
4052 =item The Argument Stack
4053
4054 =item Extending your Extension
4055
4056 =item Documenting your Extension
4057
4058 =item Installing your Extension
4059
4060 =item EXAMPLE 5
4061
4062 =item New Things in this Example
4063
4064 =item EXAMPLE 6
4065
4066 =item New Things in this Example
4067
4068 =item EXAMPLE 7 (Coming Soon)
4069
4070 =item EXAMPLE 8 (Coming Soon)
4071
4072 =item EXAMPLE 9 (Coming Soon)
4073
4074 =item Troubleshooting these Examples
4075
4076 =back
4077
4078 =item See also
4079
4080 =item Author
4081
4082 =over 4
4083
4084 =item Last Changed
4085
4086 =back
4087
4088 =back
4089
4090 =head2 perlxs - XS language reference manual
4091
4092 =over 4
4093
4094 =item DESCRIPTION
4095
4096 =over 4
4097
4098 =item Introduction
4099
4100 =item On The Road
4101
4102 =item The Anatomy of an XSUB
4103
4104 =item The Argument Stack
4105
4106 =item The RETVAL Variable
4107
4108 =item The MODULE Keyword
4109
4110 =item The PACKAGE Keyword
4111
4112 =item The PREFIX Keyword
4113
4114 =item The OUTPUT: Keyword
4115
4116 =item The NO_OUTPUT Keyword
4117
4118 =item The CODE: Keyword
4119
4120 =item The INIT: Keyword
4121
4122 =item The NO_INIT Keyword
4123
4124 =item Initializing Function Parameters
4125
4126 =item Default Parameter Values
4127
4128 =item The PREINIT: Keyword
4129
4130 =item The SCOPE: Keyword
4131
4132 =item The INPUT: Keyword
4133
4134 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4135
4136 =item The C<length(NAME)> Keyword
4137
4138 =item Variable-length Parameter Lists
4139
4140 =item The C_ARGS: Keyword
4141
4142 =item The PPCODE: Keyword
4143
4144 =item Returning Undef And Empty Lists
4145
4146 =item The REQUIRE: Keyword
4147
4148 =item The CLEANUP: Keyword
4149
4150 =item The POSTCALL: Keyword
4151
4152 =item The BOOT: Keyword
4153
4154 =item The VERSIONCHECK: Keyword
4155
4156 =item The PROTOTYPES: Keyword
4157
4158 =item The PROTOTYPE: Keyword
4159
4160 =item The ALIAS: Keyword
4161
4162 =item The INTERFACE: Keyword
4163
4164 =item The INTERFACE_MACRO: Keyword
4165
4166 =item The INCLUDE: Keyword
4167
4168 =item The CASE: Keyword
4169
4170 =item The & Unary Operator
4171
4172 =item Inserting POD, Comments and C Preprocessor Directives
4173
4174 =item Using XS With C++
4175
4176 =item Interface Strategy
4177
4178 =item Perl Objects And C Structures
4179
4180 =item The Typemap
4181
4182 =item Safely Storing Static Data in XS
4183
4184 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4185
4186 =back
4187
4188 =item EXAMPLES
4189
4190 =item XS VERSION
4191
4192 =item AUTHOR
4193
4194 =back
4195
4196 =head2 perlclib - Internal replacements for standard C library functions
4197
4198 =over 4
4199
4200 =item DESCRIPTION
4201
4202 =over 4
4203
4204 =item Conventions
4205
4206 C<t>, C<p>, C<n>, C<s>
4207
4208 =item File Operations
4209
4210 =item File Input and Output
4211
4212 =item File Positioning
4213
4214 =item Memory Management and String Handling
4215
4216 =item Character Class Tests
4217
4218 =item F<stdlib.h> functions
4219
4220 =item Miscellaneous functions
4221
4222 =back
4223
4224 =item SEE ALSO
4225
4226 =back
4227
4228 =head2 perlguts - Introduction to the Perl API
4229
4230 =over 4
4231
4232 =item DESCRIPTION
4233
4234 =item Variables
4235
4236 =over 4
4237
4238 =item Datatypes
4239
4240 =item What is an "IV"?
4241
4242 =item Working with SVs
4243
4244 =item Offsets
4245
4246 =item What's Really Stored in an SV?
4247
4248 =item Working with AVs
4249
4250 =item Working with HVs
4251
4252 =item Hash API Extensions
4253
4254 =item References
4255
4256 =item Blessed References and Class Objects
4257
4258 =item Creating New Variables
4259
4260 =item Reference Counts and Mortality
4261
4262 =item Stashes and Globs
4263
4264 =item Double-Typed SVs
4265
4266 =item Magic Variables
4267
4268 =item Assigning Magic
4269
4270 =item Magic Virtual Tables
4271
4272 =item Finding Magic
4273
4274 =item Understanding the Magic of Tied Hashes and Arrays
4275
4276 =item Localizing changes
4277
4278 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4279 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4280 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4281 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4282 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4283 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4284 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4285 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4286 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4287 save_hptr(HV **hptr)>
4288
4289 =back
4290
4291 =item Subroutines
4292
4293 =over 4
4294
4295 =item XSUBs and the Argument Stack
4296
4297 =item Calling Perl Routines from within C Programs
4298
4299 =item Memory Allocation
4300
4301 =item PerlIO
4302
4303 =item Putting a C value on Perl stack
4304
4305 =item Scratchpads
4306
4307 =item Scratchpads and recursion
4308
4309 =back
4310
4311 =item Compiled code
4312
4313 =over 4
4314
4315 =item Code tree
4316
4317 =item Examining the tree
4318
4319 =item Compile pass 1: check routines
4320
4321 =item Compile pass 1a: constant folding
4322
4323 =item Compile pass 2: context propagation
4324
4325 =item Compile pass 3: peephole optimization
4326
4327 =item Pluggable runops
4328
4329 =back
4330
4331 =item Examining internal data structures with the C<dump> functions
4332
4333 =item How multiple interpreters and concurrency are supported
4334
4335 =over 4
4336
4337 =item Background and PERL_IMPLICIT_CONTEXT
4338
4339 =item So what happened to dTHR?
4340
4341 =item How do I use all this in extensions?
4342
4343 =item Should I do anything special if I call perl from multiple threads?
4344
4345 =item Future Plans and PERL_IMPLICIT_SYS
4346
4347 =back
4348
4349 =item Internal Functions
4350
4351 A, p, d, s, n, r, f, M, o, j, x
4352
4353 =over 4
4354
4355 =item Formatted Printing of IVs, UVs, and NVs
4356
4357 =item Pointer-To-Integer and Integer-To-Pointer
4358
4359 =item Source Documentation
4360
4361 =back
4362
4363 =item Unicode Support
4364
4365 =over 4
4366
4367 =item What B<is> Unicode, anyway?
4368
4369 =item How can I recognise a UTF8 string?
4370
4371 =item How does UTF8 represent Unicode characters?
4372
4373 =item How does Perl store UTF8 strings?
4374
4375 =item How do I convert a string to UTF8?
4376
4377 =item Is there anything else I need to know?
4378
4379 =back
4380
4381 =item Custom Operators
4382
4383 =item AUTHORS
4384
4385 =item SEE ALSO
4386
4387 =back
4388
4389 =head2 perlcall - Perl calling conventions from C
4390
4391 =over 4
4392
4393 =item DESCRIPTION
4394
4395 An Error Handler, An Event Driven Program
4396
4397 =item THE CALL_ FUNCTIONS
4398
4399 call_sv, call_pv, call_method, call_argv
4400
4401 =item FLAG VALUES
4402
4403 =over 4
4404
4405 =item  G_VOID
4406
4407 =item  G_SCALAR
4408
4409 =item G_ARRAY
4410
4411 =item G_DISCARD
4412
4413 =item G_NOARGS
4414
4415 =item G_EVAL
4416
4417 =item G_KEEPERR
4418
4419 =item Determining the Context
4420
4421 =back
4422
4423 =item KNOWN PROBLEMS
4424
4425 =item EXAMPLES
4426
4427 =over 4
4428
4429 =item No Parameters, Nothing returned
4430
4431 =item Passing Parameters
4432
4433 =item Returning a Scalar
4434
4435 =item Returning a list of values
4436
4437 =item Returning a list in a scalar context
4438
4439 =item Returning Data from Perl via the parameter list
4440
4441 =item Using G_EVAL
4442
4443 =item Using G_KEEPERR
4444
4445 =item Using call_sv
4446
4447 =item Using call_argv
4448
4449 =item Using call_method
4450
4451 =item Using GIMME_V
4452
4453 =item Using Perl to dispose of temporaries
4454
4455 =item Strategies for storing Callback Context Information
4456
4457 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4458 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4459 callback
4460
4461 =item Alternate Stack Manipulation
4462
4463 =item Creating and calling an anonymous subroutine in C
4464
4465 =back
4466
4467 =item SEE ALSO
4468
4469 =item AUTHOR
4470
4471 =item DATE
4472
4473 =back
4474
4475 =head2 perlutil - utilities packaged with the Perl distribution
4476
4477 =over 4
4478
4479 =item DESCRIPTION
4480
4481 =over 4
4482
4483 =item DOCUMENTATION
4484
4485 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4486 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4487 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4488 L<roffitall|roffitall>
4489
4490 =item CONVERTORS
4491
4492 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4493
4494 =item Administration
4495
4496 L<libnetcfg|libnetcfg>
4497
4498 =item Development
4499
4500 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4501 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4502
4503 =item SEE ALSO
4504
4505 =back
4506
4507 =back
4508
4509 =head2 perlfilter - Source Filters
4510
4511 =over 4
4512
4513 =item DESCRIPTION
4514
4515 =item CONCEPTS
4516
4517 =item USING FILTERS
4518
4519 =item WRITING A SOURCE FILTER
4520
4521 =item WRITING A SOURCE FILTER IN C
4522
4523 B<Decryption Filters>
4524
4525 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4526
4527 =item WRITING A SOURCE FILTER IN PERL
4528
4529 =item USING CONTEXT: THE DEBUG FILTER
4530
4531 =item CONCLUSION
4532
4533 =item REQUIREMENTS
4534
4535 =item AUTHOR
4536
4537 =item Copyrights
4538
4539 =back
4540
4541 =head2 perldbmfilter - Perl DBM Filters
4542
4543 =over 4
4544
4545 =item SYNOPSIS
4546
4547 =item DESCRIPTION
4548
4549 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4550 B<filter_fetch_value>
4551
4552 =over 4
4553
4554 =item The Filter
4555
4556 =item An Example -- the NULL termination problem.
4557
4558 =item Another Example -- Key is a C int.
4559
4560 =back
4561
4562 =item SEE ALSO
4563
4564 =item AUTHOR
4565
4566 =back
4567
4568 =head2 perlapi - autogenerated documentation for the perl public API
4569
4570 =over 4
4571
4572 =item DESCRIPTION
4573
4574 =item "Gimme" Values
4575
4576 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4577
4578 =item Array Manipulation Functions
4579
4580 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4581 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4582 get_av, newAV, Nullav, sortsv
4583
4584 =item Callback Functions
4585
4586 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4587 FREETMPS, LEAVE, SAVETMPS
4588
4589 =item Character classes
4590
4591 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4592
4593 =item Cloning an interpreter
4594
4595 perl_clone
4596
4597 =item CV Manipulation Functions
4598
4599 CvSTASH, get_cv, Nullcv
4600
4601 =item Embedding Functions
4602
4603 load_module, perl_alloc, perl_construct, perl_destruct, perl_free,
4604 perl_parse, perl_run, require_pv
4605
4606 =item Functions in file pp_pack.c
4607
4608 pack_cat, unpack_str
4609
4610 =item Global Variables
4611
4612 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4613
4614 =item GV Functions
4615
4616 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv,
4617 gv_stashsv
4618
4619 =item Handy Values
4620
4621 HEf_SVKEY, Nullch, Nullsv
4622
4623 =item Hash Manipulation Functions
4624
4625 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4626 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4627 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4628 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store,
4629 hv_store_ent, hv_undef, newHV, Nullhv
4630
4631 =item Magical Functions
4632
4633 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4634 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4635 SvSetSV, SvSetSV_nosteal, SvSHARE
4636
4637 =item Memory Management
4638
4639 Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv,
4640 savepvn, savesharedpv, StructCopy, Zero
4641
4642 =item Miscellaneous Functions
4643
4644 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4645 strNE, strnEQ, strnNE
4646
4647 =item Numeric functions
4648
4649 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4650 scan_hex, scan_oct
4651
4652 =item Optree Manipulation Functions
4653
4654 cv_const_sv, newCONSTSUB, newXS
4655
4656 =item Stack Manipulation Macros
4657
4658 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4659 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4660 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4661 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4662 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4663
4664 =item SV Flags
4665
4666 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4667
4668 =item SV Manipulation Functions
4669
4670 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4671 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4672 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4673 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVX,
4674 SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4675 SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
4676 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4677 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4678 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4679 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4680 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4681 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4682 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4683 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4684 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4685 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4686 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4687 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4688 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4689 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4690 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4691 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4692 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4693 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4694 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4695 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4696 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg,
4697 sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv,
4698 sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags,
4699 sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true,
4700 sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn,
4701 sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
4702 sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4703
4704 =item Unicode Support
4705
4706 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4707 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4708 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4709 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4710 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4711
4712 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4713
4714 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4715 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4716
4717 =item Warning and Dieing
4718
4719 croak, warn
4720
4721 =item AUTHORS
4722
4723 =item SEE ALSO
4724
4725 =back
4726
4727 =head2 perlintern - autogenerated documentation of purely B<internal>
4728                  Perl functions
4729
4730 =over 4
4731
4732 =item DESCRIPTION
4733
4734 =item Global Variables
4735
4736 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4737 PL_rs
4738
4739 =item GV Functions
4740
4741 is_gv_magical
4742
4743 =item IO Functions
4744
4745 start_glob
4746
4747 =item Pad Data Structures
4748
4749 CvPADLIST
4750
4751 =item Stack Manipulation Macros
4752
4753 djSP, LVRET
4754
4755 =item SV Manipulation Functions
4756
4757 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4758
4759 =item AUTHORS
4760
4761 =item SEE ALSO
4762
4763 =back
4764
4765 =head2 perliol - C API for Perl's implementation of IO in Layers.
4766
4767 =over 4
4768
4769 =item SYNOPSIS
4770
4771 =item DESCRIPTION
4772
4773 =over 4
4774
4775 =item History and Background
4776
4777 =item Layers vs Disciplines
4778
4779 =item Data Structures
4780
4781 =item Functions and Attributes
4782
4783 =item Per-instance Data
4784
4785 =item Layers in action.
4786
4787 =item Per-instance flag bits
4788
4789 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4790 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4791 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4792 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4793
4794 =item Methods in Detail
4795
4796 name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
4797 PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
4798 Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
4799 Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
4800
4801 =item Core Layers
4802
4803 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4804
4805 =item Extension Layers
4806
4807 ":encoding", ":Scalar", ":Object" or ":Perl"
4808
4809 =back
4810
4811 =item TODO
4812
4813 =back
4814
4815 =head2 perlapio - perl's IO abstraction interface.
4816
4817 =over 4
4818
4819 =item SYNOPSIS
4820
4821 =item DESCRIPTION
4822
4823 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4824 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4825 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4826 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4827 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4828 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4829 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4830 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4831 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4832 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4833 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4834
4835 =over 4
4836
4837 =item Co-existence with stdio
4838
4839 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4840 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>
4841
4842 =item "Fast gets" Functions
4843
4844 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4845 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4846 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4847 B<PerlIO_get_bufsiz(f)>
4848
4849 =item Other Functions
4850
4851 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4852 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4853
4854 =back
4855
4856 =back
4857
4858 =head2 perltodo - Perl TO-DO List
4859
4860 =over 4
4861
4862 =item DESCRIPTION
4863
4864 =item To do during 5.6.x
4865
4866 =over 4
4867
4868 =item Support for I/O disciplines
4869
4870 =item Autoload bytes.pm
4871
4872 =item Make "\u{XXXX}" et al work
4873
4874 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4875
4876 =item Overloadable regex assertions
4877
4878 =item Unicode
4879
4880 =item use Thread for iThreads
4881
4882 =item make perl_clone optionally clone ops
4883
4884 =item Work out exit/die semantics for threads
4885
4886 =item Typed lexicals for compiler
4887
4888 =item Compiler workarounds for Win32
4889
4890 =item AUTOLOADing in the compiler
4891
4892 =item Fixing comppadlist when compiling
4893
4894 =item Cleaning up exported namespace
4895
4896 =item Complete signal handling
4897
4898 =item Out-of-source builds
4899
4900 =item POSIX realtime support
4901
4902 =item UNIX98 support
4903
4904 =item IPv6 Support
4905
4906 =item Long double conversion
4907
4908 =item Locales
4909
4910 =item Thread-safe regexes
4911
4912 =item Arithmetic on non-Arabic numerals
4913
4914 =item POSIX Unicode character classes
4915
4916 =item Factoring out common suffices/prefices in regexps (trie optimization)
4917
4918 =item Security audit shipped utilities
4919
4920 =item Sort out the uid-setting mess
4921
4922 =item DLL Versioning
4923
4924 =item Introduce @( and @)
4925
4926 =item Floating point handling
4927
4928 =item IV/UV preservation
4929
4930 =item Replace pod2html with something using Pod::Parser
4931
4932 =item Automate module testing on CPAN
4933
4934 =item sendmsg and recvmsg
4935
4936 =item Rewrite perlre documentation
4937
4938 =item Convert example code to IO::Handle filehandles
4939
4940 =item Document Win32 choices
4941
4942 =item Check new modules
4943
4944 =item Make roffitall find pods and libs itself
4945
4946 =back
4947
4948 =item To do at some point
4949
4950 =over 4
4951
4952 =item Remove regular expression recursion
4953
4954 =item Memory leaks after failed eval
4955
4956 =item bitfields in pack
4957
4958 =item Cross compilation
4959
4960 =item Perl preprocessor / macros
4961
4962 =item Perl lexer in Perl
4963
4964 =item Using POSIX calls internally
4965
4966 =item -i rename file when changed
4967
4968 =item All ARGV input should act like E<lt>E<gt>
4969
4970 =item Support for rerunning debugger
4971
4972 =item Test Suite for the Debugger
4973
4974 =item my sub foo { }
4975
4976 =item One-pass global destruction
4977
4978 =item Rewrite regexp parser
4979
4980 =item Cache recently used regexps
4981
4982 =item Re-entrant functions
4983
4984 =item Cross-compilation support
4985
4986 =item Bit-shifting bitvectors
4987
4988 =item debugger pragma
4989
4990 =item use less pragma
4991
4992 =item switch structures
4993
4994 =item Cache eval tree
4995
4996 =item rcatmaybe
4997
4998 =item Shrink opcode tables
4999
5000 =item Optimize away @_
5001
5002 =item Prototypes versus indirect objects
5003
5004 =item Install HTML
5005
5006 =item Prototype method calls
5007
5008 =item Return context prototype declarations
5009
5010 =item magic_setisa
5011
5012 =item Garbage collection
5013
5014 =item IO tutorial
5015
5016 =item Rewrite perldoc
5017
5018 =item Install .3p manpages
5019
5020 =item Unicode tutorial
5021
5022 =item Update POSIX.pm for 1003.1-2
5023
5024 =item Retargetable installation
5025
5026 =item POSIX emulation on non-POSIX systems
5027
5028 =item Rename Win32 headers
5029
5030 =item Finish off lvalue functions
5031
5032 =item Update sprintf documentation
5033
5034 =item Use fchown/fchmod internally
5035
5036 =item Make v-strings overloaded objects
5037
5038 =back
5039
5040 =item Vague ideas
5041
5042 =over 4
5043
5044 =item ref() in list context
5045
5046 =item Make tr/// return histogram of characters in list context
5047
5048 =item Compile to real threaded code
5049
5050 =item Structured types
5051
5052 =item Modifiable $1 et al.
5053
5054 =item Procedural interfaces for IO::*, etc.
5055
5056 =item RPC modules
5057
5058 =item Attach/detach debugger from running program
5059
5060 =item GUI::Native
5061
5062 =item foreach(reverse ...)
5063
5064 =item Constant function cache
5065
5066 =item Approximate regular expression matching
5067
5068 =back
5069
5070 =item Ongoing
5071
5072 =over 4
5073
5074 =item Update guts documentation
5075
5076 =item Add more tests
5077
5078 =item Update auxiliary tools
5079
5080 =back
5081
5082 =item Recently done things
5083
5084 =over 4
5085
5086 =item Alternative RE syntax module
5087
5088 =item Safe signal handling
5089
5090 =item Tie Modules
5091
5092 =item gettimeofday
5093
5094 =item setitimer and getimiter
5095
5096 =item Testing __DIE__ hook
5097
5098 =item CPP equivalent in Perl
5099
5100 =item Explicit switch statements
5101
5102 =item autocroak
5103
5104 =item UTF/EBCDIC
5105
5106 =item UTF Regexes
5107
5108 =item perlcc to produce executable
5109
5110 =item END blocks saved in compiled output
5111
5112 =item Secure temporary file module
5113
5114 =item Integrate Time::HiRes
5115
5116 =item Turn Cwd into XS
5117
5118 =item Mmap for input
5119
5120 =item Byte to/from UTF8 and UTF8 to/from local conversion
5121
5122 =item Add sockatmark support
5123
5124 =item Mailing list archives
5125
5126 =item Bug tracking
5127
5128 =item Integrate MacPerl
5129
5130 =item Web "nerve center" for Perl
5131
5132 =item Regular expression tutorial
5133
5134 =item Debugging Tutorial
5135
5136 =item Integrate new modules
5137
5138 =item Integrate profiler
5139
5140 =item Y2K error detection
5141
5142 =item Regular expression debugger
5143
5144 =item POD checker
5145
5146 =item "Dynamic" lexicals
5147
5148 =item Cache precompiled modules
5149
5150 =back
5151
5152 =item Deprecated Wishes
5153
5154 =over 4
5155
5156 =item Loop control on do{}
5157
5158 =item Lexically scoped typeglobs
5159
5160 =item format BOTTOM
5161
5162 =item report HANDLE
5163
5164 =item Generalised want()/caller())
5165
5166 =item Named prototypes
5167
5168 =item Built-in globbing
5169
5170 =item Regression tests for suidperl
5171
5172 =item Cached hash values
5173
5174 =item Add compression modules
5175
5176 =item Reorganise documentation into tutorials/references
5177
5178 =item Remove distinction between functions and operators
5179
5180 =item Make XS easier to use
5181
5182 =item Make embedding easier to use
5183
5184 =item man for perl
5185
5186 =item my $Package::variable
5187
5188 =item "or" tests defined, not truth
5189
5190 =item "class"-based lexicals
5191
5192 =item byteperl
5193
5194 =item Lazy evaluation / tail recursion removal
5195
5196 =item Make "use utf8" the default
5197
5198 =item Unicode collation and normalization
5199
5200 =item Create debugging macros
5201
5202 =item truncate to the people
5203
5204 =item pack/unpack tutorial
5205
5206 =back
5207
5208 =back
5209
5210 =head2 perlhack - How to hack at the Perl internals
5211
5212 =over 4
5213
5214 =item DESCRIPTION
5215
5216 Does concept match the general goals of Perl?, Where is the
5217 implementation?, Backwards compatibility, Could it be a module instead?, Is
5218 the feature generic enough?, Does it potentially introduce new bugs?, Does
5219 it preclude other desirable features?, Is the implementation robust?, Is
5220 the implementation generic enough to be portable?, Is the implementation
5221 tested?, Is there enough documentation?, Is there another way to do it?,
5222 Does it create too much work?, Patches speak louder than words
5223
5224 =over 4
5225
5226 =item Keeping in sync
5227
5228 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5229 NFS, rsync'ing the patches
5230
5231 =item Why rsync the source tree
5232
5233 It's easier to rsync the source tree, It's more recent, It's more reliable
5234
5235 =item Why rsync the patches
5236
5237 It's easier to rsync the patches, It's a good reference, Finding a start
5238 point, Finding how to fix a bug, Finding the source of misbehaviour
5239
5240 =item Perlbug remote interface
5241
5242 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5243 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5244
5245 =item Submitting patches
5246
5247 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5248 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5249
5250 =item Finding Your Way Around
5251
5252 Core modules, Tests, Documentation, Configure, Interpreter
5253
5254 =item Elements of the interpreter
5255
5256 Startup, Parsing, Optimization, Running
5257
5258 =item Internal Variable Types
5259
5260 =item Op Trees
5261
5262 =item Stacks
5263
5264 Argument stack, Mark stack, Save stack
5265
5266 =item Millions of Macros
5267
5268 =item Poking at Perl
5269
5270 =item Using a source-level debugger
5271
5272 run [args], break function_name, break source.c:xxx, step, next, continue,
5273 finish, 'enter', print
5274
5275 =item Dumping Perl Data Structures
5276
5277 =item Patching
5278
5279 =item Patching a core module
5280
5281 =item Adding a new function to the core
5282
5283 =item Writing a test
5284
5285 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5286 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5287
5288 =back
5289
5290 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5291
5292 =over 4
5293
5294 =item Rational Software's Purify
5295
5296 =item Purify on Unix
5297
5298 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5299
5300 =item Purify on NT
5301
5302 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5303
5304 =item Compaq's/Digital's Third Degree
5305
5306 =item PERL_DESTRUCT_LEVEL
5307
5308 =item Profiling
5309
5310 =item Gprof Profiling
5311
5312 -a, -b, -e routine, -f routine, -s, -z
5313
5314 =item GCC gcov Profiling
5315
5316 =item Pixie Profiling
5317
5318 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5319 -z[ero]
5320
5321 =item CONCLUSION
5322
5323 I<The Road goes ever on and on, down from the door where it began.>
5324
5325 =back
5326
5327 =item AUTHOR
5328
5329 =back
5330
5331 =head2 perlhist - the Perl history records
5332
5333 =over 4
5334
5335 =item DESCRIPTION
5336
5337 =item INTRODUCTION
5338
5339 =item THE KEEPERS OF THE PUMPKIN
5340
5341 =over 4
5342
5343 =item PUMPKIN?
5344
5345 =back
5346
5347 =item THE RECORDS
5348
5349 =over 4
5350
5351 =item SELECTED RELEASE SIZES
5352
5353 =item SELECTED PATCH SIZES
5354
5355 =back
5356
5357 =item THE KEEPERS OF THE RECORDS
5358
5359 =back
5360
5361 =head2 perldelta - what is new for perl v5.8.0
5362
5363 =over 4
5364
5365 =item DESCRIPTION
5366
5367 =item Highlights In 5.8.0
5368
5369 =item Incompatible Changes
5370
5371 =over 4
5372
5373 =item 64-bit platforms and malloc
5374
5375 =item AIX Dynaloading
5376
5377 =item Attributes for C<my> variables now handled at run-time.
5378
5379 =item Socket Extension Dynamic in VMS
5380
5381 =item IEEE-format Floating Point Default on OpenVMS Alpha
5382
5383 =item New Unicode Properties
5384
5385 =item Perl Parser Stress Tested
5386
5387 =item REF(...) Instead Of SCALAR(...)
5388
5389 =item pack/unpack D/F recycled
5390
5391 =item Deprecations
5392
5393 =back
5394
5395 =item Core Enhancements
5396
5397 =over 4
5398
5399 =item PerlIO is Now The Default
5400
5401 =item Safe Signals
5402
5403 =item Unicode Overhaul
5404
5405 =item Understanding of Numbers
5406
5407 =item Miscellaneous Changes
5408
5409 =back
5410
5411 =item Modules and Pragmata
5412
5413 =over 4
5414
5415 =item New Modules and Pragmata
5416
5417 =item Updated And Improved Modules and Pragmata
5418
5419 =back
5420
5421 =item Utility Changes
5422
5423 =item New Documentation
5424
5425 =item Performance Enhancements
5426
5427 =item Installation and Configuration Improvements
5428
5429 =over 4
5430
5431 =item Generic Improvements
5432
5433 =item New Or Improved Platforms
5434
5435 =back
5436
5437 =item Selected Bug Fixes
5438
5439 =over 4
5440
5441 =item Platform Specific Changes and Fixes
5442
5443 =back
5444
5445 =item New or Changed Diagnostics
5446
5447 =item Changed Internals
5448
5449 =item Security Vulnerability Closed
5450
5451 =item New Tests
5452
5453 =item Known Problems
5454
5455 =over 4
5456
5457 =item AIX
5458
5459 =item Amiga Perl Invoking Mystery
5460
5461 =item lib/ftmp-security tests warn 'system possibly insecure'
5462
5463 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5464
5465 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5466
5467 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5468
5469 =item Linux With Sfio Fails op/misc Test 48
5470
5471 =item Mac OS X
5472
5473 =item OS/390
5474
5475 =item op/sprintf tests 129 and 130
5476
5477 =item  Failure of Thread tests
5478
5479 =item UNICOS
5480
5481 =item UNICOS and UNICOS/mk
5482
5483 =item UTS
5484
5485 =item VMS
5486
5487 =item Win32
5488
5489 =item Localising a Tied Variable Leaks Memory
5490
5491 =item Localising Tied Arrays and Hashes Is Broken
5492
5493 =item Self-tying of Arrays and Hashes Is Forbidden
5494
5495 =item Building Extensions Can Fail Because Of Largefiles
5496
5497 =item Unicode Support on EBCDIC Still Spotty
5498
5499 =item The Compiler Suite Is Still Experimental
5500
5501 =item The Long Double Support Is Still Experimental
5502
5503 =item Seen In Perl 5.7 But Gone Now
5504
5505 =back
5506
5507 =item Reporting Bugs
5508
5509 =item SEE ALSO
5510
5511 =item HISTORY
5512
5513 =back
5514
5515 =head2 perl572delta - what's new for perl v5.7.2
5516
5517 =over 4
5518
5519 =item DESCRIPTION
5520
5521 =item Security Vulnerability Closed
5522
5523 =item Incompatible Changes
5524
5525 =over 4
5526
5527 =item 64-bit platforms and malloc
5528
5529 =item AIX Dynaloading
5530
5531 =item Socket Extension Dynamic in VMS
5532
5533 =item Different Definition of the Unicode Character Classes \p{In...}
5534
5535 =item Deprecations
5536
5537 =back
5538
5539 =item Core Enhancements
5540
5541 =item Modules and Pragmata
5542
5543 =over 4
5544
5545 =item New Modules and Distributions
5546
5547 =item Updated And Improved Modules and Pragmata
5548
5549 =back
5550
5551 =item Utility Changes
5552
5553 =item New Documentation
5554
5555 =item Installation and Configuration Improvements
5556
5557 =over 4
5558
5559 =item New Or Improved Platforms
5560
5561 =item Generic Improvements
5562
5563 =back
5564
5565 =item Selected Bug Fixes
5566
5567 =over 4
5568
5569 =item Platform Specific Changes and Fixes
5570
5571 =back
5572
5573 =item New or Changed Diagnostics
5574
5575 =item Source Code Enhancements
5576
5577 =over 4
5578
5579 =item MAGIC constants
5580
5581 =item Better commented code
5582
5583 =item Regex pre-/post-compilation items matched up
5584
5585 =item gcc -Wall
5586
5587 =back
5588
5589 =item New Tests
5590
5591 =item Known Problems
5592
5593 =over 4
5594
5595 =item AIX
5596
5597 =item Amiga Perl Invoking Mystery
5598
5599 =item lib/ftmp-security tests warn 'system possibly insecure'
5600
5601 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5602
5603 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5604
5605 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5606
5607 =item Linux With Sfio Fails op/misc Test 48
5608
5609 =item OS/390
5610
5611 =item op/sprintf tests 129 and 130
5612
5613 =item  Failure of Thread tests
5614
5615 =item UNICOS
5616
5617 =item UTS
5618
5619 =item VMS
5620
5621 =item Win32
5622
5623 =item Localising a Tied Variable Leaks Memory
5624
5625 =item Self-tying of Arrays and Hashes Is Forbidden
5626
5627 =item Variable Attributes are not Currently Usable for Tieing
5628
5629 =item Building Extensions Can Fail Because Of Largefiles
5630
5631 =item The Compiler Suite Is Still Experimental
5632
5633 =item The Long Double Support is Still Experimental
5634
5635 =back
5636
5637 =item Reporting Bugs
5638
5639 =item SEE ALSO
5640
5641 =item HISTORY
5642
5643 =back
5644
5645 =head2 perl571delta - what's new for perl v5.7.1
5646
5647 =over 4
5648
5649 =item DESCRIPTION
5650
5651 =item Security Vulnerability Closed
5652
5653 =item Incompatible Changes
5654
5655 =item Core Enhancements
5656
5657 =over 4
5658
5659 =item AUTOLOAD Is Now Lvaluable
5660
5661 =item PerlIO is Now The Default
5662
5663 =item Signals Are Now Safe
5664
5665 =back
5666
5667 =item Modules and Pragmata
5668
5669 =over 4
5670
5671 =item New Modules
5672
5673 =item Updated And Improved Modules and Pragmata
5674
5675 =back
5676
5677 =item Performance Enhancements
5678
5679 =item Utility Changes
5680
5681 =item New Documentation
5682
5683 =over 4
5684
5685 =item perlclib
5686
5687 =item perliol
5688
5689 =item README.aix
5690
5691 =item README.bs2000
5692
5693 =item README.macos
5694
5695 =item README.mpeix
5696
5697 =item README.solaris
5698
5699 =item README.vos
5700
5701 =item Porting/repository.pod
5702
5703 =back
5704
5705 =item Installation and Configuration Improvements
5706
5707 =over 4
5708
5709 =item New Or Improved Platforms
5710
5711 =item Generic Improvements
5712
5713 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5714 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5715 d_strtoq, d_u32align, d_ualarm, d_usleep
5716
5717 =back
5718
5719 =item Selected Bug Fixes
5720
5721 =over 4
5722
5723 =item Platform Specific Changes and Fixes
5724
5725 =back
5726
5727 =item New or Changed Diagnostics
5728
5729 =item Changed Internals
5730
5731 =item New Tests
5732
5733 =item Known Problems
5734
5735 =over 4
5736
5737 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5738
5739 =item lib/ftmp-security tests warn 'system possibly insecure'
5740
5741 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5742
5743 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5744
5745 =item lib/b test 19
5746
5747 =item Linux With Sfio Fails op/misc Test 48
5748
5749 =item sigaction test 13 in VMS
5750
5751 =item sprintf tests 129 and 130
5752
5753 =item  Failure of Thread tests
5754
5755 =item Localising a Tied Variable Leaks Memory
5756
5757 =item Self-tying of Arrays and Hashes Is Forbidden
5758
5759 =item Building Extensions Can Fail Because Of Largefiles
5760
5761 =item The Compiler Suite Is Still Experimental
5762
5763 =back
5764
5765 =item Reporting Bugs
5766
5767 =item SEE ALSO
5768
5769 =item HISTORY
5770
5771 =back
5772
5773 =head2 perl570delta - what's new for perl v5.7.0
5774
5775 =over 4
5776
5777 =item DESCRIPTION
5778
5779 =item Security Vulnerability Closed
5780
5781 =item Incompatible Changes
5782
5783 =item Core Enhancements
5784
5785 =item Modules and Pragmata
5786
5787 =over 4
5788
5789 =item New Modules
5790
5791 =item Updated And Improved Modules and Pragmata
5792
5793 =back
5794
5795 =item Utility Changes
5796
5797 =item New Documentation
5798
5799 =item Performance Enhancements
5800
5801 =item Installation and Configuration Improvements
5802
5803 =over 4
5804
5805 =item Generic Improvements
5806
5807 =back
5808
5809 =item Selected Bug Fixes
5810
5811 =over 4
5812
5813 =item Platform Specific Changes and Fixes
5814
5815 =back
5816
5817 =item New or Changed Diagnostics
5818
5819 =item Changed Internals
5820
5821 =item Known Problems
5822
5823 =over 4
5824
5825 =item Unicode Support Still Far From Perfect
5826
5827 =item EBCDIC Still A Lost Platform
5828
5829 =item Building Extensions Can Fail Because Of Largefiles
5830
5831 =item ftmp-security tests warn 'system possibly insecure'
5832
5833 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5834
5835 =item Long Doubles Still Don't Work In Solaris
5836
5837 =item Linux With Sfio Fails op/misc Test 48
5838
5839 =item Storable tests fail in some platforms
5840
5841 =item Threads Are Still Experimental
5842
5843 =item The Compiler Suite Is Still Experimental
5844
5845 =back
5846
5847 =item Reporting Bugs
5848
5849 =item SEE ALSO
5850
5851 =item HISTORY
5852
5853 =back
5854
5855 =head2 perl561delta - what's new for perl v5.6.x
5856
5857 =over 4
5858
5859 =item DESCRIPTION
5860
5861 =item Summary of changes between 5.6.0 and 5.6.1
5862
5863 =over 4
5864
5865 =item Security Issues
5866
5867 =item Core bug fixes
5868
5869 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5870 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5871 references to special variables, Lexical warnings, Spurious warnings and
5872 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5873 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5874 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5875 Module;>, Tests
5876
5877 =item Core features
5878
5879 =item Configuration issues
5880
5881 =item Documentation
5882
5883 =item Bundled modules
5884
5885 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5886 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5887 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5888 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5889
5890 =item Platform-specific improvements
5891
5892 NCR MP-RAS, NonStop-UX
5893
5894 =back
5895
5896 =item Core Enhancements
5897
5898 =over 4
5899
5900 =item Interpreter cloning, threads, and concurrency
5901
5902 =item Lexically scoped warning categories
5903
5904 =item Unicode and UTF-8 support
5905
5906 =item Support for interpolating named characters
5907
5908 =item "our" declarations
5909
5910 =item Support for strings represented as a vector of ordinals
5911
5912 =item Improved Perl version numbering system
5913
5914 =item New syntax for declaring subroutine attributes
5915
5916 =item File and directory handles can be autovivified
5917
5918 =item open() with more than two arguments
5919
5920 =item 64-bit support
5921
5922 =item Large file support
5923
5924 =item Long doubles
5925
5926 =item "more bits"
5927
5928 =item Enhanced support for sort() subroutines
5929
5930 =item C<sort $coderef @foo> allowed
5931
5932 =item File globbing implemented internally
5933
5934 =item Support for CHECK blocks
5935
5936 =item POSIX character class syntax [: :] supported
5937
5938 =item Better pseudo-random number generator
5939
5940 =item Improved C<qw//> operator
5941
5942 =item Better worst-case behavior of hashes
5943
5944 =item pack() format 'Z' supported
5945
5946 =item pack() format modifier '!' supported
5947
5948 =item pack() and unpack() support counted strings
5949
5950 =item Comments in pack() templates
5951
5952 =item Weak references
5953
5954 =item Binary numbers supported
5955
5956 =item Lvalue subroutines
5957
5958 =item Some arrows may be omitted in calls through references
5959
5960 =item Boolean assignment operators are legal lvalues
5961
5962 =item exists() is supported on subroutine names
5963
5964 =item exists() and delete() are supported on array elements
5965
5966 =item Pseudo-hashes work better
5967
5968 =item Automatic flushing of output buffers
5969
5970 =item Better diagnostics on meaningless filehandle operations
5971
5972 =item Where possible, buffered data discarded from duped input filehandle
5973
5974 =item eof() has the same old magic as <>
5975
5976 =item binmode() can be used to set :crlf and :raw modes
5977
5978 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5979
5980 =item system(), backticks and pipe open now reflect exec() failure
5981
5982 =item Improved diagnostics
5983
5984 =item Diagnostics follow STDERR
5985
5986 =item More consistent close-on-exec behavior
5987
5988 =item syswrite() ease-of-use
5989
5990 =item Better syntax checks on parenthesized unary operators
5991
5992 =item Bit operators support full native integer width
5993
5994 =item Improved security features
5995
5996 =item More functional bareword prototype (*)
5997
5998 =item C<require> and C<do> may be overridden
5999
6000 =item $^X variables may now have names longer than one character
6001
6002 =item New variable $^C reflects C<-c> switch
6003
6004 =item New variable $^V contains Perl version as a string
6005
6006 =item Optional Y2K warnings
6007
6008 =item Arrays now always interpolate into double-quoted strings
6009
6010 =back
6011
6012 =item Modules and Pragmata
6013
6014 =over 4
6015
6016 =item Modules
6017
6018 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6019 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6020 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6021 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6022 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6023 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6024 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6025 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6026
6027 =item Pragmata
6028
6029 =back
6030
6031 =item Utility Changes
6032
6033 =over 4
6034
6035 =item dprofpp
6036
6037 =item find2perl
6038
6039 =item h2xs
6040
6041 =item perlcc
6042
6043 =item perldoc
6044
6045 =item The Perl Debugger
6046
6047 =back
6048
6049 =item Improved Documentation
6050
6051 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6052 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6053 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6054 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6055
6056 =item Performance enhancements
6057
6058 =over 4
6059
6060 =item Simple sort() using { $a <=> $b } and the like are optimized
6061
6062 =item Optimized assignments to lexical variables
6063
6064 =item Faster subroutine calls
6065
6066 =item delete(), each(), values() and hash iteration are faster
6067
6068 =back
6069
6070 =item Installation and Configuration Improvements
6071
6072 =over 4
6073
6074 =item -Dusethreads means something different
6075
6076 =item New Configure flags
6077
6078 =item Threadedness and 64-bitness now more daring
6079
6080 =item Long Doubles
6081
6082 =item -Dusemorebits
6083
6084 =item -Duselargefiles
6085
6086 =item installusrbinperl
6087
6088 =item SOCKS support
6089
6090 =item C<-A> flag
6091
6092 =item Enhanced Installation Directories
6093
6094 =item gcc automatically tried if 'cc' does not seem to be working
6095
6096 =back
6097
6098 =item Platform specific changes
6099
6100 =over 4
6101
6102 =item Supported platforms
6103
6104 =item DOS
6105
6106 =item OS390 (OpenEdition MVS)
6107
6108 =item VMS
6109
6110 =item Win32
6111
6112 =back
6113
6114 =item Significant bug fixes
6115
6116 =over 4
6117
6118 =item <HANDLE> on empty files
6119
6120 =item C<eval '...'> improvements
6121
6122 =item All compilation errors are true errors
6123
6124 =item Implicitly closed filehandles are safer
6125
6126 =item Behavior of list slices is more consistent
6127
6128 =item C<(\$)> prototype and C<$foo{a}>
6129
6130 =item C<goto &sub> and AUTOLOAD
6131
6132 =item C<-bareword> allowed under C<use integer>
6133
6134 =item Failures in DESTROY()
6135
6136 =item Locale bugs fixed
6137
6138 =item Memory leaks
6139
6140 =item Spurious subroutine stubs after failed subroutine calls
6141
6142 =item Taint failures under C<-U>
6143
6144 =item END blocks and the C<-c> switch
6145
6146 =item Potential to leak DATA filehandles
6147
6148 =back
6149
6150 =item New or Changed Diagnostics
6151
6152 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6153 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6154 / cannot take a count, / must be followed by a, A or Z, / must be followed
6155 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6156 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6157 passed through, /%s/ should probably be written as "%s", %s() called too
6158 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6159 argument is not a HASH or ARRAY element or slice, %s argument is not a
6160 subroutine name, %s package attribute may clash with future reserved word:
6161 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6162 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6163 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6164 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6165 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6166 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6167 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6168 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6169 weaken a nonreference, Character class [:%s:] unknown, Character class
6170 syntax [%s] belongs inside character classes, Constant is not %s reference,
6171 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6172 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6173 "local" instead of "our"?), Document contains no data, entering effective
6174 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6175 output, flock() on closed filehandle %s, Global symbol "%s" requires
6176 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6177 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6178 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6179 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6180 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6181 separator character %s in attribute list, Invalid separator character %s in
6182 subroutine attribute list, leaving effective %s failed, Lvalue subs
6183 returning %s not implemented yet, Method %s not permitted, Missing
6184 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6185 No %s specified for -%c, No package name allowed for variable %s in "our",
6186 No space allowed after -%c, no UTC offset information; assuming local time
6187 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6188 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6189 around "%s" list, Possible unintended interpolation of %s in string,
6190 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6191 instead, Premature end of script headers, Repeat count in pack overflows,
6192 Repeat count in unpack overflows, realloc() of freed memory ignored,
6193 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6194 zero-length expression, switching effective %s is not implemented, This
6195 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6196 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6197 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6198 escape \\%c passed through, Unterminated attribute parameter in attribute
6199 list, Unterminated attribute list, Unterminated attribute parameter in
6200 subroutine attribute list, Unterminated subroutine attribute list, Value of
6201 CLI symbol "%s" too long, Version number must be a constant number
6202
6203 =item New tests
6204
6205 =item Incompatible Changes
6206
6207 =over 4
6208
6209 =item Perl Source Incompatibilities
6210
6211 CHECK is a new keyword, Treatment of list slices of undef has changed,
6212 Format of $English::PERL_VERSION is different, Literals of the form
6213 C<1.2.3> parse differently, Possibly changed pseudo-random number
6214 generator, Hashing function for hash keys has changed, C<undef> fails on
6215 read only values, Close-on-exec bit may be set on pipe and socket handles,
6216 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6217 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6218 Text of some diagnostic output has changed, C<%@> has been removed,
6219 Parenthesized not() behaves like a list operator, Semantics of bareword
6220 prototype C<(*)> have changed, Semantics of bit operators may have changed
6221 on 64-bit platforms, More builtins taint their results
6222
6223 =item C Source Incompatibilities
6224
6225 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6226
6227 =item Compatible C Source API Changes
6228
6229 C<PATCHLEVEL> is now C<PERL_VERSION>
6230
6231 =item Binary Incompatibilities
6232
6233 =back
6234
6235 =item Known Problems
6236
6237 =over 4
6238
6239 =item Localizing a tied hash element may leak memory
6240
6241 =item Known test failures
6242
6243 , , 
6244
6245 =item EBCDIC platforms not fully supported
6246
6247 =item UNICOS/mk CC failures during Configure run
6248
6249 =item Arrow operator and arrays
6250
6251 =item Experimental features
6252
6253 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6254 pseudo-hash data type, The Compiler suite, Internal implementation of file
6255 globbing, The DB module, The regular expression code constructs:
6256
6257 =back
6258
6259 =item Obsolete Diagnostics
6260
6261 Character class syntax [: :] is reserved for future extensions, Ill-formed
6262 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6263 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6264 to mean "${$}<digit>" is deprecated
6265
6266 =item Reporting Bugs
6267
6268 =item SEE ALSO
6269
6270 =item HISTORY
6271
6272 =back
6273
6274 =head2 perl56delta - what's new for perl v5.6.0
6275
6276 =over 4
6277
6278 =item DESCRIPTION
6279
6280 =item Core Enhancements
6281
6282 =over 4
6283
6284 =item Interpreter cloning, threads, and concurrency
6285
6286 =item Lexically scoped warning categories
6287
6288 =item Unicode and UTF-8 support
6289
6290 =item Support for interpolating named characters
6291
6292 =item "our" declarations
6293
6294 =item Support for strings represented as a vector of ordinals
6295
6296 =item Improved Perl version numbering system
6297
6298 =item New syntax for declaring subroutine attributes
6299
6300 =item File and directory handles can be autovivified
6301
6302 =item open() with more than two arguments
6303
6304 =item 64-bit support
6305
6306 =item Large file support
6307
6308 =item Long doubles
6309
6310 =item "more bits"
6311
6312 =item Enhanced support for sort() subroutines
6313
6314 =item C<sort $coderef @foo> allowed
6315
6316 =item File globbing implemented internally
6317
6318 =item Support for CHECK blocks
6319
6320 =item POSIX character class syntax [: :] supported
6321
6322 =item Better pseudo-random number generator
6323
6324 =item Improved C<qw//> operator
6325
6326 =item Better worst-case behavior of hashes
6327
6328 =item pack() format 'Z' supported
6329
6330 =item pack() format modifier '!' supported
6331
6332 =item pack() and unpack() support counted strings
6333
6334 =item Comments in pack() templates
6335
6336 =item Weak references
6337
6338 =item Binary numbers supported
6339
6340 =item Lvalue subroutines
6341
6342 =item Some arrows may be omitted in calls through references
6343
6344 =item Boolean assignment operators are legal lvalues
6345
6346 =item exists() is supported on subroutine names
6347
6348 =item exists() and delete() are supported on array elements
6349
6350 =item Pseudo-hashes work better
6351
6352 =item Automatic flushing of output buffers
6353
6354 =item Better diagnostics on meaningless filehandle operations
6355
6356 =item Where possible, buffered data discarded from duped input filehandle
6357
6358 =item eof() has the same old magic as <>
6359
6360 =item binmode() can be used to set :crlf and :raw modes
6361
6362 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6363
6364 =item system(), backticks and pipe open now reflect exec() failure
6365
6366 =item Improved diagnostics
6367
6368 =item Diagnostics follow STDERR
6369
6370 =item More consistent close-on-exec behavior
6371
6372 =item syswrite() ease-of-use
6373
6374 =item Better syntax checks on parenthesized unary operators
6375
6376 =item Bit operators support full native integer width
6377
6378 =item Improved security features
6379
6380 =item More functional bareword prototype (*)
6381
6382 =item C<require> and C<do> may be overridden
6383
6384 =item $^X variables may now have names longer than one character
6385
6386 =item New variable $^C reflects C<-c> switch
6387
6388 =item New variable $^V contains Perl version as a string
6389
6390 =item Optional Y2K warnings
6391
6392 =item Arrays now always interpolate into double-quoted strings
6393
6394 =back
6395
6396 =item Modules and Pragmata
6397
6398 =over 4
6399
6400 =item Modules
6401
6402 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6403 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6404 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6405 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6406 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6407 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6408 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6409 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6410
6411 =item Pragmata
6412
6413 =back
6414
6415 =item Utility Changes
6416
6417 =over 4
6418
6419 =item dprofpp
6420
6421 =item find2perl
6422
6423 =item h2xs
6424
6425 =item perlcc
6426
6427 =item perldoc
6428
6429 =item The Perl Debugger
6430
6431 =back
6432
6433 =item Improved Documentation
6434
6435 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6436 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6437 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6438 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6439
6440 =item Performance enhancements
6441
6442 =over 4
6443
6444 =item Simple sort() using { $a <=> $b } and the like are optimized
6445
6446 =item Optimized assignments to lexical variables
6447
6448 =item Faster subroutine calls
6449
6450 =item delete(), each(), values() and hash iteration are faster
6451
6452 =back
6453
6454 =item Installation and Configuration Improvements
6455
6456 =over 4
6457
6458 =item -Dusethreads means something different
6459
6460 =item New Configure flags
6461
6462 =item Threadedness and 64-bitness now more daring
6463
6464 =item Long Doubles
6465
6466 =item -Dusemorebits
6467
6468 =item -Duselargefiles
6469
6470 =item installusrbinperl
6471
6472 =item SOCKS support
6473
6474 =item C<-A> flag
6475
6476 =item Enhanced Installation Directories
6477
6478 =back
6479
6480 =item Platform specific changes
6481
6482 =over 4
6483
6484 =item Supported platforms
6485
6486 =item DOS
6487
6488 =item OS390 (OpenEdition MVS)
6489
6490 =item VMS
6491
6492 =item Win32
6493
6494 =back
6495
6496 =item Significant bug fixes
6497
6498 =over 4
6499
6500 =item <HANDLE> on empty files
6501
6502 =item C<eval '...'> improvements
6503
6504 =item All compilation errors are true errors
6505
6506 =item Implicitly closed filehandles are safer
6507
6508 =item Behavior of list slices is more consistent
6509
6510 =item C<(\$)> prototype and C<$foo{a}>
6511
6512 =item C<goto &sub> and AUTOLOAD
6513
6514 =item C<-bareword> allowed under C<use integer>
6515
6516 =item Failures in DESTROY()
6517
6518 =item Locale bugs fixed
6519
6520 =item Memory leaks
6521
6522 =item Spurious subroutine stubs after failed subroutine calls
6523
6524 =item Taint failures under C<-U>
6525
6526 =item END blocks and the C<-c> switch
6527
6528 =item Potential to leak DATA filehandles
6529
6530 =back
6531
6532 =item New or Changed Diagnostics
6533
6534 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6535 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6536 / cannot take a count, / must be followed by a, A or Z, / must be followed
6537 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6538 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6539 passed through, /%s/ should probably be written as "%s", %s() called too
6540 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6541 argument is not a HASH or ARRAY element or slice, %s argument is not a
6542 subroutine name, %s package attribute may clash with future reserved word:
6543 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6544 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6545 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6546 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6547 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6548 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6549 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6550 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6551 weaken a nonreference, Character class [:%s:] unknown, Character class
6552 syntax [%s] belongs inside character classes, Constant is not %s reference,
6553 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6554 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6555 "local" instead of "our"?), Document contains no data, entering effective
6556 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6557 output, flock() on closed filehandle %s, Global symbol "%s" requires
6558 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6559 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6560 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6561 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6562 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6563 separator character %s in attribute list, Invalid separator character %s in
6564 subroutine attribute list, leaving effective %s failed, Lvalue subs
6565 returning %s not implemented yet, Method %s not permitted, Missing
6566 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6567 No %s specified for -%c, No package name allowed for variable %s in "our",
6568 No space allowed after -%c, no UTC offset information; assuming local time
6569 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6570 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6571 around "%s" list, Possible unintended interpolation of %s in string,
6572 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6573 instead, Premature end of script headers, Repeat count in pack overflows,
6574 Repeat count in unpack overflows, realloc() of freed memory ignored,
6575 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6576 zero-length expression, switching effective %s is not implemented, This
6577 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6578 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6579 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6580 escape \\%c passed through, Unterminated attribute parameter in attribute
6581 list, Unterminated attribute list, Unterminated attribute parameter in
6582 subroutine attribute list, Unterminated subroutine attribute list, Value of
6583 CLI symbol "%s" too long, Version number must be a constant number
6584
6585 =item New tests
6586
6587 =item Incompatible Changes
6588
6589 =over 4
6590
6591 =item Perl Source Incompatibilities
6592
6593 CHECK is a new keyword, Treatment of list slices of undef has changed,
6594 Format of $English::PERL_VERSION is different, Literals of the form
6595 C<1.2.3> parse differently, Possibly changed pseudo-random number
6596 generator, Hashing function for hash keys has changed, C<undef> fails on
6597 read only values, Close-on-exec bit may be set on pipe and socket handles,
6598 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6599 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6600 Text of some diagnostic output has changed, C<%@> has been removed,
6601 Parenthesized not() behaves like a list operator, Semantics of bareword
6602 prototype C<(*)> have changed, Semantics of bit operators may have changed
6603 on 64-bit platforms, More builtins taint their results
6604
6605 =item C Source Incompatibilities
6606
6607 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6608
6609 =item Compatible C Source API Changes
6610
6611 C<PATCHLEVEL> is now C<PERL_VERSION>
6612
6613 =item Binary Incompatibilities
6614
6615 =back
6616
6617 =item Known Problems
6618
6619 =over 4
6620
6621 =item Thread test failures
6622
6623 =item EBCDIC platforms not supported
6624
6625 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6626
6627 =item NEXTSTEP 3.3 POSIX test failure
6628
6629 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6630 gcc
6631
6632 =item UNICOS/mk CC failures during Configure run
6633
6634 =item Arrow operator and arrays
6635
6636 =item Experimental features
6637
6638 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6639 pseudo-hash data type, The Compiler suite, Internal implementation of file
6640 globbing, The DB module, The regular expression code constructs:
6641
6642 =back
6643
6644 =item Obsolete Diagnostics
6645
6646 Character class syntax [: :] is reserved for future extensions, Ill-formed
6647 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6648 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6649 to mean "${$}<digit>" is deprecated
6650
6651 =item Reporting Bugs
6652
6653 =item SEE ALSO
6654
6655 =item HISTORY
6656
6657 =back
6658
6659 =head2 perl5005delta - what's new for perl5.005
6660
6661 =over 4
6662
6663 =item DESCRIPTION
6664
6665 =item About the new versioning system
6666
6667 =item Incompatible Changes
6668
6669 =over 4
6670
6671 =item WARNING:  This version is not binary compatible with Perl 5.004.
6672
6673 =item Default installation structure has changed
6674
6675 =item Perl Source Compatibility
6676
6677 =item C Source Compatibility
6678
6679 =item Binary Compatibility
6680
6681 =item Security fixes may affect compatibility
6682
6683 =item Relaxed new mandatory warnings introduced in 5.004
6684
6685 =item Licensing
6686
6687 =back
6688
6689 =item Core Changes
6690
6691 =over 4
6692
6693 =item Threads
6694
6695 =item Compiler
6696
6697 =item Regular Expressions
6698
6699 Many new and improved optimizations, Many bug fixes, New regular expression
6700 constructs, New operator for precompiled regular expressions, Other
6701 improvements, Incompatible changes
6702
6703 =item   Improved malloc()
6704
6705 =item Quicksort is internally implemented
6706
6707 =item Reliable signals
6708
6709 =item Reliable stack pointers
6710
6711 =item More generous treatment of carriage returns
6712
6713 =item Memory leaks
6714
6715 =item Better support for multiple interpreters
6716
6717 =item Behavior of local() on array and hash elements is now well-defined
6718
6719 =item C<%!> is transparently tied to the L<Errno> module
6720
6721 =item Pseudo-hashes are supported
6722
6723 =item C<EXPR foreach EXPR> is supported
6724
6725 =item Keywords can be globally overridden
6726
6727 =item C<$^E> is meaningful on Win32
6728
6729 =item C<foreach (1..1000000)> optimized
6730
6731 =item C<Foo::> can be used as implicitly quoted package name
6732
6733 =item C<exists $Foo::{Bar::}> tests existence of a package
6734
6735 =item Better locale support
6736
6737 =item Experimental support for 64-bit platforms
6738
6739 =item prototype() returns useful results on builtins
6740
6741 =item Extended support for exception handling
6742
6743 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6744
6745 =item All C<printf> format conversions are handled internally
6746
6747 =item New C<INIT> keyword
6748
6749 =item New C<lock> keyword
6750
6751 =item New C<qr//> operator
6752
6753 =item C<our> is now a reserved word
6754
6755 =item Tied arrays are now fully supported
6756
6757 =item Tied handles support is better
6758
6759 =item 4th argument to substr
6760
6761 =item Negative LENGTH argument to splice
6762
6763 =item Magic lvalues are now more magical
6764
6765 =item <> now reads in records
6766
6767 =back
6768
6769 =item Supported Platforms
6770
6771 =over 4
6772
6773 =item New Platforms
6774
6775 =item Changes in existing support
6776
6777 =back
6778
6779 =item Modules and Pragmata
6780
6781 =over 4
6782
6783 =item New Modules
6784
6785 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6786 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6787 Thread, attrs, fields, re
6788
6789 =item Changes in existing modules
6790
6791 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6792 MakeMaker, CPAN, Cwd
6793
6794 =back
6795
6796 =item Utility Changes
6797
6798 =item Documentation Changes
6799
6800 =item New Diagnostics
6801
6802 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6803 while coercing array into hash, Bareword "%s" refers to nonexistent
6804 package, Can't call method "%s" on an undefined value, Can't check
6805 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6806 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6807 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6808 for "%s", Character class syntax [. .] is reserved for future extensions,
6809 Character class syntax [: :] is reserved for future extensions, Character
6810 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6811 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6812 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6813 package main), Illegal hex digit ignored, No such array field, No such
6814 field "%s" in variable %s of type %s, Out of memory during ridiculously
6815 large request, Range iterator outside integer range, Recursive inheritance
6816 detected while looking for method '%s' %s, Reference found where even-sized
6817 list expected, Undefined value assigned to typeglob, Use of reserved word
6818 "%s" is deprecated, perl: warning: Setting locale failed
6819
6820 =item Obsolete Diagnostics
6821
6822 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6823 temporary file, regexp too big
6824
6825 =item Configuration Changes
6826
6827 =item BUGS
6828
6829 =item SEE ALSO
6830
6831 =item HISTORY
6832
6833 =back
6834
6835 =head2 perl5004delta - what's new for perl5.004
6836
6837 =over 4
6838
6839 =item DESCRIPTION
6840
6841 =item Supported Environments
6842
6843 =item Core Changes
6844
6845 =over 4
6846
6847 =item List assignment to %ENV works
6848
6849 =item Change to "Can't locate Foo.pm in @INC" error
6850
6851 =item Compilation option: Binary compatibility with 5.003
6852
6853 =item $PERL5OPT environment variable
6854
6855 =item Limitations on B<-M>, B<-m>, and B<-T> options
6856
6857 =item More precise warnings
6858
6859 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6860
6861 =item Previously deprecated %OVERLOAD is no longer usable
6862
6863 =item Subroutine arguments created only when they're modified
6864
6865 =item Group vector changeable with C<$)>
6866
6867 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6868
6869 =item Fixed localization of $<digit>, $&, etc.
6870
6871 =item No resetting of $. on implicit close
6872
6873 =item C<wantarray> may return undef
6874
6875 =item C<eval EXPR> determines value of EXPR in scalar context
6876
6877 =item Changes to tainting checks
6878
6879 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6880 spawning if tainted $TERM doesn't look like a terminal name
6881
6882 =item New Opcode module and revised Safe module
6883
6884 =item Embedding improvements
6885
6886 =item Internal change: FileHandle class based on IO::* classes
6887
6888 =item Internal change: PerlIO abstraction interface
6889
6890 =item New and changed syntax
6891
6892 $coderef->(PARAMS)
6893
6894 =item New and changed builtin constants
6895
6896 __PACKAGE__
6897
6898 =item New and changed builtin variables
6899
6900 $^E, $^H, $^M
6901
6902 =item New and changed builtin functions
6903
6904 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6905 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6906 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6907 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6908 nested C<sub{}> closures work now, formats work right on changing lexicals
6909
6910 =item New builtin methods
6911
6912 isa(CLASS), can(METHOD), VERSION( [NEED] )
6913
6914 =item TIEHANDLE now supported
6915
6916 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6917 LIST, READLINE this, GETC this, DESTROY this
6918
6919 =item Malloc enhancements
6920
6921 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6922
6923 =item Miscellaneous efficiency enhancements
6924
6925 =back
6926
6927 =item Support for More Operating Systems
6928
6929 =over 4
6930
6931 =item Win32
6932
6933 =item Plan 9
6934
6935 =item QNX
6936
6937 =item AmigaOS
6938
6939 =back
6940
6941 =item Pragmata
6942
6943 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6944 constant NAME => VALUE, use locale, use ops, use vmsish
6945
6946 =item Modules
6947
6948 =over 4
6949
6950 =item Required Updates
6951
6952 =item Installation directories
6953
6954 =item Module information summary
6955
6956 =item Fcntl
6957
6958 =item IO
6959
6960 =item Math::Complex
6961
6962 =item Math::Trig
6963
6964 =item DB_File
6965
6966 =item Net::Ping
6967
6968 =item Object-oriented overrides for builtin operators
6969
6970 =back
6971
6972 =item Utility Changes
6973
6974 =over 4
6975
6976 =item pod2html
6977
6978 Sends converted HTML to standard output
6979
6980 =item xsubpp
6981
6982 C<void> XSUBs now default to returning nothing
6983
6984 =back
6985
6986 =item C Language API Changes
6987
6988 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6989 manipulating hashes
6990
6991 =item Documentation Changes
6992
6993 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6994 L<perlmodlib>, L<perldebug>, L<perlsec>
6995
6996 =item New Diagnostics
6997
6998 "my" variable %s masks earlier declaration in same scope, %s argument is
6999 not a HASH element or slice, Allocation too large: %lx, Allocation too
7000 large, Applying %s to %s will act on scalar(%s), Attempt to free
7001 nonexistent shared string, Attempt to use reference as lvalue in substr,
7002 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7003 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7004 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7005 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7006 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7007 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7008 %s, Integer overflow in hex number, Integer overflow in octal number,
7009 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7010 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7011 possible typo, Null picture in formline, Offset outside string, Out of
7012 memory!, Out of memory during request for %s, panic: frexp, Possible
7013 attempt to put comments in qw() list, Possible attempt to separate words
7014 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7015 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7016 option, untie attempted while %d inner references still exist, Unrecognized
7017 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7018 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7019 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7020 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7021 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7022 long, Process terminated by SIG%s
7023
7024 =item BUGS
7025
7026 =item SEE ALSO
7027
7028 =item HISTORY
7029
7030 =back
7031
7032 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7033
7034 =over 4
7035
7036 =item DESCRIPTION
7037
7038 =over 4
7039
7040 =item Compiling Perl 5 on AIX
7041
7042 =item OS level
7043
7044 =item Building Dynamic Extensions on AIX
7045
7046 =item The IBM ANSI C Compiler
7047
7048 =item Using GNU's gcc for building perl
7049
7050 =item Using Large Files with Perl
7051
7052 =item Threaded Perl
7053
7054 =item 64-bit Perl
7055
7056 =item AIX 4.2 and extensions using C++ with statics
7057
7058 =back
7059
7060 =item AUTHOR
7061
7062 =item DATE
7063
7064 =back
7065
7066 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7067
7068 =over 4
7069
7070 =item DESCRIPTION
7071
7072 =item AUTHOR
7073
7074 =back
7075
7076 =head2 perlamiga - Perl under Amiga OS
7077
7078 =over 4
7079
7080 =item SYNOPSIS
7081
7082 =back
7083
7084 =over 4
7085
7086 =item DESCRIPTION
7087
7088 =over 4
7089
7090 =item Prerequisites for Compiling Perl on AmigaOS
7091
7092 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7093
7094 =item Starting Perl programs under AmigaOS
7095
7096 =item Shortcomings of Perl under AmigaOS
7097
7098 =back
7099
7100 =item INSTALLATION
7101
7102 =item Accessing documentation
7103
7104 =over 4
7105
7106 =item Manpages for Perl on AmigaOS
7107
7108 =item Perl HTML Documentation on AmigaOS
7109
7110 =item Perl GNU Info Files on AmigaOS
7111
7112 =item Perl LaTeX Documentation on AmigaOS
7113
7114 =back
7115
7116 =item BUILDING PERL ON AMIGAOS
7117
7118 =over 4
7119
7120 =item Build Prerequisites for Perl on AmigaOS
7121
7122 =item Getting the Perl Source for AmigaOS
7123
7124 =item Making Perl on AmigaOS
7125
7126 =item Testing Perl on AmigaOS
7127
7128 =item Installing the built Perl on AmigaOS
7129
7130 =back
7131
7132 =item AUTHORS
7133
7134 =item SEE ALSO
7135
7136 =back
7137
7138 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7139
7140 =over 4
7141
7142 =item DESCRIPTION
7143
7144 =over 4
7145
7146 =item General Issues with Perl on BeOS
7147
7148 =item BeOS Release-specific Notes
7149
7150 R4 x86, R4 PPC
7151
7152 =item Contact Information
7153
7154 =item Update 2002-03-02
7155
7156 =back
7157
7158 =back
7159
7160 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7161
7162 =over 4
7163
7164 =item SYNOPSIS
7165
7166 =item DESCRIPTION
7167
7168 =over 4
7169
7170 =item gzip on BS2000
7171
7172 =item bison on BS2000
7173
7174 =item Unpacking Perl Distribution on BS2000
7175
7176 =item Compiling Perl on BS2000
7177
7178 =item Testing Perl on BS2000
7179
7180 =item Installing Perl on BS2000
7181
7182 =item Using Perl in the Posix-Shell of BS2000
7183
7184 =item Using Perl in "native" BS2000
7185
7186 =item Floating point anomalies on BS2000
7187
7188 =back
7189
7190 =item AUTHORS
7191
7192 =item SEE ALSO
7193
7194 =over 4
7195
7196 =item Mailing list
7197
7198 =back
7199
7200 =item HISTORY
7201
7202 =back
7203
7204 =over 4
7205
7206 =item Name
7207
7208 =item Description
7209
7210 =item Build
7211
7212 =over 4
7213
7214 =item Tools & SDK
7215
7216 =item Make
7217
7218 =back
7219
7220 =item Acknowledgements
7221
7222 =item Author
7223
7224 =back
7225
7226 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7227
7228 =over 4
7229
7230 =item SYNOPSIS
7231
7232 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7233
7234 =over 4
7235
7236 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7237
7238 =item Cygwin Configuration
7239
7240 C<PATH>, I<nroff>, Permissions
7241
7242 =back
7243
7244 =item CONFIGURE PERL ON CYGWIN
7245
7246 =over 4
7247
7248 =item Stripping Perl Binaries on Cygwin
7249
7250 =item Optional Libraries for Perl on Cygwin
7251
7252 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7253 C<-lcygipc> (C<use IPC::SysV>)
7254
7255 =item Configure-time Options for Perl on Cygwin
7256
7257 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7258 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7259 C<-Dmksymlinks>
7260
7261 =item Suspicious Warnings on Cygwin
7262
7263 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7264
7265 =back
7266
7267 =item MAKE ON CYGWIN
7268
7269 =over 4
7270
7271 =item Warnings on Cygwin
7272
7273 =item ld2 on Cygwin
7274
7275 =back
7276
7277 =item TEST ON CYGWIN
7278
7279 =over 4
7280
7281 =item File Permissions on Cygwin
7282
7283 =item Script Portability on Cygwin
7284
7285 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7286
7287 =back
7288
7289 =item INSTALL PERL ON CYGWIN
7290
7291 =item MANIFEST ON CYGWIN
7292
7293 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7294 Source, Compiled Module Source, Perl Modules/Scripts
7295
7296 =item BUGS ON CYGWIN
7297
7298 =item AUTHORS
7299
7300 =item HISTORY
7301
7302 =back
7303
7304 =head2 perldgux - Perl under DG/UX.
7305
7306 =over 4
7307
7308 =item SYNOPSIS
7309
7310 =back
7311
7312 =over 4
7313
7314 =item DESCRIPTION
7315
7316 =item BUILDING PERL ON DG/UX
7317
7318 =over 4
7319
7320 =item Non-threaded Perl on DG/UX
7321
7322 =item Threaded Perl on DG/UX
7323
7324 =item Testing Perl on DG/UX
7325
7326 =item Installing the built perl on DG/UX
7327
7328 =back
7329
7330 =item AUTHOR
7331
7332 =item SEE ALSO
7333
7334 =back
7335
7336 =head2 perldos - Perl under DOS, W31, W95.
7337
7338 =over 4
7339
7340 =item SYNOPSIS
7341
7342 =item DESCRIPTION
7343
7344 =over 4
7345
7346 =item Prerequisites for Compiling Perl on DOS
7347
7348 DJGPP, Pthreads
7349
7350 =item Shortcomings of Perl under DOS
7351
7352 =item Building Perl on DOS
7353
7354 =item Testing Perl on DOS
7355
7356 =item Installation of Perl on DOS
7357
7358 =back
7359
7360 =item BUILDING AND INSTALLING MODULES ON DOS
7361
7362 =over 4
7363
7364 =item Building Prerequisites for Perl on DOS
7365
7366 =item Unpacking CPAN Modules on DOS
7367
7368 =item Building Non-XS Modules on DOS
7369
7370 =item Building XS Modules on DOS
7371
7372 =back
7373
7374 =item AUTHOR
7375
7376 =item SEE ALSO
7377
7378 =back
7379
7380 =head2 perlepoc, README.epoc - Perl for EPOC
7381
7382 =over 4
7383
7384 =item SYNOPSIS
7385
7386 =item INTRODUCTION
7387
7388 =item INSTALLING PERL ON EPOC
7389
7390 =item STARTING PERL ON EPOC
7391
7392 =item STOPPING PERL ON EPOC
7393
7394 =item USING PERL ON EPOC
7395
7396 =over 4
7397
7398 =item I/O Redirection on Epoc
7399
7400 =item PATH Names on Epoc
7401
7402 =item Editors on Epoc
7403
7404 =item Features of Perl on Epoc
7405
7406 =item Restrictions of Perl on Epoc
7407
7408 =item Compiling Perl 5 on the EPOC cross compiling environment
7409
7410 =back
7411
7412 =item SUPPORT STATUS OF PERL ON EPOC
7413
7414 =item AUTHOR
7415
7416 =item LAST UPDATE
7417
7418 =back
7419
7420 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7421 (HP-UX) systems
7422
7423 =over 4
7424
7425 =item DESCRIPTION
7426
7427 =over 4
7428
7429 =item Using perl as shipped with HP-UX
7430
7431 =item Compiling Perl 5 on HP-UX
7432
7433 =item PA-RISC
7434
7435 =item PA-RISC 1.0
7436
7437 =item PA-RISC 1.1
7438
7439 =item PA-RISC 2.0
7440
7441 =item Itanium
7442
7443 =item Portability Between PA-RISC Versions
7444
7445 =item Itanium Processor Family and HP-UX
7446
7447 =item Building Dynamic Extensions on HP-UX
7448
7449 =item The HP ANSI C Compiler
7450
7451 =item Using Large Files with Perl on HP-UX
7452
7453 =item Threaded Perl on HP-UX
7454
7455 =item 64-bit Perl on HP-UX
7456
7457 =item GDBM and Threads on HP-UX
7458
7459 =item NFS filesystems and utime(2) on HP-UX
7460
7461 =item perl -P and // and HP-UX
7462
7463 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7464
7465 =back
7466
7467 =item nss_delete core dump from op/pwent or op/grent
7468
7469 =item AUTHOR
7470
7471 =item DATE
7472
7473 =back
7474
7475 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7476
7477 =over 4
7478
7479 =item DESCRIPTION
7480
7481 =over 4
7482
7483 =item Known Problems with Perl on Hurd 
7484
7485 =back
7486
7487 =item AUTHOR
7488
7489 =back
7490
7491 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7492 systems
7493
7494 =over 4
7495
7496 =item DESCRIPTION
7497
7498 =over 4
7499
7500 =item Compiling Perl 5 on MachTen
7501
7502 =item Failures during C<make test> on MachTen
7503
7504 op/lexassign.t, pragma/warnings.t
7505
7506 =item Building external modules on MachTen
7507
7508 =back
7509
7510 =item AUTHOR
7511
7512 =item DATE
7513
7514 =back
7515
7516 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7517
7518 =over 4
7519
7520 =item SYNOPSIS
7521
7522 =item DESCRIPTION
7523
7524 =item AUTHOR
7525
7526 =item DATE
7527
7528 =back
7529
7530 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7531
7532 =over 4
7533
7534 =item DESCRIPTION
7535
7536 =item Known problems with Perl on MiNT
7537
7538 =item AUTHOR
7539
7540 =back
7541
7542 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7543
7544 =over 4
7545
7546 =item SYNOPSIS
7547
7548 =item NOTE
7549
7550 =item Binary distribution from HP
7551
7552 =item What's New in Perl for MPE/iX
7553
7554 =item Welcome to Perl/iX
7555
7556 =item System Requirements for Perl/iX
7557
7558 =item How to Obtain Perl/iX
7559
7560 =item Perl/iX Distribution Contents Highlights
7561
7562 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7563 public_html/feedback.cgi, src/perl-5.6.0-mpe
7564
7565 =item How to Compile Perl/iX
7566
7567  4,  6
7568
7569 =item Getting Started with Perl/iX
7570
7571 =item MPE/iX Implementation Considerations
7572
7573 =item Known Perl/iX Bugs Under Investigation
7574
7575 =item Perl/iX To-Do List
7576
7577 =item Perl/iX Change History
7578
7579 =item AUTHOR
7580
7581 =item Name
7582
7583 =item Description
7584
7585 =item Build
7586
7587 =over 4
7588
7589 =item Tools & SDK
7590
7591 =item Setup
7592
7593 Buildtype.bat, SetNWBld.bat, MPKBuild.bat
7594
7595 =item Make
7596
7597 =item Interpreter
7598
7599 =item Extensions
7600
7601 =back
7602
7603 =item Install
7604
7605 =item Build new extensions
7606
7607 =item Known Issues
7608
7609 =item Acknowledgements
7610
7611 =item Authors
7612
7613 =item Date
7614
7615 =back
7616
7617 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7618
7619 =over 4
7620
7621 =item SYNOPSIS
7622
7623 =back
7624
7625 =over 4
7626
7627 =item DESCRIPTION
7628
7629 =over 4
7630
7631 =item Target
7632
7633 =item Other OSes
7634
7635 =item Prerequisites
7636
7637 EMX, RSX, HPFS, pdksh
7638
7639 =item Starting Perl programs under OS/2 (and DOS and...)
7640
7641 =item Starting OS/2 (and DOS) programs under Perl
7642
7643 =back
7644
7645 =item Frequently asked questions
7646
7647 =over 4
7648
7649 =item "It does not work"
7650
7651 =item I cannot run external programs
7652
7653 =item I cannot embed perl into my program, or use F<perl.dll> from my
7654 program. 
7655
7656 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7657 L<ExtUtils::Embed>?
7658
7659 =item C<``> and pipe-C<open> do not work under DOS.
7660
7661 =item Cannot start C<find.exe "pattern" file>
7662
7663 =back
7664
7665 =item INSTALLATION
7666
7667 =over 4
7668
7669 =item Automatic binary installation
7670
7671 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7672
7673 =item Manual binary installation
7674
7675 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7676 (statically linked), Executables for Perl utilities, Main Perl library,
7677 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7678 and utilities, Manpages for Perl modules, Source for Perl documentation,
7679 Perl manual in F<.INF> format, Pdksh
7680
7681 =item B<Warning>
7682
7683 =back
7684
7685 =item Accessing documentation
7686
7687 =over 4
7688
7689 =item OS/2 F<.INF> file
7690
7691 =item Plain text
7692
7693 =item Manpages
7694
7695 =item HTML
7696
7697 =item GNU C<info> files
7698
7699 =item F<PDF> files
7700
7701 =item C<LaTeX> docs
7702
7703 =back
7704
7705 =item BUILD
7706
7707 =over 4
7708
7709 =item The short story
7710
7711 =item Prerequisites
7712
7713 =item Getting perl source
7714
7715 =item Application of the patches
7716
7717 =item Hand-editing
7718
7719 =item Making
7720
7721 =item Testing
7722
7723 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7724 F<op/stat.t>
7725
7726 =item Installing the built perl
7727
7728 =item C<a.out>-style build
7729
7730 =back
7731
7732 =item Build FAQ
7733
7734 =over 4
7735
7736 =item Some C</> became C<\> in pdksh.
7737
7738 =item C<'errno'> - unresolved external
7739
7740 =item Problems with tr or sed
7741
7742 =item Some problem (forget which ;-)
7743
7744 =item Library ... not found
7745
7746 =item Segfault in make
7747
7748 =item op/sprintf test failure
7749
7750 =back
7751
7752 =item Specific (mis)features of OS/2 port
7753
7754 =over 4
7755
7756 =item C<setpriority>, C<getpriority>
7757
7758 =item C<system()>
7759
7760 =item C<extproc> on the first line
7761
7762 =item Additional modules:
7763
7764 =item Prebuilt methods:
7765
7766 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7767  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
7768 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
7769 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
7770 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
7771 C<Cwd::extLibpath_set( path [, type ] )>,
7772 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7773 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7774 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7775 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7776 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7777
7778 =item Prebuilt variables:
7779
7780 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7781
7782 =item Misfeatures
7783
7784 =item Modifications
7785
7786 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7787 C<flock>
7788
7789 =item Identifying DLLs
7790
7791 =item Centralized management of resources
7792
7793 C<HAB>, C<HMQ>
7794
7795 =back
7796
7797 =item Perl flavors
7798
7799 =over 4
7800
7801 =item F<perl.exe>
7802
7803 =item F<perl_.exe>
7804
7805 =item F<perl__.exe>
7806
7807 =item F<perl___.exe>
7808
7809 =item Why strange names?
7810
7811 =item Why dynamic linking?
7812
7813 =item Why chimera build?
7814
7815 =back
7816
7817 =item ENVIRONMENT
7818
7819 =over 4
7820
7821 =item C<PERLLIB_PREFIX>
7822
7823 =item C<PERL_BADLANG>
7824
7825 =item C<PERL_BADFREE>
7826
7827 =item C<PERL_SH_DIR>
7828
7829 =item C<USE_PERL_FLOCK>
7830
7831 =item C<TMP> or C<TEMP>
7832
7833 =back
7834
7835 =item Evolution
7836
7837 =over 4
7838
7839 =item Priorities
7840
7841 =item DLL name mangling: pre 5.6.2
7842
7843 =item DLL name mangling: 5.6.2 and beyond
7844
7845 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7846 C<LIBPATH>
7847
7848 =item DLL forwarder generation
7849
7850 =item Threading
7851
7852 =item Calls to external programs
7853
7854 =item Memory allocation
7855
7856 =item Threads
7857
7858 C<COND_WAIT>, F<os2.c>
7859
7860 =back
7861
7862 =item BUGS
7863
7864 =back
7865
7866 =over 4
7867
7868 =item AUTHOR
7869
7870 =item SEE ALSO
7871
7872 =back
7873
7874 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7875 and z/OS
7876
7877 =over 4
7878
7879 =item SYNOPSIS
7880
7881 =item DESCRIPTION
7882
7883 =over 4
7884
7885 =item Tools
7886
7887 =item Unpacking Perl distribution on OS/390
7888
7889 =item Setup and utilities for Perl on OS/390
7890
7891 =item Configure Perl on OS/390
7892
7893 =item Build, Test, Install Perl on OS/390
7894
7895 =item Build Anomalies with Perl on OS/390
7896
7897 =item Testing Anomalies with Perl on OS/390
7898
7899 =item Installation Anomalies with Perl on OS/390
7900
7901 =item Usage Hints for Perl on OS/390
7902
7903 =item Floating Point Anomalies with Perl on OS/390
7904
7905 =item Modules and Extensions for Perl on OS/390
7906
7907 =back
7908
7909 =item AUTHORS
7910
7911 =item SEE ALSO
7912
7913 =over 4
7914
7915 =item Mailing list for Perl on OS/390
7916
7917 =back
7918
7919 =item HISTORY
7920
7921 =back
7922
7923 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7924
7925 =over 4
7926
7927 =item DESCRIPTION
7928
7929 =over 4
7930
7931 =item Required Software for Compiling Perl on QNX4
7932
7933 /bin/sh, ar, nm, cpp, make
7934
7935 =item Outstanding Issues with Perl on QNX4
7936
7937 =item QNX auxiliary files
7938
7939 qnx/ar, qnx/cpp
7940
7941 =item Outstanding issues with perl under QNX6
7942
7943 =back
7944
7945 =item AUTHOR
7946
7947 =back
7948
7949 =head2 perlplan9 - Plan 9-specific documentation for Perl
7950
7951 =over 4
7952
7953 =item DESCRIPTION
7954
7955 =over 4
7956
7957 =item Invoking Perl
7958
7959 =item What's in Plan 9 Perl
7960
7961 =item What's not in Plan 9 Perl
7962
7963 =item Perl5 Functions not currently supported in Plan 9 Perl
7964
7965 =item Signals in Plan 9 Perl
7966
7967 =back
7968
7969 =item COMPILING AND INSTALLING PERL ON PLAN 9
7970
7971 =over 4
7972
7973 =item Installing Perl Documentation on Plan 9
7974
7975 =back
7976
7977 =item BUGS
7978
7979 =item Revision date
7980
7981 =item AUTHOR
7982
7983 =back
7984
7985 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7986
7987 =over 4
7988
7989 =item DESCRIPTION
7990
7991 =over 4
7992
7993 =item Solaris Version Numbers.
7994
7995 =back
7996
7997 =item RESOURCES
7998
7999 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8000
8001 =item SETTING UP
8002
8003 =over 4
8004
8005 =item File Extraction Problems on Solaris.
8006
8007 =item Compiler and Related Tools on Solaris.
8008
8009 =item Environment for Compiling Perl on Solaris
8010
8011 =back
8012
8013 =item RUN CONFIGURE.
8014
8015 =over 4
8016
8017 =item 64-bit Issues with Perl on Solaris.
8018
8019 =item Threads in Perl on Solaris.
8020
8021 =item Malloc Issues with Perl on Solaris.
8022
8023 =back
8024
8025 =item MAKE PROBLEMS.
8026
8027 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8028 relocation error:, dlopen: stub interception failed, #error "No
8029 DATAMODEL_NATIVE specified", sh: ar: not found
8030
8031 =item MAKE TEST
8032
8033 =over 4
8034
8035 =item op/stat.t test 4 in Solaris
8036
8037 =item nss_delete core dump from op/pwent or op/grent
8038
8039 =back
8040
8041 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8042
8043 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8044
8045 =over 4
8046
8047 =item Limits on Numbers of Open Files on Solaris.
8048
8049 =back
8050
8051 =item SOLARIS-SPECIFIC MODULES.
8052
8053 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8054
8055 =over 4
8056
8057 =item Proc::ProcessTable on Solaris
8058
8059 =item BSD::Resource on Solaris
8060
8061 =item Net::SSLeay on Solaris
8062
8063 =back
8064
8065 =item AUTHOR
8066
8067 =item LAST MODIFIED
8068
8069 =back
8070
8071 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8072 Digital UNIX formerly known as DEC OSF/1) systems
8073
8074 =over 4
8075
8076 =item DESCRIPTION
8077
8078 =over 4
8079
8080 =item Compiling Perl 5 on Tru64
8081
8082 =item Using Large Files with Perl on Tru64
8083
8084 =item Threaded Perl on Tru64
8085
8086 =item Long Doubles on Tru64
8087
8088 =item 64-bit Perl on Tru64
8089
8090 =item Warnings about floating-point overflow when compiling Perl on Tru64
8091
8092 =back
8093
8094 =item Testing Perl on Tru64
8095
8096 =item AUTHOR
8097
8098 =back
8099
8100 =head2 perluts - Perl under UTS
8101
8102 =over 4
8103
8104 =item SYNOPSIS
8105
8106 =item DESCRIPTION
8107
8108 =item BUILDING PERL ON UTS
8109
8110 =item Installing the built perl on UTS
8111
8112 =item AUTHOR
8113
8114 =back
8115
8116 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8117
8118 =over 4
8119
8120 =item SYNOPSIS
8121
8122 =item DESCRIPTION
8123
8124 =over 4
8125
8126 =item Unpacking Perl Distribution on VM/ESA
8127
8128 =item Setup Perl and utilities on VM/ESA
8129
8130 =item Configure Perl on VM/ESA
8131
8132 =item Testing Anomalies of Perl on VM/ESA
8133
8134 =item Usage Hints for Perl on VM/ESA
8135
8136 =back
8137
8138 =item AUTHORS
8139
8140 =item SEE ALSO
8141
8142 =over 4
8143
8144 =item Mailing list for Perl on VM/ESA
8145
8146 =back
8147
8148 =back
8149
8150 =head2 perlvms - VMS-specific documentation for Perl
8151
8152 =over 4
8153
8154 =item DESCRIPTION
8155
8156 =item Installation
8157
8158 =item Organization of Perl Images
8159
8160 =over 4
8161
8162 =item Core Images
8163
8164 =item Perl Extensions
8165
8166 =item Installing static extensions
8167
8168 =item Installing dynamic extensions
8169
8170 =back
8171
8172 =item File specifications
8173
8174 =over 4
8175
8176 =item Syntax
8177
8178 =item Wildcard expansion
8179
8180 =item Pipes
8181
8182 =back
8183
8184 =item PERL5LIB and PERLLIB
8185
8186 =item Command line
8187
8188 =over 4
8189
8190 =item I/O redirection and backgrounding
8191
8192 =item Command line switches
8193
8194 -i, -S, -u
8195
8196 =back
8197
8198 =item Perl functions
8199
8200 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8201 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8202 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8203 LIST, waitpid PID,FLAGS
8204
8205 =item Perl variables
8206
8207 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8208
8209 =item Standard modules with VMS-specific differences
8210
8211 =over 4
8212
8213 =item SDBM_File
8214
8215 =back
8216
8217 =item Revision date
8218
8219 =item AUTHOR
8220
8221 =back
8222
8223 =head2 perlvos, README.vos - Perl for Stratus VOS
8224
8225 =over 4
8226
8227 =item SYNOPSIS
8228
8229 =over 4
8230
8231 =item Multiple methods to build perl for VOS
8232
8233 =item Stratus POSIX Support
8234
8235 =back
8236
8237 =item INSTALLING PERL IN VOS
8238
8239 =over 4
8240
8241 =item Compiling Perl 5 on VOS
8242
8243 =item Installing Perl 5 on VOS
8244
8245 =back
8246
8247 =item USING PERL IN VOS
8248
8249 =over 4
8250
8251 =item Unimplemented Features of Perl on VOS
8252
8253 =item Restrictions of Perl on VOS
8254
8255 =back
8256
8257 =item SUPPORT STATUS
8258
8259 =item AUTHOR
8260
8261 =item LAST UPDATE
8262
8263 =back
8264
8265 =head2 perlwin32 - Perl under Win32
8266
8267 =over 4
8268
8269 =item SYNOPSIS
8270
8271 =item DESCRIPTION
8272
8273 =over 4
8274
8275 =item Setting Up Perl on Win32
8276
8277 Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
8278
8279 =item Building
8280
8281 =item Testing Perl on Win32
8282
8283 =item Installation of Perl on Win32
8284
8285 =item Usage Hints for Perl on Win32
8286
8287 Environment Variables, File Globbing, Using perl from the command line,
8288 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8289 Extensions, Running Perl Scripts, Miscellaneous Things
8290
8291 =back
8292
8293 =item BUGS AND CAVEATS
8294
8295 =item AUTHORS
8296
8297 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8298 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8299 E<lt>nick@ing-simmons.netE<gt>
8300
8301 =item SEE ALSO
8302
8303 =item HISTORY
8304
8305 =back
8306
8307 =head1 PRAGMA DOCUMENTATION
8308
8309 =head2 attrs - set/get attributes of a subroutine (deprecated)
8310
8311 =over 4
8312
8313 =item SYNOPSIS
8314
8315 =item DESCRIPTION
8316
8317 method, locked
8318
8319 =back
8320
8321 =head2 re - Perl pragma to alter regular expression behaviour
8322
8323 =over 4
8324
8325 =item SYNOPSIS
8326
8327 =item DESCRIPTION
8328
8329 =back
8330
8331 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8332 data structures between threads
8333
8334 =over 4
8335
8336 =item SYNOPSIS
8337
8338 =item DESCRIPTION
8339
8340 =item EXPORT
8341
8342 =item FUNCTIONS
8343
8344 share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
8345 cond_signal VARIABLE, cond_broadcast VARIABLE
8346
8347 =item NOTES
8348
8349 =item BUGS
8350
8351 =item AUTHOR
8352
8353 =item SEE ALSO
8354
8355 =back
8356
8357 =head2 threads - Perl extension allowing use of interpreter based threads
8358 from perl
8359
8360 =over 4
8361
8362 =item SYNOPSIS
8363
8364 =item DESCRIPTION
8365
8366 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8367 threads->self, $thread->tid
8368
8369 =item TODO
8370
8371 Fix so the return value is returned when you join, Add join_all, Fix memory
8372 leaks!
8373
8374 =item AUTHOR and COPYRIGHT
8375
8376 =item BUGS
8377
8378 creating a thread from within a thread is unsafe under win32,
8379 PERL_OLD_SIGNALS are not threadsafe, will not be
8380
8381 =item SEE ALSO
8382
8383 =back
8384
8385 =head2 attributes - get/set subroutine or variable attributes
8386
8387 =over 4
8388
8389 =item SYNOPSIS
8390
8391 =item DESCRIPTION
8392
8393 =over 4
8394
8395 =item Built-in Attributes
8396
8397 locked, method, lvalue
8398
8399 =item Available Subroutines
8400
8401 get, reftype
8402
8403 =item Package-specific Attribute Handling
8404
8405 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8406
8407 =item Syntax of Attribute Lists
8408
8409 =back
8410
8411 =item EXPORTS
8412
8413 =over 4
8414
8415 =item Default exports
8416
8417 =item Available exports
8418
8419 =item Export tags defined
8420
8421 =back
8422
8423 =item EXAMPLES
8424
8425 =item SEE ALSO
8426
8427 =back
8428
8429 =head2 attrs - set/get attributes of a subroutine (deprecated)
8430
8431 =over 4
8432
8433 =item SYNOPSIS
8434
8435 =item DESCRIPTION
8436
8437 method, locked
8438
8439 =back
8440
8441 =head2 autouse - postpone load of modules until a function is used
8442
8443 =over 4
8444
8445 =item SYNOPSIS
8446
8447 =item DESCRIPTION
8448
8449 =item WARNING
8450
8451 =item AUTHOR
8452
8453 =item SEE ALSO
8454
8455 =back
8456
8457 =head2 base - Establish IS-A relationship with base class at compile time
8458
8459 =over 4
8460
8461 =item SYNOPSIS
8462
8463 =item DESCRIPTION
8464
8465 =item HISTORY
8466
8467 =item SEE ALSO
8468
8469 =back
8470
8471 =head2 blib - Use MakeMaker's uninstalled version of a package
8472
8473 =over 4
8474
8475 =item SYNOPSIS
8476
8477 =item DESCRIPTION
8478
8479 =item BUGS
8480
8481 =item AUTHOR
8482
8483 =back
8484
8485 =head2 bytes - Perl pragma to force byte semantics rather than character
8486 semantics
8487
8488 =over 4
8489
8490 =item SYNOPSIS
8491
8492 =item DESCRIPTION
8493
8494 =item SEE ALSO
8495
8496 =back
8497
8498 =head2 charnames - define character names for C<\N{named}> string literal
8499 escapes.
8500
8501 =over 4
8502
8503 =item SYNOPSIS
8504
8505 =item DESCRIPTION
8506
8507 =item CUSTOM TRANSLATORS
8508
8509 =item charnames::viacode(code)
8510
8511 =item charnames::vianame(code)
8512
8513 =item ILLEGAL CHARACTERS
8514
8515 =item BUGS
8516
8517 =back
8518
8519 =head2 constant - Perl pragma to declare constants
8520
8521 =over 4
8522
8523 =item SYNOPSIS
8524
8525 =item DESCRIPTION
8526
8527 =item NOTES
8528
8529 =over 4
8530
8531 =item List constants
8532
8533 =item Defining multiple constants at once
8534
8535 =item Magic constants
8536
8537 =back
8538
8539 =item TECHNICAL NOTES
8540
8541 =item BUGS
8542
8543 =item AUTHOR
8544
8545 =item COPYRIGHT
8546
8547 =back
8548
8549 =head2 diagnostics - Perl compiler pragma to force verbose warning
8550 diagnostics
8551
8552 =over 4
8553
8554 =item SYNOPSIS
8555
8556 =item DESCRIPTION
8557
8558 =over 4
8559
8560 =item The C<diagnostics> Pragma
8561
8562 =item The I<splain> Program
8563
8564 =back
8565
8566 =item EXAMPLES
8567
8568 =item INTERNALS
8569
8570 =item BUGS
8571
8572 =item AUTHOR
8573
8574 =back
8575
8576 =head2 encoding - pragma to control the conversion of legacy data into
8577 Unicode
8578
8579 =over 4
8580
8581 =item SYNOPSIS
8582
8583 =item DESCRIPTION
8584
8585 =item KNOWN PROBLEMS
8586
8587 =item SEE ALSO
8588
8589 =back
8590
8591 =head2 fields - compile-time class fields
8592
8593 =over 4
8594
8595 =item SYNOPSIS
8596
8597 =item DESCRIPTION
8598
8599 new, phash
8600
8601 =item SEE ALSO
8602
8603 =back
8604
8605 =head2 filetest - Perl pragma to control the filetest permission operators
8606
8607 =over 4
8608
8609 =item SYNOPSIS
8610
8611 =item DESCRIPTION
8612
8613 =over 4
8614
8615 =item subpragma access
8616
8617 =back
8618
8619 =back
8620
8621 =head2 if - C<use> a Perl module if a condition holds
8622
8623 =over 4
8624
8625 =item SYNOPSIS
8626
8627 =item DESCRIPTION
8628
8629 =item BUGS
8630
8631 =item AUTHOR
8632
8633 =back
8634
8635 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8636 point
8637
8638 =over 4
8639
8640 =item SYNOPSIS
8641
8642 =item DESCRIPTION
8643
8644 =back
8645
8646 =head2 less - perl pragma to request less of something from the compiler
8647
8648 =over 4
8649
8650 =item SYNOPSIS
8651
8652 =item DESCRIPTION
8653
8654 =back
8655
8656 =head2 lib - manipulate @INC at compile time
8657
8658 =over 4
8659
8660 =item SYNOPSIS
8661
8662 =item DESCRIPTION
8663
8664 =over 4
8665
8666 =item Adding directories to @INC
8667
8668 =item Deleting directories from @INC
8669
8670 =item Restoring original @INC
8671
8672 =back
8673
8674 =item CAVEATS
8675
8676 =item SEE ALSO
8677
8678 =item AUTHOR
8679
8680 =back
8681
8682 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8683 operations
8684
8685 =over 4
8686
8687 =item SYNOPSIS
8688
8689 =item DESCRIPTION
8690
8691 =back
8692
8693 =head2 open - perl pragma to set default disciplines for input and output
8694
8695 =over 4
8696
8697 =item SYNOPSIS
8698
8699 =item DESCRIPTION
8700
8701 =item NONPERLIO FUNCTIONALITY
8702
8703 =item IMPLEMENTATION DETAILS
8704
8705 =item SEE ALSO
8706
8707 =back
8708
8709 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8710
8711 =over 4
8712
8713 =item SYNOPSIS  
8714
8715 =item DESCRIPTION
8716
8717 =item SEE ALSO
8718
8719 =back
8720
8721 =head2 overload - Package for overloading perl operations
8722
8723 =over 4
8724
8725 =item SYNOPSIS
8726
8727 =item DESCRIPTION
8728
8729 =over 4
8730
8731 =item Declaration of overloaded functions
8732
8733 =item Calling Conventions for Binary Operations
8734
8735 FALSE, TRUE, C<undef>
8736
8737 =item Calling Conventions for Unary Operations
8738
8739 =item Calling Conventions for Mutators
8740
8741 C<++> and C<-->, C<x=> and other assignment versions
8742
8743 =item Overloadable Operations
8744
8745 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8746 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8747 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8748
8749 =item Inheritance and overloading
8750
8751 Strings as values of C<use overload> directive, Overloading of an operation
8752 is inherited by derived classes
8753
8754 =back
8755
8756 =item SPECIAL SYMBOLS FOR C<use overload>
8757
8758 =over 4
8759
8760 =item Last Resort
8761
8762 =item Fallback
8763
8764 C<undef>, TRUE, defined, but FALSE
8765
8766 =item Copy Constructor
8767
8768 B<Example>
8769
8770 =back
8771
8772 =item MAGIC AUTOGENERATION
8773
8774 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8775 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8776 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8777 I<Copy operator>
8778
8779 =item Losing overloading
8780
8781 =item Run-time Overloading
8782
8783 =item Public functions
8784
8785 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8786
8787 =item Overloading constants
8788
8789 integer, float, binary, q, qr
8790
8791 =item IMPLEMENTATION
8792
8793 =item Metaphor clash
8794
8795 =item Cookbook
8796
8797 =over 4
8798
8799 =item Two-face scalars
8800
8801 =item Two-face references
8802
8803 =item Symbolic calculator
8804
8805 =item I<Really> symbolic calculator
8806
8807 =back
8808
8809 =item AUTHOR
8810
8811 =item DIAGNOSTICS
8812
8813 Odd number of arguments for overload::constant, `%s' is not an overloadable
8814 type, `%s' is not a code reference
8815
8816 =item BUGS
8817
8818 =back
8819
8820 =head2 re - Perl pragma to alter regular expression behaviour
8821
8822 =over 4
8823
8824 =item SYNOPSIS
8825
8826 =item DESCRIPTION
8827
8828 =back
8829
8830 =head2 sigtrap - Perl pragma to enable simple signal handling
8831
8832 =over 4
8833
8834 =item SYNOPSIS
8835
8836 =item DESCRIPTION
8837
8838 =item OPTIONS
8839
8840 =over 4
8841
8842 =item SIGNAL HANDLERS
8843
8844 B<stack-trace>, B<die>, B<handler> I<your-handler>
8845
8846 =item SIGNAL LISTS
8847
8848 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8849
8850 =item OTHER
8851
8852 B<untrapped>, B<any>, I<signal>, I<number>
8853
8854 =back
8855
8856 =item EXAMPLES
8857
8858 =back
8859
8860 =head2 sort - perl pragma to control sort() behaviour
8861
8862 =over 4
8863
8864 =item SYNOPSIS
8865
8866 =item DESCRIPTION
8867
8868 =back
8869
8870 =head2 strict - Perl pragma to restrict unsafe constructs
8871
8872 =over 4
8873
8874 =item SYNOPSIS
8875
8876 =item DESCRIPTION
8877
8878 C<strict refs>, C<strict vars>, C<strict subs>
8879
8880 =back
8881
8882 =head2 subs - Perl pragma to predeclare sub names
8883
8884 =over 4
8885
8886 =item SYNOPSIS
8887
8888 =item DESCRIPTION
8889
8890 =back
8891
8892 =head2 threads - Perl extension allowing use of interpreter based threads
8893 from perl
8894
8895 =over 4
8896
8897 =item SYNOPSIS
8898
8899 =item DESCRIPTION
8900
8901 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8902 threads->self, $thread->tid
8903
8904 =item TODO
8905
8906 Fix so the return value is returned when you join, Add join_all, Fix memory
8907 leaks!
8908
8909 =item AUTHOR and COPYRIGHT
8910
8911 =item BUGS
8912
8913 creating a thread from within a thread is unsafe under win32,
8914 PERL_OLD_SIGNALS are not threadsafe, will not be
8915
8916 =item SEE ALSO
8917
8918 =back
8919
8920 =head2 threadshared, threads::shared - Perl extension for sharing data
8921 structures between threads
8922
8923 =over 4
8924
8925 =item SYNOPSIS
8926
8927 =item DESCRIPTION
8928
8929 =item EXPORT
8930
8931 =item FUNCTIONS
8932
8933 share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
8934 cond_signal VARIABLE, cond_broadcast VARIABLE
8935
8936 =item NOTES
8937
8938 =item BUGS
8939
8940 =item AUTHOR
8941
8942 =item SEE ALSO
8943
8944 =back
8945
8946 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
8947 code
8948
8949 =over 4
8950
8951 =item SYNOPSIS
8952
8953 =item DESCRIPTION
8954
8955 =over 4
8956
8957 =item Utility functions
8958
8959 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
8960 utf8::encode($string), $flag = utf8::decode($string)
8961
8962 =back
8963
8964 =item SEE ALSO
8965
8966 =back
8967
8968 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
8969
8970 =over 4
8971
8972 =item SYNOPSIS
8973
8974 =item DESCRIPTION
8975
8976 =back
8977
8978 =head2 vmsish - Perl pragma to control VMS-specific language features
8979
8980 =over 4
8981
8982 =item SYNOPSIS
8983
8984 =item DESCRIPTION
8985
8986 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
8987
8988 =back
8989
8990 =head2 warnings - Perl pragma to control optional warnings
8991
8992 =over 4
8993
8994 =item SYNOPSIS
8995
8996 =item DESCRIPTION
8997
8998 use warnings::register, warnings::enabled(), warnings::enabled($category),
8999 warnings::enabled($object), warnings::warn($message),
9000 warnings::warn($category, $message), warnings::warn($object, $message),
9001 warnings::warnif($message), warnings::warnif($category, $message),
9002 warnings::warnif($object, $message)
9003
9004 =back
9005
9006 =head2 warnings::register - warnings import function
9007
9008 =over 4
9009
9010 =item SYNOPSIS
9011
9012 =item DESCRIPTION
9013
9014 =back
9015
9016 =head1 MODULE DOCUMENTATION
9017
9018 =head2 AnyDBM_File - provide framework for multiple DBMs
9019
9020 =over 4
9021
9022 =item SYNOPSIS
9023
9024 =item DESCRIPTION
9025
9026 =over 4
9027
9028 =item DBM Comparisons
9029
9030 [0], [1], [2], [3]
9031
9032 =back
9033
9034 =item SEE ALSO
9035
9036 =back
9037
9038 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9039
9040 =over 4
9041
9042 =item VERSION
9043
9044 =item SYNOPSIS
9045
9046 =item DESCRIPTION
9047
9048 [0], [1], [2], [3], [4], [5]
9049
9050 =over 4
9051
9052 =item Typed lexicals
9053
9054 =item Type-specific attribute handlers
9055
9056 =item Non-interpretive attribute handlers
9057
9058 =item Phase-specific attribute handlers
9059
9060 =item Attributes as C<tie> interfaces
9061
9062 =back
9063
9064 =item EXAMPLES
9065
9066 =item DIAGNOSTICS
9067
9068 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9069 attributes>, C<Declaration of %s attribute in package %s may clash with
9070 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9071 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9072 be able to apply END handler>
9073
9074 =item AUTHOR
9075
9076 =item BUGS
9077
9078 =item COPYRIGHT
9079
9080 =back
9081
9082 =head2 AutoLoader - load subroutines only on demand
9083
9084 =over 4
9085
9086 =item SYNOPSIS
9087
9088 =item DESCRIPTION
9089
9090 =over 4
9091
9092 =item Subroutine Stubs
9093
9094 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9095
9096 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9097
9098 =item Package Lexicals
9099
9100 =item Not Using AutoLoader
9101
9102 =item B<AutoLoader> vs. B<SelfLoader>
9103
9104 =back
9105
9106 =item CAVEATS
9107
9108 =item SEE ALSO
9109
9110 =back
9111
9112 =head2 AutoSplit - split a package for autoloading
9113
9114 =over 4
9115
9116 =item SYNOPSIS
9117
9118 =item DESCRIPTION
9119
9120 $keep, $check, $modtime
9121
9122 =over 4
9123
9124 =item Multiple packages
9125
9126 =back
9127
9128 =item DIAGNOSTICS
9129
9130 =back
9131
9132 =head2 B - The Perl Compiler
9133
9134 =over 4
9135
9136 =item SYNOPSIS
9137
9138 =item DESCRIPTION
9139
9140 =item OVERVIEW OF CLASSES
9141
9142 =over 4
9143
9144 =item SV-RELATED CLASSES
9145
9146 =item B::SV METHODS
9147
9148 REFCNT, FLAGS
9149
9150 =item B::IV METHODS
9151
9152 IV, IVX, UVX, int_value, needs64bits, packiv
9153
9154 =item B::NV METHODS
9155
9156 NV, NVX
9157
9158 =item B::RV METHODS
9159
9160 RV
9161
9162 =item B::PV METHODS
9163
9164 PV, RV, PVX
9165
9166 =item B::PVMG METHODS
9167
9168 MAGIC, SvSTASH
9169
9170 =item B::MAGIC METHODS
9171
9172 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9173
9174 =item B::PVLV METHODS
9175
9176 TARGOFF, TARGLEN, TYPE, TARG
9177
9178 =item B::BM METHODS
9179
9180 USEFUL, PREVIOUS, RARE, TABLE
9181
9182 =item B::GV METHODS
9183
9184 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9185 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9186
9187 =item B::IO METHODS
9188
9189 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9190 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9191
9192 =item B::AV METHODS
9193
9194 FILL, MAX, OFF, ARRAY, AvFLAGS
9195
9196 =item B::CV METHODS
9197
9198 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9199 CvFLAGS, const_sv
9200
9201 =item B::HV METHODS
9202
9203 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9204
9205 =item OP-RELATED CLASSES
9206
9207 =item B::OP METHODS
9208
9209 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9210
9211 =item B::UNOP METHOD
9212
9213 first
9214
9215 =item B::BINOP METHOD
9216
9217 last
9218
9219 =item B::LOGOP METHOD
9220
9221 other
9222
9223 =item B::LISTOP METHOD
9224
9225 children
9226
9227 =item B::PMOP METHODS
9228
9229 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9230 pmpermflags, precomp, pmoffet
9231
9232 =item B::SVOP METHOD
9233
9234 sv, gv
9235
9236 =item B::PADOP METHOD
9237
9238 padix
9239
9240 =item B::PVOP METHOD
9241
9242 pv
9243
9244 =item B::LOOP METHODS
9245
9246 redoop, nextop, lastop
9247
9248 =item B::COP METHODS
9249
9250 label, stash, file, cop_seq, arybase, line
9251
9252 =back
9253
9254 =item FUNCTIONS EXPORTED BY C<B>
9255
9256 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9257 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9258 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9259 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9260 cstring(STR), class(OBJ), threadsv_names
9261
9262 =item AUTHOR
9263
9264 =back
9265
9266 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9267 bytecode
9268
9269 =over 4
9270
9271 =item SYNOPSIS
9272
9273 =item DESCRIPTION
9274
9275 %insn_data, @insn_name, @optype, @specialsv_name
9276
9277 =item AUTHOR
9278
9279 =back
9280
9281 =head2 B::Assembler - Assemble Perl bytecode
9282
9283 =over 4
9284
9285 =item SYNOPSIS
9286
9287 =item DESCRIPTION
9288
9289 =item AUTHORS
9290
9291 =back
9292
9293 =head2 B::Bblock - Walk basic blocks
9294
9295 =over 4
9296
9297 =item SYNOPSIS
9298
9299 =item DESCRIPTION
9300
9301 =over 4
9302
9303 =item Functions
9304
9305 B<find_leaders>
9306
9307 =back
9308
9309 =item AUTHOR
9310
9311 =back
9312
9313 =head2 B::Bytecode - Perl compiler's bytecode backend
9314
9315 =over 4
9316
9317 =item SYNOPSIS
9318
9319 =item DESCRIPTION
9320
9321 =item OPTIONS
9322
9323 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9324 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9325 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9326
9327 =item EXAMPLES
9328
9329 =item BUGS
9330
9331 =item AUTHORS
9332
9333 =back
9334
9335 =head2 B::C - Perl compiler's C backend
9336
9337 =over 4
9338
9339 =item SYNOPSIS
9340
9341 =item DESCRIPTION
9342
9343 =item OPTIONS
9344
9345 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9346 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9347 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9348 B<-llimit>
9349
9350 =item EXAMPLES
9351
9352 =item BUGS
9353
9354 =item AUTHOR
9355
9356 =back
9357
9358 =head2 B::CC - Perl compiler's optimized C translation backend
9359
9360 =over 4
9361
9362 =item SYNOPSIS
9363
9364 =item DESCRIPTION
9365
9366 =item OPTIONS
9367
9368 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9369 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9370 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9371
9372 =item EXAMPLES
9373
9374 =item BUGS
9375
9376 =item DIFFERENCES
9377
9378 =over 4
9379
9380 =item Loops
9381
9382 =item Context of ".."
9383
9384 =item Arithmetic
9385
9386 =item Deprecated features
9387
9388 =back
9389
9390 =item AUTHOR
9391
9392 =back
9393
9394 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9395
9396 =over 4
9397
9398 =item SYNOPSIS
9399
9400 =item DESCRIPTION
9401
9402 =item EXAMPLE
9403
9404 =item OPTIONS
9405
9406 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9407 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9408 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9409
9410 =item FORMATTING SPECIFICATIONS
9411
9412 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9413 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9414 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9415 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9416 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9417 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9418 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9419 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9420
9421 =item ABBREVIATIONS
9422
9423 =over 4
9424
9425 =item OP flags abbreviations
9426
9427 =item OP class abbreviations
9428
9429 =back
9430
9431 =item Using B::Concise outside of the O framework
9432
9433 =item AUTHOR
9434
9435 =back
9436
9437 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9438
9439 =over 4
9440
9441 =item SYNOPSIS
9442
9443 =item DESCRIPTION
9444
9445 =item AUTHOR
9446
9447 =back
9448
9449 =head2 B::Deparse - Perl compiler backend to produce perl code
9450
9451 =over 4
9452
9453 =item SYNOPSIS
9454
9455 =item DESCRIPTION
9456
9457 =item OPTIONS
9458
9459 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9460 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9461
9462 =item USING B::Deparse AS A MODULE
9463
9464 =over 4
9465
9466 =item Synopsis
9467
9468 =item Description
9469
9470 =item new
9471
9472 =item ambient_pragmas
9473
9474 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9475
9476 =item coderef2text
9477
9478 =back
9479
9480 =item BUGS
9481
9482 =item AUTHOR
9483
9484 =back
9485
9486 =head2 B::Disassembler - Disassemble Perl bytecode
9487
9488 =over 4
9489
9490 =item SYNOPSIS
9491
9492 =item DESCRIPTION
9493
9494 =item AUTHOR
9495
9496 =back
9497
9498 =head2 B::Lint - Perl lint
9499
9500 =over 4
9501
9502 =item SYNOPSIS
9503
9504 =item DESCRIPTION
9505
9506 =item OPTIONS AND LINT CHECKS
9507
9508 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9509 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9510
9511 =item NON LINT-CHECK OPTIONS
9512
9513 B<-u Package>
9514
9515 =item BUGS
9516
9517 =item AUTHOR
9518
9519 =back
9520
9521 =head2 B::O, O - Generic interface to Perl Compiler backends
9522
9523 =over 4
9524
9525 =item SYNOPSIS
9526
9527 =item DESCRIPTION
9528
9529 =item CONVENTIONS
9530
9531 =item IMPLEMENTATION
9532
9533 =item AUTHOR
9534
9535 =back
9536
9537 =head2 B::Showlex - Show lexical variables used in functions or files
9538
9539 =over 4
9540
9541 =item SYNOPSIS
9542
9543 =item DESCRIPTION
9544
9545 =item AUTHOR
9546
9547 =back
9548
9549 =head2 B::Stackobj - Helper module for CC backend
9550
9551 =over 4
9552
9553 =item SYNOPSIS
9554
9555 =item DESCRIPTION
9556
9557 =item AUTHOR
9558
9559 =back
9560
9561 =head2 B::Stash - show what stashes are loaded
9562
9563 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9564
9565 =over 4
9566
9567 =item SYNOPSIS
9568
9569 =item DESCRIPTION
9570
9571 =item AUTHOR
9572
9573 =back
9574
9575 =head2 B::Xref - Generates cross reference reports for Perl programs
9576
9577 =over 4
9578
9579 =item SYNOPSIS
9580
9581 =item DESCRIPTION
9582
9583 =item OPTIONS
9584
9585 C<-oFILENAME>, C<-r>, C<-D[tO]>
9586
9587 =item BUGS
9588
9589 =item AUTHOR
9590
9591 =back
9592
9593 =head2 Bblock, B::Bblock - Walk basic blocks
9594
9595 =over 4
9596
9597 =item SYNOPSIS
9598
9599 =item DESCRIPTION
9600
9601 =over 4
9602
9603 =item Functions
9604
9605 B<find_leaders>
9606
9607 =back
9608
9609 =item AUTHOR
9610
9611 =back
9612
9613 =head2 Benchmark - benchmark running times of Perl code
9614
9615 =over 4
9616
9617 =item SYNOPSIS
9618
9619 =item DESCRIPTION
9620
9621 =over 4
9622
9623 =item Methods
9624
9625 new, debug, iters
9626
9627 =item Standard Exports
9628
9629 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9630 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9631 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9632
9633 =item Optional Exports
9634
9635 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9636 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9637 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9638
9639 =back
9640
9641 =item NOTES
9642
9643 =item EXAMPLES
9644
9645 =item INHERITANCE
9646
9647 =item CAVEATS
9648
9649 =item SEE ALSO
9650
9651 =item AUTHORS
9652
9653 =item MODIFICATION HISTORY
9654
9655 =back
9656
9657 =head2 ByteLoader - load byte compiled perl code
9658
9659 =over 4
9660
9661 =item SYNOPSIS
9662
9663 =item DESCRIPTION
9664
9665 =item AUTHOR
9666
9667 =item SEE ALSO
9668
9669 =back
9670
9671 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9672
9673 =over 4
9674
9675 =item SYNOPSIS
9676
9677 =item DESCRIPTION
9678
9679 =item OPTIONS
9680
9681 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9682 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9683 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9684
9685 =item EXAMPLES
9686
9687 =item BUGS
9688
9689 =item AUTHORS
9690
9691 =back
9692
9693 =head2 CGI - Simple Common Gateway Interface Class
9694
9695 =over 4
9696
9697 =item SYNOPSIS
9698
9699 =item ABSTRACT
9700
9701 =item DESCRIPTION
9702
9703 =over 4
9704
9705 =item PROGRAMMING STYLE
9706
9707 =item CALLING CGI.PM ROUTINES
9708
9709 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9710
9711 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9712
9713 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9714
9715 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9716
9717 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9718
9719 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9720
9721 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9722
9723 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9724
9725 =item DELETING A PARAMETER COMPLETELY:
9726
9727 =item DELETING ALL PARAMETERS:
9728
9729 =item DIRECT ACCESS TO THE PARAMETER LIST:
9730
9731 =item FETCHING THE PARAMETER LIST AS A HASH:
9732
9733 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9734
9735 =item RETRIEVING CGI ERRORS
9736
9737 =item USING THE FUNCTION-ORIENTED INTERFACE
9738
9739 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9740 B<:standard>, B<:all>
9741
9742 =item PRAGMAS
9743
9744 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9745 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9746 -private_tempfiles
9747
9748 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9749
9750 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9751 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9752 a </ul> tag)
9753
9754 =back
9755
9756 =item GENERATING DYNAMIC DOCUMENTS
9757
9758 =over 4
9759
9760 =item CREATING A STANDARD HTTP HEADER:
9761
9762 =item GENERATING A REDIRECTION HEADER
9763
9764 =item CREATING THE HTML DOCUMENT HEADER
9765
9766 B<Parameters:>, 4, 5, 6..
9767
9768 =item ENDING THE HTML DOCUMENT:
9769
9770 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9771
9772 =item OBTAINING THE SCRIPT'S URL
9773
9774 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9775 (B<-query_string>), B<-base>
9776
9777 =item MIXING POST AND URL PARAMETERS
9778
9779 =back
9780
9781 =item CREATING STANDARD HTML ELEMENTS:
9782
9783 =over 4
9784
9785 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9786
9787 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9788
9789 =item HTML SHORTCUTS AND LIST INTERPOLATION
9790
9791 =item NON-STANDARD HTML SHORTCUTS
9792
9793 =item AUTOESCAPING HTML
9794
9795 $escaped_string = escapeHTML("unescaped string");, $charset =
9796 charset([$charset]);, $flag = autoEscape([$flag]);
9797
9798 =item PRETTY-PRINTING HTML
9799
9800 =back
9801
9802 =item CREATING FILL-OUT FORMS:
9803
9804 =over 4
9805
9806 =item CREATING AN ISINDEX TAG
9807
9808 =item STARTING AND ENDING A FORM
9809
9810 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9811
9812 =item CREATING A TEXT FIELD
9813
9814 B<Parameters>
9815
9816 =item CREATING A BIG TEXT FIELD
9817
9818 =item CREATING A PASSWORD FIELD
9819
9820 =item CREATING A FILE UPLOAD FIELD
9821
9822 B<Parameters>
9823
9824 =item CREATING A POPUP MENU
9825
9826 =item CREATING A SCROLLING LIST
9827
9828 B<Parameters:>
9829
9830 =item CREATING A GROUP OF RELATED CHECKBOXES
9831
9832 B<Parameters:>
9833
9834 =item CREATING A STANDALONE CHECKBOX
9835
9836 B<Parameters:>
9837
9838 =item CREATING A RADIO BUTTON GROUP
9839
9840 B<Parameters:>
9841
9842 =item CREATING A SUBMIT BUTTON 
9843
9844 B<Parameters:>
9845
9846 =item CREATING A RESET BUTTON
9847
9848 =item CREATING A DEFAULT BUTTON
9849
9850 =item CREATING A HIDDEN FIELD
9851
9852 B<Parameters:>
9853
9854 =item CREATING A CLICKABLE IMAGE BUTTON
9855
9856 B<Parameters:>
9857
9858 =item CREATING A JAVASCRIPT ACTION BUTTON
9859
9860 =back
9861
9862 =item HTTP COOKIES
9863
9864 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
9865 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
9866
9867 =item WORKING WITH FRAMES
9868
9869 1. Create a <Frameset> document, 2. Specify the destination for the
9870 document in the HTTP header, 3. Specify the destination for the document in
9871 the <form> tag
9872
9873 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
9874
9875 =item DEBUGGING
9876
9877 =over 4
9878
9879 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
9880
9881 =back
9882
9883 =item FETCHING ENVIRONMENT VARIABLES
9884
9885 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
9886 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
9887 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
9888 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
9889 B<request_method()>, B<content_type()>, B<http()>, B<https()>
9890
9891 =item USING NPH SCRIPTS
9892
9893 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
9894 parameters
9895
9896 =item Server Push
9897
9898 multipart_init(), multipart_start(), multipart_end(), multipart_final()
9899
9900 =item Avoiding Denial of Service Attacks
9901
9902 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
9903 basis>, B<2. Globally for all scripts>
9904
9905 =item COMPATIBILITY WITH CGI-LIB.PL
9906
9907 =item AUTHOR INFORMATION
9908
9909 =item CREDITS
9910
9911 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
9912 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
9913 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
9914 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
9915 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
9916 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
9917 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
9918 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
9919 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
9920 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
9921 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
9922 ...and many many more..
9923
9924 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
9925
9926 =item BUGS
9927
9928 =item SEE ALSO
9929
9930 =back
9931
9932 =head2 CGI::Apache - Backward compatibility module for CGI.pm
9933
9934 =over 4
9935
9936 =item SYNOPSIS
9937
9938 =item ABSTRACT
9939
9940 =item DESCRIPTION
9941
9942 =item AUTHOR INFORMATION
9943
9944 =item BUGS
9945
9946 =item SEE ALSO
9947
9948 =back
9949
9950 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
9951 other) error log
9952
9953 =over 4
9954
9955 =item SYNOPSIS
9956
9957 =item DESCRIPTION
9958
9959 =item REDIRECTING ERROR MESSAGES
9960
9961 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
9962
9963 =over 4
9964
9965 =item Changing the default message
9966
9967 =back
9968
9969 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
9970
9971 =item CHANGE LOG
9972
9973 =item AUTHORS
9974
9975 =item SEE ALSO
9976
9977 =back
9978
9979 =head2 CGI::Cookie - Interface to Netscape Cookies
9980
9981 =over 4
9982
9983 =item SYNOPSIS
9984
9985 =item DESCRIPTION
9986
9987 =item USING CGI::Cookie
9988
9989 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
9990
9991 =over 4
9992
9993 =item Creating New Cookies
9994
9995 =item Sending the Cookie to the Browser
9996
9997 =item Recovering Previous Cookies
9998
9999 =item Manipulating Cookies
10000
10001 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10002
10003 =back
10004
10005 =item AUTHOR INFORMATION
10006
10007 =item BUGS
10008
10009 =item SEE ALSO
10010
10011 =back
10012
10013 =head2 CGI::Fast - CGI Interface for Fast CGI
10014
10015 =over 4
10016
10017 =item SYNOPSIS
10018
10019 =item DESCRIPTION
10020
10021 =item OTHER PIECES OF THE PUZZLE
10022
10023 =item WRITING FASTCGI PERL SCRIPTS
10024
10025 =item INSTALLING FASTCGI SCRIPTS
10026
10027 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10028
10029 =item EXTERNAL FASTCGI SERVER INVOCATION
10030
10031 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10032
10033 =item CAVEATS
10034
10035 =item AUTHOR INFORMATION
10036
10037 =item BUGS
10038
10039 =item SEE ALSO
10040
10041 =back
10042
10043 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10044
10045 =over 4
10046
10047 =item SYNOPSIS
10048
10049 =item DESCRIPTION
10050
10051 =over 4
10052
10053 =item Tags that won't be formatted
10054
10055 =item Customizing the Indenting
10056
10057 =back
10058
10059 =item BUGS
10060
10061 =item AUTHOR
10062
10063 =item SEE ALSO
10064
10065 =back
10066
10067 =head2 CGI::Push - Simple Interface to Server Push
10068
10069 =over 4
10070
10071 =item SYNOPSIS
10072
10073 =item DESCRIPTION
10074
10075 =item USING CGI::Push
10076
10077 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10078
10079 =over 4
10080
10081 =item Heterogeneous Pages
10082
10083 =item Changing the Page Delay on the Fly
10084
10085 =back
10086
10087 =item INSTALLING CGI::Push SCRIPTS
10088
10089 =item AUTHOR INFORMATION
10090
10091 =item BUGS
10092
10093 =item SEE ALSO
10094
10095 =back
10096
10097 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10098
10099 =over 4
10100
10101 =item SYNOPSIS
10102
10103 =item ABSTRACT
10104
10105 =item DESCRIPTION
10106
10107 =item AUTHOR INFORMATION
10108
10109 =item BUGS
10110
10111 =item SEE ALSO
10112
10113 =back
10114
10115 =head2 CGI::Util - Internal utilities used by CGI module
10116
10117 =over 4
10118
10119 =item SYNOPSIS
10120
10121 =item DESCRIPTION
10122
10123 =item AUTHOR INFORMATION
10124
10125 =item SEE ALSO
10126
10127 =back
10128
10129 =head2 CPAN - query, download and build perl modules from CPAN sites
10130
10131 =over 4
10132
10133 =item SYNOPSIS
10134
10135 =item DESCRIPTION
10136
10137 =over 4
10138
10139 =item Interactive Mode
10140
10141 Searching for authors, bundles, distribution files and modules, make, test,
10142 install, clean  modules or distributions, get, readme, look module or
10143 distribution, ls author, Signals
10144
10145 =item CPAN::Shell
10146
10147 =item autobundle
10148
10149 =item recompile
10150
10151 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10152
10153 =item Programmer's interface
10154
10155 expand($type,@things), expandany(@things), Programming Examples
10156
10157 =item Methods in the other Classes
10158
10159 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10160 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10161 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10162 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10163 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10164 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10165 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10166 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10167 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10168 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10169 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10170 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10171 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10172 CPAN::Distribution::look(), CPAN::Distribution::make(),
10173 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10174 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10175 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10176 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10177 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10178 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10179 CPAN::Module::description(), CPAN::Module::force($method,@args),
10180 CPAN::Module::get(), CPAN::Module::inst_file(),
10181 CPAN::Module::inst_version(), CPAN::Module::install(),
10182 CPAN::Module::look(), CPAN::Module::make(),
10183 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10184 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10185
10186 =item Cache Manager
10187
10188 =item Bundles
10189
10190 =item Prerequisites
10191
10192 =item Finding packages and VERSION
10193
10194 =item Debugging
10195
10196 =item Floppy, Zip, Offline Mode
10197
10198 =back
10199
10200 =item CONFIGURATION
10201
10202 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10203 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10204 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10205 [unshift|push|splice] E<lt>listE<gt>>
10206
10207 =over 4
10208
10209 =item Note on urllist parameter's format
10210
10211 =item urllist parameter has CD-ROM support
10212
10213 =back
10214
10215 =item SECURITY
10216
10217 =item EXPORT
10218
10219 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10220
10221 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10222
10223 =over 4
10224
10225 =item Three basic types of firewalls
10226
10227 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10228
10229 =item Configuring lynx or ncftp for going through a firewall
10230
10231 =back
10232
10233 =item FAQ
10234
10235 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10236
10237 =item BUGS
10238
10239 =item AUTHOR
10240
10241 =item TRANSLATIONS
10242
10243 =item SEE ALSO
10244
10245 =back
10246
10247 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10248
10249 =over 4
10250
10251 =item SYNOPSIS
10252
10253 =item DESCRIPTION
10254
10255 =back
10256
10257 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10258 module
10259
10260 =over 4
10261
10262 =item SYNOPSIS
10263
10264 =item DESCRIPTION
10265
10266 =item  SEE ALSO
10267
10268 =back
10269
10270 =head2 Carp, carp    - warn of errors (from perspective of caller)
10271
10272 =over 4
10273
10274 =item SYNOPSIS
10275
10276 =item DESCRIPTION
10277
10278 =over 4
10279
10280 =item Forcing a Stack Trace
10281
10282 =back
10283
10284 =item BUGS
10285
10286 =back
10287
10288 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10289
10290 =head2 Class::ISA -- report the search path for a class's ISA tree
10291
10292 =over 4
10293
10294 =item SYNOPSIS
10295
10296 =item DESCRIPTION
10297
10298 =item FUNCTIONS
10299
10300 the function Class::ISA::super_path($CLASS), the function
10301 Class::ISA::self_and_super_path($CLASS), the function
10302 Class::ISA::self_and_super_versions($CLASS)
10303
10304 =item CAUTIONARY NOTES
10305
10306 =item COPYRIGHT
10307
10308 =item AUTHOR
10309
10310 =back
10311
10312 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10313
10314 =over 4
10315
10316 =item SYNOPSIS
10317
10318 =item DESCRIPTION
10319
10320 =over 4
10321
10322 =item The C<struct()> function
10323
10324 =item Class Creation at Compile Time
10325
10326 =item Element Types and Accessor Methods
10327
10328 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10329 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10330
10331 =item Initializing with C<new>
10332
10333 =back
10334
10335 =item EXAMPLES
10336
10337 Example 1, Example 2, Example 3
10338
10339 =item Author and Modification History
10340
10341 =back
10342
10343 =head2 Config - access Perl configuration information
10344
10345 =over 4
10346
10347 =item SYNOPSIS
10348
10349 =item DESCRIPTION
10350
10351 myconfig(), config_sh(), config_vars(@names)
10352
10353 =item EXAMPLE
10354
10355 =item WARNING
10356
10357 =item GLOSSARY
10358
10359 =over 4
10360
10361 =item _
10362
10363 C<_a>, C<_exe>, C<_o>
10364
10365 =item a
10366
10367 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10368 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10369 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10370 C<awk>
10371
10372 =item b
10373
10374 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
10375 C<byacc>, C<byteorder>
10376
10377 =item c
10378
10379 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10380 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10381 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10382 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10383 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10384 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<cryptlib>, C<csh>
10385
10386 =item d
10387
10388 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10389 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
10390 C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10391 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10392 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10393 C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
10394 C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>,
10395 C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>,
10396 C<d_endgrent>, C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>,
10397 C<d_endsent>, C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>,
10398 C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
10399 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
10400 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
10401 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
10402 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
10403 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
10404 C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>,
10405 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
10406 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getmnt>,
10407 C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
10408 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
10409 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
10410 C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
10411 C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
10412 C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
10413 C<d_htonl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
10414 C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>,
10415 C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>, C<d_lockf>,
10416 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10417 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10418 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10419 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10420 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10421 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10422 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10423 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10424 C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>, C<d_off64_t>,
10425 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
10426 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
10427 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
10428 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
10429 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
10430 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
10431 C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
10432 C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
10433 C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>, C<d_readv>,
10434 C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>,
10435 C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>,
10436 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
10437 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
10438 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
10439 C<d_setgrps>, C<d_sethent>, C<d_setitimer>, C<d_setlinebuf>,
10440 C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
10441 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setpwent>,
10442 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
10443 C<d_setruid>, C<d_setsent>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
10444 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
10445 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
10446 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
10447 C<d_socks5_init>, C<d_sqrtl>, C<d_sresgproto>, C<d_sresuproto>,
10448 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10449 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10450 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10451 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10452 C<d_strerror>, C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>,
10453 C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>,
10454 C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>,
10455 C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
10456 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
10457 C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
10458 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
10459 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
10460 C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
10461 C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
10462 C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
10463 C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10464 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10465 C<doublesize>, C<drand01>, C<dynamic_ext>
10466
10467 =item e
10468
10469 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
10470 C<exe_ext>, C<expr>, C<extensions>, C<extras>
10471
10472 =item f
10473
10474 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10475 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10476 C<full_sed>
10477
10478 =item g
10479
10480 C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
10481 C<gidtype>, C<glibpth>, C<gmake>, C<grep>, C<groupcat>, C<groupstype>,
10482 C<gzip>
10483
10484 =item h
10485
10486 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10487
10488 =item i
10489
10490 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10491 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
10492 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_fp>,
10493 C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10494 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10495 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10496 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10497 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10498 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10499 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10500 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10501 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10502 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10503 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10504 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10505 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10506 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10507 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10508 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10509 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10510 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10511 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10512 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10513 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10514
10515 =item k
10516
10517 C<known_extensions>, C<ksh>
10518
10519 =item l
10520
10521 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10522 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10523 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10524 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10525 C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>,
10526 C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
10527
10528 =item m
10529
10530 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10531 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10532 C<man3direxp>, C<man3ext>
10533
10534 =item M
10535
10536 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10537 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10538
10539 =item n
10540
10541 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10542 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10543 C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
10544 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
10545
10546 =item o
10547
10548 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10549 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10550
10551 =item p
10552
10553 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10554 C<perl>, C<perl_patchlevel>
10555
10556 =item P
10557
10558 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10559 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10560 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10561 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10562
10563 =item q
10564
10565 C<quadkind>, C<quadtype>
10566
10567 =item r
10568
10569 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
10570 C<revision>, C<rm>, C<rmail>, C<run>, C<runnm>
10571
10572 =item s
10573
10574 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10575 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
10576 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
10577 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>,
10578 C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>,
10579 C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10580 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10581 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10582 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10583 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10584 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>,
10585 C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
10586 C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
10587 C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
10588
10589 =item t
10590
10591 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10592 C<timetype>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>
10593
10594 =item u
10595
10596 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10597 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10598 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10599 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10600 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10601 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10602 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10603 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10604 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10605
10606 =item v
10607
10608 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10609 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10610 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10611 C<versiononly>, C<vi>, C<voidflags>
10612
10613 =item x
10614
10615 C<xlibpth>, C<xs_apiversion>
10616
10617 =item y
10618
10619 C<yacc>, C<yaccflags>
10620
10621 =item z
10622
10623 C<zcat>, C<zip>
10624
10625 =back
10626
10627 =item NOTE
10628
10629 =back
10630
10631 =head2 Cwd - get pathname of current working directory
10632
10633 =over 4
10634
10635 =item SYNOPSIS
10636
10637 =item DESCRIPTION
10638
10639 =over 4
10640
10641 =item getcwd and friends
10642
10643 getcwd, cwd, fastcwd, fastgetcwd
10644
10645 =item abs_path and friends
10646
10647 abs_path, realpath, fast_abs_path
10648
10649 =item $ENV{PWD}
10650
10651 =back
10652
10653 =item NOTES
10654
10655 =item SEE ALSO
10656
10657 =back
10658
10659 =head2 DB - programmatic interface to the Perl debugging API (draft,
10660 subject to
10661 change)
10662
10663 =over 4
10664
10665 =item SYNOPSIS
10666
10667 =item DESCRIPTION
10668
10669 =over 4
10670
10671 =item Global Variables
10672
10673  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
10674 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
10675 $DB::lineno
10676
10677 =item API Methods
10678
10679 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10680 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10681
10682 =item Client Callback Methods
10683
10684 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10685 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10686 CLIENT->output(LIST)
10687
10688 =back
10689
10690 =item BUGS
10691
10692 =item AUTHOR
10693
10694 =back
10695
10696 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10697
10698 =over 4
10699
10700 =item SYNOPSIS
10701
10702 =item DESCRIPTION
10703
10704 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10705
10706 =over 4
10707
10708 =item Using DB_File with Berkeley DB version 2 or greater
10709
10710 =item Interface to Berkeley DB
10711
10712 =item Opening a Berkeley DB Database File
10713
10714 =item Default Parameters
10715
10716 =item In Memory Databases
10717
10718 =back
10719
10720 =item DB_HASH
10721
10722 =over 4
10723
10724 =item A Simple Example
10725
10726 =back
10727
10728 =item DB_BTREE
10729
10730 =over 4
10731
10732 =item Changing the BTREE sort order
10733
10734 =item Handling Duplicate Keys 
10735
10736 =item The get_dup() Method
10737
10738 =item The find_dup() Method
10739
10740 =item The del_dup() Method
10741
10742 =item Matching Partial Keys 
10743
10744 =back
10745
10746 =item DB_RECNO
10747
10748 =over 4
10749
10750 =item The 'bval' Option
10751
10752 =item A Simple Example
10753
10754 =item Extra RECNO Methods
10755
10756 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10757 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10758 length, elements);>
10759
10760 =item Another Example
10761
10762 =back
10763
10764 =item THE API INTERFACE
10765
10766 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10767 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10768 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10769 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10770
10771 =item DBM FILTERS
10772
10773 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10774 B<filter_fetch_value>
10775
10776 =over 4
10777
10778 =item The Filter
10779
10780 =item An Example -- the NULL termination problem.
10781
10782 =item Another Example -- Key is a C int.
10783
10784 =back
10785
10786 =item HINTS AND TIPS 
10787
10788 =over 4
10789
10790 =item Locking: The Trouble with fd
10791
10792 =item Safe ways to lock a database
10793
10794 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10795
10796 =item Sharing Databases With C Applications
10797
10798 =item The untie() Gotcha
10799
10800 =back
10801
10802 =item COMMON QUESTIONS
10803
10804 =over 4
10805
10806 =item Why is there Perl source in my database?
10807
10808 =item How do I store complex data structures with DB_File?
10809
10810 =item What does "Invalid Argument" mean?
10811
10812 =item What does "Bareword 'DB_File' not allowed" mean? 
10813
10814 =back
10815
10816 =item REFERENCES
10817
10818 =item HISTORY
10819
10820 =item BUGS
10821
10822 =item AVAILABILITY
10823
10824 =item COPYRIGHT
10825
10826 =item SEE ALSO
10827
10828 =item AUTHOR
10829
10830 =back
10831
10832 =head2 Data::Dumper - stringified perl data structures, suitable for both
10833 printing and C<eval>
10834
10835 =over 4
10836
10837 =item SYNOPSIS
10838
10839 =item DESCRIPTION
10840
10841 =over 4
10842
10843 =item Methods
10844
10845 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
10846 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
10847 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
10848 I<$OBJ>->Reset
10849
10850 =item Functions
10851
10852 Dumper(I<LIST>)
10853
10854 =item Configuration Variables or Methods
10855
10856 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
10857 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
10858 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
10859 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
10860 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
10861 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
10862 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
10863 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
10864 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
10865 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
10866 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
10867 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
10868 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
10869 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
10870 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
10871
10872 =item Exports
10873
10874 Dumper
10875
10876 =back
10877
10878 =item EXAMPLES
10879
10880 =item BUGS
10881
10882 =item AUTHOR
10883
10884 =item VERSION
10885
10886 =item SEE ALSO
10887
10888 =back
10889
10890 =head2 Devel::DProf - a Perl code profiler
10891
10892 =over 4
10893
10894 =item SYNOPSIS
10895
10896 =item DESCRIPTION
10897
10898 =item PROFILE FORMAT
10899
10900 =item AUTOLOAD
10901
10902 =item ENVIRONMENT
10903
10904 =item BUGS
10905
10906 =item SEE ALSO
10907
10908 =back
10909
10910 =head2 Devel::PPPort, Perl/Pollution/Portability
10911
10912 =over 4
10913
10914 =item SYNOPSIS
10915
10916 =item DESCRIPTION
10917
10918 =over 4
10919
10920 =item WriteFile
10921
10922 =back
10923
10924 =item ppport.h
10925
10926 =item AUTHOR
10927
10928 =item SEE ALSO
10929
10930 =back
10931
10932 =head2 Devel::Peek - A data debugging tool for the XS programmer
10933
10934 =over 4
10935
10936 =item SYNOPSIS
10937
10938 =item DESCRIPTION
10939
10940 =over 4
10941
10942 =item Runtime debugging
10943
10944 =item Memory footprint debugging
10945
10946 =back
10947
10948 =item EXAMPLES
10949
10950 =over 4
10951
10952 =item A simple scalar string
10953
10954 =item A simple scalar number
10955
10956 =item A simple scalar with an extra reference
10957
10958 =item A reference to a simple scalar
10959
10960 =item A reference to an array
10961
10962 =item A reference to a hash
10963
10964 =item Dumping a large array or hash
10965
10966 =item A reference to an SV which holds a C pointer
10967
10968 =item A reference to a subroutine
10969
10970 =back
10971
10972 =item EXPORTS
10973
10974 =item BUGS
10975
10976 =item AUTHOR
10977
10978 =item SEE ALSO
10979
10980 =back
10981
10982 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
10983
10984 =over 4
10985
10986 =item SYNOPSIS
10987
10988 =item DESCRIPTION
10989
10990 =back
10991
10992 =head2 Digest:: - Modules that calculate message digests
10993
10994 =over 4
10995
10996 =item SYNOPSIS
10997
10998 =item DESCRIPTION
10999
11000 I<binary>, I<hex>, I<base64>
11001
11002 =item OO INTERFACE
11003
11004 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11005 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11006 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11007
11008 =item SEE ALSO
11009
11010 =item AUTHOR
11011
11012 =back
11013
11014 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11015
11016 =over 4
11017
11018 =item SYNOPSIS
11019
11020 =item DESCRIPTION
11021
11022 =item FUNCTIONS
11023
11024 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11025
11026 =item METHODS
11027
11028 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11029 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11030
11031 =item EXAMPLES
11032
11033 =item SEE ALSO
11034
11035 =item COPYRIGHT
11036
11037 =item AUTHORS
11038
11039 =back
11040
11041 =head2 DirHandle - supply object methods for directory handles
11042
11043 =over 4
11044
11045 =item SYNOPSIS
11046
11047 =item DESCRIPTION
11048
11049 =item NOTES
11050
11051 =back
11052
11053 =head2 Dumpvalue - provides screen dump of Perl data.
11054
11055 =over 4
11056
11057 =item SYNOPSIS
11058
11059 =item DESCRIPTION
11060
11061 =over 4
11062
11063 =item Creation
11064
11065 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11066 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11067 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11068 stopDbSignal
11069
11070 =item Methods
11071
11072 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
11073 veryCompact, set, get
11074
11075 =back
11076
11077 =back
11078
11079 =head2 DynaLoader - Dynamically load C libraries into Perl code
11080
11081 =over 4
11082
11083 =item SYNOPSIS
11084
11085 =item DESCRIPTION
11086
11087 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11088 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11089 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11090 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11091 bootstrap()
11092
11093 =item AUTHOR
11094
11095 =back
11096
11097 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11098 Perl code
11099
11100 =over 4
11101
11102 =item SYNOPSIS
11103
11104 =item DESCRIPTION
11105
11106 =item AUTHOR
11107
11108 =back
11109
11110 =head2 Encode - character encodings
11111
11112 =over 4
11113
11114 =item SYNOPSIS
11115
11116 =item DESCRIPTION
11117
11118 =over 4
11119
11120 =item TERMINOLOGY
11121
11122 =back
11123
11124 =item ENCODINGS
11125
11126 =over 4
11127
11128 =item Characteristics of an Encoding
11129
11130 =item Types of Encodings
11131
11132 Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
11133 Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
11134
11135 =item Specifying Encodings
11136
11137 1. By name, 2. As an object
11138
11139 =item Encoding Names
11140
11141 The MIME name as defined in IETF RFCs, The name in the IANA registry, The
11142 name used by the organization that defined it
11143
11144 =back
11145
11146 =item PERL ENCODING API
11147
11148 =over 4
11149
11150 =item Generic Encoding Interface
11151
11152 =item Handling Malformed Data
11153
11154 Scheme 1, Scheme 2, Other Schemes
11155
11156 =item UTF-8 / utf8
11157
11158 =item Other Encodings of Unicode
11159
11160 =item Listing available encodings
11161
11162 =item Defining Aliases
11163
11164 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11165 reference, e.g.:
11166
11167 =item Defining Encodings
11168
11169 =back
11170
11171 =item Encoding and IO
11172
11173 =item Encoding How to ...
11174
11175 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
11176 strings in binary data, Perl/Encode wrappers on non-Unicode XS modules
11177
11178 =item Messing with Perl's Internals
11179
11180 is_utf8(STRING [, CHECK]), valid_utf8(STRING)
11181
11182 =item IMPLEMENTATION CLASSES
11183
11184 -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
11185 -E<gt>decode($octets,$check)
11186
11187 =over 4
11188
11189 =item Compiled Encodings
11190
11191 .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
11192 variants of EBCDIC, symbol and dingbats as used by Tk on X11
11193
11194 =back
11195
11196 =item SEE ALSO
11197
11198 =back
11199
11200 =head2 Encode::Tcl - Tcl encodings
11201
11202 =head2 Encode::lib::Encode::Tcl, Encode::Tcl - Tcl encodings
11203
11204 =head2 Encode::lib::EncodeFormat, EncodeFormat - the format of encoding
11205 tables of the Encode extension
11206
11207 =over 4
11208
11209 =item DESCRIPTION
11210
11211 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
11212
11213 =item KEYWORDS
11214
11215 =item COPYRIGHT
11216
11217 =back
11218
11219 =head2 EncodeFormat - the format of encoding tables of the Encode extension
11220
11221 =over 4
11222
11223 =item DESCRIPTION
11224
11225 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
11226
11227 =item KEYWORDS
11228
11229 =item COPYRIGHT
11230
11231 =back
11232
11233 =head2 English - use nice English (or awk) names for ugly punctuation
11234 variables
11235
11236 =over 4
11237
11238 =item SYNOPSIS
11239
11240 =item DESCRIPTION
11241
11242 =item PERFORMANCE
11243
11244 =back
11245
11246 =head2 Env - perl module that imports environment variables as scalars or
11247 arrays
11248
11249 =over 4
11250
11251 =item SYNOPSIS
11252
11253 =item DESCRIPTION
11254
11255 =item LIMITATIONS
11256
11257 =item AUTHOR
11258
11259 =back
11260
11261 =head2 Errno - System errno constants
11262
11263 =over 4
11264
11265 =item SYNOPSIS
11266
11267 =item DESCRIPTION
11268
11269 =item CAVEATS
11270
11271 =item AUTHOR
11272
11273 =item COPYRIGHT
11274
11275 =back
11276
11277 =head2 Exporter - Implements default import method for modules
11278
11279 =over 4
11280
11281 =item SYNOPSIS
11282
11283 =item DESCRIPTION
11284
11285 =over 4
11286
11287 =item How to Export
11288
11289 =item Selecting What To Export
11290
11291 =item How to Import
11292
11293 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
11294
11295 =back
11296
11297 =item Advanced features
11298
11299 =over 4
11300
11301 =item Specialised Import Lists
11302
11303 =item Exporting without using Exporter's import method
11304
11305 =item Module Version Checking
11306
11307 =item Managing Unknown Symbols
11308
11309 =item Tag Handling Utility Functions
11310
11311 =item Generating combined tags
11312
11313 =item C<AUTOLOAD>ed Constants
11314
11315 =back
11316
11317 =back
11318
11319 =head2 Exporter::Heavy - Exporter guts
11320
11321 =over 4
11322
11323 =item SYNOPSIS
11324
11325 =item DESCRIPTION
11326
11327 =back
11328
11329 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
11330 Makefiles etc.
11331
11332 =over 4
11333
11334 =item SYNOPSIS
11335
11336 =item DESCRIPTION
11337
11338 =back
11339
11340 cat
11341
11342 eqtime src dst
11343
11344 rm_rf files...
11345
11346 rm_f files...
11347
11348 touch files ..
11349
11350 mv source... destination
11351
11352 cp source... destination
11353
11354 chmod mode files..
11355
11356 mkpath directory..
11357
11358 test_f file
11359
11360 =over 4
11361
11362 =item BUGS
11363
11364 =item SEE ALSO 
11365
11366 =item AUTHOR
11367
11368 =back
11369
11370 =head2 ExtUtils::Constant - generate XS code to import C header constants
11371
11372 =over 4
11373
11374 =item SYNOPSIS
11375
11376 =item DESCRIPTION
11377
11378 =item USAGE
11379
11380 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
11381
11382 =item FUNCTIONS
11383
11384 =back
11385
11386 C_stringify NAME
11387
11388 constant_types
11389
11390 memEQ_clause NAME, CHECKED_AT, INDENT
11391
11392 assign INDENT, TYPE, PRE, POST, VALUE..
11393
11394 return_clause
11395
11396 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
11397
11398 params WHAT
11399
11400 dump_names
11401
11402 dogfood
11403
11404 C_constant, name, type, value, macro, default, pre, post, def_pre =item
11405 def_post
11406
11407 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
11408
11409 autoload PACKAGE, VERSION, AUTOLOADER
11410
11411 WriteMakefileSnippet
11412
11413 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
11414 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
11415
11416 =over 4
11417
11418 =item AUTHOR
11419
11420 =back
11421
11422 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
11423
11424 =over 4
11425
11426 =item SYNOPSIS
11427
11428 =item DESCRIPTION
11429
11430 =item @EXPORT
11431
11432 =item FUNCTIONS
11433
11434 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
11435 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
11436
11437 =item EXAMPLES
11438
11439 =item SEE ALSO
11440
11441 =item AUTHOR
11442
11443 =back
11444
11445 =head2 ExtUtils::Install - install files from here to there
11446
11447 =over 4
11448
11449 =item SYNOPSIS
11450
11451 =item DESCRIPTION
11452
11453 =back
11454
11455 =head2 ExtUtils::Installed - Inventory management of installed modules
11456
11457 =over 4
11458
11459 =item SYNOPSIS
11460
11461 =item DESCRIPTION
11462
11463 =item USAGE
11464
11465 =item FUNCTIONS
11466
11467 new(), modules(), files(), directories(), directory_tree(), validate(),
11468 packlist(), version()
11469
11470 =item EXAMPLE
11471
11472 =item AUTHOR
11473
11474 =back
11475
11476 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
11477
11478 =over 4
11479
11480 =item SYNOPSIS
11481
11482 =item DESCRIPTION
11483
11484 For static extensions, For dynamic extensions, For dynamic extensions
11485
11486 =over 4
11487
11488 =item EXTRALIBS
11489
11490 =item LDLOADLIBS and LD_RUN_PATH
11491
11492 =item BSLOADLIBS
11493
11494 =back
11495
11496 =item PORTABILITY
11497
11498 =over 4
11499
11500 =item VMS implementation
11501
11502 =item Win32 implementation
11503
11504 =back
11505
11506 =item SEE ALSO
11507
11508 =back
11509
11510 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
11511 ExtUtils::MakeMaker
11512
11513 =over 4
11514
11515 =item SYNOPSIS
11516
11517 =item DESCRIPTION
11518
11519 =back
11520
11521 perl_archive
11522
11523 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
11524 ExtUtils::MakeMaker
11525
11526 =over 4
11527
11528 =item SYNOPSIS
11529
11530 =item DESCRIPTION
11531
11532 canonpath, cflags, manifypods, perl_archive
11533
11534 =back
11535
11536 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
11537 ExtUtils::MakeMaker
11538
11539 =over 4
11540
11541 =item SYNOPSIS
11542
11543 =item DESCRIPTION
11544
11545 =back
11546
11547 catfile
11548
11549 constants (o)
11550
11551 static_lib (o)
11552
11553 dynamic_bs (o)
11554
11555 dynamic_lib (o)
11556
11557 canonpath
11558
11559 perl_script
11560
11561 pm_to_blib
11562
11563 test_via_harness (o)
11564
11565 tool_autosplit (override)
11566
11567 tools_other (o)
11568
11569 xs_o (o)
11570
11571 top_targets (o)
11572
11573 htmlifypods (o)
11574
11575 manifypods (o)
11576
11577 dist_ci (o)
11578
11579 dist_core (o)
11580
11581 pasthru (o)
11582
11583 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
11584 ExtUtils::MakeMaker
11585
11586 =over 4
11587
11588 =item SYNOPSIS
11589
11590 =item DESCRIPTION
11591
11592 =item METHODS
11593
11594 =back
11595
11596 perl_archive_after
11597
11598 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
11599
11600 =over 4
11601
11602 =item SYNOPSIS
11603
11604 =item DESCRIPTION
11605
11606 =item METHODS
11607
11608 =over 4
11609
11610 =item Preloaded methods
11611
11612 canonpath
11613
11614 =back
11615
11616 =back
11617
11618 catdir
11619
11620 catfile
11621
11622 curdir
11623
11624 rootdir
11625
11626 updir
11627
11628 =over 4
11629
11630 =item SelfLoaded methods
11631
11632 c_o (o)
11633
11634 =back
11635
11636 cflags (o)
11637
11638 clean (o)
11639
11640 const_cccmd (o)
11641
11642 const_config (o)
11643
11644 const_loadlibs (o)
11645
11646 constants (o)
11647
11648 depend (o)
11649
11650 dir_target (o)
11651
11652 dist (o)
11653
11654 dist_basics (o)
11655
11656 dist_ci (o)
11657
11658 dist_core (o)
11659
11660 dist_dir (o)
11661
11662 dist_test (o)
11663
11664 dlsyms (o)
11665
11666 dynamic (o)
11667
11668 dynamic_bs (o)
11669
11670 dynamic_lib (o)
11671
11672 exescan
11673
11674 extliblist
11675
11676 file_name_is_absolute
11677
11678 find_perl
11679
11680 =over 4
11681
11682 =item Methods to actually produce chunks of text for the Makefile
11683
11684 fixin
11685
11686 =back
11687
11688 force (o)
11689
11690 guess_name
11691
11692 has_link_code
11693
11694 htmlifypods (o)
11695
11696 init_dirscan
11697
11698 init_main
11699
11700 init_others
11701
11702 install (o)
11703
11704 installbin (o)
11705
11706 libscan (o)
11707
11708 linkext (o)
11709
11710 lsdir
11711
11712 macro (o)
11713
11714 makeaperl (o)
11715
11716 makefile (o)
11717
11718 manifypods (o)
11719
11720 maybe_command
11721
11722 maybe_command_in_dirs
11723
11724 needs_linking (o)
11725
11726 nicetext
11727
11728 parse_version
11729
11730 parse_abstract
11731
11732 pasthru (o)
11733
11734 path
11735
11736 perl_script
11737
11738 perldepend (o)
11739
11740 ppd
11741
11742 perm_rw (o)
11743
11744 perm_rwx (o)
11745
11746 pm_to_blib
11747
11748 post_constants (o)
11749
11750 post_initialize (o)
11751
11752 postamble (o)
11753
11754 prefixify
11755
11756 processPL (o)
11757
11758 quote_paren
11759
11760 realclean (o)
11761
11762 replace_manpage_separator
11763
11764 static (o)
11765
11766 static_lib (o)
11767
11768 staticmake (o)
11769
11770 subdir_x (o)
11771
11772 subdirs (o)
11773
11774 test (o)
11775
11776 test_via_harness (o)
11777
11778 test_via_script (o)
11779
11780 tool_autosplit (o)
11781
11782 tools_other (o)
11783
11784 tool_xsubpp (o)
11785
11786 top_targets (o)
11787
11788 writedoc
11789
11790 xs_c (o)
11791
11792 xs_cpp (o)
11793
11794 xs_o (o)
11795
11796 perl_archive
11797
11798 perl_archive_after
11799
11800 export_list
11801
11802 =over 4
11803
11804 =item SEE ALSO
11805
11806 =back
11807
11808 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
11809 ExtUtils::MakeMaker
11810
11811 =over 4
11812
11813 =item SYNOPSIS
11814
11815 =item DESCRIPTION
11816
11817 =over 4
11818
11819 =item Methods always loaded
11820
11821 wraplist
11822
11823 =back
11824
11825 =back
11826
11827 rootdir (override)
11828
11829 =over 4
11830
11831 =item SelfLoaded methods
11832
11833 guess_name (override)
11834
11835 =back
11836
11837 find_perl (override)
11838
11839 path (override)
11840
11841 maybe_command (override)
11842
11843 maybe_command_in_dirs (override)
11844
11845 perl_script (override)
11846
11847 file_name_is_absolute (override)
11848
11849 replace_manpage_separator
11850
11851 init_others (override)
11852
11853 constants (override)
11854
11855 cflags (override)
11856
11857 const_cccmd (override)
11858
11859 pm_to_blib (override)
11860
11861 tool_autosplit (override)
11862
11863 tool_sxubpp (override)
11864
11865 xsubpp_version (override)
11866
11867 tools_other (override)
11868
11869 dist (override)
11870
11871 c_o (override)
11872
11873 xs_c (override)
11874
11875 xs_o (override)
11876
11877 top_targets (override)
11878
11879 dlsyms (override)
11880
11881 dynamic_lib (override)
11882
11883 dynamic_bs (override)
11884
11885 static_lib (override)
11886
11887 manifypods (override)
11888
11889 processPL (override)
11890
11891 installbin (override)
11892
11893 subdir_x (override)
11894
11895 clean (override)
11896
11897 realclean (override)
11898
11899 dist_basics (override)
11900
11901 dist_core (override)
11902
11903 dist_dir (override)
11904
11905 dist_test (override)
11906
11907 install (override)
11908
11909 perldepend (override)
11910
11911 makefile (override)
11912
11913 test (override)
11914
11915 test_via_harness (override)
11916
11917 test_via_script (override)
11918
11919 makeaperl (override)
11920
11921 nicetext (override)
11922
11923 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
11924 ExtUtils::MakeMaker
11925
11926 =over 4
11927
11928 =item SYNOPSIS
11929
11930 =item DESCRIPTION
11931
11932 =back
11933
11934 catfile
11935
11936 constants (o)
11937
11938 static_lib (o)
11939
11940 dynamic_bs (o)
11941
11942 dynamic_lib (o)
11943
11944 canonpath
11945
11946 perl_script
11947
11948 pm_to_blib
11949
11950 test_via_harness (o)
11951
11952 tool_autosplit (override)
11953
11954 tools_other (o)
11955
11956 xs_o (o)
11957
11958 top_targets (o)
11959
11960 htmlifypods (o)
11961
11962 manifypods (o)
11963
11964 dist_ci (o)
11965
11966 dist_core (o)
11967
11968 pasthru (o)
11969
11970 =head2 ExtUtils::MakeMaker - create an extension Makefile
11971
11972 =over 4
11973
11974 =item SYNOPSIS
11975
11976 =item DESCRIPTION
11977
11978 =over 4
11979
11980 =item How To Write A Makefile.PL
11981
11982 =item Default Makefile Behaviour
11983
11984 =item make test
11985
11986 =item make testdb
11987
11988 =item make install
11989
11990 =item PREFIX and LIB attribute
11991
11992 =item AFS users
11993
11994 =item Static Linking of a new Perl Binary
11995
11996 =item Determination of Perl Library and Installation Locations
11997
11998 =item Which architecture dependent directory?
11999
12000 =item Using Attributes and Parameters
12001
12002 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12003 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12004 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
12005 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12006 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
12007 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
12008 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
12009 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
12010 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
12011 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
12012 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE,
12013 PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW,
12014 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
12015 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT,
12016 PRINT_PREREQ, SKIP, TEST_LIBS, VERSION, VERSION_FROM, XS, XSOPT,
12017 XSPROTOARG, XS_VERSION
12018
12019 =item Additional lowercase attributes
12020
12021 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12022 tool_autosplit
12023
12024 =item Overriding MakeMaker Methods
12025
12026 =item Hintsfile support
12027
12028 =item Distribution Support
12029
12030    make distcheck,    make skipcheck,    make distclean,    make manifest, 
12031   make distdir,    make tardist,    make dist,    make uutardist,    make
12032 shdist,    make zipdist,    make ci
12033
12034 =item Disabling an extension
12035
12036 =back
12037
12038 =item ENVIRONMENT
12039
12040 PERL_MM_OPT, PERL_MM_USE_DEFAULT
12041
12042 =item SEE ALSO
12043
12044 =item AUTHORS
12045
12046 =back
12047
12048 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
12049
12050 =over 4
12051
12052 =item SYNOPSIS
12053
12054 =item DESCRIPTION
12055
12056 =item MANIFEST.SKIP
12057
12058 =item EXPORT_OK
12059
12060 =item GLOBAL VARIABLES
12061
12062 =item DIAGNOSTICS
12063
12064 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
12065 C<Added to MANIFEST:> I<file>
12066
12067 =item ENVIRONMENT
12068
12069 B<PERL_MM_MANIFEST_DEBUG>
12070
12071 =item SEE ALSO
12072
12073 =item AUTHOR
12074
12075 =back
12076
12077 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
12078
12079 =over 4
12080
12081 =item SYNOPSIS
12082
12083 =item DESCRIPTION
12084
12085 =item SEE ALSO
12086
12087 =back
12088
12089 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
12090
12091 =over 4
12092
12093 =item SYNOPSIS
12094
12095 =item DESCRIPTION
12096
12097 =back
12098
12099 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
12100 extension
12101
12102 =over 4
12103
12104 =item SYNOPSIS
12105
12106 =item DESCRIPTION
12107
12108 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
12109
12110 =item AUTHOR
12111
12112 =item REVISION
12113
12114 =back
12115
12116 =head2 ExtUtils::Packlist - manage .packlist files
12117
12118 =over 4
12119
12120 =item SYNOPSIS
12121
12122 =item DESCRIPTION
12123
12124 =item USAGE
12125
12126 =item FUNCTIONS
12127
12128 new(), read(), write(), validate(), packlist_file()
12129
12130 =item EXAMPLE
12131
12132 =item AUTHOR
12133
12134 =back
12135
12136 =head2 ExtUtils::testlib - add blib/* directories to @INC
12137
12138 =over 4
12139
12140 =item SYNOPSIS
12141
12142 =item DESCRIPTION
12143
12144 =back
12145
12146 =head2 Fatal - replace functions with equivalents which succeed or die
12147
12148 =over 4
12149
12150 =item SYNOPSIS
12151
12152 =item DESCRIPTION
12153
12154 =item AUTHOR
12155
12156 =back
12157
12158 =head2 Fcntl - load the C Fcntl.h defines
12159
12160 =over 4
12161
12162 =item SYNOPSIS
12163
12164 =item DESCRIPTION
12165
12166 =item NOTE
12167
12168 =item EXPORTED SYMBOLS
12169
12170 =back
12171
12172 =head2 File::Basename, fileparse - split a pathname into pieces
12173
12174 =over 4
12175
12176 =item SYNOPSIS
12177
12178 =item DESCRIPTION
12179
12180 fileparse_set_fstype, fileparse
12181
12182 =item EXAMPLES
12183
12184 C<basename>, C<dirname>
12185
12186 =back
12187
12188 =head2 File::CheckTree, validate - run many filetest checks on a tree
12189
12190 =over 4
12191
12192 =item SYNOPSIS
12193
12194 =item DESCRIPTION
12195
12196 =back
12197
12198 =head2 File::Compare - Compare files or filehandles
12199
12200 =over 4
12201
12202 =item SYNOPSIS
12203
12204 =item DESCRIPTION
12205
12206 =item RETURN
12207
12208 =item AUTHOR
12209
12210 =back
12211
12212 =head2 File::Copy - Copy files or filehandles
12213
12214 =over 4
12215
12216 =item SYNOPSIS
12217
12218 =item DESCRIPTION
12219
12220 =over 4
12221
12222 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
12223
12224 rmscopy($from,$to[,$date_flag])
12225
12226 =back
12227
12228 =item RETURN
12229
12230 =item NOTES
12231
12232 =item AUTHOR
12233
12234 =back
12235
12236 =head2 File::DosGlob - DOS like globbing and then some
12237
12238 =over 4
12239
12240 =item SYNOPSIS
12241
12242 =item DESCRIPTION
12243
12244 =item NOTES
12245
12246 =item EXPORTS (by request only)
12247
12248 =item BUGS
12249
12250 =item AUTHOR
12251
12252 =item HISTORY
12253
12254 =item SEE ALSO
12255
12256 =back
12257
12258 =head2 File::Find - Traverse a directory tree.
12259
12260 =over 4
12261
12262 =item SYNOPSIS
12263
12264 =item DESCRIPTION
12265
12266 B<find>, B<finddepth>
12267
12268 =over 4
12269
12270 =item %options
12271
12272 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
12273 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
12274 C<untaint>, C<untaint_pattern>, C<untaint_skip>
12275
12276 =item The wanted function
12277
12278 C<$File::Find::dir> is the current directory name,, C<$_> is the current
12279 filename within that directory, C<$File::Find::name> is the complete
12280 pathname to the file
12281
12282 =back
12283
12284 =item WARNINGS
12285
12286 =item CAVEAT
12287
12288 $dont_use_nlink, symlinks
12289
12290 =item NOTES
12291
12292 =item HISTORY
12293
12294 =back
12295
12296 =head2 File::Glob - Perl extension for BSD glob routine
12297
12298 =over 4
12299
12300 =item SYNOPSIS
12301
12302 =item DESCRIPTION
12303
12304 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
12305 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
12306 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
12307
12308 =item DIAGNOSTICS
12309
12310 C<GLOB_NOSPACE>, C<GLOB_ABEND>
12311
12312 =item NOTES
12313
12314 =item AUTHOR
12315
12316 =back
12317
12318 =head2 File::Path - create or remove directory trees
12319
12320 =over 4
12321
12322 =item SYNOPSIS
12323
12324 =item DESCRIPTION
12325
12326 =item AUTHORS
12327
12328 =back
12329
12330 =head2 File::Spec - portably perform operations on file names
12331
12332 =over 4
12333
12334 =item SYNOPSIS
12335
12336 =item DESCRIPTION
12337
12338 =item METHODS
12339
12340 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
12341 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
12342 splitdir, catpath(), abs2rel, rel2abs()
12343
12344 =item SEE ALSO
12345
12346 =item AUTHORS
12347
12348 =back
12349
12350 =head2 File::Spec::Cygwin - methods for Cygwin file specs
12351
12352 =over 4
12353
12354 =item SYNOPSIS
12355
12356 =item DESCRIPTION
12357
12358 =back
12359
12360 =head2 File::Spec::Epoc - methods for Epoc file specs
12361
12362 =over 4
12363
12364 =item SYNOPSIS
12365
12366 =item DESCRIPTION
12367
12368 devnull
12369
12370 =back
12371
12372 tmpdir
12373
12374 path
12375
12376 canonpath()
12377
12378 splitpath
12379
12380 splitdir
12381
12382 catpath
12383
12384 abs2rel
12385
12386 rel2abs()
12387
12388 =over 4
12389
12390 =item SEE ALSO
12391
12392 =back
12393
12394 =head2 File::Spec::Functions - portably perform operations on file names
12395
12396 =over 4
12397
12398 =item SYNOPSIS
12399
12400 =item DESCRIPTION
12401
12402 =over 4
12403
12404 =item Exports
12405
12406 =back
12407
12408 =item SEE ALSO
12409
12410 =back
12411
12412 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
12413
12414 =over 4
12415
12416 =item SYNOPSIS
12417
12418 =item DESCRIPTION
12419
12420 =item METHODS
12421
12422 canonpath
12423
12424 =back
12425
12426 catdir()
12427
12428 catfile
12429
12430 curdir
12431
12432 devnull
12433
12434 rootdir
12435
12436 tmpdir
12437
12438 updir
12439
12440 file_name_is_absolute
12441
12442 path
12443
12444 splitpath
12445
12446 splitdir
12447
12448 catpath
12449
12450 abs2rel
12451
12452 rel2abs
12453
12454 =over 4
12455
12456 =item AUTHORS
12457
12458 =item SEE ALSO
12459
12460 =back
12461
12462 canonpath
12463
12464 splitpath
12465
12466 splitdir
12467
12468 catpath
12469
12470 =head2 File::Spec::OS2 - methods for OS/2 file specs
12471
12472 =over 4
12473
12474 =item SYNOPSIS
12475
12476 =item DESCRIPTION
12477
12478 =back
12479
12480 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
12481 modules
12482
12483 =over 4
12484
12485 =item SYNOPSIS
12486
12487 =item DESCRIPTION
12488
12489 =item METHODS
12490
12491 canonpath()
12492
12493 =back
12494
12495 catdir()
12496
12497 catfile
12498
12499 curdir
12500
12501 devnull
12502
12503 rootdir
12504
12505 tmpdir
12506
12507 updir
12508
12509 no_upwards
12510
12511 case_tolerant
12512
12513 file_name_is_absolute
12514
12515 path
12516
12517 join
12518
12519 splitpath
12520
12521 splitdir
12522
12523 catpath()
12524
12525 abs2rel
12526
12527 rel2abs()
12528
12529 =over 4
12530
12531 =item SEE ALSO
12532
12533 =back
12534
12535 =head2 File::Spec::VMS - methods for VMS file specs
12536
12537 =over 4
12538
12539 =item SYNOPSIS
12540
12541 =item DESCRIPTION
12542
12543 eliminate_macros
12544
12545 =back
12546
12547 fixpath
12548
12549 =over 4
12550
12551 =item Methods always loaded
12552
12553 canonpath (override)
12554
12555 =back
12556
12557 catdir
12558
12559 catfile
12560
12561 curdir (override)
12562
12563 devnull (override)
12564
12565 rootdir (override)
12566
12567 tmpdir (override)
12568
12569 updir (override)
12570
12571 case_tolerant (override)
12572
12573 path (override)
12574
12575 file_name_is_absolute (override)
12576
12577 splitpath (override)
12578
12579 splitdir (override)
12580
12581 catpath (override)
12582
12583 abs2rel (override)
12584
12585 rel2abs (override)
12586
12587 =over 4
12588
12589 =item SEE ALSO
12590
12591 =back
12592
12593 =head2 File::Spec::Win32 - methods for Win32 file specs
12594
12595 =over 4
12596
12597 =item SYNOPSIS
12598
12599 =item DESCRIPTION
12600
12601 devnull
12602
12603 =back
12604
12605 tmpdir
12606
12607 catfile
12608
12609 canonpath
12610
12611 splitpath
12612
12613 splitdir
12614
12615 catpath
12616
12617 =over 4
12618
12619 =item SEE ALSO
12620
12621 =back
12622
12623 =head2 File::Temp - return name and handle of a temporary file safely
12624
12625 =over 4
12626
12627 =item PORTABILITY
12628
12629 =item SYNOPSIS
12630
12631 =item DESCRIPTION
12632
12633 =back
12634
12635 =over 4
12636
12637 =item FUNCTIONS
12638
12639 B<tempfile>
12640
12641 =back
12642
12643 B<tempdir>
12644
12645 =over 4
12646
12647 =item MKTEMP FUNCTIONS
12648
12649 B<mkstemp>
12650
12651 =back
12652
12653 B<mkstemps>
12654
12655 B<mkdtemp>
12656
12657 B<mktemp>
12658
12659 =over 4
12660
12661 =item POSIX FUNCTIONS
12662
12663 B<tmpnam>
12664
12665 =back
12666
12667 B<tmpfile>
12668
12669 =over 4
12670
12671 =item ADDITIONAL FUNCTIONS
12672
12673 B<tempnam>
12674
12675 =back
12676
12677 =over 4
12678
12679 =item UTILITY FUNCTIONS
12680
12681 B<unlink0>
12682
12683 =back
12684
12685 =over 4
12686
12687 =item PACKAGE VARIABLES
12688
12689 B<safe_level>, STANDARD, MEDIUM, HIGH
12690
12691 =back
12692
12693 TopSystemUID
12694
12695 =over 4
12696
12697 =item WARNING
12698
12699 =over 4
12700
12701 =item Temporary files and NFS
12702
12703 =back
12704
12705 =item HISTORY
12706
12707 =item SEE ALSO
12708
12709 =item AUTHOR
12710
12711 =back
12712
12713 =head2 File::stat - by-name interface to Perl's built-in stat() functions
12714
12715 =over 4
12716
12717 =item SYNOPSIS
12718
12719 =item DESCRIPTION
12720
12721 =item NOTE
12722
12723 =item AUTHOR
12724
12725 =back
12726
12727 =head2 FileCache - keep more files open than the system permits
12728
12729 =over 4
12730
12731 =item SYNOPSIS
12732
12733 =item DESCRIPTION
12734
12735 =item BUGS
12736
12737 =back
12738
12739 =head2 FileHandle - supply object methods for filehandles
12740
12741 =over 4
12742
12743 =item SYNOPSIS
12744
12745 =item DESCRIPTION
12746
12747 $fh->print, $fh->printf, $fh->getline, $fh->getlines
12748
12749 =item SEE ALSO
12750
12751 =back
12752
12753 =head2 Filter::Simple - Simplified source filtering
12754
12755 =over 4
12756
12757 =item SYNOPSIS
12758
12759 =item DESCRIPTION
12760
12761 =over 4
12762
12763 =item The Problem
12764
12765 =item A Solution
12766
12767 =item Disabling or changing <no> behaviour
12768
12769 =item All-in-one interface
12770
12771 =item Filtering only specific components of source code
12772
12773 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
12774 C<"all">
12775
12776 =item Filtering only the code parts of source code
12777
12778 Most source code ceases to be grammatically correct when it is broken up
12779 into the pieces between string literals and regexes. So the C<'code'>
12780 component filter behaves slightly differently from the other partial
12781 filters
12782 described in the previous section.
12783
12784 =item Using Filter::Simple with an explicit C<import> subroutine
12785
12786 =item Using Filter::Simple and Exporter together
12787
12788 =item How it works
12789
12790 =back
12791
12792 =item AUTHOR
12793
12794 =item COPYRIGHT
12795
12796 =back
12797
12798 =head2 Filter::Util::Call - Perl Source Filter Utility Module
12799
12800 =over 4
12801
12802 =item SYNOPSIS
12803
12804 =item DESCRIPTION
12805
12806 =over 4
12807
12808 =item B<use Filter::Util::Call>
12809
12810 =item B<import()>
12811
12812 =item B<filter() and anonymous sub>
12813
12814 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
12815
12816 =back
12817
12818 =item EXAMPLES
12819
12820 =over 4
12821
12822 =item Example 1: A simple filter.
12823
12824 =item Example 2: Using the context
12825
12826 =item Example 3: Using the context within the filter
12827
12828 =item Example 4: Using filter_del
12829
12830 =back
12831
12832 =item Filter::Simple
12833
12834 =item AUTHOR
12835
12836 =item DATE
12837
12838 =back
12839
12840 =head2 FindBin - Locate directory of original perl script
12841
12842 =over 4
12843
12844 =item SYNOPSIS
12845
12846 =item DESCRIPTION
12847
12848 =item EXPORTABLE VARIABLES
12849
12850 =item KNOWN ISSUES
12851
12852 =item KNOWN BUGS
12853
12854 =item AUTHORS
12855
12856 =item COPYRIGHT
12857
12858 =back
12859
12860 =head2 GDBM_File - Perl5 access to the gdbm library.
12861
12862 =over 4
12863
12864 =item SYNOPSIS
12865
12866 =item DESCRIPTION
12867
12868 =item AVAILABILITY
12869
12870 =item BUGS
12871
12872 =item SEE ALSO
12873
12874 =back
12875
12876 =head2 Getopt::Long - Extended processing of command line options
12877
12878 =over 4
12879
12880 =item SYNOPSIS
12881
12882 =item DESCRIPTION
12883
12884 =item Command Line Options, an Introduction
12885
12886 =item Getting Started with Getopt::Long
12887
12888 =over 4
12889
12890 =item Simple options
12891
12892 =item A little bit less simple options
12893
12894 =item Mixing command line option with other arguments
12895
12896 =item Options with values
12897
12898 =item Options with multiple values
12899
12900 =item Options with hash values
12901
12902 =item User-defined subroutines to handle options
12903
12904 =item Options with multiple names
12905
12906 =item Case and abbreviations
12907
12908 =item Summary of Option Specifications
12909
12910 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
12911 + [ I<desttype> ]
12912
12913 =back
12914
12915 =item Advanced Possibilities
12916
12917 =over 4
12918
12919 =item Object oriented interface
12920
12921 =item Documentation and help texts
12922
12923 =item Storing options in a hash
12924
12925 =item Bundling
12926
12927 =item The lonesome dash
12928
12929 =item Argument callback
12930
12931 =back
12932
12933 =item Configuring Getopt::Long
12934
12935 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
12936 require_order, permute, bundling (default: disabled), bundling_override
12937 (default: disabled), ignore_case  (default: enabled), ignore_case_always
12938 (default: disabled), pass_through (default: disabled), prefix,
12939 prefix_pattern, debug (default: disabled)
12940
12941 =item Return values and Errors
12942
12943 =item Legacy
12944
12945 =over 4
12946
12947 =item Default destinations
12948
12949 =item Alternative option starters
12950
12951 =item Configuration variables
12952
12953 =back
12954
12955 =item Trouble Shooting
12956
12957 =over 4
12958
12959 =item Warning: Ignoring '!' modifier for short option
12960
12961 =item GetOptions does not return a false result when an option is not
12962 supplied
12963
12964 =item GetOptions does not split the command line correctly
12965
12966 =item How do I put a "-?" option into a Getopt::Long?
12967
12968 =back
12969
12970 =item AUTHOR
12971
12972 =item COPYRIGHT AND DISCLAIMER
12973
12974 =back
12975
12976 =head2 Getopt::Std, getopt - Process single-character switches with switch
12977 clustering
12978
12979 =over 4
12980
12981 =item SYNOPSIS
12982
12983 =item DESCRIPTION
12984
12985 =back
12986
12987 =head2 I18N::Collate - compare 8-bit scalar data according to the current
12988 locale
12989
12990 =over 4
12991
12992 =item SYNOPSIS
12993
12994 =item DESCRIPTION
12995
12996 =back
12997
12998 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
12999 tags
13000
13001 =over 4
13002
13003 =item SYNOPSIS
13004
13005 =item DESCRIPTION
13006
13007 =back
13008
13009 the function is_language_tag($lang1)
13010
13011 the function extract_language_tags($whatever)
13012
13013 the function same_language_tag($lang1, $lang2)
13014
13015 the function similarity_language_tag($lang1, $lang2)
13016
13017 the function is_dialect_of($lang1, $lang2)
13018
13019 the function super_languages($lang1)
13020
13021 the function locale2language_tag($locale_identifier)
13022
13023 the function encode_language_tag($lang1)
13024
13025 the function alternate_language_tags($lang1)
13026
13027 the function @langs = panic_languages(@accept_languages)
13028
13029 =over 4
13030
13031 =item ABOUT LOWERCASING
13032
13033 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
13034
13035 =item SEE ALSO
13036
13037 =item COPYRIGHT
13038
13039 =item AUTHOR
13040
13041 =back
13042
13043 =head2 I18N::LangTags::List -- tags and names for human languages
13044
13045 =over 4
13046
13047 =item SYNOPSIS
13048
13049 =item DESCRIPTION
13050
13051 =item ABOUT LANGUAGE TAGS
13052
13053 =item LIST OF LANGUAGES
13054
13055 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
13056 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
13057 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
13058 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
13059 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
13060 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
13061 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
13062 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
13063 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
13064 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
13065 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
13066 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
13067 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
13068 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
13069 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
13070 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
13071 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
13072 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
13073 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
13074 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
13075 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
13076 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
13077 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
13078 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
13079 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
13080 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
13081 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
13082 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
13083 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
13084 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
13085 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
13086 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
13087 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
13088 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
13089 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
13090 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
13091 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
13092 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
13093 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
13094 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
13095 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
13096 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
13097 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
13098 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
13099 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
13100 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
13101 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
13102 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
13103 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
13104 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
13105 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
13106 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
13107 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
13108 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
13109 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
13110 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
13111 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
13112 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
13113 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
13114 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
13115 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
13116 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
13117 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
13118 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
13119 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
13120 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
13121 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
13122 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
13123 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
13124 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
13125 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
13126 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
13127 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
13128 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
13129 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
13130 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
13131 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
13132 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
13133 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
13134 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
13135 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
13136 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
13137 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
13138 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
13139 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
13140 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
13141 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
13142 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
13143 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
13144 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
13145 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
13146 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
13147 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
13148 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
13149 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
13150 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
13151 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
13152 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
13153 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
13154 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
13155 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
13156 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
13157 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
13158 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
13159 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
13160 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
13161 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
13162 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
13163 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
13164 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
13165 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
13166 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
13167 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
13168 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
13169 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
13170 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
13171 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
13172 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
13173 Zhuang, {zu} : Zulu, {zun} : Zuni
13174
13175 =item SEE ALSO
13176
13177 =item COPYRIGHT AND DISCLAIMER
13178
13179 =item AUTHOR
13180
13181 =back
13182
13183 =head2 I18N::Langinfo - query locale information
13184
13185 =over 4
13186
13187 =item SYNOPSIS
13188
13189 =item DESCRIPTION
13190
13191 =over 4
13192
13193 =item EXPORT
13194
13195 =back
13196
13197 =item SEE ALSO
13198
13199 =item AUTHOR
13200
13201 =item COPYRIGHT AND LICENSE
13202
13203 =back
13204
13205 =head2 IO - load various IO modules
13206
13207 =over 4
13208
13209 =item SYNOPSIS
13210
13211 =item DESCRIPTION
13212
13213 =back
13214
13215 =head2 IO::Dir - supply object methods for directory handles
13216
13217 =over 4
13218
13219 =item SYNOPSIS
13220
13221 =item DESCRIPTION
13222
13223 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
13224 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
13225
13226 =item SEE ALSO
13227
13228 =item AUTHOR
13229
13230 =item COPYRIGHT
13231
13232 =back
13233
13234 =head2 IO::File - supply object methods for filehandles
13235
13236 =over 4
13237
13238 =item SYNOPSIS
13239
13240 =item DESCRIPTION
13241
13242 =item CONSTRUCTOR
13243
13244 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
13245
13246 =item METHODS
13247
13248 open( FILENAME [,MODE [,PERMS]] )
13249
13250 =item SEE ALSO
13251
13252 =item HISTORY
13253
13254 =back
13255
13256 =head2 IO::Handle - supply object methods for I/O handles
13257
13258 =over 4
13259
13260 =item SYNOPSIS
13261
13262 =item DESCRIPTION
13263
13264 =item CONSTRUCTOR
13265
13266 new (), new_from_fd ( FD, MODE )
13267
13268 =item METHODS
13269
13270 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
13271 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
13272 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
13273 $io->blocking ( [ BOOL ] ), $io->untaint
13274
13275 =item NOTE
13276
13277 =item SEE ALSO
13278
13279 =item BUGS
13280
13281 =item HISTORY
13282
13283 =back
13284
13285 =head2 IO::Pipe - supply object methods for pipes
13286
13287 =over 4
13288
13289 =item SYNOPSIS
13290
13291 =item DESCRIPTION
13292
13293 =item CONSTRUCTOR
13294
13295 new ( [READER, WRITER] )
13296
13297 =item METHODS
13298
13299 reader ([ARGS]), writer ([ARGS]), handles ()
13300
13301 =item SEE ALSO
13302
13303 =item AUTHOR
13304
13305 =item COPYRIGHT
13306
13307 =back
13308
13309 =head2 IO::Poll - Object interface to system poll call
13310
13311 =over 4
13312
13313 =item SYNOPSIS
13314
13315 =item DESCRIPTION
13316
13317 =item METHODS
13318
13319 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
13320 IO ), handles( [ EVENT_MASK ] )
13321
13322 =item SEE ALSO
13323
13324 =item AUTHOR
13325
13326 =item COPYRIGHT
13327
13328 =back
13329
13330 =head2 IO::Seekable - supply seek based methods for I/O objects
13331
13332 =over 4
13333
13334 =item SYNOPSIS
13335
13336 =item DESCRIPTION
13337
13338 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
13339 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
13340 $io->tell
13341
13342 =item SEE ALSO
13343
13344 =item HISTORY
13345
13346 =back
13347
13348 =head2 IO::Select - OO interface to the select system call
13349
13350 =over 4
13351
13352 =item SYNOPSIS
13353
13354 =item DESCRIPTION
13355
13356 =item CONSTRUCTOR
13357
13358 new ( [ HANDLES ] )
13359
13360 =item METHODS
13361
13362 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
13363 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
13364 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
13365
13366 =item EXAMPLE
13367
13368 =item AUTHOR
13369
13370 =item COPYRIGHT
13371
13372 =back
13373
13374 =head2 IO::Socket - Object interface to socket communications
13375
13376 =over 4
13377
13378 =item SYNOPSIS
13379
13380 =item DESCRIPTION
13381
13382 =item CONSTRUCTOR
13383
13384 new ( [ARGS] )
13385
13386 =item METHODS
13387
13388 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
13389 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
13390
13391 =item SEE ALSO
13392
13393 =item AUTHOR
13394
13395 =item COPYRIGHT
13396
13397 =back
13398
13399 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
13400
13401 =over 4
13402
13403 =item SYNOPSIS
13404
13405 =item DESCRIPTION
13406
13407 =item CONSTRUCTOR
13408
13409 new ( [ARGS] )
13410
13411 =over 4
13412
13413 =item METHODS
13414
13415 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
13416 ()
13417
13418 =back
13419
13420 =item SEE ALSO
13421
13422 =item AUTHOR
13423
13424 =item COPYRIGHT
13425
13426 =back
13427
13428 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
13429
13430 =over 4
13431
13432 =item SYNOPSIS
13433
13434 =item DESCRIPTION
13435
13436 =item CONSTRUCTOR
13437
13438 new ( [ARGS] )
13439
13440 =item METHODS
13441
13442 hostpath(), peerpath()
13443
13444 =item SEE ALSO
13445
13446 =item AUTHOR
13447
13448 =item COPYRIGHT
13449
13450 =back
13451
13452 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
13453 handles
13454
13455 =over 4
13456
13457 =item SYNOPSIS
13458
13459 =item DESCRIPTION
13460
13461 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
13462 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
13463
13464 =item SEE ALSO
13465
13466 =item AUTHOR
13467
13468 =item COPYRIGHT
13469
13470 =back
13471
13472 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
13473
13474 =over 4
13475
13476 =item SYNOPSIS
13477
13478 =item DESCRIPTION
13479
13480 =item CONSTRUCTOR
13481
13482 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
13483
13484 =item METHODS
13485
13486 open( FILENAME [,MODE [,PERMS]] )
13487
13488 =item SEE ALSO
13489
13490 =item HISTORY
13491
13492 =back
13493
13494 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
13495 handles
13496
13497 =over 4
13498
13499 =item SYNOPSIS
13500
13501 =item DESCRIPTION
13502
13503 =item CONSTRUCTOR
13504
13505 new (), new_from_fd ( FD, MODE )
13506
13507 =item METHODS
13508
13509 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
13510 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
13511 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
13512 $io->blocking ( [ BOOL ] ), $io->untaint
13513
13514 =item NOTE
13515
13516 =item SEE ALSO
13517
13518 =item BUGS
13519
13520 =item HISTORY
13521
13522 =back
13523
13524 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
13525
13526 =over 4
13527
13528 =item SYNOPSIS
13529
13530 =item DESCRIPTION
13531
13532 =item CONSTRUCTOR
13533
13534 new ( [READER, WRITER] )
13535
13536 =item METHODS
13537
13538 reader ([ARGS]), writer ([ARGS]), handles ()
13539
13540 =item SEE ALSO
13541
13542 =item AUTHOR
13543
13544 =item COPYRIGHT
13545
13546 =back
13547
13548 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
13549
13550 =over 4
13551
13552 =item SYNOPSIS
13553
13554 =item DESCRIPTION
13555
13556 =item METHODS
13557
13558 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
13559 IO ), handles( [ EVENT_MASK ] )
13560
13561 =item SEE ALSO
13562
13563 =item AUTHOR
13564
13565 =item COPYRIGHT
13566
13567 =back
13568
13569 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
13570 I/O objects
13571
13572 =over 4
13573
13574 =item SYNOPSIS
13575
13576 =item DESCRIPTION
13577
13578 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
13579 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
13580 $io->tell
13581
13582 =item SEE ALSO
13583
13584 =item HISTORY
13585
13586 =back
13587
13588 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
13589 call
13590
13591 =over 4
13592
13593 =item SYNOPSIS
13594
13595 =item DESCRIPTION
13596
13597 =item CONSTRUCTOR
13598
13599 new ( [ HANDLES ] )
13600
13601 =item METHODS
13602
13603 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
13604 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
13605 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
13606
13607 =item EXAMPLE
13608
13609 =item AUTHOR
13610
13611 =item COPYRIGHT
13612
13613 =back
13614
13615 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
13616 communications
13617
13618 =over 4
13619
13620 =item SYNOPSIS
13621
13622 =item DESCRIPTION
13623
13624 =item CONSTRUCTOR
13625
13626 new ( [ARGS] )
13627
13628 =item METHODS
13629
13630 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
13631 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
13632
13633 =item SEE ALSO
13634
13635 =item AUTHOR
13636
13637 =item COPYRIGHT
13638
13639 =back
13640
13641 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
13642 AF_INET domain sockets
13643
13644 =over 4
13645
13646 =item SYNOPSIS
13647
13648 =item DESCRIPTION
13649
13650 =item CONSTRUCTOR
13651
13652 new ( [ARGS] )
13653
13654 =over 4
13655
13656 =item METHODS
13657
13658 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
13659 ()
13660
13661 =back
13662
13663 =item SEE ALSO
13664
13665 =item AUTHOR
13666
13667 =item COPYRIGHT
13668
13669 =back
13670
13671 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
13672 AF_UNIX domain sockets
13673
13674 =over 4
13675
13676 =item SYNOPSIS
13677
13678 =item DESCRIPTION
13679
13680 =item CONSTRUCTOR
13681
13682 new ( [ARGS] )
13683
13684 =item METHODS
13685
13686 hostpath(), peerpath()
13687
13688 =item SEE ALSO
13689
13690 =item AUTHOR
13691
13692 =item COPYRIGHT
13693
13694 =back
13695
13696 =head2 IPC::Msg - SysV Msg IPC object class
13697
13698 =over 4
13699
13700 =item SYNOPSIS
13701
13702 =item DESCRIPTION
13703
13704 =item METHODS
13705
13706 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
13707 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
13708 FLAGS ] ), stat
13709
13710 =item SEE ALSO
13711
13712 =item AUTHOR
13713
13714 =item COPYRIGHT
13715
13716 =back
13717
13718 =head2 IPC::Open2, open2 - open a process for both reading and writing
13719
13720 =over 4
13721
13722 =item SYNOPSIS
13723
13724 =item DESCRIPTION
13725
13726 =item WARNING 
13727
13728 =item SEE ALSO
13729
13730 =back
13731
13732 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
13733 handling
13734
13735 =over 4
13736
13737 =item SYNOPSIS
13738
13739 =item DESCRIPTION
13740
13741 =item WARNING
13742
13743 =back
13744
13745 =head2 IPC::Semaphore - SysV Semaphore IPC object class
13746
13747 =over 4
13748
13749 =item SYNOPSIS
13750
13751 =item DESCRIPTION
13752
13753 =item METHODS
13754
13755 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
13756 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
13757 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
13758 , VALUE ), stat
13759
13760 =item SEE ALSO
13761
13762 =item AUTHOR
13763
13764 =item COPYRIGHT
13765
13766 =back
13767
13768 =head2 IPC::SysV - SysV IPC constants
13769
13770 =over 4
13771
13772 =item SYNOPSIS
13773
13774 =item DESCRIPTION
13775
13776 ftok( PATH, ID )
13777
13778 =item SEE ALSO
13779
13780 =item AUTHORS
13781
13782 =item COPYRIGHT
13783
13784 =back
13785
13786 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
13787
13788 =over 4
13789
13790 =item SYNOPSIS
13791
13792 =item DESCRIPTION
13793
13794 =item METHODS
13795
13796 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
13797 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
13798 FLAGS ] ), stat
13799
13800 =item SEE ALSO
13801
13802 =item AUTHOR
13803
13804 =item COPYRIGHT
13805
13806 =back
13807
13808 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
13809 class
13810
13811 =over 4
13812
13813 =item SYNOPSIS
13814
13815 =item DESCRIPTION
13816
13817 =item METHODS
13818
13819 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
13820 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
13821 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
13822 , VALUE ), stat
13823
13824 =item SEE ALSO
13825
13826 =item AUTHOR
13827
13828 =item COPYRIGHT
13829
13830 =back
13831
13832 =head2 List::Util - A selection of general-utility list subroutines
13833
13834 =over 4
13835
13836 =item SYNOPSIS
13837
13838 =item DESCRIPTION
13839
13840 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
13841 BLOCK LIST, shuffle LIST, sum LIST
13842
13843 =item KNOWN BUGS
13844
13845 =item SUGGESTED ADDITIONS
13846
13847 =item COPYRIGHT
13848
13849 =back
13850
13851 =head2 List::Utilib::List::Util, List::Util - A selection of
13852 general-utility list subroutines
13853
13854 =over 4
13855
13856 =item SYNOPSIS
13857
13858 =item DESCRIPTION
13859
13860 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
13861 BLOCK LIST, shuffle LIST, sum LIST
13862
13863 =item KNOWN BUGS
13864
13865 =item SUGGESTED ADDITIONS
13866
13867 =item COPYRIGHT
13868
13869 =back
13870
13871 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
13872 general-utility scalar subroutines
13873
13874 =over 4
13875
13876 =item SYNOPSIS
13877
13878 =item DESCRIPTION
13879
13880 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
13881 EXPR, tainted EXPR, weaken REF
13882
13883 =item KNOWN BUGS
13884
13885 =item COPYRIGHT
13886
13887 =item BLATANT PLUG
13888
13889 =back
13890
13891 =head2 Locale::Constants - constants for Locale codes
13892
13893 =over 4
13894
13895 =item SYNOPSIS
13896
13897 =item DESCRIPTION
13898
13899 =item KNOWN BUGS AND LIMITATIONS
13900
13901 =item SEE ALSO
13902
13903 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
13904
13905 =item AUTHOR
13906
13907 =item COPYRIGHT
13908
13909 =back
13910
13911 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
13912
13913 =over 4
13914
13915 =item SYNOPSIS
13916
13917 =item DESCRIPTION
13918
13919 B<alpha-2>, B<alpha-3>, B<numeric>
13920
13921 =item CONVERSION ROUTINES
13922
13923 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
13924 country_code2code( CODE, CODESET, CODESET )
13925
13926 =item QUERY ROUTINES
13927
13928 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
13929
13930 =item CODE ALIASING
13931
13932 =item EXAMPLES
13933
13934 =item DOMAIN NAMES
13935
13936 =item KNOWN BUGS AND LIMITATIONS
13937
13938 =item SEE ALSO
13939
13940 Locale::Language, Locale::Script, Locale::Currency, ISO 3166,
13941 http://www.din.de/gremien/nas/nabd/iso3166ma/,
13942 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
13943 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
13944
13945 =item AUTHOR
13946
13947 =item COPYRIGHT
13948
13949 =back
13950
13951 =head2 Locale::Currency - ISO three letter codes for currency
13952 identification (ISO 4217)
13953
13954 =over 4
13955
13956 =item SYNOPSIS
13957
13958 =item DESCRIPTION
13959
13960 XTS, XXX
13961
13962 =item CONVERSION ROUTINES
13963
13964 code2currency(), currency2code()
13965
13966 =item QUERY ROUTINES
13967
13968 C<all_currency_codes()>, C<all_currency_names()>
13969
13970 =item EXAMPLES
13971
13972 =item KNOWN BUGS AND LIMITATIONS
13973
13974 =item SEE ALSO
13975
13976 Locale::Country, Locale::Script, ISO 4217:1995,
13977 http://www.bsi-global.com/iso4217currency
13978
13979 =item AUTHOR
13980
13981 =item COPYRIGHT
13982
13983 =back
13984
13985 =head2 Locale::Language - ISO two letter codes for language identification
13986 (ISO 639)
13987
13988 =over 4
13989
13990 =item SYNOPSIS
13991
13992 =item DESCRIPTION
13993
13994 =item CONVERSION ROUTINES
13995
13996 code2language(), language2code()
13997
13998 =item QUERY ROUTINES
13999
14000 C<all_language_codes()>, C<all_language_names()>
14001
14002 =item EXAMPLES
14003
14004 =item KNOWN BUGS AND LIMITATIONS
14005
14006 =item SEE ALSO
14007
14008 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
14009 http://lcweb.loc.gov/standards/iso639-2/langhome.html
14010
14011 =item AUTHOR
14012
14013 =item COPYRIGHT
14014
14015 =back
14016
14017 =head2 Locale::Maketext -- framework for localization
14018
14019 =over 4
14020
14021 =item SYNOPSIS
14022
14023 =item DESCRIPTION
14024
14025 =item QUICK OVERVIEW
14026
14027 =item METHODS
14028
14029 =over 4
14030
14031 =item Construction Methods
14032
14033 =item The "maketext" Method
14034
14035 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
14036
14037 =item Utility Methods
14038
14039 $language->quant($number, $singular), $language->quant($number, $singular,
14040 $plural), $language->quant($number, $singular, $plural, $negative),
14041 $language->numf($number), $language->sprintf($format, @items),
14042 $language->language_tag(), $language->encoding()
14043
14044 =item Language Handle Attributes and Internals
14045
14046 =back
14047
14048 =item LANGUAGE CLASS HIERARCHIES
14049
14050 =item ENTRIES IN EACH LEXICON
14051
14052 =item BRACKET NOTATION
14053
14054 =item AUTO LEXICONS
14055
14056 =item CONTROLLING LOOKUP FAILURE
14057
14058 =item HOW TO USE MAKETEXT
14059
14060 =item SEE ALSO
14061
14062 =item COPYRIGHT AND DISCLAIMER
14063
14064 =item AUTHOR
14065
14066 =back
14067
14068 =head2 Locale::Maketext::TPJ13 -- article about software localization
14069
14070 =over 4
14071
14072 =item SYNOPSIS
14073
14074 =item DESCRIPTION
14075
14076 =item Localization and Perl: gettext breaks, Maketext fixes
14077
14078 =over 4
14079
14080 =item A Localization Horror Story: It Could Happen To You
14081
14082 =item The Linguistic View
14083
14084 =item Breaking gettext
14085
14086 =item Replacing gettext
14087
14088 =item Buzzwords: Abstraction and Encapsulation
14089
14090 =item Buzzword: Isomorphism
14091
14092 =item Buzzword: Inheritance
14093
14094 =item Buzzword: Concision
14095
14096 =item The Devil in the Details
14097
14098 =item The Proof in the Pudding: Localizing Web Sites
14099
14100 =item References
14101
14102 =back
14103
14104 =back
14105
14106 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
14107
14108 =over 4
14109
14110 =item SYNOPSIS
14111
14112 =item DESCRIPTION
14113
14114 B<alpha-2>, B<alpha-3>, B<numeric>
14115
14116 =over 4
14117
14118 =item SPECIAL CODES
14119
14120 =back
14121
14122 =item CONVERSION ROUTINES
14123
14124 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
14125 script_code2code( CODE, CODESET, CODESET )
14126
14127 =item QUERY ROUTINES
14128
14129 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
14130
14131 =item EXAMPLES
14132
14133 =item KNOWN BUGS AND LIMITATIONS
14134
14135 =item SEE ALSO
14136
14137 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
14138 http://www.evertype.com/standards/iso15924/
14139
14140 =item AUTHOR
14141
14142 =item COPYRIGHT
14143
14144 =back
14145
14146 =head2 MIME::Base64 - Encoding and decoding of base64 strings
14147
14148 =over 4
14149
14150 =item SYNOPSIS
14151
14152 =item DESCRIPTION
14153
14154 encode_base64($str, [$eol]), decode_base64($str)
14155
14156 =item DIAGNOSTICS
14157
14158 Premature end of base64 data, Premature padding of base64 data
14159
14160 =item EXAMPLES
14161
14162 =item COPYRIGHT
14163
14164 =back
14165
14166 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
14167 of quoted-printable strings
14168
14169 =over 4
14170
14171 =item SYNOPSIS
14172
14173 =item DESCRIPTION
14174
14175 encode_qp($str), decode_qp($str);
14176
14177 =item COPYRIGHT
14178
14179 =back
14180
14181 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
14182 strings
14183
14184 =over 4
14185
14186 =item SYNOPSIS
14187
14188 =item DESCRIPTION
14189
14190 encode_qp($str), decode_qp($str);
14191
14192 =item COPYRIGHT
14193
14194 =back
14195
14196 =head2 Math::BigFloat - Arbitrary size floating point math package
14197
14198 =over 4
14199
14200 =item SYNOPSIS
14201
14202 =item DESCRIPTION
14203
14204 =over 4
14205
14206 =item Canonical notation
14207
14208 =item Output
14209
14210 =item C<mantissa()>, C<exponent()> and C<parts()>
14211
14212 =item Accuracy vs. Precision
14213
14214 =item Rounding
14215
14216 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
14217 ), fround  ( -$scale ) and fround ( 0 )
14218
14219 =back
14220
14221 =item EXAMPLES
14222
14223   # not ready yet
14224
14225 =item Autocreating constants
14226
14227 =item BUGS
14228
14229 =item CAVEAT
14230
14231 stringify, bstr(), bdiv, Modifying and =, bpow
14232
14233 =item LICENSE
14234
14235 =item AUTHORS
14236
14237 =back
14238
14239 =head2 Math::BigInt - Arbitrary size integer math package
14240
14241 =over 4
14242
14243 =item SYNOPSIS
14244
14245 =item DESCRIPTION
14246
14247 Canonical notation, Input, Output
14248
14249 =item METHODS
14250
14251 =over 4
14252
14253 =item accuracy
14254
14255 =item brsft
14256
14257 =item new
14258
14259 =item bnan
14260
14261 =item bzero
14262
14263 =item binf
14264
14265 =item bone
14266
14267 =item is_one() / is_zero() / is_nan() / is_positive() / is_negative() /
14268 is_inf() / is_odd() / is_even() / is_int()
14269
14270         $x->is_zero();                  # true if arg is +0
14271         $x->is_nan();                   # true if arg is NaN
14272         $x->is_one();                   # true if arg is +1
14273         $x->is_one('-');                # true if arg is -1
14274         $x->is_odd();                   # true if odd, false for even
14275         $x->is_even();                  # true if even, false for odd
14276         $x->is_positive();              # true if >= 0
14277         $x->is_negative();              # true if <  0
14278         $x->is_inf();                   # true if +inf
14279         $x->is_inf('-');                # true if -inf (sign is default
14280 '+')
14281         $x->is_int();                   # true if $x is an integer
14282
14283 =item bcmp
14284
14285 =item bacmp
14286
14287 =item sign
14288
14289 =item bcmp
14290
14291 =item bneg
14292
14293 =item babs
14294
14295 =item bnorm
14296
14297 =item bnot
14298
14299 =item binc
14300
14301 =item bdec
14302
14303 =item badd
14304
14305 =item bsub
14306
14307 =item bmul
14308
14309 =item bdiv
14310
14311 =item bmod
14312
14313 =item bpow
14314
14315 =item blsft
14316
14317 =item brsft
14318
14319 =item band
14320
14321 =item bior
14322
14323 =item bxor
14324
14325 =item bnot
14326
14327 =item bsqrt
14328
14329 =item bfac
14330
14331 =item round
14332
14333 =item bround
14334
14335 =item bfround
14336
14337 =item bfloor
14338
14339 =item bceil
14340
14341 =item bgcd
14342
14343 =item blcm
14344
14345 =item exponent
14346
14347 =item mantissa
14348
14349 =item parts
14350
14351 =item copy
14352
14353 =item as_number
14354
14355 =item bsstr
14356
14357 =item as_hex
14358
14359 =item as_bin
14360
14361 =back
14362
14363 =item ACCURACY and PRECISION
14364
14365 =over 4
14366
14367 =item Precision P
14368
14369 =item Accuracy A
14370
14371 =item Fallback F
14372
14373 =item Rounding mode R
14374
14375 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
14376 (significant digits), Setting/Accessing, Creating numbers, Usage,
14377 Precedence, Overriding globals, Local settings, Rounding, Default values,
14378 Remarks
14379
14380 =back
14381
14382 =item INTERNALS
14383
14384 =over 4
14385
14386 =item MATH LIBRARY
14387
14388 =item SIGN
14389
14390 =item mantissa(), exponent() and parts()
14391
14392 =back
14393
14394 =item EXAMPLES
14395
14396   use Math::BigInt;
14397
14398 =item Autocreating constants
14399
14400 =item PERFORMANCE
14401
14402 =over 4
14403
14404 =item Alternative math libraries
14405
14406 =item SUBCLASSING
14407
14408 =back
14409
14410 =item Subclassing Math::BigInt
14411
14412 =item UPGRADING
14413
14414 =over 4
14415
14416 =item Auto-upgrade
14417
14418 bsqrt(), div(), blog()
14419
14420 =back
14421
14422 =item BUGS
14423
14424 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
14425
14426 =item CAVEATS
14427
14428 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
14429 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
14430 types, bsqrt(), brsft()
14431
14432 =item LICENSE
14433
14434 =item SEE ALSO
14435
14436 =item AUTHORS
14437
14438 =back
14439
14440 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
14441
14442 =over 4
14443
14444 =item SYNOPSIS
14445
14446 =item DESCRIPTION
14447
14448 =item EXPORT
14449
14450 =item WRAP YOUR OWN
14451
14452 =item LICENSE
14453
14454 This program is free software; you may redistribute it and/or modify it
14455 under
14456 the same terms as Perl itself. 
14457
14458 =item AUTHORS
14459
14460 =item SEE ALSO
14461
14462 =back
14463
14464 =head2 Math::Complex - complex numbers and associated mathematical
14465 functions
14466
14467 =over 4
14468
14469 =item SYNOPSIS
14470
14471 =item DESCRIPTION
14472
14473 =item OPERATIONS
14474
14475 =item CREATION
14476
14477 =item STRINGIFICATION
14478
14479 =over 4
14480
14481 =item CHANGED IN PERL 5.6
14482
14483 =back
14484
14485 =item USAGE
14486
14487 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
14488
14489 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
14490
14491 =item BUGS
14492
14493 =item AUTHORS
14494
14495 =back
14496
14497 =head2 Math::Trig - trigonometric functions
14498
14499 =over 4
14500
14501 =item SYNOPSIS
14502
14503 =item DESCRIPTION
14504
14505 =item TRIGONOMETRIC FUNCTIONS
14506
14507 B<tan>
14508
14509 =over 4
14510
14511 =item ERRORS DUE TO DIVISION BY ZERO
14512
14513 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
14514
14515 =back
14516
14517 =item PLANE ANGLE CONVERSIONS
14518
14519 =item RADIAL COORDINATE CONVERSIONS
14520
14521 =over 4
14522
14523 =item COORDINATE SYSTEMS
14524
14525 =item 3-D ANGLE CONVERSIONS
14526
14527 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
14528 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
14529
14530 =back
14531
14532 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
14533
14534 =item EXAMPLES
14535
14536 =over 4
14537
14538 =item CAVEAT FOR GREAT CIRCLE FORMULAS
14539
14540 =back
14541
14542 =item BUGS
14543
14544 =item AUTHORS
14545
14546 =back
14547
14548 =head2 Memoize - Make your functions faster by trading space for time
14549
14550 =over 4
14551
14552 =item SYNOPSIS
14553
14554 =item DESCRIPTION
14555
14556 =item DETAILS
14557
14558 =item OPTIONS
14559
14560 =over 4
14561
14562 =item INSTALL
14563
14564 =item NORMALIZER
14565
14566 =item C<SCALAR_CACHE>, C<LIST_CACHE>
14567
14568 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
14569
14570 =back
14571
14572 =item OTHER FACILITIES
14573
14574 =over 4
14575
14576 =item C<unmemoize>
14577
14578 =item C<flush_cache>
14579
14580 =back
14581
14582 =item CAVEATS
14583
14584 =item PERSISTENT CACHE SUPPORT
14585
14586 =item EXPIRATION SUPPORT
14587
14588 =item BUGS
14589
14590 =item MAILING LIST
14591
14592 =item AUTHOR
14593
14594 =item COPYRIGHT AND LICENSE
14595
14596 =item THANK YOU
14597
14598 =back
14599
14600 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
14601 Storable use
14602
14603 =over 4
14604
14605 =item DESCRIPTION
14606
14607 =back
14608
14609 =head2 Memoize::Expire - Plug-in module for automatic expiration of
14610 memoized values
14611
14612 =over 4
14613
14614 =item SYNOPSIS
14615
14616 =item DESCRIPTION
14617
14618 =item INTERFACE
14619
14620  TIEHASH,  EXISTS,  STORE
14621
14622 =item ALTERNATIVES
14623
14624 =item CAVEATS
14625
14626 =item AUTHOR
14627
14628 =item SEE ALSO
14629
14630 =back
14631
14632 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
14633
14634 =over 4
14635
14636 =item DESCRIPTION
14637
14638 =back
14639
14640 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
14641
14642 =over 4
14643
14644 =item DESCRIPTION
14645
14646 =back
14647
14648 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
14649 Storable use
14650
14651 =over 4
14652
14653 =item DESCRIPTION
14654
14655 =back
14656
14657 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
14658 Storable use
14659
14660 =over 4
14661
14662 =item DESCRIPTION
14663
14664 =back
14665
14666 =head2 Memoize::Storable - store Memoized data in Storable database
14667
14668 =over 4
14669
14670 =item DESCRIPTION
14671
14672 =back
14673
14674 =head2 NDBM_File - Tied access to ndbm files
14675
14676 =over 4
14677
14678 =item SYNOPSIS
14679
14680 =item DESCRIPTION
14681
14682 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
14683
14684 =item DIAGNOSTICS
14685
14686 =over 4
14687
14688 =item C<ndbm store returned -1, errno 22, key "..." at ...>
14689
14690 =back
14691
14692 =item BUGS AND WARNINGS
14693
14694 =back
14695
14696 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
14697
14698 =over 4
14699
14700 =item SYNOPSIS
14701
14702 =item DESCRIPTION
14703
14704 =over 4
14705
14706 =item Enforcing redispatch
14707
14708 =item Avoiding repetitions
14709
14710 =back
14711
14712 =item AUTHOR
14713
14714 =item BUGS AND IRRITATIONS
14715
14716 =item COPYRIGHT
14717
14718 =back
14719
14720 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
14721
14722 =over 4
14723
14724 =item SYNOPSIS
14725
14726 =item DESCRIPTION
14727
14728 =item USER METHODS
14729
14730 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
14731 dataend ()
14732
14733 =item CLASS METHODS
14734
14735 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
14736 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
14737 ungetline ( TEXT ), read_until_dot (), tied_fh ()
14738
14739 =item EXPORTS
14740
14741 =item AUTHOR
14742
14743 =item COPYRIGHT
14744
14745 =back
14746
14747 =head2 Net::Config - Local configuration data for libnet
14748
14749 =over 4
14750
14751 =item SYNOPSYS
14752
14753 =item DESCRIPTION
14754
14755 =item METHODS
14756
14757 requires_firewall HOST
14758
14759 =item NetConfig VALUES
14760
14761 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
14762 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
14763 ftp_int_pasive, local_netmask, test_hosts, test_exists
14764
14765 =back
14766
14767 =head2 Net::Domain - Attempt to evaluate the current host's internet name
14768 and domain
14769
14770 =over 4
14771
14772 =item SYNOPSIS
14773
14774 =item DESCRIPTION
14775
14776 hostfqdn (), hostname (), hostdomain ()
14777
14778 =item AUTHOR
14779
14780 =item COPYRIGHT
14781
14782 =back
14783
14784 =head2 Net::FTP - FTP Client class
14785
14786 =over 4
14787
14788 =item SYNOPSIS
14789
14790 =item DESCRIPTION
14791
14792 =item OVERVIEW
14793
14794 =item CONSTRUCTOR
14795
14796 new (HOST [,OPTIONS])
14797
14798 =item METHODS
14799
14800 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
14801 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
14802 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
14803 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
14804 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
14805 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
14806 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
14807 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
14808 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
14809 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
14810 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
14811 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
14812 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
14813
14814 =over 4
14815
14816 =item Methods for the adventurous
14817
14818 quot (CMD [,ARGS])
14819
14820 =back
14821
14822 =item THE dataconn CLASS
14823
14824 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
14825 bytes_read (), abort (), close ()
14826
14827 =item UNIMPLEMENTED
14828
14829 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
14830
14831 =item REPORTING BUGS
14832
14833 =item AUTHOR
14834
14835 =item SEE ALSO
14836
14837 =item USE EXAMPLES
14838
14839 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
14840
14841 =item CREDITS
14842
14843 =item COPYRIGHT
14844
14845 =back
14846
14847 =head2 Net::NNTP - NNTP Client class
14848
14849 =over 4
14850
14851 =item SYNOPSIS
14852
14853 =item DESCRIPTION
14854
14855 =item CONSTRUCTOR
14856
14857 new ( [ HOST ] [, OPTIONS ])
14858
14859 =item METHODS
14860
14861 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
14862 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
14863 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
14864 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
14865 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
14866 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
14867 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
14868
14869 =over 4
14870
14871 =item Extension methods
14872
14873 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
14874 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
14875 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
14876 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
14877 GROUP ] ), reader
14878
14879 =back
14880
14881 =item UNSUPPORTED
14882
14883 =item DEFINITIONS
14884
14885 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
14886
14887 =item SEE ALSO
14888
14889 =item AUTHOR
14890
14891 =item COPYRIGHT
14892
14893 =back
14894
14895 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
14896
14897 =over 4
14898
14899 =item SYNOPSIS
14900
14901 =item DESCRIPTION
14902
14903 =item EXAMPLES
14904
14905 =item CONSTRUCTOR
14906
14907 new ( [ HOST, ] [ OPTIONS ] )
14908
14909 =item METHODS
14910
14911 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
14912 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
14913 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
14914 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
14915
14916 =item NOTES
14917
14918 =item SEE ALSO
14919
14920 =item AUTHOR
14921
14922 =item COPYRIGHT
14923
14924 =back
14925
14926 =head2 Net::Ping - check a remote host for reachability
14927
14928 =over 4
14929
14930 =item SYNOPSIS
14931
14932 =item DESCRIPTION
14933
14934 =over 4
14935
14936 =item Functions
14937
14938 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);,
14939 $p->bind($local_addr);, $p->ping($host [, $timeout]);, $p->open($host);,
14940 $p->open($host);, $p->close();, pingecho($host [, $timeout]);
14941
14942 =back
14943
14944 =item WARNING
14945
14946 =item NOTES
14947
14948 =item AUTHORS
14949
14950 =item COPYRIGHT
14951
14952 =back
14953
14954 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
14955
14956 =over 4
14957
14958 =item SYNOPSIS
14959
14960 =item DESCRIPTION
14961
14962 =item EXAMPLES
14963
14964 =item CONSTRUCTOR
14965
14966 new Net::SMTP [ HOST, ] [ OPTIONS ]
14967
14968 =item METHODS
14969
14970 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
14971 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
14972 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
14973 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
14974 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
14975 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
14976 quit ()
14977
14978 =item SEE ALSO
14979
14980 =item AUTHOR
14981
14982 =item COPYRIGHT
14983
14984 =back
14985
14986 =head2 Net::Time - time and daytime network client interface
14987
14988 =over 4
14989
14990 =item SYNOPSIS
14991
14992 =item DESCRIPTION
14993
14994 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
14995 PROTOCOL [, TIMEOUT]]])
14996
14997 =item AUTHOR
14998
14999 =item COPYRIGHT
15000
15001 =back
15002
15003 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
15004 functions
15005
15006 =over 4
15007
15008 =item SYNOPSIS
15009
15010 =item DESCRIPTION
15011
15012 =item EXAMPLES
15013
15014 =item NOTE
15015
15016 =item AUTHOR
15017
15018 =back
15019
15020 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
15021
15022 =over 4
15023
15024 =item DESCRIPTION
15025
15026 =over 4
15027
15028 =item Where to get this document
15029
15030 =item How to contribute to this document
15031
15032 =back
15033
15034 =item Author and Copyright Information
15035
15036 =over 4
15037
15038 =item Disclaimer
15039
15040 =back
15041
15042 =item Obtaining and installing libnet
15043
15044 =over 4
15045
15046 =item What is libnet ?
15047
15048 =item Which version of perl do I need ?
15049
15050 =item What other modules do I need ?
15051
15052 =item What machines support libnet ?
15053
15054 =item Where can I get the latest libnet release
15055
15056 =back
15057
15058 =item Using Net::FTP
15059
15060 =over 4
15061
15062 =item How do I download files from an FTP server ?
15063
15064 =item How do I transfer files in binary mode ?
15065
15066 =item How can I get the size of a file on a remote FTP server ?
15067
15068 =item How can I get the modification time of a file on a remote FTP server
15069 ?
15070
15071 =item How can I change the permissions of a file on a remote server ?
15072
15073 =item Can I do a reget operation like the ftp command ?
15074
15075 =item How do I get a directory listing from an FTP server ?
15076
15077 =item Changing directory to "" does not fail ?
15078
15079 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
15080
15081 =item I am behind an FTP proxy firewall, but cannot access machines outside
15082 ?
15083
15084 =item My ftp proxy firewall does not listen on port 21
15085
15086 =item Is it possible to change the file permissions of a file on an FTP
15087 server ?
15088
15089 =item I have seen scripts call a method message, but cannot find it
15090 documented ?
15091
15092 =item Why does Net::FTP not implement mput and mget methods
15093
15094 =back
15095
15096 =item Using Net::SMTP
15097
15098 =over 4
15099
15100 =item Why can't the part of an Email address after the @ be used as the
15101 hostname ?
15102
15103 =item Why does Net::SMTP not do DNS MX lookups ?
15104
15105 =item The verify method always returns true ?
15106
15107 =back
15108
15109 =item Debugging scripts
15110
15111 =over 4
15112
15113 =item How can I debug my scripts that use Net::* modules ?
15114
15115 =back
15116
15117 =item AUTHOR AND COPYRIGHT
15118
15119 =back
15120
15121 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
15122 functions
15123
15124 =over 4
15125
15126 =item SYNOPSIS
15127
15128 =item DESCRIPTION
15129
15130 =item EXAMPLES
15131
15132 =item NOTE
15133
15134 =item AUTHOR
15135
15136 =back
15137
15138 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
15139 functions
15140
15141 =over 4
15142
15143 =item SYNOPSIS
15144
15145 =item DESCRIPTION
15146
15147 =item NOTE
15148
15149 =item AUTHOR
15150
15151 =back
15152
15153 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
15154 functions
15155
15156 =over 4
15157
15158 =item SYNOPSIS
15159
15160 =item DESCRIPTION
15161
15162 =item EXAMPLES
15163
15164 =item NOTE
15165
15166 =item AUTHOR
15167
15168 =back
15169
15170 =head2 Netrc, Net::Netrc - OO interface to users netrc file
15171
15172 =over 4
15173
15174 =item SYNOPSIS
15175
15176 =item DESCRIPTION
15177
15178 =item THE .netrc FILE
15179
15180 machine name, default, login name, password string, account string, macdef
15181 name
15182
15183 =item CONSTRUCTOR
15184
15185 lookup ( MACHINE [, LOGIN ])
15186
15187 =item METHODS
15188
15189 login (), password (), account (), lpa ()
15190
15191 =item AUTHOR
15192
15193 =item SEE ALSO
15194
15195 =item COPYRIGHT
15196
15197 =back
15198
15199 =head2 O - Generic interface to Perl Compiler backends
15200
15201 =over 4
15202
15203 =item SYNOPSIS
15204
15205 =item DESCRIPTION
15206
15207 =item CONVENTIONS
15208
15209 =item IMPLEMENTATION
15210
15211 =item AUTHOR
15212
15213 =back
15214
15215 =head2 ODBM_File - Tied access to odbm files
15216
15217 =over 4
15218
15219 =item SYNOPSIS
15220
15221 =item DESCRIPTION
15222
15223 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15224
15225 =item DIAGNOSTICS
15226
15227 =over 4
15228
15229 =item C<odbm store returned -1, errno 22, key "..." at ...>
15230
15231 =back
15232
15233 =item BUGS AND WARNINGS
15234
15235 =back
15236
15237 =head2 Opcode - Disable named opcodes when compiling perl code
15238
15239 =over 4
15240
15241 =item SYNOPSIS
15242
15243 =item DESCRIPTION
15244
15245 =item NOTE
15246
15247 =item WARNING
15248
15249 =item Operator Names and Operator Lists
15250
15251 an operator name (opname), an operator tag name (optag), a negated opname
15252 or optag, an operator set (opset)
15253
15254 =item Opcode Functions
15255
15256 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
15257 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
15258 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
15259 opdump (PAT)
15260
15261 =item Manipulating Opsets
15262
15263 =item TO DO (maybe)
15264
15265 =back
15266
15267 =over 4
15268
15269 =item Predefined Opcode Tags
15270
15271 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
15272 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
15273 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
15274 :dangerous
15275
15276 =item SEE ALSO
15277
15278 =item AUTHORS
15279
15280 =back
15281
15282 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
15283 compartments
15284
15285 =over 4
15286
15287 =item SYNOPSIS
15288
15289 =item DESCRIPTION
15290
15291 a new namespace, an operator mask
15292
15293 =item WARNING
15294
15295 =over 4
15296
15297 =item RECENT CHANGES
15298
15299 =item Methods in class Safe
15300
15301 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
15302 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
15303 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
15304 root (NAMESPACE), mask (MASK)
15305
15306 =item Some Safety Issues
15307
15308 Memory, CPU, Snooping, Signals, State Changes
15309
15310 =item AUTHOR
15311
15312 =back
15313
15314 =back
15315
15316 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
15317 compiling
15318
15319 =over 4
15320
15321 =item SYNOPSIS  
15322
15323 =item DESCRIPTION
15324
15325 =item SEE ALSO
15326
15327 =back
15328
15329 =head2 POSIX - Perl interface to IEEE Std 1003.1
15330
15331 =over 4
15332
15333 =item SYNOPSIS
15334
15335 =item DESCRIPTION
15336
15337 =item NOTE
15338
15339 =item CAVEATS 
15340
15341 =item FUNCTIONS
15342
15343 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
15344 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
15345 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
15346 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
15347 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
15348 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
15349 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
15350 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
15351 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
15352 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
15353 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
15354 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
15355 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
15356 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
15357 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
15358 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
15359 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
15360 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
15361 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
15362 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
15363 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
15364 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
15365 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
15366 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
15367 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
15368 wctomb, write
15369
15370 =item CLASSES
15371
15372 =over 4
15373
15374 =item POSIX::SigAction
15375
15376 new
15377
15378 =item POSIX::SigSet
15379
15380 new, addset, delset, emptyset, fillset, ismember
15381
15382 =item POSIX::Termios
15383
15384 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
15385 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
15386 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
15387 field values, c_cflag field values, c_iflag field values, c_lflag field
15388 values, c_oflag field values
15389
15390 =back
15391
15392 =item PATHNAME CONSTANTS
15393
15394 Constants
15395
15396 =item POSIX CONSTANTS
15397
15398 Constants
15399
15400 =item SYSTEM CONFIGURATION
15401
15402 Constants
15403
15404 =item ERRNO
15405
15406 Constants
15407
15408 =item FCNTL
15409
15410 Constants
15411
15412 =item FLOAT
15413
15414 Constants
15415
15416 =item LIMITS
15417
15418 Constants
15419
15420 =item LOCALE
15421
15422 Constants
15423
15424 =item MATH
15425
15426 Constants
15427
15428 =item SIGNAL
15429
15430 Constants
15431
15432 =item STAT
15433
15434 Constants, Macros
15435
15436 =item STDLIB
15437
15438 Constants
15439
15440 =item STDIO
15441
15442 Constants
15443
15444 =item TIME
15445
15446 Constants
15447
15448 =item UNISTD
15449
15450 Constants
15451
15452 =item WAIT
15453
15454 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
15455 WTERMSIG, WIFSTOPPED, WSTOPSIG
15456
15457 =back
15458
15459 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
15460 name space
15461
15462 =over 4
15463
15464 =item SYNOPSIS
15465
15466 =item DESCRIPTION
15467
15468 unix, stdio, perlio, crlf, utf8, raw
15469
15470 =over 4
15471
15472 =item Defaults and how to override them
15473
15474 =back
15475
15476 =item AUTHOR
15477
15478 =item SEE ALSO
15479
15480 =back
15481
15482 =head2 PerlIO::Scalar - support module for in-memory IO.
15483
15484 =over 4
15485
15486 =item SYNOPSIS
15487
15488 =item DESCRIPTION
15489
15490 =back
15491
15492 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
15493
15494 =over 4
15495
15496 =item SYNOPSIS
15497
15498 =item DESCRIPTION
15499
15500 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
15501 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
15502 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
15503 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
15504 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
15505 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
15506 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
15507
15508 =over 4
15509
15510 =item Example - a Hexadecimal Handle
15511
15512 =back
15513
15514 =back
15515
15516 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
15517
15518 =over 4
15519
15520 =item SYNOPSIS
15521
15522 =item OPTIONS/ARGUMENTS
15523
15524 =over 4
15525
15526 =item podchecker()
15527
15528 B<-warnings> =E<gt> I<val>
15529
15530 =back
15531
15532 =item DESCRIPTION
15533
15534 =item DIAGNOSTICS
15535
15536 =over 4
15537
15538 =item Errors
15539
15540 empty =headn, =over on line I<N> without closing =back, =item without
15541 previous =over, =back without previous =over, No argument for =begin, =end
15542 without =begin, Nested =begin's, =for without formatter specification,
15543 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
15544 interior-sequence "I<SEQ>", nested commands
15545 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
15546 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
15547 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
15548 after =back
15549
15550 =item Warnings
15551
15552 multiple occurence of link target I<name>, line containing nothing but
15553 whitespace in paragraph, file does not start with =head, previous =item has
15554 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
15555 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
15556 items in =over, No argument for =item, empty section in previous paragraph,
15557 Verbatim paragraph in NAME section
15558
15559 =item Hyperlinks
15560
15561 ignoring leading/trailing whitespace in link, (section) in '$page'
15562 deprecated, alternative text/node '%s' contains non-escaped | or /
15563
15564 =back
15565
15566 =item RETURN VALUE
15567
15568 =item EXAMPLES
15569
15570 =item INTERFACE
15571
15572 =back
15573
15574 C<Pod::Checker-E<gt>new( %options )>
15575
15576 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
15577 @args )>
15578
15579 C<$checker-E<gt>num_errors()>
15580
15581 C<$checker-E<gt>name()>
15582
15583 C<$checker-E<gt>node()>
15584
15585 C<$checker-E<gt>idx()>
15586
15587 C<$checker-E<gt>hyperlink()>
15588
15589 =over 4
15590
15591 =item AUTHOR
15592
15593 =back
15594
15595 =head2 Pod::Find - find POD documents in directory trees
15596
15597 =over 4
15598
15599 =item SYNOPSIS
15600
15601 =item DESCRIPTION
15602
15603 =back
15604
15605 =over 4
15606
15607 =item C<pod_find( { %opts } , @directories )>
15608
15609 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
15610 1>
15611
15612 =back
15613
15614 =over 4
15615
15616 =item C<simplify_name( $str )>
15617
15618 =back
15619
15620 =over 4
15621
15622 =item C<pod_where( { %opts }, $pod )>
15623
15624 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
15625 1>
15626
15627 =back
15628
15629 =over 4
15630
15631 =item C<contains_pod( $file , $verbose )>
15632
15633 =back
15634
15635 =over 4
15636
15637 =item AUTHOR
15638
15639 =item SEE ALSO
15640
15641 =back
15642
15643 =head2 Pod::Html - module to convert pod files to HTML
15644
15645 =over 4
15646
15647 =item SYNOPSIS
15648
15649 =item DESCRIPTION
15650
15651 =item ARGUMENTS
15652
15653 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
15654 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
15655 title, verbose
15656
15657 =item EXAMPLE
15658
15659 =item ENVIRONMENT
15660
15661 =item AUTHOR
15662
15663 =item SEE ALSO
15664
15665 =item COPYRIGHT
15666
15667 =back
15668
15669 =head2 Pod::InputObjects - objects representing POD input paragraphs,
15670 commands, etc.
15671
15672 =over 4
15673
15674 =item SYNOPSIS
15675
15676 =item REQUIRES
15677
15678 =item EXPORTS
15679
15680 =item DESCRIPTION
15681
15682 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
15683 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
15684
15685 =back
15686
15687 =over 4
15688
15689 =item B<Pod::InputSource>
15690
15691 =back
15692
15693 =over 4
15694
15695 =item B<new()>
15696
15697 =back
15698
15699 =over 4
15700
15701 =item B<name()>
15702
15703 =back
15704
15705 =over 4
15706
15707 =item B<handle()>
15708
15709 =back
15710
15711 =over 4
15712
15713 =item B<was_cutting()>
15714
15715 =back
15716
15717 =over 4
15718
15719 =item B<Pod::Paragraph>
15720
15721 =back
15722
15723 =over 4
15724
15725 =item Pod::Paragraph-E<gt>B<new()>
15726
15727 =back
15728
15729 =over 4
15730
15731 =item $pod_para-E<gt>B<cmd_name()>
15732
15733 =back
15734
15735 =over 4
15736
15737 =item $pod_para-E<gt>B<text()>
15738
15739 =back
15740
15741 =over 4
15742
15743 =item $pod_para-E<gt>B<raw_text()>
15744
15745 =back
15746
15747 =over 4
15748
15749 =item $pod_para-E<gt>B<cmd_prefix()>
15750
15751 =back
15752
15753 =over 4
15754
15755 =item $pod_para-E<gt>B<cmd_separator()>
15756
15757 =back
15758
15759 =over 4
15760
15761 =item $pod_para-E<gt>B<parse_tree()>
15762
15763 =back
15764
15765 =over 4
15766
15767 =item $pod_para-E<gt>B<file_line()>
15768
15769 =back
15770
15771 =over 4
15772
15773 =item B<Pod::InteriorSequence>
15774
15775 =back
15776
15777 =over 4
15778
15779 =item Pod::InteriorSequence-E<gt>B<new()>
15780
15781 =back
15782
15783 =over 4
15784
15785 =item $pod_seq-E<gt>B<cmd_name()>
15786
15787 =back
15788
15789 =over 4
15790
15791 =item $pod_seq-E<gt>B<prepend()>
15792
15793 =back
15794
15795 =over 4
15796
15797 =item $pod_seq-E<gt>B<append()>
15798
15799 =back
15800
15801 =over 4
15802
15803 =item $pod_seq-E<gt>B<nested()>
15804
15805 =back
15806
15807 =over 4
15808
15809 =item $pod_seq-E<gt>B<raw_text()>
15810
15811 =back
15812
15813 =over 4
15814
15815 =item $pod_seq-E<gt>B<left_delimiter()>
15816
15817 =back
15818
15819 =over 4
15820
15821 =item $pod_seq-E<gt>B<right_delimiter()>
15822
15823 =back
15824
15825 =over 4
15826
15827 =item $pod_seq-E<gt>B<parse_tree()>
15828
15829 =back
15830
15831 =over 4
15832
15833 =item $pod_seq-E<gt>B<file_line()>
15834
15835 =back
15836
15837 =over 4
15838
15839 =item Pod::InteriorSequence::B<DESTROY()>
15840
15841 =back
15842
15843 =over 4
15844
15845 =item B<Pod::ParseTree>
15846
15847 =back
15848
15849 =over 4
15850
15851 =item Pod::ParseTree-E<gt>B<new()>
15852
15853 =back
15854
15855 =over 4
15856
15857 =item $ptree-E<gt>B<top()>
15858
15859 =back
15860
15861 =over 4
15862
15863 =item $ptree-E<gt>B<children()>
15864
15865 =back
15866
15867 =over 4
15868
15869 =item $ptree-E<gt>B<prepend()>
15870
15871 =back
15872
15873 =over 4
15874
15875 =item $ptree-E<gt>B<append()>
15876
15877 =back
15878
15879 =over 4
15880
15881 =item $ptree-E<gt>B<raw_text()>
15882
15883 =back
15884
15885 =over 4
15886
15887 =item Pod::ParseTree::B<DESTROY()>
15888
15889 =back
15890
15891 =over 4
15892
15893 =item SEE ALSO
15894
15895 =item AUTHOR
15896
15897 =back
15898
15899 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
15900
15901 =over 4
15902
15903 =item SYNOPSIS
15904
15905 =item DESCRIPTION
15906
15907 =back
15908
15909 =over 4
15910
15911 =item OBJECT METHODS
15912
15913 C<initialize>
15914
15915 =back
15916
15917 =over 4
15918
15919 =item Data Accessors
15920
15921 B<AddPreamble>
15922
15923 =back
15924
15925 B<AddPostamble>
15926
15927 B<Head1Level>
15928
15929 B<Label>
15930
15931 B<LevelNoNum>
15932
15933 B<MakeIndex>
15934
15935 B<ReplaceNAMEwithSection>
15936
15937 B<StartWithNewPage>
15938
15939 B<TableOfContents>
15940
15941 B<UniqueLabels>
15942
15943 B<UserPreamble>
15944
15945 B<UserPostamble>
15946
15947 B<Lists>
15948
15949 =over 4
15950
15951 =item Subclassed methods
15952
15953 =back
15954
15955 B<begin_pod>
15956
15957 B<end_pod>
15958
15959 B<command>
15960
15961 B<verbatim>
15962
15963 B<textblock>
15964
15965 B<interior_sequence>
15966
15967 =over 4
15968
15969 =item List Methods
15970
15971 B<begin_list>
15972
15973 =back
15974
15975 B<end_list>
15976
15977 B<add_item>
15978
15979 =over 4
15980
15981 =item Methods for headings
15982
15983 B<head>
15984
15985 =back
15986
15987 =over 4
15988
15989 =item Internal methods
15990
15991 B<_output>
15992
15993 =back
15994
15995 B<_replace_special_chars>
15996
15997 B<_replace_special_chars_late>
15998
15999 B<_create_label>
16000
16001 B<_create_index>
16002
16003 B<_clean_latex_commands>
16004
16005 B<_split_delimited>
16006
16007 =over 4
16008
16009 =item NOTES
16010
16011 =item SEE ALSO
16012
16013 =item AUTHORS
16014
16015 =item COPYRIGHT
16016
16017 =item REVISION
16018
16019 =back
16020
16021 =head2 Pod::Man - Convert POD data to formatted *roff input
16022
16023 =over 4
16024
16025 =item SYNOPSIS
16026
16027 =item DESCRIPTION
16028
16029 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
16030 release, section
16031
16032 =item DIAGNOSTICS
16033
16034 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
16035 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
16036 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
16037 =back
16038
16039 =item BUGS
16040
16041 =item CAVEATS
16042
16043 =item SEE ALSO
16044
16045 =item AUTHOR
16046
16047 =item COPYRIGHT AND LICENSE
16048
16049 =back
16050
16051 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
16052
16053 =over 4
16054
16055 =item SYNOPSIS
16056
16057 =item DESCRIPTION
16058
16059 =item AUTHOR
16060
16061 =item COPYRIGHT AND LICENSE
16062
16063 =back
16064
16065 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
16066
16067 =over 4
16068
16069 =item SYNOPSIS
16070
16071 =item DESCRIPTION
16072
16073 =back
16074
16075 =over 4
16076
16077 =item Pod::List
16078
16079 Pod::List-E<gt>new()
16080
16081 =back
16082
16083 $list-E<gt>file()
16084
16085 $list-E<gt>start()
16086
16087 $list-E<gt>indent()
16088
16089 $list-E<gt>type()
16090
16091 $list-E<gt>rx()
16092
16093 $list-E<gt>item()
16094
16095 $list-E<gt>parent()
16096
16097 $list-E<gt>tag()
16098
16099 =over 4
16100
16101 =item Pod::Hyperlink
16102
16103 Pod::Hyperlink-E<gt>new()
16104
16105 =back
16106
16107 $link-E<gt>parse($string)
16108
16109 $link-E<gt>markup($string)
16110
16111 $link-E<gt>text()
16112
16113 $link-E<gt>warning()
16114
16115 $link-E<gt>file(), $link-E<gt>line()
16116
16117 $link-E<gt>page()
16118
16119 $link-E<gt>node()
16120
16121 $link-E<gt>alttext()
16122
16123 $link-E<gt>type()
16124
16125 $link-E<gt>link()
16126
16127 =over 4
16128
16129 =item Pod::Cache
16130
16131 Pod::Cache-E<gt>new()
16132
16133 =back
16134
16135 $cache-E<gt>item()
16136
16137 $cache-E<gt>find_page($name)
16138
16139 =over 4
16140
16141 =item Pod::Cache::Item
16142
16143 Pod::Cache::Item-E<gt>new()
16144
16145 =back
16146
16147 $cacheitem-E<gt>page()
16148
16149 $cacheitem-E<gt>description()
16150
16151 $cacheitem-E<gt>path()
16152
16153 $cacheitem-E<gt>file()
16154
16155 $cacheitem-E<gt>nodes()
16156
16157 $cacheitem-E<gt>find_node($name)
16158
16159 $cacheitem-E<gt>idx()
16160
16161 =over 4
16162
16163 =item AUTHOR
16164
16165 =item SEE ALSO
16166
16167 =back
16168
16169 =head2 Pod::Parser - base class for creating POD filters and translators
16170
16171 =over 4
16172
16173 =item SYNOPSIS
16174
16175 =item REQUIRES
16176
16177 =item EXPORTS
16178
16179 =item DESCRIPTION
16180
16181 =item QUICK OVERVIEW
16182
16183 =item PARSING OPTIONS
16184
16185 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
16186 B<-warnings> (default: unset)
16187
16188 =back
16189
16190 =over 4
16191
16192 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
16193
16194 =back
16195
16196 =over 4
16197
16198 =item B<command()>
16199
16200 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
16201
16202 =back
16203
16204 =over 4
16205
16206 =item B<verbatim()>
16207
16208 C<$text>, C<$line_num>, C<$pod_para>
16209
16210 =back
16211
16212 =over 4
16213
16214 =item B<textblock()>
16215
16216 C<$text>, C<$line_num>, C<$pod_para>
16217
16218 =back
16219
16220 =over 4
16221
16222 =item B<interior_sequence()>
16223
16224 =back
16225
16226 =over 4
16227
16228 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
16229
16230 =back
16231
16232 =over 4
16233
16234 =item B<new()>
16235
16236 =back
16237
16238 =over 4
16239
16240 =item B<initialize()>
16241
16242 =back
16243
16244 =over 4
16245
16246 =item B<begin_pod()>
16247
16248 =back
16249
16250 =over 4
16251
16252 =item B<begin_input()>
16253
16254 =back
16255
16256 =over 4
16257
16258 =item B<end_input()>
16259
16260 =back
16261
16262 =over 4
16263
16264 =item B<end_pod()>
16265
16266 =back
16267
16268 =over 4
16269
16270 =item B<preprocess_line()>
16271
16272 =back
16273
16274 =over 4
16275
16276 =item B<preprocess_paragraph()>
16277
16278 =back
16279
16280 =over 4
16281
16282 =item METHODS FOR PARSING AND PROCESSING
16283
16284 =back
16285
16286 =over 4
16287
16288 =item B<parse_text()>
16289
16290 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
16291 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
16292 I<code-ref>|I<method-name>
16293
16294 =back
16295
16296 =over 4
16297
16298 =item B<interpolate()>
16299
16300 =back
16301
16302 =over 4
16303
16304 =item B<parse_paragraph()>
16305
16306 =back
16307
16308 =over 4
16309
16310 =item B<parse_from_filehandle()>
16311
16312 =back
16313
16314 =over 4
16315
16316 =item B<parse_from_file()>
16317
16318 =back
16319
16320 =over 4
16321
16322 =item ACCESSOR METHODS
16323
16324 =back
16325
16326 =over 4
16327
16328 =item B<errorsub()>
16329
16330 =back
16331
16332 =over 4
16333
16334 =item B<cutting()>
16335
16336 =back
16337
16338 =over 4
16339
16340 =item B<parseopts()>
16341
16342 =back
16343
16344 =over 4
16345
16346 =item B<output_file()>
16347
16348 =back
16349
16350 =over 4
16351
16352 =item B<output_handle()>
16353
16354 =back
16355
16356 =over 4
16357
16358 =item B<input_file()>
16359
16360 =back
16361
16362 =over 4
16363
16364 =item B<input_handle()>
16365
16366 =back
16367
16368 =over 4
16369
16370 =item B<input_streams()>
16371
16372 =back
16373
16374 =over 4
16375
16376 =item B<top_stream()>
16377
16378 =back
16379
16380 =over 4
16381
16382 =item PRIVATE METHODS AND DATA
16383
16384 =back
16385
16386 =over 4
16387
16388 =item B<_push_input_stream()>
16389
16390 =back
16391
16392 =over 4
16393
16394 =item B<_pop_input_stream()>
16395
16396 =back
16397
16398 =over 4
16399
16400 =item TREE-BASED PARSING
16401
16402 =item SEE ALSO
16403
16404 =item AUTHOR
16405
16406 =back
16407
16408 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
16409
16410 =over 4
16411
16412 =item SYNOPSIS
16413
16414 =item DESCRIPTION
16415
16416 =over 4
16417
16418 =item EXPORT
16419
16420 =back
16421
16422 =item AUTHOR
16423
16424 =item SEE ALSO
16425
16426 =back
16427
16428 =head2 Pod::Select, podselect() - extract selected sections of POD from
16429 input
16430
16431 =over 4
16432
16433 =item SYNOPSIS
16434
16435 =item REQUIRES
16436
16437 =item EXPORTS
16438
16439 =item DESCRIPTION
16440
16441 =item SECTION SPECIFICATIONS
16442
16443 =item RANGE SPECIFICATIONS
16444
16445 =back
16446
16447 =over 4
16448
16449 =item OBJECT METHODS
16450
16451 =back
16452
16453 =over 4
16454
16455 =item B<curr_headings()>
16456
16457 =back
16458
16459 =over 4
16460
16461 =item B<select()>
16462
16463 =back
16464
16465 =over 4
16466
16467 =item B<add_selection()>
16468
16469 =back
16470
16471 =over 4
16472
16473 =item B<clear_selections()>
16474
16475 =back
16476
16477 =over 4
16478
16479 =item B<match_section()>
16480
16481 =back
16482
16483 =over 4
16484
16485 =item B<is_selected()>
16486
16487 =back
16488
16489 =over 4
16490
16491 =item EXPORTED FUNCTIONS
16492
16493 =back
16494
16495 =over 4
16496
16497 =item B<podselect()>
16498
16499 B<-output>, B<-sections>, B<-ranges>
16500
16501 =back
16502
16503 =over 4
16504
16505 =item PRIVATE METHODS AND DATA
16506
16507 =back
16508
16509 =over 4
16510
16511 =item B<_compile_section_spec()>
16512
16513 =back
16514
16515 =over 4
16516
16517 =item $self->{_SECTION_HEADINGS}
16518
16519 =back
16520
16521 =over 4
16522
16523 =item $self->{_SELECTED_SECTIONS}
16524
16525 =back
16526
16527 =over 4
16528
16529 =item SEE ALSO
16530
16531 =item AUTHOR
16532
16533 =back
16534
16535 =head2 Pod::Text - Convert POD data to formatted ASCII text
16536
16537 =over 4
16538
16539 =item SYNOPSIS
16540
16541 =item DESCRIPTION
16542
16543 alt, code, indent, loose, quotes, sentence, width
16544
16545 =item DIAGNOSTICS
16546
16547 Bizarre space in item, Item called without tag, Can't open %s for reading:
16548 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
16549 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
16550 Unmatched =back
16551
16552 =item RESTRICTIONS
16553
16554 =item NOTES
16555
16556 =item SEE ALSO
16557
16558 =item AUTHOR
16559
16560 =item COPYRIGHT AND LICENSE
16561
16562 =back
16563
16564 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
16565
16566 =over 4
16567
16568 =item SYNOPSIS
16569
16570 =item DESCRIPTION
16571
16572 =item BUGS
16573
16574 =item SEE ALSO
16575
16576 =item AUTHOR
16577
16578 =item COPYRIGHT AND LICENSE
16579
16580 =back
16581
16582 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
16583 text
16584
16585 =over 4
16586
16587 =item SYNOPSIS
16588
16589 =item DESCRIPTION
16590
16591 =item BUGS
16592
16593 =item SEE ALSO
16594
16595 =item AUTHOR
16596
16597 =item COPYRIGHT AND LICENSE
16598
16599 =back
16600
16601 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
16602 text with format escapes
16603
16604 =over 4
16605
16606 =item SYNOPSIS
16607
16608 =item DESCRIPTION
16609
16610 =item NOTES
16611
16612 =item SEE ALSO
16613
16614 =item AUTHOR
16615
16616 =item COPYRIGHT AND LICENSE
16617
16618 =back
16619
16620 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
16621 documentation
16622
16623 =over 4
16624
16625 =item SYNOPSIS
16626
16627 =item ARGUMENTS
16628
16629 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
16630 C<-pathlist>
16631
16632 =item DESCRIPTION
16633
16634 =item EXAMPLES
16635
16636 =over 4
16637
16638 =item Recommended Use
16639
16640 =back
16641
16642 =item CAVEATS
16643
16644 =item AUTHOR
16645
16646 =item ACKNOWLEDGEMENTS
16647
16648 =back
16649
16650 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
16651 translators.
16652
16653 =over 4
16654
16655 =item HEADINGS
16656
16657 =item This C<is> a "level 1" heading
16658
16659 =over 4
16660
16661 =item ``Level'' "2 I<heading>
16662
16663 =back
16664
16665 =item This C<is> a "level 1" heading
16666
16667 =over 4
16668
16669 =item ``Level'' 2 I<heading>
16670
16671 =back
16672
16673 =item LINKS
16674
16675 =item OVER AND ITEMS
16676
16677 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
16678 text
16679
16680 =item FORMATTING CODES
16681
16682 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
16683
16684 =item VERBATIM
16685
16686 =item CONCLUSION
16687
16688 =back
16689
16690 =head2 SDBM_File - Tied access to sdbm files
16691
16692 =over 4
16693
16694 =item SYNOPSIS
16695
16696 =item DESCRIPTION
16697
16698 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16699
16700 =item DIAGNOSTICS
16701
16702 =over 4
16703
16704 =item C<sdbm store returned -1, errno 22, key "..." at ...>
16705
16706 =back
16707
16708 =item BUGS AND WARNINGS
16709
16710 =back
16711
16712 =head2 Safe - Compile and execute code in restricted compartments
16713
16714 =over 4
16715
16716 =item SYNOPSIS
16717
16718 =item DESCRIPTION
16719
16720 a new namespace, an operator mask
16721
16722 =item WARNING
16723
16724 =over 4
16725
16726 =item RECENT CHANGES
16727
16728 =item Methods in class Safe
16729
16730 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16731 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16732 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16733 root (NAMESPACE), mask (MASK)
16734
16735 =item Some Safety Issues
16736
16737 Memory, CPU, Snooping, Signals, State Changes
16738
16739 =item AUTHOR
16740
16741 =back
16742
16743 =back
16744
16745 =head2 Scalar::Util - A selection of general-utility scalar subroutines
16746
16747 =over 4
16748
16749 =item SYNOPSIS
16750
16751 =item DESCRIPTION
16752
16753 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
16754 EXPR, tainted EXPR, weaken REF
16755
16756 =item KNOWN BUGS
16757
16758 =item COPYRIGHT
16759
16760 =item BLATANT PLUG
16761
16762 =back
16763
16764 =head2 Search::Dict, look - search for key in dictionary file
16765
16766 =over 4
16767
16768 =item SYNOPSIS
16769
16770 =item DESCRIPTION
16771
16772 =back
16773
16774 =head2 SelectSaver - save and restore selected file handle
16775
16776 =over 4
16777
16778 =item SYNOPSIS
16779
16780 =item DESCRIPTION
16781
16782 =back
16783
16784 =head2 SelfLoader - load functions only on demand
16785
16786 =over 4
16787
16788 =item SYNOPSIS
16789
16790 =item DESCRIPTION
16791
16792 =over 4
16793
16794 =item The __DATA__ token
16795
16796 =item SelfLoader autoloading
16797
16798 =item Autoloading and package lexicals
16799
16800 =item SelfLoader and AutoLoader
16801
16802 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
16803
16804 =item Classes and inherited methods.
16805
16806 =back
16807
16808 =item Multiple packages and fully qualified subroutine names
16809
16810 =back
16811
16812 =head2 Shell - run shell commands transparently within perl
16813
16814 =over 4
16815
16816 =item SYNOPSIS
16817
16818 =item DESCRIPTION
16819
16820 =over 4
16821
16822 =item OBJECT ORIENTED SYNTAX
16823
16824 =back
16825
16826 =item AUTHOR
16827
16828 =back
16829
16830 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
16831 socket.h defines and structure manipulators 
16832
16833 =over 4
16834
16835 =item SYNOPSIS
16836
16837 =item DESCRIPTION
16838
16839 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
16840 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
16841 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
16842 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
16843 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
16844
16845 =back
16846
16847 =head2 Storable - persistency for perl data structures
16848
16849 =over 4
16850
16851 =item SYNOPSIS
16852
16853 =item DESCRIPTION
16854
16855 =item MEMORY STORE
16856
16857 =item ADVISORY LOCKING
16858
16859 =item SPEED
16860
16861 =item CANONICAL REPRESENTATION
16862
16863 =item ERROR REPORTING
16864
16865 =item WIZARDS ONLY
16866
16867 =over 4
16868
16869 =item Hooks
16870
16871 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
16872 I<serialized>, ..
16873
16874 =item Predicates
16875
16876 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
16877 C<Storable::is_retrieving>
16878
16879 =item Recursion
16880
16881 =item Deep Cloning
16882
16883 =back
16884
16885 =item Storable magic
16886
16887 =item EXAMPLES
16888
16889 =item WARNING
16890
16891 =item BUGS
16892
16893 =item CREDITS
16894
16895 =item TRANSLATIONS
16896
16897 =item AUTHOR
16898
16899 =item SEE ALSO
16900
16901 =back
16902
16903 =head2 Switch - A switch statement for Perl
16904
16905 =over 4
16906
16907 =item VERSION
16908
16909 =item SYNOPSIS
16910
16911 =item BACKGROUND
16912
16913 =item DESCRIPTION
16914
16915 =over 4
16916
16917 =item Allowing fall-through
16918
16919 =item Automating fall-through
16920
16921 =item Alternative syntax
16922
16923 =item Higher-order Operations
16924
16925 =back
16926
16927 =item DEPENDENCIES
16928
16929 =item AUTHOR
16930
16931 =item BUGS
16932
16933 =item LIMITATION
16934
16935 =item COPYRIGHT
16936
16937 =back
16938
16939 =head2 Symbol - manipulate Perl symbols and their names
16940
16941 =over 4
16942
16943 =item SYNOPSIS
16944
16945 =item DESCRIPTION
16946
16947 =back
16948
16949 =head2 Sys::Hostname - Try every conceivable way to get hostname
16950
16951 =over 4
16952
16953 =item SYNOPSIS
16954
16955 =item DESCRIPTION
16956
16957 =item AUTHOR
16958
16959 =back
16960
16961 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
16962 interface to the UNIX syslog(3) calls
16963
16964 =over 4
16965
16966 =item SYNOPSIS
16967
16968 =item DESCRIPTION
16969
16970 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
16971 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
16972 closelog
16973
16974 =item EXAMPLES
16975
16976 =item SEE ALSO
16977
16978 =item AUTHOR
16979
16980 =back
16981
16982 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
16983 Perl interface to the UNIX syslog(3) calls
16984
16985 =over 4
16986
16987 =item SYNOPSIS
16988
16989 =item DESCRIPTION
16990
16991 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
16992 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
16993 closelog
16994
16995 =item EXAMPLES
16996
16997 =item SEE ALSO
16998
16999 =item AUTHOR
17000
17001 =back
17002
17003 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
17004
17005 =over 4
17006
17007 =item SYNOPSIS
17008
17009 =item DESCRIPTION
17010
17011 =item DIAGNOSTICS
17012
17013 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
17014 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
17015 comma allowed after filehandle, No name for escape sequence %s
17016
17017 =item ENVIRONMENT
17018
17019 ANSI_COLORS_DISABLED
17020
17021 =item RESTRICTIONS
17022
17023 =item NOTES
17024
17025 =item SEE ALSO
17026
17027 =item AUTHORS
17028
17029 =item LICENSE
17030
17031 =back
17032
17033 =head2 Term::Cap - Perl termcap interface
17034
17035 =over 4
17036
17037 =item SYNOPSIS
17038
17039 =item DESCRIPTION
17040
17041 =over 4
17042
17043 =item METHODS
17044
17045 =back
17046
17047 =back
17048
17049 B<Tgetent>, OSPEED, TERM
17050
17051 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
17052
17053 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
17054
17055 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
17056
17057 B<Trequire>
17058
17059 =over 4
17060
17061 =item EXAMPLES
17062
17063 =item COPYRIGHT AND LICENSE
17064
17065 =item AUTHOR
17066
17067 =item SEE ALSO
17068
17069 =back
17070
17071 =head2 Term::Complete - Perl word completion module
17072
17073 =over 4
17074
17075 =item SYNOPSIS
17076
17077 =item DESCRIPTION
17078
17079 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
17080
17081 =item DIAGNOSTICS
17082
17083 =item BUGS
17084
17085 =item AUTHOR
17086
17087 =back
17088
17089 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
17090 no real package is found, substitutes stubs instead of basic functions.
17091
17092 =over 4
17093
17094 =item SYNOPSIS
17095
17096 =item DESCRIPTION
17097
17098 =item Minimal set of supported functions
17099
17100 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
17101 C<MinLine>, C<findConsole>, Attribs, C<Features>
17102
17103 =item Additional supported functions
17104
17105 C<tkRunning>, C<ornaments>, C<newTTY>
17106
17107 =item EXPORTS
17108
17109 =item ENVIRONMENT
17110
17111 =item CAVEATS
17112
17113 =back
17114
17115 =head2 Test - provides a simple framework for writing test scripts
17116
17117 =over 4
17118
17119 =item SYNOPSIS
17120
17121 =item DESCRIPTION
17122
17123 =over 4
17124
17125 =item Functions
17126
17127 B<plan>
17128
17129 =back
17130
17131 =back
17132
17133 B<_to_value>
17134
17135 B<ok>
17136
17137 =over 4
17138
17139 =item TEST TYPES
17140
17141 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
17142
17143 =item ONFAIL
17144
17145 =item BUGS and CAVEATS
17146
17147 =item TODO
17148
17149 =item SEE ALSO
17150
17151 =item AUTHOR
17152
17153 =back
17154
17155 =head2 Test::Builder - Backend for building test libraries
17156
17157 =over 4
17158
17159 =item SYNOPSIS
17160
17161 =item DESCRIPTION
17162
17163 =over 4
17164
17165 =item Construction
17166
17167 B<new>
17168
17169 =back
17170
17171 =back
17172
17173 =over 4
17174
17175 =item Setting up tests
17176
17177 B<exported_to>
17178
17179 =back
17180
17181 B<plan>
17182
17183 B<expected_tests>
17184
17185 B<no_plan>
17186
17187 B<skip_all>
17188
17189 =over 4
17190
17191 =item Running tests
17192
17193 B<ok>
17194
17195 =back
17196
17197 B<is_eq>, B<is_num>
17198
17199 B<isnt_eq>, B<isnt_num>
17200
17201 B<like>, B<unlike>
17202
17203 B<cmp_ok>
17204
17205 B<BAILOUT>
17206
17207 B<skip>
17208
17209 B<todo_skip>
17210
17211 B<skip_rest>
17212
17213 =over 4
17214
17215 =item Test style
17216
17217 B<level>
17218
17219 =back
17220
17221 B<use_numbers>
17222
17223 B<no_header>, B<no_ending>
17224
17225 =over 4
17226
17227 =item Output
17228
17229 B<diag>
17230
17231 =back
17232
17233 B<_print>
17234
17235 B<output>, B<failure_output>, B<todo_output>
17236
17237 =over 4
17238
17239 =item Test Status and Info
17240
17241 B<current_test>
17242
17243 =back
17244
17245 B<summary>
17246
17247 B<details>  I<UNIMPLEMENTED>, B<todo>
17248
17249 B<caller>
17250
17251 B<_sanity_check>
17252
17253 B<_whoa>
17254
17255 B<_my_exit>
17256
17257 =over 4
17258
17259 =item EXAMPLES
17260
17261 =item SEE ALSO
17262
17263 =item AUTHORS
17264
17265 =item COPYRIGHT
17266
17267 =back
17268
17269 =head2 Test::Harness - run perl standard test scripts with statistics
17270
17271 =over 4
17272
17273 =item SYNOPSIS
17274
17275 =item DESCRIPTION
17276
17277 =over 4
17278
17279 =item The test script output
17280
17281 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
17282 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
17283 else>
17284
17285 =item Taint mode
17286
17287 =item Configuration variables.
17288
17289 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
17290
17291 =item Failure
17292
17293 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
17294 Failed>
17295
17296 =item Functions
17297
17298 B<runtests>
17299
17300 =back
17301
17302 =back
17303
17304 B<_all_ok>
17305
17306 B<_globdir>
17307
17308 B<_run_all_tests>
17309
17310 B<_mk_leader>
17311
17312 B<_leader_width>
17313
17314 =over 4
17315
17316 =item EXPORT
17317
17318 =item DIAGNOSTICS
17319
17320 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
17321 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
17322 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
17323 %s>, C<FAILED--Further testing stopped%s>
17324
17325 =item ENVIRONMENT
17326
17327 C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
17328 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
17329 C<HARNESS_ACTIVE>
17330
17331 =item EXAMPLE
17332
17333 =item SEE ALSO
17334
17335 =item AUTHORS
17336
17337 =item TODO
17338
17339 =item BUGS
17340
17341 =back
17342
17343 =head2 Test::Harness::Assert - simple assert
17344
17345 =over 4
17346
17347 =item SYNOPSIS
17348
17349 =item DESCRIPTION
17350
17351 =over 4
17352
17353 =item Functions
17354
17355 B<assert>
17356
17357 =back
17358
17359 =back
17360
17361 =over 4
17362
17363 =item AUTHOR
17364
17365 =item SEE ALSO
17366
17367 =back
17368
17369 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
17370
17371 =over 4
17372
17373 =item SYNOPSIS
17374
17375 =item DESCRIPTION
17376
17377 =back
17378
17379 =head2 Test::Harness::Straps - detailed analysis of test results
17380
17381 =over 4
17382
17383 =item SYNOPSIS
17384
17385 =item DESCRIPTION
17386
17387 =over 4
17388
17389 =item Construction
17390
17391 B<new>
17392
17393 =back
17394
17395 =back
17396
17397 B<_init>
17398
17399 =over 4
17400
17401 =item Analysis
17402
17403 B<analyze>
17404
17405 =back
17406
17407 B<analyze_fh>
17408
17409 B<analyze_file>
17410
17411 B<_switches>
17412
17413 B<_INC2PERL5LIB>
17414
17415 B<_filtered_INC>
17416
17417 B<_restore_PERL5LIB>
17418
17419 =over 4
17420
17421 =item Parsing
17422
17423 B<_is_comment>
17424
17425 =back
17426
17427 B<_is_header>
17428
17429 B<_is_test>
17430
17431 B<_is_bail_out>
17432
17433 B<_reset_file_state>
17434
17435 =over 4
17436
17437 =item Results
17438
17439 B<_detailize>
17440
17441 =back
17442
17443 =over 4
17444
17445 =item EXAMPLES
17446
17447 =item AUTHOR
17448
17449 =item SEE ALSO
17450
17451 =back
17452
17453 =head2 Test::More - yet another framework for writing test scripts
17454
17455 =over 4
17456
17457 =item SYNOPSIS
17458
17459 =item DESCRIPTION
17460
17461 =over 4
17462
17463 =item I love it when a plan comes together
17464
17465 =back
17466
17467 =back
17468
17469 =over 4
17470
17471 =item Test names
17472
17473 =item I'm ok, you're not ok.
17474
17475 B<ok>
17476
17477 =back
17478
17479 B<is>, B<isnt>
17480
17481 B<like>
17482
17483 B<unlike>
17484
17485 B<cmp_ok>
17486
17487 B<can_ok>
17488
17489 B<isa_ok>
17490
17491 B<pass>, B<fail>
17492
17493 =over 4
17494
17495 =item Diagnostics
17496
17497 B<diag>
17498
17499 =back
17500
17501 =over 4
17502
17503 =item Module tests
17504
17505 B<use_ok>
17506
17507 =back
17508
17509 B<require_ok>
17510
17511 =over 4
17512
17513 =item Conditional tests
17514
17515 B<SKIP: BLOCK>
17516
17517 =back
17518
17519 B<TODO: BLOCK>, B<todo_skip>
17520
17521 =over 4
17522
17523 =item Comparison functions
17524
17525 B<is_deeply>
17526
17527 =back
17528
17529 B<eq_array>
17530
17531 B<eq_hash>
17532
17533 B<eq_set>
17534
17535 =over 4
17536
17537 =item Extending and Embedding Test::More
17538
17539 B<builder>
17540
17541 =back
17542
17543 =over 4
17544
17545 =item NOTES
17546
17547 =item BUGS and CAVEATS
17548
17549 Making your own ok(), The eq_* family has some caveats, Test::Harness
17550 upgrades
17551
17552 =item HISTORY
17553
17554 =item SEE ALSO
17555
17556 =item AUTHORS
17557
17558 =item COPYRIGHT
17559
17560 =back
17561
17562 =head2 Test::Simple - Basic utilities for writing tests.
17563
17564 =over 4
17565
17566 =item SYNOPSIS
17567
17568 =item DESCRIPTION
17569
17570 B<ok>
17571
17572 =back
17573
17574 =over 4
17575
17576 =item EXAMPLE
17577
17578 =item CAVEATS
17579
17580 =item NOTES
17581
17582 =item HISTORY
17583
17584 =item SEE ALSO
17585
17586 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
17587 L<Test::Harness>
17588
17589 =item AUTHORS
17590
17591 =item COPYRIGHT
17592
17593 =back
17594
17595 =head2 Test::Tutorial - A tutorial about writing really basic tests
17596
17597 =over 4
17598
17599 =item DESCRIPTION
17600
17601 =over 4
17602
17603 =item Nuts and bolts of testing.
17604
17605 =item Where to start?
17606
17607 =item Names
17608
17609 =item Test the manual
17610
17611 =item Sometimes the tests are wrong
17612
17613 =item Testing lots of values
17614
17615 =item Informative names
17616
17617 =item Skipping tests
17618
17619 =item Todo tests
17620
17621 =item Testing with taint mode.
17622
17623 =back
17624
17625 =item FOOTNOTES
17626
17627 =item AUTHORS
17628
17629 =item COPYRIGHT
17630
17631 =back
17632
17633 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
17634
17635 =over 4
17636
17637 =item SYNOPSIS
17638
17639 =item DESCRIPTION
17640
17641 =item EXAMPLE
17642
17643 =back
17644
17645 =head2 Text::Balanced - Extract delimited text sequences from strings.
17646
17647 =over 4
17648
17649 =item SYNOPSIS
17650
17651 =item DESCRIPTION
17652
17653 =over 4
17654
17655 =item General behaviour in list contexts
17656
17657 [0], [1], [2]
17658
17659 =item General behaviour in scalar and void contexts
17660
17661 =item A note about prefixes
17662
17663 =item C<extract_delimited>
17664
17665 =item C<extract_bracketed>
17666
17667 =item C<extract_tagged>
17668
17669 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
17670 [0], [1], [2], [3], [4], [5]
17671
17672 =item C<gen_extract_tagged>
17673
17674 =item C<extract_quotelike>
17675
17676 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
17677
17678 =item C<extract_quotelike> and "here documents"
17679
17680 [0], [1], [2], [3], [4], [5], [6], [7..10]
17681
17682 =item C<extract_codeblock>
17683
17684 =item C<extract_multiple>
17685
17686 =item C<gen_delimited_pat>
17687
17688 =back
17689
17690 =item DIAGNOSTICS
17691
17692  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
17693 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
17694 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
17695 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
17696 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
17697 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
17698 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
17699 after dereferencer>, C<Did not find expected opening bracket at %s>,
17700 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
17701 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
17702 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
17703 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
17704 tag>
17705
17706 =item AUTHOR
17707
17708 =item BUGS AND IRRITATIONS
17709
17710 =item COPYRIGHT
17711
17712 =back
17713
17714 =head2 Text::ParseWords - parse text into an array of tokens or array of
17715 arrays
17716
17717 =over 4
17718
17719 =item SYNOPSIS
17720
17721 =item DESCRIPTION
17722
17723 =item EXAMPLES
17724
17725 =item AUTHORS
17726
17727 =back
17728
17729 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
17730 by Knuth
17731
17732 =over 4
17733
17734 =item SYNOPSIS
17735
17736 =item DESCRIPTION
17737
17738 =item EXAMPLES
17739
17740 =item LIMITATIONS
17741
17742 =item AUTHOR
17743
17744 =back
17745
17746 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
17747 unexpand(1)
17748
17749 =over 4
17750
17751 =item SYNOPSIS
17752
17753 =item DESCRIPTION
17754
17755 =item BUGS
17756
17757 =item AUTHOR
17758
17759 =back
17760
17761 =head2 Text::Wrap - line wrapping to form simple paragraphs
17762
17763 =over 4
17764
17765 =item SYNOPSIS 
17766
17767 =item DESCRIPTION
17768
17769 =item OVERRIDES
17770
17771 =item EXAMPLE
17772
17773 =item AUTHOR
17774
17775 =back
17776
17777 =head2 Thread - manipulate threads in Perl
17778
17779 =over 4
17780
17781 =item CAVEAT
17782
17783 =item SYNOPSIS
17784
17785 =item DESCRIPTION
17786
17787 =item FUNCTIONS
17788
17789 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
17790 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
17791 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
17792
17793 =item METHODS
17794
17795 join, eval, detach, equal, tid, flags, done
17796
17797 =item LIMITATIONS
17798
17799 =item SEE ALSO
17800
17801 =back
17802
17803 =head2 Thread::Queue - thread-safe queues
17804
17805 =over 4
17806
17807 =item SYNOPSIS
17808
17809 =item DESCRIPTION
17810
17811 =item FUNCTIONS AND METHODS
17812
17813 new, enqueue LIST, dequeue, dequeue_nb, pending
17814
17815 =item SEE ALSO
17816
17817 =back
17818
17819 =head2 Thread::Semaphore - thread-safe semaphores
17820
17821 =over 4
17822
17823 =item SYNOPSIS
17824
17825 =item DESCRIPTION
17826
17827 =item FUNCTIONS AND METHODS
17828
17829 new, new NUMBER, down, down NUMBER, up, up NUMBER
17830
17831 =back
17832
17833 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
17834
17835 =over 4
17836
17837 =item SYNOPSIS
17838
17839 =item DESCRIPTION
17840
17841 =item BUGS
17842
17843 =back
17844
17845 =head2 Thread::Specific - thread-specific keys
17846
17847 =over 4
17848
17849 =item SYNOPSIS
17850
17851 =item DESCRIPTION
17852
17853 =back
17854
17855 =head2 Tie::Array - base class for tied arrays
17856
17857 =over 4
17858
17859 =item SYNOPSIS
17860
17861 =item DESCRIPTION
17862
17863 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
17864 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
17865 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
17866 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
17867
17868 =item CAVEATS
17869
17870 =item AUTHOR
17871
17872 =back
17873
17874 =head2 Tie::File - Access the lines of a disk file via a Perl array
17875
17876 =over 4
17877
17878 =item SYNOPSIS
17879
17880 =item DESCRIPTION
17881
17882 =over 4
17883
17884 =item C<recsep>
17885
17886 =item C<mode>
17887
17888 =item C<cachesize>
17889
17890 =item Option Format
17891
17892 =back
17893
17894 =item Public Methods
17895
17896 =over 4
17897
17898 =item C<flock>
17899
17900 =item Tying to an already-opened filehandle
17901
17902 =back
17903
17904 =item CAVEATS
17905
17906 =over 4
17907
17908 =item Efficiency Note
17909
17910 =item Efficiency Note 2
17911
17912 =item Efficiency Note 3
17913
17914 =back
17915
17916 =item CAVEATS
17917
17918 =item AUTHOR
17919
17920 =item LICENSE
17921
17922 =item WARRANTY
17923
17924 =item THANKS
17925
17926 =item TODO
17927
17928 =back
17929
17930 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
17931 handles
17932
17933 =over 4
17934
17935 =item SYNOPSIS
17936
17937 =item DESCRIPTION
17938
17939 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
17940 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
17941 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
17942 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
17943
17944 =item MORE INFORMATION
17945
17946 =item COMPATIBILITY
17947
17948 =back
17949
17950 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
17951 tied hashes
17952
17953 =over 4
17954
17955 =item SYNOPSIS
17956
17957 =item DESCRIPTION
17958
17959 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
17960 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
17961
17962 =item Inheriting from B<Tie::StdHash>
17963
17964 =item Inheriting from B<Tie::ExtraHash>
17965
17966 =item C<UNTIE> and C<DESTROY>
17967
17968 =item MORE INFORMATION
17969
17970 =back
17971
17972 =head2 Tie::Memoize - add data to hash when needed
17973
17974 =over 4
17975
17976 =item SYNOPSIS
17977
17978 =item DESCRIPTION
17979
17980 =item Inheriting from B<Tie::Memoize>
17981
17982 =item EXAMPLE
17983
17984 =item BUGS
17985
17986 =item AUTHOR
17987
17988 =back
17989
17990 =head2 Tie::RefHash - use references as hash keys
17991
17992 =over 4
17993
17994 =item SYNOPSIS
17995
17996 =item DESCRIPTION
17997
17998 =item EXAMPLE
17999
18000 =item AUTHOR
18001
18002 =item VERSION
18003
18004 =item SEE ALSO
18005
18006 =back
18007
18008 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
18009 scalars
18010
18011 =over 4
18012
18013 =item SYNOPSIS
18014
18015 =item DESCRIPTION
18016
18017 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
18018
18019 =item MORE INFORMATION
18020
18021 =back
18022
18023 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
18024
18025 =over 4
18026
18027 =item SYNOPSIS
18028
18029 =item DESCRIPTION
18030
18031 =item CAVEATS
18032
18033 =back
18034
18035 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
18036 timers
18037
18038 =over 4
18039
18040 =item SYNOPSIS
18041
18042 =item DESCRIPTION
18043
18044 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
18045 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
18046 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
18047 getitimer ( $which )
18048
18049 =item EXAMPLES
18050
18051 =item C API
18052
18053 =item CAVEATS
18054
18055 =item AUTHORS
18056
18057 =item REVISION
18058
18059 =item COPYRIGHT
18060
18061 =back
18062
18063 =head2 Time::Local - efficiently compute time from local and GMT time
18064
18065 =over 4
18066
18067 =item SYNOPSIS
18068
18069 =item DESCRIPTION
18070
18071 =item IMPLEMENTATION
18072
18073 =item BUGS
18074
18075 =back
18076
18077 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
18078 function
18079
18080 =over 4
18081
18082 =item SYNOPSIS
18083
18084 =item DESCRIPTION
18085
18086 =item NOTE
18087
18088 =item AUTHOR
18089
18090 =back
18091
18092 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
18093 function
18094
18095 =over 4
18096
18097 =item SYNOPSIS
18098
18099 =item DESCRIPTION
18100
18101 =item NOTE
18102
18103 =item AUTHOR
18104
18105 =back
18106
18107 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
18108
18109 =over 4
18110
18111 =item SYNOPSIS
18112
18113 =item DESCRIPTION
18114
18115 =item AUTHOR
18116
18117 =back
18118
18119 =head2 UNIVERSAL - base class for ALL classes (blessed references)
18120
18121 =over 4
18122
18123 =item SYNOPSIS
18124
18125 =item DESCRIPTION
18126
18127 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
18128 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
18129
18130 =back
18131
18132 =head2 Unicode::Collate - use UCA (Unicode Collation Algorithm)
18133
18134 =over 4
18135
18136 =item SYNOPSIS
18137
18138 =item DESCRIPTION
18139
18140 =over 4
18141
18142 =item Constructor and Tailoring
18143
18144 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
18145 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
18146 undefChar, katakana_before_hiragana, upper_before_lower
18147
18148 =item Other methods
18149
18150 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
18151 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
18152 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
18153 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
18154 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
18155 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$position =
18156 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
18157 $Collator-E<gt>index($string, $substring)>
18158
18159 =item EXPORT
18160
18161 =item TODO
18162
18163 =item CAVEAT
18164
18165 =back
18166
18167 =item AUTHOR
18168
18169 =item SEE ALSO
18170
18171 Unicode Collation Algorithm - Unicode TR #10, L<Unicode::Normalize>
18172
18173 =back
18174
18175 =head2 Unicode::Normalize - normalized forms of Unicode text
18176
18177 =over 4
18178
18179 =item SYNOPSIS
18180
18181 =item DESCRIPTION
18182
18183 =over 4
18184
18185 =item Normalization Forms
18186
18187 C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>,
18188 C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>,
18189 C<$normalized_string = normalize($form_name, $raw_string)>
18190
18191 =item Character Data
18192
18193 C<$canonical_decomposed = getCanon($codepoint)>,
18194 C<$compatibility_decomposed = getCompat($codepoint)>, C<$uv_composite =
18195 getComposite($uv_here, $uv_next)>, C<$combining_class =
18196 getCombinClass($codepoint)>, C<$is_exclusion = isExclusion($codepoint)>
18197
18198 =item EXPORT
18199
18200 =item TODO
18201
18202 =back
18203
18204 =item AUTHOR
18205
18206 =item SEE ALSO
18207
18208 http://www.unicode.org/unicode/reports/tr15/
18209
18210 =back
18211
18212 =head2 Unicode::UCD - Unicode character database
18213
18214 =over 4
18215
18216 =item SYNOPSIS
18217
18218 =item DESCRIPTION
18219
18220 =back
18221
18222 =over 4
18223
18224 =item charinfo
18225
18226 =back
18227
18228 =over 4
18229
18230 =item charblock
18231
18232 =back
18233
18234 =over 4
18235
18236 =item charscript
18237
18238 =back
18239
18240 =over 4
18241
18242 =item charblocks
18243
18244 =back
18245
18246 =over 4
18247
18248 =item charscripts
18249
18250 =back
18251
18252 =over 4
18253
18254 =item Blocks versus Scripts
18255
18256 =item Matching Scripts and Blocks
18257
18258 =item Code Point Arguments
18259
18260 =item charinrange
18261
18262 =back
18263
18264 =over 4
18265
18266 =item compexcl
18267
18268 =back
18269
18270 =over 4
18271
18272 =item casefold
18273
18274 =back
18275
18276 =over 4
18277
18278 =item casespec
18279
18280 =back
18281
18282 =over 4
18283
18284 =item Unicode::UCD::UnicodeVersion
18285
18286 =back
18287
18288 =over 4
18289
18290 =item Implementation Note
18291
18292 =back
18293
18294 =over 4
18295
18296 =item BUGS
18297
18298 =item AUTHOR
18299
18300 =back
18301
18302 =head2 User::grent - by-name interface to Perl's built-in getgr*()
18303 functions
18304
18305 =over 4
18306
18307 =item SYNOPSIS
18308
18309 =item DESCRIPTION
18310
18311 =item NOTE
18312
18313 =item AUTHOR
18314
18315 =back
18316
18317 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
18318 functions
18319
18320 =over 4
18321
18322 =item SYNOPSIS
18323
18324 =item DESCRIPTION
18325
18326 =over 4
18327
18328 =item System Specifics
18329
18330 =back
18331
18332 =item NOTE
18333
18334 =item AUTHOR
18335
18336 =item HISTORY
18337
18338 March 18th, 2000
18339
18340 =back
18341
18342 =head2 Win32 - Interfaces to some Win32 API Functions
18343
18344 =over 4
18345
18346 =item DESCRIPTION
18347
18348 =over 4
18349
18350 =item Alphabetical Listing of Win32 Functions
18351
18352 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
18353 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
18354 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
18355 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
18356 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
18357 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
18358 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
18359 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
18360 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
18361 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
18362 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
18363 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
18364 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
18365 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
18366 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
18367 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
18368 Win32::UnregisterServer(LIBRARYNAME)
18369
18370 =back
18371
18372 =back
18373
18374 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
18375
18376 =over 4
18377
18378 =item SYNOPSIS
18379
18380 =item DESCRIPTION
18381
18382 =back
18383
18384 =over 4
18385
18386 =item NOTES
18387
18388 =item AUTHOR
18389
18390 =back
18391
18392 =head2 XSLoader - Dynamically load C libraries into Perl code
18393
18394 =over 4
18395
18396 =item SYNOPSIS
18397
18398 =item DESCRIPTION
18399
18400 =item AUTHOR
18401
18402 =back
18403
18404 =head1 AUXILIARY DOCUMENTATION
18405
18406 Here should be listed all the extra programs' documentation, but they
18407 don't all have manual pages yet:
18408
18409 =over 4
18410
18411 =item a2p
18412
18413 =item s2p
18414
18415 =item find2perl
18416
18417 =item h2ph
18418
18419 =item c2ph
18420
18421 =item h2xs
18422
18423 =item xsubpp
18424
18425 =item pod2man
18426
18427 =item wrapsuid
18428
18429 =back
18430
18431 =head1 AUTHOR
18432
18433 Larry Wall <F<larry@wall.org>>, with the help of oodles
18434 of other folks.
18435