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 perldos - Perl under DOS, W31, W95.
5676
5677 =over 4
5678
5679 =item SYNOPSIS
5680
5681 =item DESCRIPTION
5682
5683 =over 4
5684
5685 =item Prerequisites
5686
5687 DJGPP, Pthreads
5688
5689 =item Shortcomings of Perl under DOS
5690
5691 =item Building
5692
5693 =item Testing
5694
5695 =item Installation
5696
5697 =back
5698
5699 =item BUILDING AND INSTALLING MODULES
5700
5701 =over 4
5702
5703 =item Prerequisites
5704
5705 =item Unpacking CPAN Modules
5706
5707 =item Building Non-XS Modules
5708
5709 =item Building XS Modules
5710
5711 =back
5712
5713 =item AUTHOR
5714
5715 =item SEE ALSO
5716
5717 =back
5718
5719 =head2 perlepoc, README.epoc - Perl for EPOC
5720
5721 =over 4
5722
5723 =item SYNOPSIS
5724
5725 =item INTRODUCTION
5726
5727 =item INSTALLING PERL ON EPOC
5728
5729 =item STARTING PERL ON EPOC
5730
5731 =item STOPPING PERL ON EPOC
5732
5733 =item USING PERL ON EPOC
5734
5735 =over 4
5736
5737 =item I/O Redirection
5738
5739 =item PATH Names
5740
5741 =item Editors
5742
5743 =item Features
5744
5745 =item Restrictions
5746
5747 =item Compiling Perl 5 on the EPOC cross compiling environment
5748
5749 =back
5750
5751 =item SUPPORT STATUS
5752
5753 =item AUTHOR
5754
5755 =item LAST UPDATE
5756
5757 =back
5758
5759 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
5760 (HP-UX) systems
5761
5762 =over 4
5763
5764 =item DESCRIPTION
5765
5766 =over 4
5767
5768 =item Compiling Perl 5 on HP-UX
5769
5770 =item PA-RISC
5771
5772 =item PA-RISC 1.0
5773
5774 =item PA-RISC 1.1
5775
5776 =item PA-RISC 2.0
5777
5778 =item Portability Between PA-RISC Versions
5779
5780 =item Building Dynamic Extensions on HP-UX
5781
5782 =item The HP ANSI C Compiler
5783
5784 =item Using Large Files with Perl
5785
5786 =item Threaded Perl
5787
5788 =item 64-bit Perl
5789
5790 =item GDBM and Threads
5791
5792 =item NFS filesystems and utime(2)
5793
5794 =item perl -P and //
5795
5796 =back
5797
5798 =item AUTHOR
5799
5800 =item DATE
5801
5802 =back
5803
5804 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
5805 systems
5806
5807 =over 4
5808
5809 =item DESCRIPTION
5810
5811 =over 4
5812
5813 =item Compiling Perl 5 on MachTen
5814
5815 =item Failures during C<make test>
5816
5817 op/lexassign.t, pragma/warnings.t
5818
5819 =item Building external modules
5820
5821 =back
5822
5823 =item AUTHOR
5824
5825 =item DATE
5826
5827 =back
5828
5829 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
5830
5831 =over 4
5832
5833 =item SYNOPSIS
5834
5835 =item DESCRIPTION
5836
5837 =item AUTHOR
5838
5839 =item DATE
5840
5841 =back
5842
5843 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
5844
5845 =head1 SYNOPSIS
5846
5847 =over 4
5848
5849 =item What's New
5850
5851 =item System Requirements
5852
5853 =item How to Obtain Perl/iX
5854
5855 =item Distribution Contents Highlights
5856
5857 README, public_html/feedback.cgi,  4,  6
5858
5859 =item Getting Started with Perl/iX
5860
5861 =item MPE/iX Implementation Considerations
5862
5863 =item Change History
5864
5865 =back
5866
5867 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
5868
5869 =over 4
5870
5871 =item SYNOPSIS
5872
5873 =back
5874
5875 =over 4
5876
5877 =item DESCRIPTION
5878
5879 =over 4
5880
5881 =item Target
5882
5883 =item Other OSes
5884
5885 =item Prerequisites
5886
5887 EMX, RSX, HPFS, pdksh
5888
5889 =item Starting Perl programs under OS/2 (and DOS and...)
5890
5891 =item Starting OS/2 (and DOS) programs under Perl
5892
5893 =back
5894
5895 =item Frequently asked questions
5896
5897 =over 4
5898
5899 =item "It does not work"
5900
5901 =item I cannot run external programs
5902
5903 =item I cannot embed perl into my program, or use F<perl.dll> from my
5904 program.
5905
5906 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
5907 L<ExtUtils::Embed>?
5908
5909 =item C<``> and pipe-C<open> do not work under DOS.
5910
5911 =item Cannot start C<find.exe "pattern" file>
5912
5913 =back
5914
5915 =item INSTALLATION
5916
5917 =over 4
5918
5919 =item Automatic binary installation
5920
5921 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
5922
5923 =item Manual binary installation
5924
5925 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
5926 (statically linked), Executables for Perl utilities, Main Perl library,
5927 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
5928 and utilities, Manpages for Perl modules, Source for Perl documentation,
5929 Perl manual in F<.INF> format, Pdksh
5930
5931 =item B<Warning>
5932
5933 =back
5934
5935 =item Accessing documentation
5936
5937 =over 4
5938
5939 =item OS/2 F<.INF> file
5940
5941 =item Plain text
5942
5943 =item Manpages
5944
5945 =item HTML
5946
5947 =item GNU C<info> files
5948
5949 =item F<.PDF> files
5950
5951 =item C<LaTeX> docs
5952
5953 =back
5954
5955 =item BUILD
5956
5957 =over 4
5958
5959 =item The short story
5960
5961 =item Prerequisites
5962
5963 =item Getting perl source
5964
5965 =item Application of the patches
5966
5967 =item Hand-editing
5968
5969 =item Making
5970
5971 =item Testing
5972
5973 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
5974 F<op/stat.t>
5975
5976 =item Installing the built perl
5977
5978 =item C<a.out>-style build
5979
5980 =back
5981
5982 =item Build FAQ
5983
5984 =over 4
5985
5986 =item Some C</> became C<\> in pdksh.
5987
5988 =item C<'errno'> - unresolved external
5989
5990 =item Problems with tr or sed
5991
5992 =item Some problem (forget which ;-)
5993
5994 =item Library ... not found
5995
5996 =item Segfault in make
5997
5998 =item op/sprintf test failure
5999
6000 =back
6001
6002 =item Specific (mis)features of OS/2 port
6003
6004 =over 4
6005
6006 =item C<setpriority>, C<getpriority>
6007
6008 =item C<system()>
6009
6010 =item C<extproc> on the first line
6011
6012 =item Additional modules:
6013
6014 =item Prebuilt methods:
6015
6016 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
6017  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
6018 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
6019 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
6020 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
6021 C<Cwd::extLibpath_set( path [, type ] )>,
6022 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
6023 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
6024 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
6025 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
6026 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
6027
6028 =item Prebuilt variables:
6029
6030 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
6031
6032 =item Misfeatures
6033
6034 =item Modifications
6035
6036 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
6037 C<flock>
6038
6039 =item Identifying DLLs
6040
6041 =item Centralized management of resources
6042
6043 C<HAB>, C<HMQ>
6044
6045 =back
6046
6047 =item Perl flavors
6048
6049 =over 4
6050
6051 =item F<perl.exe>
6052
6053 =item F<perl_.exe>
6054
6055 =item F<perl__.exe>
6056
6057 =item F<perl___.exe>
6058
6059 =item Why strange names?
6060
6061 =item Why dynamic linking?
6062
6063 =item Why chimera build?
6064
6065 =back
6066
6067 =item ENVIRONMENT
6068
6069 =over 4
6070
6071 =item C<PERLLIB_PREFIX>
6072
6073 =item C<PERL_BADLANG>
6074
6075 =item C<PERL_BADFREE>
6076
6077 =item C<PERL_SH_DIR>
6078
6079 =item C<USE_PERL_FLOCK>
6080
6081 =item C<TMP> or C<TEMP>
6082
6083 =back
6084
6085 =item Evolution
6086
6087 =over 4
6088
6089 =item Priorities
6090
6091 =item DLL name mangling
6092
6093 =item Threading
6094
6095 =item Calls to external programs
6096
6097 =item Memory allocation
6098
6099 =item Threads
6100
6101 C<COND_WAIT>, F<os2.c>
6102
6103 =back
6104
6105 =back
6106
6107 =over 4
6108
6109 =item AUTHOR
6110
6111 =item SEE ALSO
6112
6113 =back
6114
6115 =head2 perlos390, README.os390 - building and installing Perl for OS/390.
6116
6117 =over 4
6118
6119 =item SYNOPSIS
6120
6121 =item DESCRIPTION
6122
6123 =over 4
6124
6125 =item Unpacking
6126
6127 =item Setup and utilities
6128
6129 =item Configure
6130
6131 =item Build, test, install
6132
6133 =item build anomalies
6134
6135 =item testing anomalies
6136
6137 =item installation anomalies
6138
6139 =item Usage Hints
6140
6141 =item Floating point anomalies
6142
6143 =item Modules and Extensions
6144
6145 =back
6146
6147 =item AUTHORS
6148
6149 =item SEE ALSO
6150
6151 =over 4
6152
6153 =item Mailing list
6154
6155 =back
6156
6157 =item HISTORY
6158
6159 =back
6160
6161 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
6162
6163 =over 4
6164
6165 =item DESCRIPTION
6166
6167 =over 4
6168
6169 =item Solaris Version Numbers.
6170
6171 =back
6172
6173 =item RESOURCES
6174
6175 Solaris FAQ, Precompiled Binaries, Solaris Documentation
6176
6177 =item SETTING UP
6178
6179 =over 4
6180
6181 =item File Extraction Problems.
6182
6183 =item Compiler and Related Tools.
6184
6185 =item Environment
6186
6187 =back
6188
6189 =item RUN CONFIGURE.
6190
6191 =over 4
6192
6193 =item 64-bit Issues.
6194
6195 =item Threads.
6196
6197 =item Malloc Issues.
6198
6199 =back
6200
6201 =item MAKE PROBLEMS.
6202
6203 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
6204 relocation error:, dlopen: stub interception failed, #error "No
6205 DATAMODEL_NATIVE specified", sh: ar: not found
6206
6207 =item MAKE TEST
6208
6209 =over 4
6210
6211 =item op/stat.t test 4
6212
6213 =back
6214
6215 =item PREBUILT BINARIES.
6216
6217 =item RUNTIME ISSUES.
6218
6219 =over 4
6220
6221 =item Limits on Numbers of Open Files.
6222
6223 =back
6224
6225 =item SOLARIS-SPECIFIC MODULES.
6226
6227 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
6228
6229 =over 4
6230
6231 =item Proc::ProcessTable
6232
6233 =item BSD::Resource
6234
6235 =item Net::SSLeay
6236
6237 =back
6238
6239 =item AUTHOR
6240
6241 =item LAST MODIFIED
6242
6243 =back
6244
6245 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
6246
6247 =over 4
6248
6249 =item SYNOPSIS
6250
6251 =item DESCRIPTION
6252
6253 =over 4
6254
6255 =item Unpacking
6256
6257 =item Setup and utilities
6258
6259 =item Configure
6260
6261 Don't turn on the compiler optimization flag "-O".  There's a bug in the
6262 compiler (APAR PQ18812) that generates some bad code the optimizer is on,
6263 As VM/ESA doesn't fully support the fork() API programs relying on this
6264 call will not work. I've replaced fork()/exec() with spawn() and the
6265 standalone exec() with spawn(). This has a side effect when opening unnamed
6266 pipes in a shell script: there is no child process generated under
6267
6268 =item testing anomalies
6269
6270 =item Usage Hints
6271
6272 When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII
6273 character sets are different.  Perl builtin functions that may behave
6274 differently under EBCDIC are mentioned in the perlport.pod document.
6275
6276 =back
6277
6278 =item AUTHORS
6279
6280 =item SEE ALSO
6281
6282 =over 4
6283
6284 =item Mailing list
6285
6286 =back
6287
6288 =back
6289
6290 =head2 perlvms - VMS-specific documentation for Perl
6291
6292 =over 4
6293
6294 =item DESCRIPTION
6295
6296 =item Installation
6297
6298 =item Organization of Perl Images
6299
6300 =over 4
6301
6302 =item Core Images
6303
6304 =item Perl Extensions
6305
6306 =item Installing static extensions
6307
6308 =item Installing dynamic extensions
6309
6310 =back
6311
6312 =item File specifications
6313
6314 =over 4
6315
6316 =item Syntax
6317
6318 =item Wildcard expansion
6319
6320 =item Pipes
6321
6322 =back
6323
6324 =item PERL5LIB and PERLLIB
6325
6326 =item Command line
6327
6328 =over 4
6329
6330 =item I/O redirection and backgrounding
6331
6332 =item Command line switches
6333
6334 -i, -S, -u
6335
6336 =back
6337
6338 =item Perl functions
6339
6340 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
6341 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
6342 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
6343 LIST, waitpid PID,FLAGS
6344
6345 =item Perl variables
6346
6347 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $^S, $|
6348
6349 =item Standard modules with VMS-specific differences
6350
6351 =over 4
6352
6353 =item SDBM_File
6354
6355 =back
6356
6357 =item Revision date
6358
6359 =item AUTHOR
6360
6361 =back
6362
6363 =head2 perlvos, README.vos - Perl for Stratus VOS
6364
6365 =over 4
6366
6367 =item SYNOPSIS
6368
6369 =over 4
6370
6371 =item Stratus POSIX Support
6372
6373 =back
6374
6375 =item INSTALLING PERL IN VOS
6376
6377 =over 4
6378
6379 =item Compiling Perl 5 on VOS
6380
6381 =item Installing Perl 5 on VOS
6382
6383 =back
6384
6385 =item USING PERL IN VOS
6386
6387 =over 4
6388
6389 =item Unimplemented Features
6390
6391 =item Restrictions
6392
6393 =back
6394
6395 =item SUPPORT STATUS
6396
6397 =item AUTHOR
6398
6399 =item LAST UPDATE
6400
6401 =back
6402
6403 =head2 perlwin32 - Perl under Win32
6404
6405 =over 4
6406
6407 =item SYNOPSIS
6408
6409 =item DESCRIPTION
6410
6411 =over 4
6412
6413 =item Setting Up
6414
6415 Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
6416
6417 =item Building
6418
6419 =item Testing
6420
6421 =item Installation
6422
6423 =item Usage Hints
6424
6425 Environment Variables, File Globbing, Using perl from the command line,
6426 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
6427 Extensions, Running Perl Scripts, Miscellaneous Things
6428
6429 =back
6430
6431 =item BUGS AND CAVEATS
6432
6433 =item AUTHORS
6434
6435 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
6436 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
6437 E<lt>nick@ing-simmons.netE<gt>
6438
6439 =item SEE ALSO
6440
6441 =item HISTORY
6442
6443 =back
6444
6445 =head1 PRAGMA DOCUMENTATION
6446
6447 =head2 attrs - set/get attributes of a subroutine (deprecated)
6448
6449 =over 4
6450
6451 =item SYNOPSIS
6452
6453 =item DESCRIPTION
6454
6455 method, locked
6456
6457 =back
6458
6459 =head2 re - Perl pragma to alter regular expression behaviour
6460
6461 =over 4
6462
6463 =item SYNOPSIS
6464
6465 =item DESCRIPTION
6466
6467 =back
6468
6469 =head2 attributes - get/set subroutine or variable attributes
6470
6471 =over 4
6472
6473 =item SYNOPSIS
6474
6475 =item DESCRIPTION
6476
6477 =over 4
6478
6479 =item Built-in Attributes
6480
6481 locked, method, lvalue
6482
6483 =item Available Subroutines
6484
6485 get, reftype
6486
6487 =item Package-specific Attribute Handling
6488
6489 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
6490
6491 =item Syntax of Attribute Lists
6492
6493 =back
6494
6495 =item EXPORTS
6496
6497 =over 4
6498
6499 =item Default exports
6500
6501 =item Available exports
6502
6503 =item Export tags defined
6504
6505 =back
6506
6507 =item EXAMPLES
6508
6509 =item SEE ALSO
6510
6511 =back
6512
6513 =head2 attrs - set/get attributes of a subroutine (deprecated)
6514
6515 =over 4
6516
6517 =item SYNOPSIS
6518
6519 =item DESCRIPTION
6520
6521 method, locked
6522
6523 =back
6524
6525 =head2 autouse - postpone load of modules until a function is used
6526
6527 =over 4
6528
6529 =item SYNOPSIS
6530
6531 =item DESCRIPTION
6532
6533 =item WARNING
6534
6535 =item AUTHOR
6536
6537 =item SEE ALSO
6538
6539 =back
6540
6541 =head2 base - Establish IS-A relationship with base class at compile time
6542
6543 =over 4
6544
6545 =item SYNOPSIS
6546
6547 =item DESCRIPTION
6548
6549 =item HISTORY
6550
6551 =item SEE ALSO
6552
6553 =back
6554
6555 =head2 blib - Use MakeMaker's uninstalled version of a package
6556
6557 =over 4
6558
6559 =item SYNOPSIS
6560
6561 =item DESCRIPTION
6562
6563 =item BUGS
6564
6565 =item AUTHOR
6566
6567 =back
6568
6569 =head2 bytes - Perl pragma to force byte semantics rather than character
6570 semantics
6571
6572 =over 4
6573
6574 =item SYNOPSIS
6575
6576 =item DESCRIPTION
6577
6578 =item SEE ALSO
6579
6580 =back
6581
6582 =head2 charnames - define character names for C<\N{named}> string literal
6583 escape.
6584
6585 =over 4
6586
6587 =item SYNOPSIS
6588
6589 =item DESCRIPTION
6590
6591 =item CUSTOM TRANSLATORS
6592
6593 =item BUGS
6594
6595 =back
6596
6597 =head2 constant - Perl pragma to declare constants
6598
6599 =over 4
6600
6601 =item SYNOPSIS
6602
6603 =item DESCRIPTION
6604
6605 =item NOTES
6606
6607 =item TECHNICAL NOTE
6608
6609 =item BUGS
6610
6611 =item AUTHOR
6612
6613 =item COPYRIGHT
6614
6615 =back
6616
6617 =head2 diagnostics - Perl compiler pragma to force verbose warning
6618 diagnostics
6619
6620 =over 4
6621
6622 =item SYNOPSIS
6623
6624 =item DESCRIPTION
6625
6626 =over 4
6627
6628 =item The C<diagnostics> Pragma
6629
6630 =item The I<splain> Program
6631
6632 =back
6633
6634 =item EXAMPLES
6635
6636 =item INTERNALS
6637
6638 =item BUGS
6639
6640 =item AUTHOR
6641
6642 =back
6643
6644 =head2 fields - compile-time class fields
6645
6646 =over 4
6647
6648 =item SYNOPSIS
6649
6650 =item DESCRIPTION
6651
6652 new, phash
6653
6654 =item SEE ALSO
6655
6656 =back
6657
6658 =head2 filetest - Perl pragma to control the filetest permission operators
6659
6660 =over 4
6661
6662 =item SYNOPSIS
6663
6664 =item DESCRIPTION
6665
6666 =over 4
6667
6668 =item subpragma access
6669
6670 =back
6671
6672 =back
6673
6674 =head2 integer - Perl pragma to use integer arithmetic instead of floating
6675 point
6676
6677 =over 4
6678
6679 =item SYNOPSIS
6680
6681 =item DESCRIPTION
6682
6683 =back
6684
6685 =head2 less - perl pragma to request less of something from the compiler
6686
6687 =over 4
6688
6689 =item SYNOPSIS
6690
6691 =item DESCRIPTION
6692
6693 =back
6694
6695 =head2 lib - manipulate @INC at compile time
6696
6697 =over 4
6698
6699 =item SYNOPSIS
6700
6701 =item DESCRIPTION
6702
6703 =over 4
6704
6705 =item Adding directories to @INC
6706
6707 =item Deleting directories from @INC
6708
6709 =item Restoring original @INC
6710
6711 =back
6712
6713 =item SEE ALSO
6714
6715 =item AUTHOR
6716
6717 =back
6718
6719 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
6720 operations
6721
6722 =over 4
6723
6724 =item SYNOPSIS
6725
6726 =item DESCRIPTION
6727
6728 =back
6729
6730 =head2 open - perl pragma to set default disciplines for input and output
6731
6732 =over 4
6733
6734 =item SYNOPSIS
6735
6736 =item DESCRIPTION
6737
6738 =item NONPERLIO FUNCTIONALITY
6739
6740 =item IMPLEMENTATION DETAILS
6741
6742 =item SEE ALSO
6743
6744 =back
6745
6746 =head2 ops - Perl pragma to restrict unsafe operations when compiling
6747
6748 =over 4
6749
6750 =item SYNOPSIS
6751
6752 =item DESCRIPTION
6753
6754 =item SEE ALSO
6755
6756 =back
6757
6758 =head2 overload - Package for overloading perl operations
6759
6760 =over 4
6761
6762 =item SYNOPSIS
6763
6764 =item DESCRIPTION
6765
6766 =over 4
6767
6768 =item Declaration of overloaded functions
6769
6770 =item Calling Conventions for Binary Operations
6771
6772 FALSE, TRUE, C<undef>
6773
6774 =item Calling Conventions for Unary Operations
6775
6776 =item Calling Conventions for Mutators
6777
6778 C<++> and C<-->, C<x=> and other assignment versions
6779
6780 =item Overloadable Operations
6781
6782 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
6783 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
6784 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
6785
6786 =item Inheritance and overloading
6787
6788 Strings as values of C<use overload> directive, Overloading of an operation
6789 is inherited by derived classes
6790
6791 =back
6792
6793 =item SPECIAL SYMBOLS FOR C<use overload>
6794
6795 =over 4
6796
6797 =item Last Resort
6798
6799 =item Fallback
6800
6801 C<undef>, TRUE, defined, but FALSE
6802
6803 =item Copy Constructor
6804
6805 B<Example>
6806
6807 =back
6808
6809 =item MAGIC AUTOGENERATION
6810
6811 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
6812 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
6813 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
6814 I<Copy operator>
6815
6816 =item Losing overloading
6817
6818 =item Run-time Overloading
6819
6820 =item Public functions
6821
6822 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
6823
6824 =item Overloading constants
6825
6826 integer, float, binary, q, qr
6827
6828 =item IMPLEMENTATION
6829
6830 =item Metaphor clash
6831
6832 =item Cookbook
6833
6834 =over 4
6835
6836 =item Two-face scalars
6837
6838 =item Two-face references
6839
6840 =item Symbolic calculator
6841
6842 =item I<Really> symbolic calculator
6843
6844 =back
6845
6846 =item AUTHOR
6847
6848 =item DIAGNOSTICS
6849
6850 Odd number of arguments for overload::constant, `%s' is not an overloadable
6851 type, `%s' is not a code reference
6852
6853 =item BUGS
6854
6855 =back
6856
6857 =head2 re - Perl pragma to alter regular expression behaviour
6858
6859 =over 4
6860
6861 =item SYNOPSIS
6862
6863 =item DESCRIPTION
6864
6865 =back
6866
6867 =head2 sigtrap - Perl pragma to enable simple signal handling
6868
6869 =over 4
6870
6871 =item SYNOPSIS
6872
6873 =item DESCRIPTION
6874
6875 =item OPTIONS
6876
6877 =over 4
6878
6879 =item SIGNAL HANDLERS
6880
6881 B<stack-trace>, B<die>, B<handler> I<your-handler>
6882
6883 =item SIGNAL LISTS
6884
6885 B<normal-signals>, B<error-signals>, B<old-interface-signals>
6886
6887 =item OTHER
6888
6889 B<untrapped>, B<any>, I<signal>, I<number>
6890
6891 =back
6892
6893 =item EXAMPLES
6894
6895 =back
6896
6897 =head2 strict - Perl pragma to restrict unsafe constructs
6898
6899 =over 4
6900
6901 =item SYNOPSIS
6902
6903 =item DESCRIPTION
6904
6905 C<strict refs>, C<strict vars>, C<strict subs>
6906
6907 =back
6908
6909 =head2 subs - Perl pragma to predeclare sub names
6910
6911 =over 4
6912
6913 =item SYNOPSIS
6914
6915 =item DESCRIPTION
6916
6917 =back
6918
6919 =head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data
6920 and non-UTF data.
6921
6922 =over 4
6923
6924 =item SYNOPSIS
6925
6926 =item DESCRIPTION
6927
6928 =item SEE ALSO
6929
6930 =back
6931
6932 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
6933 code
6934
6935 =over 4
6936
6937 =item SYNOPSIS
6938
6939 =item DESCRIPTION
6940
6941 =over 4
6942
6943 =item Utility functions
6944
6945 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
6946 utf8::encode($string), $flag = utf8::decode($string)
6947
6948 =back
6949
6950 =item SEE ALSO
6951
6952 =back
6953
6954 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
6955
6956 =over 4
6957
6958 =item SYNOPSIS
6959
6960 =item DESCRIPTION
6961
6962 =back
6963
6964 =head2 warnings - Perl pragma to control optional warnings
6965
6966 =over 4
6967
6968 =item SYNOPSIS
6969
6970 =item DESCRIPTION
6971
6972 use warnings::register, warnings::enabled(), warnings::enabled($category),
6973 warnings::enabled($object), warnings::warn($message),
6974 warnings::warn($category, $message), warnings::warn($object, $message),
6975 warnings::warnif($message), warnings::warnif($category, $message),
6976 warnings::warnif($object, $message)
6977
6978 =back
6979
6980 =head2 warnings::register - warnings import function
6981
6982 =head1 MODULE DOCUMENTATION
6983
6984 =head2 AnyDBM_File - provide framework for multiple DBMs
6985
6986 =over 4
6987
6988 =item SYNOPSIS
6989
6990 =item DESCRIPTION
6991
6992 =over 4
6993
6994 =item DBM Comparisons
6995
6996 [0], [1], [2], [3]
6997
6998 =back
6999
7000 =item SEE ALSO
7001
7002 =back
7003
7004 =head2 AutoLoader - load subroutines only on demand
7005
7006 =over 4
7007
7008 =item SYNOPSIS
7009
7010 =item DESCRIPTION
7011
7012 =over 4
7013
7014 =item Subroutine Stubs
7015
7016 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
7017
7018 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
7019
7020 =item Package Lexicals
7021
7022 =item Not Using AutoLoader
7023
7024 =item B<AutoLoader> vs. B<SelfLoader>
7025
7026 =back
7027
7028 =item CAVEATS
7029
7030 =item SEE ALSO
7031
7032 =back
7033
7034 =head2 AutoSplit - split a package for autoloading
7035
7036 =over 4
7037
7038 =item SYNOPSIS
7039
7040 =item DESCRIPTION
7041
7042 $keep, $check, $modtime
7043
7044 =over 4
7045
7046 =item Multiple packages
7047
7048 =back
7049
7050 =item DIAGNOSTICS
7051
7052 =back
7053
7054 =head2 B - The Perl Compiler
7055
7056 =over 4
7057
7058 =item SYNOPSIS
7059
7060 =item DESCRIPTION
7061
7062 =item OVERVIEW OF CLASSES
7063
7064 =over 4
7065
7066 =item SV-RELATED CLASSES
7067
7068 =item B::SV METHODS
7069
7070 REFCNT, FLAGS
7071
7072 =item B::IV METHODS
7073
7074 IV, IVX, UVX, int_value, needs64bits, packiv
7075
7076 =item B::NV METHODS
7077
7078 NV, NVX
7079
7080 =item B::RV METHODS
7081
7082 RV
7083
7084 =item B::PV METHODS
7085
7086 PV, PVX
7087
7088 =item B::PVMG METHODS
7089
7090 MAGIC, SvSTASH
7091
7092 =item B::MAGIC METHODS
7093
7094 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
7095
7096 =item B::PVLV METHODS
7097
7098 TARGOFF, TARGLEN, TYPE, TARG
7099
7100 =item B::BM METHODS
7101
7102 USEFUL, PREVIOUS, RARE, TABLE
7103
7104 =item B::GV METHODS
7105
7106 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
7107 LINE, FILE, FILEGV, GvREFCNT, FLAGS
7108
7109 =item B::IO METHODS
7110
7111 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
7112 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
7113
7114 =item B::AV METHODS
7115
7116 FILL, MAX, OFF, ARRAY, AvFLAGS
7117
7118 =item B::CV METHODS
7119
7120 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
7121 CvFLAGS, const_sv
7122
7123 =item B::HV METHODS
7124
7125 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
7126
7127 =item OP-RELATED CLASSES
7128
7129 =item B::OP METHODS
7130
7131 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
7132
7133 =item B::UNOP METHOD
7134
7135 first
7136
7137 =item B::BINOP METHOD
7138
7139 last
7140
7141 =item B::LOGOP METHOD
7142
7143 other
7144
7145 =item B::LISTOP METHOD
7146
7147 children
7148
7149 =item B::PMOP METHODS
7150
7151 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
7152
7153 =item B::SVOP METHOD
7154
7155 sv, gv
7156
7157 =item B::PADOP METHOD
7158
7159 padix
7160
7161 =item B::PVOP METHOD
7162
7163 pv
7164
7165 =item B::LOOP METHODS
7166
7167 redoop, nextop, lastop
7168
7169 =item B::COP METHODS
7170
7171 label, stash, file, cop_seq, arybase, line
7172
7173 =back
7174
7175 =item FUNCTIONS EXPORTED BY C<B>
7176
7177 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
7178 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
7179 walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM),
7180 hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names
7181
7182 =item AUTHOR
7183
7184 =back
7185
7186 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
7187 bytecode
7188
7189 =over 4
7190
7191 =item SYNOPSIS
7192
7193 =item DESCRIPTION
7194
7195 =item AUTHOR
7196
7197 =back
7198
7199 =head2 B::Assembler - Assemble Perl bytecode
7200
7201 =over 4
7202
7203 =item SYNOPSIS
7204
7205 =item DESCRIPTION
7206
7207 =item AUTHORS
7208
7209 =back
7210
7211 =head2 B::Bblock - Walk basic blocks
7212
7213 =over 4
7214
7215 =item SYNOPSIS
7216
7217 =item DESCRIPTION
7218
7219 =item AUTHOR
7220
7221 =back
7222
7223 =head2 B::Bytecode - Perl compiler's bytecode backend
7224
7225 =over 4
7226
7227 =item SYNOPSIS
7228
7229 =item DESCRIPTION
7230
7231 =item OPTIONS
7232
7233 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
7234 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
7235 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
7236
7237 =item EXAMPLES
7238
7239 =item BUGS
7240
7241 =item AUTHORS
7242
7243 =back
7244
7245 =head2 B::C - Perl compiler's C backend
7246
7247 =over 4
7248
7249 =item SYNOPSIS
7250
7251 =item DESCRIPTION
7252
7253 =item OPTIONS
7254
7255 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
7256 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
7257
7258 =item EXAMPLES
7259
7260 =item BUGS
7261
7262 =item AUTHOR
7263
7264 =back
7265
7266 =head2 B::CC - Perl compiler's optimized C translation backend
7267
7268 =over 4
7269
7270 =item SYNOPSIS
7271
7272 =item DESCRIPTION
7273
7274 =item OPTIONS
7275
7276 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
7277 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
7278 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
7279
7280 =item EXAMPLES
7281
7282 =item BUGS
7283
7284 =item DIFFERENCES
7285
7286 =over 4
7287
7288 =item Loops
7289
7290 =item Context of ".."
7291
7292 =item Arithmetic
7293
7294 =item Deprecated features
7295
7296 =back
7297
7298 =item AUTHOR
7299
7300 =back
7301
7302 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
7303
7304 =over 4
7305
7306 =item SYNOPSIS
7307
7308 =item DESCRIPTION
7309
7310 =item OPTIONS
7311
7312 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
7313 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
7314 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
7315
7316 =item FORMATTING SPECIFICATIONS
7317
7318 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
7319 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
7320 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
7321 B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
7322 B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>,
7323 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
7324 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
7325 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
7326
7327 =item ABBREVIATIONS
7328
7329 =over 4
7330
7331 =item OP flags abbreviations
7332
7333 =item OP class abbreviations
7334
7335 =back
7336
7337 =item AUTHOR
7338
7339 =back
7340
7341 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
7342
7343 =over 4
7344
7345 =item SYNOPSIS
7346
7347 =item DESCRIPTION
7348
7349 =item AUTHOR
7350
7351 =back
7352
7353 =head2 B::Deparse - Perl compiler backend to produce perl code
7354
7355 =over 4
7356
7357 =item SYNOPSIS
7358
7359 =item DESCRIPTION
7360
7361 =item OPTIONS
7362
7363 B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
7364 B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
7365
7366 =item USING B::Deparse AS A MODULE
7367
7368 =over 4
7369
7370 =item Synopsis
7371
7372 =item Description
7373
7374 =item new
7375
7376 =item ambient_pragmas
7377
7378 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
7379
7380 =item coderef2text
7381
7382 =back
7383
7384 =item BUGS
7385
7386 =item AUTHOR
7387
7388 =back
7389
7390 =head2 B::Disassembler - Disassemble Perl bytecode
7391
7392 =over 4
7393
7394 =item SYNOPSIS
7395
7396 =item DESCRIPTION
7397
7398 =item AUTHOR
7399
7400 =back
7401
7402 =head2 B::Lint - Perl lint
7403
7404 =over 4
7405
7406 =item SYNOPSIS
7407
7408 =item DESCRIPTION
7409
7410 =item OPTIONS AND LINT CHECKS
7411
7412 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
7413 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
7414
7415 =item NON LINT-CHECK OPTIONS
7416
7417 B<-u Package>
7418
7419 =item BUGS
7420
7421 =item AUTHOR
7422
7423 =back
7424
7425 =head2 B::O, O - Generic interface to Perl Compiler backends
7426
7427 =over 4
7428
7429 =item SYNOPSIS
7430
7431 =item DESCRIPTION
7432
7433 =item CONVENTIONS
7434
7435 =item IMPLEMENTATION
7436
7437 =item AUTHOR
7438
7439 =back
7440
7441 =head2 B::Showlex - Show lexical variables used in functions or files
7442
7443 =over 4
7444
7445 =item SYNOPSIS
7446
7447 =item DESCRIPTION
7448
7449 =item AUTHOR
7450
7451 =back
7452
7453 =head2 B::Stackobj - Helper module for CC backend
7454
7455 =over 4
7456
7457 =item SYNOPSIS
7458
7459 =item DESCRIPTION
7460
7461 =item AUTHOR
7462
7463 =back
7464
7465 =head2 B::Stash - show what stashes are loaded
7466
7467 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
7468
7469 =over 4
7470
7471 =item SYNOPSIS
7472
7473 =item DESCRIPTION
7474
7475 =item AUTHOR
7476
7477 =back
7478
7479 =head2 B::Xref - Generates cross reference reports for Perl programs
7480
7481 =over 4
7482
7483 =item SYNOPSIS
7484
7485 =item DESCRIPTION
7486
7487 =item OPTIONS
7488
7489 C<-oFILENAME>, C<-r>, C<-D[tO]>
7490
7491 =item BUGS
7492
7493 =item AUTHOR
7494
7495 =back
7496
7497 =head2 Bblock, B::Bblock - Walk basic blocks
7498
7499 =over 4
7500
7501 =item SYNOPSIS
7502
7503 =item DESCRIPTION
7504
7505 =item AUTHOR
7506
7507 =back
7508
7509 =head2 Benchmark - benchmark running times of Perl code
7510
7511 =over 4
7512
7513 =item SYNOPSIS
7514
7515 =item DESCRIPTION
7516
7517 =over 4
7518
7519 =item Methods
7520
7521 new, debug, iters
7522
7523 =item Standard Exports
7524
7525 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
7526 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
7527 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
7528
7529 =item Optional Exports
7530
7531 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
7532 STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
7533 ), enablecache ( ), timesum ( T1, T2 )
7534
7535 =back
7536
7537 =item NOTES
7538
7539 =item EXAMPLES
7540
7541 =item INHERITANCE
7542
7543 =item CAVEATS
7544
7545 =item SEE ALSO
7546
7547 =item AUTHORS
7548
7549 =item MODIFICATION HISTORY
7550
7551 =back
7552
7553 =head2 ByteLoader - load byte compiled perl code
7554
7555 =over 4
7556
7557 =item SYNOPSIS
7558
7559 =item DESCRIPTION
7560
7561 =item AUTHOR
7562
7563 =item SEE ALSO
7564
7565 =back
7566
7567 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
7568
7569 =over 4
7570
7571 =item SYNOPSIS
7572
7573 =item DESCRIPTION
7574
7575 =item OPTIONS
7576
7577 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
7578 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
7579 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
7580
7581 =item EXAMPLES
7582
7583 =item BUGS
7584
7585 =item AUTHORS
7586
7587 =back
7588
7589 =head2 CGI - Simple Common Gateway Interface Class
7590
7591 =over 4
7592
7593 =item SYNOPSIS
7594
7595 =item ABSTRACT
7596
7597 =item DESCRIPTION
7598
7599 =over 4
7600
7601 =item PROGRAMMING STYLE
7602
7603 =item CALLING CGI.PM ROUTINES
7604
7605 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
7606
7607 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
7608
7609 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
7610
7611 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
7612
7613 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
7614
7615 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
7616
7617 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
7618
7619 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
7620
7621 =item DELETING A PARAMETER COMPLETELY:
7622
7623 =item DELETING ALL PARAMETERS:
7624
7625 =item DIRECT ACCESS TO THE PARAMETER LIST:
7626
7627 =item FETCHING THE PARAMETER LIST AS A HASH:
7628
7629 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
7630
7631 =item RETRIEVING CGI ERRORS
7632
7633 =item USING THE FUNCTION-ORIENTED INTERFACE
7634
7635 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
7636 B<:standard>, B<:all>
7637
7638 =item PRAGMAS
7639
7640 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
7641 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
7642 -private_tempfiles
7643
7644 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
7645
7646 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
7647 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
7648 a </UL> tag)
7649
7650 =back
7651
7652 =item GENERATING DYNAMIC DOCUMENTS
7653
7654 =over 4
7655
7656 =item CREATING A STANDARD HTTP HEADER:
7657
7658 =item GENERATING A REDIRECTION HEADER
7659
7660 =item CREATING THE HTML DOCUMENT HEADER
7661
7662 B<Parameters:>, 4, 5, 6..
7663
7664 =item ENDING THE HTML DOCUMENT:
7665
7666 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
7667
7668 =item OBTAINING THE SCRIPT'S URL
7669
7670 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
7671 (B<-query_string>), B<-base>
7672
7673 =item MIXING POST AND URL PARAMETERS
7674
7675 =back
7676
7677 =item CREATING STANDARD HTML ELEMENTS:
7678
7679 =over 4
7680
7681 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
7682
7683 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
7684
7685 =item HTML SHORTCUTS AND LIST INTERPOLATION
7686
7687 =item NON-STANDARD HTML SHORTCUTS
7688
7689 =item AUTOESCAPING HTML
7690
7691 $escaped_string = escapeHTML("unescaped string");, $charset =
7692 charset([$charset]);, $flag = autoEscape([$flag]);
7693
7694 =item PRETTY-PRINTING HTML
7695
7696 =back
7697
7698 =item CREATING FILL-OUT FORMS:
7699
7700 =over 4
7701
7702 =item CREATING AN ISINDEX TAG
7703
7704 =item STARTING AND ENDING A FORM
7705
7706 B<application/x-www-form-urlencoded>, B<multipart/form-data>
7707
7708 =item CREATING A TEXT FIELD
7709
7710 B<Parameters>
7711
7712 =item CREATING A BIG TEXT FIELD
7713
7714 =item CREATING A PASSWORD FIELD
7715
7716 =item CREATING A FILE UPLOAD FIELD
7717
7718 B<Parameters>
7719
7720 =item CREATING A POPUP MENU
7721
7722 =item CREATING A SCROLLING LIST
7723
7724 B<Parameters:>
7725
7726 =item CREATING A GROUP OF RELATED CHECKBOXES
7727
7728 B<Parameters:>
7729
7730 =item CREATING A STANDALONE CHECKBOX
7731
7732 B<Parameters:>
7733
7734 =item CREATING A RADIO BUTTON GROUP
7735
7736 B<Parameters:>
7737
7738 =item CREATING A SUBMIT BUTTON
7739
7740 B<Parameters:>
7741
7742 =item CREATING A RESET BUTTON
7743
7744 =item CREATING A DEFAULT BUTTON
7745
7746 =item CREATING A HIDDEN FIELD
7747
7748 B<Parameters:>
7749
7750 =item CREATING A CLICKABLE IMAGE BUTTON
7751
7752 B<Parameters:>
7753
7754 =item CREATING A JAVASCRIPT ACTION BUTTON
7755
7756 =back
7757
7758 =item HTTP COOKIES
7759
7760 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
7761 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
7762
7763 =item WORKING WITH FRAMES
7764
7765 1. Create a <Frameset> document, 2. Specify the destination for the
7766 document in the HTTP header, 3. Specify the destination for the document in
7767 the <FORM> tag
7768
7769 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
7770
7771 =item DEBUGGING
7772
7773 =over 4
7774
7775 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
7776
7777 =back
7778
7779 =item FETCHING ENVIRONMENT VARIABLES
7780
7781 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
7782 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
7783 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
7784 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
7785 B<request_method()>, B<content_type()>, B<http()>, B<https()>
7786
7787 =item USING NPH SCRIPTS
7788
7789 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
7790 parameters
7791
7792 =item Server Push
7793
7794 multipart_init(), multipart_start(), multipart_end(), multipart_final()
7795
7796 =item Avoiding Denial of Service Attacks
7797
7798 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
7799 basis>, B<2. Globally for all scripts>
7800
7801 =item COMPATIBILITY WITH CGI-LIB.PL
7802
7803 =item AUTHOR INFORMATION
7804
7805 =item CREDITS
7806
7807 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
7808 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
7809 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
7810 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
7811 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
7812 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
7813 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
7814 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
7815 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
7816 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
7817 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
7818 ...and many many more..
7819
7820 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
7821
7822 =item BUGS
7823
7824 =item SEE ALSO
7825
7826 =back
7827
7828 =head2 CGI::Apache - Backward compatibility module for CGI.pm
7829
7830 =over 4
7831
7832 =item SYNOPSIS
7833
7834 =item ABSTRACT
7835
7836 =item DESCRIPTION
7837
7838 =item AUTHOR INFORMATION
7839
7840 =item BUGS
7841
7842 =item SEE ALSO
7843
7844 =back
7845
7846 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
7847 other) error log
7848
7849 =over 4
7850
7851 =item SYNOPSIS
7852
7853 =item DESCRIPTION
7854
7855 =item REDIRECTING ERROR MESSAGES
7856
7857 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
7858
7859 =over 4
7860
7861 =item Changing the default message
7862
7863 =back
7864
7865 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
7866
7867 =item CHANGE LOG
7868
7869 =item AUTHORS
7870
7871 =item SEE ALSO
7872
7873 =back
7874
7875 =head2 CGI::Cookie - Interface to Netscape Cookies
7876
7877 =over 4
7878
7879 =item SYNOPSIS
7880
7881 =item DESCRIPTION
7882
7883 =item USING CGI::Cookie
7884
7885 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
7886
7887 =over 4
7888
7889 =item Creating New Cookies
7890
7891 =item Sending the Cookie to the Browser
7892
7893 =item Recovering Previous Cookies
7894
7895 =item Manipulating Cookies
7896
7897 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
7898
7899 =back
7900
7901 =item AUTHOR INFORMATION
7902
7903 =item BUGS
7904
7905 =item SEE ALSO
7906
7907 =back
7908
7909 =head2 CGI::Fast - CGI Interface for Fast CGI
7910
7911 =over 4
7912
7913 =item SYNOPSIS
7914
7915 =item DESCRIPTION
7916
7917 =item OTHER PIECES OF THE PUZZLE
7918
7919 =item WRITING FASTCGI PERL SCRIPTS
7920
7921 =item INSTALLING FASTCGI SCRIPTS
7922
7923 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
7924
7925 =item CAVEATS
7926
7927 =item AUTHOR INFORMATION
7928
7929 =item BUGS
7930
7931 =item SEE ALSO
7932
7933 =back
7934
7935 =head2 CGI::Pretty - module to produce nicely formatted HTML code
7936
7937 =over 4
7938
7939 =item SYNOPSIS
7940
7941 =item DESCRIPTION
7942
7943 =over 4
7944
7945 =item Tags that won't be formatted
7946
7947 =item Customizing the Indenting
7948
7949 =back
7950
7951 =item BUGS
7952
7953 =item AUTHOR
7954
7955 =item SEE ALSO
7956
7957 =back
7958
7959 =head2 CGI::Push - Simple Interface to Server Push
7960
7961 =over 4
7962
7963 =item SYNOPSIS
7964
7965 =item DESCRIPTION
7966
7967 =item USING CGI::Push
7968
7969 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
7970
7971 =over 4
7972
7973 =item Heterogeneous Pages
7974
7975 =item Changing the Page Delay on the Fly
7976
7977 =back
7978
7979 =item INSTALLING CGI::Push SCRIPTS
7980
7981 =item AUTHOR INFORMATION
7982
7983 =item BUGS
7984
7985 =item SEE ALSO
7986
7987 =back
7988
7989 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
7990
7991 =over 4
7992
7993 =item SYNOPSIS
7994
7995 =item ABSTRACT
7996
7997 =item DESCRIPTION
7998
7999 =item AUTHOR INFORMATION
8000
8001 =item BUGS
8002
8003 =item SEE ALSO
8004
8005 =back
8006
8007 =head2 CGI::Util - Internal utilities used by CGI module
8008
8009 =over 4
8010
8011 =item SYNOPSIS
8012
8013 =item DESCRIPTION
8014
8015 =item AUTHOR INFORMATION
8016
8017 =item SEE ALSO
8018
8019 =back
8020
8021 =head2 CPAN - query, download and build perl modules from CPAN sites
8022
8023 =over 4
8024
8025 =item SYNOPSIS
8026
8027 =item DESCRIPTION
8028
8029 =over 4
8030
8031 =item Interactive Mode
8032
8033 Searching for authors, bundles, distribution files and modules, make, test,
8034 install, clean  modules or distributions, get, readme, look module or
8035 distribution, ls author, Signals
8036
8037 =item CPAN::Shell
8038
8039 =item autobundle
8040
8041 =item recompile
8042
8043 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
8044
8045 =item Programmer's interface
8046
8047 expand($type,@things), expandany(@things), Programming Examples
8048
8049 =item Methods in the other Classes
8050
8051 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
8052 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
8053 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
8054 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
8055 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
8056 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
8057 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
8058 CPAN::Bundle::readme(), CPAN::Bundle::test(),
8059 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
8060 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
8061 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
8062 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
8063 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
8064 CPAN::Distribution::look(), CPAN::Distribution::make(),
8065 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
8066 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
8067 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
8068 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
8069 CPAN::Module::clean(), CPAN::Module::cpan_file(),
8070 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
8071 CPAN::Module::description(), CPAN::Module::force($method,@args),
8072 CPAN::Module::get(), CPAN::Module::inst_file(),
8073 CPAN::Module::inst_version(), CPAN::Module::install(),
8074 CPAN::Module::look(), CPAN::Module::make(),
8075 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
8076 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
8077
8078 =item Cache Manager
8079
8080 =item Bundles
8081
8082 =item Prerequisites
8083
8084 =item Finding packages and VERSION
8085
8086 =item Debugging
8087
8088 =item Floppy, Zip, Offline Mode
8089
8090 =back
8091
8092 =item CONFIGURATION
8093
8094 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
8095 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
8096 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
8097 [unshift|push|splice] E<lt>listE<gt>>
8098
8099 =over 4
8100
8101 =item Note on urllist parameter's format
8102
8103 =item urllist parameter has CD-ROM support
8104
8105 =back
8106
8107 =item SECURITY
8108
8109 =item EXPORT
8110
8111 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
8112
8113 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
8114
8115 =over 4
8116
8117 =item Three basic types of firewalls
8118
8119 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
8120
8121 =item Configuring lynx or ncftp for going through a firewall
8122
8123 =back
8124
8125 =item FAQ
8126
8127 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
8128
8129 =item BUGS
8130
8131 =item AUTHOR
8132
8133 =item TRANSLATIONS
8134
8135 =item SEE ALSO
8136
8137 =back
8138
8139 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
8140
8141 =over 4
8142
8143 =item SYNOPSIS
8144
8145 =item DESCRIPTION
8146
8147 =back
8148
8149 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
8150 module
8151
8152 =over 4
8153
8154 =item SYNOPSIS
8155
8156 =item DESCRIPTION
8157
8158 =item  SEE ALSO
8159
8160 =back
8161
8162 =head2 Carp, carp    - warn of errors (from perspective of caller)
8163
8164 =over 4
8165
8166 =item SYNOPSIS
8167
8168 =item DESCRIPTION
8169
8170 =over 4
8171
8172 =item Forcing a Stack Trace
8173
8174 =back
8175
8176 =item BUGS
8177
8178 =back
8179
8180 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
8181
8182 =head2 Class::ISA -- report the search path for a class's ISA tree
8183
8184 =over 4
8185
8186 =item SYNOPSIS
8187
8188 =item DESCRIPTION
8189
8190 =item FUNCTIONS
8191
8192 the function Class::ISA::super_path($CLASS), the function
8193 Class::ISA::self_and_super_path($CLASS), the function
8194 Class::ISA::self_and_super_versions($CLASS)
8195
8196 =item CAUTIONARY NOTES
8197
8198 =item COPYRIGHT
8199
8200 =item AUTHOR
8201
8202 =back
8203
8204 =head2 Class::Struct - declare struct-like datatypes as Perl classes
8205
8206 =over 4
8207
8208 =item SYNOPSIS
8209
8210 =item DESCRIPTION
8211
8212 =over 4
8213
8214 =item The C<struct()> function
8215
8216 =item Class Creation at Compile Time
8217
8218 =item Element Types and Accessor Methods
8219
8220 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
8221 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
8222
8223 =item Initializing with C<new>
8224
8225 =back
8226
8227 =item EXAMPLES
8228
8229 Example 1, Example 2, Example 3
8230
8231 =item Author and Modification History
8232
8233 =back
8234
8235 =head2 Config - access Perl configuration information
8236
8237 =over 4
8238
8239 =item SYNOPSIS
8240
8241 =item DESCRIPTION
8242
8243 myconfig(), config_sh(), config_vars(@names)
8244
8245 =item EXAMPLE
8246
8247 =item WARNING
8248
8249 =item GLOSSARY
8250
8251 =over 4
8252
8253 =item _
8254
8255 C<_a>, C<_exe>, C<_o>
8256
8257 =item a
8258
8259 C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<api_revision>,
8260 C<api_subversion>, C<api_version>, C<api_versionstring>, C<ar>, C<archlib>,
8261 C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk>
8262
8263 =item b
8264
8265 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
8266 C<byacc>, C<byteorder>
8267
8268 =item c
8269
8270 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
8271 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
8272 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
8273 C<clocktype>, C<comm>, C<compress>
8274
8275 =item C
8276
8277 C<CONFIGDOTSH>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
8278 C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
8279 C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh>
8280
8281 =item d
8282
8283 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
8284 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
8285 C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
8286 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
8287 C<d_chsize>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_crypt>,
8288 C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>,
8289 C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>,
8290 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endhent>, C<d_endnent>,
8291 C<d_endpent>, C<d_endpwent>, C<d_endsent>, C<d_eofnblk>, C<d_eunice>,
8292 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
8293 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_flexfnam>, C<d_flock>,
8294 C<d_fork>, C<d_fpathconf>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
8295 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
8296 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
8297 C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>,
8298 C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostprotos>,
8299 C<d_getitimer>, C<d_getlogin>, C<d_getmnt>, C<d_getmntent>,
8300 C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>,
8301 C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, C<d_getpent>,
8302 C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, C<d_getprior>,
8303 C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, C<d_getsbyname>,
8304 C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>, C<d_getspnam>,
8305 C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
8306 C<d_iconv>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
8307 C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
8308 C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
8309 C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>,
8310 C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
8311 C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
8312 C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_mprotect>, C<d_msg>,
8313 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
8314 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
8315 C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
8316 C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>, C<d_off64_t>,
8317 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
8318 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
8319 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
8320 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
8321 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
8322 C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
8323 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
8324 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>,
8325 C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>,
8326 C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
8327 C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>,
8328 C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
8329 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
8330 C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setitimer>,
8331 C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>,
8332 C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>,
8333 C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
8334 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>,
8335 C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>,
8336 C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>,
8337 C<d_sigsetjmp>, C<d_sockatmark>, C<d_socket>, C<d_socklen_t>,
8338 C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_statblks>,
8339 C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
8340 C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
8341 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
8342 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
8343 C<d_strerror>, C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>,
8344 C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>,
8345 C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_sysconf>,
8346 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
8347 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
8348 C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
8349 C<d_uname>, C<d_union_semun>, C<d_usleep>, C<d_ustat>, C<d_vendorarch>,
8350 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
8351 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
8352 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
8353 C<db_hashtype>, C<db_prefixtype>, C<defvoidused>, C<direntrytype>,
8354 C<dlext>, C<dlsrc>, C<doublesize>, C<drand01>, C<dynamic_ext>
8355
8356 =item e
8357
8358 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
8359 C<exe_ext>, C<expr>, C<extensions>
8360
8361 =item f
8362
8363 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
8364 C<fpossize>, C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
8365
8366 =item g
8367
8368 C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
8369 C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
8370
8371 =item h
8372
8373 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
8374
8375 =item i
8376
8377 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
8378 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
8379 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
8380 C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_libutil>,
8381 C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>,
8382 C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>,
8383 C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, C<i_pthread>, C<i_pwd>,
8384 C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>,
8385 C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sunmath>,
8386 C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>,
8387 C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, C<i_sysmount>,
8388 C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>,
8389 C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, C<i_sysstatvfs>,
8390 C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>,
8391 C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>,
8392 C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>,
8393 C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
8394 C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>,
8395 C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>,
8396 C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>,
8397 C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>,
8398 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
8399 C<installvendorlib>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>,
8400 C<ivtype>
8401
8402 =item k
8403
8404 C<known_extensions>, C<ksh>
8405
8406 =item l
8407
8408 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
8409 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
8410 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
8411 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
8412 C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>,
8413 C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
8414
8415 =item m
8416
8417 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
8418 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
8419 C<man3direxp>, C<man3ext>
8420
8421 =item M
8422
8423 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
8424 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
8425
8426 =item n
8427
8428 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
8429 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
8430 C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
8431 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
8432
8433 =item o
8434
8435 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
8436 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
8437
8438 =item p
8439
8440 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
8441 C<perl>
8442
8443 =item P
8444
8445 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
8446 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
8447 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
8448 C<privlibexp>, C<prototype>, C<ptrsize>
8449
8450 =item q
8451
8452 C<quadkind>, C<quadtype>
8453
8454 =item r
8455
8456 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
8457 C<revision>, C<rm>, C<rmail>, C<runnm>
8458
8459 =item s
8460
8461 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
8462 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
8463 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
8464 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>,
8465 C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>,
8466 C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
8467 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
8468 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
8469 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
8470 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
8471 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>,
8472 C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
8473 C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
8474 C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
8475
8476 =item t
8477
8478 C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>,
8479 C<touch>, C<tr>, C<trnl>, C<troff>
8480
8481 =item u
8482
8483 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
8484 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
8485 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
8486 C<use64bitint>, C<usedl>, C<useithreads>, C<uselargefiles>,
8487 C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, C<usemymalloc>,
8488 C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, C<usesfio>,
8489 C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>,
8490 C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>,
8491 C<uvxformat>, C<uvXUformat>
8492
8493 =item v
8494
8495 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
8496 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
8497 C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags>
8498
8499 =item x
8500
8501 C<xlibpth>, C<xs_apiversion>
8502
8503 =item y
8504
8505 C<yacc>, C<yaccflags>
8506
8507 =item z
8508
8509 C<zcat>, C<zip>
8510
8511 =back
8512
8513 =item NOTE
8514
8515 =back
8516
8517 =head2 Cwd - get pathname of current working directory
8518
8519 =over 4
8520
8521 =item SYNOPSIS
8522
8523 =item DESCRIPTION
8524
8525 =back
8526
8527 =head2 DB - programmatic interface to the Perl debugging API (draft,
8528 subject to
8529 change)
8530
8531 =over 4
8532
8533 =item SYNOPSIS
8534
8535 =item DESCRIPTION
8536
8537 =over 4
8538
8539 =item Global Variables
8540
8541  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
8542 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
8543 $DB::lineno
8544
8545 =item API Methods
8546
8547 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
8548 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
8549
8550 =item Client Callback Methods
8551
8552 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
8553 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
8554 CLIENT->output(LIST)
8555
8556 =back
8557
8558 =item BUGS
8559
8560 =item AUTHOR
8561
8562 =back
8563
8564 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
8565
8566 =over 4
8567
8568 =item SYNOPSIS
8569
8570 =item DESCRIPTION
8571
8572 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
8573
8574 =over 4
8575
8576 =item Using DB_File with Berkeley DB version 2 or 3
8577
8578 =item Interface to Berkeley DB
8579
8580 =item Opening a Berkeley DB Database File
8581
8582 =item Default Parameters
8583
8584 =item In Memory Databases
8585
8586 =back
8587
8588 =item DB_HASH
8589
8590 =over 4
8591
8592 =item A Simple Example
8593
8594 =back
8595
8596 =item DB_BTREE
8597
8598 =over 4
8599
8600 =item Changing the BTREE sort order
8601
8602 =item Handling Duplicate Keys
8603
8604 =item The get_dup() Method
8605
8606 =item The find_dup() Method
8607
8608 =item The del_dup() Method
8609
8610 =item Matching Partial Keys
8611
8612 =back
8613
8614 =item DB_RECNO
8615
8616 =over 4
8617
8618 =item The 'bval' Option
8619
8620 =item A Simple Example
8621
8622 =item Extra RECNO Methods
8623
8624 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
8625 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
8626
8627 =item Another Example
8628
8629 =back
8630
8631 =item THE API INTERFACE
8632
8633 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
8634 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
8635 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
8636 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
8637
8638 =item DBM FILTERS
8639
8640 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
8641 B<filter_fetch_value>
8642
8643 =over 4
8644
8645 =item The Filter
8646
8647 =item An Example -- the NULL termination problem.
8648
8649 =item Another Example -- Key is a C int.
8650
8651 =back
8652
8653 =item HINTS AND TIPS
8654
8655 =over 4
8656
8657 =item Locking: The Trouble with fd
8658
8659 =item Safe ways to lock a database
8660
8661 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
8662
8663 =item Sharing Databases With C Applications
8664
8665 =item The untie() Gotcha
8666
8667 =back
8668
8669 =item COMMON QUESTIONS
8670
8671 =over 4
8672
8673 =item Why is there Perl source in my database?
8674
8675 =item How do I store complex data structures with DB_File?
8676
8677 =item What does "Invalid Argument" mean?
8678
8679 =item What does "Bareword 'DB_File' not allowed" mean?
8680
8681 =back
8682
8683 =item REFERENCES
8684
8685 =item HISTORY
8686
8687 =item BUGS
8688
8689 =item AVAILABILITY
8690
8691 =item COPYRIGHT
8692
8693 =item SEE ALSO
8694
8695 =item AUTHOR
8696
8697 =back
8698
8699 =head2 Data::Dumper - stringified perl data structures, suitable for both
8700 printing and C<eval>
8701
8702 =over 4
8703
8704 =item SYNOPSIS
8705
8706 =item DESCRIPTION
8707
8708 =over 4
8709
8710 =item Methods
8711
8712 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
8713 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
8714 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
8715 I<$OBJ>->Reset
8716
8717 =item Functions
8718
8719 Dumper(I<LIST>)
8720
8721 =item Configuration Variables or Methods
8722
8723 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
8724 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
8725 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
8726 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
8727 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
8728 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
8729 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
8730 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
8731 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
8732 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
8733 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
8734 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>)
8735
8736 =item Exports
8737
8738 Dumper
8739
8740 =back
8741
8742 =item EXAMPLES
8743
8744 =item BUGS
8745
8746 =item AUTHOR
8747
8748 =item VERSION
8749
8750 =item SEE ALSO
8751
8752 =back
8753
8754 =head2 Devel::DProf - a Perl code profiler
8755
8756 =over 4
8757
8758 =item SYNOPSIS
8759
8760 =item DESCRIPTION
8761
8762 =item PROFILE FORMAT
8763
8764 =item AUTOLOAD
8765
8766 =item ENVIRONMENT
8767
8768 =item BUGS
8769
8770 =item SEE ALSO
8771
8772 =back
8773
8774 =head2 Devel::Peek - A data debugging tool for the XS programmer
8775
8776 =over 4
8777
8778 =item SYNOPSIS
8779
8780 =item DESCRIPTION
8781
8782 =over 4
8783
8784 =item Memory footprint debugging
8785
8786 =back
8787
8788 =item EXAMPLES
8789
8790 =over 4
8791
8792 =item A simple scalar string
8793
8794 =item A simple scalar number
8795
8796 =item A simple scalar with an extra reference
8797
8798 =item A reference to a simple scalar
8799
8800 =item A reference to an array
8801
8802 =item A reference to a hash
8803
8804 =item Dumping a large array or hash
8805
8806 =item A reference to an SV which holds a C pointer
8807
8808 =item A reference to a subroutine
8809
8810 =back
8811
8812 =item EXPORTS
8813
8814 =item BUGS
8815
8816 =item AUTHOR
8817
8818 =item SEE ALSO
8819
8820 =back
8821
8822 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
8823
8824 =over 4
8825
8826 =item SYNOPSIS
8827
8828 =item DESCRIPTION
8829
8830 =back
8831
8832 =head2 Digest:: - Modules that calculate message digests
8833
8834 =over 4
8835
8836 =item SYNOPSIS
8837
8838 =item DESCRIPTION
8839
8840 I<binary>, I<hex>, I<base64>
8841
8842 =item OO INTERFACE
8843
8844 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
8845 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
8846 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
8847
8848 =item SEE ALSO
8849
8850 =item AUTHOR
8851
8852 =back
8853
8854 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
8855
8856 =over 4
8857
8858 =item SYNOPSIS
8859
8860 =item DESCRIPTION
8861
8862 =item FUNCTIONS
8863
8864 md5($data,...), md5_hex($data,...), md5_base64($data,...)
8865
8866 =item METHODS
8867
8868 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
8869 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
8870
8871 =item EXAMPLES
8872
8873 =item SEE ALSO
8874
8875 =item COPYRIGHT
8876
8877 =item AUTHORS
8878
8879 =back
8880
8881 =head2 DirHandle - supply object methods for directory handles
8882
8883 =over 4
8884
8885 =item SYNOPSIS
8886
8887 =item DESCRIPTION
8888
8889 =back
8890
8891 =head2 Dumpvalue - provides screen dump of Perl data.
8892
8893 =over 4
8894
8895 =item SYNOPSIS
8896
8897 =item DESCRIPTION
8898
8899 =over 4
8900
8901 =item Creation
8902
8903 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
8904 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
8905 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
8906 stopDbSignal
8907
8908 =item Methods
8909
8910 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
8911 veryCompact, set, get
8912
8913 =back
8914
8915 =back
8916
8917 =head2 DynaLoader - Dynamically load C libraries into Perl code
8918
8919 =over 4
8920
8921 =item SYNOPSIS
8922
8923 =item DESCRIPTION
8924
8925 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
8926 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
8927 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
8928 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
8929 bootstrap()
8930
8931 =item AUTHOR
8932
8933 =back
8934
8935 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
8936 Perl code
8937
8938 =over 4
8939
8940 =item SYNOPSIS
8941
8942 =item DESCRIPTION
8943
8944 =item AUTHOR
8945
8946 =back
8947
8948 =head2 Encode - character encodings
8949
8950 =over 4
8951
8952 =item SYNOPSIS
8953
8954 =item DESCRIPTION
8955
8956 =over 4
8957
8958 =item TERMINOLOGY
8959
8960 =back
8961
8962 =item ENCODINGS
8963
8964 =over 4
8965
8966 =item Characteristics of an Encoding
8967
8968 =item Types of Encodings
8969
8970 Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
8971 Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
8972
8973 =item Specifying Encodings
8974
8975 1. By name, 2. As an object
8976
8977 =item Encoding Names
8978
8979 The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry,
8980 The name used by the the organization that defined it
8981
8982 =back
8983
8984 =item PERL ENCODING API
8985
8986 =over 4
8987
8988 =item Generic Encoding Interface
8989
8990 =item Handling Malformed Data
8991
8992 Scheme 1, Scheme 2, Other Schemes
8993
8994 =item UTF-8 / utf8
8995
8996 =item Other Encodings of Unicode
8997
8998 =item Listing available encodings
8999
9000 =item Defining Aliases
9001
9002 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
9003 reference, e.g.:
9004
9005 =item Defining Encodings
9006
9007 =back
9008
9009 =item Encoding and IO
9010
9011 =item Encoding How to ...
9012
9013 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
9014 strings in binary data, perl/Encode wrappers on non-Unicode XS modules
9015
9016 =item Messing with Perl's Internals
9017
9018 is_utf8(STRING [, CHECK]), valid_utf8(STRING)
9019
9020 =item IMPLEMENTATION CLASSES
9021
9022 -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
9023 -E<gt>decode($octets,$check)
9024
9025 =over 4
9026
9027 =item Compiled Encodings
9028
9029 .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
9030 variants of EBCDIC, symbol and dingbats as used by Tk on X11
9031
9032 =back
9033
9034 =item SEE ALSO
9035
9036 =back
9037
9038 =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
9039 of the Encode extension
9040
9041 =over 4
9042
9043 =item DESCRIPTION
9044
9045 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9046
9047 =item KEYWORDS
9048
9049 =item COPYRIGHT
9050
9051 =back
9052
9053 =head2 Encode::Tcl - Tcl encodings
9054
9055 =head2 EncodeFormat - the format of encoding tables of the Encode extension
9056
9057 =over 4
9058
9059 =item DESCRIPTION
9060
9061 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9062
9063 =item KEYWORDS
9064
9065 =item COPYRIGHT
9066
9067 =back
9068
9069 =head2 English - use nice English (or awk) names for ugly punctuation
9070 variables
9071
9072 =over 4
9073
9074 =item SYNOPSIS
9075
9076 =item DESCRIPTION
9077
9078 =item PERFORMANCE
9079
9080 =back
9081
9082 =head2 Env - perl module that imports environment variables as scalars or
9083 arrays
9084
9085 =over 4
9086
9087 =item SYNOPSIS
9088
9089 =item DESCRIPTION
9090
9091 =item LIMITATIONS
9092
9093 =item AUTHOR
9094
9095 =back
9096
9097 =head2 Errno - System errno constants
9098
9099 =over 4
9100
9101 =item SYNOPSIS
9102
9103 =item DESCRIPTION
9104
9105 =item CAVEATS
9106
9107 =item AUTHOR
9108
9109 =item COPYRIGHT
9110
9111 =back
9112
9113 =head2 Exporter - Implements default import method for modules
9114
9115 =over 4
9116
9117 =item SYNOPSIS
9118
9119 =item DESCRIPTION
9120
9121 =over 4
9122
9123 =item How to Export
9124
9125 =item Selecting What To Export
9126
9127 =item Specialised Import Lists
9128
9129 =item Exporting without using Export's import method
9130
9131 =item Module Version Checking
9132
9133 =item Managing Unknown Symbols
9134
9135 =item Tag Handling Utility Functions
9136
9137 =back
9138
9139 =back
9140
9141 =head2 Exporter::Heavy - Exporter guts
9142
9143 =over 4
9144
9145 =item SYNOPIS
9146
9147 =item DESCRIPTION
9148
9149 =back
9150
9151 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
9152 Makefiles etc.
9153
9154 =over 4
9155
9156 =item SYNOPSIS
9157
9158 =item DESCRIPTION
9159
9160 =back
9161
9162 cat
9163
9164 eqtime src dst
9165
9166 rm_f files...
9167
9168 rm_f files...
9169
9170 touch files ..
9171
9172 mv source... destination
9173
9174 cp source... destination
9175
9176 chmod mode files..
9177
9178 mkpath directory..
9179
9180 test_f file
9181
9182 =over 4
9183
9184 =item BUGS
9185
9186 =item SEE ALSO
9187
9188 =item AUTHOR
9189
9190 =back
9191
9192 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
9193
9194 =over 4
9195
9196 =item SYNOPSIS
9197
9198 =item DESCRIPTION
9199
9200 =item @EXPORT
9201
9202 =item FUNCTIONS
9203
9204 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
9205 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
9206
9207 =item EXAMPLES
9208
9209 =item SEE ALSO
9210
9211 =item AUTHOR
9212
9213 =back
9214
9215 =head2 ExtUtils::Install - install files from here to there
9216
9217 =over 4
9218
9219 =item SYNOPSIS
9220
9221 =item DESCRIPTION
9222
9223 =back
9224
9225 =head2 ExtUtils::Installed - Inventory management of installed modules
9226
9227 =over 4
9228
9229 =item SYNOPSIS
9230
9231 =item DESCRIPTION
9232
9233 =item USAGE
9234
9235 =item FUNCTIONS
9236
9237 new(), modules(), files(), directories(), directory_tree(), validate(),
9238 packlist(), version()
9239
9240 =item EXAMPLE
9241
9242 =item AUTHOR
9243
9244 =back
9245
9246 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
9247
9248 =over 4
9249
9250 =item SYNOPSIS
9251
9252 =item DESCRIPTION
9253
9254 For static extensions, For dynamic extensions, For dynamic extensions
9255
9256 =over 4
9257
9258 =item EXTRALIBS
9259
9260 =item LDLOADLIBS and LD_RUN_PATH
9261
9262 =item BSLOADLIBS
9263
9264 =back
9265
9266 =item PORTABILITY
9267
9268 =over 4
9269
9270 =item VMS implementation
9271
9272 =item Win32 implementation
9273
9274 =back
9275
9276 =item SEE ALSO
9277
9278 =back
9279
9280 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
9281 ExtUtils::MakeMaker
9282
9283 =over 4
9284
9285 =item SYNOPSIS
9286
9287 =item DESCRIPTION
9288
9289 canonpath, cflags, manifypods, perl_archive
9290
9291 =back
9292
9293 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
9294 ExtUtils::MakeMaker
9295
9296 =over 4
9297
9298 =item SYNOPSIS
9299
9300 =item DESCRIPTION
9301
9302 =item METHODS
9303
9304 =back
9305
9306 perl_archive_after
9307
9308 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
9309
9310 =over 4
9311
9312 =item SYNOPSIS
9313
9314 =item DESCRIPTION
9315
9316 =item METHODS
9317
9318 =over 4
9319
9320 =item Preloaded methods
9321
9322 canonpath
9323
9324 =back
9325
9326 =back
9327
9328 catdir
9329
9330 catfile
9331
9332 curdir
9333
9334 rootdir
9335
9336 updir
9337
9338 =over 4
9339
9340 =item SelfLoaded methods
9341
9342 c_o (o)
9343
9344 =back
9345
9346 cflags (o)
9347
9348 clean (o)
9349
9350 const_cccmd (o)
9351
9352 const_config (o)
9353
9354 const_loadlibs (o)
9355
9356 constants (o)
9357
9358 depend (o)
9359
9360 dir_target (o)
9361
9362 dist (o)
9363
9364 dist_basics (o)
9365
9366 dist_ci (o)
9367
9368 dist_core (o)
9369
9370 dist_dir (o)
9371
9372 dist_test (o)
9373
9374 dlsyms (o)
9375
9376 dynamic (o)
9377
9378 dynamic_bs (o)
9379
9380 dynamic_lib (o)
9381
9382 exescan
9383
9384 extliblist
9385
9386 file_name_is_absolute
9387
9388 find_perl
9389
9390 =over 4
9391
9392 =item Methods to actually produce chunks of text for the Makefile
9393
9394 fixin
9395
9396 =back
9397
9398 force (o)
9399
9400 guess_name
9401
9402 has_link_code
9403
9404 htmlifypods (o)
9405
9406 init_dirscan
9407
9408 init_main
9409
9410 init_others
9411
9412 install (o)
9413
9414 installbin (o)
9415
9416 libscan (o)
9417
9418 linkext (o)
9419
9420 lsdir
9421
9422 macro (o)
9423
9424 makeaperl (o)
9425
9426 makefile (o)
9427
9428 manifypods (o)
9429
9430 maybe_command
9431
9432 maybe_command_in_dirs
9433
9434 needs_linking (o)
9435
9436 nicetext
9437
9438 parse_version
9439
9440 parse_abstract
9441
9442 pasthru (o)
9443
9444 path
9445
9446 perl_script
9447
9448 perldepend (o)
9449
9450 ppd
9451
9452 perm_rw (o)
9453
9454 perm_rwx (o)
9455
9456 pm_to_blib
9457
9458 post_constants (o)
9459
9460 post_initialize (o)
9461
9462 postamble (o)
9463
9464 prefixify
9465
9466 processPL (o)
9467
9468 realclean (o)
9469
9470 replace_manpage_separator
9471
9472 static (o)
9473
9474 static_lib (o)
9475
9476 staticmake (o)
9477
9478 subdir_x (o)
9479
9480 subdirs (o)
9481
9482 test (o)
9483
9484 test_via_harness (o)
9485
9486 test_via_script (o)
9487
9488 tool_autosplit (o)
9489
9490 tools_other (o)
9491
9492 tool_xsubpp (o)
9493
9494 top_targets (o)
9495
9496 writedoc
9497
9498 xs_c (o)
9499
9500 xs_cpp (o)
9501
9502 xs_o (o)
9503
9504 perl_archive
9505
9506 perl_archive_after
9507
9508 export_list
9509
9510 =over 4
9511
9512 =item SEE ALSO
9513
9514 =back
9515
9516 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
9517 ExtUtils::MakeMaker
9518
9519 =over 4
9520
9521 =item SYNOPSIS
9522
9523 =item DESCRIPTION
9524
9525 =over 4
9526
9527 =item Methods always loaded
9528
9529 wraplist
9530
9531 =back
9532
9533 =back
9534
9535 rootdir (override)
9536
9537 =over 4
9538
9539 =item SelfLoaded methods
9540
9541 guess_name (override)
9542
9543 =back
9544
9545 find_perl (override)
9546
9547 path (override)
9548
9549 maybe_command (override)
9550
9551 maybe_command_in_dirs (override)
9552
9553 perl_script (override)
9554
9555 file_name_is_absolute (override)
9556
9557 replace_manpage_separator
9558
9559 init_others (override)
9560
9561 constants (override)
9562
9563 cflags (override)
9564
9565 const_cccmd (override)
9566
9567 pm_to_blib (override)
9568
9569 tool_autosplit (override)
9570
9571 tool_sxubpp (override)
9572
9573 xsubpp_version (override)
9574
9575 tools_other (override)
9576
9577 dist (override)
9578
9579 c_o (override)
9580
9581 xs_c (override)
9582
9583 xs_o (override)
9584
9585 top_targets (override)
9586
9587 dlsyms (override)
9588
9589 dynamic_lib (override)
9590
9591 dynamic_bs (override)
9592
9593 static_lib (override)
9594
9595 manifypods (override)
9596
9597 processPL (override)
9598
9599 installbin (override)
9600
9601 subdir_x (override)
9602
9603 clean (override)
9604
9605 realclean (override)
9606
9607 dist_basics (override)
9608
9609 dist_core (override)
9610
9611 dist_dir (override)
9612
9613 dist_test (override)
9614
9615 install (override)
9616
9617 perldepend (override)
9618
9619 makefile (override)
9620
9621 test (override)
9622
9623 test_via_harness (override)
9624
9625 test_via_script (override)
9626
9627 makeaperl (override)
9628
9629 nicetext (override)
9630
9631 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
9632 ExtUtils::MakeMaker
9633
9634 =over 4
9635
9636 =item SYNOPSIS
9637
9638 =item DESCRIPTION
9639
9640 =back
9641
9642 catfile
9643
9644 constants (o)
9645
9646 static_lib (o)
9647
9648 dynamic_bs (o)
9649
9650 dynamic_lib (o)
9651
9652 canonpath
9653
9654 perl_script
9655
9656 pm_to_blib
9657
9658 test_via_harness (o)
9659
9660 tool_autosplit (override)
9661
9662 tools_other (o)
9663
9664 xs_o (o)
9665
9666 top_targets (o)
9667
9668 htmlifypods (o)
9669
9670 manifypods (o)
9671
9672 dist_ci (o)
9673
9674 dist_core (o)
9675
9676 pasthru (o)
9677
9678 =head2 ExtUtils::MakeMaker - create an extension Makefile
9679
9680 =over 4
9681
9682 =item SYNOPSIS
9683
9684 =item DESCRIPTION
9685
9686 =over 4
9687
9688 =item How To Write A Makefile.PL
9689
9690 =item Default Makefile Behaviour
9691
9692 =item make test
9693
9694 =item make testdb
9695
9696 =item make install
9697
9698 =item PREFIX and LIB attribute
9699
9700 =item AFS users
9701
9702 =item Static Linking of a new Perl Binary
9703
9704 =item Determination of Perl Library and Installation Locations
9705
9706 =item Which architecture dependent directory?
9707
9708 =item Using Attributes and Parameters
9709
9710 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
9711 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
9712 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
9713 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
9714 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
9715 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
9716 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
9717 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
9718 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
9719 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
9720 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
9721 PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX,
9722 PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
9723 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION,
9724 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
9725
9726 =item Additional lowercase attributes
9727
9728 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
9729 tool_autosplit
9730
9731 =item Overriding MakeMaker Methods
9732
9733 =item Hintsfile support
9734
9735 =item Distribution Support
9736
9737    make distcheck,    make skipcheck,    make distclean,    make manifest,
9738   make distdir,    make tardist,    make dist,    make uutardist,    make
9739 shdist,    make zipdist,    make ci
9740
9741 =item Disabling an extension
9742
9743 =back
9744
9745 =item ENVIRONMENT
9746
9747 PERL_MM_OPT
9748
9749 =item SEE ALSO
9750
9751 =item AUTHORS
9752
9753 =back
9754
9755 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
9756
9757 =over 4
9758
9759 =item SYNOPSIS
9760
9761 =item DESCRIPTION
9762
9763 =item MANIFEST.SKIP
9764
9765 =item EXPORT_OK
9766
9767 =item GLOBAL VARIABLES
9768
9769 =item DIAGNOSTICS
9770
9771 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
9772 C<Added to MANIFEST:> I<file>
9773
9774 =item ENVIRONMENT
9775
9776 B<PERL_MM_MANIFEST_DEBUG>
9777
9778 =item SEE ALSO
9779
9780 =item AUTHOR
9781
9782 =back
9783
9784 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
9785
9786 =over 4
9787
9788 =item SYNOPSIS
9789
9790 =item DESCRIPTION
9791
9792 =item SEE ALSO
9793
9794 =back
9795
9796 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
9797
9798 =over 4
9799
9800 =item SYNOPSIS
9801
9802 =item DESCRIPTION
9803
9804 =back
9805
9806 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
9807 extension
9808
9809 =over 4
9810
9811 =item SYNOPSIS
9812
9813 =item DESCRIPTION
9814
9815 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
9816
9817 =item AUTHOR
9818
9819 =item REVISION
9820
9821 =back
9822
9823 =head2 ExtUtils::Packlist - manage .packlist files
9824
9825 =over 4
9826
9827 =item SYNOPSIS
9828
9829 =item DESCRIPTION
9830
9831 =item USAGE
9832
9833 =item FUNCTIONS
9834
9835 new(), read(), write(), validate(), packlist_file()
9836
9837 =item EXAMPLE
9838
9839 =item AUTHOR
9840
9841 =back
9842
9843 =head2 ExtUtils::testlib - add blib/* directories to @INC
9844
9845 =over 4
9846
9847 =item SYNOPSIS
9848
9849 =item DESCRIPTION
9850
9851 =back
9852
9853 =head2 Fatal - replace functions with equivalents which succeed or die
9854
9855 =over 4
9856
9857 =item SYNOPSIS
9858
9859 =item DESCRIPTION
9860
9861 =item AUTHOR
9862
9863 =back
9864
9865 =head2 Fcntl - load the C Fcntl.h defines
9866
9867 =over 4
9868
9869 =item SYNOPSIS
9870
9871 =item DESCRIPTION
9872
9873 =item NOTE
9874
9875 =item EXPORTED SYMBOLS
9876
9877 =back
9878
9879 =head2 File::Basename, fileparse - split a pathname into pieces
9880
9881 =over 4
9882
9883 =item SYNOPSIS
9884
9885 =item DESCRIPTION
9886
9887 fileparse_set_fstype, fileparse
9888
9889 =item EXAMPLES
9890
9891 C<basename>, C<dirname>
9892
9893 =back
9894
9895 =head2 File::CheckTree, validate - run many filetest checks on a tree
9896
9897 =over 4
9898
9899 =item SYNOPSIS
9900
9901 =item DESCRIPTION
9902
9903 =back
9904
9905 =head2 File::Compare - Compare files or filehandles
9906
9907 =over 4
9908
9909 =item SYNOPSIS
9910
9911 =item DESCRIPTION
9912
9913 =item RETURN
9914
9915 =item AUTHOR
9916
9917 =back
9918
9919 =head2 File::Copy - Copy files or filehandles
9920
9921 =over 4
9922
9923 =item SYNOPSIS
9924
9925 =item DESCRIPTION
9926
9927 =over 4
9928
9929 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
9930
9931 rmscopy($from,$to[,$date_flag])
9932
9933 =back
9934
9935 =item RETURN
9936
9937 =item AUTHOR
9938
9939 =back
9940
9941 =head2 File::DosGlob - DOS like globbing and then some
9942
9943 =over 4
9944
9945 =item SYNOPSIS
9946
9947 =item DESCRIPTION
9948
9949 =item EXPORTS (by request only)
9950
9951 =item BUGS
9952
9953 =item AUTHOR
9954
9955 =item HISTORY
9956
9957 =item SEE ALSO
9958
9959 =back
9960
9961 =head2 File::Find, find - traverse a file tree
9962
9963 =over 4
9964
9965 =item SYNOPSIS
9966
9967 =item DESCRIPTION
9968
9969 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
9970 C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>,
9971 C<untaint_pattern>, C<untaint_skip>
9972
9973 =item CAVEAT
9974
9975 =back
9976
9977 =head2 File::Glob - Perl extension for BSD glob routine
9978
9979 =over 4
9980
9981 =item SYNOPSIS
9982
9983 =item DESCRIPTION
9984
9985 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
9986 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
9987 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
9988
9989 =item DIAGNOSTICS
9990
9991 C<GLOB_NOSPACE>, C<GLOB_ABEND>
9992
9993 =item NOTES
9994
9995 =item AUTHOR
9996
9997 =back
9998
9999 =head2 File::Path - create or remove directory trees
10000
10001 =over 4
10002
10003 =item SYNOPSIS
10004
10005 =item DESCRIPTION
10006
10007 =item AUTHORS
10008
10009 =back
10010
10011 =head2 File::Spec - portably perform operations on file names
10012
10013 =over 4
10014
10015 =item SYNOPSIS
10016
10017 =item DESCRIPTION
10018
10019 =item SEE ALSO
10020
10021 =item AUTHORS
10022
10023 =back
10024
10025 =head2 File::Spec::Epoc - methods for Epoc file specs
10026
10027 =over 4
10028
10029 =item SYNOPSIS
10030
10031 =item DESCRIPTION
10032
10033 devnull
10034
10035 =back
10036
10037 tmpdir
10038
10039 path
10040
10041 canonpath
10042
10043 splitpath
10044
10045 splitdir
10046
10047 catpath
10048
10049 abs2rel
10050
10051 rel2abs
10052
10053 =over 4
10054
10055 =item SEE ALSO
10056
10057 =back
10058
10059 =head2 File::Spec::Functions - portably perform operations on file names
10060
10061 =over 4
10062
10063 =item SYNOPSIS
10064
10065 =item DESCRIPTION
10066
10067 =over 4
10068
10069 =item Exports
10070
10071 =back
10072
10073 =item SEE ALSO
10074
10075 =back
10076
10077 =head2 File::Spec::Mac - File::Spec for MacOS
10078
10079 =over 4
10080
10081 =item SYNOPSIS
10082
10083 =item DESCRIPTION
10084
10085 =item METHODS
10086
10087 canonpath
10088
10089 =back
10090
10091 catdir
10092
10093 catfile
10094
10095 curdir
10096
10097 devnull
10098
10099 rootdir
10100
10101 tmpdir
10102
10103 updir
10104
10105 file_name_is_absolute
10106
10107 path
10108
10109 splitpath
10110
10111 splitdir
10112
10113 catpath
10114
10115 abs2rel
10116
10117 rel2abs
10118
10119 =over 4
10120
10121 =item SEE ALSO
10122
10123 =back
10124
10125 =head2 File::Spec::OS2 - methods for OS/2 file specs
10126
10127 =over 4
10128
10129 =item SYNOPSIS
10130
10131 =item DESCRIPTION
10132
10133 =back
10134
10135 =head2 File::Spec::Unix - methods used by File::Spec
10136
10137 =over 4
10138
10139 =item SYNOPSIS
10140
10141 =item DESCRIPTION
10142
10143 =item METHODS
10144
10145 canonpath
10146
10147 =back
10148
10149 catdir
10150
10151 catfile
10152
10153 curdir
10154
10155 devnull
10156
10157 rootdir
10158
10159 tmpdir
10160
10161 updir
10162
10163 no_upwards
10164
10165 case_tolerant
10166
10167 file_name_is_absolute
10168
10169 path
10170
10171 join
10172
10173 splitpath
10174
10175 splitdir
10176
10177 catpath
10178
10179 abs2rel
10180
10181 rel2abs
10182
10183 =over 4
10184
10185 =item SEE ALSO
10186
10187 =back
10188
10189 =head2 File::Spec::VMS - methods for VMS file specs
10190
10191 =over 4
10192
10193 =item SYNOPSIS
10194
10195 =item DESCRIPTION
10196
10197 eliminate_macros
10198
10199 =back
10200
10201 fixpath
10202
10203 =over 4
10204
10205 =item Methods always loaded
10206
10207 canonpath (override)
10208
10209 =back
10210
10211 catdir
10212
10213 catfile
10214
10215 curdir (override)
10216
10217 devnull (override)
10218
10219 rootdir (override)
10220
10221 tmpdir (override)
10222
10223 updir (override)
10224
10225 case_tolerant (override)
10226
10227 path (override)
10228
10229 file_name_is_absolute (override)
10230
10231 splitpath (override)
10232
10233 splitdir (override)
10234
10235 catpath (override)
10236
10237 abs2rel (override)
10238
10239 rel2abs (override)
10240
10241 =over 4
10242
10243 =item SEE ALSO
10244
10245 =back
10246
10247 =head2 File::Spec::Win32 - methods for Win32 file specs
10248
10249 =over 4
10250
10251 =item SYNOPSIS
10252
10253 =item DESCRIPTION
10254
10255 devnull
10256
10257 =back
10258
10259 tmpdir
10260
10261 catfile
10262
10263 canonpath
10264
10265 splitpath
10266
10267 splitdir
10268
10269 catpath
10270
10271 =over 4
10272
10273 =item SEE ALSO
10274
10275 =back
10276
10277 =head2 File::Temp - return name and handle of a temporary file safely
10278
10279 =over 4
10280
10281 =item PORTABILITY
10282
10283 =item SYNOPSIS
10284
10285 =item DESCRIPTION
10286
10287 =back
10288
10289 =over 4
10290
10291 =item FUNCTIONS
10292
10293 B<tempfile>
10294
10295 =back
10296
10297 B<tempdir>
10298
10299 =over 4
10300
10301 =item MKTEMP FUNCTIONS
10302
10303 B<mkstemp>
10304
10305 =back
10306
10307 B<mkstemps>
10308
10309 B<mkdtemp>
10310
10311 B<mktemp>
10312
10313 =over 4
10314
10315 =item POSIX FUNCTIONS
10316
10317 B<tmpnam>
10318
10319 =back
10320
10321 B<tmpfile>
10322
10323 =over 4
10324
10325 =item ADDITIONAL FUNCTIONS
10326
10327 B<tempnam>
10328
10329 =back
10330
10331 =over 4
10332
10333 =item UTILITY FUNCTIONS
10334
10335 B<unlink0>
10336
10337 =back
10338
10339 =over 4
10340
10341 =item PACKAGE VARIABLES
10342
10343 B<safe_level>, STANDARD, MEDIUM, HIGH
10344
10345 =back
10346
10347 TopSystemUID
10348
10349 =over 4
10350
10351 =item WARNING
10352
10353 =over 4
10354
10355 =item Temporary files and NFS
10356
10357 =back
10358
10359 =item HISTORY
10360
10361 =item SEE ALSO
10362
10363 =item AUTHOR
10364
10365 =back
10366
10367 =head2 File::stat - by-name interface to Perl's built-in stat() functions
10368
10369 =over 4
10370
10371 =item SYNOPSIS
10372
10373 =item DESCRIPTION
10374
10375 =item NOTE
10376
10377 =item AUTHOR
10378
10379 =back
10380
10381 =head2 FileCache - keep more files open than the system permits
10382
10383 =over 4
10384
10385 =item SYNOPSIS
10386
10387 =item DESCRIPTION
10388
10389 =item BUGS
10390
10391 =back
10392
10393 =head2 FileHandle - supply object methods for filehandles
10394
10395 =over 4
10396
10397 =item SYNOPSIS
10398
10399 =item DESCRIPTION
10400
10401 $fh->print, $fh->printf, $fh->getline, $fh->getlines
10402
10403 =item SEE ALSO
10404
10405 =back
10406
10407 =head2 Filter::Simple - Simplified source filtering
10408
10409 =over 4
10410
10411 =item SYNOPSIS
10412
10413 =item DESCRIPTION
10414
10415 =over 4
10416
10417 =item The Problem
10418
10419 =item A Solution
10420
10421 =item How it works
10422
10423 =back
10424
10425 =item AUTHOR
10426
10427 =item COPYRIGHT
10428
10429 =back
10430
10431 =head2 Filter::Util::Call - Perl Source Filter Utility Module
10432
10433 =over 4
10434
10435 =item SYNOPSIS
10436
10437 =item DESCRIPTION
10438
10439 =over 4
10440
10441 =item B<use Filter::Util::Call>
10442
10443 =item B<import()>
10444
10445 =item B<filter() and anonymous sub>
10446
10447 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
10448
10449 =back
10450
10451 =item EXAMPLES
10452
10453 =over 4
10454
10455 =item Example 1: A simple filter.
10456
10457 =item Example 2: Using the context
10458
10459 =item Example 3: Using the context within the filter
10460
10461 =item Example 4: Using filter_del
10462
10463 =back
10464
10465 =item Filter::Simple
10466
10467 =item AUTHOR
10468
10469 =item DATE
10470
10471 =back
10472
10473 =head2 FindBin - Locate directory of original perl script
10474
10475 =over 4
10476
10477 =item SYNOPSIS
10478
10479 =item DESCRIPTION
10480
10481 =item EXPORTABLE VARIABLES
10482
10483 =item KNOWN BUGS
10484
10485 =item AUTHORS
10486
10487 =item COPYRIGHT
10488
10489 =back
10490
10491 =head2 GDBM_File - Perl5 access to the gdbm library.
10492
10493 =over 4
10494
10495 =item SYNOPSIS
10496
10497 =item DESCRIPTION
10498
10499 =item AVAILABILITY
10500
10501 =item BUGS
10502
10503 =item SEE ALSO
10504
10505 =back
10506
10507 =head2 Getopt::Long - Extended processing of command line options
10508
10509 =over 4
10510
10511 =item SYNOPSIS
10512
10513 =item DESCRIPTION
10514
10515 =item Command Line Options, an Introduction
10516
10517 =item Getting Started with Getopt::Long
10518
10519 =over 4
10520
10521 =item Simple options
10522
10523 =item A little bit less simple options
10524
10525 =item Mixing command line option with other arguments
10526
10527 =item Options with values
10528
10529 =item Options with multiple values
10530
10531 =item Options with hash values
10532
10533 =item User-defined subroutines to handle options
10534
10535 =item Options with multiple names
10536
10537 =item Case and abbreviations
10538
10539 =item Summary of Option Specifications
10540
10541 !, +, s, i, f, : I<type> [ I<desttype> ]
10542
10543 =back
10544
10545 =item Advanced Possibilities
10546
10547 =over 4
10548
10549 =item Object oriented interface
10550
10551 =item Documentation and help texts
10552
10553 =item Storing options in a hash
10554
10555 =item Bundling
10556
10557 =item The lonesome dash
10558
10559 =item Argument call-back
10560
10561 =back
10562
10563 =item Configuring Getopt::Long
10564
10565 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
10566 require_order, permute, bundling (default: disabled), bundling_override
10567 (default: disabled), ignore_case  (default: enabled), ignore_case_always
10568 (default: disabled), pass_through (default: disabled), prefix,
10569 prefix_pattern, debug (default: disabled)
10570
10571 =item Return values and Errors
10572
10573 =item Legacy
10574
10575 =over 4
10576
10577 =item Default destinations
10578
10579 =item Alternative option starters
10580
10581 =item Configuration variables
10582
10583 =back
10584
10585 =item Trouble Shooting
10586
10587 =over 4
10588
10589 =item Warning: Ignoring '!' modifier for short option
10590
10591 =item GetOptions does not return a false result when an option is not
10592 supplied
10593
10594 =back
10595
10596 =item AUTHOR
10597
10598 =item COPYRIGHT AND DISCLAIMER
10599
10600 =back
10601
10602 =head2 Getopt::Std, getopt - Process single-character switches with switch
10603 clustering
10604
10605 =over 4
10606
10607 =item SYNOPSIS
10608
10609 =item DESCRIPTION
10610
10611 =back
10612
10613 =head2 I18N::Collate - compare 8-bit scalar data according to the current
10614 locale
10615
10616 =over 4
10617
10618 =item SYNOPSIS
10619
10620 =item DESCRIPTION
10621
10622 =back
10623
10624 =head2 IO - load various IO modules
10625
10626 =over 4
10627
10628 =item SYNOPSIS
10629
10630 =item DESCRIPTION
10631
10632 =back
10633
10634 =head2 IO::Dir - supply object methods for directory handles
10635
10636 =over 4
10637
10638 =item SYNOPSIS
10639
10640 =item DESCRIPTION
10641
10642 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10643 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10644
10645 =item SEE ALSO
10646
10647 =item AUTHOR
10648
10649 =item COPYRIGHT
10650
10651 =back
10652
10653 =head2 IO::File - supply object methods for filehandles
10654
10655 =over 4
10656
10657 =item SYNOPSIS
10658
10659 =item DESCRIPTION
10660
10661 =item CONSTRUCTOR
10662
10663 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10664
10665 =item METHODS
10666
10667 open( FILENAME [,MODE [,PERMS]] )
10668
10669 =item SEE ALSO
10670
10671 =item HISTORY
10672
10673 =back
10674
10675 =head2 IO::Handle - supply object methods for I/O handles
10676
10677 =over 4
10678
10679 =item SYNOPSIS
10680
10681 =item DESCRIPTION
10682
10683 =item CONSTRUCTOR
10684
10685 new (), new_from_fd ( FD, MODE )
10686
10687 =item METHODS
10688
10689 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10690 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10691 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10692 $io->blocking ( [ BOOL ] ), $io->untaint
10693
10694 =item NOTE
10695
10696 =item SEE ALSO
10697
10698 =item BUGS
10699
10700 =item HISTORY
10701
10702 =back
10703
10704 =head2 IO::Pipe - supply object methods for pipes
10705
10706 =over 4
10707
10708 =item SYNOPSIS
10709
10710 =item DESCRIPTION
10711
10712 =item CONSTRUCTOR
10713
10714 new ( [READER, WRITER] )
10715
10716 =item METHODS
10717
10718 reader ([ARGS]), writer ([ARGS]), handles ()
10719
10720 =item SEE ALSO
10721
10722 =item AUTHOR
10723
10724 =item COPYRIGHT
10725
10726 =back
10727
10728 =head2 IO::Poll - Object interface to system poll call
10729
10730 =over 4
10731
10732 =item SYNOPSIS
10733
10734 =item DESCRIPTION
10735
10736 =item METHODS
10737
10738 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10739 IO ), handles( [ EVENT_MASK ] )
10740
10741 =item SEE ALSO
10742
10743 =item AUTHOR
10744
10745 =item COPYRIGHT
10746
10747 =back
10748
10749 =head2 IO::Seekable - supply seek based methods for I/O objects
10750
10751 =over 4
10752
10753 =item SYNOPSIS
10754
10755 =item DESCRIPTION
10756
10757 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10758 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10759 $io->tell
10760
10761 =item SEE ALSO
10762
10763 =item HISTORY
10764
10765 =back
10766
10767 =head2 IO::Select - OO interface to the select system call
10768
10769 =over 4
10770
10771 =item SYNOPSIS
10772
10773 =item DESCRIPTION
10774
10775 =item CONSTRUCTOR
10776
10777 new ( [ HANDLES ] )
10778
10779 =item METHODS
10780
10781 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
10782 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
10783 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
10784
10785 =item EXAMPLE
10786
10787 =item AUTHOR
10788
10789 =item COPYRIGHT
10790
10791 =back
10792
10793 =head2 IO::Socket - Object interface to socket communications
10794
10795 =over 4
10796
10797 =item SYNOPSIS
10798
10799 =item DESCRIPTION
10800
10801 =item CONSTRUCTOR
10802
10803 new ( [ARGS] )
10804
10805 =item METHODS
10806
10807 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
10808 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
10809
10810 =item SEE ALSO
10811
10812 =item AUTHOR
10813
10814 =item COPYRIGHT
10815
10816 =back
10817
10818 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
10819
10820 =over 4
10821
10822 =item SYNOPSIS
10823
10824 =item DESCRIPTION
10825
10826 =item CONSTRUCTOR
10827
10828 new ( [ARGS] )
10829
10830 =over 4
10831
10832 =item METHODS
10833
10834 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
10835 ()
10836
10837 =back
10838
10839 =item SEE ALSO
10840
10841 =item AUTHOR
10842
10843 =item COPYRIGHT
10844
10845 =back
10846
10847 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
10848
10849 =over 4
10850
10851 =item SYNOPSIS
10852
10853 =item DESCRIPTION
10854
10855 =item CONSTRUCTOR
10856
10857 new ( [ARGS] )
10858
10859 =item METHODS
10860
10861 hostpath(), peerpath()
10862
10863 =item SEE ALSO
10864
10865 =item AUTHOR
10866
10867 =item COPYRIGHT
10868
10869 =back
10870
10871 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
10872 handles
10873
10874 =over 4
10875
10876 =item SYNOPSIS
10877
10878 =item DESCRIPTION
10879
10880 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10881 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10882
10883 =item SEE ALSO
10884
10885 =item AUTHOR
10886
10887 =item COPYRIGHT
10888
10889 =back
10890
10891 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
10892
10893 =over 4
10894
10895 =item SYNOPSIS
10896
10897 =item DESCRIPTION
10898
10899 =item CONSTRUCTOR
10900
10901 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10902
10903 =item METHODS
10904
10905 open( FILENAME [,MODE [,PERMS]] )
10906
10907 =item SEE ALSO
10908
10909 =item HISTORY
10910
10911 =back
10912
10913 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
10914 handles
10915
10916 =over 4
10917
10918 =item SYNOPSIS
10919
10920 =item DESCRIPTION
10921
10922 =item CONSTRUCTOR
10923
10924 new (), new_from_fd ( FD, MODE )
10925
10926 =item METHODS
10927
10928 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10929 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10930 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10931 $io->blocking ( [ BOOL ] ), $io->untaint
10932
10933 =item NOTE
10934
10935 =item SEE ALSO
10936
10937 =item BUGS
10938
10939 =item HISTORY
10940
10941 =back
10942
10943 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
10944
10945 =over 4
10946
10947 =item SYNOPSIS
10948
10949 =item DESCRIPTION
10950
10951 =item CONSTRUCTOR
10952
10953 new ( [READER, WRITER] )
10954
10955 =item METHODS
10956
10957 reader ([ARGS]), writer ([ARGS]), handles ()
10958
10959 =item SEE ALSO
10960
10961 =item AUTHOR
10962
10963 =item COPYRIGHT
10964
10965 =back
10966
10967 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
10968
10969 =over 4
10970
10971 =item SYNOPSIS
10972
10973 =item DESCRIPTION
10974
10975 =item METHODS
10976
10977 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10978 IO ), handles( [ EVENT_MASK ] )
10979
10980 =item SEE ALSO
10981
10982 =item AUTHOR
10983
10984 =item COPYRIGHT
10985
10986 =back
10987
10988 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
10989 I/O objects
10990
10991 =over 4
10992
10993 =item SYNOPSIS
10994
10995 =item DESCRIPTION
10996
10997 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10998 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10999 $io->tell
11000
11001 =item SEE ALSO
11002
11003 =item HISTORY
11004
11005 =back
11006
11007 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
11008 call
11009
11010 =over 4
11011
11012 =item SYNOPSIS
11013
11014 =item DESCRIPTION
11015
11016 =item CONSTRUCTOR
11017
11018 new ( [ HANDLES ] )
11019
11020 =item METHODS
11021
11022 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
11023 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
11024 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
11025
11026 =item EXAMPLE
11027
11028 =item AUTHOR
11029
11030 =item COPYRIGHT
11031
11032 =back
11033
11034 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
11035 communications
11036
11037 =over 4
11038
11039 =item SYNOPSIS
11040
11041 =item DESCRIPTION
11042
11043 =item CONSTRUCTOR
11044
11045 new ( [ARGS] )
11046
11047 =item METHODS
11048
11049 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
11050 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
11051
11052 =item SEE ALSO
11053
11054 =item AUTHOR
11055
11056 =item COPYRIGHT
11057
11058 =back
11059
11060 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
11061 AF_INET domain sockets
11062
11063 =over 4
11064
11065 =item SYNOPSIS
11066
11067 =item DESCRIPTION
11068
11069 =item CONSTRUCTOR
11070
11071 new ( [ARGS] )
11072
11073 =over 4
11074
11075 =item METHODS
11076
11077 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
11078 ()
11079
11080 =back
11081
11082 =item SEE ALSO
11083
11084 =item AUTHOR
11085
11086 =item COPYRIGHT
11087
11088 =back
11089
11090 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
11091 AF_UNIX domain sockets
11092
11093 =over 4
11094
11095 =item SYNOPSIS
11096
11097 =item DESCRIPTION
11098
11099 =item CONSTRUCTOR
11100
11101 new ( [ARGS] )
11102
11103 =item METHODS
11104
11105 hostpath(), peerpath()
11106
11107 =item SEE ALSO
11108
11109 =item AUTHOR
11110
11111 =item COPYRIGHT
11112
11113 =back
11114
11115 =head2 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::Open2, open2 - open a process for both reading and writing
11138
11139 =over 4
11140
11141 =item SYNOPSIS
11142
11143 =item DESCRIPTION
11144
11145 =item WARNING
11146
11147 =item SEE ALSO
11148
11149 =back
11150
11151 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
11152 handling
11153
11154 =over 4
11155
11156 =item SYNOPSIS
11157
11158 =item DESCRIPTION
11159
11160 =item WARNING
11161
11162 =back
11163
11164 =head2 IPC::Semaphore - SysV Semaphore IPC object class
11165
11166 =over 4
11167
11168 =item SYNOPSIS
11169
11170 =item DESCRIPTION
11171
11172 =item METHODS
11173
11174 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
11175 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
11176 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
11177 , VALUE ), stat
11178
11179 =item SEE ALSO
11180
11181 =item AUTHOR
11182
11183 =item COPYRIGHT
11184
11185 =back
11186
11187 =head2 IPC::SysV - SysV IPC constants
11188
11189 =over 4
11190
11191 =item SYNOPSIS
11192
11193 =item DESCRIPTION
11194
11195 ftok( PATH, ID )
11196
11197 =item SEE ALSO
11198
11199 =item AUTHORS
11200
11201 =item COPYRIGHT
11202
11203 =back
11204
11205 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
11206
11207 =over 4
11208
11209 =item SYNOPSIS
11210
11211 =item DESCRIPTION
11212
11213 =item METHODS
11214
11215 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
11216 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
11217 FLAGS ] ), stat
11218
11219 =item SEE ALSO
11220
11221 =item AUTHOR
11222
11223 =item COPYRIGHT
11224
11225 =back
11226
11227 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
11228 class
11229
11230 =over 4
11231
11232 =item SYNOPSIS
11233
11234 =item DESCRIPTION
11235
11236 =item METHODS
11237
11238 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
11239 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
11240 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
11241 , VALUE ), stat
11242
11243 =item SEE ALSO
11244
11245 =item AUTHOR
11246
11247 =item COPYRIGHT
11248
11249 =back
11250
11251 =head2 List::Util - A selection of general-utility list subroutines
11252
11253 =over 4
11254
11255 =item SYNOPSIS
11256
11257 =item DESCRIPTION
11258
11259 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
11260 BLOCK LIST, sum LIST
11261
11262 =item SUGGESTED ADDITIONS
11263
11264 =item COPYRIGHT
11265
11266 =back
11267
11268 =head2 List::Utilib::List::Util, List::Util - A selection of
11269 general-utility list subroutines
11270
11271 =over 4
11272
11273 =item SYNOPSIS
11274
11275 =item DESCRIPTION
11276
11277 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
11278 BLOCK LIST, sum LIST
11279
11280 =item SUGGESTED ADDITIONS
11281
11282 =item COPYRIGHT
11283
11284 =back
11285
11286 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
11287 general-utility scalar subroutines
11288
11289 =over 4
11290
11291 =item SYNOPSIS
11292
11293 =item DESCRIPTION
11294
11295 blessed EXPR, dualvar NUM, STRING, isweak EXPR, reftype EXPR, weaken REF
11296
11297 =item COPYRIGHT
11298
11299 =item BLATANT PLUG
11300
11301 =back
11302
11303 =head2 Locale::Constants - constants for Locale codes
11304
11305 =over 4
11306
11307 =item SYNOPSIS
11308
11309 =item DESCRIPTION
11310
11311 =item KNOWN BUGS AND LIMITATIONS
11312
11313 =item SEE ALSO
11314
11315 Locale::Language, Locale::Country, Locale::Currency
11316
11317 =item AUTHOR
11318
11319 =item COPYRIGHT
11320
11321 =back
11322
11323 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
11324
11325 =over 4
11326
11327 =item SYNOPSIS
11328
11329 =back
11330
11331 =over 4
11332
11333 =item DESCRIPTION
11334
11335 B<alpha-2>, B<alpha-3>, B<numeric>
11336
11337 =back
11338
11339 =over 4
11340
11341 =item CONVERSION ROUTINES
11342
11343 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
11344 country_code2code( CODE, CODESET, CODESET )
11345
11346 =back
11347
11348 =over 4
11349
11350 =item QUERY ROUTINES
11351
11352 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
11353
11354 =back
11355
11356 =over 4
11357
11358 =item CODE ALIASING
11359
11360 =back
11361
11362 =over 4
11363
11364 =item EXAMPLES
11365
11366 =item DOMAIN NAMES
11367
11368 =item KNOWN BUGS AND LIMITATIONS
11369
11370 =item SEE ALSO
11371
11372 Locale::Language, Locale::Currency, ISO 3166,
11373 http://www.din.de/gremien/nas/nabd/iso3166ma/,
11374 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
11375 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
11376
11377 =item AUTHOR
11378
11379 =item COPYRIGHT
11380
11381 =back
11382
11383 =head2 Locale::Currency - ISO three letter codes for currency
11384 identification (ISO 4217)
11385
11386 =over 4
11387
11388 =item SYNOPSIS
11389
11390 =back
11391
11392 =over 4
11393
11394 =item DESCRIPTION
11395
11396 XTS, XXX
11397
11398 =back
11399
11400 =over 4
11401
11402 =item CONVERSION ROUTINES
11403
11404 code2currency(), currency2code()
11405
11406 =back
11407
11408 =over 4
11409
11410 =item QUERY ROUTINES
11411
11412 C<all_currency_codes()>, C<all_currency_names()>
11413
11414 =back
11415
11416 =over 4
11417
11418 =item EXAMPLES
11419
11420 =item KNOWN BUGS AND LIMITATIONS
11421
11422 =item SEE ALSO
11423
11424 Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
11425
11426 =item AUTHOR
11427
11428 =item COPYRIGHT
11429
11430 =back
11431
11432 =head2 Locale::Language - ISO two letter codes for language identification
11433 (ISO 639)
11434
11435 =over 4
11436
11437 =item SYNOPSIS
11438
11439 =back
11440
11441 =over 4
11442
11443 =item DESCRIPTION
11444
11445 =back
11446
11447 =over 4
11448
11449 =item CONVERSION ROUTINES
11450
11451 code2language(), language2code()
11452
11453 =back
11454
11455 =over 4
11456
11457 =item QUERY ROUTINES
11458
11459 C<all_language_codes()>, C<all_language_names()>
11460
11461 =back
11462
11463 =over 4
11464
11465 =item EXAMPLES
11466
11467 =item KNOWN BUGS AND LIMITATIONS
11468
11469 =item SEE ALSO
11470
11471 Locale::Country, Locale::Currency, ISO 639:1988 (E/F),
11472 http://lcweb.loc.gov/standards/iso639-2/langhome.html
11473
11474 =item AUTHOR
11475
11476 =item COPYRIGHT
11477
11478 =back
11479
11480 =head2 MIME::Base64 - Encoding and decoding of base64 strings
11481
11482 =over 4
11483
11484 =item SYNOPSIS
11485
11486 =item DESCRIPTION
11487
11488 encode_base64($str, [$eol]), decode_base64($str)
11489
11490 =item DIAGNOSTICS
11491
11492 Premature end of base64 data, Premature padding of base64 data
11493
11494 =item EXAMPLES
11495
11496 =item COPYRIGHT
11497
11498 =back
11499
11500 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
11501 of quoted-printable strings
11502
11503 =over 4
11504
11505 =item SYNOPSIS
11506
11507 =item DESCRIPTION
11508
11509 encode_qp($str), decode_qp($str);
11510
11511 =item COPYRIGHT
11512
11513 =back
11514
11515 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
11516 strings
11517
11518 =over 4
11519
11520 =item SYNOPSIS
11521
11522 =item DESCRIPTION
11523
11524 encode_qp($str), decode_qp($str);
11525
11526 =item COPYRIGHT
11527
11528 =back
11529
11530 =head2 Math::BigFloat - Arbitrary length float math package
11531
11532 =over 4
11533
11534 =item SYNOPSIS
11535
11536 =item DESCRIPTION
11537
11538 number format, Error returns 'NaN', Division is computed to, Rounding is
11539 performed
11540
11541 =item BUGS
11542
11543 =item AUTHOR
11544
11545 =back
11546
11547 =head2 Math::BigInt - Arbitrary size integer math package
11548
11549 =over 4
11550
11551 =item SYNOPSIS
11552
11553 =item DESCRIPTION
11554
11555 Canonical notation, Input, Output
11556
11557 =item EXAMPLES
11558
11559 =item Autocreating constants
11560
11561 =item BUGS
11562
11563 =item AUTHOR
11564
11565 =back
11566
11567 =head2 Math::Complex - complex numbers and associated mathematical
11568 functions
11569
11570 =over 4
11571
11572 =item SYNOPSIS
11573
11574 =item DESCRIPTION
11575
11576 =item OPERATIONS
11577
11578 =item CREATION
11579
11580 =item STRINGIFICATION
11581
11582 =over 4
11583
11584 =item CHANGED IN PERL 5.6
11585
11586 =back
11587
11588 =item USAGE
11589
11590 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
11591
11592 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
11593
11594 =item BUGS
11595
11596 =item AUTHORS
11597
11598 =back
11599
11600 =head2 Math::Trig - trigonometric functions
11601
11602 =over 4
11603
11604 =item SYNOPSIS
11605
11606 =item DESCRIPTION
11607
11608 =item TRIGONOMETRIC FUNCTIONS
11609
11610 B<tan>
11611
11612 =over 4
11613
11614 =item ERRORS DUE TO DIVISION BY ZERO
11615
11616 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
11617
11618 =back
11619
11620 =item PLANE ANGLE CONVERSIONS
11621
11622 =item RADIAL COORDINATE CONVERSIONS
11623
11624 =over 4
11625
11626 =item COORDINATE SYSTEMS
11627
11628 =item 3-D ANGLE CONVERSIONS
11629
11630 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
11631 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
11632
11633 =back
11634
11635 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
11636
11637 =item EXAMPLES
11638
11639 =over 4
11640
11641 =item CAVEAT FOR GREAT CIRCLE FORMULAS
11642
11643 =back
11644
11645 =item BUGS
11646
11647 =item AUTHORS
11648
11649 =back
11650
11651 =head2 NDBM_File - Tied access to ndbm files
11652
11653 =over 4
11654
11655 =item SYNOPSIS
11656
11657 =item DESCRIPTION
11658
11659 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
11660
11661 =item DIAGNOSTICS
11662
11663 =over 4
11664
11665 =item C<ndbm store returned -1, errno 22, key "..." at ...>
11666
11667 =back
11668
11669 =item BUGS AND WARNINGS
11670
11671 =back
11672
11673 =head2 Net::Ping - check a remote host for reachability
11674
11675 =over 4
11676
11677 =item SYNOPSIS
11678
11679 =item DESCRIPTION
11680
11681 icmp, udp, tcp, stream, external
11682
11683 =over 4
11684
11685 =item Functions
11686
11687 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
11688 $timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
11689
11690 =back
11691
11692 =item NOTES
11693
11694 =back
11695
11696 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
11697 functions
11698
11699 =over 4
11700
11701 =item SYNOPSIS
11702
11703 =item DESCRIPTION
11704
11705 =item EXAMPLES
11706
11707 =item NOTE
11708
11709 =item AUTHOR
11710
11711 =back
11712
11713 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
11714 functions
11715
11716 =over 4
11717
11718 =item SYNOPSIS
11719
11720 =item DESCRIPTION
11721
11722 =item EXAMPLES
11723
11724 =item NOTE
11725
11726 =item AUTHOR
11727
11728 =back
11729
11730 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
11731 functions
11732
11733 =over 4
11734
11735 =item SYNOPSIS
11736
11737 =item DESCRIPTION
11738
11739 =item NOTE
11740
11741 =item AUTHOR
11742
11743 =back
11744
11745 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
11746 functions
11747
11748 =over 4
11749
11750 =item SYNOPSIS
11751
11752 =item DESCRIPTION
11753
11754 =item EXAMPLES
11755
11756 =item NOTE
11757
11758 =item AUTHOR
11759
11760 =back
11761
11762 =head2 O - Generic interface to Perl Compiler backends
11763
11764 =over 4
11765
11766 =item SYNOPSIS
11767
11768 =item DESCRIPTION
11769
11770 =item CONVENTIONS
11771
11772 =item IMPLEMENTATION
11773
11774 =item AUTHOR
11775
11776 =back
11777
11778 =head2 ODBM_File - Tied access to odbm files
11779
11780 =over 4
11781
11782 =item SYNOPSIS
11783
11784 =item DESCRIPTION
11785
11786 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
11787
11788 =item DIAGNOSTICS
11789
11790 =over 4
11791
11792 =item C<odbm store returned -1, errno 22, key "..." at ...>
11793
11794 =back
11795
11796 =item BUGS AND WARNINGS
11797
11798 =back
11799
11800 =head2 Opcode - Disable named opcodes when compiling perl code
11801
11802 =over 4
11803
11804 =item SYNOPSIS
11805
11806 =item DESCRIPTION
11807
11808 =item NOTE
11809
11810 =item WARNING
11811
11812 =item Operator Names and Operator Lists
11813
11814 an operator name (opname), an operator tag name (optag), a negated opname
11815 or optag, an operator set (opset)
11816
11817 =item Opcode Functions
11818
11819 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
11820 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
11821 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
11822 opdump (PAT)
11823
11824 =item Manipulating Opsets
11825
11826 =item TO DO (maybe)
11827
11828 =back
11829
11830 =over 4
11831
11832 =item Predefined Opcode Tags
11833
11834 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
11835 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
11836 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
11837 :dangerous
11838
11839 =item SEE ALSO
11840
11841 =item AUTHORS
11842
11843 =back
11844
11845 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
11846 compartments
11847
11848 =over 4
11849
11850 =item SYNOPSIS
11851
11852 =item DESCRIPTION
11853
11854 a new namespace, an operator mask
11855
11856 =item WARNING
11857
11858 =over 4
11859
11860 =item RECENT CHANGES
11861
11862 =item Methods in class Safe
11863
11864 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
11865 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
11866 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
11867 root (NAMESPACE), mask (MASK)
11868
11869 =item Some Safety Issues
11870
11871 Memory, CPU, Snooping, Signals, State Changes
11872
11873 =item AUTHOR
11874
11875 =back
11876
11877 =back
11878
11879 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
11880 compiling
11881
11882 =over 4
11883
11884 =item SYNOPSIS
11885
11886 =item DESCRIPTION
11887
11888 =item SEE ALSO
11889
11890 =back
11891
11892 =head2 POSIX - Perl interface to IEEE Std 1003.1
11893
11894 =over 4
11895
11896 =item SYNOPSIS
11897
11898 =item DESCRIPTION
11899
11900 =item NOTE
11901
11902 =item CAVEATS
11903
11904 =item FUNCTIONS
11905
11906 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
11907 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
11908 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
11909 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
11910 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
11911 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
11912 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
11913 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
11914 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
11915 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
11916 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
11917 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
11918 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
11919 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
11920 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
11921 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
11922 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
11923 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
11924 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
11925 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
11926 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
11927 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
11928 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
11929 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
11930 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
11931 wctomb, write
11932
11933 =item CLASSES
11934
11935 =over 4
11936
11937 =item POSIX::SigAction
11938
11939 new
11940
11941 =item POSIX::SigSet
11942
11943 new, addset, delset, emptyset, fillset, ismember
11944
11945 =item POSIX::Termios
11946
11947 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
11948 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
11949 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
11950 field values, c_cflag field values, c_iflag field values, c_lflag field
11951 values, c_oflag field values
11952
11953 =back
11954
11955 =item PATHNAME CONSTANTS
11956
11957 Constants
11958
11959 =item POSIX CONSTANTS
11960
11961 Constants
11962
11963 =item SYSTEM CONFIGURATION
11964
11965 Constants
11966
11967 =item ERRNO
11968
11969 Constants
11970
11971 =item FCNTL
11972
11973 Constants
11974
11975 =item FLOAT
11976
11977 Constants
11978
11979 =item LIMITS
11980
11981 Constants
11982
11983 =item LOCALE
11984
11985 Constants
11986
11987 =item MATH
11988
11989 Constants
11990
11991 =item SIGNAL
11992
11993 Constants
11994
11995 =item STAT
11996
11997 Constants, Macros
11998
11999 =item STDLIB
12000
12001 Constants
12002
12003 =item STDIO
12004
12005 Constants
12006
12007 =item TIME
12008
12009 Constants
12010
12011 =item UNISTD
12012
12013 Constants
12014
12015 =item WAIT
12016
12017 Constants, Macros
12018
12019 =back
12020
12021 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
12022 name space
12023
12024 =over 4
12025
12026 =item SYNOPSIS
12027
12028 =item DESCRIPTION
12029
12030 unix, stdio, perlio, crlf, utf8, raw
12031
12032 =over 4
12033
12034 =item Defaults and how to override them
12035
12036 =back
12037
12038 =item AUTHOR
12039
12040 =item SEE ALSO
12041
12042 =back
12043
12044 =head2 PerlIO::Scalar - support module for in-memory IO.
12045
12046 =over 4
12047
12048 =item SYNOPSIS
12049
12050 =item DESCRIPTION
12051
12052 =back
12053
12054 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
12055
12056 =over 4
12057
12058 =item SYNOPSIS
12059
12060 =item DESCRIPTION
12061
12062 $class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
12063 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
12064 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
12065 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
12066 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
12067 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
12068 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
12069
12070 =back
12071
12072 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
12073
12074 =over 4
12075
12076 =item SYNOPSIS
12077
12078 =item OPTIONS/ARGUMENTS
12079
12080 =over 4
12081
12082 =item podchecker()
12083
12084 B<-warnings> =E<gt> I<val>
12085
12086 =back
12087
12088 =item DESCRIPTION
12089
12090 =item DIAGNOSTICS
12091
12092 =over 4
12093
12094 =item Errors
12095
12096 empty =headn, =over on line I<N> without closing =back, =item without
12097 previous =over, =back without previous =over, No argument for =begin, =end
12098 without =begin, Nested =begin's, =for without formatter specification,
12099 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
12100 interior-sequence "I<SEQ>", nested commands
12101 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
12102 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
12103 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
12104 after =back
12105
12106 =item Warnings
12107
12108 multiple occurence of link target I<name>, line containing nothing but
12109 whitespace in paragraph, file does not start with =head, previous =item has
12110 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
12111 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
12112 items in =over, No argument for =item, empty section in previous paragraph,
12113 Verbatim paragraph in NAME section
12114
12115 =item Hyperlinks
12116
12117 ignoring leading/trailing whitespace in link, (section) in '$page'
12118 deprecated, alternative text/node '%s' contains non-escaped | or /
12119
12120 =back
12121
12122 =item RETURN VALUE
12123
12124 =item EXAMPLES
12125
12126 =item INTERFACE
12127
12128 =back
12129
12130 C<Pod::Checker-E<gt>new( %options )>
12131
12132 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
12133 @args )>
12134
12135 C<$checker-E<gt>num_errors()>
12136
12137 C<$checker-E<gt>name()>
12138
12139 C<$checker-E<gt>node()>
12140
12141 C<$checker-E<gt>idx()>
12142
12143 C<$checker-E<gt>hyperlink()>
12144
12145 =over 4
12146
12147 =item AUTHOR
12148
12149 =back
12150
12151 =head2 Pod::Find - find POD documents in directory trees
12152
12153 =over 4
12154
12155 =item SYNOPSIS
12156
12157 =item DESCRIPTION
12158
12159 =back
12160
12161 =over 4
12162
12163 =item C<pod_find( { %opts } , @directories )>
12164
12165 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
12166 1>
12167
12168 =back
12169
12170 =over 4
12171
12172 =item C<simplify_name( $str )>
12173
12174 =back
12175
12176 =over 4
12177
12178 =item C<pod_where( { %opts }, $pod )>
12179
12180 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
12181 1>
12182
12183 =back
12184
12185 =over 4
12186
12187 =item C<contains_pod( $file , $verbose )>
12188
12189 =back
12190
12191 =over 4
12192
12193 =item AUTHOR
12194
12195 =item SEE ALSO
12196
12197 =back
12198
12199 =head2 Pod::Html - module to convert pod files to HTML
12200
12201 =over 4
12202
12203 =item SYNOPSIS
12204
12205 =item DESCRIPTION
12206
12207 =item ARGUMENTS
12208
12209 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
12210 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
12211 title, verbose
12212
12213 =item EXAMPLE
12214
12215 =item ENVIRONMENT
12216
12217 =item AUTHOR
12218
12219 =item SEE ALSO
12220
12221 =item COPYRIGHT
12222
12223 =back
12224
12225 =head2 Pod::InputObjects - objects representing POD input paragraphs,
12226 commands, etc.
12227
12228 =over 4
12229
12230 =item SYNOPSIS
12231
12232 =item REQUIRES
12233
12234 =item EXPORTS
12235
12236 =item DESCRIPTION
12237
12238 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
12239 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
12240
12241 =back
12242
12243 =over 4
12244
12245 =item B<Pod::InputSource>
12246
12247 =back
12248
12249 =over 4
12250
12251 =item B<new()>
12252
12253 =back
12254
12255 =over 4
12256
12257 =item B<name()>
12258
12259 =back
12260
12261 =over 4
12262
12263 =item B<handle()>
12264
12265 =back
12266
12267 =over 4
12268
12269 =item B<was_cutting()>
12270
12271 =back
12272
12273 =over 4
12274
12275 =item B<Pod::Paragraph>
12276
12277 =back
12278
12279 =over 4
12280
12281 =item Pod::Paragraph-E<gt>B<new()>
12282
12283 =back
12284
12285 =over 4
12286
12287 =item $pod_para-E<gt>B<cmd_name()>
12288
12289 =back
12290
12291 =over 4
12292
12293 =item $pod_para-E<gt>B<text()>
12294
12295 =back
12296
12297 =over 4
12298
12299 =item $pod_para-E<gt>B<raw_text()>
12300
12301 =back
12302
12303 =over 4
12304
12305 =item $pod_para-E<gt>B<cmd_prefix()>
12306
12307 =back
12308
12309 =over 4
12310
12311 =item $pod_para-E<gt>B<cmd_separator()>
12312
12313 =back
12314
12315 =over 4
12316
12317 =item $pod_para-E<gt>B<parse_tree()>
12318
12319 =back
12320
12321 =over 4
12322
12323 =item $pod_para-E<gt>B<file_line()>
12324
12325 =back
12326
12327 =over 4
12328
12329 =item B<Pod::InteriorSequence>
12330
12331 =back
12332
12333 =over 4
12334
12335 =item Pod::InteriorSequence-E<gt>B<new()>
12336
12337 =back
12338
12339 =over 4
12340
12341 =item $pod_seq-E<gt>B<cmd_name()>
12342
12343 =back
12344
12345 =over 4
12346
12347 =item $pod_seq-E<gt>B<prepend()>
12348
12349 =back
12350
12351 =over 4
12352
12353 =item $pod_seq-E<gt>B<append()>
12354
12355 =back
12356
12357 =over 4
12358
12359 =item $pod_seq-E<gt>B<nested()>
12360
12361 =back
12362
12363 =over 4
12364
12365 =item $pod_seq-E<gt>B<raw_text()>
12366
12367 =back
12368
12369 =over 4
12370
12371 =item $pod_seq-E<gt>B<left_delimiter()>
12372
12373 =back
12374
12375 =over 4
12376
12377 =item $pod_seq-E<gt>B<right_delimiter()>
12378
12379 =back
12380
12381 =over 4
12382
12383 =item $pod_seq-E<gt>B<parse_tree()>
12384
12385 =back
12386
12387 =over 4
12388
12389 =item $pod_seq-E<gt>B<file_line()>
12390
12391 =back
12392
12393 =over 4
12394
12395 =item Pod::InteriorSequence::B<DESTROY()>
12396
12397 =back
12398
12399 =over 4
12400
12401 =item B<Pod::ParseTree>
12402
12403 =back
12404
12405 =over 4
12406
12407 =item Pod::ParseTree-E<gt>B<new()>
12408
12409 =back
12410
12411 =over 4
12412
12413 =item $ptree-E<gt>B<top()>
12414
12415 =back
12416
12417 =over 4
12418
12419 =item $ptree-E<gt>B<children()>
12420
12421 =back
12422
12423 =over 4
12424
12425 =item $ptree-E<gt>B<prepend()>
12426
12427 =back
12428
12429 =over 4
12430
12431 =item $ptree-E<gt>B<append()>
12432
12433 =back
12434
12435 =over 4
12436
12437 =item $ptree-E<gt>B<raw_text()>
12438
12439 =back
12440
12441 =over 4
12442
12443 =item Pod::ParseTree::B<DESTROY()>
12444
12445 =back
12446
12447 =over 4
12448
12449 =item SEE ALSO
12450
12451 =item AUTHOR
12452
12453 =back
12454
12455 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
12456
12457 =over 4
12458
12459 =item SYNOPSIS
12460
12461 =item DESCRIPTION
12462
12463 =back
12464
12465 =over 4
12466
12467 =item OBJECT METHODS
12468
12469 C<initialize>
12470
12471 =back
12472
12473 =over 4
12474
12475 =item Data Accessors
12476
12477 B<AddPreamble>
12478
12479 =back
12480
12481 B<AddPostamble>
12482
12483 B<Head1Level>
12484
12485 B<Label>
12486
12487 B<LevelNoNum>
12488
12489 B<MakeIndex>
12490
12491 B<ReplaceNAMEwithSection>
12492
12493 B<StartWithNewPage>
12494
12495 B<TableOfContents>
12496
12497 B<UniqueLabels>
12498
12499 B<UserPreamble>
12500
12501 B<UserPostamble>
12502
12503 B<Lists>
12504
12505 =over 4
12506
12507 =item Subclassed methods
12508
12509 =back
12510
12511 B<begin_pod>
12512
12513 B<end_pod>
12514
12515 B<command>
12516
12517 B<verbatim>
12518
12519 B<textblock>
12520
12521 B<interior_sequence>
12522
12523 =over 4
12524
12525 =item List Methods
12526
12527 B<begin_list>
12528
12529 =back
12530
12531 B<end_list>
12532
12533 B<add_item>
12534
12535 =over 4
12536
12537 =item Methods for headings
12538
12539 B<head>
12540
12541 =back
12542
12543 =over 4
12544
12545 =item Internal methods
12546
12547 B<_output>
12548
12549 =back
12550
12551 B<_replace_special_chars>
12552
12553 B<_create_label>
12554
12555 B<_create_index>
12556
12557 B<_clean_latex_commands>
12558
12559 =over 4
12560
12561 =item NOTES
12562
12563 =item SEE ALSO
12564
12565 =item AUTHORS
12566
12567 =item COPYRIGHT
12568
12569 =item REVISION
12570
12571 =back
12572
12573 =head2 Pod::Man - Convert POD data to formatted *roff input
12574
12575 =over 4
12576
12577 =item SYNOPSIS
12578
12579 =item DESCRIPTION
12580
12581 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
12582 release, section
12583
12584 =item DIAGNOSTICS
12585
12586 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
12587 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape
12588 EE<lt>%sE<gt>, Unknown sequence %s, %s: Unknown command paragraph "%s" on
12589 line %d, Unmatched =back
12590
12591 =item BUGS
12592
12593 =item SEE ALSO
12594
12595 =item AUTHOR
12596
12597 =back
12598
12599 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
12600
12601 =over 4
12602
12603 =item SYNOPSIS
12604
12605 =item DESCRIPTION
12606
12607 =back
12608
12609 =over 4
12610
12611 =item Pod::List
12612
12613 Pod::List-E<gt>new()
12614
12615 =back
12616
12617 $list-E<gt>file()
12618
12619 $list-E<gt>start()
12620
12621 $list-E<gt>indent()
12622
12623 $list-E<gt>type()
12624
12625 $list-E<gt>rx()
12626
12627 $list-E<gt>item()
12628
12629 $list-E<gt>parent()
12630
12631 $list-E<gt>tag()
12632
12633 =over 4
12634
12635 =item Pod::Hyperlink
12636
12637 Pod::Hyperlink-E<gt>new()
12638
12639 =back
12640
12641 $link-E<gt>parse($string)
12642
12643 $link-E<gt>markup($string)
12644
12645 $link-E<gt>text()
12646
12647 $link-E<gt>warning()
12648
12649 $link-E<gt>file(), $link-E<gt>line()
12650
12651 $link-E<gt>page()
12652
12653 $link-E<gt>node()
12654
12655 $link-E<gt>alttext()
12656
12657 $link-E<gt>type()
12658
12659 $link-E<gt>link()
12660
12661 =over 4
12662
12663 =item Pod::Cache
12664
12665 Pod::Cache-E<gt>new()
12666
12667 =back
12668
12669 $cache-E<gt>item()
12670
12671 $cache-E<gt>find_page($name)
12672
12673 =over 4
12674
12675 =item Pod::Cache::Item
12676
12677 Pod::Cache::Item-E<gt>new()
12678
12679 =back
12680
12681 $cacheitem-E<gt>page()
12682
12683 $cacheitem-E<gt>description()
12684
12685 $cacheitem-E<gt>path()
12686
12687 $cacheitem-E<gt>file()
12688
12689 $cacheitem-E<gt>nodes()
12690
12691 $cacheitem-E<gt>find_node($name)
12692
12693 $cacheitem-E<gt>idx()
12694
12695 =over 4
12696
12697 =item AUTHOR
12698
12699 =item SEE ALSO
12700
12701 =back
12702
12703 =head2 Pod::Parser - base class for creating POD filters and translators
12704
12705 =over 4
12706
12707 =item SYNOPSIS
12708
12709 =item REQUIRES
12710
12711 =item EXPORTS
12712
12713 =item DESCRIPTION
12714
12715 =item QUICK OVERVIEW
12716
12717 =item PARSING OPTIONS
12718
12719 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
12720 B<-warnings> (default: unset)
12721
12722 =back
12723
12724 =over 4
12725
12726 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
12727
12728 =back
12729
12730 =over 4
12731
12732 =item B<command()>
12733
12734 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
12735
12736 =back
12737
12738 =over 4
12739
12740 =item B<verbatim()>
12741
12742 C<$text>, C<$line_num>, C<$pod_para>
12743
12744 =back
12745
12746 =over 4
12747
12748 =item B<textblock()>
12749
12750 C<$text>, C<$line_num>, C<$pod_para>
12751
12752 =back
12753
12754 =over 4
12755
12756 =item B<interior_sequence()>
12757
12758 =back
12759
12760 =over 4
12761
12762 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
12763
12764 =back
12765
12766 =over 4
12767
12768 =item B<new()>
12769
12770 =back
12771
12772 =over 4
12773
12774 =item B<initialize()>
12775
12776 =back
12777
12778 =over 4
12779
12780 =item B<begin_pod()>
12781
12782 =back
12783
12784 =over 4
12785
12786 =item B<begin_input()>
12787
12788 =back
12789
12790 =over 4
12791
12792 =item B<end_input()>
12793
12794 =back
12795
12796 =over 4
12797
12798 =item B<end_pod()>
12799
12800 =back
12801
12802 =over 4
12803
12804 =item B<preprocess_line()>
12805
12806 =back
12807
12808 =over 4
12809
12810 =item B<preprocess_paragraph()>
12811
12812 =back
12813
12814 =over 4
12815
12816 =item METHODS FOR PARSING AND PROCESSING
12817
12818 =back
12819
12820 =over 4
12821
12822 =item B<parse_text()>
12823
12824 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
12825 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
12826 I<code-ref>|I<method-name>
12827
12828 =back
12829
12830 =over 4
12831
12832 =item B<interpolate()>
12833
12834 =back
12835
12836 =over 4
12837
12838 =item B<parse_paragraph()>
12839
12840 =back
12841
12842 =over 4
12843
12844 =item B<parse_from_filehandle()>
12845
12846 =back
12847
12848 =over 4
12849
12850 =item B<parse_from_file()>
12851
12852 =back
12853
12854 =over 4
12855
12856 =item ACCESSOR METHODS
12857
12858 =back
12859
12860 =over 4
12861
12862 =item B<errorsub()>
12863
12864 =back
12865
12866 =over 4
12867
12868 =item B<cutting()>
12869
12870 =back
12871
12872 =over 4
12873
12874 =item B<parseopts()>
12875
12876 =back
12877
12878 =over 4
12879
12880 =item B<output_file()>
12881
12882 =back
12883
12884 =over 4
12885
12886 =item B<output_handle()>
12887
12888 =back
12889
12890 =over 4
12891
12892 =item B<input_file()>
12893
12894 =back
12895
12896 =over 4
12897
12898 =item B<input_handle()>
12899
12900 =back
12901
12902 =over 4
12903
12904 =item B<input_streams()>
12905
12906 =back
12907
12908 =over 4
12909
12910 =item B<top_stream()>
12911
12912 =back
12913
12914 =over 4
12915
12916 =item PRIVATE METHODS AND DATA
12917
12918 =back
12919
12920 =over 4
12921
12922 =item B<_push_input_stream()>
12923
12924 =back
12925
12926 =over 4
12927
12928 =item B<_pop_input_stream()>
12929
12930 =back
12931
12932 =over 4
12933
12934 =item TREE-BASED PARSING
12935
12936 =item SEE ALSO
12937
12938 =item AUTHOR
12939
12940 =back
12941
12942 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
12943
12944 =over 4
12945
12946 =item SYNOPSIS
12947
12948 =item DESCRIPTION
12949
12950 =over 4
12951
12952 =item EXPORT
12953
12954 =back
12955
12956 =item AUTHOR
12957
12958 =item SEE ALSO
12959
12960 =back
12961
12962 =head2 Pod::Select, podselect() - extract selected sections of POD from
12963 input
12964
12965 =over 4
12966
12967 =item SYNOPSIS
12968
12969 =item REQUIRES
12970
12971 =item EXPORTS
12972
12973 =item DESCRIPTION
12974
12975 =item SECTION SPECIFICATIONS
12976
12977 =item RANGE SPECIFICATIONS
12978
12979 =back
12980
12981 =over 4
12982
12983 =item OBJECT METHODS
12984
12985 =back
12986
12987 =over 4
12988
12989 =item B<curr_headings()>
12990
12991 =back
12992
12993 =over 4
12994
12995 =item B<select()>
12996
12997 =back
12998
12999 =over 4
13000
13001 =item B<add_selection()>
13002
13003 =back
13004
13005 =over 4
13006
13007 =item B<clear_selections()>
13008
13009 =back
13010
13011 =over 4
13012
13013 =item B<match_section()>
13014
13015 =back
13016
13017 =over 4
13018
13019 =item B<is_selected()>
13020
13021 =back
13022
13023 =over 4
13024
13025 =item EXPORTED FUNCTIONS
13026
13027 =back
13028
13029 =over 4
13030
13031 =item B<podselect()>
13032
13033 B<-output>, B<-sections>, B<-ranges>
13034
13035 =back
13036
13037 =over 4
13038
13039 =item PRIVATE METHODS AND DATA
13040
13041 =back
13042
13043 =over 4
13044
13045 =item B<_compile_section_spec()>
13046
13047 =back
13048
13049 =over 4
13050
13051 =item $self->{_SECTION_HEADINGS}
13052
13053 =back
13054
13055 =over 4
13056
13057 =item $self->{_SELECTED_SECTIONS}
13058
13059 =back
13060
13061 =over 4
13062
13063 =item SEE ALSO
13064
13065 =item AUTHOR
13066
13067 =back
13068
13069 =head2 Pod::Text - Convert POD data to formatted ASCII text
13070
13071 =over 4
13072
13073 =item SYNOPSIS
13074
13075 =item DESCRIPTION
13076
13077 alt, indent, loose, quotes, sentence, width
13078
13079 =item DIAGNOSTICS
13080
13081 Bizarre space in item, Can't open %s for reading: %s, Invalid quote
13082 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
13083 %s, Unknown sequence: %s, Unmatched =back
13084
13085 =item RESTRICTIONS
13086
13087 =item NOTES
13088
13089 =item SEE ALSO
13090
13091 =item AUTHOR
13092
13093 =back
13094
13095 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
13096
13097 =over 4
13098
13099 =item SYNOPSIS
13100
13101 =item DESCRIPTION
13102
13103 =item BUGS
13104
13105 =item SEE ALSO
13106
13107 =item AUTHOR
13108
13109 =back
13110
13111 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
13112 text
13113
13114 =over 4
13115
13116 =item SYNOPSIS
13117
13118 =item DESCRIPTION
13119
13120 =item BUGS
13121
13122 =item SEE ALSO
13123
13124 =item AUTHOR
13125
13126 =back
13127
13128 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
13129 text with format escapes
13130
13131 =over 4
13132
13133 =item SYNOPSIS
13134
13135 =item DESCRIPTION
13136
13137 =item SEE ALSO
13138
13139 =item AUTHOR
13140
13141 =back
13142
13143 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
13144 documentation
13145
13146 =over 4
13147
13148 =item SYNOPSIS
13149
13150 =item ARGUMENTS
13151
13152 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
13153 C<-pathlist>
13154
13155 =item DESCRIPTION
13156
13157 =item EXAMPLES
13158
13159 =over 4
13160
13161 =item Recommended Use
13162
13163 =back
13164
13165 =item CAVEATS
13166
13167 =item AUTHOR
13168
13169 =item ACKNOWLEDGEMENTS
13170
13171 =back
13172
13173 =head2 SDBM_File - Tied access to sdbm files
13174
13175 =over 4
13176
13177 =item SYNOPSIS
13178
13179 =item DESCRIPTION
13180
13181 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
13182
13183 =item DIAGNOSTICS
13184
13185 =over 4
13186
13187 =item C<sdbm store returned -1, errno 22, key "..." at ...>
13188
13189 =back
13190
13191 =item BUGS AND WARNINGS
13192
13193 =back
13194
13195 =head2 Safe - Compile and execute code in restricted compartments
13196
13197 =over 4
13198
13199 =item SYNOPSIS
13200
13201 =item DESCRIPTION
13202
13203 a new namespace, an operator mask
13204
13205 =item WARNING
13206
13207 =over 4
13208
13209 =item RECENT CHANGES
13210
13211 =item Methods in class Safe
13212
13213 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
13214 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
13215 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
13216 root (NAMESPACE), mask (MASK)
13217
13218 =item Some Safety Issues
13219
13220 Memory, CPU, Snooping, Signals, State Changes
13221
13222 =item AUTHOR
13223
13224 =back
13225
13226 =back
13227
13228 =head2 Scalar::Util - A selection of general-utility scalar subroutines
13229
13230 =over 4
13231
13232 =item SYNOPSIS
13233
13234 =item DESCRIPTION
13235
13236 blessed EXPR, dualvar NUM, STRING, isweak EXPR, reftype EXPR, weaken REF
13237
13238 =item COPYRIGHT
13239
13240 =item BLATANT PLUG
13241
13242 =back
13243
13244 =head2 Search::Dict, look - search for key in dictionary file
13245
13246 =over 4
13247
13248 =item SYNOPSIS
13249
13250 =item DESCRIPTION
13251
13252 =back
13253
13254 =head2 SelectSaver - save and restore selected file handle
13255
13256 =over 4
13257
13258 =item SYNOPSIS
13259
13260 =item DESCRIPTION
13261
13262 =back
13263
13264 =head2 SelfLoader - load functions only on demand
13265
13266 =over 4
13267
13268 =item SYNOPSIS
13269
13270 =item DESCRIPTION
13271
13272 =over 4
13273
13274 =item The __DATA__ token
13275
13276 =item SelfLoader autoloading
13277
13278 =item Autoloading and package lexicals
13279
13280 =item SelfLoader and AutoLoader
13281
13282 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
13283
13284 =item Classes and inherited methods.
13285
13286 =back
13287
13288 =item Multiple packages and fully qualified subroutine names
13289
13290 =back
13291
13292 =head2 Shell - run shell commands transparently within perl
13293
13294 =over 4
13295
13296 =item SYNOPSIS
13297
13298 =item DESCRIPTION
13299
13300 =over 4
13301
13302 =item OBJECT ORIENTED SYNTAX
13303
13304 =back
13305
13306 =item AUTHOR
13307
13308 =back
13309
13310 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
13311 socket.h defines and structure manipulators
13312
13313 =over 4
13314
13315 =item SYNOPSIS
13316
13317 =item DESCRIPTION
13318
13319 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
13320 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
13321 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
13322 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
13323 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
13324
13325 =back
13326
13327 =head2 Storable - persistency for perl data structures
13328
13329 =over 4
13330
13331 =item SYNOPSIS
13332
13333 =item DESCRIPTION
13334
13335 =item MEMORY STORE
13336
13337 =item ADVISORY LOCKING
13338
13339 =item SPEED
13340
13341 =item CANONICAL REPRESENTATION
13342
13343 =item ERROR REPORTING
13344
13345 =item WIZARDS ONLY
13346
13347 =over 4
13348
13349 =item Hooks
13350
13351 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
13352 I<serialized>, ..
13353
13354 =item Predicates
13355
13356 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
13357 C<Storable::is_retrieving>
13358
13359 =item Recursion
13360
13361 =item Deep Cloning
13362
13363 =back
13364
13365 =item EXAMPLES
13366
13367 =item WARNING
13368
13369 =item BUGS
13370
13371 =item CREDITS
13372
13373 =item TRANSLATIONS
13374
13375 =item AUTHOR
13376
13377 =item SEE ALSO
13378
13379 =back
13380
13381 =head2 Switch - A switch statement for Perl
13382
13383 =over 4
13384
13385 =item VERSION
13386
13387 =item SYNOPSIS
13388
13389 =item BACKGROUND
13390
13391 =item DESCRIPTION
13392
13393 =over 4
13394
13395 =item Allowing fall-through
13396
13397 =item Automating fall-through
13398
13399 =item Higher-order Operations
13400
13401 =back
13402
13403 =item DEPENDENCIES
13404
13405 =item AUTHOR
13406
13407 =item BUGS
13408
13409 =item COPYRIGHT
13410
13411 =back
13412
13413 =head2 Symbol - manipulate Perl symbols and their names
13414
13415 =over 4
13416
13417 =item SYNOPSIS
13418
13419 =item DESCRIPTION
13420
13421 =back
13422
13423 =head2 Sys::Hostname - Try every conceivable way to get hostname
13424
13425 =over 4
13426
13427 =item SYNOPSIS
13428
13429 =item DESCRIPTION
13430
13431 =item AUTHOR
13432
13433 =back
13434
13435 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
13436 interface to the UNIX syslog(3) calls
13437
13438 =over 4
13439
13440 =item SYNOPSIS
13441
13442 =item DESCRIPTION
13443
13444 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
13445 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
13446 closelog
13447
13448 =item EXAMPLES
13449
13450 =item SEE ALSO
13451
13452 =item AUTHOR
13453
13454 =back
13455
13456 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
13457 Perl interface to the UNIX syslog(3) calls
13458
13459 =over 4
13460
13461 =item SYNOPSIS
13462
13463 =item DESCRIPTION
13464
13465 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
13466 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
13467 closelog
13468
13469 =item EXAMPLES
13470
13471 =item SEE ALSO
13472
13473 =item AUTHOR
13474
13475 =back
13476
13477 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
13478
13479 =over 4
13480
13481 =item SYNOPSIS
13482
13483 =item DESCRIPTION
13484
13485 =item DIAGNOSTICS
13486
13487 Invalid attribute name %s, Name "%s" used only once: possible typo, No
13488 comma allowed after filehandle, Bareword "%s" not allowed while "strict
13489 subs" in use
13490
13491 =item RESTRICTIONS
13492
13493 =item NOTES
13494
13495 =item AUTHORS
13496
13497 =back
13498
13499 =head2 Term::Cap - Perl termcap interface
13500
13501 =over 4
13502
13503 =item SYNOPSIS
13504
13505 =item DESCRIPTION
13506
13507 =item EXAMPLES
13508
13509 =back
13510
13511 =head2 Term::Complete - Perl word completion module
13512
13513 =over 4
13514
13515 =item SYNOPSIS
13516
13517 =item DESCRIPTION
13518
13519 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
13520
13521 =item DIAGNOSTICS
13522
13523 =item BUGS
13524
13525 =item AUTHOR
13526
13527 =back
13528
13529 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
13530 no real package is found, substitutes stubs instead of basic functions.
13531
13532 =over 4
13533
13534 =item SYNOPSIS
13535
13536 =item DESCRIPTION
13537
13538 =item Minimal set of supported functions
13539
13540 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
13541 C<MinLine>, C<findConsole>, Attribs, C<Features>
13542
13543 =item Additional supported functions
13544
13545 C<tkRunning>, C<ornaments>, C<newTTY>
13546
13547 =item EXPORTS
13548
13549 =item ENVIRONMENT
13550
13551 =item CAVEATS
13552
13553 =back
13554
13555 =head2 Test - provides a simple framework for writing test scripts
13556
13557 =over 4
13558
13559 =item SYNOPSIS
13560
13561 =item DESCRIPTION
13562
13563 =item TEST TYPES
13564
13565 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
13566
13567 =item RETURN VALUE
13568
13569 =item ONFAIL
13570
13571 =item SEE ALSO
13572
13573 =item AUTHOR
13574
13575 =back
13576
13577 =head2 Test::Harness - run perl standard test scripts with statistics
13578
13579 =over 4
13580
13581 =item SYNOPSIS
13582
13583 =item DESCRIPTION
13584
13585 =over 4
13586
13587 =item The test script output
13588
13589 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
13590 B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
13591 B<Todo tests>, B<Bail out!>, B<Comments>
13592
13593 =back
13594
13595 =item EXPORT
13596
13597 =item DIAGNOSTICS
13598
13599 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
13600 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
13601 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
13602 %s>, C<FAILED--Further testing stopped%s>
13603
13604 =item ENVIRONMENT
13605
13606 C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
13607 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
13608 C<HARNESS_ACTIVE>
13609
13610 =item SEE ALSO
13611
13612 =item AUTHORS
13613
13614 =item BUGS
13615
13616 =back
13617
13618 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
13619
13620 =over 4
13621
13622 =item SYNOPSIS
13623
13624 =item DESCRIPTION
13625
13626 =item EXAMPLE
13627
13628 =back
13629
13630 =head2 Text::Balanced - Extract delimited text sequences from strings.
13631
13632 =over 4
13633
13634 =item SYNOPSIS
13635
13636 =item DESCRIPTION
13637
13638 =over 4
13639
13640 =item General behaviour in list contexts
13641
13642 [0], [1], [2]
13643
13644 =item General behaviour in scalar and void contexts
13645
13646 =item A note about prefixes
13647
13648 =item C<extract_delimited>
13649
13650 =item C<extract_bracketed>
13651
13652 =item C<extract_tagged>
13653
13654 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
13655 [0], [1], [2], [3], [4], [5]
13656
13657 =item C<gen_extract_tagged>
13658
13659 =item C<extract_quotelike>
13660
13661 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
13662
13663 =item C<extract_quotelike> and "here documents"
13664
13665 [0], [1], [2], [3], [4], [5], [6], [7..10]
13666
13667 =item C<extract_codeblock>
13668
13669 =item C<extract_multiple>
13670
13671 =item C<gen_delimited_pat>
13672
13673 =back
13674
13675 =item DIAGNOSTICS
13676
13677  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
13678 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
13679 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
13680 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
13681 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
13682 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
13683 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
13684 after dereferencer>, C<Did not find expected opening bracket at %s>,
13685 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
13686 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
13687 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
13688 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
13689 tag>
13690
13691 =item AUTHOR
13692
13693 =item BUGS AND IRRITATIONS
13694
13695 =item COPYRIGHT
13696
13697 =back
13698
13699 =head2 Text::ParseWords - parse text into an array of tokens or array of
13700 arrays
13701
13702 =over 4
13703
13704 =item SYNOPSIS
13705
13706 =item DESCRIPTION
13707
13708 =item EXAMPLES
13709
13710 =item AUTHORS
13711
13712 =back
13713
13714 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
13715 by Knuth
13716
13717 =over 4
13718
13719 =item SYNOPSIS
13720
13721 =item DESCRIPTION
13722
13723 =item EXAMPLES
13724
13725 =item LIMITATIONS
13726
13727 =item AUTHOR
13728
13729 =back
13730
13731 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
13732 unexpand(1)
13733
13734 =over 4
13735
13736 =item SYNOPSIS
13737
13738 =item DESCRIPTION
13739
13740 =item BUGS
13741
13742 =item AUTHOR
13743
13744 =back
13745
13746 =head2 Text::Wrap - line wrapping to form simple paragraphs
13747
13748 =over 4
13749
13750 =item SYNOPSIS
13751
13752 =item DESCRIPTION
13753
13754 =item EXAMPLE
13755
13756 =item AUTHOR
13757
13758 =back
13759
13760 =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
13761 change)
13762
13763 =over 4
13764
13765 =item CAVEAT
13766
13767 =item SYNOPSIS
13768
13769 =item DESCRIPTION
13770
13771 =item FUNCTIONS
13772
13773 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
13774 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
13775 cond_broadcast VARIABLE, yield
13776
13777 =item METHODS
13778
13779 join, eval, detach, equal, tid, flags, done
13780
13781 =item LIMITATIONS
13782
13783 =item SEE ALSO
13784
13785 =back
13786
13787 =head2 Thread::Queue - thread-safe queues
13788
13789 =over 4
13790
13791 =item SYNOPSIS
13792
13793 =item DESCRIPTION
13794
13795 =item FUNCTIONS AND METHODS
13796
13797 new, enqueue LIST, dequeue, dequeue_nb, pending
13798
13799 =item SEE ALSO
13800
13801 =back
13802
13803 =head2 Thread::Semaphore - thread-safe semaphores
13804
13805 =over 4
13806
13807 =item SYNOPSIS
13808
13809 =item DESCRIPTION
13810
13811 =item FUNCTIONS AND METHODS
13812
13813 new, new NUMBER, down, down NUMBER, up, up NUMBER
13814
13815 =back
13816
13817 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
13818
13819 =over 4
13820
13821 =item SYNOPSIS
13822
13823 =item DESCRIPTION
13824
13825 =item BUGS
13826
13827 =back
13828
13829 =head2 Thread::Specific - thread-specific keys
13830
13831 =over 4
13832
13833 =item SYNOPSIS
13834
13835 =item DESCRIPTION
13836
13837 =back
13838
13839 =head2 Tie::Array - base class for tied arrays
13840
13841 =over 4
13842
13843 =item SYNOPSIS
13844
13845 =item DESCRIPTION
13846
13847 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
13848 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
13849 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
13850 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
13851
13852 =item CAVEATS
13853
13854 =item AUTHOR
13855
13856 =back
13857
13858 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
13859 handles
13860
13861 =over 4
13862
13863 =item SYNOPSIS
13864
13865 =item DESCRIPTION
13866
13867 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
13868 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
13869 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
13870 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
13871
13872 =item MORE INFORMATION
13873
13874 =item COMPATIBILITY
13875
13876 =back
13877
13878 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
13879
13880 =over 4
13881
13882 =item SYNOPSIS
13883
13884 =item DESCRIPTION
13885
13886 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
13887 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
13888
13889 =item CAVEATS
13890
13891 =item MORE INFORMATION
13892
13893 =back
13894
13895 =head2 Tie::RefHash - use references as hash keys
13896
13897 =over 4
13898
13899 =item SYNOPSIS
13900
13901 =item DESCRIPTION
13902
13903 =item EXAMPLE
13904
13905 =item AUTHOR
13906
13907 =item VERSION
13908
13909 =item SEE ALSO
13910
13911 =back
13912
13913 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
13914 scalars
13915
13916 =over 4
13917
13918 =item SYNOPSIS
13919
13920 =item DESCRIPTION
13921
13922 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
13923
13924 =item MORE INFORMATION
13925
13926 =back
13927
13928 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
13929
13930 =over 4
13931
13932 =item SYNOPSIS
13933
13934 =item DESCRIPTION
13935
13936 =item CAVEATS
13937
13938 =back
13939
13940 =head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday
13941
13942 =over 4
13943
13944 =item SYNOPSIS
13945
13946 =item DESCRIPTION
13947
13948 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
13949 $interval_useconds ] ), tv_interval ( $ref_to_gettimeofday [,
13950 $ref_to_later_gettimeofday] ), time (), sleep ( $floating_seconds ), alarm
13951 ( $floating_seconds [, $interval_floating_seconds ] ), setitimer ( $which,
13952 $floating_seconds [, $interval_floating_seconds ] ), getitimer ( $which )
13953
13954 =item EXAMPLES
13955
13956 =item C API
13957
13958 =item AUTHORS
13959
13960 =item REVISION
13961
13962 =item COPYRIGHT
13963
13964 =back
13965
13966 =head2 Time::Local - efficiently compute time from local and GMT time
13967
13968 =over 4
13969
13970 =item SYNOPSIS
13971
13972 =item DESCRIPTION
13973
13974 =item IMPLEMENTATION
13975
13976 =item BUGS
13977
13978 =back
13979
13980 =head2 Time::Piece - Object Oriented time objects
13981
13982 =over 4
13983
13984 =item SYNOPSIS
13985
13986 =item DESCRIPTION
13987
13988 =item USAGE
13989
13990 =over 4
13991
13992 =item Local Locales
13993
13994 =item Date Calculations
13995
13996 =item Date Comparisons
13997
13998 =item Global Overriding
13999
14000 =back
14001
14002 =item AUTHOR
14003
14004 =over 4
14005
14006 =item License
14007
14008 =item Bugs
14009
14010 =back
14011
14012 =back
14013
14014 =head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert
14015 seconds to other date values
14016
14017 =over 4
14018
14019 =item SYNOPSIS
14020
14021 =item DESCRIPTION
14022
14023 =item METHODS
14024
14025 =item AUTHOR
14026
14027 =item LICENSE
14028
14029 =item Bugs
14030
14031 =back
14032
14033 =head2 Time::Seconds - a simple API to convert seconds to other date values
14034
14035 =over 4
14036
14037 =item SYNOPSIS
14038
14039 =item DESCRIPTION
14040
14041 =item METHODS
14042
14043 =item AUTHOR
14044
14045 =item LICENSE
14046
14047 =item Bugs
14048
14049 =back
14050
14051 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
14052 function
14053
14054 =over 4
14055
14056 =item SYNOPSIS
14057
14058 =item DESCRIPTION
14059
14060 =item NOTE
14061
14062 =item AUTHOR
14063
14064 =back
14065
14066 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
14067 function
14068
14069 =over 4
14070
14071 =item SYNOPSIS
14072
14073 =item DESCRIPTION
14074
14075 =item NOTE
14076
14077 =item AUTHOR
14078
14079 =back
14080
14081 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
14082
14083 =over 4
14084
14085 =item SYNOPSIS
14086
14087 =item DESCRIPTION
14088
14089 =item AUTHOR
14090
14091 =back
14092
14093 =head2 UNIVERSAL - base class for ALL classes (blessed references)
14094
14095 =over 4
14096
14097 =item SYNOPSIS
14098
14099 =item DESCRIPTION
14100
14101 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
14102 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
14103
14104 =back
14105
14106 =head2 User::grent - by-name interface to Perl's built-in getgr*()
14107 functions
14108
14109 =over 4
14110
14111 =item SYNOPSIS
14112
14113 =item DESCRIPTION
14114
14115 =item NOTE
14116
14117 =item AUTHOR
14118
14119 =back
14120
14121 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
14122 functions
14123
14124 =over 4
14125
14126 =item SYNOPSIS
14127
14128 =item DESCRIPTION
14129
14130 =over 4
14131
14132 =item System Specifics
14133
14134 =back
14135
14136 =item NOTE
14137
14138 =item AUTHOR
14139
14140 =item HISTORY
14141
14142 March 18th, 2000
14143
14144 =back
14145
14146 =head2 Win32 - Interfaces to some Win32 API Functions
14147
14148 =over 4
14149
14150 =item DESCRIPTION
14151
14152 =over 4
14153
14154 =item Alphabetical Listing of Win32 Functions
14155
14156 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
14157 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
14158 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
14159 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
14160 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
14161 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
14162 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
14163 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
14164 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
14165 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
14166 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
14167 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
14168 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
14169 Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
14170 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
14171 PID), Win32::UnregisterServer(LIBRARYNAME)
14172
14173 =back
14174
14175 =back
14176
14177 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
14178
14179 =over 4
14180
14181 =item SYNOPSIS
14182
14183 =item DESCRIPTION
14184
14185 =back
14186
14187 =over 4
14188
14189 =item NOTES
14190
14191 =item AUTHOR
14192
14193 =back
14194
14195 =head2 XSLoader - Dynamically load C libraries into Perl code
14196
14197 =over 4
14198
14199 =item SYNOPSIS
14200
14201 =item DESCRIPTION
14202
14203 =item AUTHOR
14204
14205 =back
14206
14207 =head1 AUXILIARY DOCUMENTATION
14208
14209 Here should be listed all the extra programs' documentation, but they
14210 don't all have manual pages yet:
14211
14212 =over 4
14213
14214 =item a2p
14215
14216 =item s2p
14217
14218 =item find2perl
14219
14220 =item h2ph
14221
14222 =item c2ph
14223
14224 =item h2xs
14225
14226 =item xsubpp
14227
14228 =item pod2man
14229
14230 =item wrapsuid
14231
14232 =back
14233
14234 =head1 AUTHOR
14235
14236 Larry Wall <F<larry@wall.org>>, with the help of oodles
14237 of other folks.
14238