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