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