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, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew,
3871 Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP,
3872 SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE,
3873 StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp,
3874 SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV,
3875 SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
3876 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off,
3877 SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force, SvPV_nolen,
3878 SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV,
3879 SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, SvTAINTED,
3880 SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV, SVt_NV,
3881 SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE, SvUTF8,
3882 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 z
8217
8218 C<zcat>, C<zip>
8219
8220 =back
8221
8222 =item NOTE
8223
8224 =back
8225
8226 =head2 Cwd, getcwd - get pathname of current working directory
8227
8228 =over 4
8229
8230 =item SYNOPSIS
8231
8232 =item DESCRIPTION
8233
8234 =back
8235
8236 =head2 DB - programmatic interface to the Perl debugging API (draft,
8237 subject to
8238 change)
8239
8240 =over 4
8241
8242 =item SYNOPSIS
8243
8244 =item DESCRIPTION
8245
8246 =over 4
8247
8248 =item Global Variables
8249
8250  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
8251 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
8252 $DB::lineno
8253
8254 =item API Methods
8255
8256 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
8257 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
8258
8259 =item Client Callback Methods
8260
8261 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
8262 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
8263 CLIENT->output(LIST)
8264
8265 =back
8266
8267 =item BUGS
8268
8269 =item AUTHOR
8270
8271 =back
8272
8273 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
8274
8275 =over 4
8276
8277 =item SYNOPSIS
8278
8279 =item DESCRIPTION
8280
8281 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
8282
8283 =over 4
8284
8285 =item Using DB_File with Berkeley DB version 2 or 3
8286
8287 =item Interface to Berkeley DB
8288
8289 =item Opening a Berkeley DB Database File
8290
8291 =item Default Parameters
8292
8293 =item In Memory Databases
8294
8295 =back
8296
8297 =item DB_HASH
8298
8299 =over 4
8300
8301 =item A Simple Example
8302
8303 =back
8304
8305 =item DB_BTREE
8306
8307 =over 4
8308
8309 =item Changing the BTREE sort order
8310
8311 =item Handling Duplicate Keys
8312
8313 =item The get_dup() Method
8314
8315 =item The find_dup() Method
8316
8317 =item The del_dup() Method
8318
8319 =item Matching Partial Keys
8320
8321 =back
8322
8323 =item DB_RECNO
8324
8325 =over 4
8326
8327 =item The 'bval' Option
8328
8329 =item A Simple Example
8330
8331 =item Extra RECNO Methods
8332
8333 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
8334 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
8335
8336 =item Another Example
8337
8338 =back
8339
8340 =item THE API INTERFACE
8341
8342 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
8343 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
8344 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
8345 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
8346
8347 =item DBM FILTERS
8348
8349 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
8350 B<filter_fetch_value>
8351
8352 =over 4
8353
8354 =item The Filter
8355
8356 =item An Example -- the NULL termination problem.
8357
8358 =item Another Example -- Key is a C int.
8359
8360 =back
8361
8362 =item HINTS AND TIPS
8363
8364 =over 4
8365
8366 =item Locking: The Trouble with fd
8367
8368 =item Safe ways to lock a database
8369
8370 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
8371
8372 =item Sharing Databases With C Applications
8373
8374 =item The untie() Gotcha
8375
8376 =back
8377
8378 =item COMMON QUESTIONS
8379
8380 =over 4
8381
8382 =item Why is there Perl source in my database?
8383
8384 =item How do I store complex data structures with DB_File?
8385
8386 =item What does "Invalid Argument" mean?
8387
8388 =item What does "Bareword 'DB_File' not allowed" mean?
8389
8390 =back
8391
8392 =item REFERENCES
8393
8394 =item HISTORY
8395
8396 =item BUGS
8397
8398 =item AVAILABILITY
8399
8400 =item COPYRIGHT
8401
8402 =item SEE ALSO
8403
8404 =item AUTHOR
8405
8406 =back
8407
8408 =head2 Data::Dumper - stringified perl data structures, suitable for both
8409 printing and C<eval>
8410
8411 =over 4
8412
8413 =item SYNOPSIS
8414
8415 =item DESCRIPTION
8416
8417 =over 4
8418
8419 =item Methods
8420
8421 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
8422 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
8423 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
8424 I<$OBJ>->Reset
8425
8426 =item Functions
8427
8428 Dumper(I<LIST>)
8429
8430 =item Configuration Variables or Methods
8431
8432 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
8433 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
8434 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
8435 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
8436 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
8437 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
8438 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
8439 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
8440 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
8441 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
8442 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
8443 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>)
8444
8445 =item Exports
8446
8447 Dumper
8448
8449 =back
8450
8451 =item EXAMPLES
8452
8453 =item BUGS
8454
8455 =item AUTHOR
8456
8457 =item VERSION
8458
8459 =item SEE ALSO
8460
8461 =back
8462
8463 =head2 Devel::DProf - a Perl code profiler
8464
8465 =over 4
8466
8467 =item SYNOPSIS
8468
8469 =item DESCRIPTION
8470
8471 =item PROFILE FORMAT
8472
8473 =item AUTOLOAD
8474
8475 =item ENVIRONMENT
8476
8477 =item BUGS
8478
8479 =item SEE ALSO
8480
8481 =back
8482
8483 =head2 Devel::Peek - A data debugging tool for the XS programmer
8484
8485 =over 4
8486
8487 =item SYNOPSIS
8488
8489 =item DESCRIPTION
8490
8491 =over 4
8492
8493 =item Memory footprint debugging
8494
8495 =back
8496
8497 =item EXAMPLES
8498
8499 =over 4
8500
8501 =item A simple scalar string
8502
8503 =item A simple scalar number
8504
8505 =item A simple scalar with an extra reference
8506
8507 =item A reference to a simple scalar
8508
8509 =item A reference to an array
8510
8511 =item A reference to a hash
8512
8513 =item Dumping a large array or hash
8514
8515 =item A reference to an SV which holds a C pointer
8516
8517 =item A reference to a subroutine
8518
8519 =back
8520
8521 =item EXPORTS
8522
8523 =item BUGS
8524
8525 =item AUTHOR
8526
8527 =item SEE ALSO
8528
8529 =back
8530
8531 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
8532
8533 =over 4
8534
8535 =item SYNOPSIS
8536
8537 =item DESCRIPTION
8538
8539 =back
8540
8541 =head2 DirHandle - supply object methods for directory handles
8542
8543 =over 4
8544
8545 =item SYNOPSIS
8546
8547 =item DESCRIPTION
8548
8549 =back
8550
8551 =head2 Dumpvalue - provides screen dump of Perl data.
8552
8553 =over 4
8554
8555 =item SYNOPSIS
8556
8557 =item DESCRIPTION
8558
8559 =over 4
8560
8561 =item Creation
8562
8563 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
8564 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
8565 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
8566 stopDbSignal
8567
8568 =item Methods
8569
8570 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
8571 veryCompact, set, get
8572
8573 =back
8574
8575 =back
8576
8577 =head2 DynaLoader - Dynamically load C libraries into Perl code
8578
8579 =over 4
8580
8581 =item SYNOPSIS
8582
8583 =item DESCRIPTION
8584
8585 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
8586 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
8587 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
8588 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
8589 bootstrap()
8590
8591 =item AUTHOR
8592
8593 =back
8594
8595 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
8596 Perl code
8597
8598 =over 4
8599
8600 =item SYNOPSIS
8601
8602 =item DESCRIPTION
8603
8604 =item AUTHOR
8605
8606 =back
8607
8608 =head2 Encode - character encodings
8609
8610 =over 4
8611
8612 =item SYNOPSIS
8613
8614 =item DESCRIPTION
8615
8616 =over 4
8617
8618 =item TERMINOLOGY
8619
8620 =back
8621
8622 =item ENCODINGS
8623
8624 =over 4
8625
8626 =item Characteristics of an Encoding
8627
8628 =item Types of Encodings
8629
8630 Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
8631 Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
8632
8633 =item Specifying Encodings
8634
8635 1. By name, 2. As an object
8636
8637 =item Encoding Names
8638
8639 The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry,
8640 The name used by the the organization that defined it
8641
8642 =back
8643
8644 =item PERL ENCODING API
8645
8646 =over 4
8647
8648 =item Generic Encoding Interface
8649
8650 =item Handling Malformed Data
8651
8652 Scheme 1, Scheme 2, Other Schemes
8653
8654 =item UTF-8 / utf8
8655
8656 =item Other Encodings of Unicode
8657
8658 =back
8659
8660 =item Encoding and IO
8661
8662 =item Encoding How to ...
8663
8664 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
8665 strings in binary data, perl/Encode wrappers on non-Unicode XS modules
8666
8667 =item Messing with Perl's Internals
8668
8669 utf8_downgrade($string[, CHECK]), is_utf8(STRING [, CHECK]),
8670 valid_utf8(STRING)
8671
8672 =item IMPLEMENTATION CLASSES
8673
8674 -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
8675 -E<gt>decode($octets,$check)
8676
8677 =over 4
8678
8679 =item Compiled Encodings
8680
8681 .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
8682 variants of EBCDIC, symbol and dingbats as used by Tk on X11
8683
8684 =back
8685
8686 =item SEE ALSO
8687
8688 =back
8689
8690 =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
8691 of the Encode extension
8692
8693 =over 4
8694
8695 =item DESCRIPTION
8696
8697 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
8698
8699 =item KEYWORDS
8700
8701 =item COPYRIGHT
8702
8703 =back
8704
8705 =head2 EncodeFormat - the format of encoding tables of the Encode extension
8706
8707 =over 4
8708
8709 =item DESCRIPTION
8710
8711 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
8712
8713 =item KEYWORDS
8714
8715 =item COPYRIGHT
8716
8717 =back
8718
8719 =head2 English - use nice English (or awk) names for ugly punctuation
8720 variables
8721
8722 =over 4
8723
8724 =item SYNOPSIS
8725
8726 =item DESCRIPTION
8727
8728 =item PERFORMANCE
8729
8730 =back
8731
8732 =head2 Env - perl module that imports environment variables as scalars or
8733 arrays
8734
8735 =over 4
8736
8737 =item SYNOPSIS
8738
8739 =item DESCRIPTION
8740
8741 =item LIMITATIONS
8742
8743 =item AUTHOR
8744
8745 =back
8746
8747 =head2 Errno - System errno constants
8748
8749 =over 4
8750
8751 =item SYNOPSIS
8752
8753 =item DESCRIPTION
8754
8755 =item CAVEATS
8756
8757 =item AUTHOR
8758
8759 =item COPYRIGHT
8760
8761 =back
8762
8763 =head2 Exporter - Implements default import method for modules
8764
8765 =over 4
8766
8767 =item SYNOPSIS
8768
8769 =item DESCRIPTION
8770
8771 =over 4
8772
8773 =item How to Export
8774
8775 =item Selecting What To Export
8776
8777 =item Specialised Import Lists
8778
8779 =item Exporting without using Export's import method
8780
8781 =item Module Version Checking
8782
8783 =item Managing Unknown Symbols
8784
8785 =item Tag Handling Utility Functions
8786
8787 =back
8788
8789 =back
8790
8791 =head2 Exporter::Heavy - Exporter guts
8792
8793 =over 4
8794
8795 =item SYNOPIS
8796
8797 =item DESCRIPTION
8798
8799 =back
8800
8801 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
8802 Makefiles etc.
8803
8804 =over 4
8805
8806 =item SYNOPSIS
8807
8808 =item DESCRIPTION
8809
8810 =back
8811
8812 cat
8813
8814 eqtime src dst
8815
8816 rm_f files...
8817
8818 rm_f files...
8819
8820 touch files ..
8821
8822 mv source... destination
8823
8824 cp source... destination
8825
8826 chmod mode files..
8827
8828 mkpath directory..
8829
8830 test_f file
8831
8832 =over 4
8833
8834 =item BUGS
8835
8836 =item SEE ALSO
8837
8838 =item AUTHOR
8839
8840 =back
8841
8842 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
8843
8844 =over 4
8845
8846 =item SYNOPSIS
8847
8848 =item DESCRIPTION
8849
8850 =item @EXPORT
8851
8852 =item FUNCTIONS
8853
8854 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
8855 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
8856
8857 =item EXAMPLES
8858
8859 =item SEE ALSO
8860
8861 =item AUTHOR
8862
8863 =back
8864
8865 =head2 ExtUtils::Install - install files from here to there
8866
8867 =over 4
8868
8869 =item SYNOPSIS
8870
8871 =item DESCRIPTION
8872
8873 =back
8874
8875 =head2 ExtUtils::Installed - Inventory management of installed modules
8876
8877 =over 4
8878
8879 =item SYNOPSIS
8880
8881 =item DESCRIPTION
8882
8883 =item USAGE
8884
8885 =item FUNCTIONS
8886
8887 new(), modules(), files(), directories(), directory_tree(), validate(),
8888 packlist(), version()
8889
8890 =item EXAMPLE
8891
8892 =item AUTHOR
8893
8894 =back
8895
8896 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
8897
8898 =over 4
8899
8900 =item SYNOPSIS
8901
8902 =item DESCRIPTION
8903
8904 For static extensions, For dynamic extensions, For dynamic extensions
8905
8906 =over 4
8907
8908 =item EXTRALIBS
8909
8910 =item LDLOADLIBS and LD_RUN_PATH
8911
8912 =item BSLOADLIBS
8913
8914 =back
8915
8916 =item PORTABILITY
8917
8918 =over 4
8919
8920 =item VMS implementation
8921
8922 =item Win32 implementation
8923
8924 =back
8925
8926 =item SEE ALSO
8927
8928 =back
8929
8930 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
8931 ExtUtils::MakeMaker
8932
8933 =over 4
8934
8935 =item SYNOPSIS
8936
8937 =item DESCRIPTION
8938
8939 canonpath, cflags, manifypods, perl_archive
8940
8941 =back
8942
8943 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
8944 ExtUtils::MakeMaker
8945
8946 =over 4
8947
8948 =item SYNOPSIS
8949
8950 =item DESCRIPTION
8951
8952 =back
8953
8954 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
8955
8956 =over 4
8957
8958 =item SYNOPSIS
8959
8960 =item DESCRIPTION
8961
8962 =item METHODS
8963
8964 =over 4
8965
8966 =item Preloaded methods
8967
8968 canonpath
8969
8970 =back
8971
8972 =back
8973
8974 catdir
8975
8976 catfile
8977
8978 curdir
8979
8980 rootdir
8981
8982 updir
8983
8984 =over 4
8985
8986 =item SelfLoaded methods
8987
8988 c_o (o)
8989
8990 =back
8991
8992 cflags (o)
8993
8994 clean (o)
8995
8996 const_cccmd (o)
8997
8998 const_config (o)
8999
9000 const_loadlibs (o)
9001
9002 constants (o)
9003
9004 depend (o)
9005
9006 dir_target (o)
9007
9008 dist (o)
9009
9010 dist_basics (o)
9011
9012 dist_ci (o)
9013
9014 dist_core (o)
9015
9016 dist_dir (o)
9017
9018 dist_test (o)
9019
9020 dlsyms (o)
9021
9022 dynamic (o)
9023
9024 dynamic_bs (o)
9025
9026 dynamic_lib (o)
9027
9028 exescan
9029
9030 extliblist
9031
9032 file_name_is_absolute
9033
9034 find_perl
9035
9036 =over 4
9037
9038 =item Methods to actually produce chunks of text for the Makefile
9039
9040 fixin
9041
9042 =back
9043
9044 force (o)
9045
9046 guess_name
9047
9048 has_link_code
9049
9050 htmlifypods (o)
9051
9052 init_dirscan
9053
9054 init_main
9055
9056 init_others
9057
9058 install (o)
9059
9060 installbin (o)
9061
9062 libscan (o)
9063
9064 linkext (o)
9065
9066 lsdir
9067
9068 macro (o)
9069
9070 makeaperl (o)
9071
9072 makefile (o)
9073
9074 manifypods (o)
9075
9076 maybe_command
9077
9078 maybe_command_in_dirs
9079
9080 needs_linking (o)
9081
9082 nicetext
9083
9084 parse_version
9085
9086 parse_abstract
9087
9088 pasthru (o)
9089
9090 path
9091
9092 perl_script
9093
9094 perldepend (o)
9095
9096 ppd
9097
9098 perm_rw (o)
9099
9100 perm_rwx (o)
9101
9102 pm_to_blib
9103
9104 post_constants (o)
9105
9106 post_initialize (o)
9107
9108 postamble (o)
9109
9110 prefixify
9111
9112 processPL (o)
9113
9114 realclean (o)
9115
9116 replace_manpage_separator
9117
9118 static (o)
9119
9120 static_lib (o)
9121
9122 staticmake (o)
9123
9124 subdir_x (o)
9125
9126 subdirs (o)
9127
9128 test (o)
9129
9130 test_via_harness (o)
9131
9132 test_via_script (o)
9133
9134 tool_autosplit (o)
9135
9136 tools_other (o)
9137
9138 tool_xsubpp (o)
9139
9140 top_targets (o)
9141
9142 writedoc
9143
9144 xs_c (o)
9145
9146 xs_cpp (o)
9147
9148 xs_o (o)
9149
9150 perl_archive
9151
9152 export_list
9153
9154 =over 4
9155
9156 =item SEE ALSO
9157
9158 =back
9159
9160 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
9161 ExtUtils::MakeMaker
9162
9163 =over 4
9164
9165 =item SYNOPSIS
9166
9167 =item DESCRIPTION
9168
9169 =over 4
9170
9171 =item Methods always loaded
9172
9173 wraplist
9174
9175 =back
9176
9177 =back
9178
9179 rootdir (override)
9180
9181 =over 4
9182
9183 =item SelfLoaded methods
9184
9185 guess_name (override)
9186
9187 =back
9188
9189 find_perl (override)
9190
9191 path (override)
9192
9193 maybe_command (override)
9194
9195 maybe_command_in_dirs (override)
9196
9197 perl_script (override)
9198
9199 file_name_is_absolute (override)
9200
9201 replace_manpage_separator
9202
9203 init_others (override)
9204
9205 constants (override)
9206
9207 cflags (override)
9208
9209 const_cccmd (override)
9210
9211 pm_to_blib (override)
9212
9213 tool_autosplit (override)
9214
9215 tool_sxubpp (override)
9216
9217 xsubpp_version (override)
9218
9219 tools_other (override)
9220
9221 dist (override)
9222
9223 c_o (override)
9224
9225 xs_c (override)
9226
9227 xs_o (override)
9228
9229 top_targets (override)
9230
9231 dlsyms (override)
9232
9233 dynamic_lib (override)
9234
9235 dynamic_bs (override)
9236
9237 static_lib (override)
9238
9239 manifypods (override)
9240
9241 processPL (override)
9242
9243 installbin (override)
9244
9245 subdir_x (override)
9246
9247 clean (override)
9248
9249 realclean (override)
9250
9251 dist_basics (override)
9252
9253 dist_core (override)
9254
9255 dist_dir (override)
9256
9257 dist_test (override)
9258
9259 install (override)
9260
9261 perldepend (override)
9262
9263 makefile (override)
9264
9265 test (override)
9266
9267 test_via_harness (override)
9268
9269 test_via_script (override)
9270
9271 makeaperl (override)
9272
9273 nicetext (override)
9274
9275 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
9276 ExtUtils::MakeMaker
9277
9278 =over 4
9279
9280 =item SYNOPSIS
9281
9282 =item DESCRIPTION
9283
9284 =back
9285
9286 catfile
9287
9288 constants (o)
9289
9290 static_lib (o)
9291
9292 dynamic_bs (o)
9293
9294 dynamic_lib (o)
9295
9296 canonpath
9297
9298 perl_script
9299
9300 pm_to_blib
9301
9302 test_via_harness (o)
9303
9304 tool_autosplit (override)
9305
9306 tools_other (o)
9307
9308 xs_o (o)
9309
9310 top_targets (o)
9311
9312 htmlifypods (o)
9313
9314 manifypods (o)
9315
9316 dist_ci (o)
9317
9318 dist_core (o)
9319
9320 pasthru (o)
9321
9322 =head2 ExtUtils::MakeMaker - create an extension Makefile
9323
9324 =over 4
9325
9326 =item SYNOPSIS
9327
9328 =item DESCRIPTION
9329
9330 =over 4
9331
9332 =item How To Write A Makefile.PL
9333
9334 =item Default Makefile Behaviour
9335
9336 =item make test
9337
9338 =item make testdb
9339
9340 =item make install
9341
9342 =item PREFIX and LIB attribute
9343
9344 =item AFS users
9345
9346 =item Static Linking of a new Perl Binary
9347
9348 =item Determination of Perl Library and Installation Locations
9349
9350 =item Which architecture dependent directory?
9351
9352 =item Using Attributes and Parameters
9353
9354 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
9355 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
9356 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
9357 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
9358 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
9359 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
9360 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
9361 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
9362 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
9363 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
9364 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
9365 PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX,
9366 PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
9367 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION,
9368 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
9369
9370 =item Additional lowercase attributes
9371
9372 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
9373 tool_autosplit
9374
9375 =item Overriding MakeMaker Methods
9376
9377 =item Hintsfile support
9378
9379 =item Distribution Support
9380
9381    make distcheck,    make skipcheck,    make distclean,    make manifest,
9382   make distdir,    make tardist,    make dist,    make uutardist,    make
9383 shdist,    make zipdist,    make ci
9384
9385 =item Disabling an extension
9386
9387 =back
9388
9389 =item ENVIRONMENT
9390
9391 PERL_MM_OPT
9392
9393 =item SEE ALSO
9394
9395 =item AUTHORS
9396
9397 =back
9398
9399 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
9400
9401 =over 4
9402
9403 =item SYNOPSIS
9404
9405 =item DESCRIPTION
9406
9407 =item MANIFEST.SKIP
9408
9409 =item EXPORT_OK
9410
9411 =item GLOBAL VARIABLES
9412
9413 =item DIAGNOSTICS
9414
9415 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
9416 C<Added to MANIFEST:> I<file>
9417
9418 =item ENVIRONMENT
9419
9420 B<PERL_MM_MANIFEST_DEBUG>
9421
9422 =item SEE ALSO
9423
9424 =item AUTHOR
9425
9426 =back
9427
9428 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
9429
9430 =over 4
9431
9432 =item SYNOPSIS
9433
9434 =item DESCRIPTION
9435
9436 =item SEE ALSO
9437
9438 =back
9439
9440 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
9441
9442 =over 4
9443
9444 =item SYNOPSIS
9445
9446 =item DESCRIPTION
9447
9448 =back
9449
9450 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
9451 extension
9452
9453 =over 4
9454
9455 =item SYNOPSIS
9456
9457 =item DESCRIPTION
9458
9459 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
9460
9461 =item AUTHOR
9462
9463 =item REVISION
9464
9465 =back
9466
9467 =head2 ExtUtils::Packlist - manage .packlist files
9468
9469 =over 4
9470
9471 =item SYNOPSIS
9472
9473 =item DESCRIPTION
9474
9475 =item USAGE
9476
9477 =item FUNCTIONS
9478
9479 new(), read(), write(), validate(), packlist_file()
9480
9481 =item EXAMPLE
9482
9483 =item AUTHOR
9484
9485 =back
9486
9487 =head2 ExtUtils::testlib - add blib/* directories to @INC
9488
9489 =over 4
9490
9491 =item SYNOPSIS
9492
9493 =item DESCRIPTION
9494
9495 =back
9496
9497 =head2 Fatal - replace functions with equivalents which succeed or die
9498
9499 =over 4
9500
9501 =item SYNOPSIS
9502
9503 =item DESCRIPTION
9504
9505 =item AUTHOR
9506
9507 =back
9508
9509 =head2 Fcntl - load the C Fcntl.h defines
9510
9511 =over 4
9512
9513 =item SYNOPSIS
9514
9515 =item DESCRIPTION
9516
9517 =item NOTE
9518
9519 =item EXPORTED SYMBOLS
9520
9521 =back
9522
9523 =head2 File::Basename, fileparse - split a pathname into pieces
9524
9525 =over 4
9526
9527 =item SYNOPSIS
9528
9529 =item DESCRIPTION
9530
9531 fileparse_set_fstype, fileparse
9532
9533 =item EXAMPLES
9534
9535 C<basename>, C<dirname>
9536
9537 =back
9538
9539 =head2 File::CheckTree, validate - run many filetest checks on a tree
9540
9541 =over 4
9542
9543 =item SYNOPSIS
9544
9545 =item DESCRIPTION
9546
9547 =back
9548
9549 =head2 File::Compare - Compare files or filehandles
9550
9551 =over 4
9552
9553 =item SYNOPSIS
9554
9555 =item DESCRIPTION
9556
9557 =item RETURN
9558
9559 =item AUTHOR
9560
9561 =back
9562
9563 =head2 File::Copy - Copy files or filehandles
9564
9565 =over 4
9566
9567 =item SYNOPSIS
9568
9569 =item DESCRIPTION
9570
9571 =over 4
9572
9573 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
9574
9575 rmscopy($from,$to[,$date_flag])
9576
9577 =back
9578
9579 =item RETURN
9580
9581 =item AUTHOR
9582
9583 =back
9584
9585 =head2 File::DosGlob - DOS like globbing and then some
9586
9587 =over 4
9588
9589 =item SYNOPSIS
9590
9591 =item DESCRIPTION
9592
9593 =item EXPORTS (by request only)
9594
9595 =item BUGS
9596
9597 =item AUTHOR
9598
9599 =item HISTORY
9600
9601 =item SEE ALSO
9602
9603 =back
9604
9605 =head2 File::Find, find - traverse a file tree
9606
9607 =over 4
9608
9609 =item SYNOPSIS
9610
9611 =item DESCRIPTION
9612
9613 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
9614 C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>,
9615 C<untaint_pattern>, C<untaint_skip>
9616
9617 =item CAVEAT
9618
9619 =back
9620
9621 =head2 File::Glob - Perl extension for BSD glob routine
9622
9623 =over 4
9624
9625 =item SYNOPSIS
9626
9627 =item DESCRIPTION
9628
9629 C<GLOB_ERR>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, C<GLOB_NOSORT>,
9630 C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, C<GLOB_TILDE>, C<GLOB_CSH>
9631
9632 =item DIAGNOSTICS
9633
9634 C<GLOB_NOSPACE>, C<GLOB_ABEND>
9635
9636 =item NOTES
9637
9638 =item AUTHOR
9639
9640 =back
9641
9642 =head2 File::Path - create or remove directory trees
9643
9644 =over 4
9645
9646 =item SYNOPSIS
9647
9648 =item DESCRIPTION
9649
9650 =item AUTHORS
9651
9652 =back
9653
9654 =head2 File::Spec - portably perform operations on file names
9655
9656 =over 4
9657
9658 =item SYNOPSIS
9659
9660 =item DESCRIPTION
9661
9662 =item SEE ALSO
9663
9664 =item AUTHORS
9665
9666 =back
9667
9668 =head2 File::Spec::Epoc - methods for Epoc file specs
9669
9670 =over 4
9671
9672 =item SYNOPSIS
9673
9674 =item DESCRIPTION
9675
9676 devnull
9677
9678 =back
9679
9680 tmpdir
9681
9682 path
9683
9684 canonpath
9685
9686 splitpath
9687
9688 splitdir
9689
9690 catpath
9691
9692 abs2rel
9693
9694 rel2abs
9695
9696 =over 4
9697
9698 =item SEE ALSO
9699
9700 =back
9701
9702 =head2 File::Spec::Functions - portably perform operations on file names
9703
9704 =over 4
9705
9706 =item SYNOPSIS
9707
9708 =item DESCRIPTION
9709
9710 =over 4
9711
9712 =item Exports
9713
9714 =back
9715
9716 =item SEE ALSO
9717
9718 =back
9719
9720 =head2 File::Spec::Mac - File::Spec for MacOS
9721
9722 =over 4
9723
9724 =item SYNOPSIS
9725
9726 =item DESCRIPTION
9727
9728 =item METHODS
9729
9730 canonpath
9731
9732 =back
9733
9734 catdir
9735
9736 catfile
9737
9738 curdir
9739
9740 devnull
9741
9742 rootdir
9743
9744 tmpdir
9745
9746 updir
9747
9748 file_name_is_absolute
9749
9750 path
9751
9752 splitpath
9753
9754 splitdir
9755
9756 catpath
9757
9758 abs2rel
9759
9760 rel2abs
9761
9762 =over 4
9763
9764 =item SEE ALSO
9765
9766 =back
9767
9768 =head2 File::Spec::OS2 - methods for OS/2 file specs
9769
9770 =over 4
9771
9772 =item SYNOPSIS
9773
9774 =item DESCRIPTION
9775
9776 =back
9777
9778 =head2 File::Spec::Unix - methods used by File::Spec
9779
9780 =over 4
9781
9782 =item SYNOPSIS
9783
9784 =item DESCRIPTION
9785
9786 =item METHODS
9787
9788 canonpath
9789
9790 =back
9791
9792 catdir
9793
9794 catfile
9795
9796 curdir
9797
9798 devnull
9799
9800 rootdir
9801
9802 tmpdir
9803
9804 updir
9805
9806 no_upwards
9807
9808 case_tolerant
9809
9810 file_name_is_absolute
9811
9812 path
9813
9814 join
9815
9816 splitpath
9817
9818 splitdir
9819
9820 catpath
9821
9822 abs2rel
9823
9824 rel2abs
9825
9826 =over 4
9827
9828 =item SEE ALSO
9829
9830 =back
9831
9832 =head2 File::Spec::VMS - methods for VMS file specs
9833
9834 =over 4
9835
9836 =item SYNOPSIS
9837
9838 =item DESCRIPTION
9839
9840 eliminate_macros
9841
9842 =back
9843
9844 fixpath
9845
9846 =over 4
9847
9848 =item Methods always loaded
9849
9850 canonpath (override)
9851
9852 =back
9853
9854 catdir
9855
9856 catfile
9857
9858 curdir (override)
9859
9860 devnull (override)
9861
9862 rootdir (override)
9863
9864 tmpdir (override)
9865
9866 updir (override)
9867
9868 case_tolerant (override)
9869
9870 path (override)
9871
9872 file_name_is_absolute (override)
9873
9874 splitpath (override)
9875
9876 splitdir (override)
9877
9878 catpath (override)
9879
9880 abs2rel (override)
9881
9882 rel2abs (override)
9883
9884 =over 4
9885
9886 =item SEE ALSO
9887
9888 =back
9889
9890 =head2 File::Spec::Win32 - methods for Win32 file specs
9891
9892 =over 4
9893
9894 =item SYNOPSIS
9895
9896 =item DESCRIPTION
9897
9898 devnull
9899
9900 =back
9901
9902 tmpdir
9903
9904 catfile
9905
9906 canonpath
9907
9908 splitpath
9909
9910 splitdir
9911
9912 catpath
9913
9914 =over 4
9915
9916 =item SEE ALSO
9917
9918 =back
9919
9920 =head2 File::Temp - return name and handle of a temporary file safely
9921
9922 =over 4
9923
9924 =item PORTABILITY
9925
9926 =item SYNOPSIS
9927
9928 =item DESCRIPTION
9929
9930 =back
9931
9932 =over 4
9933
9934 =item FUNCTIONS
9935
9936 B<tempfile>
9937
9938 =back
9939
9940 B<tempdir>
9941
9942 =over 4
9943
9944 =item MKTEMP FUNCTIONS
9945
9946 B<mkstemp>
9947
9948 =back
9949
9950 B<mkstemps>
9951
9952 B<mkdtemp>
9953
9954 B<mktemp>
9955
9956 =over 4
9957
9958 =item POSIX FUNCTIONS
9959
9960 B<tmpnam>
9961
9962 =back
9963
9964 B<tmpfile>
9965
9966 =over 4
9967
9968 =item ADDITIONAL FUNCTIONS
9969
9970 B<tempnam>
9971
9972 =back
9973
9974 =over 4
9975
9976 =item UTILITY FUNCTIONS
9977
9978 B<unlink0>
9979
9980 =back
9981
9982 =over 4
9983
9984 =item PACKAGE VARIABLES
9985
9986 B<safe_level>, STANDARD, MEDIUM, HIGH
9987
9988 =back
9989
9990 TopSystemUID
9991
9992 =over 4
9993
9994 =item WARNING
9995
9996 =over 4
9997
9998 =item Temporary files and NFS
9999
10000 =back
10001
10002 =item HISTORY
10003
10004 =item SEE ALSO
10005
10006 =item AUTHOR
10007
10008 =back
10009
10010 =head2 File::stat - by-name interface to Perl's built-in stat() functions
10011
10012 =over 4
10013
10014 =item SYNOPSIS
10015
10016 =item DESCRIPTION
10017
10018 =item NOTE
10019
10020 =item AUTHOR
10021
10022 =back
10023
10024 =head2 FileCache - keep more files open than the system permits
10025
10026 =over 4
10027
10028 =item SYNOPSIS
10029
10030 =item DESCRIPTION
10031
10032 =item BUGS
10033
10034 =back
10035
10036 =head2 FileHandle - supply object methods for filehandles
10037
10038 =over 4
10039
10040 =item SYNOPSIS
10041
10042 =item DESCRIPTION
10043
10044 $fh->print, $fh->printf, $fh->getline, $fh->getlines
10045
10046 =item SEE ALSO
10047
10048 =back
10049
10050 =head2 Filter::Simple - Simplified source filtering
10051
10052 =over 4
10053
10054 =item SYNOPSIS
10055
10056 =item DESCRIPTION
10057
10058 =over 4
10059
10060 =item The Problem
10061
10062 =item A Solution
10063
10064 =item How it works
10065
10066 =back
10067
10068 =item AUTHOR
10069
10070 =item COPYRIGHT
10071
10072 =back
10073
10074 =head2 Filter::Util::Call - Perl Source Filter Utility Module
10075
10076 =over 4
10077
10078 =item SYNOPSIS
10079
10080     use Filter::Util::Call ;
10081
10082 =item DESCRIPTION
10083
10084 =over 4
10085
10086 =item B<use Filter::Util::Call>
10087
10088 =item B<import()>
10089
10090 =item B<filter() and anonymous sub>
10091
10092 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
10093
10094 =back
10095
10096 =item EXAMPLES
10097
10098 =over 4
10099
10100 =item Example 1: A simple filter.
10101
10102 =item Example 2: Using the context
10103
10104 =item Example 3: Using the context within the filter
10105
10106 =item Example 4: Using filter_del
10107
10108 =back
10109
10110 =item AUTHOR
10111
10112 =item DATE
10113
10114 =back
10115
10116 =head2 FindBin - Locate directory of original perl script
10117
10118 =over 4
10119
10120 =item SYNOPSIS
10121
10122 =item DESCRIPTION
10123
10124 =item EXPORTABLE VARIABLES
10125
10126 =item KNOWN BUGS
10127
10128 =item AUTHORS
10129
10130 =item COPYRIGHT
10131
10132 =back
10133
10134 =head2 GDBM_File - Perl5 access to the gdbm library.
10135
10136 =over 4
10137
10138 =item SYNOPSIS
10139
10140 =item DESCRIPTION
10141
10142 =item AVAILABILITY
10143
10144 =item BUGS
10145
10146 =item SEE ALSO
10147
10148 =back
10149
10150 =head2 Getopt::Long - Extended processing of command line options
10151
10152 =over 4
10153
10154 =item SYNOPSIS
10155
10156 =item DESCRIPTION
10157
10158 =item Command Line Options, an Introduction
10159
10160 =item Getting Started with Getopt::Long
10161
10162 =over 4
10163
10164 =item Simple options
10165
10166 =item A little bit less simple options
10167
10168 =item Mixing command line option with other arguments
10169
10170 =item Options with values
10171
10172 =item Options with multiple values
10173
10174 =item Options with hash values
10175
10176 =item User-defined subroutines to handle options
10177
10178 =item Options with multiple names
10179
10180 =item Case and abbreviations
10181
10182 =item Summary of Option Specifications
10183
10184 !, +, s, i, f, : I<type> [ I<desttype> ]
10185
10186 =back
10187
10188 =item Advanced Possibilities
10189
10190 =over 4
10191
10192 =item Object oriented interface
10193
10194 =item Documentation and help texts
10195
10196 =item Storing options in a hash
10197
10198 =item Bundling
10199
10200 =item The lonesome dash
10201
10202 =item Argument call-back
10203
10204 =back
10205
10206 =item Configuring Getopt::Long
10207
10208 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
10209 require_order, permute, bundling (default: disabled), bundling_override
10210 (default: disabled), ignore_case  (default: enabled), ignore_case_always
10211 (default: disabled), pass_through (default: disabled), prefix,
10212 prefix_pattern, debug (default: disabled)
10213
10214 =item Return values and Errors
10215
10216 =item Legacy
10217
10218 =over 4
10219
10220 =item Default destinations
10221
10222 =item Alternative option starters
10223
10224 =item Configuration variables
10225
10226 =back
10227
10228 =item Trouble Shooting
10229
10230 =over 4
10231
10232 =item Warning: Ignoring '!' modifier for short option
10233
10234 =item GetOptions does not return a false result when an option is not
10235 supplied
10236
10237 =back
10238
10239 =item AUTHOR
10240
10241 =item COPYRIGHT AND DISCLAIMER
10242
10243 =back
10244
10245 =head2 Getopt::Std, getopt - Process single-character switches with switch
10246 clustering
10247
10248 =over 4
10249
10250 =item SYNOPSIS
10251
10252 =item DESCRIPTION
10253
10254 =back
10255
10256 =head2 I18N::Collate - compare 8-bit scalar data according to the current
10257 locale
10258
10259 =over 4
10260
10261 =item SYNOPSIS
10262
10263 =item DESCRIPTION
10264
10265 =back
10266
10267 =head2 IO - load various IO modules
10268
10269 =over 4
10270
10271 =item SYNOPSIS
10272
10273 =item DESCRIPTION
10274
10275 =back
10276
10277 =head2 IO::Dir - supply object methods for directory handles
10278
10279 =over 4
10280
10281 =item SYNOPSIS
10282
10283 =item DESCRIPTION
10284
10285 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10286 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10287
10288 =item SEE ALSO
10289
10290 =item AUTHOR
10291
10292 =item COPYRIGHT
10293
10294 =back
10295
10296 =head2 IO::File - supply object methods for filehandles
10297
10298 =over 4
10299
10300 =item SYNOPSIS
10301
10302 =item DESCRIPTION
10303
10304 =item CONSTRUCTOR
10305
10306 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10307
10308 =item METHODS
10309
10310 open( FILENAME [,MODE [,PERMS]] )
10311
10312 =item SEE ALSO
10313
10314 =item HISTORY
10315
10316 =back
10317
10318 =head2 IO::Handle - supply object methods for I/O handles
10319
10320 =over 4
10321
10322 =item SYNOPSIS
10323
10324 =item DESCRIPTION
10325
10326 =item CONSTRUCTOR
10327
10328 new (), new_from_fd ( FD, MODE )
10329
10330 =item METHODS
10331
10332 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10333 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10334 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10335 $io->blocking ( [ BOOL ] ), $io->untaint
10336
10337 =item NOTE
10338
10339 =item SEE ALSO
10340
10341 =item BUGS
10342
10343 =item HISTORY
10344
10345 =back
10346
10347 =head2 IO::Pipe - supply object methods for pipes
10348
10349 =over 4
10350
10351 =item SYNOPSIS
10352
10353 =item DESCRIPTION
10354
10355 =item CONSTRUCTOR
10356
10357 new ( [READER, WRITER] )
10358
10359 =item METHODS
10360
10361 reader ([ARGS]), writer ([ARGS]), handles ()
10362
10363 =item SEE ALSO
10364
10365 =item AUTHOR
10366
10367 =item COPYRIGHT
10368
10369 =back
10370
10371 =head2 IO::Poll - Object interface to system poll call
10372
10373 =over 4
10374
10375 =item SYNOPSIS
10376
10377 =item DESCRIPTION
10378
10379 =item METHODS
10380
10381 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10382 IO ), handles( [ EVENT_MASK ] )
10383
10384 =item SEE ALSO
10385
10386 =item AUTHOR
10387
10388 =item COPYRIGHT
10389
10390 =back
10391
10392 =head2 IO::Seekable - supply seek based methods for I/O objects
10393
10394 =over 4
10395
10396 =item SYNOPSIS
10397
10398 =item DESCRIPTION
10399
10400 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10401 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10402 $io->tell
10403
10404 =item HISTORY
10405
10406 =back
10407
10408 =head2 IO::Select - OO interface to the select system call
10409
10410 =over 4
10411
10412 =item SYNOPSIS
10413
10414 =item DESCRIPTION
10415
10416 =item CONSTRUCTOR
10417
10418 new ( [ HANDLES ] )
10419
10420 =item METHODS
10421
10422 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
10423 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
10424 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
10425
10426 =item EXAMPLE
10427
10428 =item AUTHOR
10429
10430 =item COPYRIGHT
10431
10432 =back
10433
10434 =head2 IO::Socket - Object interface to socket communications
10435
10436 =over 4
10437
10438 =item SYNOPSIS
10439
10440 =item DESCRIPTION
10441
10442 =item CONSTRUCTOR
10443
10444 new ( [ARGS] )
10445
10446 =item METHODS
10447
10448 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
10449 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
10450
10451 =item SEE ALSO
10452
10453 =item AUTHOR
10454
10455 =item COPYRIGHT
10456
10457 =back
10458
10459 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
10460
10461 =over 4
10462
10463 =item SYNOPSIS
10464
10465 =item DESCRIPTION
10466
10467 =item CONSTRUCTOR
10468
10469 new ( [ARGS] )
10470
10471 =over 4
10472
10473 =item METHODS
10474
10475 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
10476 ()
10477
10478 =back
10479
10480 =item SEE ALSO
10481
10482 =item AUTHOR
10483
10484 =item COPYRIGHT
10485
10486 =back
10487
10488 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
10489
10490 =over 4
10491
10492 =item SYNOPSIS
10493
10494 =item DESCRIPTION
10495
10496 =item CONSTRUCTOR
10497
10498 new ( [ARGS] )
10499
10500 =item METHODS
10501
10502 hostpath(), peerpath()
10503
10504 =item SEE ALSO
10505
10506 =item AUTHOR
10507
10508 =item COPYRIGHT
10509
10510 =back
10511
10512 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
10513 handles
10514
10515 =over 4
10516
10517 =item SYNOPSIS
10518
10519 =item DESCRIPTION
10520
10521 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10522 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10523
10524 =item SEE ALSO
10525
10526 =item AUTHOR
10527
10528 =item COPYRIGHT
10529
10530 =back
10531
10532 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
10533
10534 =over 4
10535
10536 =item SYNOPSIS
10537
10538 =item DESCRIPTION
10539
10540 =item CONSTRUCTOR
10541
10542 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10543
10544 =item METHODS
10545
10546 open( FILENAME [,MODE [,PERMS]] )
10547
10548 =item SEE ALSO
10549
10550 =item HISTORY
10551
10552 =back
10553
10554 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
10555 handles
10556
10557 =over 4
10558
10559 =item SYNOPSIS
10560
10561 =item DESCRIPTION
10562
10563 =item CONSTRUCTOR
10564
10565 new (), new_from_fd ( FD, MODE )
10566
10567 =item METHODS
10568
10569 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10570 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10571 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10572 $io->blocking ( [ BOOL ] ), $io->untaint
10573
10574 =item NOTE
10575
10576 =item SEE ALSO
10577
10578 =item BUGS
10579
10580 =item HISTORY
10581
10582 =back
10583
10584 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
10585
10586 =over 4
10587
10588 =item SYNOPSIS
10589
10590 =item DESCRIPTION
10591
10592 =item CONSTRUCTOR
10593
10594 new ( [READER, WRITER] )
10595
10596 =item METHODS
10597
10598 reader ([ARGS]), writer ([ARGS]), handles ()
10599
10600 =item SEE ALSO
10601
10602 =item AUTHOR
10603
10604 =item COPYRIGHT
10605
10606 =back
10607
10608 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
10609
10610 =over 4
10611
10612 =item SYNOPSIS
10613
10614 =item DESCRIPTION
10615
10616 =item METHODS
10617
10618 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10619 IO ), handles( [ EVENT_MASK ] )
10620
10621 =item SEE ALSO
10622
10623 =item AUTHOR
10624
10625 =item COPYRIGHT
10626
10627 =back
10628
10629 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
10630 I/O objects
10631
10632 =over 4
10633
10634 =item SYNOPSIS
10635
10636 =item DESCRIPTION
10637
10638 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10639 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10640 $io->tell
10641
10642 =item HISTORY
10643
10644 =back
10645
10646 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
10647 call
10648
10649 =over 4
10650
10651 =item SYNOPSIS
10652
10653 =item DESCRIPTION
10654
10655 =item CONSTRUCTOR
10656
10657 new ( [ HANDLES ] )
10658
10659 =item METHODS
10660
10661 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
10662 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
10663 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
10664
10665 =item EXAMPLE
10666
10667 =item AUTHOR
10668
10669 =item COPYRIGHT
10670
10671 =back
10672
10673 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
10674 communications
10675
10676 =over 4
10677
10678 =item SYNOPSIS
10679
10680 =item DESCRIPTION
10681
10682 =item CONSTRUCTOR
10683
10684 new ( [ARGS] )
10685
10686 =item METHODS
10687
10688 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
10689 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
10690
10691 =item SEE ALSO
10692
10693 =item AUTHOR
10694
10695 =item COPYRIGHT
10696
10697 =back
10698
10699 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
10700 AF_INET domain sockets
10701
10702 =over 4
10703
10704 =item SYNOPSIS
10705
10706 =item DESCRIPTION
10707
10708 =item CONSTRUCTOR
10709
10710 new ( [ARGS] )
10711
10712 =over 4
10713
10714 =item METHODS
10715
10716 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
10717 ()
10718
10719 =back
10720
10721 =item SEE ALSO
10722
10723 =item AUTHOR
10724
10725 =item COPYRIGHT
10726
10727 =back
10728
10729 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
10730 AF_UNIX domain sockets
10731
10732 =over 4
10733
10734 =item SYNOPSIS
10735
10736 =item DESCRIPTION
10737
10738 =item CONSTRUCTOR
10739
10740 new ( [ARGS] )
10741
10742 =item METHODS
10743
10744 hostpath(), peerpath()
10745
10746 =item SEE ALSO
10747
10748 =item AUTHOR
10749
10750 =item COPYRIGHT
10751
10752 =back
10753
10754 =head2 IPC::Msg - SysV Msg IPC object class
10755
10756 =over 4
10757
10758 =item SYNOPSIS
10759
10760 =item DESCRIPTION
10761
10762 =item METHODS
10763
10764 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
10765 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
10766 FLAGS ] ), stat
10767
10768 =item SEE ALSO
10769
10770 =item AUTHOR
10771
10772 =item COPYRIGHT
10773
10774 =back
10775
10776 =head2 IPC::Open2, open2 - open a process for both reading and writing
10777
10778 =over 4
10779
10780 =item SYNOPSIS
10781
10782 =item DESCRIPTION
10783
10784 =item WARNING
10785
10786 =item SEE ALSO
10787
10788 =back
10789
10790 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
10791 handling
10792
10793 =over 4
10794
10795 =item SYNOPSIS
10796
10797 =item DESCRIPTION
10798
10799 =item WARNING
10800
10801 =back
10802
10803 =head2 IPC::Semaphore - SysV Semaphore IPC object class
10804
10805 =over 4
10806
10807 =item SYNOPSIS
10808
10809 =item DESCRIPTION
10810
10811 =item METHODS
10812
10813 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
10814 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
10815 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
10816 , VALUE ), stat
10817
10818 =item SEE ALSO
10819
10820 =item AUTHOR
10821
10822 =item COPYRIGHT
10823
10824 =back
10825
10826 =head2 IPC::SysV - SysV IPC constants
10827
10828 =over 4
10829
10830 =item SYNOPSIS
10831
10832 =item DESCRIPTION
10833
10834 ftok( PATH, ID )
10835
10836 =item SEE ALSO
10837
10838 =item AUTHORS
10839
10840 =item COPYRIGHT
10841
10842 =back
10843
10844 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
10845
10846 =over 4
10847
10848 =item SYNOPSIS
10849
10850 =item DESCRIPTION
10851
10852 =item METHODS
10853
10854 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
10855 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
10856 FLAGS ] ), stat
10857
10858 =item SEE ALSO
10859
10860 =item AUTHOR
10861
10862 =item COPYRIGHT
10863
10864 =back
10865
10866 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
10867 class
10868
10869 =over 4
10870
10871 =item SYNOPSIS
10872
10873 =item DESCRIPTION
10874
10875 =item METHODS
10876
10877 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
10878 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
10879 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
10880 , VALUE ), stat
10881
10882 =item SEE ALSO
10883
10884 =item AUTHOR
10885
10886 =item COPYRIGHT
10887
10888 =back
10889
10890 =head2 Math::BigFloat - Arbitrary length float math package
10891
10892 =over 4
10893
10894 =item SYNOPSIS
10895
10896 =item DESCRIPTION
10897
10898 number format, Error returns 'NaN', Division is computed to, Rounding is
10899 performed
10900
10901 =item BUGS
10902
10903 =item AUTHOR
10904
10905 =back
10906
10907 =head2 Math::BigInt - Arbitrary size integer math package
10908
10909 =over 4
10910
10911 =item SYNOPSIS
10912
10913 =item DESCRIPTION
10914
10915 Canonical notation, Input, Output
10916
10917 =item EXAMPLES
10918
10919 =item Autocreating constants
10920
10921 =item BUGS
10922
10923 =item AUTHOR
10924
10925 =back
10926
10927 =head2 Math::Complex - complex numbers and associated mathematical
10928 functions
10929
10930 =over 4
10931
10932 =item SYNOPSIS
10933
10934 =item DESCRIPTION
10935
10936 =item OPERATIONS
10937
10938 =item CREATION
10939
10940 =item STRINGIFICATION
10941
10942 =over 4
10943
10944 =item CHANGED IN PERL 5.6
10945
10946 =back
10947
10948 =item USAGE
10949
10950 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
10951
10952 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
10953
10954 =item BUGS
10955
10956 =item AUTHORS
10957
10958 =back
10959
10960 =head2 Math::Trig - trigonometric functions
10961
10962 =over 4
10963
10964 =item SYNOPSIS
10965
10966 =item DESCRIPTION
10967
10968 =item TRIGONOMETRIC FUNCTIONS
10969
10970 B<tan>
10971
10972 =over 4
10973
10974 =item ERRORS DUE TO DIVISION BY ZERO
10975
10976 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
10977
10978 =back
10979
10980 =item PLANE ANGLE CONVERSIONS
10981
10982 =item RADIAL COORDINATE CONVERSIONS
10983
10984 =over 4
10985
10986 =item COORDINATE SYSTEMS
10987
10988 =item 3-D ANGLE CONVERSIONS
10989
10990 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
10991 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
10992
10993 =back
10994
10995 =item GREAT CIRCLE DISTANCES
10996
10997 =item EXAMPLES
10998
10999 =item BUGS
11000
11001 =item AUTHORS
11002
11003 =back
11004
11005 =head2 NDBM_File - Tied access to ndbm files
11006
11007 =over 4
11008
11009 =item SYNOPSIS
11010
11011 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
11012
11013 =item DIAGNOSTICS
11014
11015 =over 4
11016
11017 =item C<ndbm store returned -1, errno 22, key "..." at ...>
11018
11019 =back
11020
11021 =item BUGS AND WARNINGS
11022
11023 =back
11024
11025 =head2 Net::Ping - check a remote host for reachability
11026
11027 =over 4
11028
11029 =item SYNOPSIS
11030
11031 =item DESCRIPTION
11032
11033 =over 4
11034
11035 =item Functions
11036
11037 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
11038 $timeout]);, $p->close();, pingecho($host [, $timeout]);
11039
11040 =back
11041
11042 =item WARNING
11043
11044 =item NOTES
11045
11046 =back
11047
11048 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
11049 functions
11050
11051 =over 4
11052
11053 =item SYNOPSIS
11054
11055 =item DESCRIPTION
11056
11057 =item EXAMPLES
11058
11059 =item NOTE
11060
11061 =item AUTHOR
11062
11063 =back
11064
11065 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
11066 functions
11067
11068 =over 4
11069
11070 =item SYNOPSIS
11071
11072 =item DESCRIPTION
11073
11074 =item EXAMPLES
11075
11076 =item NOTE
11077
11078 =item AUTHOR
11079
11080 =back
11081
11082 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
11083 functions
11084
11085 =over 4
11086
11087 =item SYNOPSIS
11088
11089 =item DESCRIPTION
11090
11091 =item NOTE
11092
11093 =item AUTHOR
11094
11095 =back
11096
11097 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
11098 functions
11099
11100 =over 4
11101
11102 =item SYNOPSIS
11103
11104 =item DESCRIPTION
11105
11106 =item EXAMPLES
11107
11108 =item NOTE
11109
11110 =item AUTHOR
11111
11112 =back
11113
11114 =head2 O - Generic interface to Perl Compiler backends
11115
11116 =over 4
11117
11118 =item SYNOPSIS
11119
11120 =item DESCRIPTION
11121
11122 =item CONVENTIONS
11123
11124 =item IMPLEMENTATION
11125
11126 =item AUTHOR
11127
11128 =back
11129
11130 =head2 ODBM_File - Tied access to odbm files
11131
11132 =over 4
11133
11134 =item SYNOPSIS
11135
11136 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
11137
11138 =item DIAGNOSTICS
11139
11140 =over 4
11141
11142 =item C<odbm store returned -1, errno 22, key "..." at ...>
11143
11144 =back
11145
11146 =item BUGS AND WARNINGS
11147
11148 =back
11149
11150 =head2 Opcode - Disable named opcodes when compiling perl code
11151
11152 =over 4
11153
11154 =item SYNOPSIS
11155
11156 =item DESCRIPTION
11157
11158 =item NOTE
11159
11160 =item WARNING
11161
11162 =item Operator Names and Operator Lists
11163
11164 an operator name (opname), an operator tag name (optag), a negated opname
11165 or optag, an operator set (opset)
11166
11167 =item Opcode Functions
11168
11169 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
11170 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
11171 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
11172 opdump (PAT)
11173
11174 =item Manipulating Opsets
11175
11176 =item TO DO (maybe)
11177
11178 =back
11179
11180 =over 4
11181
11182 =item Predefined Opcode Tags
11183
11184 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
11185 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
11186 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
11187 :dangerous
11188
11189 =item SEE ALSO
11190
11191 =item AUTHORS
11192
11193 =back
11194
11195 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
11196 compartments
11197
11198 =over 4
11199
11200 =item SYNOPSIS
11201
11202 =item DESCRIPTION
11203
11204 a new namespace, an operator mask
11205
11206 =item WARNING
11207
11208 =over 4
11209
11210 =item RECENT CHANGES
11211
11212 =item Methods in class Safe
11213
11214 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
11215 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
11216 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
11217 root (NAMESPACE), mask (MASK)
11218
11219 =item Some Safety Issues
11220
11221 Memory, CPU, Snooping, Signals, State Changes
11222
11223 =item AUTHOR
11224
11225 =back
11226
11227 =back
11228
11229 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
11230 compiling
11231
11232 =over 4
11233
11234 =item SYNOPSIS
11235
11236 =item DESCRIPTION
11237
11238 =item SEE ALSO
11239
11240 =back
11241
11242 =head2 POSIX - Perl interface to IEEE Std 1003.1
11243
11244 =over 4
11245
11246 =item SYNOPSIS
11247
11248 =item DESCRIPTION
11249
11250 =item NOTE
11251
11252 =item CAVEATS
11253
11254 =item FUNCTIONS
11255
11256 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
11257 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
11258 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
11259 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
11260 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
11261 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
11262 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
11263 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
11264 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
11265 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
11266 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
11267 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
11268 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
11269 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
11270 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
11271 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
11272 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
11273 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
11274 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
11275 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
11276 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
11277 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
11278 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
11279 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
11280 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
11281 wctomb, write
11282
11283 =item CLASSES
11284
11285 =over 4
11286
11287 =item POSIX::SigAction
11288
11289 new
11290
11291 =item POSIX::SigSet
11292
11293 new, addset, delset, emptyset, fillset, ismember
11294
11295 =item POSIX::Termios
11296
11297 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
11298 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
11299 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
11300 field values, c_cflag field values, c_iflag field values, c_lflag field
11301 values, c_oflag field values
11302
11303 =back
11304
11305 =item PATHNAME CONSTANTS
11306
11307 Constants
11308
11309 =item POSIX CONSTANTS
11310
11311 Constants
11312
11313 =item SYSTEM CONFIGURATION
11314
11315 Constants
11316
11317 =item ERRNO
11318
11319 Constants
11320
11321 =item FCNTL
11322
11323 Constants
11324
11325 =item FLOAT
11326
11327 Constants
11328
11329 =item LIMITS
11330
11331 Constants
11332
11333 =item LOCALE
11334
11335 Constants
11336
11337 =item MATH
11338
11339 Constants
11340
11341 =item SIGNAL
11342
11343 Constants
11344
11345 =item STAT
11346
11347 Constants, Macros
11348
11349 =item STDLIB
11350
11351 Constants
11352
11353 =item STDIO
11354
11355 Constants
11356
11357 =item TIME
11358
11359 Constants
11360
11361 =item UNISTD
11362
11363 Constants
11364
11365 =item WAIT
11366
11367 Constants, Macros
11368
11369 =back
11370
11371 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
11372
11373 =over 4
11374
11375 =item SYNOPSIS
11376
11377 =item OPTIONS/ARGUMENTS
11378
11379 =over 4
11380
11381 =item podchecker()
11382
11383 B<-warnings> =E<gt> I<val>
11384
11385 =back
11386
11387 =item DESCRIPTION
11388
11389 =item DIAGNOSTICS
11390
11391 =over 4
11392
11393 =item Errors
11394
11395 empty =headn, =over on line I<N> without closing =back, =item without
11396 previous =over, =back without previous =over, No argument for =begin, =end
11397 without =begin, Nested =begin's, =for without formatter specification,
11398 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
11399 interior-sequence "I<SEQ>", nested commands
11400 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
11401 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
11402 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
11403 after =back
11404
11405 =item Warnings
11406
11407 multiple occurence of link target I<name>, line containing nothing but
11408 whitespace in paragraph, file does not start with =head, No numeric
11409 argument for =over, previous =item has no contents, preceding non-item
11410 paragraph(s), =item type mismatch (I<one> vs. I<two>), I<N> unescaped
11411 C<E<lt>E<gt>> in paragraph, Unknown entity, No items in =over, No argument
11412 for =item, empty section in previous paragraph, Verbatim paragraph in NAME
11413 section
11414
11415 =item Hyperlinks
11416
11417 collapsing newlines to blanks, ignoring leading/trailing whitespace in
11418 link, (section) in '$page' deprecated, alternative text/node '%s' contains
11419 non-escaped | or /
11420
11421 =back
11422
11423 =item RETURN VALUE
11424
11425 =item EXAMPLES
11426
11427 =item INTERFACE
11428
11429 =back
11430
11431 C<Pod::Checker-E<gt>new( %options )>
11432
11433 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
11434 @args )>
11435
11436 C<$checker-E<gt>num_errors()>
11437
11438 C<$checker-E<gt>name()>
11439
11440 C<$checker-E<gt>node()>
11441
11442 C<$checker-E<gt>idx()>
11443
11444 C<$checker-E<gt>hyperlink()>
11445
11446 =over 4
11447
11448 =item AUTHOR
11449
11450 =back
11451
11452 =head2 Pod::Find - find POD documents in directory trees
11453
11454 =over 4
11455
11456 =item SYNOPSIS
11457
11458 =item DESCRIPTION
11459
11460 =back
11461
11462 =over 4
11463
11464 =item C<pod_find( { %opts } , @directories )>
11465
11466 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
11467 1>
11468
11469 =back
11470
11471 =over 4
11472
11473 =item C<simplify_name( $str )>
11474
11475 =back
11476
11477 =over 4
11478
11479 =item C<pod_where( { %opts }, $pod )>
11480
11481 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
11482 1>
11483
11484 =back
11485
11486 =over 4
11487
11488 =item C<contains_pod( $file , $verbose )>
11489
11490 =back
11491
11492 =over 4
11493
11494 =item AUTHOR
11495
11496 =item SEE ALSO
11497
11498 =back
11499
11500 =head2 Pod::Html - module to convert pod files to HTML
11501
11502 =over 4
11503
11504 =item SYNOPSIS
11505
11506 =item DESCRIPTION
11507
11508 =item ARGUMENTS
11509
11510 backlink, css, flush, header, help, htmldir, htmlroot, index, infile,
11511 libpods, netscape, outfile, podpath, podroot, quiet, recurse, title,
11512 verbose
11513
11514 =item EXAMPLE
11515
11516 =item ENVIRONMENT
11517
11518 =item AUTHOR
11519
11520 =item SEE ALSO
11521
11522 =item COPYRIGHT
11523
11524 =back
11525
11526 =head2 Pod::InputObjects - objects representing POD input paragraphs,
11527 commands, etc.
11528
11529 =over 4
11530
11531 =item SYNOPSIS
11532
11533 =item REQUIRES
11534
11535 =item EXPORTS
11536
11537 =item DESCRIPTION
11538
11539 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
11540 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
11541
11542 =back
11543
11544 =over 4
11545
11546 =item B<Pod::InputSource>
11547
11548 =back
11549
11550 =over 4
11551
11552 =item B<new()>
11553
11554 =back
11555
11556 =over 4
11557
11558 =item B<name()>
11559
11560 =back
11561
11562 =over 4
11563
11564 =item B<handle()>
11565
11566 =back
11567
11568 =over 4
11569
11570 =item B<was_cutting()>
11571
11572 =back
11573
11574 =over 4
11575
11576 =item B<Pod::Paragraph>
11577
11578 =back
11579
11580 =over 4
11581
11582 =item Pod::Paragraph-E<gt>B<new()>
11583
11584 =back
11585
11586 =over 4
11587
11588 =item $pod_para-E<gt>B<cmd_name()>
11589
11590 =back
11591
11592 =over 4
11593
11594 =item $pod_para-E<gt>B<text()>
11595
11596 =back
11597
11598 =over 4
11599
11600 =item $pod_para-E<gt>B<raw_text()>
11601
11602 =back
11603
11604 =over 4
11605
11606 =item $pod_para-E<gt>B<cmd_prefix()>
11607
11608 =back
11609
11610 =over 4
11611
11612 =item $pod_para-E<gt>B<cmd_separator()>
11613
11614 =back
11615
11616 =over 4
11617
11618 =item $pod_para-E<gt>B<parse_tree()>
11619
11620 =back
11621
11622 =over 4
11623
11624 =item $pod_para-E<gt>B<file_line()>
11625
11626 =back
11627
11628 =over 4
11629
11630 =item B<Pod::InteriorSequence>
11631
11632 =back
11633
11634 =over 4
11635
11636 =item Pod::InteriorSequence-E<gt>B<new()>
11637
11638 =back
11639
11640 =over 4
11641
11642 =item $pod_seq-E<gt>B<cmd_name()>
11643
11644 =back
11645
11646 =over 4
11647
11648 =item $pod_seq-E<gt>B<prepend()>
11649
11650 =back
11651
11652 =over 4
11653
11654 =item $pod_seq-E<gt>B<append()>
11655
11656 =back
11657
11658 =over 4
11659
11660 =item $pod_seq-E<gt>B<nested()>
11661
11662 =back
11663
11664 =over 4
11665
11666 =item $pod_seq-E<gt>B<raw_text()>
11667
11668 =back
11669
11670 =over 4
11671
11672 =item $pod_seq-E<gt>B<left_delimiter()>
11673
11674 =back
11675
11676 =over 4
11677
11678 =item $pod_seq-E<gt>B<right_delimiter()>
11679
11680 =back
11681
11682 =over 4
11683
11684 =item $pod_seq-E<gt>B<parse_tree()>
11685
11686 =back
11687
11688 =over 4
11689
11690 =item $pod_seq-E<gt>B<file_line()>
11691
11692 =back
11693
11694 =over 4
11695
11696 =item Pod::InteriorSequence::B<DESTROY()>
11697
11698 =back
11699
11700 =over 4
11701
11702 =item B<Pod::ParseTree>
11703
11704 =back
11705
11706 =over 4
11707
11708 =item Pod::ParseTree-E<gt>B<new()>
11709
11710 =back
11711
11712 =over 4
11713
11714 =item $ptree-E<gt>B<top()>
11715
11716 =back
11717
11718 =over 4
11719
11720 =item $ptree-E<gt>B<children()>
11721
11722 =back
11723
11724 =over 4
11725
11726 =item $ptree-E<gt>B<prepend()>
11727
11728 =back
11729
11730 =over 4
11731
11732 =item $ptree-E<gt>B<append()>
11733
11734 =back
11735
11736 =over 4
11737
11738 =item $ptree-E<gt>B<raw_text()>
11739
11740 =back
11741
11742 =over 4
11743
11744 =item Pod::ParseTree::B<DESTROY()>
11745
11746 =back
11747
11748 =over 4
11749
11750 =item SEE ALSO
11751
11752 =item AUTHOR
11753
11754 =back
11755
11756 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
11757
11758 =over 4
11759
11760 =item SYNOPSIS
11761
11762 =item DESCRIPTION
11763
11764 =back
11765
11766 =over 4
11767
11768 =item OBJECT METHODS
11769
11770 C<initialize>
11771
11772 =back
11773
11774 =over 4
11775
11776 =item Data Accessors
11777
11778 B<AddPreamble>
11779
11780 =back
11781
11782 B<AddPostamble>
11783
11784 B<Head1Level>
11785
11786 B<Label>
11787
11788 B<LevelNoNum>
11789
11790 B<MakeIndex>
11791
11792 B<ReplaceNAMEwithSection>
11793
11794 B<StartWithNewPage>
11795
11796 B<TableOfContents>
11797
11798 B<UniqueLabels>
11799
11800 B<UserPreamble>
11801
11802 B<UserPostamble>
11803
11804 B<Lists>
11805
11806 =over 4
11807
11808 =item Subclassed methods
11809
11810 =back
11811
11812 B<begin_pod>
11813
11814 B<end_pod>
11815
11816 B<command>
11817
11818 B<verbatim>
11819
11820 B<textblock>
11821
11822 B<interior_sequence>
11823
11824 =over 4
11825
11826 =item List Methods
11827
11828 B<begin_list>
11829
11830 =back
11831
11832 B<end_list>
11833
11834 B<add_item>
11835
11836 =over 4
11837
11838 =item Methods for headings
11839
11840 B<head>
11841
11842 =back
11843
11844 =over 4
11845
11846 =item Internal methods
11847
11848 B<_output>
11849
11850 =back
11851
11852 B<_replace_special_chars>
11853
11854 B<_create_label>
11855
11856 B<_create_index>
11857
11858 B<_clean_latex_commands>
11859
11860 =over 4
11861
11862 =item NOTES
11863
11864 =item SEE ALSO
11865
11866 =item AUTHORS
11867
11868 =item COPYRIGHT
11869
11870 =item REVISION
11871
11872 =back
11873
11874 =head2 Pod::Man - Convert POD data to formatted *roff input
11875
11876 =over 4
11877
11878 =item SYNOPSIS
11879
11880 =item DESCRIPTION
11881
11882 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
11883 release, section
11884
11885 =item DIAGNOSTICS
11886
11887 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
11888 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape
11889 EE<lt>%sE<gt>, Unknown sequence %s, %s: Unknown command paragraph "%s" on
11890 line %d, Unmatched =back
11891
11892 =item BUGS
11893
11894 =item SEE ALSO
11895
11896 =item AUTHOR
11897
11898 =back
11899
11900 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
11901
11902 =over 4
11903
11904 =item SYNOPSIS
11905
11906 =item DESCRIPTION
11907
11908 =back
11909
11910 =over 4
11911
11912 =item Pod::List
11913
11914 Pod::List-E<gt>new()
11915
11916 =back
11917
11918 $list-E<gt>file()
11919
11920 $list-E<gt>start()
11921
11922 $list-E<gt>indent()
11923
11924 $list-E<gt>type()
11925
11926 $list-E<gt>rx()
11927
11928 $list-E<gt>item()
11929
11930 $list-E<gt>parent()
11931
11932 $list-E<gt>tag()
11933
11934 =over 4
11935
11936 =item Pod::Hyperlink
11937
11938 Pod::Hyperlink-E<gt>new()
11939
11940 =back
11941
11942 $link-E<gt>parse($string)
11943
11944 $link-E<gt>markup($string)
11945
11946 $link-E<gt>text()
11947
11948 $link-E<gt>warning()
11949
11950 $link-E<gt>file(), $link-E<gt>line()
11951
11952 $link-E<gt>page()
11953
11954 $link-E<gt>node()
11955
11956 $link-E<gt>alttext()
11957
11958 $link-E<gt>type()
11959
11960 $link-E<gt>link()
11961
11962 =over 4
11963
11964 =item Pod::Cache
11965
11966 Pod::Cache-E<gt>new()
11967
11968 =back
11969
11970 $cache-E<gt>item()
11971
11972 $cache-E<gt>find_page($name)
11973
11974 =over 4
11975
11976 =item Pod::Cache::Item
11977
11978 Pod::Cache::Item-E<gt>new()
11979
11980 =back
11981
11982 $cacheitem-E<gt>page()
11983
11984 $cacheitem-E<gt>description()
11985
11986 $cacheitem-E<gt>path()
11987
11988 $cacheitem-E<gt>file()
11989
11990 $cacheitem-E<gt>nodes()
11991
11992 $cacheitem-E<gt>find_node($name)
11993
11994 $cacheitem-E<gt>idx()
11995
11996 =over 4
11997
11998 =item AUTHOR
11999
12000 =item SEE ALSO
12001
12002 =back
12003
12004 =head2 Pod::Parser - base class for creating POD filters and translators
12005
12006 =over 4
12007
12008 =item SYNOPSIS
12009
12010 =item REQUIRES
12011
12012 =item EXPORTS
12013
12014 =item DESCRIPTION
12015
12016 =item QUICK OVERVIEW
12017
12018 =item PARSING OPTIONS
12019
12020 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
12021 B<-warnings> (default: unset)
12022
12023 =back
12024
12025 =over 4
12026
12027 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
12028
12029 =back
12030
12031 =over 4
12032
12033 =item B<command()>
12034
12035 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
12036
12037 =back
12038
12039 =over 4
12040
12041 =item B<verbatim()>
12042
12043 C<$text>, C<$line_num>, C<$pod_para>
12044
12045 =back
12046
12047 =over 4
12048
12049 =item B<textblock()>
12050
12051 C<$text>, C<$line_num>, C<$pod_para>
12052
12053 =back
12054
12055 =over 4
12056
12057 =item B<interior_sequence()>
12058
12059 =back
12060
12061 =over 4
12062
12063 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
12064
12065 =back
12066
12067 =over 4
12068
12069 =item B<new()>
12070
12071 =back
12072
12073 =over 4
12074
12075 =item B<initialize()>
12076
12077 =back
12078
12079 =over 4
12080
12081 =item B<begin_pod()>
12082
12083 =back
12084
12085 =over 4
12086
12087 =item B<begin_input()>
12088
12089 =back
12090
12091 =over 4
12092
12093 =item B<end_input()>
12094
12095 =back
12096
12097 =over 4
12098
12099 =item B<end_pod()>
12100
12101 =back
12102
12103 =over 4
12104
12105 =item B<preprocess_line()>
12106
12107 =back
12108
12109 =over 4
12110
12111 =item B<preprocess_paragraph()>
12112
12113 =back
12114
12115 =over 4
12116
12117 =item METHODS FOR PARSING AND PROCESSING
12118
12119 =back
12120
12121 =over 4
12122
12123 =item B<parse_text()>
12124
12125 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
12126 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
12127 I<code-ref>|I<method-name>
12128
12129 =back
12130
12131 =over 4
12132
12133 =item B<interpolate()>
12134
12135 =back
12136
12137 =over 4
12138
12139 =item B<parse_paragraph()>
12140
12141 =back
12142
12143 =over 4
12144
12145 =item B<parse_from_filehandle()>
12146
12147 =back
12148
12149 =over 4
12150
12151 =item B<parse_from_file()>
12152
12153 =back
12154
12155 =over 4
12156
12157 =item ACCESSOR METHODS
12158
12159 =back
12160
12161 =over 4
12162
12163 =item B<errorsub()>
12164
12165 =back
12166
12167 =over 4
12168
12169 =item B<cutting()>
12170
12171 =back
12172
12173 =over 4
12174
12175 =item B<parseopts()>
12176
12177 =back
12178
12179 =over 4
12180
12181 =item B<output_file()>
12182
12183 =back
12184
12185 =over 4
12186
12187 =item B<output_handle()>
12188
12189 =back
12190
12191 =over 4
12192
12193 =item B<input_file()>
12194
12195 =back
12196
12197 =over 4
12198
12199 =item B<input_handle()>
12200
12201 =back
12202
12203 =over 4
12204
12205 =item B<input_streams()>
12206
12207 =back
12208
12209 =over 4
12210
12211 =item B<top_stream()>
12212
12213 =back
12214
12215 =over 4
12216
12217 =item PRIVATE METHODS AND DATA
12218
12219 =back
12220
12221 =over 4
12222
12223 =item B<_push_input_stream()>
12224
12225 =back
12226
12227 =over 4
12228
12229 =item B<_pop_input_stream()>
12230
12231 =back
12232
12233 =over 4
12234
12235 =item TREE-BASED PARSING
12236
12237 =item SEE ALSO
12238
12239 =item AUTHOR
12240
12241 =back
12242
12243 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
12244
12245 =over 4
12246
12247 =item SYNOPSIS
12248
12249 =item DESCRIPTION
12250
12251 =over 4
12252
12253 =item EXPORT
12254
12255 =back
12256
12257 =item AUTHOR
12258
12259 =item SEE ALSO
12260
12261 =back
12262
12263 =head2 Pod::Select, podselect() - extract selected sections of POD from
12264 input
12265
12266 =over 4
12267
12268 =item SYNOPSIS
12269
12270 =item REQUIRES
12271
12272 =item EXPORTS
12273
12274 =item DESCRIPTION
12275
12276 =item SECTION SPECIFICATIONS
12277
12278 =item RANGE SPECIFICATIONS
12279
12280 =back
12281
12282 =over 4
12283
12284 =item OBJECT METHODS
12285
12286 =back
12287
12288 =over 4
12289
12290 =item B<curr_headings()>
12291
12292 =back
12293
12294 =over 4
12295
12296 =item B<select()>
12297
12298 =back
12299
12300 =over 4
12301
12302 =item B<add_selection()>
12303
12304 =back
12305
12306 =over 4
12307
12308 =item B<clear_selections()>
12309
12310 =back
12311
12312 =over 4
12313
12314 =item B<match_section()>
12315
12316 =back
12317
12318 =over 4
12319
12320 =item B<is_selected()>
12321
12322 =back
12323
12324 =over 4
12325
12326 =item EXPORTED FUNCTIONS
12327
12328 =back
12329
12330 =over 4
12331
12332 =item B<podselect()>
12333
12334 B<-output>, B<-sections>, B<-ranges>
12335
12336 =back
12337
12338 =over 4
12339
12340 =item PRIVATE METHODS AND DATA
12341
12342 =back
12343
12344 =over 4
12345
12346 =item B<_compile_section_spec()>
12347
12348 =back
12349
12350 =over 4
12351
12352 =item $self->{_SECTION_HEADINGS}
12353
12354 =back
12355
12356 =over 4
12357
12358 =item $self->{_SELECTED_SECTIONS}
12359
12360 =back
12361
12362 =over 4
12363
12364 =item SEE ALSO
12365
12366 =item AUTHOR
12367
12368 =back
12369
12370 =head2 Pod::Text - Convert POD data to formatted ASCII text
12371
12372 =over 4
12373
12374 =item SYNOPSIS
12375
12376 =item DESCRIPTION
12377
12378 alt, indent, loose, quotes, sentence, width
12379
12380 =item DIAGNOSTICS
12381
12382 Bizarre space in item, Can't open %s for reading: %s, Invalid quote
12383 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
12384 %s, Unknown sequence: %s, Unmatched =back
12385
12386 =item RESTRICTIONS
12387
12388 =item NOTES
12389
12390 =item SEE ALSO
12391
12392 =item AUTHOR
12393
12394 =back
12395
12396 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
12397
12398 =over 4
12399
12400 =item SYNOPSIS
12401
12402 =item DESCRIPTION
12403
12404 =item BUGS
12405
12406 =item SEE ALSO
12407
12408 =item AUTHOR
12409
12410 =back
12411
12412 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
12413 text
12414
12415 =over 4
12416
12417 =item SYNOPSIS
12418
12419 =item DESCRIPTION
12420
12421 =item BUGS
12422
12423 =item SEE ALSO
12424
12425 =item AUTHOR
12426
12427 =back
12428
12429 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
12430 text with format escapes
12431
12432 =over 4
12433
12434 =item SYNOPSIS
12435
12436 =item DESCRIPTION
12437
12438 =item SEE ALSO
12439
12440 =item AUTHOR
12441
12442 =back
12443
12444 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
12445 documentation
12446
12447 =over 4
12448
12449 =item SYNOPSIS
12450
12451 =item ARGUMENTS
12452
12453 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
12454 C<-pathlist>
12455
12456 =item DESCRIPTION
12457
12458 =item EXAMPLES
12459
12460 =over 4
12461
12462 =item Recommended Use
12463
12464 =back
12465
12466 =item CAVEATS
12467
12468 =item AUTHOR
12469
12470 =item ACKNOWLEDGEMENTS
12471
12472 =back
12473
12474 =head2 SDBM_File - Tied access to sdbm files
12475
12476 =over 4
12477
12478 =item SYNOPSIS
12479
12480 =item DESCRIPTION
12481
12482 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
12483
12484 =item DIAGNOSTICS
12485
12486 =over 4
12487
12488 =item C<sdbm store returned -1, errno 22, key "..." at ...>
12489
12490 =back
12491
12492 =item BUGS AND WARNINGS
12493
12494 =back
12495
12496 =head2 Safe - Compile and execute code in restricted compartments
12497
12498 =over 4
12499
12500 =item SYNOPSIS
12501
12502 =item DESCRIPTION
12503
12504 a new namespace, an operator mask
12505
12506 =item WARNING
12507
12508 =over 4
12509
12510 =item RECENT CHANGES
12511
12512 =item Methods in class Safe
12513
12514 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
12515 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
12516 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
12517 root (NAMESPACE), mask (MASK)
12518
12519 =item Some Safety Issues
12520
12521 Memory, CPU, Snooping, Signals, State Changes
12522
12523 =item AUTHOR
12524
12525 =back
12526
12527 =back
12528
12529 =head2 Search::Dict, look - search for key in dictionary file
12530
12531 =over 4
12532
12533 =item SYNOPSIS
12534
12535 =item DESCRIPTION
12536
12537 =back
12538
12539 =head2 SelectSaver - save and restore selected file handle
12540
12541 =over 4
12542
12543 =item SYNOPSIS
12544
12545 =item DESCRIPTION
12546
12547 =back
12548
12549 =head2 SelfLoader - load functions only on demand
12550
12551 =over 4
12552
12553 =item SYNOPSIS
12554
12555 =item DESCRIPTION
12556
12557 =over 4
12558
12559 =item The __DATA__ token
12560
12561 =item SelfLoader autoloading
12562
12563 =item Autoloading and package lexicals
12564
12565 =item SelfLoader and AutoLoader
12566
12567 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
12568
12569 =item Classes and inherited methods.
12570
12571 =back
12572
12573 =item Multiple packages and fully qualified subroutine names
12574
12575 =back
12576
12577 =head2 Shell - run shell commands transparently within perl
12578
12579 =over 4
12580
12581 =item SYNOPSIS
12582
12583 =item DESCRIPTION
12584
12585 =over 4
12586
12587 =item OBJECT ORIENTED SYNTAX
12588
12589 =back
12590
12591 =item AUTHOR
12592
12593 =back
12594
12595 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
12596 socket.h defines and structure manipulators
12597
12598 =over 4
12599
12600 =item SYNOPSIS
12601
12602 =item DESCRIPTION
12603
12604 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
12605 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
12606 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
12607 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
12608 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
12609
12610 =back
12611
12612 =head2 Storable - persistency for perl data structures
12613
12614 =over 4
12615
12616 =item SYNOPSIS
12617
12618 =item DESCRIPTION
12619
12620 =item MEMORY STORE
12621
12622 =item ADVISORY LOCKING
12623
12624 =item SPEED
12625
12626 =item CANONICAL REPRESENTATION
12627
12628 =item ERROR REPORTING
12629
12630 =item WIZARDS ONLY
12631
12632 =over 4
12633
12634 =item Hooks
12635
12636 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
12637 I<serialized>, ..
12638
12639 =item Predicates
12640
12641 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
12642 C<Storable::is_retrieving>
12643
12644 =item Recursion
12645
12646 =item Deep Cloning
12647
12648 =back
12649
12650 =item EXAMPLES
12651
12652 =item WARNING
12653
12654 =item BUGS
12655
12656 =item CREDITS
12657
12658 =item TRANSLATIONS
12659
12660 =item AUTHOR
12661
12662 =item SEE ALSO
12663
12664 =back
12665
12666 =head2 Symbol - manipulate Perl symbols and their names
12667
12668 =over 4
12669
12670 =item SYNOPSIS
12671
12672 =item DESCRIPTION
12673
12674 =back
12675
12676 =head2 Sys::Hostname - Try every conceivable way to get hostname
12677
12678 =over 4
12679
12680 =item SYNOPSIS
12681
12682 =item DESCRIPTION
12683
12684 =item AUTHOR
12685
12686 =back
12687
12688 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
12689 interface to the UNIX syslog(3) calls
12690
12691 =over 4
12692
12693 =item SYNOPSIS
12694
12695 =item DESCRIPTION
12696
12697 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
12698 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
12699 closelog
12700
12701 =item EXAMPLES
12702
12703 =item SEE ALSO
12704
12705 =item AUTHOR
12706
12707 =back
12708
12709 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
12710 Perl interface to the UNIX syslog(3) calls
12711
12712 =over 4
12713
12714 =item SYNOPSIS
12715
12716 =item DESCRIPTION
12717
12718 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
12719 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
12720 closelog
12721
12722 =item EXAMPLES
12723
12724 =item SEE ALSO
12725
12726 =item AUTHOR
12727
12728 =back
12729
12730 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
12731
12732 =over 4
12733
12734 =item SYNOPSIS
12735
12736 =item DESCRIPTION
12737
12738 =item DIAGNOSTICS
12739
12740 Invalid attribute name %s, Name "%s" used only once: possible typo, No
12741 comma allowed after filehandle, Bareword "%s" not allowed while "strict
12742 subs" in use
12743
12744 =item RESTRICTIONS
12745
12746 =item NOTES
12747
12748 =item AUTHORS
12749
12750 =back
12751
12752 =head2 Term::Cap - Perl termcap interface
12753
12754 =over 4
12755
12756 =item SYNOPSIS
12757
12758 =item DESCRIPTION
12759
12760 =item EXAMPLES
12761
12762 =back
12763
12764 =head2 Term::Complete - Perl word completion module
12765
12766 =over 4
12767
12768 =item SYNOPSIS
12769
12770 =item DESCRIPTION
12771
12772 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
12773
12774 =item DIAGNOSTICS
12775
12776 =item BUGS
12777
12778 =item AUTHOR
12779
12780 =back
12781
12782 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
12783 no real package is found, substitutes stubs instead of basic functions.
12784
12785 =over 4
12786
12787 =item SYNOPSIS
12788
12789 =item DESCRIPTION
12790
12791 =item Minimal set of supported functions
12792
12793 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
12794 C<MinLine>, C<findConsole>, Attribs, C<Features>
12795
12796 =item Additional supported functions
12797
12798 C<tkRunning>, C<ornaments>, C<newTTY>
12799
12800 =item EXPORTS
12801
12802 =item ENVIRONMENT
12803
12804 =back
12805
12806 =head2   Test - provides a simple framework for writing test scripts
12807
12808 =over 4
12809
12810 =item SYNOPSIS
12811
12812 =item DESCRIPTION
12813
12814 =item TEST TYPES
12815
12816 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
12817
12818 =item RETURN VALUE
12819
12820 =item ONFAIL
12821
12822 =item SEE ALSO
12823
12824 =item AUTHOR
12825
12826 =back
12827
12828 =head2 Test::Harness - run perl standard test scripts with statistics
12829
12830 =over 4
12831
12832 =item SYNOPSIS
12833
12834 =item DESCRIPTION
12835
12836 =over 4
12837
12838 =item The test script output
12839
12840 B<1..M>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
12841 B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
12842 B<Todo tests>, B<Bail out!>, B<Comments>
12843
12844 =back
12845
12846 =item EXPORT
12847
12848 =item DIAGNOSTICS
12849
12850 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
12851 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
12852 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
12853 %s>, C<FAILED--Further testing stopped%s>
12854
12855 =item ENVIRONMENT
12856
12857 C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
12858 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
12859 C<HARNESS_ACTIVE>
12860
12861 =item SEE ALSO
12862
12863 =item AUTHORS
12864
12865 =item BUGS
12866
12867 =back
12868
12869 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
12870
12871 =over 4
12872
12873 =item SYNOPSIS
12874
12875 =item DESCRIPTION
12876
12877 =item EXAMPLE
12878
12879 =back
12880
12881 =head2 Text::ParseWords - parse text into an array of tokens or array of
12882 arrays
12883
12884 =over 4
12885
12886 =item SYNOPSIS
12887
12888 =item DESCRIPTION
12889
12890 =item EXAMPLES
12891
12892 =item AUTHORS
12893
12894 =back
12895
12896 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
12897 by Knuth
12898
12899 =over 4
12900
12901 =item SYNOPSIS
12902
12903 =item DESCRIPTION
12904
12905 =item EXAMPLES
12906
12907 =item LIMITATIONS
12908
12909 =item AUTHOR
12910
12911 =back
12912
12913 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
12914 unexpand(1)
12915
12916 =over 4
12917
12918 =item SYNOPSIS
12919
12920 =item DESCRIPTION
12921
12922 =item BUGS
12923
12924 =item AUTHOR
12925
12926 =back
12927
12928 =head2 Text::Wrap - line wrapping to form simple paragraphs
12929
12930 =over 4
12931
12932 =item SYNOPSIS
12933
12934 =item DESCRIPTION
12935
12936 =item EXAMPLE
12937
12938 =item AUTHOR
12939
12940 =back
12941
12942 =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
12943 change)
12944
12945 =over 4
12946
12947 =item SYNOPSIS
12948
12949 =item DESCRIPTION
12950
12951 =item FUNCTIONS
12952
12953 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
12954 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
12955 cond_broadcast VARIABLE, yield
12956
12957 =item METHODS
12958
12959 join, eval, detach, equal, tid, flags, done
12960
12961 =item LIMITATIONS
12962
12963 =item SEE ALSO
12964
12965 =back
12966
12967 =head2 Thread::Queue - thread-safe queues
12968
12969 =over 4
12970
12971 =item SYNOPSIS
12972
12973 =item DESCRIPTION
12974
12975 =item FUNCTIONS AND METHODS
12976
12977 new, enqueue LIST, dequeue, dequeue_nb, pending
12978
12979 =item SEE ALSO
12980
12981 =back
12982
12983 =head2 Thread::Semaphore - thread-safe semaphores
12984
12985 =over 4
12986
12987 =item SYNOPSIS
12988
12989 =item DESCRIPTION
12990
12991 =item FUNCTIONS AND METHODS
12992
12993 new, new NUMBER, down, down NUMBER, up, up NUMBER
12994
12995 =back
12996
12997 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
12998
12999 =over 4
13000
13001 =item SYNOPSIS
13002
13003 =item DESCRIPTION
13004
13005 =item BUGS
13006
13007 =back
13008
13009 =head2 Thread::Specific - thread-specific keys
13010
13011 =over 4
13012
13013 =item SYNOPSIS
13014
13015 =item DESCRIPTION
13016
13017 =back
13018
13019 =head2 Tie::Array - base class for tied arrays
13020
13021 =over 4
13022
13023 =item SYNOPSIS
13024
13025 =item DESCRIPTION
13026
13027 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
13028 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
13029 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
13030 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
13031
13032 =item CAVEATS
13033
13034 =item AUTHOR
13035
13036 =back
13037
13038 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
13039 handles
13040
13041 =over 4
13042
13043 =item SYNOPSIS
13044
13045 =item DESCRIPTION
13046
13047 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
13048 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
13049 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
13050 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
13051
13052 =item MORE INFORMATION
13053
13054 =item COMPATIBILITY
13055
13056 =back
13057
13058 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
13059
13060 =over 4
13061
13062 =item SYNOPSIS
13063
13064 =item DESCRIPTION
13065
13066 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
13067 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
13068
13069 =item CAVEATS
13070
13071 =item MORE INFORMATION
13072
13073 =back
13074
13075 =head2 Tie::RefHash - use references as hash keys
13076
13077 =over 4
13078
13079 =item SYNOPSIS
13080
13081 =item DESCRIPTION
13082
13083 =item EXAMPLE
13084
13085 =item AUTHOR
13086
13087 =item VERSION
13088
13089 =item SEE ALSO
13090
13091 =back
13092
13093 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
13094 scalars
13095
13096 =over 4
13097
13098 =item SYNOPSIS
13099
13100 =item DESCRIPTION
13101
13102 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
13103
13104 =item MORE INFORMATION
13105
13106 =back
13107
13108 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
13109
13110 =over 4
13111
13112 =item SYNOPSIS
13113
13114 =item DESCRIPTION
13115
13116 =item CAVEATS
13117
13118 =back
13119
13120 =head2 Time::Local - efficiently compute time from local and GMT time
13121
13122 =over 4
13123
13124 =item SYNOPSIS
13125
13126 =item DESCRIPTION
13127
13128 =item IMPLEMENTATION
13129
13130 =item BUGS
13131
13132 =back
13133
13134 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
13135 function
13136
13137 =over 4
13138
13139 =item SYNOPSIS
13140
13141 =item DESCRIPTION
13142
13143 =item NOTE
13144
13145 =item AUTHOR
13146
13147 =back
13148
13149 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
13150 function
13151
13152 =over 4
13153
13154 =item SYNOPSIS
13155
13156 =item DESCRIPTION
13157
13158 =item NOTE
13159
13160 =item AUTHOR
13161
13162 =back
13163
13164 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
13165
13166 =over 4
13167
13168 =item SYNOPSIS
13169
13170 =item DESCRIPTION
13171
13172 =item AUTHOR
13173
13174 =back
13175
13176 =head2 UNIVERSAL - base class for ALL classes (blessed references)
13177
13178 =over 4
13179
13180 =item SYNOPSIS
13181
13182 =item DESCRIPTION
13183
13184 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
13185 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
13186
13187 =back
13188
13189 =head2 User::grent - by-name interface to Perl's built-in getgr*()
13190 functions
13191
13192 =over 4
13193
13194 =item SYNOPSIS
13195
13196 =item DESCRIPTION
13197
13198 =item NOTE
13199
13200 =item AUTHOR
13201
13202 =back
13203
13204 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
13205 functions
13206
13207 =over 4
13208
13209 =item SYNOPSIS
13210
13211 =item DESCRIPTION
13212
13213 =over 4
13214
13215 =item System Specifics
13216
13217 =back
13218
13219 =item NOTE
13220
13221 =item AUTHOR
13222
13223 =item HISTORY
13224
13225 March 18th, 2000
13226
13227 =back
13228
13229 =head2 Win32 - Interfaces to some Win32 API Functions
13230
13231 =over 4
13232
13233 =item DESCRIPTION
13234
13235 =over 4
13236
13237 =item Alphabetical Listing of Win32 Functions
13238
13239 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
13240 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
13241 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
13242 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
13243 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
13244 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
13245 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
13246 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
13247 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
13248 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
13249 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
13250 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
13251 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
13252 Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
13253 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
13254 PID), Win32::UnregisterServer(LIBRARYNAME)
13255
13256 =back
13257
13258 =back
13259
13260 =head2 XSLoader - Dynamically load C libraries into Perl code
13261
13262 =over 4
13263
13264 =item SYNOPSIS
13265
13266 =item DESCRIPTION
13267
13268 =item AUTHOR
13269
13270 =back
13271
13272 =head1 AUXILIARY DOCUMENTATION
13273
13274 Here should be listed all the extra programs' documentation, but they
13275 don't all have manual pages yet:
13276
13277 =over 4
13278
13279 =item a2p
13280
13281 =item s2p
13282
13283 =item find2perl
13284
13285 =item h2ph
13286
13287 =item c2ph
13288
13289 =item h2xs
13290
13291 =item xsubpp
13292
13293 =item pod2man
13294
13295 =item wrapsuid
13296
13297 =back
13298
13299 =head1 AUTHOR
13300
13301 Larry Wall <F<larry@wall.org>>, with the help of oodles
13302 of other folks.
13303