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