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