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