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