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, items, ix, LEAVE, looks_like_number,
3827 MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical,
3828 mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc,
3829 NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share,
3830 newSVrv, newSVsv, newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv,
3831 Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_construct, perl_destruct,
3832 perl_free, perl_parse, perl_run, PL_DBsingle, PL_DBsub, PL_DBtrace,
3833 PL_dowarn, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi,
3834 POPl, POPn, POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
3835 PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn,
3836 SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE,
3837 strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW,
3838 SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
3839 SvIOK_UV, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp,
3840 SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
3841 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force,
3842 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
3843 SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
3844 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV,
3845 SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE,
3846 SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv,
3847 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv,
3848 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_dec,
3849 sv_derived_from, sv_eq, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
3850 sv_isa, sv_isobject, sv_len, sv_len_utf8, sv_magic, sv_mortalcopy,
3851 sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace,
3852 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
3853 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
3854 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
3855 sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_true,
3856 sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, sv_usepvn_mg,
3857 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_vcatpvfn,
3858 sv_vsetpvfn, THIS, toLOWER, toUPPER, U8 *s, utf8_distance, utf8_hop,
3859 utf8_length, utf8_to_bytes, utf8_to_uv, utf8_to_uv_simple, warn, XPUSHi,
3860 XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV,
3861 XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES,
3862 XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION,
3863 XS_VERSION_BOOTCHECK, Zero
3864
3865 =item AUTHORS
3866
3867 =item SEE ALSO
3868
3869 =back
3870
3871 =head2 perlintern - autogenerated documentation of purely B<internal>
3872                  Perl functions
3873
3874 =over 4
3875
3876 =item DESCRIPTION
3877
3878 djSP, is_gv_magical, LVRET, start_glob
3879
3880 =item AUTHORS
3881
3882 =item SEE ALSO
3883
3884 =back
3885
3886 =head2 perlapio - perl's IO abstraction interface.
3887
3888 =over 4
3889
3890 =item SYNOPSIS
3891
3892 =item DESCRIPTION
3893
3894 B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
3895 B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
3896 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
3897 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
3898 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
3899 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
3900 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
3901 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
3902 B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
3903 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>
3904
3905 =over 4
3906
3907 =item Co-existence with stdio
3908
3909 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
3910 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>,
3911 B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>,
3912 B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>,
3913 B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>,
3914 B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
3915
3916 =back
3917
3918 =back
3919
3920 =head2 perltodo - Perl TO-DO List
3921
3922 =over 4
3923
3924 =item DESCRIPTION
3925
3926 =item Infrastructure
3927
3928 =over 4
3929
3930 =item Mailing list archives
3931
3932 =item Bug tracking system
3933
3934 =item Regression Tests
3935
3936 Coverage, Regression, __DIE__, suidperl, The 25% slowdown from perl4 to
3937 perl5
3938
3939 =back
3940
3941 =item Configure
3942
3943 =over 4
3944
3945 =item Install HTML
3946
3947 =back
3948
3949 =item Perl Language
3950
3951 =over 4
3952
3953 =item 64-bit Perl
3954
3955 =item Prototypes
3956
3957 Named prototypes, Indirect objects, Method calls, Context, Scoped subs
3958
3959 =back
3960
3961 =item Perl Internals
3962
3963 =over 4
3964
3965 =item magic_setisa
3966
3967 =item Garbage Collection
3968
3969 =item Reliable signals
3970
3971 Alternate runops() for signal despatch, Figure out how to die() in delayed
3972 sighandler, Add tests for Thread::Signal, Automatic tests against CPAN
3973
3974 =item Interpolated regex performance bugs
3975
3976 =item Memory leaks from failed eval/regcomp
3977
3978 =item Make XS easier to use
3979
3980 =item Make embedded Perl easier to use
3981
3982 =item Namespace cleanup
3983
3984 =item MULTIPLICITY
3985
3986 =item MacPerl
3987
3988 =back
3989
3990 =item Documentation
3991
3992 =over 4
3993
3994 =item A clear division into tutorial and reference
3995
3996 =item Remove the artificial distinction between operators and functions
3997
3998 =item More tutorials
3999
4000 Regular expressions, I/O, pack/unpack, Debugging
4001
4002 =item Include a search tool
4003
4004 =item Include a locate tool
4005
4006 =item Separate function manpages by default
4007
4008 =item Users can't find the manpages
4009
4010 =item Install ALL Documentation
4011
4012 =item Outstanding issues to be documented
4013
4014 =item Adapt www.linuxhq.com for Perl
4015
4016 =item Replace man with a perl program
4017
4018 =item Unicode tutorial
4019
4020 =back
4021
4022 =item Modules
4023
4024 =over 4
4025
4026 =item Update the POSIX extension to conform with the POSIX 1003.1 Edition 2
4027
4028 =item Module versions
4029
4030 =item New modules
4031
4032 =item Profiler
4033
4034 =item Tie Modules
4035
4036 VecArray, SubstrArray, VirtualArray, ShiftSplice
4037
4038 =item Procedural options
4039
4040 =item RPC
4041
4042 =item y2k localtime/gmtime
4043
4044 =item Export File::Find variables
4045
4046 =item Ioctl
4047
4048 =item Debugger attach/detach
4049
4050 =item Regular Expression debugger
4051
4052 =item Alternative RE Syntax
4053
4054 =item Bundled modules
4055
4056 =item Expect
4057
4058 =item GUI::Native
4059
4060 =item Update semibroken auxiliary tools; h2ph, a2p, etc.
4061
4062 =item pod2html
4063
4064 =item Podchecker
4065
4066 =back
4067
4068 =item Tom's Wishes
4069
4070 =over 4
4071
4072 =item Webperl
4073
4074 =item Mobile agents
4075
4076 =item POSIX on non-POSIX
4077
4078 =item Portable installations
4079
4080 =back
4081
4082 =item Win32 Stuff
4083
4084 =over 4
4085
4086 =item Rename new headers to be consistent with the rest
4087
4088 =item Sort out the spawnvp() mess
4089
4090 =item Work out DLL versioning
4091
4092 =item Style-check
4093
4094 =back
4095
4096 =item Would be nice to have
4097
4098 C<pack "(stuff)*">, Contiguous bitfields in pack/unpack, lexperl, Bundled
4099 perl preprocessor, Use posix calls internally where possible, format
4100 BOTTOM, -i rename file only when successfully changed, All ARGV input
4101 should act like <>, report HANDLE [formats], support in perlmain to rerun
4102 debugger, lvalue functions
4103
4104 =item Possible pragmas
4105
4106 =over 4
4107
4108 =item 'less'
4109
4110 =back
4111
4112 =item Optimizations
4113
4114 =over 4
4115
4116 =item constant function cache
4117
4118 =item foreach(reverse...)
4119
4120 =item Cache eval tree
4121
4122 =item rcatmaybe
4123
4124 =item Shrink opcode tables
4125
4126 =item Cache hash value
4127
4128 =item Optimize away @_ where possible
4129
4130 =item Optimize sort by { $a <=> $b }
4131
4132 =item Rewrite regexp parser for better integrated optimization
4133
4134 =back
4135
4136 =item Vague possibilities
4137
4138 ref function in list context, make tr/// return histogram in list context?,
4139 Loop control on do{} et al, Explicit switch statements, compile to real
4140 threaded code, structured types, Modifiable $1 et al
4141
4142 =item To Do Or Not To Do
4143
4144 =over 4
4145
4146 =item Making my() work on "package" variables
4147
4148 =item "or" testing defined not truth
4149
4150 =item "dynamic" lexicals
4151
4152 =item "class"-based, rather than package-based "lexicals"
4153
4154 =back
4155
4156 =item Threading
4157
4158 =over 4
4159
4160 =item Modules
4161
4162 =item Testing
4163
4164 =item $AUTOLOAD
4165
4166 =item exit/die
4167
4168 =item External threads
4169
4170 =item Thread::Pool
4171
4172 =item thread-safety
4173
4174 =item Per-thread GVs
4175
4176 =back
4177
4178 =item Compiler
4179
4180 =over 4
4181
4182 =item Optimization
4183
4184 =item Byteperl
4185
4186 =item Precompiled modules
4187
4188 =item Executables
4189
4190 =item Typed lexicals
4191
4192 =item Win32
4193
4194 =item END blocks
4195
4196 =item _AUTOLOAD
4197
4198 =item comppadlist
4199
4200 =item Cached compilation
4201
4202 =back
4203
4204 =item Recently Finished Tasks
4205
4206 =over 4
4207
4208 =item Figure a way out of $^(capital letter)
4209
4210 =item Filenames
4211
4212 =item Foreign lines
4213
4214 =item Namespace cleanup
4215
4216 =item ISA.pm
4217
4218 =item gettimeofday
4219
4220 =item autocroak?
4221
4222 =back
4223
4224 =back
4225
4226 =head2 perlhack - How to hack at the Perl internals
4227
4228 =over 4
4229
4230 =item DESCRIPTION
4231
4232 Does concept match the general goals of Perl?, Where is the
4233 implementation?, Backwards compatibility, Could it be a module instead?, Is
4234 the feature generic enough?, Does it potentially introduce new bugs?, Does
4235 it preclude other desirable features?, Is the implementation robust?, Is
4236 the implementation generic enough to be portable?, Is there enough
4237 documentation?, Is there another way to do it?, Does it create too much
4238 work?, Patches speak louder than words
4239
4240 =over 4
4241
4242 =item Keeping in sync
4243
4244 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4245 NFS, rsync'ing the patches, It's easier, It's more recent, It's more
4246 reliable, It's easier, It's a good reference, Finding a start point,
4247 Finding how to fix a bug, Finding the source of misbehaviour
4248
4249 =item Submitting patches
4250
4251 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4252 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4253
4254 =item Finding Your Way Around
4255
4256 Core modules, Documentation, Configure, Interpreter
4257
4258 =item Elements of the interpreter
4259
4260 Startup, Parsing, Optimization, Running
4261
4262 =item Internal Variable Types
4263
4264 =item Op Trees
4265
4266 =item Stacks
4267
4268 Argument stack, Mark stack, Save stack
4269
4270 =item Millions of Macros
4271
4272 =item Poking at Perl
4273
4274 =item Using a source-level debugger
4275
4276 run [args], break function_name, break source.c:xxx, step, next, continue,
4277 finish, 'enter', print
4278
4279 =item Dumping Perl Data Structures
4280
4281 =item Patching
4282
4283 =back
4284
4285 =item EXTERNAL TOOLS FOR DEBUGGING PERL
4286
4287 =over 4
4288
4289 =item Rational Software's Purify
4290
4291 =item Purify on Unix
4292
4293 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
4294
4295 =item Purify on NT
4296
4297 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
4298
4299 =item CONCLUSION
4300
4301 I<The Road goes ever on and on, down from the door where it began.>
4302
4303 =back
4304
4305 =item AUTHOR
4306
4307 =back
4308
4309 =head2 perlhist - the Perl history records
4310
4311 =over 4
4312
4313 =item DESCRIPTION
4314
4315 =item INTRODUCTION
4316
4317 =item THE KEEPERS OF THE PUMPKIN
4318
4319 =over 4
4320
4321 =item PUMPKIN?
4322
4323 =back
4324
4325 =item THE RECORDS
4326
4327 =over 4
4328
4329 =item SELECTED RELEASE SIZES
4330
4331 =item SELECTED PATCH SIZES
4332
4333 =back
4334
4335 =item THE KEEPERS OF THE RECORDS
4336
4337 =back
4338
4339 =head2 perldelta - what's new for perl v5.7.0
4340
4341 =over 4
4342
4343 =item DESCRIPTION
4344
4345 =item Security Vulnerability Closed
4346
4347 =item Incompatible Changes
4348
4349 =item Core Enhancements
4350
4351 =item Modules and Pragmata
4352
4353 =over 4
4354
4355 =item New Modules
4356
4357 =item Updated And Improved Modules and Pragmata
4358
4359 =back
4360
4361 =item Utility Changes
4362
4363 =item New Documentation
4364
4365 =item Performance Enhancements
4366
4367 =item Installation and Configuration Improvements
4368
4369 =over 4
4370
4371 =item Generic Improvements
4372
4373 =back
4374
4375 =item Selected Bug Fixes
4376
4377 =over 4
4378
4379 =item Platform Specific Changes and Fixes
4380
4381 =back
4382
4383 =item New or Changed Diagnostics
4384
4385 =item Changed Internals
4386
4387 =item Known Problems
4388
4389 =over 4
4390
4391 =item Unicode Support Still Far From Perfect
4392
4393 =item EBCDIC Still A Lost Platform
4394
4395 =item Building Extensions Can Fail Because Of Largefiles
4396
4397 =item ftmp-security tests warn 'system possibly insecure'
4398
4399 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
4400
4401 =item Long Doubles Still Don't Work In Solaris
4402
4403 =item Linux With Sfio Fails op/misc Test 48
4404
4405 =item sprintf tests 129 and 130
4406
4407 =item Storable tests fail in some platforms
4408
4409 =item Threads Are Still Experimental
4410
4411 =item The Compiler Suite Is Still Experimental
4412
4413 =back
4414
4415 =item Reporting Bugs
4416
4417 =item SEE ALSO
4418
4419 =item HISTORY
4420
4421 =back
4422
4423 =head2 perl56delta, perldelta - what's new for perl v5.6.0
4424
4425 =over 4
4426
4427 =item DESCRIPTION
4428
4429 =item Core Enhancements
4430
4431 =over 4
4432
4433 =item Interpreter cloning, threads, and concurrency
4434
4435 =item Lexically scoped warning categories
4436
4437 =item Unicode and UTF-8 support
4438
4439 =item Support for interpolating named characters
4440
4441 =item "our" declarations
4442
4443 =item Support for strings represented as a vector of ordinals
4444
4445 =item Improved Perl version numbering system
4446
4447 =item New syntax for declaring subroutine attributes
4448
4449 =item File and directory handles can be autovivified
4450
4451 =item open() with more than two arguments
4452
4453 =item 64-bit support
4454
4455 =item Large file support
4456
4457 =item Long doubles
4458
4459 =item "more bits"
4460
4461 =item Enhanced support for sort() subroutines
4462
4463 =item C<sort $coderef @foo> allowed
4464
4465 =item File globbing implemented internally
4466
4467 =item Support for CHECK blocks
4468
4469 =item POSIX character class syntax [: :] supported
4470
4471 =item Better pseudo-random number generator
4472
4473 =item Improved C<qw//> operator
4474
4475 =item Better worst-case behavior of hashes
4476
4477 =item pack() format 'Z' supported
4478
4479 =item pack() format modifier '!' supported
4480
4481 =item pack() and unpack() support counted strings
4482
4483 =item Comments in pack() templates
4484
4485 =item Weak references
4486
4487 =item Binary numbers supported
4488
4489 =item Lvalue subroutines
4490
4491 =item Some arrows may be omitted in calls through references
4492
4493 =item Boolean assignment operators are legal lvalues
4494
4495 =item exists() is supported on subroutine names
4496
4497 =item exists() and delete() are supported on array elements
4498
4499 =item Pseudo-hashes work better
4500
4501 =item Automatic flushing of output buffers
4502
4503 =item Better diagnostics on meaningless filehandle operations
4504
4505 =item Where possible, buffered data discarded from duped input filehandle
4506
4507 =item eof() has the same old magic as <>
4508
4509 =item binmode() can be used to set :crlf and :raw modes
4510
4511 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
4512
4513 =item system(), backticks and pipe open now reflect exec() failure
4514
4515 =item Improved diagnostics
4516
4517 =item Diagnostics follow STDERR
4518
4519 =item More consistent close-on-exec behavior
4520
4521 =item syswrite() ease-of-use
4522
4523 =item Better syntax checks on parenthesized unary operators
4524
4525 =item Bit operators support full native integer width
4526
4527 =item Improved security features
4528
4529 =item More functional bareword prototype (*)
4530
4531 =item C<require> and C<do> may be overridden
4532
4533 =item $^X variables may now have names longer than one character
4534
4535 =item New variable $^C reflects C<-c> switch
4536
4537 =item New variable $^V contains Perl version as a string
4538
4539 =item Optional Y2K warnings
4540
4541 =item Arrays now always interpolate into double-quoted strings
4542
4543 =back
4544
4545 =item Modules and Pragmata
4546
4547 =over 4
4548
4549 =item Modules
4550
4551 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
4552 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
4553 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
4554 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
4555 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
4556 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
4557 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
4558 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
4559
4560 =item Pragmata
4561
4562 =back
4563
4564 =item Utility Changes
4565
4566 =over 4
4567
4568 =item dprofpp
4569
4570 =item find2perl
4571
4572 =item h2xs
4573
4574 =item perlcc
4575
4576 =item perldoc
4577
4578 =item The Perl Debugger
4579
4580 =back
4581
4582 =item Improved Documentation
4583
4584 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
4585 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
4586 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
4587 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
4588
4589 =item Performance enhancements
4590
4591 =over 4
4592
4593 =item Simple sort() using { $a <=> $b } and the like are optimized
4594
4595 =item Optimized assignments to lexical variables
4596
4597 =item Faster subroutine calls
4598
4599 =item delete(), each(), values() and hash iteration are faster
4600
4601 =back
4602
4603 =item Installation and Configuration Improvements
4604
4605 =over 4
4606
4607 =item -Dusethreads means something different
4608
4609 =item New Configure flags
4610
4611 =item Threadedness and 64-bitness now more daring
4612
4613 =item Long Doubles
4614
4615 =item -Dusemorebits
4616
4617 =item -Duselargefiles
4618
4619 =item installusrbinperl
4620
4621 =item SOCKS support
4622
4623 =item C<-A> flag
4624
4625 =item Enhanced Installation Directories
4626
4627 =back
4628
4629 =item Platform specific changes
4630
4631 =over 4
4632
4633 =item Supported platforms
4634
4635 =item DOS
4636
4637 =item OS390 (OpenEdition MVS)
4638
4639 =item VMS
4640
4641 =item Win32
4642
4643 =back
4644
4645 =item Significant bug fixes
4646
4647 =over 4
4648
4649 =item <HANDLE> on empty files
4650
4651 =item C<eval '...'> improvements
4652
4653 =item All compilation errors are true errors
4654
4655 =item Implicitly closed filehandles are safer
4656
4657 =item Behavior of list slices is more consistent
4658
4659 =item C<(\$)> prototype and C<$foo{a}>
4660
4661 =item C<goto &sub> and AUTOLOAD
4662
4663 =item C<-bareword> allowed under C<use integer>
4664
4665 =item Failures in DESTROY()
4666
4667 =item Locale bugs fixed
4668
4669 =item Memory leaks
4670
4671 =item Spurious subroutine stubs after failed subroutine calls
4672
4673 =item Taint failures under C<-U>
4674
4675 =item END blocks and the C<-c> switch
4676
4677 =item Potential to leak DATA filehandles
4678
4679 =back
4680
4681 =item New or Changed Diagnostics
4682
4683 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
4684 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
4685 / cannot take a count, / must be followed by a, A or Z, / must be followed
4686 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
4687 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
4688 passed through, /%s/ should probably be written as "%s", %s() called too
4689 early to check prototype, %s argument is not a HASH or ARRAY element, %s
4690 argument is not a HASH or ARRAY element or slice, %s argument is not a
4691 subroutine name, %s package attribute may clash with future reserved word:
4692 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
4693 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
4694 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
4695 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
4696 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
4697 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
4698 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
4699 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
4700 weaken a nonreference, Character class [:%s:] unknown, Character class
4701 syntax [%s] belongs inside character classes, Constant is not %s reference,
4702 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
4703 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
4704 "local" instead of "our"?), Document contains no data, entering effective
4705 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
4706 output, flock() on closed filehandle %s, Global symbol "%s" requires
4707 explicit package name, Hexadecimal number > 0xffffffff non-portable,
4708 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
4709 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
4710 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
4711 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
4712 separator character %s in attribute list, Invalid separator character %s in
4713 subroutine attribute list, leaving effective %s failed, Lvalue subs
4714 returning %s not implemented yet, Method %s not permitted, Missing
4715 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
4716 No %s specified for -%c, No package name allowed for variable %s in "our",
4717 No space allowed after -%c, no UTC offset information; assuming local time
4718 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
4719 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
4720 around "%s" list, Possible unintended interpolation of %s in string,
4721 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
4722 instead, Premature end of script headers, Repeat count in pack overflows,
4723 Repeat count in unpack overflows, realloc() of freed memory ignored,
4724 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
4725 zero-length expression, switching effective %s is not implemented, This
4726 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
4727 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
4728 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
4729 escape \\%c passed through, Unterminated attribute parameter in attribute
4730 list, Unterminated attribute list, Unterminated attribute parameter in
4731 subroutine attribute list, Unterminated subroutine attribute list, Value of
4732 CLI symbol "%s" too long, Version number must be a constant number
4733
4734 =item New tests
4735
4736 =item Incompatible Changes
4737
4738 =over 4
4739
4740 =item Perl Source Incompatibilities
4741
4742 CHECK is a new keyword, Treatment of list slices of undef has changed,
4743 Format of $English::PERL_VERSION is different, Literals of the form
4744 C<1.2.3> parse differently, Possibly changed pseudo-random number
4745 generator, Hashing function for hash keys has changed, C<undef> fails on
4746 read only values, Close-on-exec bit may be set on pipe and socket handles,
4747 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
4748 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
4749 Text of some diagnostic output has changed, C<%@> has been removed,
4750 Parenthesized not() behaves like a list operator, Semantics of bareword
4751 prototype C<(*)> have changed, Semantics of bit operators may have changed
4752 on 64-bit platforms, More builtins taint their results
4753
4754 =item C Source Incompatibilities
4755
4756 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
4757
4758 =item Compatible C Source API Changes
4759
4760 C<PATCHLEVEL> is now C<PERL_VERSION>
4761
4762 =item Binary Incompatibilities
4763
4764 =back
4765
4766 =item Known Problems
4767
4768 =over 4
4769
4770 =item Thread test failures
4771
4772 =item EBCDIC platforms not supported
4773
4774 =item In 64-bit HP-UX the lib/io_multihomed test may hang
4775
4776 =item NEXTSTEP 3.3 POSIX test failure
4777
4778 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
4779 gcc
4780
4781 =item UNICOS/mk CC failures during Configure run
4782
4783 =item Arrow operator and arrays
4784
4785 =item Experimental features
4786
4787 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
4788 pseudo-hash data type, The Compiler suite, Internal implementation of file
4789 globbing, The DB module, The regular expression code constructs:
4790
4791 =back
4792
4793 =item Obsolete Diagnostics
4794
4795 Character class syntax [: :] is reserved for future extensions, Ill-formed
4796 logical name |%s| in prime_env_iter, In string, @%s now must be written as
4797 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
4798 to mean "${$}<digit>" is deprecated
4799
4800 =item Reporting Bugs
4801
4802 =item SEE ALSO
4803
4804 =item HISTORY
4805
4806 =back
4807
4808 =head2 perl5005delta, perldelta - what's new for perl5.005
4809
4810 =over 4
4811
4812 =item DESCRIPTION
4813
4814 =item About the new versioning system
4815
4816 =item Incompatible Changes
4817
4818 =over 4
4819
4820 =item WARNING:  This version is not binary compatible with Perl 5.004.
4821
4822 =item Default installation structure has changed
4823
4824 =item Perl Source Compatibility
4825
4826 =item C Source Compatibility
4827
4828 =item Binary Compatibility
4829
4830 =item Security fixes may affect compatibility
4831
4832 =item Relaxed new mandatory warnings introduced in 5.004
4833
4834 =item Licensing
4835
4836 =back
4837
4838 =item Core Changes
4839
4840 =over 4
4841
4842 =item Threads
4843
4844 =item Compiler
4845
4846 =item Regular Expressions
4847
4848 Many new and improved optimizations, Many bug fixes, New regular expression
4849 constructs, New operator for precompiled regular expressions, Other
4850 improvements, Incompatible changes
4851
4852 =item   Improved malloc()
4853
4854 =item Quicksort is internally implemented
4855
4856 =item Reliable signals
4857
4858 =item Reliable stack pointers
4859
4860 =item More generous treatment of carriage returns
4861
4862 =item Memory leaks
4863
4864 =item Better support for multiple interpreters
4865
4866 =item Behavior of local() on array and hash elements is now well-defined
4867
4868 =item C<%!> is transparently tied to the L<Errno> module
4869
4870 =item Pseudo-hashes are supported
4871
4872 =item C<EXPR foreach EXPR> is supported
4873
4874 =item Keywords can be globally overridden
4875
4876 =item C<$^E> is meaningful on Win32
4877
4878 =item C<foreach (1..1000000)> optimized
4879
4880 =item C<Foo::> can be used as implicitly quoted package name
4881
4882 =item C<exists $Foo::{Bar::}> tests existence of a package
4883
4884 =item Better locale support
4885
4886 =item Experimental support for 64-bit platforms
4887
4888 =item prototype() returns useful results on builtins
4889
4890 =item Extended support for exception handling
4891
4892 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
4893
4894 =item All C<printf> format conversions are handled internally
4895
4896 =item New C<INIT> keyword
4897
4898 =item New C<lock> keyword
4899
4900 =item New C<qr//> operator
4901
4902 =item C<our> is now a reserved word
4903
4904 =item Tied arrays are now fully supported
4905
4906 =item Tied handles support is better
4907
4908 =item 4th argument to substr
4909
4910 =item Negative LENGTH argument to splice
4911
4912 =item Magic lvalues are now more magical
4913
4914 =item <> now reads in records
4915
4916 =back
4917
4918 =item Supported Platforms
4919
4920 =over 4
4921
4922 =item New Platforms
4923
4924 =item Changes in existing support
4925
4926 =back
4927
4928 =item Modules and Pragmata
4929
4930 =over 4
4931
4932 =item New Modules
4933
4934 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
4935 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
4936 Thread, attrs, fields, re
4937
4938 =item Changes in existing modules
4939
4940 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
4941 MakeMaker, CPAN, Cwd, Benchmark
4942
4943 =back
4944
4945 =item Utility Changes
4946
4947 =item Documentation Changes
4948
4949 =item New Diagnostics
4950
4951 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
4952 while coercing array into hash, Bareword "%s" refers to nonexistent
4953 package, Can't call method "%s" on an undefined value, Can't check
4954 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
4955 goto subroutine from an eval-string, Can't localize pseudo-hash element,
4956 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
4957 for "%s", Character class syntax [. .] is reserved for future extensions,
4958 Character class syntax [: :] is reserved for future extensions, Character
4959 class syntax [= =] is reserved for future extensions, %s: Eval-group in
4960 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
4961 Eval-group not allowed at run time, Explicit blessing to '' (assuming
4962 package main), Illegal hex digit ignored, No such array field, No such
4963 field "%s" in variable %s of type %s, Out of memory during ridiculously
4964 large request, Range iterator outside integer range, Recursive inheritance
4965 detected while looking for method '%s' %s, Reference found where even-sized
4966 list expected, Undefined value assigned to typeglob, Use of reserved word
4967 "%s" is deprecated, perl: warning: Setting locale failed
4968
4969 =item Obsolete Diagnostics
4970
4971 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
4972 temporary file, regexp too big
4973
4974 =item Configuration Changes
4975
4976 =item BUGS
4977
4978 =item SEE ALSO
4979
4980 =item HISTORY
4981
4982 =back
4983
4984 =head2 perl5004delta, perldelta - what's new for perl5.004
4985
4986 =over 4
4987
4988 =item DESCRIPTION
4989
4990 =item Supported Environments
4991
4992 =item Core Changes
4993
4994 =over 4
4995
4996 =item List assignment to %ENV works
4997
4998 =item Change to "Can't locate Foo.pm in @INC" error
4999
5000 =item Compilation option: Binary compatibility with 5.003
5001
5002 =item $PERL5OPT environment variable
5003
5004 =item Limitations on B<-M>, B<-m>, and B<-T> options
5005
5006 =item More precise warnings
5007
5008 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
5009
5010 =item Previously deprecated %OVERLOAD is no longer usable
5011
5012 =item Subroutine arguments created only when they're modified
5013
5014 =item Group vector changeable with C<$)>
5015
5016 =item Fixed parsing of $$<digit>, &$<digit>, etc.
5017
5018 =item Fixed localization of $<digit>, $&, etc.
5019
5020 =item No resetting of $. on implicit close
5021
5022 =item C<wantarray> may return undef
5023
5024 =item C<eval EXPR> determines value of EXPR in scalar context
5025
5026 =item Changes to tainting checks
5027
5028 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
5029 spawning if tainted $TERM doesn't look like a terminal name
5030
5031 =item New Opcode module and revised Safe module
5032
5033 =item Embedding improvements
5034
5035 =item Internal change: FileHandle class based on IO::* classes
5036
5037 =item Internal change: PerlIO abstraction interface
5038
5039 =item New and changed syntax
5040
5041 $coderef->(PARAMS)
5042
5043 =item New and changed builtin constants
5044
5045 __PACKAGE__
5046
5047 =item New and changed builtin variables
5048
5049 $^E, $^H, $^M
5050
5051 =item New and changed builtin functions
5052
5053 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
5054 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
5055 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
5056 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
5057 nested C<sub{}> closures work now, formats work right on changing lexicals
5058
5059 =item New builtin methods
5060
5061 isa(CLASS), can(METHOD), VERSION( [NEED] )
5062
5063 =item TIEHANDLE now supported
5064
5065 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
5066 LIST, READLINE this, GETC this, DESTROY this
5067
5068 =item Malloc enhancements
5069
5070 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
5071
5072 =item Miscellaneous efficiency enhancements
5073
5074 =back
5075
5076 =item Support for More Operating Systems
5077
5078 =over 4
5079
5080 =item Win32
5081
5082 =item Plan 9
5083
5084 =item QNX
5085
5086 =item AmigaOS
5087
5088 =back
5089
5090 =item Pragmata
5091
5092 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
5093 constant NAME => VALUE, use locale, use ops, use vmsish
5094
5095 =item Modules
5096
5097 =over 4
5098
5099 =item Required Updates
5100
5101 =item Installation directories
5102
5103 =item Module information summary
5104
5105 =item Fcntl
5106
5107 =item IO
5108
5109 =item Math::Complex
5110
5111 =item Math::Trig
5112
5113 =item DB_File
5114
5115 =item Net::Ping
5116
5117 =item Object-oriented overrides for builtin operators
5118
5119 =back
5120
5121 =item Utility Changes
5122
5123 =over 4
5124
5125 =item pod2html
5126
5127 Sends converted HTML to standard output
5128
5129 =item xsubpp
5130
5131 C<void> XSUBs now default to returning nothing
5132
5133 =back
5134
5135 =item C Language API Changes
5136
5137 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
5138 manipulating hashes
5139
5140 =item Documentation Changes
5141
5142 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
5143 L<perlmodlib>, L<perldebug>, L<perlsec>
5144
5145 =item New Diagnostics
5146
5147 "my" variable %s masks earlier declaration in same scope, %s argument is
5148 not a HASH element or slice, Allocation too large: %lx, Allocation too
5149 large, Applying %s to %s will act on scalar(%s), Attempt to free
5150 nonexistent shared string, Attempt to use reference as lvalue in substr,
5151 Bareword "%s" refers to nonexistent package, Can't redefine active sort
5152 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
5153 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
5154 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
5155 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
5156 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
5157 %s, Integer overflow in hex number, Integer overflow in octal number,
5158 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
5159 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
5160 possible typo, Null picture in formline, Offset outside string, Out of
5161 memory!, Out of memory during request for %s, panic: frexp, Possible
5162 attempt to put comments in qw() list, Possible attempt to separate words
5163 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
5164 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
5165 option, untie attempted while %d inner references still exist, Unrecognized
5166 character %s, Unsupported function fork, Use of "$$<digit>" to mean
5167 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
5168 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
5169 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
5170 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
5171 long, Process terminated by SIG%s
5172
5173 =item BUGS
5174
5175 =item SEE ALSO
5176
5177 =item HISTORY
5178
5179 =back
5180
5181 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
5182
5183 =over 4
5184
5185 =item DESCRIPTION
5186
5187 =over 4
5188
5189 =item Compiling Perl 5 on AIX
5190
5191 =item OS level
5192
5193 =item Building Dynamic Extensions on AIX
5194
5195 =item The IBM ANSI C Compiler
5196
5197 =item Using GNU's gcc for building perl
5198
5199 =item Using Large Files with Perl
5200
5201 =item Threaded Perl
5202
5203 =item 64-bit Perl
5204
5205 =item GDBM and Threads
5206
5207 =item NFS filesystems and utime(2)
5208
5209 =back
5210
5211 =item AUTHOR
5212
5213 =item DATE
5214
5215 =back
5216
5217 =head2 perlamiga - Perl under Amiga OS
5218
5219 =over 4
5220
5221 =item SYNOPSIS
5222
5223 =back
5224
5225 =over 4
5226
5227 =item DESCRIPTION
5228
5229 =over 4
5230
5231 =item Prerequisites
5232
5233 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
5234
5235 =item Starting Perl programs under AmigaOS
5236
5237 =item Shortcomings of Perl under AmigaOS
5238
5239 =back
5240
5241 =item INSTALLATION
5242
5243 =item Accessing documentation
5244
5245 =over 4
5246
5247 =item Manpages
5248
5249 =item B<HTML>
5250
5251 =item B<GNU> C<info> files
5252
5253 =item C<LaTeX> docs
5254
5255 =back
5256
5257 =item BUILD
5258
5259 =over 4
5260
5261 =item Prerequisites
5262
5263 =item Getting the perl source
5264
5265 =item Making
5266
5267 sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
5268
5269 =item Testing
5270
5271 =item Installing the built perl
5272
5273 =back
5274
5275 =item AUTHORS
5276
5277 =item SEE ALSO
5278
5279 =back
5280
5281 =head2 perlcygwin, README.cygwin - Perl for Cygwin
5282
5283 =over 4
5284
5285 =item SYNOPSIS
5286
5287 =item PREREQUISITES
5288
5289 =over 4
5290
5291 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
5292
5293 =item Cygwin Configuration
5294
5295 C<PATH>, I<nroff>, Permissions
5296
5297 =back
5298
5299 =item CONFIGURE
5300
5301 =over 4
5302
5303 =item Strip Binaries
5304
5305 =item Optional Libraries
5306
5307 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
5308 C<-lcygipc> (C<use IPC::SysV>)
5309
5310 =item Configure-time Options
5311
5312 C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>,
5313 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
5314
5315 =item Suspicious Warnings
5316
5317 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
5318
5319 =back
5320
5321 =item MAKE
5322
5323 =over 4
5324
5325 =item Warnings
5326
5327 =item ld2
5328
5329 =back
5330
5331 =item TEST
5332
5333 =over 4
5334
5335 =item File Permissions
5336
5337 =item Hard Links
5338
5339 =item Filetime Granularity
5340
5341 =item Tainting Checks
5342
5343 =item /etc/group
5344
5345 =item Script Portability
5346
5347 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
5348
5349 =back
5350
5351 =item INSTALL
5352
5353 =item MANIFEST
5354
5355 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
5356 Source, Compiled Module Source, Perl Modules/Scripts
5357
5358 =item BUGS
5359
5360 =item AUTHORS
5361
5362 =item HISTORY
5363
5364 =back
5365
5366 =head2 perldos - Perl under DOS, W31, W95.
5367
5368 =over 4
5369
5370 =item SYNOPSIS
5371
5372 =item DESCRIPTION
5373
5374 =over 4
5375
5376 =item Prerequisites
5377
5378 DJGPP, Pthreads
5379
5380 =item Shortcomings of Perl under DOS
5381
5382 =item Building
5383
5384 =item Testing
5385
5386 =item Installation
5387
5388 =back
5389
5390 =item BUILDING AND INSTALLING MODULES
5391
5392 =over 4
5393
5394 =item Prerequisites
5395
5396 =item Unpacking CPAN Modules
5397
5398 =item Building Non-XS Modules
5399
5400 =item Building XS Modules
5401
5402 =back
5403
5404 =item AUTHOR
5405
5406 =item SEE ALSO
5407
5408 =back
5409
5410 =head2 perlepoc, README.epoc - Perl for EPOC
5411
5412 =over 4
5413
5414 =item SYNOPSIS
5415
5416 =item INTRODUCTION
5417
5418 =item INSTALLING PERL ON EPOC
5419
5420 =item USING PERL ON EPOC
5421
5422 =over 4
5423
5424 =item IO Redirection
5425
5426 =item PATH Names
5427
5428 =item Editors
5429
5430 =item Features
5431
5432 =item Restrictions
5433
5434 =item Compiling Perl 5 on the EPOC cross compiling environment
5435
5436 =back
5437
5438 =item SUPPORT STATUS
5439
5440 =item AUTHOR
5441
5442 =item LAST UPDATE
5443
5444 =back
5445
5446 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
5447 (HP-UX) systems
5448
5449 =over 4
5450
5451 =item DESCRIPTION
5452
5453 =over 4
5454
5455 =item Compiling Perl 5 on HP-UX
5456
5457 =item PA-RISC
5458
5459 =item PA-RISC 1.0
5460
5461 =item PA-RISC 1.1
5462
5463 =item PA-RISC 2.0
5464
5465 =item Portability Between PA-RISC Versions
5466
5467 =item Building Dynamic Extensions on HP-UX
5468
5469 =item The HP ANSI C Compiler
5470
5471 =item Using Large Files with Perl
5472
5473 =item Threaded Perl
5474
5475 =item 64-bit Perl
5476
5477 =item GDBM and Threads
5478
5479 =item NFS filesystems and utime(2)
5480
5481 =item perl -P and //
5482
5483 =back
5484
5485 =item AUTHOR
5486
5487 =item DATE
5488
5489 =back
5490
5491 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
5492 systems
5493
5494 =over 4
5495
5496 =item DESCRIPTION
5497
5498 =over 4
5499
5500 =item Compiling Perl 5 on MachTen
5501
5502 =item Failures during C<make test>
5503
5504 op/lexassign.t, pragma/warnings.t
5505
5506 =item Building external modules
5507
5508 =back
5509
5510 =item AUTHOR
5511
5512 =item DATE
5513
5514 =back
5515
5516 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
5517
5518 =head1 SYNOPSIS
5519
5520 =over 4
5521
5522 =item What's New
5523
5524 =item System Requirements
5525
5526 =item How to Obtain Perl/iX
5527
5528 =item Distribution Contents Highlights
5529
5530 README, public_html/feedback.cgi,  4,  6
5531
5532 =item Getting Started with Perl/iX
5533
5534 =item MPE/iX Implementation Considerations
5535
5536 =item Change History
5537
5538 =back
5539
5540 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
5541
5542 =over 4
5543
5544 =item SYNOPSIS
5545
5546 =back
5547
5548 =over 4
5549
5550 =item DESCRIPTION
5551
5552 =over 4
5553
5554 =item Target
5555
5556 =item Other OSes
5557
5558 =item Prerequisites
5559
5560 EMX, RSX, HPFS, pdksh
5561
5562 =item Starting Perl programs under OS/2 (and DOS and...)
5563
5564 =item Starting OS/2 (and DOS) programs under Perl
5565
5566 =back
5567
5568 =item Frequently asked questions
5569
5570 =over 4
5571
5572 =item I cannot run external programs
5573
5574 =item I cannot embed perl into my program, or use F<perl.dll> from my
5575 program.
5576
5577 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
5578 L<ExtUtils::Embed>?
5579
5580 =item C<``> and pipe-C<open> do not work under DOS.
5581
5582 =item Cannot start C<find.exe "pattern" file>
5583
5584 =back
5585
5586 =item INSTALLATION
5587
5588 =over 4
5589
5590 =item Automatic binary installation
5591
5592 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
5593
5594 =item Manual binary installation
5595
5596 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
5597 (statically linked), Executables for Perl utilities, Main Perl library,
5598 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
5599 and utilities, Manpages for Perl modules, Source for Perl documentation,
5600 Perl manual in F<.INF> format, Pdksh
5601
5602 =item B<Warning>
5603
5604 =back
5605
5606 =item Accessing documentation
5607
5608 =over 4
5609
5610 =item OS/2 F<.INF> file
5611
5612 =item Plain text
5613
5614 =item Manpages
5615
5616 =item HTML
5617
5618 =item GNU C<info> files
5619
5620 =item F<.PDF> files
5621
5622 =item C<LaTeX> docs
5623
5624 =back
5625
5626 =item BUILD
5627
5628 =over 4
5629
5630 =item Prerequisites
5631
5632 =item Getting perl source
5633
5634 =item Application of the patches
5635
5636 =item Hand-editing
5637
5638 =item Making
5639
5640 =item Testing
5641
5642 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
5643 F<lib/io_pipe.t>, F<lib/io_sock.t>, F<op/stat.t>, F<lib/io_udp.t>
5644
5645 =item Installing the built perl
5646
5647 =item C<a.out>-style build
5648
5649 =back
5650
5651 =item Build FAQ
5652
5653 =over 4
5654
5655 =item Some C</> became C<\> in pdksh.
5656
5657 =item C<'errno'> - unresolved external
5658
5659 =item Problems with tr or sed
5660
5661 =item Some problem (forget which ;-)
5662
5663 =item Library ... not found
5664
5665 =item Segfault in make
5666
5667 =item op/sprintf test failure
5668
5669 =back
5670
5671 =item Specific (mis)features of OS/2 port
5672
5673 =over 4
5674
5675 =item C<setpriority>, C<getpriority>
5676
5677 =item C<system()>
5678
5679 =item C<extproc> on the first line
5680
5681 =item Additional modules:
5682
5683 =item Prebuilt methods:
5684
5685 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
5686  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
5687 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
5688 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
5689 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
5690 C<Cwd::extLibpath_set( path [, type ] )>
5691
5692 =item Misfeatures
5693
5694 =item Modifications
5695
5696 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<flock>
5697
5698 =back
5699
5700 =item Perl flavors
5701
5702 =over 4
5703
5704 =item F<perl.exe>
5705
5706 =item F<perl_.exe>
5707
5708 =item F<perl__.exe>
5709
5710 =item F<perl___.exe>
5711
5712 =item Why strange names?
5713
5714 =item Why dynamic linking?
5715
5716 =item Why chimera build?
5717
5718 explicit fork(), open FH, "|-", open FH, "-|"
5719
5720 =back
5721
5722 =item ENVIRONMENT
5723
5724 =over 4
5725
5726 =item C<PERLLIB_PREFIX>
5727
5728 =item C<PERL_BADLANG>
5729
5730 =item C<PERL_BADFREE>
5731
5732 =item C<PERL_SH_DIR>
5733
5734 =item C<USE_PERL_FLOCK>
5735
5736 =item C<TMP> or C<TEMP>
5737
5738 =back
5739
5740 =item Evolution
5741
5742 =over 4
5743
5744 =item Priorities
5745
5746 =item DLL name mangling
5747
5748 =item Threading
5749
5750 =item Calls to external programs
5751
5752 =item Memory allocation
5753
5754 =item Threads
5755
5756 C<COND_WAIT>, F<os2.c>
5757
5758 =back
5759
5760 =back
5761
5762 =over 4
5763
5764 =item AUTHOR
5765
5766 =item SEE ALSO
5767
5768 =back
5769
5770 =head2 perlos390, README.os390 - building and installing Perl for OS/390.
5771
5772 =over 4
5773
5774 =item SYNOPSIS
5775
5776 =item DESCRIPTION
5777
5778 =over 4
5779
5780 =item Unpacking
5781
5782 =item Setup and utilities
5783
5784 =item Configure
5785
5786 =item Build, test, install
5787
5788 =item build anomalies
5789
5790 =item testing anomalies
5791
5792 =item Usage Hints
5793
5794 =item Modules and Extensions
5795
5796 =back
5797
5798 =item AUTHORS
5799
5800 =item SEE ALSO
5801
5802 =over 4
5803
5804 =item Mailing list
5805
5806 =back
5807
5808 =item HISTORY
5809
5810 =back
5811
5812 =head2 perlposix-bc, README.posix-bc - building and installing Perl for
5813 BS2000 POSIX.
5814
5815 =over 4
5816
5817 =item SYNOPSIS
5818
5819 =item DESCRIPTION
5820
5821 =over 4
5822
5823 =item gzip
5824
5825 =item bison
5826
5827 =item Unpacking
5828
5829 =item Compiling
5830
5831 =item Testing
5832
5833 =item Install
5834
5835 =item Using Perl
5836
5837 =back
5838
5839 =item AUTHORS
5840
5841 =item SEE ALSO
5842
5843 =over 4
5844
5845 =item Mailing list
5846
5847 =back
5848
5849 =item HISTORY
5850
5851 =back
5852
5853 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
5854
5855 =over 4
5856
5857 =item DESCRIPTION
5858
5859 =over 4
5860
5861 =item Solaris Version Numbers.
5862
5863 =back
5864
5865 =item RESOURCES
5866
5867 Solaris FAQ, Precompiled Binaries, Solaris Documentation
5868
5869 =item SETTING UP
5870
5871 =over 4
5872
5873 =item File Extraction Problems.
5874
5875 =item Compiler and Related Tools.
5876
5877 =item Environment
5878
5879 =back
5880
5881 =item RUN CONFIGURE.
5882
5883 =over 4
5884
5885 =item 64-bit Issues.
5886
5887 =item Threads.
5888
5889 =item Malloc Issues.
5890
5891 =back
5892
5893 =item MAKE PROBLEMS.
5894
5895 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
5896 relocation error:, dlopen: stub interception failed, #error "No
5897 DATAMODEL_NATIVE specified", sh: ar: not found
5898
5899 =item MAKE TEST
5900
5901 =over 4
5902
5903 =item op/stat.t test 4
5904
5905 =back
5906
5907 =item PREBUILT BINARIES.
5908
5909 =item RUNTIME ISSUES.
5910
5911 =over 4
5912
5913 =item Limits on Numbers of Open Files.
5914
5915 =back
5916
5917 =item SOLARIS-SPECIFIC MODULES.
5918
5919 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
5920
5921 =over 4
5922
5923 =item Proc::ProcessTable
5924
5925 =item BSD::Resource
5926
5927 =item Net::SSLeay
5928
5929 =back
5930
5931 =item AUTHOR
5932
5933 =item LAST MODIFIED
5934
5935 =back
5936
5937 =head2 perlvms - VMS-specific documentation for Perl
5938
5939 =over 4
5940
5941 =item DESCRIPTION
5942
5943 =item Installation
5944
5945 =item Organization of Perl Images
5946
5947 =over 4
5948
5949 =item Core Images
5950
5951 =item Perl Extensions
5952
5953 =item Installing static extensions
5954
5955 =item Installing dynamic extensions
5956
5957 =back
5958
5959 =item File specifications
5960
5961 =over 4
5962
5963 =item Syntax
5964
5965 =item Wildcard expansion
5966
5967 =item Pipes
5968
5969 =back
5970
5971 =item PERL5LIB and PERLLIB
5972
5973 =item Command line
5974
5975 =over 4
5976
5977 =item I/O redirection and backgrounding
5978
5979 =item Command line switches
5980
5981 -i, -S, -u
5982
5983 =back
5984
5985 =item Perl functions
5986
5987 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
5988 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
5989 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
5990 LIST, waitpid PID,FLAGS
5991
5992 =item Perl variables
5993
5994 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $^S, $|
5995
5996 =item Standard modules with VMS-specific differences
5997
5998 =over 4
5999
6000 =item SDBM_File
6001
6002 =back
6003
6004 =item Revision date
6005
6006 =item AUTHOR
6007
6008 =back
6009
6010 =head2 perlvos, README.vos - Perl for Stratus VOS
6011
6012 =over 4
6013
6014 =item SYNOPSIS
6015
6016 =over 4
6017
6018 =item Stratus POSIX Support
6019
6020 =back
6021
6022 =item INSTALLING PERL IN VOS
6023
6024 =over 4
6025
6026 =item Compiling Perl 5 on VOS
6027
6028 =item Installing Perl 5 on VOS
6029
6030 =back
6031
6032 =item USING PERL IN VOS
6033
6034 =over 4
6035
6036 =item Unimplemented Features
6037
6038 =item Restrictions
6039
6040 =back
6041
6042 =item SUPPORT STATUS
6043
6044 =item AUTHOR
6045
6046 =item LAST UPDATE
6047
6048 =back
6049
6050 =head2 perlwin32 - Perl under Win32
6051
6052 =over 4
6053
6054 =item SYNOPSIS
6055
6056 =item DESCRIPTION
6057
6058 =over 4
6059
6060 =item Setting Up
6061
6062 Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
6063
6064 =item Building
6065
6066 =item Testing
6067
6068 =item Installation
6069
6070 =item Usage Hints
6071
6072 Environment Variables, File Globbing, Using perl from the command line,
6073 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
6074 Extensions, Running Perl Scripts, Miscellaneous Things
6075
6076 =back
6077
6078 =item BUGS AND CAVEATS
6079
6080 =item AUTHORS
6081
6082 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
6083 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
6084 E<lt>nick@ing-simmons.netE<gt>
6085
6086 =item SEE ALSO
6087
6088 =item HISTORY
6089
6090 =back
6091
6092 =head1 PRAGMA DOCUMENTATION
6093
6094 =head2 attrs - set/get attributes of a subroutine (deprecated)
6095
6096 =over 4
6097
6098 =item SYNOPSIS
6099
6100 =item DESCRIPTION
6101
6102 method, locked
6103
6104 =back
6105
6106 =head2 re - Perl pragma to alter regular expression behaviour
6107
6108 =over 4
6109
6110 =item SYNOPSIS
6111
6112 =item DESCRIPTION
6113
6114 =back
6115
6116 =head2 attributes - get/set subroutine or variable attributes
6117
6118 =over 4
6119
6120 =item SYNOPSIS
6121
6122 =item DESCRIPTION
6123
6124 =over 4
6125
6126 =item Built-in Attributes
6127
6128 locked, method, lvalue
6129
6130 =item Available Subroutines
6131
6132 get, reftype
6133
6134 =item Package-specific Attribute Handling
6135
6136 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
6137
6138 =item Syntax of Attribute Lists
6139
6140 =back
6141
6142 =item EXPORTS
6143
6144 =over 4
6145
6146 =item Default exports
6147
6148 =item Available exports
6149
6150 =item Export tags defined
6151
6152 =back
6153
6154 =item EXAMPLES
6155
6156 =item SEE ALSO
6157
6158 =back
6159
6160 =head2 attrs - set/get attributes of a subroutine (deprecated)
6161
6162 =over 4
6163
6164 =item SYNOPSIS
6165
6166 =item DESCRIPTION
6167
6168 method, locked
6169
6170 =back
6171
6172 =head2 autouse - postpone load of modules until a function is used
6173
6174 =over 4
6175
6176 =item SYNOPSIS
6177
6178 =item DESCRIPTION
6179
6180 =item WARNING
6181
6182 =item AUTHOR
6183
6184 =item SEE ALSO
6185
6186 =back
6187
6188 =head2 base - Establish IS-A relationship with base class at compile time
6189
6190 =over 4
6191
6192 =item SYNOPSIS
6193
6194 =item DESCRIPTION
6195
6196 =item HISTORY
6197
6198 =item SEE ALSO
6199
6200 =back
6201
6202 =head2 blib - Use MakeMaker's uninstalled version of a package
6203
6204 =over 4
6205
6206 =item SYNOPSIS
6207
6208 =item DESCRIPTION
6209
6210 =item BUGS
6211
6212 =item AUTHOR
6213
6214 =back
6215
6216 =head2 bytes - Perl pragma to force byte semantics rather than character
6217 semantics
6218
6219 =over 4
6220
6221 =item SYNOPSIS
6222
6223 =item DESCRIPTION
6224
6225 =item SEE ALSO
6226
6227 =back
6228
6229 =head2 charnames - define character names for C<\N{named}> string literal
6230 escape.
6231
6232 =over 4
6233
6234 =item SYNOPSIS
6235
6236 =item DESCRIPTION
6237
6238 =item CUSTOM TRANSLATORS
6239
6240 =item BUGS
6241
6242 =back
6243
6244 =head2 constant - Perl pragma to declare constants
6245
6246 =over 4
6247
6248 =item SYNOPSIS
6249
6250 =item DESCRIPTION
6251
6252 =item NOTES
6253
6254 =item TECHNICAL NOTE
6255
6256 =item BUGS
6257
6258 =item AUTHOR
6259
6260 =item COPYRIGHT
6261
6262 =back
6263
6264 =head2 diagnostics - Perl compiler pragma to force verbose warning
6265 diagnostics
6266
6267 =over 4
6268
6269 =item SYNOPSIS
6270
6271 =item DESCRIPTION
6272
6273 =over 4
6274
6275 =item The C<diagnostics> Pragma
6276
6277 =item The I<splain> Program
6278
6279 =back
6280
6281 =item EXAMPLES
6282
6283 =item INTERNALS
6284
6285 =item BUGS
6286
6287 =item AUTHOR
6288
6289 =back
6290
6291 =head2 fields - compile-time class fields
6292
6293 =over 4
6294
6295 =item SYNOPSIS
6296
6297 =item DESCRIPTION
6298
6299 new, phash
6300
6301 =item SEE ALSO
6302
6303 =back
6304
6305 =head2 filetest - Perl pragma to control the filetest permission operators
6306
6307 =over 4
6308
6309 =item SYNOPSIS
6310
6311 =item DESCRIPTION
6312
6313 =over 4
6314
6315 =item subpragma access
6316
6317 =back
6318
6319 =back
6320
6321 =head2 integer - Perl pragma to compute arithmetic in integer instead of
6322 double
6323
6324 =over 4
6325
6326 =item SYNOPSIS
6327
6328 =item DESCRIPTION
6329
6330 =back
6331
6332 =head2 less - perl pragma to request less of something from the compiler
6333
6334 =over 4
6335
6336 =item SYNOPSIS
6337
6338 =item DESCRIPTION
6339
6340 =back
6341
6342 =head2 lib - manipulate @INC at compile time
6343
6344 =over 4
6345
6346 =item SYNOPSIS
6347
6348 =item DESCRIPTION
6349
6350 =over 4
6351
6352 =item Adding directories to @INC
6353
6354 =item Deleting directories from @INC
6355
6356 =item Restoring original @INC
6357
6358 =back
6359
6360 =item SEE ALSO
6361
6362 =item AUTHOR
6363
6364 =back
6365
6366 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
6367 operations
6368
6369 =over 4
6370
6371 =item SYNOPSIS
6372
6373 =item DESCRIPTION
6374
6375 =back
6376
6377 =head2 open - perl pragma to set default disciplines for input and output
6378
6379 =over 4
6380
6381 =item SYNOPSIS
6382
6383 =item DESCRIPTION
6384
6385 =item UNIMPLEMENTED FUNCTIONALITY
6386
6387 =item SEE ALSO
6388
6389 =back
6390
6391 =head2 ops - Perl pragma to restrict unsafe operations when compiling
6392
6393 =over 4
6394
6395 =item SYNOPSIS
6396
6397 =item DESCRIPTION
6398
6399 =item SEE ALSO
6400
6401 =back
6402
6403 =head2 overload - Package for overloading perl operations
6404
6405 =over 4
6406
6407 =item SYNOPSIS
6408
6409 =item DESCRIPTION
6410
6411 =over 4
6412
6413 =item Declaration of overloaded functions
6414
6415 =item Calling Conventions for Binary Operations
6416
6417 FALSE, TRUE, C<undef>
6418
6419 =item Calling Conventions for Unary Operations
6420
6421 =item Calling Conventions for Mutators
6422
6423 C<++> and C<-->, C<x=> and other assignment versions
6424
6425 =item Overloadable Operations
6426
6427 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
6428 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
6429 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
6430
6431 =item Inheritance and overloading
6432
6433 Strings as values of C<use overload> directive, Overloading of an operation
6434 is inherited by derived classes
6435
6436 =back
6437
6438 =item SPECIAL SYMBOLS FOR C<use overload>
6439
6440 =over 4
6441
6442 =item Last Resort
6443
6444 =item Fallback
6445
6446 C<undef>, TRUE, defined, but FALSE
6447
6448 =item Copy Constructor
6449
6450 B<Example>
6451
6452 =back
6453
6454 =item MAGIC AUTOGENERATION
6455
6456 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
6457 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
6458 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
6459 I<Copy operator>
6460
6461 =item Losing overloading
6462
6463 =item Run-time Overloading
6464
6465 =item Public functions
6466
6467 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
6468
6469 =item Overloading constants
6470
6471 integer, float, binary, q, qr
6472
6473 =item IMPLEMENTATION
6474
6475 =item Metaphor clash
6476
6477 =item Cookbook
6478
6479 =over 4
6480
6481 =item Two-face scalars
6482
6483 =item Two-face references
6484
6485 =item Symbolic calculator
6486
6487 =item I<Really> symbolic calculator
6488
6489 =back
6490
6491 =item AUTHOR
6492
6493 =item DIAGNOSTICS
6494
6495 Odd number of arguments for overload::constant, `%s' is not an overloadable
6496 type, `%s' is not a code reference
6497
6498 =item BUGS
6499
6500 =back
6501
6502 =head2 perlio - perl pragma to configure C level IO
6503
6504 =over 4
6505
6506 =item SYNOPSIS
6507
6508 =item DESCRIPTION
6509
6510 unix, stdio, perlio
6511
6512 =over 4
6513
6514 =item Defaults and how to override them
6515
6516 =back
6517
6518 =item AUTHOR
6519
6520 =back
6521
6522 =head2 re - Perl pragma to alter regular expression behaviour
6523
6524 =over 4
6525
6526 =item SYNOPSIS
6527
6528 =item DESCRIPTION
6529
6530 =back
6531
6532 =head2 sigtrap - Perl pragma to enable simple signal handling
6533
6534 =over 4
6535
6536 =item SYNOPSIS
6537
6538 =item DESCRIPTION
6539
6540 =item OPTIONS
6541
6542 =over 4
6543
6544 =item SIGNAL HANDLERS
6545
6546 B<stack-trace>, B<die>, B<handler> I<your-handler>
6547
6548 =item SIGNAL LISTS
6549
6550 B<normal-signals>, B<error-signals>, B<old-interface-signals>
6551
6552 =item OTHER
6553
6554 B<untrapped>, B<any>, I<signal>, I<number>
6555
6556 =back
6557
6558 =item EXAMPLES
6559
6560 =back
6561
6562 =head2 strict - Perl pragma to restrict unsafe constructs
6563
6564 =over 4
6565
6566 =item SYNOPSIS
6567
6568 =item DESCRIPTION
6569
6570 C<strict refs>, C<strict vars>, C<strict subs>
6571
6572 =back
6573
6574 =head2 subs - Perl pragma to predeclare sub names
6575
6576 =over 4
6577
6578 =item SYNOPSIS
6579
6580 =item DESCRIPTION
6581
6582 =back
6583
6584 =head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data
6585 and non-UTF data.
6586
6587 =over 4
6588
6589 =item SYNOPSIS
6590
6591 =item DESCRIPTION
6592
6593 =item SEE ALSO
6594
6595 =back
6596
6597 =head2 utf8 - Perl pragma to enable/disable UTF-8 in source code
6598
6599 =over 4
6600
6601 =item SYNOPSIS
6602
6603 =item DESCRIPTION
6604
6605 =item SEE ALSO
6606
6607 =back
6608
6609 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
6610
6611 =over 4
6612
6613 =item SYNOPSIS
6614
6615 =item DESCRIPTION
6616
6617 =back
6618
6619 =head2 warnings - Perl pragma to control optional warnings
6620
6621 =over 4
6622
6623 =item SYNOPSIS
6624
6625 =item DESCRIPTION
6626
6627 use warnings::register, warnings::enabled(), warnings::enabled($category),
6628 warnings::enabled($object), warnings::warn($message),
6629 warnings::warn($category, $message), warnings::warn($object, $message),
6630 warnings::warnif($message), warnings::warnif($category, $message),
6631 warnings::warnif($object, $message)
6632
6633 =back
6634
6635 =head2 warnings::register - warnings import function
6636
6637 =head1 MODULE DOCUMENTATION
6638
6639 =head2 AnyDBM_File - provide framework for multiple DBMs
6640
6641 =over 4
6642
6643 =item SYNOPSIS
6644
6645 =item DESCRIPTION
6646
6647 =over 4
6648
6649 =item DBM Comparisons
6650
6651 [0], [1], [2], [3]
6652
6653 =back
6654
6655 =item SEE ALSO
6656
6657 =back
6658
6659 =head2 AutoLoader - load subroutines only on demand
6660
6661 =over 4
6662
6663 =item SYNOPSIS
6664
6665 =item DESCRIPTION
6666
6667 =over 4
6668
6669 =item Subroutine Stubs
6670
6671 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
6672
6673 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
6674
6675 =item Package Lexicals
6676
6677 =item Not Using AutoLoader
6678
6679 =item B<AutoLoader> vs. B<SelfLoader>
6680
6681 =back
6682
6683 =item CAVEATS
6684
6685 =item SEE ALSO
6686
6687 =back
6688
6689 =head2 AutoSplit - split a package for autoloading
6690
6691 =over 4
6692
6693 =item SYNOPSIS
6694
6695 =item DESCRIPTION
6696
6697 $keep, $check, $modtime
6698
6699 =over 4
6700
6701 =item Multiple packages
6702
6703 =back
6704
6705 =item DIAGNOSTICS
6706
6707 =back
6708
6709 =head2 B - The Perl Compiler
6710
6711 =over 4
6712
6713 =item SYNOPSIS
6714
6715 =item DESCRIPTION
6716
6717 =item OVERVIEW OF CLASSES
6718
6719 =over 4
6720
6721 =item SV-RELATED CLASSES
6722
6723 =item B::SV METHODS
6724
6725 REFCNT, FLAGS
6726
6727 =item B::IV METHODS
6728
6729 IV, IVX, needs64bits, packiv
6730
6731 =item B::NV METHODS
6732
6733 NV, NVX
6734
6735 =item B::RV METHODS
6736
6737 RV
6738
6739 =item B::PV METHODS
6740
6741 PV
6742
6743 =item B::PVMG METHODS
6744
6745 MAGIC, SvSTASH
6746
6747 =item B::MAGIC METHODS
6748
6749 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
6750
6751 =item B::PVLV METHODS
6752
6753 TARGOFF, TARGLEN, TYPE, TARG
6754
6755 =item B::BM METHODS
6756
6757 USEFUL, PREVIOUS, RARE, TABLE
6758
6759 =item B::GV METHODS
6760
6761 is_empty, NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE,
6762 FILEGV, GvREFCNT, FLAGS
6763
6764 =item B::IO METHODS
6765
6766 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
6767 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
6768
6769 =item B::AV METHODS
6770
6771 FILL, MAX, OFF, ARRAY, AvFLAGS
6772
6773 =item B::CV METHODS
6774
6775 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
6776 CvFLAGS, const_sv
6777
6778 =item B::HV METHODS
6779
6780 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
6781
6782 =item OP-RELATED CLASSES
6783
6784 =item B::OP METHODS
6785
6786 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
6787
6788 =item B::UNOP METHOD
6789
6790 first
6791
6792 =item B::BINOP METHOD
6793
6794 last
6795
6796 =item B::LOGOP METHOD
6797
6798 other
6799
6800 =item B::LISTOP METHOD
6801
6802 children
6803
6804 =item B::PMOP METHODS
6805
6806 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
6807
6808 =item B::SVOP METHOD
6809
6810 sv, gv
6811
6812 =item B::PADOP METHOD
6813
6814 padix
6815
6816 =item B::PVOP METHOD
6817
6818 pv
6819
6820 =item B::LOOP METHODS
6821
6822 redoop, nextop, lastop
6823
6824 =item B::COP METHODS
6825
6826 label, stash, file, cop_seq, arybase, line
6827
6828 =back
6829
6830 =item FUNCTIONS EXPORTED BY C<B>
6831
6832 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
6833 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
6834 walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM),
6835 hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names
6836
6837 =item AUTHOR
6838
6839 =back
6840
6841 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
6842 bytecode
6843
6844 =over 4
6845
6846 =item SYNOPSIS
6847
6848 =item DESCRIPTION
6849
6850 =item AUTHOR
6851
6852 =back
6853
6854 =head2 B::Assembler - Assemble Perl bytecode
6855
6856 =over 4
6857
6858 =item SYNOPSIS
6859
6860 =item DESCRIPTION
6861
6862 =item AUTHORS
6863
6864 =back
6865
6866 =head2 B::Bblock - Walk basic blocks
6867
6868 =over 4
6869
6870 =item SYNOPSIS
6871
6872 =item DESCRIPTION
6873
6874 =item AUTHOR
6875
6876 =back
6877
6878 =head2 B::Bytecode - Perl compiler's bytecode backend
6879
6880 =over 4
6881
6882 =item SYNOPSIS
6883
6884 =item DESCRIPTION
6885
6886 =item OPTIONS
6887
6888 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
6889 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
6890 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>    Stores package in the
6891 output.    =back
6892
6893 =item EXAMPLES
6894
6895 =item BUGS
6896
6897 =item AUTHORS
6898
6899 =back
6900
6901 =head2 B::C - Perl compiler's C backend
6902
6903 =over 4
6904
6905 =item SYNOPSIS
6906
6907 =item DESCRIPTION
6908
6909 =item OPTIONS
6910
6911 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
6912 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
6913
6914 =item EXAMPLES
6915
6916 =item BUGS
6917
6918 =item AUTHOR
6919
6920 =back
6921
6922 =head2 B::CC - Perl compiler's optimized C translation backend
6923
6924 =over 4
6925
6926 =item SYNOPSIS
6927
6928 =item DESCRIPTION
6929
6930 =item OPTIONS
6931
6932 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
6933 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
6934 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
6935
6936 =item EXAMPLES
6937
6938 =item BUGS
6939
6940 =item DIFFERENCES
6941
6942 =over 4
6943
6944 =item Loops
6945
6946 =item Context of ".."
6947
6948 =item Arithmetic
6949
6950 =item Deprecated features
6951
6952 =back
6953
6954 =item AUTHOR
6955
6956 =back
6957
6958 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
6959
6960 =over 4
6961
6962 =item SYNOPSIS
6963
6964 =item DESCRIPTION
6965
6966 =item AUTHOR
6967
6968 =back
6969
6970 =head2 B::Deparse - Perl compiler backend to produce perl code
6971
6972 =over 4
6973
6974 =item SYNOPSIS
6975
6976 =item DESCRIPTION
6977
6978 =item OPTIONS
6979
6980 B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
6981 B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
6982
6983 =item USING B::Deparse AS A MODULE
6984
6985 =over 4
6986
6987 =item Synopsis
6988
6989 =item Description
6990
6991 =item new
6992
6993 =item coderef2text
6994
6995 =back
6996
6997 =item BUGS
6998
6999 =item AUTHOR
7000
7001 =back
7002
7003 =head2 B::Disassembler - Disassemble Perl bytecode
7004
7005 =over 4
7006
7007 =item SYNOPSIS
7008
7009 =item DESCRIPTION
7010
7011 =item AUTHOR
7012
7013 =back
7014
7015 =head2 B::Lint - Perl lint
7016
7017 =over 4
7018
7019 =item SYNOPSIS
7020
7021 =item DESCRIPTION
7022
7023 =item OPTIONS AND LINT CHECKS
7024
7025 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
7026 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
7027
7028 =item NON LINT-CHECK OPTIONS
7029
7030 B<-u Package>
7031
7032 =item BUGS
7033
7034 =item AUTHOR
7035
7036 =back
7037
7038 =head2 B::O, O - Generic interface to Perl Compiler backends
7039
7040 =over 4
7041
7042 =item SYNOPSIS
7043
7044 =item DESCRIPTION
7045
7046 =item CONVENTIONS
7047
7048 =item IMPLEMENTATION
7049
7050 =item AUTHOR
7051
7052 =back
7053
7054 =head2 B::Showlex - Show lexical variables used in functions or files
7055
7056 =over 4
7057
7058 =item SYNOPSIS
7059
7060 =item DESCRIPTION
7061
7062 =item AUTHOR
7063
7064 =back
7065
7066 =head2 B::Stackobj - Helper module for CC backend
7067
7068 =over 4
7069
7070 =item SYNOPSIS
7071
7072 =item DESCRIPTION
7073
7074 =item AUTHOR
7075
7076 =back
7077
7078 =head2 B::Stash - show what stashes are loaded
7079
7080 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
7081
7082 =over 4
7083
7084 =item SYNOPSIS
7085
7086 =item DESCRIPTION
7087
7088 =item AUTHOR
7089
7090 =back
7091
7092 =head2 B::Xref - Generates cross reference reports for Perl programs
7093
7094 =over 4
7095
7096 =item SYNOPSIS
7097
7098 =item DESCRIPTION
7099
7100 =item OPTIONS
7101
7102 C<-oFILENAME>, C<-r>, C<-D[tO]>
7103
7104 =item BUGS
7105
7106 =item AUTHOR
7107
7108 =back
7109
7110 =head2 Bblock, B::Bblock - Walk basic blocks
7111
7112 =over 4
7113
7114 =item SYNOPSIS
7115
7116 =item DESCRIPTION
7117
7118 =item AUTHOR
7119
7120 =back
7121
7122 =head2 Benchmark - benchmark running times of Perl code
7123
7124 =over 4
7125
7126 =item SYNOPSIS
7127
7128 =item DESCRIPTION
7129
7130 =over 4
7131
7132 =item Methods
7133
7134 new, debug, iters
7135
7136 =item Standard Exports
7137
7138 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
7139 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
7140 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
7141
7142 =item Optional Exports
7143
7144 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
7145 STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
7146 ), enablecache ( ), timesum ( T1, T2 )
7147
7148 =back
7149
7150 =item NOTES
7151
7152 =item EXAMPLES
7153
7154 =item INHERITANCE
7155
7156 =item CAVEATS
7157
7158 =item SEE ALSO
7159
7160 =item AUTHORS
7161
7162 =item MODIFICATION HISTORY
7163
7164 =back
7165
7166 =head2 ByteLoader - load byte compiled perl code
7167
7168 =over 4
7169
7170 =item SYNOPSIS
7171
7172 =item DESCRIPTION
7173
7174 =item AUTHOR
7175
7176 =item SEE ALSO
7177
7178 =back
7179
7180 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
7181
7182 =over 4
7183
7184 =item SYNOPSIS
7185
7186 =item DESCRIPTION
7187
7188 =item OPTIONS
7189
7190 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
7191 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
7192 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>    Stores package in the
7193 output.    =back
7194
7195 =item EXAMPLES
7196
7197 =item BUGS
7198
7199 =item AUTHORS
7200
7201 =back
7202
7203 =head2 CGI - Simple Common Gateway Interface Class
7204
7205 =over 4
7206
7207 =item SYNOPSIS
7208
7209 =item ABSTRACT
7210
7211 =item DESCRIPTION
7212
7213 =over 4
7214
7215 =item PROGRAMMING STYLE
7216
7217 =item CALLING CGI.PM ROUTINES
7218
7219 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
7220
7221 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
7222
7223 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
7224
7225 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
7226
7227 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
7228
7229 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
7230
7231 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
7232
7233 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
7234
7235 =item DELETING A PARAMETER COMPLETELY:
7236
7237 =item DELETING ALL PARAMETERS:
7238
7239 =item DIRECT ACCESS TO THE PARAMETER LIST:
7240
7241 =item FETCHING THE PARAMETER LIST AS A HASH:
7242
7243 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
7244
7245 =item RETRIEVING CGI ERRORS
7246
7247 =item USING THE FUNCTION-ORIENTED INTERFACE
7248
7249 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
7250 B<:standard>, B<:all>
7251
7252 =item PRAGMAS
7253
7254 -any, -compile, -nosticky, -no_xhtml, -nph, -newstyle_urls, -oldstyle_urls,
7255 -autoload, -no_debug, -debug, -private_tempfiles
7256
7257 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
7258
7259 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
7260 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
7261 a </UL> tag)
7262
7263 =back
7264
7265 =item GENERATING DYNAMIC DOCUMENTS
7266
7267 =over 4
7268
7269 =item CREATING A STANDARD HTTP HEADER:
7270
7271 =item GENERATING A REDIRECTION HEADER
7272
7273 =item CREATING THE HTML DOCUMENT HEADER
7274
7275 B<Parameters:>, 4, 5, 6..
7276
7277 =item ENDING THE HTML DOCUMENT:
7278
7279 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
7280
7281 =item OBTAINING THE SCRIPT'S URL
7282
7283 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
7284 (B<-query_string>), B<-base>
7285
7286 =item MIXING POST AND URL PARAMETERS
7287
7288 =back
7289
7290 =item CREATING STANDARD HTML ELEMENTS:
7291
7292 =over 4
7293
7294 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
7295
7296 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
7297
7298 =item HTML SHORTCUTS AND LIST INTERPOLATION
7299
7300 =item NON-STANDARD HTML SHORTCUTS
7301
7302 =item AUTOESCAPING HTML
7303
7304 $escaped_string = escapeHTML("unescaped string");, $charset =
7305 charset([$charset]);, $flag = autoEscape([$flag]);
7306
7307 =item PRETTY-PRINTING HTML
7308
7309 =back
7310
7311 =item CREATING FILL-OUT FORMS:
7312
7313 =over 4
7314
7315 =item CREATING AN ISINDEX TAG
7316
7317 =item STARTING AND ENDING A FORM
7318
7319 B<application/x-www-form-urlencoded>, B<multipart/form-data>
7320
7321 =item CREATING A TEXT FIELD
7322
7323 B<Parameters>
7324
7325 =item CREATING A BIG TEXT FIELD
7326
7327 =item CREATING A PASSWORD FIELD
7328
7329 =item CREATING A FILE UPLOAD FIELD
7330
7331 B<Parameters>
7332
7333 =item CREATING A POPUP MENU
7334
7335 =item CREATING A SCROLLING LIST
7336
7337 B<Parameters:>
7338
7339 =item CREATING A GROUP OF RELATED CHECKBOXES
7340
7341 B<Parameters:>
7342
7343 =item CREATING A STANDALONE CHECKBOX
7344
7345 B<Parameters:>
7346
7347 =item CREATING A RADIO BUTTON GROUP
7348
7349 B<Parameters:>
7350
7351 =item CREATING A SUBMIT BUTTON
7352
7353 B<Parameters:>
7354
7355 =item CREATING A RESET BUTTON
7356
7357 =item CREATING A DEFAULT BUTTON
7358
7359 =item CREATING A HIDDEN FIELD
7360
7361 B<Parameters:>
7362
7363 =item CREATING A CLICKABLE IMAGE BUTTON
7364
7365 B<Parameters:>
7366
7367 =item CREATING A JAVASCRIPT ACTION BUTTON
7368
7369 =back
7370
7371 =item HTTP COOKIES
7372
7373 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
7374 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
7375
7376 =item WORKING WITH FRAMES
7377
7378 1. Create a <Frameset> document, 2. Specify the destination for the
7379 document in the HTTP header, 3. Specify the destination for the document in
7380 the <FORM> tag
7381
7382 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
7383
7384 =item DEBUGGING
7385
7386 =over 4
7387
7388 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
7389
7390 =back
7391
7392 =item FETCHING ENVIRONMENT VARIABLES
7393
7394 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
7395 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
7396 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
7397 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
7398 B<request_method()>, B<content_type()>, B<http()>, B<https()>
7399
7400 =item USING NPH SCRIPTS
7401
7402 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
7403 parameters
7404
7405 =item Server Push
7406
7407 multipart_init(), multipart_start(), multipart_end()
7408
7409 =item Avoiding Denial of Service Attacks
7410
7411 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
7412 basis>, B<2. Globally for all scripts>
7413
7414 =item COMPATIBILITY WITH CGI-LIB.PL
7415
7416 =item AUTHOR INFORMATION
7417
7418 =item CREDITS
7419
7420 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
7421 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
7422 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
7423 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
7424 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
7425 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
7426 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
7427 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
7428 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
7429 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
7430 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
7431 ...and many many more..
7432
7433 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
7434
7435 =item BUGS
7436
7437 =item SEE ALSO
7438
7439 =back
7440
7441 =head2 CGI::Apache - Backward compatibility module for CGI.pm
7442
7443 =over 4
7444
7445 =item SYNOPSIS
7446
7447 =item ABSTRACT
7448
7449 =item DESCRIPTION
7450
7451 =item AUTHOR INFORMATION
7452
7453 =item BUGS
7454
7455 =item SEE ALSO
7456
7457 =back
7458
7459 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
7460 other) error log
7461
7462 =over 4
7463
7464 =item SYNOPSIS
7465
7466 =item DESCRIPTION
7467
7468 =item REDIRECTING ERROR MESSAGES
7469
7470 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
7471
7472 =over 4
7473
7474 =item Changing the default message
7475
7476 =back
7477
7478 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
7479
7480 =item CHANGE LOG
7481
7482 =item AUTHORS
7483
7484 =item SEE ALSO
7485
7486 =back
7487
7488 =head2 CGI::Cookie - Interface to Netscape Cookies
7489
7490 =over 4
7491
7492 =item SYNOPSIS
7493
7494 =item DESCRIPTION
7495
7496 =item USING CGI::Cookie
7497
7498 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
7499
7500 =over 4
7501
7502 =item Creating New Cookies
7503
7504 =item Sending the Cookie to the Browser
7505
7506 =item Recovering Previous Cookies
7507
7508 =item Manipulating Cookies
7509
7510 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
7511
7512 =back
7513
7514 =item AUTHOR INFORMATION
7515
7516 =item BUGS
7517
7518 =item SEE ALSO
7519
7520 =back
7521
7522 =head2 CGI::Fast - CGI Interface for Fast CGI
7523
7524 =over 4
7525
7526 =item SYNOPSIS
7527
7528 =item DESCRIPTION
7529
7530 =item OTHER PIECES OF THE PUZZLE
7531
7532 =item WRITING FASTCGI PERL SCRIPTS
7533
7534 =item INSTALLING FASTCGI SCRIPTS
7535
7536 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
7537
7538 =item CAVEATS
7539
7540 =item AUTHOR INFORMATION
7541
7542 =item BUGS
7543
7544 =item SEE ALSO
7545
7546 =back
7547
7548 =head2 CGI::Pretty - module to produce nicely formatted HTML code
7549
7550 =over 4
7551
7552 =item SYNOPSIS
7553
7554 =item DESCRIPTION
7555
7556 =over 4
7557
7558 =item Tags that won't be formatted
7559
7560 =item Customizing the Indenting
7561
7562 =back
7563
7564 =item BUGS
7565
7566 =item AUTHOR
7567
7568 =item SEE ALSO
7569
7570 =back
7571
7572 =head2 CGI::Push - Simple Interface to Server Push
7573
7574 =over 4
7575
7576 =item SYNOPSIS
7577
7578 =item DESCRIPTION
7579
7580 =item USING CGI::Push
7581
7582 -next_page, -last_page, -type, -delay, -cookie, -target, -expires
7583
7584 =over 4
7585
7586 =item Heterogeneous Pages
7587
7588 =item Changing the Page Delay on the Fly
7589
7590 =back
7591
7592 =item INSTALLING CGI::Push SCRIPTS
7593
7594 =item AUTHOR INFORMATION
7595
7596 =item BUGS
7597
7598 =item SEE ALSO
7599
7600 =back
7601
7602 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
7603
7604 =over 4
7605
7606 =item SYNOPSIS
7607
7608 =item ABSTRACT
7609
7610 =item DESCRIPTION
7611
7612 =item AUTHOR INFORMATION
7613
7614 =item BUGS
7615
7616 =item SEE ALSO
7617
7618 =back
7619
7620 =head2 CPAN - query, download and build perl modules from CPAN sites
7621
7622 =over 4
7623
7624 =item SYNOPSIS
7625
7626 =item DESCRIPTION
7627
7628 =over 4
7629
7630 =item Interactive Mode
7631
7632 Searching for authors, bundles, distribution files and modules, make, test,
7633 install, clean  modules or distributions, get, readme, look module or
7634 distribution, Signals
7635
7636 =item CPAN::Shell
7637
7638 =item autobundle
7639
7640 =item recompile
7641
7642 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
7643
7644 =item Programmer's interface
7645
7646 expand($type,@things), expandany(@things), Programming Examples
7647
7648 =item Methods in the other Classes
7649
7650 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
7651 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
7652 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
7653 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
7654 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
7655 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
7656 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
7657 CPAN::Bundle::readme(), CPAN::Bundle::test(),
7658 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
7659 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
7660 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
7661 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
7662 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
7663 CPAN::Distribution::look(), CPAN::Distribution::make(),
7664 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
7665 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
7666 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
7667 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
7668 CPAN::Module::clean(), CPAN::Module::cpan_file(),
7669 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
7670 CPAN::Module::description(), CPAN::Module::force($method,@args),
7671 CPAN::Module::get(), CPAN::Module::inst_file(),
7672 CPAN::Module::inst_version(), CPAN::Module::install(),
7673 CPAN::Module::look(), CPAN::Module::make(),
7674 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
7675 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
7676
7677 =item Cache Manager
7678
7679 =item Bundles
7680
7681 =item Prerequisites
7682
7683 =item Finding packages and VERSION
7684
7685 =item Debugging
7686
7687 =item Floppy, Zip, Offline Mode
7688
7689 =back
7690
7691 =item CONFIGURATION
7692
7693 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
7694 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
7695 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
7696 [unshift|push|splice] E<lt>listE<gt>>
7697
7698 =over 4
7699
7700 =item Note on urllist parameter's format
7701
7702 =item urllist parameter has CD-ROM support
7703
7704 =back
7705
7706 =item SECURITY
7707
7708 =item EXPORT
7709
7710 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
7711
7712 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
7713
7714 =over 4
7715
7716 =item Three basic types of firewalls
7717
7718 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
7719
7720 =item Configuring lynx or ncftp for going through a firewall
7721
7722 =back
7723
7724 =item FAQ
7725
7726 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
7727
7728 =item BUGS
7729
7730 =item AUTHOR
7731
7732 =item SEE ALSO
7733
7734 =back
7735
7736 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
7737
7738 =over 4
7739
7740 =item SYNOPSIS
7741
7742 =item DESCRIPTION
7743
7744 =back
7745
7746 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
7747 module
7748
7749 =over 4
7750
7751 =item SYNOPSIS
7752
7753 =item DESCRIPTION
7754
7755 =item  SEE ALSO
7756
7757 =back
7758
7759 =head2 Carp, carp    - warn of errors (from perspective of caller)
7760
7761 =over 4
7762
7763 =item SYNOPSIS
7764
7765 =item DESCRIPTION
7766
7767 =over 4
7768
7769 =item Forcing a Stack Trace
7770
7771 =back
7772
7773 =item BUGS
7774
7775 =back
7776
7777 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
7778
7779 =head2 Class::Struct - declare struct-like datatypes as Perl classes
7780
7781 =over 4
7782
7783 =item SYNOPSIS
7784
7785 =item DESCRIPTION
7786
7787 =over 4
7788
7789 =item The C<struct()> function
7790
7791 =item Class Creation at Compile Time
7792
7793 =item Element Types and Accessor Methods
7794
7795 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
7796 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
7797
7798 =item Initializing with C<new>
7799
7800 =back
7801
7802 =item EXAMPLES
7803
7804 Example 1, Example 2, Example 3
7805
7806 =item Author and Modification History
7807
7808 =back
7809
7810 =head2 Config - access Perl configuration information
7811
7812 =over 4
7813
7814 =item SYNOPSIS
7815
7816 =item DESCRIPTION
7817
7818 myconfig(), config_sh(), config_vars(@names)
7819
7820 =item EXAMPLE
7821
7822 =item WARNING
7823
7824 =item GLOSSARY
7825
7826 =over 4
7827
7828 =item _
7829
7830 C<_a>, C<_exe>, C<_o>
7831
7832 =item a
7833
7834 C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<api_revision>,
7835 C<api_subversion>, C<api_version>, C<api_versionstring>, C<ar>, C<archlib>,
7836 C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk>
7837
7838 =item b
7839
7840 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
7841 C<byacc>, C<byteorder>
7842
7843 =item c
7844
7845 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
7846 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
7847 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
7848 C<clocktype>, C<comm>, C<compress>
7849
7850 =item C
7851
7852 C<CONFIGDOTSH>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
7853 C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
7854 C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh>
7855
7856 =item d
7857
7858 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
7859 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
7860 C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
7861 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
7862 C<d_chsize>, C<d_closedir>, C<d_const>, C<d_crypt>, C<d_csh>, C<d_cuserid>,
7863 C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>,
7864 C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>,
7865 C<d_endgrent>, C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>,
7866 C<d_endsent>, C<d_eofnblk>, C<d_eunice>, C<d_fchmod>, C<d_fchown>,
7867 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
7868 C<d_fds_bits>, C<d_fgetpos>, C<d_flexfnam>, C<d_flock>, C<d_fork>,
7869 C<d_fpathconf>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>,
7870 C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>,
7871 C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>,
7872 C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
7873 C<d_gethent>, C<d_gethname>, C<d_gethostprotos>, C<d_getlogin>,
7874 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
7875 C<d_getnent>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
7876 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
7877 C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>,
7878 C<d_getpwent>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
7879 C<d_getservprotos>, C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>,
7880 C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>, C<d_iconv>, C<d_index>,
7881 C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isnan>, C<d_isnanl>,
7882 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>,
7883 C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>,
7884 C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>,
7885 C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>,
7886 C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>,
7887 C<d_mmap>, C<d_modfl>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
7888 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
7889 C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>, C<d_msync>,
7890 C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nv_preserves_uv>,
7891 C<d_nv_preserves_uv_bits>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
7892 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
7893 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
7894 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
7895 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
7896 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_yield>, C<d_pwage>,
7897 C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>,
7898 C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>,
7899 C<d_readlink>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>,
7900 C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>,
7901 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
7902 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
7903 C<d_semop>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrps>,
7904 C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>,
7905 C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
7906 C<d_setproctitle>, C<d_setpwent>, C<d_setregid>, C<d_setresgid>,
7907 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
7908 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
7909 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
7910 C<d_sigsetjmp>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
7911 C<d_socks5_init>, C<d_sqrtl>, C<d_statblks>, C<d_statfs_f_flags>,
7912 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
7913 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
7914 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
7915 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strtod>,
7916 C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>,
7917 C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>,
7918 C<d_syscall>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, C<d_system>,
7919 C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>,
7920 C<d_times>, C<d_truncate>, C<d_tzname>, C<d_umask>, C<d_uname>,
7921 C<d_union_semun>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
7922 C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
7923 C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
7924 C<d_wctomb>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
7925 C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
7926 C<drand01>, C<dynamic_ext>
7927
7928 =item e
7929
7930 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
7931 C<exe_ext>, C<expr>, C<extensions>
7932
7933 =item f
7934
7935 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
7936 C<fpossize>, C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
7937
7938 =item g
7939
7940 C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
7941 C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
7942
7943 =item h
7944
7945 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
7946
7947 =item i
7948
7949 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
7950 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
7951 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
7952 C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_libutil>,
7953 C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>,
7954 C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>,
7955 C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, C<i_pthread>, C<i_pwd>,
7956 C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>,
7957 C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sunmath>,
7958 C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>,
7959 C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, C<i_sysmount>,
7960 C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>,
7961 C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, C<i_sysstatvfs>,
7962 C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>,
7963 C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>,
7964 C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>,
7965 C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
7966 C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>,
7967 C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>,
7968 C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>,
7969 C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>,
7970 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
7971 C<installvendorlib>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>,
7972 C<ivtype>
7973
7974 =item k
7975
7976 C<known_extensions>, C<ksh>
7977
7978 =item l
7979
7980 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
7981 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
7982 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
7983 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
7984 C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>,
7985 C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
7986
7987 =item m
7988
7989 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
7990 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
7991 C<man3direxp>, C<man3ext>
7992
7993 =item M
7994
7995 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
7996 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
7997
7998 =item n
7999
8000 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
8001 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
8002 C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
8003 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
8004
8005 =item o
8006
8007 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
8008 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
8009
8010 =item p
8011
8012 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
8013 C<perl>
8014
8015 =item P
8016
8017 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
8018 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
8019 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
8020 C<privlibexp>, C<prototype>, C<ptrsize>
8021
8022 =item q
8023
8024 C<quadkind>, C<quadtype>
8025
8026 =item r
8027
8028 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
8029 C<revision>, C<rm>, C<rmail>, C<runnm>
8030
8031 =item s
8032
8033 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
8034 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
8035 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
8036 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>,
8037 C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitelib>,
8038 C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, C<siteprefixexp>,
8039 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
8040 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
8041 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
8042 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
8043 C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
8044 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
8045 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
8046 C<strings>, C<submit>, C<subversion>, C<sysman>
8047
8048 =item t
8049
8050 C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>,
8051 C<touch>, C<tr>, C<trnl>, C<troff>
8052
8053 =item u
8054
8055 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
8056 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
8057 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
8058 C<use64bitint>, C<usedl>, C<useithreads>, C<uselargefiles>,
8059 C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, C<usemymalloc>,
8060 C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, C<usesfio>,
8061 C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>,
8062 C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>,
8063 C<uvxformat>, C<uvXUformat>
8064
8065 =item v
8066
8067 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
8068 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
8069 C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags>
8070
8071 =item x
8072
8073 C<xlibpth>, C<xs_apiversion>
8074
8075 =item z
8076
8077 C<zcat>, C<zip>
8078
8079 =back
8080
8081 =item NOTE
8082
8083 =back
8084
8085 =head2 Cwd, getcwd - get pathname of current working directory
8086
8087 =over 4
8088
8089 =item SYNOPSIS
8090
8091 =item DESCRIPTION
8092
8093 =back
8094
8095 =head2 DB - programmatic interface to the Perl debugging API (draft,
8096 subject to
8097 change)
8098
8099 =over 4
8100
8101 =item SYNOPSIS
8102
8103 =item DESCRIPTION
8104
8105 =over 4
8106
8107 =item Global Variables
8108
8109  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
8110 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
8111 $DB::lineno
8112
8113 =item API Methods
8114
8115 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
8116 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
8117
8118 =item Client Callback Methods
8119
8120 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
8121 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
8122 CLIENT->output(LIST)
8123
8124 =back
8125
8126 =item BUGS
8127
8128 =item AUTHOR
8129
8130 =back
8131
8132 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
8133
8134 =over 4
8135
8136 =item SYNOPSIS
8137
8138 =item DESCRIPTION
8139
8140 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
8141
8142 =over 4
8143
8144 =item Using DB_File with Berkeley DB version 2 or 3
8145
8146 =item Interface to Berkeley DB
8147
8148 =item Opening a Berkeley DB Database File
8149
8150 =item Default Parameters
8151
8152 =item In Memory Databases
8153
8154 =back
8155
8156 =item DB_HASH
8157
8158 =over 4
8159
8160 =item A Simple Example
8161
8162 =back
8163
8164 =item DB_BTREE
8165
8166 =over 4
8167
8168 =item Changing the BTREE sort order
8169
8170 =item Handling Duplicate Keys
8171
8172 =item The get_dup() Method
8173
8174 =item The find_dup() Method
8175
8176 =item The del_dup() Method
8177
8178 =item Matching Partial Keys
8179
8180 =back
8181
8182 =item DB_RECNO
8183
8184 =over 4
8185
8186 =item The 'bval' Option
8187
8188 =item A Simple Example
8189
8190 =item Extra RECNO Methods
8191
8192 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
8193 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
8194
8195 =item Another Example
8196
8197 =back
8198
8199 =item THE API INTERFACE
8200
8201 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
8202 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
8203 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
8204 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
8205
8206 =item DBM FILTERS
8207
8208 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
8209 B<filter_fetch_value>
8210
8211 =over 4
8212
8213 =item The Filter
8214
8215 =item An Example -- the NULL termination problem.
8216
8217 =item Another Example -- Key is a C int.
8218
8219 =back
8220
8221 =item HINTS AND TIPS
8222
8223 =over 4
8224
8225 =item Locking: The Trouble with fd
8226
8227 =item Safe ways to lock a database
8228
8229 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
8230
8231 =item Sharing Databases With C Applications
8232
8233 =item The untie() Gotcha
8234
8235 =back
8236
8237 =item COMMON QUESTIONS
8238
8239 =over 4
8240
8241 =item Why is there Perl source in my database?
8242
8243 =item How do I store complex data structures with DB_File?
8244
8245 =item What does "Invalid Argument" mean?
8246
8247 =item What does "Bareword 'DB_File' not allowed" mean?
8248
8249 =back
8250
8251 =item REFERENCES
8252
8253 =item HISTORY
8254
8255 =item BUGS
8256
8257 =item AVAILABILITY
8258
8259 =item COPYRIGHT
8260
8261 =item SEE ALSO
8262
8263 =item AUTHOR
8264
8265 =back
8266
8267 =head2 Data::Dumper - stringified perl data structures, suitable for both
8268 printing and C<eval>
8269
8270 =over 4
8271
8272 =item SYNOPSIS
8273
8274 =item DESCRIPTION
8275
8276 =over 4
8277
8278 =item Methods
8279
8280 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
8281 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
8282 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
8283 I<$OBJ>->Reset
8284
8285 =item Functions
8286
8287 Dumper(I<LIST>)
8288
8289 =item Configuration Variables or Methods
8290
8291 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
8292 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
8293 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
8294 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
8295 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
8296 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
8297 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
8298 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
8299 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
8300 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
8301 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
8302 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>)
8303
8304 =item Exports
8305
8306 Dumper
8307
8308 =back
8309
8310 =item EXAMPLES
8311
8312 =item BUGS
8313
8314 =item AUTHOR
8315
8316 =item VERSION
8317
8318 =item SEE ALSO
8319
8320 =back
8321
8322 =head2 Devel::DProf - a Perl code profiler
8323
8324 =over 4
8325
8326 =item SYNOPSIS
8327
8328 =item DESCRIPTION
8329
8330 =item PROFILE FORMAT
8331
8332 =item AUTOLOAD
8333
8334 =item ENVIRONMENT
8335
8336 =item BUGS
8337
8338 =item SEE ALSO
8339
8340 =back
8341
8342 =head2 Devel::Peek - A data debugging tool for the XS programmer
8343
8344 =over 4
8345
8346 =item SYNOPSIS
8347
8348 =item DESCRIPTION
8349
8350 =over 4
8351
8352 =item Memory footprint debugging
8353
8354 =back
8355
8356 =item EXAMPLES
8357
8358 =over 4
8359
8360 =item A simple scalar string
8361
8362 =item A simple scalar number
8363
8364 =item A simple scalar with an extra reference
8365
8366 =item A reference to a simple scalar
8367
8368 =item A reference to an array
8369
8370 =item A reference to a hash
8371
8372 =item Dumping a large array or hash
8373
8374 =item A reference to an SV which holds a C pointer
8375
8376 =item A reference to a subroutine
8377
8378 =back
8379
8380 =item EXPORTS
8381
8382 =item BUGS
8383
8384 =item AUTHOR
8385
8386 =item SEE ALSO
8387
8388 =back
8389
8390 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
8391
8392 =over 4
8393
8394 =item SYNOPSIS
8395
8396 =item DESCRIPTION
8397
8398 =back
8399
8400 =head2 DirHandle - supply object methods for directory handles
8401
8402 =over 4
8403
8404 =item SYNOPSIS
8405
8406 =item DESCRIPTION
8407
8408 =back
8409
8410 =head2 Dumpvalue - provides screen dump of Perl data.
8411
8412 =over 4
8413
8414 =item SYNOPSIS
8415
8416 =item DESCRIPTION
8417
8418 =over 4
8419
8420 =item Creation
8421
8422 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
8423 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
8424 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
8425 stopDbSignal
8426
8427 =item Methods
8428
8429 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
8430 veryCompact, set, get
8431
8432 =back
8433
8434 =back
8435
8436 =head2 DynaLoader - Dynamically load C libraries into Perl code
8437
8438 =over 4
8439
8440 =item SYNOPSIS
8441
8442 =item DESCRIPTION
8443
8444 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
8445 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
8446 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
8447 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
8448 bootstrap()
8449
8450 =item AUTHOR
8451
8452 =back
8453
8454 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
8455 Perl code
8456
8457 =over 4
8458
8459 =item SYNOPSIS
8460
8461 =item DESCRIPTION
8462
8463 =item AUTHOR
8464
8465 =back
8466
8467 =head2 Encode - character encodings
8468
8469 =over 4
8470
8471 =item TERMINOLOGY
8472
8473 =item bytes
8474
8475 =item chars
8476
8477 =item chars With Encoding
8478
8479 =item Testing For UTF-8
8480
8481 =item Toggling UTF-8-ness
8482
8483 =item UTF-16 and UTF-32 Encodings
8484
8485 =item Handling Malformed Data
8486
8487 =back
8488
8489 =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
8490 of the Encode extension
8491
8492 =over 4
8493
8494 =item DESCRIPTION
8495
8496 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
8497
8498 =item KEYWORDS
8499
8500 =item COPYRIGHT
8501
8502 =back
8503
8504 =head2 EncodeFormat - the format of encoding tables of the Encode extension
8505
8506 =over 4
8507
8508 =item DESCRIPTION
8509
8510 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
8511
8512 =item KEYWORDS
8513
8514 =item COPYRIGHT
8515
8516 =back
8517
8518 =head2 English - use nice English (or awk) names for ugly punctuation
8519 variables
8520
8521 =over 4
8522
8523 =item SYNOPSIS
8524
8525 =item DESCRIPTION
8526
8527 =item PERFORMANCE
8528
8529 =back
8530
8531 =head2 Env - perl module that imports environment variables as scalars or
8532 arrays
8533
8534 =over 4
8535
8536 =item SYNOPSIS
8537
8538 =item DESCRIPTION
8539
8540 =item LIMITATIONS
8541
8542 =item AUTHOR
8543
8544 =back
8545
8546 =head2 Errno - System errno constants
8547
8548 =over 4
8549
8550 =item SYNOPSIS
8551
8552 =item DESCRIPTION
8553
8554 =item CAVEATS
8555
8556 =item AUTHOR
8557
8558 =item COPYRIGHT
8559
8560 =back
8561
8562 =head2 Exporter - Implements default import method for modules
8563
8564 =over 4
8565
8566 =item SYNOPSIS
8567
8568 =item DESCRIPTION
8569
8570 =over 4
8571
8572 =item How to Export
8573
8574 =item Selecting What To Export
8575
8576 =item Specialised Import Lists
8577
8578 =item Exporting without using Export's import method
8579
8580 =item Module Version Checking
8581
8582 =item Managing Unknown Symbols
8583
8584 =item Tag Handling Utility Functions
8585
8586 =back
8587
8588 =back
8589
8590 =head2 Exporter::Heavy - Exporter guts
8591
8592 =over 4
8593
8594 =item SYNOPIS
8595
8596 =item DESCRIPTION
8597
8598 =back
8599
8600 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
8601 Makefiles etc.
8602
8603 =over 4
8604
8605 =item SYNOPSIS
8606
8607 =item DESCRIPTION
8608
8609 =back
8610
8611 cat
8612
8613 eqtime src dst
8614
8615 rm_f files...
8616
8617 rm_f files...
8618
8619 touch files ..
8620
8621 mv source... destination
8622
8623 cp source... destination
8624
8625 chmod mode files..
8626
8627 mkpath directory..
8628
8629 test_f file
8630
8631 =over 4
8632
8633 =item BUGS
8634
8635 =item SEE ALSO
8636
8637 =item AUTHOR
8638
8639 =back
8640
8641 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
8642
8643 =over 4
8644
8645 =item SYNOPSIS
8646
8647 =item DESCRIPTION
8648
8649 =item @EXPORT
8650
8651 =item FUNCTIONS
8652
8653 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
8654 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
8655
8656 =item EXAMPLES
8657
8658 =item SEE ALSO
8659
8660 =item AUTHOR
8661
8662 =back
8663
8664 =head2 ExtUtils::Install - install files from here to there
8665
8666 =over 4
8667
8668 =item SYNOPSIS
8669
8670 =item DESCRIPTION
8671
8672 =back
8673
8674 =head2 ExtUtils::Installed - Inventory management of installed modules
8675
8676 =over 4
8677
8678 =item SYNOPSIS
8679
8680 =item DESCRIPTION
8681
8682 =item USAGE
8683
8684 =item FUNCTIONS
8685
8686 new(), modules(), files(), directories(), directory_tree(), validate(),
8687 packlist(), version()
8688
8689 =item EXAMPLE
8690
8691 =item AUTHOR
8692
8693 =back
8694
8695 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
8696
8697 =over 4
8698
8699 =item SYNOPSIS
8700
8701 =item DESCRIPTION
8702
8703 For static extensions, For dynamic extensions, For dynamic extensions
8704
8705 =over 4
8706
8707 =item EXTRALIBS
8708
8709 =item LDLOADLIBS and LD_RUN_PATH
8710
8711 =item BSLOADLIBS
8712
8713 =back
8714
8715 =item PORTABILITY
8716
8717 =over 4
8718
8719 =item VMS implementation
8720
8721 =item Win32 implementation
8722
8723 =back
8724
8725 =item SEE ALSO
8726
8727 =back
8728
8729 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
8730 ExtUtils::MakeMaker
8731
8732 =over 4
8733
8734 =item SYNOPSIS
8735
8736 =item DESCRIPTION
8737
8738 canonpath, cflags, manifypods, perl_archive
8739
8740 =back
8741
8742 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
8743 ExtUtils::MakeMaker
8744
8745 =over 4
8746
8747 =item SYNOPSIS
8748
8749 =item DESCRIPTION
8750
8751 =back
8752
8753 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
8754
8755 =over 4
8756
8757 =item SYNOPSIS
8758
8759 =item DESCRIPTION
8760
8761 =item METHODS
8762
8763 =over 4
8764
8765 =item Preloaded methods
8766
8767 canonpath
8768
8769 =back
8770
8771 =back
8772
8773 catdir
8774
8775 catfile
8776
8777 curdir
8778
8779 rootdir
8780
8781 updir
8782
8783 =over 4
8784
8785 =item SelfLoaded methods
8786
8787 c_o (o)
8788
8789 =back
8790
8791 cflags (o)
8792
8793 clean (o)
8794
8795 const_cccmd (o)
8796
8797 const_config (o)
8798
8799 const_loadlibs (o)
8800
8801 constants (o)
8802
8803 depend (o)
8804
8805 dir_target (o)
8806
8807 dist (o)
8808
8809 dist_basics (o)
8810
8811 dist_ci (o)
8812
8813 dist_core (o)
8814
8815 dist_dir (o)
8816
8817 dist_test (o)
8818
8819 dlsyms (o)
8820
8821 dynamic (o)
8822
8823 dynamic_bs (o)
8824
8825 dynamic_lib (o)
8826
8827 exescan
8828
8829 extliblist
8830
8831 file_name_is_absolute
8832
8833 find_perl
8834
8835 =over 4
8836
8837 =item Methods to actually produce chunks of text for the Makefile
8838
8839 fixin
8840
8841 =back
8842
8843 force (o)
8844
8845 guess_name
8846
8847 has_link_code
8848
8849 htmlifypods (o)
8850
8851 init_dirscan
8852
8853 init_main
8854
8855 init_others
8856
8857 install (o)
8858
8859 installbin (o)
8860
8861 libscan (o)
8862
8863 linkext (o)
8864
8865 lsdir
8866
8867 macro (o)
8868
8869 makeaperl (o)
8870
8871 makefile (o)
8872
8873 manifypods (o)
8874
8875 maybe_command
8876
8877 maybe_command_in_dirs
8878
8879 needs_linking (o)
8880
8881 nicetext
8882
8883 parse_version
8884
8885 parse_abstract
8886
8887 pasthru (o)
8888
8889 path
8890
8891 perl_script
8892
8893 perldepend (o)
8894
8895 ppd
8896
8897 perm_rw (o)
8898
8899 perm_rwx (o)
8900
8901 pm_to_blib
8902
8903 post_constants (o)
8904
8905 post_initialize (o)
8906
8907 postamble (o)
8908
8909 prefixify
8910
8911 processPL (o)
8912
8913 realclean (o)
8914
8915 replace_manpage_separator
8916
8917 static (o)
8918
8919 static_lib (o)
8920
8921 staticmake (o)
8922
8923 subdir_x (o)
8924
8925 subdirs (o)
8926
8927 test (o)
8928
8929 test_via_harness (o)
8930
8931 test_via_script (o)
8932
8933 tool_autosplit (o)
8934
8935 tools_other (o)
8936
8937 tool_xsubpp (o)
8938
8939 top_targets (o)
8940
8941 writedoc
8942
8943 xs_c (o)
8944
8945 xs_cpp (o)
8946
8947 xs_o (o)
8948
8949 perl_archive
8950
8951 export_list
8952
8953 =over 4
8954
8955 =item SEE ALSO
8956
8957 =back
8958
8959 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
8960 ExtUtils::MakeMaker
8961
8962 =over 4
8963
8964 =item SYNOPSIS
8965
8966 =item DESCRIPTION
8967
8968 =over 4
8969
8970 =item Methods always loaded
8971
8972 wraplist
8973
8974 =back
8975
8976 =back
8977
8978 rootdir (override)
8979
8980 =over 4
8981
8982 =item SelfLoaded methods
8983
8984 guess_name (override)
8985
8986 =back
8987
8988 find_perl (override)
8989
8990 path (override)
8991
8992 maybe_command (override)
8993
8994 maybe_command_in_dirs (override)
8995
8996 perl_script (override)
8997
8998 file_name_is_absolute (override)
8999
9000 replace_manpage_separator
9001
9002 init_others (override)
9003
9004 constants (override)
9005
9006 cflags (override)
9007
9008 const_cccmd (override)
9009
9010 pm_to_blib (override)
9011
9012 tool_autosplit (override)
9013
9014 tool_sxubpp (override)
9015
9016 xsubpp_version (override)
9017
9018 tools_other (override)
9019
9020 dist (override)
9021
9022 c_o (override)
9023
9024 xs_c (override)
9025
9026 xs_o (override)
9027
9028 top_targets (override)
9029
9030 dlsyms (override)
9031
9032 dynamic_lib (override)
9033
9034 dynamic_bs (override)
9035
9036 static_lib (override)
9037
9038 manifypods (override)
9039
9040 processPL (override)
9041
9042 installbin (override)
9043
9044 subdir_x (override)
9045
9046 clean (override)
9047
9048 realclean (override)
9049
9050 dist_basics (override)
9051
9052 dist_core (override)
9053
9054 dist_dir (override)
9055
9056 dist_test (override)
9057
9058 install (override)
9059
9060 perldepend (override)
9061
9062 makefile (override)
9063
9064 test (override)
9065
9066 test_via_harness (override)
9067
9068 test_via_script (override)
9069
9070 makeaperl (override)
9071
9072 nicetext (override)
9073
9074 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
9075 ExtUtils::MakeMaker
9076
9077 =over 4
9078
9079 =item SYNOPSIS
9080
9081 =item DESCRIPTION
9082
9083 =back
9084
9085 catfile
9086
9087 constants (o)
9088
9089 static_lib (o)
9090
9091 dynamic_bs (o)
9092
9093 dynamic_lib (o)
9094
9095 canonpath
9096
9097 perl_script
9098
9099 pm_to_blib
9100
9101 test_via_harness (o)
9102
9103 tool_autosplit (override)
9104
9105 tools_other (o)
9106
9107 xs_o (o)
9108
9109 top_targets (o)
9110
9111 htmlifypods (o)
9112
9113 manifypods (o)
9114
9115 dist_ci (o)
9116
9117 dist_core (o)
9118
9119 pasthru (o)
9120
9121 =head2 ExtUtils::MakeMaker - create an extension Makefile
9122
9123 =over 4
9124
9125 =item SYNOPSIS
9126
9127 =item DESCRIPTION
9128
9129 =over 4
9130
9131 =item How To Write A Makefile.PL
9132
9133 =item Default Makefile Behaviour
9134
9135 =item make test
9136
9137 =item make testdb
9138
9139 =item make install
9140
9141 =item PREFIX and LIB attribute
9142
9143 =item AFS users
9144
9145 =item Static Linking of a new Perl Binary
9146
9147 =item Determination of Perl Library and Installation Locations
9148
9149 =item Which architecture dependent directory?
9150
9151 =item Using Attributes and Parameters
9152
9153 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
9154 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
9155 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
9156 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
9157 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
9158 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
9159 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
9160 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
9161 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
9162 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
9163 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
9164 PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX,
9165 PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
9166 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION,
9167 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
9168
9169 =item Additional lowercase attributes
9170
9171 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
9172 tool_autosplit
9173
9174 =item Overriding MakeMaker Methods
9175
9176 =item Hintsfile support
9177
9178 =item Distribution Support
9179
9180    make distcheck,    make skipcheck,    make distclean,    make manifest,
9181   make distdir,    make tardist,    make dist,    make uutardist,    make
9182 shdist,    make zipdist,    make ci
9183
9184 =item Disabling an extension
9185
9186 =back
9187
9188 =item ENVIRONMENT
9189
9190 PERL_MM_OPT
9191
9192 =item SEE ALSO
9193
9194 =item AUTHORS
9195
9196 =back
9197
9198 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
9199
9200 =over 4
9201
9202 =item SYNOPSIS
9203
9204 =item DESCRIPTION
9205
9206 =item MANIFEST.SKIP
9207
9208 =item EXPORT_OK
9209
9210 =item GLOBAL VARIABLES
9211
9212 =item DIAGNOSTICS
9213
9214 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
9215 C<Added to MANIFEST:> I<file>
9216
9217 =item ENVIRONMENT
9218
9219 B<PERL_MM_MANIFEST_DEBUG>
9220
9221 =item SEE ALSO
9222
9223 =item AUTHOR
9224
9225 =back
9226
9227 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
9228
9229 =over 4
9230
9231 =item SYNOPSIS
9232
9233 =item DESCRIPTION
9234
9235 =item SEE ALSO
9236
9237 =back
9238
9239 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
9240
9241 =over 4
9242
9243 =item SYNOPSIS
9244
9245 =item DESCRIPTION
9246
9247 =back
9248
9249 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
9250 extension
9251
9252 =over 4
9253
9254 =item SYNOPSIS
9255
9256 =item DESCRIPTION
9257
9258 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
9259
9260 =item AUTHOR
9261
9262 =item REVISION
9263
9264 =back
9265
9266 =head2 ExtUtils::Packlist - manage .packlist files
9267
9268 =over 4
9269
9270 =item SYNOPSIS
9271
9272 =item DESCRIPTION
9273
9274 =item USAGE
9275
9276 =item FUNCTIONS
9277
9278 new(), read(), write(), validate(), packlist_file()
9279
9280 =item EXAMPLE
9281
9282 =item AUTHOR
9283
9284 =back
9285
9286 =head2 ExtUtils::testlib - add blib/* directories to @INC
9287
9288 =over 4
9289
9290 =item SYNOPSIS
9291
9292 =item DESCRIPTION
9293
9294 =back
9295
9296 =head2 Fatal - replace functions with equivalents which succeed or die
9297
9298 =over 4
9299
9300 =item SYNOPSIS
9301
9302 =item DESCRIPTION
9303
9304 =item AUTHOR
9305
9306 =back
9307
9308 =head2 Fcntl - load the C Fcntl.h defines
9309
9310 =over 4
9311
9312 =item SYNOPSIS
9313
9314 =item DESCRIPTION
9315
9316 =item NOTE
9317
9318 =item EXPORTED SYMBOLS
9319
9320 =back
9321
9322 =head2 File::Basename, fileparse - split a pathname into pieces
9323
9324 =over 4
9325
9326 =item SYNOPSIS
9327
9328 =item DESCRIPTION
9329
9330 fileparse_set_fstype, fileparse
9331
9332 =item EXAMPLES
9333
9334 C<basename>, C<dirname>
9335
9336 =back
9337
9338 =head2 File::CheckTree, validate - run many filetest checks on a tree
9339
9340 =over 4
9341
9342 =item SYNOPSIS
9343
9344 =item DESCRIPTION
9345
9346 =back
9347
9348 =head2 File::Compare - Compare files or filehandles
9349
9350 =over 4
9351
9352 =item SYNOPSIS
9353
9354 =item DESCRIPTION
9355
9356 =item RETURN
9357
9358 =item AUTHOR
9359
9360 =back
9361
9362 =head2 File::Copy - Copy files or filehandles
9363
9364 =over 4
9365
9366 =item SYNOPSIS
9367
9368 =item DESCRIPTION
9369
9370 =over 4
9371
9372 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
9373
9374 rmscopy($from,$to[,$date_flag])
9375
9376 =back
9377
9378 =item RETURN
9379
9380 =item AUTHOR
9381
9382 =back
9383
9384 =head2 File::DosGlob - DOS like globbing and then some
9385
9386 =over 4
9387
9388 =item SYNOPSIS
9389
9390 =item DESCRIPTION
9391
9392 =item EXPORTS (by request only)
9393
9394 =item BUGS
9395
9396 =item AUTHOR
9397
9398 =item HISTORY
9399
9400 =item SEE ALSO
9401
9402 =back
9403
9404 =head2 File::Find, find - traverse a file tree
9405
9406 =over 4
9407
9408 =item SYNOPSIS
9409
9410 =item DESCRIPTION
9411
9412 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
9413 C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>,
9414 C<untaint_pattern>, C<untaint_skip>
9415
9416 =item CAVEAT
9417
9418 =back
9419
9420 =head2 File::Glob - Perl extension for BSD glob routine
9421
9422 =over 4
9423
9424 =item SYNOPSIS
9425
9426 =item DESCRIPTION
9427
9428 C<GLOB_ERR>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, C<GLOB_NOSORT>,
9429 C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, C<GLOB_TILDE>, C<GLOB_CSH>
9430
9431 =item DIAGNOSTICS
9432
9433 C<GLOB_NOSPACE>, C<GLOB_ABEND>
9434
9435 =item NOTES
9436
9437 =item AUTHOR
9438
9439 =back
9440
9441 =head2 File::Path - create or remove directory trees
9442
9443 =over 4
9444
9445 =item SYNOPSIS
9446
9447 =item DESCRIPTION
9448
9449 =item AUTHORS
9450
9451 =back
9452
9453 =head2 File::Spec - portably perform operations on file names
9454
9455 =over 4
9456
9457 =item SYNOPSIS
9458
9459 =item DESCRIPTION
9460
9461 =item SEE ALSO
9462
9463 =item AUTHORS
9464
9465 =back
9466
9467 =head2 File::Spec::Epoc - methods for Epoc file specs
9468
9469 =over 4
9470
9471 =item SYNOPSIS
9472
9473 =item DESCRIPTION
9474
9475 devnull
9476
9477 =back
9478
9479 tmpdir
9480
9481 path
9482
9483 canonpath
9484
9485 splitpath
9486
9487 splitdir
9488
9489 catpath
9490
9491 abs2rel
9492
9493 rel2abs
9494
9495 =over 4
9496
9497 =item SEE ALSO
9498
9499 =back
9500
9501 =head2 File::Spec::Functions - portably perform operations on file names
9502
9503 =over 4
9504
9505 =item SYNOPSIS
9506
9507 =item DESCRIPTION
9508
9509 =over 4
9510
9511 =item Exports
9512
9513 =back
9514
9515 =item SEE ALSO
9516
9517 =back
9518
9519 =head2 File::Spec::Mac - File::Spec for MacOS
9520
9521 =over 4
9522
9523 =item SYNOPSIS
9524
9525 =item DESCRIPTION
9526
9527 =item METHODS
9528
9529 canonpath
9530
9531 =back
9532
9533 catdir
9534
9535 catfile
9536
9537 curdir
9538
9539 devnull
9540
9541 rootdir
9542
9543 tmpdir
9544
9545 updir
9546
9547 file_name_is_absolute
9548
9549 path
9550
9551 splitpath
9552
9553 splitdir
9554
9555 catpath
9556
9557 abs2rel
9558
9559 rel2abs
9560
9561 =over 4
9562
9563 =item SEE ALSO
9564
9565 =back
9566
9567 =head2 File::Spec::OS2 - methods for OS/2 file specs
9568
9569 =over 4
9570
9571 =item SYNOPSIS
9572
9573 =item DESCRIPTION
9574
9575 =back
9576
9577 =head2 File::Spec::Unix - methods used by File::Spec
9578
9579 =over 4
9580
9581 =item SYNOPSIS
9582
9583 =item DESCRIPTION
9584
9585 =item METHODS
9586
9587 canonpath
9588
9589 =back
9590
9591 catdir
9592
9593 catfile
9594
9595 curdir
9596
9597 devnull
9598
9599 rootdir
9600
9601 tmpdir
9602
9603 updir
9604
9605 no_upwards
9606
9607 case_tolerant
9608
9609 file_name_is_absolute
9610
9611 path
9612
9613 join
9614
9615 splitpath
9616
9617 splitdir
9618
9619 catpath
9620
9621 abs2rel
9622
9623 rel2abs
9624
9625 =over 4
9626
9627 =item SEE ALSO
9628
9629 =back
9630
9631 =head2 File::Spec::VMS - methods for VMS file specs
9632
9633 =over 4
9634
9635 =item SYNOPSIS
9636
9637 =item DESCRIPTION
9638
9639 eliminate_macros
9640
9641 =back
9642
9643 fixpath
9644
9645 =over 4
9646
9647 =item Methods always loaded
9648
9649 canonpath (override)
9650
9651 =back
9652
9653 catdir
9654
9655 catfile
9656
9657 curdir (override)
9658
9659 devnull (override)
9660
9661 rootdir (override)
9662
9663 tmpdir (override)
9664
9665 updir (override)
9666
9667 case_tolerant (override)
9668
9669 path (override)
9670
9671 file_name_is_absolute (override)
9672
9673 splitpath (override)
9674
9675 splitdir (override)
9676
9677 catpath (override)
9678
9679 abs2rel (override)
9680
9681 rel2abs (override)
9682
9683 =over 4
9684
9685 =item SEE ALSO
9686
9687 =back
9688
9689 =head2 File::Spec::Win32 - methods for Win32 file specs
9690
9691 =over 4
9692
9693 =item SYNOPSIS
9694
9695 =item DESCRIPTION
9696
9697 devnull
9698
9699 =back
9700
9701 tmpdir
9702
9703 catfile
9704
9705 canonpath
9706
9707 splitpath
9708
9709 splitdir
9710
9711 catpath
9712
9713 =over 4
9714
9715 =item SEE ALSO
9716
9717 =back
9718
9719 =head2 File::Temp - return name and handle of a temporary file safely
9720
9721 =over 4
9722
9723 =item PORTABILITY
9724
9725 =item SYNOPSIS
9726
9727 =item DESCRIPTION
9728
9729 =back
9730
9731 =over 4
9732
9733 =item FUNCTIONS
9734
9735 B<tempfile>
9736
9737 =back
9738
9739 B<tempdir>
9740
9741 =over 4
9742
9743 =item MKTEMP FUNCTIONS
9744
9745 B<mkstemp>
9746
9747 =back
9748
9749 B<mkstemps>
9750
9751 B<mkdtemp>
9752
9753 B<mktemp>
9754
9755 =over 4
9756
9757 =item POSIX FUNCTIONS
9758
9759 B<tmpnam>
9760
9761 =back
9762
9763 B<tmpfile>
9764
9765 =over 4
9766
9767 =item ADDITIONAL FUNCTIONS
9768
9769 B<tempnam>
9770
9771 =back
9772
9773 =over 4
9774
9775 =item UTILITY FUNCTIONS
9776
9777 B<unlink0>
9778
9779 =back
9780
9781 =over 4
9782
9783 =item PACKAGE VARIABLES
9784
9785 B<safe_level>, STANDARD, MEDIUM, HIGH
9786
9787 =back
9788
9789 TopSystemUID
9790
9791 =over 4
9792
9793 =item WARNING
9794
9795 =over 4
9796
9797 =item Temporary files and NFS
9798
9799 =back
9800
9801 =item HISTORY
9802
9803 =item SEE ALSO
9804
9805 =item AUTHOR
9806
9807 =back
9808
9809 =head2 File::stat - by-name interface to Perl's built-in stat() functions
9810
9811 =over 4
9812
9813 =item SYNOPSIS
9814
9815 =item DESCRIPTION
9816
9817 =item NOTE
9818
9819 =item AUTHOR
9820
9821 =back
9822
9823 =head2 FileCache - keep more files open than the system permits
9824
9825 =over 4
9826
9827 =item SYNOPSIS
9828
9829 =item DESCRIPTION
9830
9831 =item BUGS
9832
9833 =back
9834
9835 =head2 FileHandle - supply object methods for filehandles
9836
9837 =over 4
9838
9839 =item SYNOPSIS
9840
9841 =item DESCRIPTION
9842
9843 $fh->print, $fh->printf, $fh->getline, $fh->getlines
9844
9845 =item SEE ALSO
9846
9847 =back
9848
9849 =head2 Filter::Simple - Simplified source filtering
9850
9851 =over 4
9852
9853 =item SYNOPSIS
9854
9855 =item DESCRIPTION
9856
9857 =over 4
9858
9859 =item The Problem
9860
9861 =item A Solution
9862
9863 =item How it works
9864
9865 =back
9866
9867 =item AUTHOR
9868
9869 =item COPYRIGHT
9870
9871 =back
9872
9873 =head2 Filter::Util::Call - Perl Source Filter Utility Module
9874
9875 =over 4
9876
9877 =item SYNOPSIS
9878
9879     use Filter::Util::Call ;
9880
9881 =item DESCRIPTION
9882
9883 =over 4
9884
9885 =item B<use Filter::Util::Call>
9886
9887 =item B<import()>
9888
9889 =item B<filter() and anonymous sub>
9890
9891 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
9892
9893 =back
9894
9895 =item EXAMPLES
9896
9897 =over 4
9898
9899 =item Example 1: A simple filter.
9900
9901 =item Example 2: Using the context
9902
9903 =item Example 3: Using the context within the filter
9904
9905 =item Example 4: Using filter_del
9906
9907 =back
9908
9909 =item AUTHOR
9910
9911 =item DATE
9912
9913 =back
9914
9915 =head2 FindBin - Locate directory of original perl script
9916
9917 =over 4
9918
9919 =item SYNOPSIS
9920
9921 =item DESCRIPTION
9922
9923 =item EXPORTABLE VARIABLES
9924
9925 =item KNOWN BUGS
9926
9927 =item AUTHORS
9928
9929 =item COPYRIGHT
9930
9931 =back
9932
9933 =head2 GDBM_File - Perl5 access to the gdbm library.
9934
9935 =over 4
9936
9937 =item SYNOPSIS
9938
9939 =item DESCRIPTION
9940
9941 =item AVAILABILITY
9942
9943 =item BUGS
9944
9945 =item SEE ALSO
9946
9947 =back
9948
9949 =head2 Getopt::Long - Extended processing of command line options
9950
9951 =over 4
9952
9953 =item SYNOPSIS
9954
9955 =item DESCRIPTION
9956
9957 =item Command Line Options, an Introduction
9958
9959 =item Getting Started with Getopt::Long
9960
9961 =over 4
9962
9963 =item Simple options
9964
9965 =item A little bit less simple options
9966
9967 =item Mixing command line option with other arguments
9968
9969 =item Options with values
9970
9971 =item Options with multiple values
9972
9973 =item Options with hash values
9974
9975 =item User-defined subroutines to handle options
9976
9977 =item Options with multiple names
9978
9979 =item Case and abbreviations
9980
9981 =item Summary of Option Specifications
9982
9983 !, +, s, i, f, : I<type> [ I<desttype> ]
9984
9985 =back
9986
9987 =item Advanced Possibilities
9988
9989 =over 4
9990
9991 =item Object oriented interface
9992
9993 =item Documentation and help texts
9994
9995 =item Storing options in a hash
9996
9997 =item Bundling
9998
9999 =item The lonesome dash
10000
10001 =item Argument call-back
10002
10003 =back
10004
10005 =item Configuring Getopt::Long
10006
10007 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
10008 require_order, permute, bundling (default: disabled), bundling_override
10009 (default: disabled), ignore_case  (default: enabled), ignore_case_always
10010 (default: disabled), pass_through (default: disabled), prefix,
10011 prefix_pattern, debug (default: disabled)
10012
10013 =item Return values and Errors
10014
10015 =item Legacy
10016
10017 =over 4
10018
10019 =item Default destinations
10020
10021 =item Alternative option starters
10022
10023 =item Configuration variables
10024
10025 =back
10026
10027 =item Trouble Shooting
10028
10029 =over 4
10030
10031 =item Warning: Ignoring '!' modifier for short option
10032
10033 =item GetOptions does not return a false result when an option is not
10034 supplied
10035
10036 =back
10037
10038 =item AUTHOR
10039
10040 =item COPYRIGHT AND DISCLAIMER
10041
10042 =back
10043
10044 =head2 Getopt::Std, getopt - Process single-character switches with switch
10045 clustering
10046
10047 =over 4
10048
10049 =item SYNOPSIS
10050
10051 =item DESCRIPTION
10052
10053 =back
10054
10055 =head2 I18N::Collate - compare 8-bit scalar data according to the current
10056 locale
10057
10058 =over 4
10059
10060 =item SYNOPSIS
10061
10062 =item DESCRIPTION
10063
10064 =back
10065
10066 =head2 IO - load various IO modules
10067
10068 =over 4
10069
10070 =item SYNOPSIS
10071
10072 =item DESCRIPTION
10073
10074 =back
10075
10076 =head2 IO::Dir - supply object methods for directory handles
10077
10078 =over 4
10079
10080 =item SYNOPSIS
10081
10082 =item DESCRIPTION
10083
10084 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10085 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10086
10087 =item SEE ALSO
10088
10089 =item AUTHOR
10090
10091 =item COPYRIGHT
10092
10093 =back
10094
10095 =head2 IO::File - supply object methods for filehandles
10096
10097 =over 4
10098
10099 =item SYNOPSIS
10100
10101 =item DESCRIPTION
10102
10103 =item CONSTRUCTOR
10104
10105 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10106
10107 =item METHODS
10108
10109 open( FILENAME [,MODE [,PERMS]] )
10110
10111 =item SEE ALSO
10112
10113 =item HISTORY
10114
10115 =back
10116
10117 =head2 IO::Handle - supply object methods for I/O handles
10118
10119 =over 4
10120
10121 =item SYNOPSIS
10122
10123 =item DESCRIPTION
10124
10125 =item CONSTRUCTOR
10126
10127 new (), new_from_fd ( FD, MODE )
10128
10129 =item METHODS
10130
10131 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10132 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10133 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10134 $io->blocking ( [ BOOL ] ), $io->untaint
10135
10136 =item NOTE
10137
10138 =item SEE ALSO
10139
10140 =item BUGS
10141
10142 =item HISTORY
10143
10144 =back
10145
10146 =head2 IO::Pipe - supply object methods for pipes
10147
10148 =over 4
10149
10150 =item SYNOPSIS
10151
10152 =item DESCRIPTION
10153
10154 =item CONSTRUCTOR
10155
10156 new ( [READER, WRITER] )
10157
10158 =item METHODS
10159
10160 reader ([ARGS]), writer ([ARGS]), handles ()
10161
10162 =item SEE ALSO
10163
10164 =item AUTHOR
10165
10166 =item COPYRIGHT
10167
10168 =back
10169
10170 =head2 IO::Poll - Object interface to system poll call
10171
10172 =over 4
10173
10174 =item SYNOPSIS
10175
10176 =item DESCRIPTION
10177
10178 =item METHODS
10179
10180 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10181 IO ), handles( [ EVENT_MASK ] )
10182
10183 =item SEE ALSO
10184
10185 =item AUTHOR
10186
10187 =item COPYRIGHT
10188
10189 =back
10190
10191 =head2 IO::Seekable - supply seek based methods for I/O objects
10192
10193 =over 4
10194
10195 =item SYNOPSIS
10196
10197 =item DESCRIPTION
10198
10199 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10200 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10201 $io->tell
10202
10203 =item HISTORY
10204
10205 =back
10206
10207 =head2 IO::Select - OO interface to the select system call
10208
10209 =over 4
10210
10211 =item SYNOPSIS
10212
10213 =item DESCRIPTION
10214
10215 =item CONSTRUCTOR
10216
10217 new ( [ HANDLES ] )
10218
10219 =item METHODS
10220
10221 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
10222 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
10223 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
10224
10225 =item EXAMPLE
10226
10227 =item AUTHOR
10228
10229 =item COPYRIGHT
10230
10231 =back
10232
10233 =head2 IO::Socket - Object interface to socket communications
10234
10235 =over 4
10236
10237 =item SYNOPSIS
10238
10239 =item DESCRIPTION
10240
10241 =item CONSTRUCTOR
10242
10243 new ( [ARGS] )
10244
10245 =item METHODS
10246
10247 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
10248 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
10249
10250 =item SEE ALSO
10251
10252 =item AUTHOR
10253
10254 =item COPYRIGHT
10255
10256 =back
10257
10258 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
10259
10260 =over 4
10261
10262 =item SYNOPSIS
10263
10264 =item DESCRIPTION
10265
10266 =item CONSTRUCTOR
10267
10268 new ( [ARGS] )
10269
10270 =over 4
10271
10272 =item METHODS
10273
10274 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
10275 ()
10276
10277 =back
10278
10279 =item SEE ALSO
10280
10281 =item AUTHOR
10282
10283 =item COPYRIGHT
10284
10285 =back
10286
10287 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
10288
10289 =over 4
10290
10291 =item SYNOPSIS
10292
10293 =item DESCRIPTION
10294
10295 =item CONSTRUCTOR
10296
10297 new ( [ARGS] )
10298
10299 =item METHODS
10300
10301 hostpath(), peerpath()
10302
10303 =item SEE ALSO
10304
10305 =item AUTHOR
10306
10307 =item COPYRIGHT
10308
10309 =back
10310
10311 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
10312 handles
10313
10314 =over 4
10315
10316 =item SYNOPSIS
10317
10318 =item DESCRIPTION
10319
10320 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10321 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10322
10323 =item SEE ALSO
10324
10325 =item AUTHOR
10326
10327 =item COPYRIGHT
10328
10329 =back
10330
10331 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
10332
10333 =over 4
10334
10335 =item SYNOPSIS
10336
10337 =item DESCRIPTION
10338
10339 =item CONSTRUCTOR
10340
10341 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10342
10343 =item METHODS
10344
10345 open( FILENAME [,MODE [,PERMS]] )
10346
10347 =item SEE ALSO
10348
10349 =item HISTORY
10350
10351 =back
10352
10353 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
10354 handles
10355
10356 =over 4
10357
10358 =item SYNOPSIS
10359
10360 =item DESCRIPTION
10361
10362 =item CONSTRUCTOR
10363
10364 new (), new_from_fd ( FD, MODE )
10365
10366 =item METHODS
10367
10368 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10369 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10370 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10371 $io->blocking ( [ BOOL ] ), $io->untaint
10372
10373 =item NOTE
10374
10375 =item SEE ALSO
10376
10377 =item BUGS
10378
10379 =item HISTORY
10380
10381 =back
10382
10383 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
10384
10385 =over 4
10386
10387 =item SYNOPSIS
10388
10389 =item DESCRIPTION
10390
10391 =item CONSTRUCTOR
10392
10393 new ( [READER, WRITER] )
10394
10395 =item METHODS
10396
10397 reader ([ARGS]), writer ([ARGS]), handles ()
10398
10399 =item SEE ALSO
10400
10401 =item AUTHOR
10402
10403 =item COPYRIGHT
10404
10405 =back
10406
10407 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
10408
10409 =over 4
10410
10411 =item SYNOPSIS
10412
10413 =item DESCRIPTION
10414
10415 =item METHODS
10416
10417 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10418 IO ), handles( [ EVENT_MASK ] )
10419
10420 =item SEE ALSO
10421
10422 =item AUTHOR
10423
10424 =item COPYRIGHT
10425
10426 =back
10427
10428 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
10429 I/O objects
10430
10431 =over 4
10432
10433 =item SYNOPSIS
10434
10435 =item DESCRIPTION
10436
10437 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10438 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10439 $io->tell
10440
10441 =item HISTORY
10442
10443 =back
10444
10445 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
10446 call
10447
10448 =over 4
10449
10450 =item SYNOPSIS
10451
10452 =item DESCRIPTION
10453
10454 =item CONSTRUCTOR
10455
10456 new ( [ HANDLES ] )
10457
10458 =item METHODS
10459
10460 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
10461 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
10462 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
10463
10464 =item EXAMPLE
10465
10466 =item AUTHOR
10467
10468 =item COPYRIGHT
10469
10470 =back
10471
10472 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
10473 communications
10474
10475 =over 4
10476
10477 =item SYNOPSIS
10478
10479 =item DESCRIPTION
10480
10481 =item CONSTRUCTOR
10482
10483 new ( [ARGS] )
10484
10485 =item METHODS
10486
10487 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
10488 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
10489
10490 =item SEE ALSO
10491
10492 =item AUTHOR
10493
10494 =item COPYRIGHT
10495
10496 =back
10497
10498 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
10499 AF_INET domain sockets
10500
10501 =over 4
10502
10503 =item SYNOPSIS
10504
10505 =item DESCRIPTION
10506
10507 =item CONSTRUCTOR
10508
10509 new ( [ARGS] )
10510
10511 =over 4
10512
10513 =item METHODS
10514
10515 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
10516 ()
10517
10518 =back
10519
10520 =item SEE ALSO
10521
10522 =item AUTHOR
10523
10524 =item COPYRIGHT
10525
10526 =back
10527
10528 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
10529 AF_UNIX domain sockets
10530
10531 =over 4
10532
10533 =item SYNOPSIS
10534
10535 =item DESCRIPTION
10536
10537 =item CONSTRUCTOR
10538
10539 new ( [ARGS] )
10540
10541 =item METHODS
10542
10543 hostpath(), peerpath()
10544
10545 =item SEE ALSO
10546
10547 =item AUTHOR
10548
10549 =item COPYRIGHT
10550
10551 =back
10552
10553 =head2 IPC::Msg - SysV Msg IPC object class
10554
10555 =over 4
10556
10557 =item SYNOPSIS
10558
10559 =item DESCRIPTION
10560
10561 =item METHODS
10562
10563 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
10564 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
10565 FLAGS ] ), stat
10566
10567 =item SEE ALSO
10568
10569 =item AUTHOR
10570
10571 =item COPYRIGHT
10572
10573 =back
10574
10575 =head2 IPC::Open2, open2 - open a process for both reading and writing
10576
10577 =over 4
10578
10579 =item SYNOPSIS
10580
10581 =item DESCRIPTION
10582
10583 =item WARNING
10584
10585 =item SEE ALSO
10586
10587 =back
10588
10589 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
10590 handling
10591
10592 =over 4
10593
10594 =item SYNOPSIS
10595
10596 =item DESCRIPTION
10597
10598 =item WARNING
10599
10600 =back
10601
10602 =head2 IPC::Semaphore - SysV Semaphore IPC object class
10603
10604 =over 4
10605
10606 =item SYNOPSIS
10607
10608 =item DESCRIPTION
10609
10610 =item METHODS
10611
10612 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
10613 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
10614 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
10615 , VALUE ), stat
10616
10617 =item SEE ALSO
10618
10619 =item AUTHOR
10620
10621 =item COPYRIGHT
10622
10623 =back
10624
10625 =head2 IPC::SysV - SysV IPC constants
10626
10627 =over 4
10628
10629 =item SYNOPSIS
10630
10631 =item DESCRIPTION
10632
10633 ftok( PATH, ID )
10634
10635 =item SEE ALSO
10636
10637 =item AUTHORS
10638
10639 =item COPYRIGHT
10640
10641 =back
10642
10643 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
10644
10645 =over 4
10646
10647 =item SYNOPSIS
10648
10649 =item DESCRIPTION
10650
10651 =item METHODS
10652
10653 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
10654 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
10655 FLAGS ] ), stat
10656
10657 =item SEE ALSO
10658
10659 =item AUTHOR
10660
10661 =item COPYRIGHT
10662
10663 =back
10664
10665 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
10666 class
10667
10668 =over 4
10669
10670 =item SYNOPSIS
10671
10672 =item DESCRIPTION
10673
10674 =item METHODS
10675
10676 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
10677 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
10678 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
10679 , VALUE ), stat
10680
10681 =item SEE ALSO
10682
10683 =item AUTHOR
10684
10685 =item COPYRIGHT
10686
10687 =back
10688
10689 =head2 Math::BigFloat - Arbitrary length float math package
10690
10691 =over 4
10692
10693 =item SYNOPSIS
10694
10695 =item DESCRIPTION
10696
10697 number format, Error returns 'NaN', Division is computed to, Rounding is
10698 performed
10699
10700 =item BUGS
10701
10702 =item AUTHOR
10703
10704 =back
10705
10706 =head2 Math::BigInt - Arbitrary size integer math package
10707
10708 =over 4
10709
10710 =item SYNOPSIS
10711
10712 =item DESCRIPTION
10713
10714 Canonical notation, Input, Output
10715
10716 =item EXAMPLES
10717
10718 =item Autocreating constants
10719
10720 =item BUGS
10721
10722 =item AUTHOR
10723
10724 =back
10725
10726 =head2 Math::Complex - complex numbers and associated mathematical
10727 functions
10728
10729 =over 4
10730
10731 =item SYNOPSIS
10732
10733 =item DESCRIPTION
10734
10735 =item OPERATIONS
10736
10737 =item CREATION
10738
10739 =item STRINGIFICATION
10740
10741 =over 4
10742
10743 =item CHANGED IN PERL 5.6
10744
10745 =back
10746
10747 =item USAGE
10748
10749 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
10750
10751 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
10752
10753 =item BUGS
10754
10755 =item AUTHORS
10756
10757 =back
10758
10759 =head2 Math::Trig - trigonometric functions
10760
10761 =over 4
10762
10763 =item SYNOPSIS
10764
10765 =item DESCRIPTION
10766
10767 =item TRIGONOMETRIC FUNCTIONS
10768
10769 B<tan>
10770
10771 =over 4
10772
10773 =item ERRORS DUE TO DIVISION BY ZERO
10774
10775 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
10776
10777 =back
10778
10779 =item PLANE ANGLE CONVERSIONS
10780
10781 =item RADIAL COORDINATE CONVERSIONS
10782
10783 =over 4
10784
10785 =item COORDINATE SYSTEMS
10786
10787 =item 3-D ANGLE CONVERSIONS
10788
10789 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
10790 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
10791
10792 =back
10793
10794 =item GREAT CIRCLE DISTANCES
10795
10796 =item EXAMPLES
10797
10798 =item BUGS
10799
10800 =item AUTHORS
10801
10802 =back
10803
10804 =head2 NDBM_File - Tied access to ndbm files
10805
10806 =over 4
10807
10808 =item SYNOPSIS
10809
10810 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
10811
10812 =item DIAGNOSTICS
10813
10814 =over 4
10815
10816 =item C<ndbm store returned -1, errno 22, key "..." at ...>
10817
10818 =back
10819
10820 =item BUGS AND WARNINGS
10821
10822 =back
10823
10824 =head2 Net::Ping - check a remote host for reachability
10825
10826 =over 4
10827
10828 =item SYNOPSIS
10829
10830 =item DESCRIPTION
10831
10832 =over 4
10833
10834 =item Functions
10835
10836 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
10837 $timeout]);, $p->close();, pingecho($host [, $timeout]);
10838
10839 =back
10840
10841 =item WARNING
10842
10843 =item NOTES
10844
10845 =back
10846
10847 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
10848 functions
10849
10850 =over 4
10851
10852 =item SYNOPSIS
10853
10854 =item DESCRIPTION
10855
10856 =item EXAMPLES
10857
10858 =item NOTE
10859
10860 =item AUTHOR
10861
10862 =back
10863
10864 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
10865 functions
10866
10867 =over 4
10868
10869 =item SYNOPSIS
10870
10871 =item DESCRIPTION
10872
10873 =item EXAMPLES
10874
10875 =item NOTE
10876
10877 =item AUTHOR
10878
10879 =back
10880
10881 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
10882 functions
10883
10884 =over 4
10885
10886 =item SYNOPSIS
10887
10888 =item DESCRIPTION
10889
10890 =item NOTE
10891
10892 =item AUTHOR
10893
10894 =back
10895
10896 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
10897 functions
10898
10899 =over 4
10900
10901 =item SYNOPSIS
10902
10903 =item DESCRIPTION
10904
10905 =item EXAMPLES
10906
10907 =item NOTE
10908
10909 =item AUTHOR
10910
10911 =back
10912
10913 =head2 O - Generic interface to Perl Compiler backends
10914
10915 =over 4
10916
10917 =item SYNOPSIS
10918
10919 =item DESCRIPTION
10920
10921 =item CONVENTIONS
10922
10923 =item IMPLEMENTATION
10924
10925 =item AUTHOR
10926
10927 =back
10928
10929 =head2 ODBM_File - Tied access to odbm files
10930
10931 =over 4
10932
10933 =item SYNOPSIS
10934
10935 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
10936
10937 =item DIAGNOSTICS
10938
10939 =over 4
10940
10941 =item C<odbm store returned -1, errno 22, key "..." at ...>
10942
10943 =back
10944
10945 =item BUGS AND WARNINGS
10946
10947 =back
10948
10949 =head2 Opcode - Disable named opcodes when compiling perl code
10950
10951 =over 4
10952
10953 =item SYNOPSIS
10954
10955 =item DESCRIPTION
10956
10957 =item NOTE
10958
10959 =item WARNING
10960
10961 =item Operator Names and Operator Lists
10962
10963 an operator name (opname), an operator tag name (optag), a negated opname
10964 or optag, an operator set (opset)
10965
10966 =item Opcode Functions
10967
10968 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
10969 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
10970 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
10971 opdump (PAT)
10972
10973 =item Manipulating Opsets
10974
10975 =item TO DO (maybe)
10976
10977 =back
10978
10979 =over 4
10980
10981 =item Predefined Opcode Tags
10982
10983 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
10984 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
10985 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
10986 :dangerous
10987
10988 =item SEE ALSO
10989
10990 =item AUTHORS
10991
10992 =back
10993
10994 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
10995 compartments
10996
10997 =over 4
10998
10999 =item SYNOPSIS
11000
11001 =item DESCRIPTION
11002
11003 a new namespace, an operator mask
11004
11005 =item WARNING
11006
11007 =over 4
11008
11009 =item RECENT CHANGES
11010
11011 =item Methods in class Safe
11012
11013 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
11014 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
11015 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
11016 root (NAMESPACE), mask (MASK)
11017
11018 =item Some Safety Issues
11019
11020 Memory, CPU, Snooping, Signals, State Changes
11021
11022 =item AUTHOR
11023
11024 =back
11025
11026 =back
11027
11028 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
11029 compiling
11030
11031 =over 4
11032
11033 =item SYNOPSIS
11034
11035 =item DESCRIPTION
11036
11037 =item SEE ALSO
11038
11039 =back
11040
11041 =head2 POSIX - Perl interface to IEEE Std 1003.1
11042
11043 =over 4
11044
11045 =item SYNOPSIS
11046
11047 =item DESCRIPTION
11048
11049 =item NOTE
11050
11051 =item CAVEATS
11052
11053 =item FUNCTIONS
11054
11055 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
11056 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
11057 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
11058 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
11059 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
11060 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
11061 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
11062 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
11063 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
11064 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
11065 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
11066 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
11067 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
11068 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
11069 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
11070 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
11071 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
11072 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
11073 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
11074 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
11075 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
11076 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
11077 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
11078 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
11079 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
11080 wctomb, write
11081
11082 =item CLASSES
11083
11084 =over 4
11085
11086 =item POSIX::SigAction
11087
11088 new
11089
11090 =item POSIX::SigSet
11091
11092 new, addset, delset, emptyset, fillset, ismember
11093
11094 =item POSIX::Termios
11095
11096 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
11097 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
11098 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
11099 field values, c_cflag field values, c_iflag field values, c_lflag field
11100 values, c_oflag field values
11101
11102 =back
11103
11104 =item PATHNAME CONSTANTS
11105
11106 Constants
11107
11108 =item POSIX CONSTANTS
11109
11110 Constants
11111
11112 =item SYSTEM CONFIGURATION
11113
11114 Constants
11115
11116 =item ERRNO
11117
11118 Constants
11119
11120 =item FCNTL
11121
11122 Constants
11123
11124 =item FLOAT
11125
11126 Constants
11127
11128 =item LIMITS
11129
11130 Constants
11131
11132 =item LOCALE
11133
11134 Constants
11135
11136 =item MATH
11137
11138 Constants
11139
11140 =item SIGNAL
11141
11142 Constants
11143
11144 =item STAT
11145
11146 Constants, Macros
11147
11148 =item STDLIB
11149
11150 Constants
11151
11152 =item STDIO
11153
11154 Constants
11155
11156 =item TIME
11157
11158 Constants
11159
11160 =item UNISTD
11161
11162 Constants
11163
11164 =item WAIT
11165
11166 Constants, Macros
11167
11168 =back
11169
11170 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
11171
11172 =over 4
11173
11174 =item SYNOPSIS
11175
11176 =item OPTIONS/ARGUMENTS
11177
11178 =over 4
11179
11180 =item podchecker()
11181
11182 B<-warnings> =E<gt> I<val>
11183
11184 =back
11185
11186 =item DESCRIPTION
11187
11188 =item DIAGNOSTICS
11189
11190 =over 4
11191
11192 =item Errors
11193
11194 empty =headn, =over on line I<N> without closing =back, =item without
11195 previous =over, =back without previous =over, No argument for =begin, =end
11196 without =begin, Nested =begin's, =for without formatter specification,
11197 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
11198 interior-sequence "I<SEQ>", nested commands
11199 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
11200 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
11201 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
11202 after =back
11203
11204 =item Warnings
11205
11206 multiple occurence of link target I<name>, line containing nothing but
11207 whitespace in paragraph, file does not start with =head, No numeric
11208 argument for =over, previous =item has no contents, preceding non-item
11209 paragraph(s), =item type mismatch (I<one> vs. I<two>), I<N> unescaped
11210 C<E<lt>E<gt>> in paragraph, Unknown entity, No items in =over, No argument
11211 for =item, empty section in previous paragraph, Verbatim paragraph in NAME
11212 section
11213
11214 =item Hyperlinks
11215
11216 collapsing newlines to blanks, ignoring leading/trailing whitespace in
11217 link, (section) in '$page' deprecated, alternative text/node '%s' contains
11218 non-escaped | or /
11219
11220 =back
11221
11222 =item RETURN VALUE
11223
11224 =item EXAMPLES
11225
11226 =item INTERFACE
11227
11228 =back
11229
11230 C<Pod::Checker-E<gt>new( %options )>
11231
11232 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
11233 @args )>
11234
11235 C<$checker-E<gt>num_errors()>
11236
11237 C<$checker-E<gt>name()>
11238
11239 C<$checker-E<gt>node()>
11240
11241 C<$checker-E<gt>idx()>
11242
11243 C<$checker-E<gt>hyperlink()>
11244
11245 =over 4
11246
11247 =item AUTHOR
11248
11249 =back
11250
11251 =head2 Pod::Find - find POD documents in directory trees
11252
11253 =over 4
11254
11255 =item SYNOPSIS
11256
11257 =item DESCRIPTION
11258
11259 =back
11260
11261 =over 4
11262
11263 =item C<pod_find( { %opts } , @directories )>
11264
11265 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
11266 1>
11267
11268 =back
11269
11270 =over 4
11271
11272 =item C<simplify_name( $str )>
11273
11274 =back
11275
11276 =over 4
11277
11278 =item C<pod_where( { %opts }, $pod )>
11279
11280 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
11281 1>
11282
11283 =back
11284
11285 =over 4
11286
11287 =item C<contains_pod( $file , $verbose )>
11288
11289 =back
11290
11291 =over 4
11292
11293 =item AUTHOR
11294
11295 =item SEE ALSO
11296
11297 =back
11298
11299 =head2 Pod::Html - module to convert pod files to HTML
11300
11301 =over 4
11302
11303 =item SYNOPSIS
11304
11305 =item DESCRIPTION
11306
11307 =item ARGUMENTS
11308
11309 backlink, css, flush, header, help, htmldir, htmlroot, index, infile,
11310 libpods, netscape, outfile, podpath, podroot, quiet, recurse, title,
11311 verbose
11312
11313 =item EXAMPLE
11314
11315 =item ENVIRONMENT
11316
11317 =item AUTHOR
11318
11319 =item SEE ALSO
11320
11321 =item COPYRIGHT
11322
11323 =back
11324
11325 =head2 Pod::InputObjects - objects representing POD input paragraphs,
11326 commands, etc.
11327
11328 =over 4
11329
11330 =item SYNOPSIS
11331
11332 =item REQUIRES
11333
11334 =item EXPORTS
11335
11336 =item DESCRIPTION
11337
11338 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
11339 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
11340
11341 =back
11342
11343 =over 4
11344
11345 =item B<Pod::InputSource>
11346
11347 =back
11348
11349 =over 4
11350
11351 =item B<new()>
11352
11353 =back
11354
11355 =over 4
11356
11357 =item B<name()>
11358
11359 =back
11360
11361 =over 4
11362
11363 =item B<handle()>
11364
11365 =back
11366
11367 =over 4
11368
11369 =item B<was_cutting()>
11370
11371 =back
11372
11373 =over 4
11374
11375 =item B<Pod::Paragraph>
11376
11377 =back
11378
11379 =over 4
11380
11381 =item Pod::Paragraph-E<gt>B<new()>
11382
11383 =back
11384
11385 =over 4
11386
11387 =item $pod_para-E<gt>B<cmd_name()>
11388
11389 =back
11390
11391 =over 4
11392
11393 =item $pod_para-E<gt>B<text()>
11394
11395 =back
11396
11397 =over 4
11398
11399 =item $pod_para-E<gt>B<raw_text()>
11400
11401 =back
11402
11403 =over 4
11404
11405 =item $pod_para-E<gt>B<cmd_prefix()>
11406
11407 =back
11408
11409 =over 4
11410
11411 =item $pod_para-E<gt>B<cmd_separator()>
11412
11413 =back
11414
11415 =over 4
11416
11417 =item $pod_para-E<gt>B<parse_tree()>
11418
11419 =back
11420
11421 =over 4
11422
11423 =item $pod_para-E<gt>B<file_line()>
11424
11425 =back
11426
11427 =over 4
11428
11429 =item B<Pod::InteriorSequence>
11430
11431 =back
11432
11433 =over 4
11434
11435 =item Pod::InteriorSequence-E<gt>B<new()>
11436
11437 =back
11438
11439 =over 4
11440
11441 =item $pod_seq-E<gt>B<cmd_name()>
11442
11443 =back
11444
11445 =over 4
11446
11447 =item $pod_seq-E<gt>B<prepend()>
11448
11449 =back
11450
11451 =over 4
11452
11453 =item $pod_seq-E<gt>B<append()>
11454
11455 =back
11456
11457 =over 4
11458
11459 =item $pod_seq-E<gt>B<nested()>
11460
11461 =back
11462
11463 =over 4
11464
11465 =item $pod_seq-E<gt>B<raw_text()>
11466
11467 =back
11468
11469 =over 4
11470
11471 =item $pod_seq-E<gt>B<left_delimiter()>
11472
11473 =back
11474
11475 =over 4
11476
11477 =item $pod_seq-E<gt>B<right_delimiter()>
11478
11479 =back
11480
11481 =over 4
11482
11483 =item $pod_seq-E<gt>B<parse_tree()>
11484
11485 =back
11486
11487 =over 4
11488
11489 =item $pod_seq-E<gt>B<file_line()>
11490
11491 =back
11492
11493 =over 4
11494
11495 =item Pod::InteriorSequence::B<DESTROY()>
11496
11497 =back
11498
11499 =over 4
11500
11501 =item B<Pod::ParseTree>
11502
11503 =back
11504
11505 =over 4
11506
11507 =item Pod::ParseTree-E<gt>B<new()>
11508
11509 =back
11510
11511 =over 4
11512
11513 =item $ptree-E<gt>B<top()>
11514
11515 =back
11516
11517 =over 4
11518
11519 =item $ptree-E<gt>B<children()>
11520
11521 =back
11522
11523 =over 4
11524
11525 =item $ptree-E<gt>B<prepend()>
11526
11527 =back
11528
11529 =over 4
11530
11531 =item $ptree-E<gt>B<append()>
11532
11533 =back
11534
11535 =over 4
11536
11537 =item $ptree-E<gt>B<raw_text()>
11538
11539 =back
11540
11541 =over 4
11542
11543 =item Pod::ParseTree::B<DESTROY()>
11544
11545 =back
11546
11547 =over 4
11548
11549 =item SEE ALSO
11550
11551 =item AUTHOR
11552
11553 =back
11554
11555 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
11556
11557 =over 4
11558
11559 =item SYNOPSIS
11560
11561 =item DESCRIPTION
11562
11563 =back
11564
11565 =over 4
11566
11567 =item OBJECT METHODS
11568
11569 C<initialize>
11570
11571 =back
11572
11573 =over 4
11574
11575 =item Data Accessors
11576
11577 B<AddPreamble>
11578
11579 =back
11580
11581 B<AddPostamble>
11582
11583 B<Head1Level>
11584
11585 B<Label>
11586
11587 B<LevelNoNum>
11588
11589 B<MakeIndex>
11590
11591 B<ReplaceNAMEwithSection>
11592
11593 B<StartWithNewPage>
11594
11595 B<TableOfContents>
11596
11597 B<UniqueLabels>
11598
11599 B<UserPreamble>
11600
11601 B<UserPostamble>
11602
11603 B<Lists>
11604
11605 =over 4
11606
11607 =item Subclassed methods
11608
11609 =back
11610
11611 B<begin_pod>
11612
11613 B<end_pod>
11614
11615 B<command>
11616
11617 B<verbatim>
11618
11619 B<textblock>
11620
11621 B<interior_sequence>
11622
11623 =over 4
11624
11625 =item List Methods
11626
11627 B<begin_list>
11628
11629 =back
11630
11631 B<end_list>
11632
11633 B<add_item>
11634
11635 =over 4
11636
11637 =item Methods for headings
11638
11639 B<head>
11640
11641 =back
11642
11643 =over 4
11644
11645 =item Internal methods
11646
11647 B<_output>
11648
11649 =back
11650
11651 B<_replace_special_chars>
11652
11653 B<_create_label>
11654
11655 B<_create_index>
11656
11657 B<_clean_latex_commands>
11658
11659 =over 4
11660
11661 =item NOTES
11662
11663 =item SEE ALSO
11664
11665 =item AUTHORS
11666
11667 =item COPYRIGHT
11668
11669 =item REVISION
11670
11671 =back
11672
11673 =head2 Pod::Man - Convert POD data to formatted *roff input
11674
11675 =over 4
11676
11677 =item SYNOPSIS
11678
11679 =item DESCRIPTION
11680
11681 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
11682 release, section
11683
11684 =item DIAGNOSTICS
11685
11686 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
11687 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape
11688 EE<lt>%sE<gt>, Unknown sequence %s, %s: Unknown command paragraph "%s" on
11689 line %d, Unmatched =back
11690
11691 =item BUGS
11692
11693 =item SEE ALSO
11694
11695 =item AUTHOR
11696
11697 =back
11698
11699 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
11700
11701 =over 4
11702
11703 =item SYNOPSIS
11704
11705 =item DESCRIPTION
11706
11707 =back
11708
11709 =over 4
11710
11711 =item Pod::List
11712
11713 Pod::List-E<gt>new()
11714
11715 =back
11716
11717 $list-E<gt>file()
11718
11719 $list-E<gt>start()
11720
11721 $list-E<gt>indent()
11722
11723 $list-E<gt>type()
11724
11725 $list-E<gt>rx()
11726
11727 $list-E<gt>item()
11728
11729 $list-E<gt>parent()
11730
11731 $list-E<gt>tag()
11732
11733 =over 4
11734
11735 =item Pod::Hyperlink
11736
11737 Pod::Hyperlink-E<gt>new()
11738
11739 =back
11740
11741 $link-E<gt>parse($string)
11742
11743 $link-E<gt>markup($string)
11744
11745 $link-E<gt>text()
11746
11747 $link-E<gt>warning()
11748
11749 $link-E<gt>file(), $link-E<gt>line()
11750
11751 $link-E<gt>page()
11752
11753 $link-E<gt>node()
11754
11755 $link-E<gt>alttext()
11756
11757 $link-E<gt>type()
11758
11759 $link-E<gt>link()
11760
11761 =over 4
11762
11763 =item Pod::Cache
11764
11765 Pod::Cache-E<gt>new()
11766
11767 =back
11768
11769 $cache-E<gt>item()
11770
11771 $cache-E<gt>find_page($name)
11772
11773 =over 4
11774
11775 =item Pod::Cache::Item
11776
11777 Pod::Cache::Item-E<gt>new()
11778
11779 =back
11780
11781 $cacheitem-E<gt>page()
11782
11783 $cacheitem-E<gt>description()
11784
11785 $cacheitem-E<gt>path()
11786
11787 $cacheitem-E<gt>file()
11788
11789 $cacheitem-E<gt>nodes()
11790
11791 $cacheitem-E<gt>find_node($name)
11792
11793 $cacheitem-E<gt>idx()
11794
11795 =over 4
11796
11797 =item AUTHOR
11798
11799 =item SEE ALSO
11800
11801 =back
11802
11803 =head2 Pod::Parser - base class for creating POD filters and translators
11804
11805 =over 4
11806
11807 =item SYNOPSIS
11808
11809 =item REQUIRES
11810
11811 =item EXPORTS
11812
11813 =item DESCRIPTION
11814
11815 =item QUICK OVERVIEW
11816
11817 =item PARSING OPTIONS
11818
11819 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
11820 B<-warnings> (default: unset)
11821
11822 =back
11823
11824 =over 4
11825
11826 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
11827
11828 =back
11829
11830 =over 4
11831
11832 =item B<command()>
11833
11834 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
11835
11836 =back
11837
11838 =over 4
11839
11840 =item B<verbatim()>
11841
11842 C<$text>, C<$line_num>, C<$pod_para>
11843
11844 =back
11845
11846 =over 4
11847
11848 =item B<textblock()>
11849
11850 C<$text>, C<$line_num>, C<$pod_para>
11851
11852 =back
11853
11854 =over 4
11855
11856 =item B<interior_sequence()>
11857
11858 =back
11859
11860 =over 4
11861
11862 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
11863
11864 =back
11865
11866 =over 4
11867
11868 =item B<new()>
11869
11870 =back
11871
11872 =over 4
11873
11874 =item B<initialize()>
11875
11876 =back
11877
11878 =over 4
11879
11880 =item B<begin_pod()>
11881
11882 =back
11883
11884 =over 4
11885
11886 =item B<begin_input()>
11887
11888 =back
11889
11890 =over 4
11891
11892 =item B<end_input()>
11893
11894 =back
11895
11896 =over 4
11897
11898 =item B<end_pod()>
11899
11900 =back
11901
11902 =over 4
11903
11904 =item B<preprocess_line()>
11905
11906 =back
11907
11908 =over 4
11909
11910 =item B<preprocess_paragraph()>
11911
11912 =back
11913
11914 =over 4
11915
11916 =item METHODS FOR PARSING AND PROCESSING
11917
11918 =back
11919
11920 =over 4
11921
11922 =item B<parse_text()>
11923
11924 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
11925 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
11926 I<code-ref>|I<method-name>
11927
11928 =back
11929
11930 =over 4
11931
11932 =item B<interpolate()>
11933
11934 =back
11935
11936 =over 4
11937
11938 =item B<parse_paragraph()>
11939
11940 =back
11941
11942 =over 4
11943
11944 =item B<parse_from_filehandle()>
11945
11946 =back
11947
11948 =over 4
11949
11950 =item B<parse_from_file()>
11951
11952 =back
11953
11954 =over 4
11955
11956 =item ACCESSOR METHODS
11957
11958 =back
11959
11960 =over 4
11961
11962 =item B<errorsub()>
11963
11964 =back
11965
11966 =over 4
11967
11968 =item B<cutting()>
11969
11970 =back
11971
11972 =over 4
11973
11974 =item B<parseopts()>
11975
11976 =back
11977
11978 =over 4
11979
11980 =item B<output_file()>
11981
11982 =back
11983
11984 =over 4
11985
11986 =item B<output_handle()>
11987
11988 =back
11989
11990 =over 4
11991
11992 =item B<input_file()>
11993
11994 =back
11995
11996 =over 4
11997
11998 =item B<input_handle()>
11999
12000 =back
12001
12002 =over 4
12003
12004 =item B<input_streams()>
12005
12006 =back
12007
12008 =over 4
12009
12010 =item B<top_stream()>
12011
12012 =back
12013
12014 =over 4
12015
12016 =item PRIVATE METHODS AND DATA
12017
12018 =back
12019
12020 =over 4
12021
12022 =item B<_push_input_stream()>
12023
12024 =back
12025
12026 =over 4
12027
12028 =item B<_pop_input_stream()>
12029
12030 =back
12031
12032 =over 4
12033
12034 =item TREE-BASED PARSING
12035
12036 =item SEE ALSO
12037
12038 =item AUTHOR
12039
12040 =back
12041
12042 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
12043
12044 =over 4
12045
12046 =item SYNOPSIS
12047
12048 =item DESCRIPTION
12049
12050 =over 4
12051
12052 =item EXPORT
12053
12054 =back
12055
12056 =item AUTHOR
12057
12058 =item SEE ALSO
12059
12060 =back
12061
12062 =head2 Pod::Select, podselect() - extract selected sections of POD from
12063 input
12064
12065 =over 4
12066
12067 =item SYNOPSIS
12068
12069 =item REQUIRES
12070
12071 =item EXPORTS
12072
12073 =item DESCRIPTION
12074
12075 =item SECTION SPECIFICATIONS
12076
12077 =item RANGE SPECIFICATIONS
12078
12079 =back
12080
12081 =over 4
12082
12083 =item OBJECT METHODS
12084
12085 =back
12086
12087 =over 4
12088
12089 =item B<curr_headings()>
12090
12091 =back
12092
12093 =over 4
12094
12095 =item B<select()>
12096
12097 =back
12098
12099 =over 4
12100
12101 =item B<add_selection()>
12102
12103 =back
12104
12105 =over 4
12106
12107 =item B<clear_selections()>
12108
12109 =back
12110
12111 =over 4
12112
12113 =item B<match_section()>
12114
12115 =back
12116
12117 =over 4
12118
12119 =item B<is_selected()>
12120
12121 =back
12122
12123 =over 4
12124
12125 =item EXPORTED FUNCTIONS
12126
12127 =back
12128
12129 =over 4
12130
12131 =item B<podselect()>
12132
12133 B<-output>, B<-sections>, B<-ranges>
12134
12135 =back
12136
12137 =over 4
12138
12139 =item PRIVATE METHODS AND DATA
12140
12141 =back
12142
12143 =over 4
12144
12145 =item B<_compile_section_spec()>
12146
12147 =back
12148
12149 =over 4
12150
12151 =item $self->{_SECTION_HEADINGS}
12152
12153 =back
12154
12155 =over 4
12156
12157 =item $self->{_SELECTED_SECTIONS}
12158
12159 =back
12160
12161 =over 4
12162
12163 =item SEE ALSO
12164
12165 =item AUTHOR
12166
12167 =back
12168
12169 =head2 Pod::Text - Convert POD data to formatted ASCII text
12170
12171 =over 4
12172
12173 =item SYNOPSIS
12174
12175 =item DESCRIPTION
12176
12177 alt, indent, loose, quotes, sentence, width
12178
12179 =item DIAGNOSTICS
12180
12181 Bizarre space in item, Can't open %s for reading: %s, Invalid quote
12182 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
12183 %s, Unknown sequence: %s, Unmatched =back
12184
12185 =item RESTRICTIONS
12186
12187 =item NOTES
12188
12189 =item SEE ALSO
12190
12191 =item AUTHOR
12192
12193 =back
12194
12195 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
12196
12197 =over 4
12198
12199 =item SYNOPSIS
12200
12201 =item DESCRIPTION
12202
12203 =item BUGS
12204
12205 =item SEE ALSO
12206
12207 =item AUTHOR
12208
12209 =back
12210
12211 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
12212 text
12213
12214 =over 4
12215
12216 =item SYNOPSIS
12217
12218 =item DESCRIPTION
12219
12220 =item BUGS
12221
12222 =item SEE ALSO
12223
12224 =item AUTHOR
12225
12226 =back
12227
12228 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
12229 text with format escapes
12230
12231 =over 4
12232
12233 =item SYNOPSIS
12234
12235 =item DESCRIPTION
12236
12237 =item SEE ALSO
12238
12239 =item AUTHOR
12240
12241 =back
12242
12243 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
12244 documentation
12245
12246 =over 4
12247
12248 =item SYNOPSIS
12249
12250 =item ARGUMENTS
12251
12252 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
12253 C<-pathlist>
12254
12255 =item DESCRIPTION
12256
12257 =item EXAMPLES
12258
12259 =over 4
12260
12261 =item Recommended Use
12262
12263 =back
12264
12265 =item CAVEATS
12266
12267 =item AUTHOR
12268
12269 =item ACKNOWLEDGEMENTS
12270
12271 =back
12272
12273 =head2 SDBM_File - Tied access to sdbm files
12274
12275 =over 4
12276
12277 =item SYNOPSIS
12278
12279 =item DESCRIPTION
12280
12281 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
12282
12283 =item DIAGNOSTICS
12284
12285 =over 4
12286
12287 =item C<sdbm store returned -1, errno 22, key "..." at ...>
12288
12289 =back
12290
12291 =item BUGS AND WARNINGS
12292
12293 =back
12294
12295 =head2 Safe - Compile and execute code in restricted compartments
12296
12297 =over 4
12298
12299 =item SYNOPSIS
12300
12301 =item DESCRIPTION
12302
12303 a new namespace, an operator mask
12304
12305 =item WARNING
12306
12307 =over 4
12308
12309 =item RECENT CHANGES
12310
12311 =item Methods in class Safe
12312
12313 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
12314 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
12315 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
12316 root (NAMESPACE), mask (MASK)
12317
12318 =item Some Safety Issues
12319
12320 Memory, CPU, Snooping, Signals, State Changes
12321
12322 =item AUTHOR
12323
12324 =back
12325
12326 =back
12327
12328 =head2 Search::Dict, look - search for key in dictionary file
12329
12330 =over 4
12331
12332 =item SYNOPSIS
12333
12334 =item DESCRIPTION
12335
12336 =back
12337
12338 =head2 SelectSaver - save and restore selected file handle
12339
12340 =over 4
12341
12342 =item SYNOPSIS
12343
12344 =item DESCRIPTION
12345
12346 =back
12347
12348 =head2 SelfLoader - load functions only on demand
12349
12350 =over 4
12351
12352 =item SYNOPSIS
12353
12354 =item DESCRIPTION
12355
12356 =over 4
12357
12358 =item The __DATA__ token
12359
12360 =item SelfLoader autoloading
12361
12362 =item Autoloading and package lexicals
12363
12364 =item SelfLoader and AutoLoader
12365
12366 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
12367
12368 =item Classes and inherited methods.
12369
12370 =back
12371
12372 =item Multiple packages and fully qualified subroutine names
12373
12374 =back
12375
12376 =head2 Shell - run shell commands transparently within perl
12377
12378 =over 4
12379
12380 =item SYNOPSIS
12381
12382 =item DESCRIPTION
12383
12384 =over 4
12385
12386 =item OBJECT ORIENTED SYNTAX
12387
12388 =back
12389
12390 =item AUTHOR
12391
12392 =back
12393
12394 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
12395 socket.h defines and structure manipulators
12396
12397 =over 4
12398
12399 =item SYNOPSIS
12400
12401 =item DESCRIPTION
12402
12403 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
12404 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
12405 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
12406 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
12407 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
12408
12409 =back
12410
12411 =head2 Storable - persistency for perl data structures
12412
12413 =over 4
12414
12415 =item SYNOPSIS
12416
12417 =item DESCRIPTION
12418
12419 =item MEMORY STORE
12420
12421 =item ADVISORY LOCKING
12422
12423 =item SPEED
12424
12425 =item CANONICAL REPRESENTATION
12426
12427 =item ERROR REPORTING
12428
12429 =item WIZARDS ONLY
12430
12431 =over 4
12432
12433 =item Hooks
12434
12435 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
12436 I<serialized>, ..
12437
12438 =item Predicates
12439
12440 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
12441 C<Storable::is_retrieving>
12442
12443 =item Recursion
12444
12445 =item Deep Cloning
12446
12447 =back
12448
12449 =item EXAMPLES
12450
12451 =item WARNING
12452
12453 =item BUGS
12454
12455 =item CREDITS
12456
12457 =item TRANSLATIONS
12458
12459 =item AUTHOR
12460
12461 =item SEE ALSO
12462
12463 =back
12464
12465 =head2 Symbol - manipulate Perl symbols and their names
12466
12467 =over 4
12468
12469 =item SYNOPSIS
12470
12471 =item DESCRIPTION
12472
12473 =back
12474
12475 =head2 Sys::Hostname - Try every conceivable way to get hostname
12476
12477 =over 4
12478
12479 =item SYNOPSIS
12480
12481 =item DESCRIPTION
12482
12483 =item AUTHOR
12484
12485 =back
12486
12487 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
12488 interface to the UNIX syslog(3) calls
12489
12490 =over 4
12491
12492 =item SYNOPSIS
12493
12494 =item DESCRIPTION
12495
12496 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
12497 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
12498 closelog
12499
12500 =item EXAMPLES
12501
12502 =item SEE ALSO
12503
12504 =item AUTHOR
12505
12506 =back
12507
12508 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
12509 Perl interface to the UNIX syslog(3) calls
12510
12511 =over 4
12512
12513 =item SYNOPSIS
12514
12515 =item DESCRIPTION
12516
12517 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
12518 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
12519 closelog
12520
12521 =item EXAMPLES
12522
12523 =item SEE ALSO
12524
12525 =item AUTHOR
12526
12527 =back
12528
12529 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
12530
12531 =over 4
12532
12533 =item SYNOPSIS
12534
12535 =item DESCRIPTION
12536
12537 =item DIAGNOSTICS
12538
12539 Invalid attribute name %s, Name "%s" used only once: possible typo, No
12540 comma allowed after filehandle, Bareword "%s" not allowed while "strict
12541 subs" in use
12542
12543 =item RESTRICTIONS
12544
12545 =item NOTES
12546
12547 =item AUTHORS
12548
12549 =back
12550
12551 =head2 Term::Cap - Perl termcap interface
12552
12553 =over 4
12554
12555 =item SYNOPSIS
12556
12557 =item DESCRIPTION
12558
12559 =item EXAMPLES
12560
12561 =back
12562
12563 =head2 Term::Complete - Perl word completion module
12564
12565 =over 4
12566
12567 =item SYNOPSIS
12568
12569 =item DESCRIPTION
12570
12571 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
12572
12573 =item DIAGNOSTICS
12574
12575 =item BUGS
12576
12577 =item AUTHOR
12578
12579 =back
12580
12581 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
12582 no real package is found, substitutes stubs instead of basic functions.
12583
12584 =over 4
12585
12586 =item SYNOPSIS
12587
12588 =item DESCRIPTION
12589
12590 =item Minimal set of supported functions
12591
12592 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
12593 C<MinLine>, C<findConsole>, Attribs, C<Features>
12594
12595 =item Additional supported functions
12596
12597 C<tkRunning>, C<ornaments>, C<newTTY>
12598
12599 =item EXPORTS
12600
12601 =item ENVIRONMENT
12602
12603 =back
12604
12605 =head2   Test - provides a simple framework for writing test scripts
12606
12607 =over 4
12608
12609 =item SYNOPSIS
12610
12611 =item DESCRIPTION
12612
12613 =item TEST TYPES
12614
12615 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
12616
12617 =item RETURN VALUE
12618
12619 =item ONFAIL
12620
12621 =item SEE ALSO
12622
12623 =item AUTHOR
12624
12625 =back
12626
12627 =head2 Test::Harness - run perl standard test scripts with statistics
12628
12629 =over 4
12630
12631 =item SYNOPSIS
12632
12633 =item DESCRIPTION
12634
12635 =over 4
12636
12637 =item The test script output
12638
12639 =back
12640
12641 =item EXPORT
12642
12643 =item DIAGNOSTICS
12644
12645 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
12646 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
12647 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
12648 %s>, C<FAILED--Further testing stopped%s>
12649
12650 =item ENVIRONMENT
12651
12652 =item SEE ALSO
12653
12654 =item AUTHORS
12655
12656 =item BUGS
12657
12658 =back
12659
12660 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
12661
12662 =over 4
12663
12664 =item SYNOPSIS
12665
12666 =item DESCRIPTION
12667
12668 =item EXAMPLE
12669
12670 =back
12671
12672 =head2 Text::ParseWords - parse text into an array of tokens or array of
12673 arrays
12674
12675 =over 4
12676
12677 =item SYNOPSIS
12678
12679 =item DESCRIPTION
12680
12681 =item EXAMPLES
12682
12683 =item AUTHORS
12684
12685 =back
12686
12687 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
12688 by Knuth
12689
12690 =over 4
12691
12692 =item SYNOPSIS
12693
12694 =item DESCRIPTION
12695
12696 =item EXAMPLES
12697
12698 =item LIMITATIONS
12699
12700 =item AUTHOR
12701
12702 =back
12703
12704 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
12705 unexpand(1)
12706
12707 =over 4
12708
12709 =item SYNOPSIS
12710
12711 =item DESCRIPTION
12712
12713 =item BUGS
12714
12715 =item AUTHOR
12716
12717 =back
12718
12719 =head2 Text::Wrap - line wrapping to form simple paragraphs
12720
12721 =over 4
12722
12723 =item SYNOPSIS
12724
12725 =item DESCRIPTION
12726
12727 =item EXAMPLE
12728
12729 =item AUTHOR
12730
12731 =back
12732
12733 =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
12734 change)
12735
12736 =over 4
12737
12738 =item SYNOPSIS
12739
12740 =item DESCRIPTION
12741
12742 =item FUNCTIONS
12743
12744 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
12745 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
12746 cond_broadcast VARIABLE, yield
12747
12748 =item METHODS
12749
12750 join, eval, detach, equal, tid, flags, done
12751
12752 =item LIMITATIONS
12753
12754 =item SEE ALSO
12755
12756 =back
12757
12758 =head2 Thread::Queue - thread-safe queues
12759
12760 =over 4
12761
12762 =item SYNOPSIS
12763
12764 =item DESCRIPTION
12765
12766 =item FUNCTIONS AND METHODS
12767
12768 new, enqueue LIST, dequeue, dequeue_nb, pending
12769
12770 =item SEE ALSO
12771
12772 =back
12773
12774 =head2 Thread::Semaphore - thread-safe semaphores
12775
12776 =over 4
12777
12778 =item SYNOPSIS
12779
12780 =item DESCRIPTION
12781
12782 =item FUNCTIONS AND METHODS
12783
12784 new, new NUMBER, down, down NUMBER, up, up NUMBER
12785
12786 =back
12787
12788 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
12789
12790 =over 4
12791
12792 =item SYNOPSIS
12793
12794 =item DESCRIPTION
12795
12796 =item BUGS
12797
12798 =back
12799
12800 =head2 Thread::Specific - thread-specific keys
12801
12802 =over 4
12803
12804 =item SYNOPSIS
12805
12806 =item DESCRIPTION
12807
12808 =back
12809
12810 =head2 Tie::Array - base class for tied arrays
12811
12812 =over 4
12813
12814 =item SYNOPSIS
12815
12816 =item DESCRIPTION
12817
12818 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
12819 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
12820 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
12821 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
12822
12823 =item CAVEATS
12824
12825 =item AUTHOR
12826
12827 =back
12828
12829 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
12830 handles
12831
12832 =over 4
12833
12834 =item SYNOPSIS
12835
12836 =item DESCRIPTION
12837
12838 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
12839 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
12840 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
12841 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
12842
12843 =item MORE INFORMATION
12844
12845 =item COMPATIBILITY
12846
12847 =back
12848
12849 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
12850
12851 =over 4
12852
12853 =item SYNOPSIS
12854
12855 =item DESCRIPTION
12856
12857 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
12858 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
12859
12860 =item CAVEATS
12861
12862 =item MORE INFORMATION
12863
12864 =back
12865
12866 =head2 Tie::RefHash - use references as hash keys
12867
12868 =over 4
12869
12870 =item SYNOPSIS
12871
12872 =item DESCRIPTION
12873
12874 =item EXAMPLE
12875
12876 =item AUTHOR
12877
12878 =item VERSION
12879
12880 =item SEE ALSO
12881
12882 =back
12883
12884 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
12885 scalars
12886
12887 =over 4
12888
12889 =item SYNOPSIS
12890
12891 =item DESCRIPTION
12892
12893 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
12894
12895 =item MORE INFORMATION
12896
12897 =back
12898
12899 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
12900
12901 =over 4
12902
12903 =item SYNOPSIS
12904
12905 =item DESCRIPTION
12906
12907 =item CAVEATS
12908
12909 =back
12910
12911 =head2 Time::Local - efficiently compute time from local and GMT time
12912
12913 =over 4
12914
12915 =item SYNOPSIS
12916
12917 =item DESCRIPTION
12918
12919 =item IMPLEMENTATION
12920
12921 =item BUGS
12922
12923 =back
12924
12925 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
12926 function
12927
12928 =over 4
12929
12930 =item SYNOPSIS
12931
12932 =item DESCRIPTION
12933
12934 =item NOTE
12935
12936 =item AUTHOR
12937
12938 =back
12939
12940 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
12941 function
12942
12943 =over 4
12944
12945 =item SYNOPSIS
12946
12947 =item DESCRIPTION
12948
12949 =item NOTE
12950
12951 =item AUTHOR
12952
12953 =back
12954
12955 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
12956
12957 =over 4
12958
12959 =item SYNOPSIS
12960
12961 =item DESCRIPTION
12962
12963 =item AUTHOR
12964
12965 =back
12966
12967 =head2 UNIVERSAL - base class for ALL classes (blessed references)
12968
12969 =over 4
12970
12971 =item SYNOPSIS
12972
12973 =item DESCRIPTION
12974
12975 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
12976 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
12977
12978 =back
12979
12980 =head2 User::grent - by-name interface to Perl's built-in getgr*()
12981 functions
12982
12983 =over 4
12984
12985 =item SYNOPSIS
12986
12987 =item DESCRIPTION
12988
12989 =item NOTE
12990
12991 =item AUTHOR
12992
12993 =back
12994
12995 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
12996 functions
12997
12998 =over 4
12999
13000 =item SYNOPSIS
13001
13002 =item DESCRIPTION
13003
13004 =over 4
13005
13006 =item System Specifics
13007
13008 =back
13009
13010 =item NOTE
13011
13012 =item AUTHOR
13013
13014 =item HISTORY
13015
13016 March 18th, 2000
13017
13018 =back
13019
13020 =head2 Win32 - Interfaces to some Win32 API Functions
13021
13022 =over 4
13023
13024 =item DESCRIPTION
13025
13026 =over 4
13027
13028 =item Alphabetical Listing of Win32 Functions
13029
13030 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
13031 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
13032 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
13033 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
13034 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
13035 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
13036 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
13037 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
13038 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
13039 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
13040 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
13041 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
13042 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
13043 Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
13044 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
13045 PID), Win32::UnregisterServer(LIBRARYNAME)
13046
13047 =back
13048
13049 =back
13050
13051 =head2 XSLoader - Dynamically load C libraries into Perl code
13052
13053 =over 4
13054
13055 =item SYNOPSIS
13056
13057 =item DESCRIPTION
13058
13059 =item AUTHOR
13060
13061 =back
13062
13063 =head1 AUXILIARY DOCUMENTATION
13064
13065 Here should be listed all the extra programs' documentation, but they
13066 don't all have manual pages yet:
13067
13068 =over 4
13069
13070 =item a2p
13071
13072 =item s2p
13073
13074 =item find2perl
13075
13076 =item h2ph
13077
13078 =item c2ph
13079
13080 =item h2xs
13081
13082 =item xsubpp
13083
13084 =item pod2man
13085
13086 =item wrapsuid
13087
13088 =back
13089
13090 =head1 AUTHOR
13091
13092 Larry Wall <F<larry@wall.org>>, with the help of oodles
13093 of other folks.
13094