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