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