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 perlintro -- a brief introduction and overview of Perl
  41
  42 =over 4
  43
  44 =item DESCRIPTION
  45
  46 =over 4
  47
  48 =item What is Perl?
  49
  50 =item Running Perl programs
  51
  52 =item Basic syntax overview
  53
  54 =item Perl variable types
  55
  56 Scalars, Arrays, Hashes
  57
  58 =item Variable scoping
  59
  60 =item Conditional and looping constructs
  61
  62 if, while, for, foreach
  63
  64 =item Builtin operators and functions
  65
  66 Arithmetic, Numeric comparison, String comparison, Boolean logic,
  67 Miscellaneous
  68
  69 =item Files and I/O
  70
  71 =item Regular expressions
  72
  73 Simple matching, Simple substitution, More complex regular expressions,
  74 Parentheses for capturing, Other regexp features
  75
  76 =item Writing subroutines
  77
  78 =item OO Perl
  79
  80 =item Using Perl modules
  81
  82 =back
  83
  84 =item AUTHOR
  85
  86 =back
  87
  88 =head2 perlfaq - frequently asked questions about Perl ($Date: 2001/10/16
  89 13:27:22 $)
  90
  91 =over 4
  92
  93 =item DESCRIPTION
  94
  95 =over 4
  96
  97 =item perlfaq: Structural overview of the FAQ.
  98
  99 =item L<perlfaq1>: General Questions About Perl
 100
 101 =item L<perlfaq2>: Obtaining and Learning about Perl
 102
 103 =item L<perlfaq3>: Programming Tools
 104
 105 =item L<perlfaq4>: Data Manipulation
 106
 107 =item L<perlfaq5>: Files and Formats
 108
 109 =item L<perlfaq6>: Regexps
 110
 111 =item L<perlfaq7>: General Perl Language Issues
 112
 113 =item L<perlfaq8>: System Interaction
 114
 115 =item L<perlfaq9>: Networking
 116
 117 =back
 118
 119 =item About the perlfaq documents
 120
 121 =over 4
 122
 123 =item Where to get the perlfaq
 124
 125 =item How to contribute to the perlfaq
 126
 127 =item What will happen if you mail your Perl programming problems to the
 128 authors
 129
 130 =back
 131
 132 =item Credits
 133
 134 =item Author and Copyright Information
 135
 136 =over 4
 137
 138 =item Bundled Distributions
 139
 140 =item Disclaimer
 141
 142 =back
 143
 144 =item Changes
 145
 146 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98,
 147 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
 148 Initial Release: 11/March/97
 149
 150 =back
 151
 152 =head2 perlbook - Perl book information
 153
 154 =over 4
 155
 156 =item DESCRIPTION
 157
 158 =back
 159
 160 =head2 perlsyn - Perl syntax
 161
 162 =over 4
 163
 164 =item DESCRIPTION
 165
 166 =over 4
 167
 168 =item Declarations
 169
 170 =item Simple statements
 171
 172 =item Compound statements
 173
 174 =item Loop Control
 175
 176 =item For Loops
 177
 178 =item Foreach Loops
 179
 180 =item Basic BLOCKs and Switch Statements
 181
 182 =item Goto
 183
 184 =item PODs: Embedded Documentation
 185
 186 =item Plain Old Comments (Not!)
 187
 188 =back
 189
 190 =back
 191
 192 =head2 perldata - Perl data types
 193
 194 =over 4
 195
 196 =item DESCRIPTION
 197
 198 =over 4
 199
 200 =item Variable names
 201
 202 =item Context
 203
 204 =item Scalar values
 205
 206 =item Scalar value constructors
 207
 208 =item List value constructors
 209
 210 =item Slices
 211
 212 =item Typeglobs and Filehandles
 213
 214 =back
 215
 216 =item SEE ALSO
 217
 218 =back
 219
 220 =head2 perlop - Perl operators and precedence
 221
 222 =over 4
 223
 224 =item SYNOPSIS
 225
 226 =item DESCRIPTION
 227
 228 =over 4
 229
 230 =item Terms and List Operators (Leftward)
 231
 232 =item The Arrow Operator
 233
 234 =item Auto-increment and Auto-decrement
 235
 236 =item Exponentiation
 237
 238 =item Symbolic Unary Operators
 239
 240 =item Binding Operators
 241
 242 =item Multiplicative Operators
 243
 244 =item Additive Operators
 245
 246 =item Shift Operators
 247
 248 =item Named Unary Operators
 249
 250 =item Relational Operators
 251
 252 =item Equality Operators
 253
 254 =item Bitwise And
 255
 256 =item Bitwise Or and Exclusive Or
 257
 258 =item C-style Logical And
 259
 260 =item C-style Logical Or
 261
 262 =item Range Operators
 263
 264 =item Conditional Operator
 265
 266 =item Assignment Operators
 267
 268 =item Comma Operator
 269
 270 =item List Operators (Rightward)
 271
 272 =item Logical Not
 273
 274 =item Logical And
 275
 276 =item Logical or and Exclusive Or
 277
 278 =item C Operators Missing From Perl
 279
 280 unary &, unary *, (TYPE)
 281
 282 =item Quote and Quote-like Operators
 283
 284 =item Regexp Quote-Like Operators
 285
 286 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 287 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 288 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 289 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 290
 291 =item Gory details of parsing quoted constructs
 292
 293 Finding the end, Removal of backslashes before delimiters, Interpolation,
 294 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 295 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 296 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 297 regular expressions
 298
 299 =item I/O Operators
 300
 301 =item Constant Folding
 302
 303 =item Bitwise String Operators
 304
 305 =item Integer Arithmetic
 306
 307 =item Floating-point Arithmetic
 308
 309 =item Bigger Numbers
 310
 311 =back
 312
 313 =back
 314
 315 =head2 perlsub - Perl subroutines
 316
 317 =over 4
 318
 319 =item SYNOPSIS
 320
 321 =item DESCRIPTION
 322
 323 =over 4
 324
 325 =item Private Variables via my()
 326
 327 =item Persistent Private Variables
 328
 329 =item Temporary Values via local()
 330
 331 =item Lvalue subroutines
 332
 333 =item Passing Symbol Table Entries (typeglobs)
 334
 335 =item When to Still Use local()
 336
 337 =item Pass by Reference
 338
 339 =item Prototypes
 340
 341 =item Constant Functions
 342
 343 =item Overriding Built-in Functions
 344
 345 =item Autoloading
 346
 347 =item Subroutine Attributes
 348
 349 =back
 350
 351 =item SEE ALSO
 352
 353 =back
 354
 355 =head2 perlfunc - Perl builtin functions
 356
 357 =over 4
 358
 359 =item DESCRIPTION
 360
 361 =over 4
 362
 363 =item Perl Functions by Category
 364
 365 Functions for SCALARs or strings, Regular expressions and pattern matching,
 366 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 367 Functions for real %HASHes, Input and output functions, Functions for fixed
 368 length data or records, Functions for filehandles, files, or directories,
 369 Keywords related to the control flow of your perl program, Keywords related
 370 to scoping, Miscellaneous functions, Functions for processes and process
 371 groups, Keywords related to perl modules, Keywords related to classes and
 372 object-orientedness, Low-level socket functions, System V interprocess
 373 communication functions, Fetching user and group info, Fetching network
 374 info, Time-related functions, Functions new in perl5, Functions obsoleted
 375 in perl5
 376
 377 =item Portability
 378
 379 =item Alphabetical Listing of Perl Functions
 380
 381 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 382 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 383 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
 384 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
 385 chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER,
 386 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
 387 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 388 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
 389 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
 390 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
 391 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
 392 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
 393 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
 394 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
 395 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
 396 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
 397 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
 398 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
 399 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
 400 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
 401 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
 402 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
 403 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
 404 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 405 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 406 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 407 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
 408 lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST,
 409 mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
 410 msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR :
 411 ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open
 412 FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST,
 413 open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR
 414 : ATTRIBUTES, pack TEMPLATE,LIST, package NAMESPACE, package, pipe
 415 READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
 416 LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
 417 LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
 418 qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
 419 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
 420 readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
 421 recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
 422 OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
 423 return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
 424 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
 425 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
 426 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
 427 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 428 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 429 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 430 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 431 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 432 EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL,
 433 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort
 434 BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice
 435 ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split
 436 /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf
 437 FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat
 438 EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK,
 439 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 440 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 441 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 442 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 443 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 444 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 445 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 446 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 447 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 448 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 449 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
 450 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
 451 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
 452 LIST, write FILEHANDLE, write EXPR, write, y///
 453
 454 =back
 455
 456 =back
 457
 458 =head2 perlreftut - Mark's very short tutorial about references
 459
 460 =over 4
 461
 462 =item DESCRIPTION
 463
 464 =item Who Needs Complicated Data Structures?
 465
 466 =item The Solution
 467
 468 =item Syntax
 469
 470 =over 4
 471
 472 =item Making References
 473
 474 =item Using References
 475
 476 =back
 477
 478 =item An Example
 479
 480 =item Arrow Rule
 481
 482 =item Solution
 483
 484 =item The Rest
 485
 486 =item Summary
 487
 488 =item Credits
 489
 490 =over 4
 491
 492 =item Distribution Conditions
 493
 494 =back
 495
 496 =back
 497
 498 =head2 perldsc - Perl Data Structures Cookbook
 499
 500 =over 4
 501
 502 =item DESCRIPTION
 503
 504 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 505 more elaborate constructs
 506
 507 =item REFERENCES
 508
 509 =item COMMON MISTAKES
 510
 511 =item CAVEAT ON PRECEDENCE
 512
 513 =item WHY YOU SHOULD ALWAYS C<use strict>
 514
 515 =item DEBUGGING
 516
 517 =item CODE EXAMPLES
 518
 519 =item ARRAYS OF ARRAYS
 520
 521 =over 4
 522
 523 =item Declaration of a ARRAY OF ARRAYS
 524
 525 =item Generation of a ARRAY OF ARRAYS
 526
 527 =item Access and Printing of a ARRAY OF ARRAYS
 528
 529 =back
 530
 531 =item HASHES OF ARRAYS
 532
 533 =over 4
 534
 535 =item Declaration of a HASH OF ARRAYS
 536
 537 =item Generation of a HASH OF ARRAYS
 538
 539 =item Access and Printing of a HASH OF ARRAYS
 540
 541 =back
 542
 543 =item ARRAYS OF HASHES
 544
 545 =over 4
 546
 547 =item Declaration of a ARRAY OF HASHES
 548
 549 =item Generation of a ARRAY OF HASHES
 550
 551 =item Access and Printing of a ARRAY OF HASHES
 552
 553 =back
 554
 555 =item HASHES OF HASHES
 556
 557 =over 4
 558
 559 =item Declaration of a HASH OF HASHES
 560
 561 =item Generation of a HASH OF HASHES
 562
 563 =item Access and Printing of a HASH OF HASHES
 564
 565 =back
 566
 567 =item MORE ELABORATE RECORDS
 568
 569 =over 4
 570
 571 =item Declaration of MORE ELABORATE RECORDS
 572
 573 =item Declaration of a HASH OF COMPLEX RECORDS
 574
 575 =item Generation of a HASH OF COMPLEX RECORDS
 576
 577 =back
 578
 579 =item Database Ties
 580
 581 =item SEE ALSO
 582
 583 =item AUTHOR
 584
 585 =back
 586
 587 =head2 perlrequick - Perl regular expressions quick start
 588
 589 =over 4
 590
 591 =item DESCRIPTION
 592
 593 =item The Guide
 594
 595 =over 4
 596
 597 =item Simple word matching
 598
 599 =item Using character classes
 600
 601 =item Matching this or that
 602
 603 =item Grouping things and hierarchical matching
 604
 605 =item Extracting matches
 606
 607 =item Matching repetitions
 608
 609 =item More matching
 610
 611 =item Search and replace
 612
 613 =item The split operator
 614
 615 =back
 616
 617 =item BUGS
 618
 619 =item SEE ALSO
 620
 621 =item AUTHOR AND COPYRIGHT
 622
 623 =over 4
 624
 625 =item Acknowledgments
 626
 627 =back
 628
 629 =back
 630
 631 =head2 perlpod - plain old documentation
 632
 633 =over 4
 634
 635 =item DESCRIPTION
 636
 637 =over 4
 638
 639 =item Verbatim Paragraph
 640
 641 =item Command Paragraph
 642
 643 =item Ordinary Block of Text
 644
 645 =item The Intent
 646
 647 =item Embedding Pods in Perl Modules
 648
 649 =item Common Pod Pitfalls
 650
 651 =back
 652
 653 =item SEE ALSO
 654
 655 =item AUTHOR
 656
 657 =back
 658
 659 =head2 perlstyle - Perl style guide
 660
 661 =over 4
 662
 663 =item DESCRIPTION
 664
 665 =back
 666
 667 =head2 perltrap - Perl traps for the unwary
 668
 669 =over 4
 670
 671 =item DESCRIPTION
 672
 673 =over 4
 674
 675 =item Awk Traps
 676
 677 =item C Traps
 678
 679 =item Sed Traps
 680
 681 =item Shell Traps
 682
 683 =item Perl Traps
 684
 685 =item Perl4 to Perl5 Traps
 686
 687 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 688 Traps, General data type traps, Context Traps - scalar, list contexts,
 689 Precedence Traps, General Regular Expression Traps using s///, etc,
 690 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 691
 692 =item Discontinuance, Deprecation, and BugFix traps
 693
 694 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 695 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 696 Discontinuance, Deprecation, Discontinuance, Discontinuance
 697
 698 =item Parsing Traps
 699
 700 Parsing, Parsing, Parsing, Parsing
 701
 702 =item Numerical Traps
 703
 704 Numerical, Numerical, Numerical, Bitwise string ops
 705
 706 =item General data type traps
 707
 708 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 709 (Constants), (Scalars), (Variable Suicide)
 710
 711 =item Context Traps - scalar, list contexts
 712
 713 (list context), (scalar context), (scalar context), (list, builtin)
 714
 715 =item Precedence Traps
 716
 717 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 718 Precedence
 719
 720 =item General Regular Expression Traps using s///, etc.
 721
 722 Regular Expression, Regular Expression, Regular Expression, Regular
 723 Expression, Regular Expression, Regular Expression, Regular Expression,
 724 Regular Expression
 725
 726 =item Subroutine, Signal, Sorting Traps
 727
 728 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 729
 730 =item OS Traps
 731
 732 (SysV), (SysV)
 733
 734 =item Interpolation Traps
 735
 736 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 737 Interpolation, Interpolation, Interpolation, Interpolation
 738
 739 =item DBM Traps
 740
 741 DBM, DBM
 742
 743 =item Unclassified Traps
 744
 745 C<require>/C<do> trap using returned value, C<split> on empty string with
 746 LIMIT specified
 747
 748 =back
 749
 750 =back
 751
 752 =head2 perlrun - how to execute the Perl interpreter
 753
 754 =over 4
 755
 756 =item SYNOPSIS
 757
 758 =item DESCRIPTION
 759
 760 =over 4
 761
 762 =item #! and quoting on non-Unix systems
 763
 764 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 765
 766 =item Location of Perl
 767
 768 =item Command Switches
 769
 770 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 771 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 772 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 773 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 774 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 775 B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>,
 776 B<-x> I<directory>
 777
 778 =back
 779
 780 =item ENVIRONMENT
 781
 782 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
 783 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL,
 784 PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to the VMS port)
 785
 786 =back
 787
 788 =head2 perldiag - various Perl diagnostics
 789
 790 =over 4
 791
 792 =item DESCRIPTION
 793
 794 =back
 795
 796 =head2 perllexwarn - Perl Lexical Warnings
 797
 798 =over 4
 799
 800 =item DESCRIPTION
 801
 802 =over 4
 803
 804 =item Default Warnings and Optional Warnings
 805
 806 =item What's wrong with B<-w> and C<$^W>
 807
 808 =item Controlling Warnings from the Command Line
 809
 810 B<-w>, B<-W>, B<-X>
 811
 812 =item Backward Compatibility
 813
 814 =item Category Hierarchy
 815
 816 =item Fatal Warnings
 817
 818 =item Reporting Warnings from a Module
 819
 820 =back
 821
 822 =item TODO
 823
 824 =item SEE ALSO
 825
 826 =item AUTHOR
 827
 828 =back
 829
 830 =head2 perldebtut - Perl debugging tutorial
 831
 832 =over 4
 833
 834 =item DESCRIPTION
 835
 836 =item use strict
 837
 838 =item Looking at data and -w and w
 839
 840 =item help
 841
 842 =item Stepping through code
 843
 844 =item Placeholder for a, w, t, T
 845
 846 =item REGULAR EXPRESSIONS
 847
 848 =item OUTPUT TIPS
 849
 850 =item CGI
 851
 852 =item GUIs
 853
 854 =item SUMMARY
 855
 856 =item SEE ALSO
 857
 858 =item AUTHOR
 859
 860 =item CONTRIBUTORS
 861
 862 =back
 863
 864 =head2 perldebug - Perl debugging
 865
 866 =over 4
 867
 868 =item DESCRIPTION
 869
 870 =item The Perl Debugger
 871
 872 =over 4
 873
 874 =item Debugger Commands
 875
 876 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
 877 [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line, l subname,
 878 -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex], t, t expr,
 879 b [line] [condition], b subname [condition], b postpone subname
 880 [condition], b load filename, b compile subname, d [line], D, a [line]
 881 command, a [line], A, W expr, W, O booloption .., O anyoption? .., O
 882 option=value .., < ?, < [ command ], << command, > ?, > command, >>
 883 command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !!
 884 cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man
 885 [manpage]
 886
 887 =item Configurable Options
 888
 889 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 890 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 891 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 892 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
 893 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>,
 894 C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
 895
 896 =item Debugger input/output
 897
 898 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 899 listing
 900
 901 =item Debugging compile-time statements
 902
 903 =item Debugger Customization
 904
 905 =item Readline Support
 906
 907 =item Editor Support for Debugging
 908
 909 =item The Perl Profiler
 910
 911 =back
 912
 913 =item Debugging regular expressions
 914
 915 =item Debugging memory usage
 916
 917 =item SEE ALSO
 918
 919 =item BUGS
 920
 921 =back
 922
 923 =head2 perlvar - Perl predefined variables
 924
 925 =over 4
 926
 927 =item DESCRIPTION
 928
 929 =over 4
 930
 931 =item Predefined Names
 932
 933 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
 934 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
 935 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
 936 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
 937 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
 938 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
 939 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
 940 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
 941 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
 942 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
 943 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
 944 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
 945 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
 946 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
 947 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
 948 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
 949 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
 950 IO::Handle->format_line_break_characters EXPR,
 951 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
 952 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, $OS_ERROR,
 953 $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID,
 954 $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID,
 955 $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $],
 956 $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H,
 957 $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04,
 958 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R,
 959 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, $PERL_VERSION,
 960 $^V, $WARNING, $^W, ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS},
 961 $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV,
 962 $ENV{expr}, %SIG, $SIG{expr}
 963
 964 =item Error Indicators
 965
 966 =item Technical Note on the Syntax of Variable Names
 967
 968 =back
 969
 970 =item BUGS
 971
 972 =back
 973
 974 =head2 perllol - Manipulating Arrays of Arrays in Perl
 975
 976 =over 4
 977
 978 =item DESCRIPTION
 979
 980 =over 4
 981
 982 =item Declaration and Access of Arrays of Arrays
 983
 984 =item Growing Your Own
 985
 986 =item Access and Printing
 987
 988 =item Slices
 989
 990 =back
 991
 992 =item SEE ALSO
 993
 994 =item AUTHOR
 995
 996 =back
 997
 998 =head2 perlopentut - tutorial on opening things in Perl
 999
1000 =over 4
1001
1002 =item DESCRIPTION
1003
1004 =item Open E<agrave> la shell
1005
1006 =over 4
1007
1008 =item Simple Opens
1009
1010 =item Pipe Opens
1011
1012 =item The Minus File
1013
1014 =item Mixing Reads and Writes
1015
1016 =item Filters
1017
1018 =back
1019
1020 =item Open E<agrave> la C
1021
1022 =over 4
1023
1024 =item Permissions E<agrave> la mode
1025
1026 =back
1027
1028 =item Obscure Open Tricks
1029
1030 =over 4
1031
1032 =item Re-Opening Files (dups)
1033
1034 =item Dispelling the Dweomer
1035
1036 =item Paths as Opens
1037
1038 =item Single Argument Open
1039
1040 =item Playing with STDIN and STDOUT
1041
1042 =back
1043
1044 =item Other I/O Issues
1045
1046 =over 4
1047
1048 =item Opening Non-File Files
1049
1050 =item Binary Files
1051
1052 =item File Locking
1053
1054 =back
1055
1056 =item SEE ALSO
1057
1058 =item AUTHOR and COPYRIGHT
1059
1060 =item HISTORY
1061
1062 =back
1063
1064 =head2 perlretut - Perl regular expressions tutorial
1065
1066 =over 4
1067
1068 =item DESCRIPTION
1069
1070 =item Part 1: The basics
1071
1072 =over 4
1073
1074 =item Simple word matching
1075
1076 =item Using character classes
1077
1078 =item Matching this or that
1079
1080 =item Grouping things and hierarchical matching
1081
1082 =item Extracting matches
1083
1084 =item Matching repetitions
1085
1086 =item Building a regexp
1087
1088 =item Using regular expressions in Perl
1089
1090 =back
1091
1092 =item Part 2: Power tools
1093
1094 =over 4
1095
1096 =item More on characters, strings, and character classes
1097
1098 =item Compiling and saving regular expressions
1099
1100 =item Embedding comments and modifiers in a regular expression
1101
1102 =item Non-capturing groupings
1103
1104 =item Looking ahead and looking behind
1105
1106 =item Using independent subexpressions to prevent backtracking
1107
1108 =item Conditional expressions
1109
1110 =item A bit of magic: executing Perl code in a regular expression
1111
1112 =item Pragmas and debugging
1113
1114 =back
1115
1116 =item BUGS
1117
1118 =item SEE ALSO
1119
1120 =item AUTHOR AND COPYRIGHT
1121
1122 =over 4
1123
1124 =item Acknowledgments
1125
1126 =back
1127
1128 =back
1129
1130 =head2 perlre - Perl regular expressions
1131
1132 =over 4
1133
1134 =item DESCRIPTION
1135
1136 i, m, s, x
1137
1138 =over 4
1139
1140 =item Regular Expressions
1141
1142 cntrl, graph, print, punct, xdigit
1143
1144 =item Extended Patterns
1145
1146 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1147 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1148 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1149 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1150
1151 =item Backtracking
1152
1153 =item Version 8 Regular Expressions
1154
1155 =item Warning on \1 vs $1
1156
1157 =item Repeated patterns matching zero-length substring
1158
1159 =item Combining pieces together
1160
1161 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1162 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1163 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1164 C<(?(condition)yes-pattern|no-pattern)>
1165
1166 =item Creating custom RE engines
1167
1168 =back
1169
1170 =item BUGS
1171
1172 =item SEE ALSO
1173
1174 =back
1175
1176 =head2 perlref - Perl references and nested data structures
1177
1178 =over 4
1179
1180 =item NOTE
1181
1182 =item DESCRIPTION
1183
1184 =over 4
1185
1186 =item Making References
1187
1188 =item Using References
1189
1190 =item Symbolic references
1191
1192 =item Not-so-symbolic references
1193
1194 =item Pseudo-hashes: Using an array as a hash
1195
1196 =item Function Templates
1197
1198 =back
1199
1200 =item WARNING
1201
1202 =item SEE ALSO
1203
1204 =back
1205
1206 =head2 perlform - Perl formats
1207
1208 =over 4
1209
1210 =item DESCRIPTION
1211
1212 =over 4
1213
1214 =item Format Variables
1215
1216 =back
1217
1218 =item NOTES
1219
1220 =over 4
1221
1222 =item Footers
1223
1224 =item Accessing Formatting Internals
1225
1226 =back
1227
1228 =item WARNINGS
1229
1230 =back
1231
1232 =head2 perlboot - Beginner's Object-Oriented Tutorial
1233
1234 =over 4
1235
1236 =item DESCRIPTION
1237
1238 =over 4
1239
1240 =item If we could talk to the animals...
1241
1242 =item Introducing the method invocation arrow
1243
1244 =item Invoking a barnyard
1245
1246 =item The extra parameter of method invocation
1247
1248 =item Calling a second method to simplify things
1249
1250 =item Inheriting the windpipes
1251
1252 =item A few notes about @ISA
1253
1254 =item Overriding the methods
1255
1256 =item Starting the search from a different place
1257
1258 =item The SUPER way of doing things
1259
1260 =item Where we're at so far...
1261
1262 =item A horse is a horse, of course of course -- or is it?
1263
1264 =item Invoking an instance method
1265
1266 =item Accessing the instance data
1267
1268 =item How to build a horse
1269
1270 =item Inheriting the constructor
1271
1272 =item Making a method work with either classes or instances
1273
1274 =item Adding parameters to a method
1275
1276 =item More interesting instances
1277
1278 =item A horse of a different color
1279
1280 =item Summary
1281
1282 =back
1283
1284 =item SEE ALSO
1285
1286 =item COPYRIGHT
1287
1288 =back
1289
1290 =head2 perltoot - Tom's object-oriented tutorial for perl
1291
1292 =over 4
1293
1294 =item DESCRIPTION
1295
1296 =item Creating a Class
1297
1298 =over 4
1299
1300 =item Object Representation
1301
1302 =item Class Interface
1303
1304 =item Constructors and Instance Methods
1305
1306 =item Planning for the Future: Better Constructors
1307
1308 =item Destructors
1309
1310 =item Other Object Methods
1311
1312 =back
1313
1314 =item Class Data
1315
1316 =over 4
1317
1318 =item Accessing Class Data
1319
1320 =item Debugging Methods
1321
1322 =item Class Destructors
1323
1324 =item Documenting the Interface
1325
1326 =back
1327
1328 =item Aggregation
1329
1330 =item Inheritance
1331
1332 =over 4
1333
1334 =item Overridden Methods
1335
1336 =item Multiple Inheritance
1337
1338 =item UNIVERSAL: The Root of All Objects
1339
1340 =back
1341
1342 =item Alternate Object Representations
1343
1344 =over 4
1345
1346 =item Arrays as Objects
1347
1348 =item Closures as Objects
1349
1350 =back
1351
1352 =item AUTOLOAD: Proxy Methods
1353
1354 =over 4
1355
1356 =item Autoloaded Data Methods
1357
1358 =item Inherited Autoloaded Data Methods
1359
1360 =back
1361
1362 =item Metaclassical Tools
1363
1364 =over 4
1365
1366 =item Class::Struct
1367
1368 =item Data Members as Variables
1369
1370 =back
1371
1372 =item NOTES
1373
1374 =over 4
1375
1376 =item Object Terminology
1377
1378 =back
1379
1380 =item SEE ALSO
1381
1382 =item AUTHOR AND COPYRIGHT
1383
1384 =item COPYRIGHT
1385
1386 =over 4
1387
1388 =item Acknowledgments
1389
1390 =back
1391
1392 =back
1393
1394 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1395
1396 =over 4
1397
1398 =item DESCRIPTION
1399
1400 =item Class Data in a Can
1401
1402 =item Class Data as Package Variables
1403
1404 =over 4
1405
1406 =item Putting All Your Eggs in One Basket
1407
1408 =item Inheritance Concerns
1409
1410 =item The Eponymous Meta-Object
1411
1412 =item Indirect References to Class Data
1413
1414 =item Monadic Classes
1415
1416 =item Translucent Attributes
1417
1418 =back
1419
1420 =item Class Data as Lexical Variables
1421
1422 =over 4
1423
1424 =item Privacy and Responsibility
1425
1426 =item File-Scoped Lexicals
1427
1428 =item More Inheritance Concerns
1429
1430 =item Locking the Door and Throwing Away the Key
1431
1432 =item Translucency Revisited
1433
1434 =back
1435
1436 =item NOTES
1437
1438 =item SEE ALSO
1439
1440 =item AUTHOR AND COPYRIGHT
1441
1442 =item ACKNOWLEDGEMENTS
1443
1444 =item HISTORY
1445
1446 =back
1447
1448 =head2 perlobj - Perl objects
1449
1450 =over 4
1451
1452 =item DESCRIPTION
1453
1454 =over 4
1455
1456 =item An Object is Simply a Reference
1457
1458 =item A Class is Simply a Package
1459
1460 =item A Method is Simply a Subroutine
1461
1462 =item Method Invocation
1463
1464 =item Indirect Object Syntax
1465
1466 =item Default UNIVERSAL methods
1467
1468 isa(CLASS), can(METHOD), VERSION( [NEED] )
1469
1470 =item Destructors
1471
1472 =item Summary
1473
1474 =item Two-Phased Garbage Collection
1475
1476 =back
1477
1478 =item SEE ALSO
1479
1480 =back
1481
1482 =head2 perlbot - Bag'o Object Tricks (the BOT)
1483
1484 =over 4
1485
1486 =item DESCRIPTION
1487
1488 =item OO SCALING TIPS
1489
1490 =item INSTANCE VARIABLES
1491
1492 =item SCALAR INSTANCE VARIABLES
1493
1494 =item INSTANCE VARIABLE INHERITANCE
1495
1496 =item OBJECT RELATIONSHIPS
1497
1498 =item OVERRIDING SUPERCLASS METHODS
1499
1500 =item USING RELATIONSHIP WITH SDBM
1501
1502 =item THINKING OF CODE REUSE
1503
1504 =item CLASS CONTEXT AND THE OBJECT
1505
1506 =item INHERITING A CONSTRUCTOR
1507
1508 =item DELEGATION
1509
1510 =back
1511
1512 =head2 perltie - how to hide an object class in a simple variable
1513
1514 =over 4
1515
1516 =item SYNOPSIS
1517
1518 =item DESCRIPTION
1519
1520 =over 4
1521
1522 =item Tying Scalars
1523
1524 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1525 DESTROY this
1526
1527 =item Tying Arrays
1528
1529 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1530 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1531 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1532 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1533 this
1534
1535 =item Tying Hashes
1536
1537 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1538 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1539 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1540
1541 =item Tying FileHandles
1542
1543 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1544 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1545 DESTROY this
1546
1547 =item UNTIE this
1548
1549 =item The C<untie> Gotcha
1550
1551 =back
1552
1553 =item SEE ALSO
1554
1555 =item BUGS
1556
1557 =item AUTHOR
1558
1559 =back
1560
1561 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1562 safe subprocesses, sockets, and semaphores)
1563
1564 =over 4
1565
1566 =item DESCRIPTION
1567
1568 =item Signals
1569
1570 =item Named Pipes
1571
1572 =over 4
1573
1574 =item WARNING
1575
1576 =back
1577
1578 =item Using open() for IPC
1579
1580 =over 4
1581
1582 =item Filehandles
1583
1584 =item Background Processes
1585
1586 =item Complete Dissociation of Child from Parent
1587
1588 =item Safe Pipe Opens
1589
1590 =item Bidirectional Communication with Another Process
1591
1592 =item Bidirectional Communication with Yourself
1593
1594 =back
1595
1596 =item Sockets: Client/Server Communication
1597
1598 =over 4
1599
1600 =item Internet Line Terminators
1601
1602 =item Internet TCP Clients and Servers
1603
1604 =item Unix-Domain TCP Clients and Servers
1605
1606 =back
1607
1608 =item TCP Clients with IO::Socket
1609
1610 =over 4
1611
1612 =item A Simple Client
1613
1614 C<Proto>, C<PeerAddr>, C<PeerPort>
1615
1616 =item A Webget Client
1617
1618 =item Interactive Client with IO::Socket
1619
1620 =back
1621
1622 =item TCP Servers with IO::Socket
1623
1624 Proto, LocalPort, Listen, Reuse
1625
1626 =item UDP: Message Passing
1627
1628 =item SysV IPC
1629
1630 =item NOTES
1631
1632 =item BUGS
1633
1634 =item AUTHOR
1635
1636 =item SEE ALSO
1637
1638 =back
1639
1640 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
1641
1642 =over 4
1643
1644 =item SYNOPSIS
1645
1646 =item DESCRIPTION
1647
1648 =over 4
1649
1650 =item Behavior of other Perl features in forked pseudo-processes
1651
1652 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1653 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1654 files, directories and network sockets
1655
1656 =item Resource limits
1657
1658 =item Killing the parent process
1659
1660 =item Lifetime of the parent process and pseudo-processes
1661
1662 =item CAVEATS AND LIMITATIONS
1663
1664 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1665 Global state maintained by XSUBs, Interpreter embedded in larger
1666 application, Thread-safety of extensions
1667
1668 =back
1669
1670 =item BUGS
1671
1672 =item AUTHOR
1673
1674 =item SEE ALSO
1675
1676 =back
1677
1678 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1679
1680 =over 4
1681
1682 =item SYNOPSIS
1683
1684 =item DESCRIPTION
1685
1686 =item Storing numbers
1687
1688 =item Numeric operators and numeric conversions
1689
1690 =item Flavors of Perl numeric operations
1691
1692 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1693 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1694 integer>, Operators which expect an integer, Operators which expect a
1695 string
1696
1697 =item AUTHOR
1698
1699 =item SEE ALSO
1700
1701 =back
1702
1703 =head2 perlthrtut - tutorial on threads in Perl
1704
1705 =over 4
1706
1707 =item DESCRIPTION
1708
1709 =back
1710
1711 =head2 perlothrtut - old tutorial on threads in Perl
1712
1713 =over 4
1714
1715 =item DESCRIPTION
1716
1717 =item What Is A Thread Anyway?
1718
1719 =item Threaded Program Models
1720
1721 =over 4
1722
1723 =item Boss/Worker
1724
1725 =item Work Crew
1726
1727 =item Pipeline
1728
1729 =back
1730
1731 =item Native threads
1732
1733 =item What kind of threads are perl threads?
1734
1735 =item Threadsafe Modules
1736
1737 =item Thread Basics
1738
1739 =over 4
1740
1741 =item Basic Thread Support
1742
1743 =item Creating Threads
1744
1745 =item Giving up control
1746
1747 =item Waiting For A Thread To Exit
1748
1749 =item Errors In Threads
1750
1751 =item Ignoring A Thread
1752
1753 =back
1754
1755 =item Threads And Data
1756
1757 =over 4
1758
1759 =item Shared And Unshared Data
1760
1761 =item Thread Pitfall: Races
1762
1763 =item Controlling access: lock()
1764
1765 =item Thread Pitfall: Deadlocks
1766
1767 =item Queues: Passing Data Around
1768
1769 =back
1770
1771 =item Threads And Code
1772
1773 =over 4
1774
1775 =item Semaphores: Synchronizing Data Access
1776
1777 Basic semaphores, Advanced Semaphores
1778
1779 =item Attributes: Restricting Access To Subroutines
1780
1781 =item Subroutine Locks
1782
1783 =item Methods
1784
1785 =item Locking A Subroutine
1786
1787 =back
1788
1789 =item General Thread Utility Routines
1790
1791 =over 4
1792
1793 =item What Thread Am I In?
1794
1795 =item Thread IDs
1796
1797 =item Are These Threads The Same?
1798
1799 =item What Threads Are Running?
1800
1801 =back
1802
1803 =item A Complete Example
1804
1805 =item Conclusion
1806
1807 =item Bibliography
1808
1809 =over 4
1810
1811 =item Introductory Texts
1812
1813 =item OS-Related References
1814
1815 =item Other References
1816
1817 =back
1818
1819 =item Acknowledgements
1820
1821 =item AUTHOR
1822
1823 =item Copyrights
1824
1825 =back
1826
1827 =head2 perlport - Writing portable Perl
1828
1829 =over 4
1830
1831 =item DESCRIPTION
1832
1833 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
1834 portable
1835
1836 =item ISSUES
1837
1838 =over 4
1839
1840 =item Newlines
1841
1842 =item Numbers endianness and Width
1843
1844 =item Files and Filesystems
1845
1846 =item System Interaction
1847
1848 =item Interprocess Communication (IPC)
1849
1850 =item External Subroutines (XS)
1851
1852 =item Standard Modules
1853
1854 =item Time and Date
1855
1856 =item Character sets and character encoding
1857
1858 =item Internationalisation
1859
1860 =item System Resources
1861
1862 =item Security
1863
1864 =item Style
1865
1866 =back
1867
1868 =item CPAN Testers
1869
1870 Mailing list: cpan-testers@perl.org, Testing results:
1871 http://testers.cpan.org/
1872
1873 =item PLATFORMS
1874
1875 =over 4
1876
1877 =item Unix
1878
1879 =item DOS and Derivatives
1880
1881 =item S<Mac OS>
1882
1883 =item VMS
1884
1885 =item VOS
1886
1887 =item EBCDIC Platforms
1888
1889 =item Acorn RISC OS
1890
1891 =item Other perls
1892
1893 =back
1894
1895 =item FUNCTION IMPLEMENTATIONS
1896
1897 =over 4
1898
1899 =item Alphabetical Listing of Perl Functions
1900
1901 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
1902 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
1903 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
1904 LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork,
1905 getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME,
1906 getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr
1907 ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
1908 getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
1909 setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
1910 setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
1911 endprotoent, endservent, exit EXPR, exit, getsockopt SOCKET,LEVEL,OPTNAME,
1912 glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
1913 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
1914 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
1915 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
1916 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
1917 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
1918 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
1919 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
1920 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
1921 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
1922 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
1923 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
1924 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
1925 wait, waitpid PID,FLAGS
1926
1927 =back
1928
1929 =item CHANGES
1930
1931 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
1932 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
1933 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
1934 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
1935 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
1936 v1.30, 03 August 1998, v1.23, 10 July 1998
1937
1938 =item Supported Platforms
1939
1940 =item SEE ALSO
1941
1942 =item AUTHORS / CONTRIBUTORS
1943
1944 =item VERSION
1945
1946 =back
1947
1948 =head2 perllocale - Perl locale handling (internationalization and
1949 localization)
1950
1951 =over 4
1952
1953 =item DESCRIPTION
1954
1955 =item PREPARING TO USE LOCALES
1956
1957 =item USING LOCALES
1958
1959 =over 4
1960
1961 =item The use locale pragma
1962
1963 =item The setlocale function
1964
1965 =item Finding locales
1966
1967 =item LOCALE PROBLEMS
1968
1969 =item Temporarily fixing locale problems
1970
1971 =item Permanently fixing locale problems
1972
1973 =item Permanently fixing your system's locale configuration
1974
1975 =item Fixing system locale configuration
1976
1977 =item The localeconv function
1978
1979 =item I18N::Langinfo
1980
1981 =back
1982
1983 =item LOCALE CATEGORIES
1984
1985 =over 4
1986
1987 =item Category LC_COLLATE: Collation
1988
1989 =item Category LC_CTYPE: Character Types
1990
1991 =item Category LC_NUMERIC: Numeric Formatting
1992
1993 =item Category LC_MONETARY: Formatting of monetary amounts
1994
1995 =item LC_TIME
1996
1997 =item Other categories
1998
1999 =back
2000
2001 =item SECURITY
2002
2003 =item ENVIRONMENT
2004
2005 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2006 LC_NUMERIC, LC_TIME, LANG
2007
2008 =item NOTES
2009
2010 =over 4
2011
2012 =item Backward compatibility
2013
2014 =item I18N:Collate obsolete
2015
2016 =item Sort speed and memory use impacts
2017
2018 =item write() and LC_NUMERIC
2019
2020 =item Freely available locale definitions
2021
2022 =item I18n and l10n
2023
2024 =item An imperfect standard
2025
2026 =back
2027
2028 =item BUGS
2029
2030 =over 4
2031
2032 =item Broken systems
2033
2034 =back
2035
2036 =item SEE ALSO
2037
2038 =item HISTORY
2039
2040 =back
2041
2042 =head2 perlunicode - Unicode support in Perl
2043
2044 =over 4
2045
2046 =item DESCRIPTION
2047
2048 =over 4
2049
2050 =item Important Caveats
2051
2052 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2053 to enable UTF-8/UTF-EBCDIC in scripts
2054
2055 =item Byte and Character semantics
2056
2057 =item Effects of character semantics
2058
2059 =item Scripts
2060
2061 =item Blocks
2062
2063 =item Character encodings for input and output
2064
2065 =back
2066
2067 =item CAVEATS
2068
2069 =item UNICODE REGULAR EXPRESSION SUPPORT LEVEL
2070
2071 =item SEE ALSO
2072
2073 =back
2074
2075 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2076
2077 =over 4
2078
2079 =item DESCRIPTION
2080
2081 =item COMMON CHARACTER CODE SETS
2082
2083 =over 4
2084
2085 =item ASCII
2086
2087 =item ISO 8859
2088
2089 =item Latin 1 (ISO 8859-1)
2090
2091 =item EBCDIC
2092
2093 =item 13 variant characters
2094
2095 =item 0037
2096
2097 =item 1047
2098
2099 =item POSIX-BC
2100
2101 =item Unicode and UTF
2102
2103 =back
2104
2105 =item SINGLE OCTET TABLES
2106
2107 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2108
2109 =item IDENTIFYING CHARACTER CODE SETS
2110
2111 =item CONVERSIONS
2112
2113 =over 4
2114
2115 =item tr///
2116
2117 =item iconv
2118
2119 =item C RTL
2120
2121 =back
2122
2123 =item OPERATOR DIFFERENCES
2124
2125 =item FUNCTION DIFFERENCES
2126
2127 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2128
2129 =item REGULAR EXPRESSION DIFFERENCES
2130
2131 =item SOCKETS
2132
2133 =item SORTING
2134
2135 =over 4
2136
2137 =item Ignore ASCII vs. EBCDIC sort differences.
2138
2139 =item MONO CASE then sort data.
2140
2141 =item Convert, sort data, then re convert.
2142
2143 =item Perform sorting on one type of machine only.
2144
2145 =back
2146
2147 =item TRANSFORMATION FORMATS
2148
2149 =over 4
2150
2151 =item URL decoding and encoding
2152
2153 =item uu encoding and decoding
2154
2155 =item Quoted-Printable encoding and decoding
2156
2157 =item Caesarian ciphers
2158
2159 =back
2160
2161 =item Hashing order and checksums
2162
2163 =item I18N AND L10N
2164
2165 =item MULTI OCTET CHARACTER SETS
2166
2167 =item OS ISSUES
2168
2169 =over 4
2170
2171 =item OS/400
2172
2173 IFS access
2174
2175 =item OS/390, z/OS
2176
2177 chcp, dataset access, OS/390, z/OS iconv, locales
2178
2179 =item VM/ESA?
2180
2181 =item POSIX-BC?
2182
2183 =back
2184
2185 =item BUGS
2186
2187 =item SEE ALSO
2188
2189 =item REFERENCES
2190
2191 =item HISTORY
2192
2193 =item AUTHOR
2194
2195 =back
2196
2197 =head2 perlsec - Perl security
2198
2199 =over 4
2200
2201 =item DESCRIPTION
2202
2203 =over 4
2204
2205 =item Laundering and Detecting Tainted Data
2206
2207 =item Switches On the "#!" Line
2208
2209 =item Cleaning Up Your Path
2210
2211 =item Security Bugs
2212
2213 =item Protecting Your Programs
2214
2215 =back
2216
2217 =item SEE ALSO
2218
2219 =back
2220
2221 =head2 perlmod - Perl modules (packages and symbol tables)
2222
2223 =over 4
2224
2225 =item DESCRIPTION
2226
2227 =over 4
2228
2229 =item Packages
2230
2231 =item Symbol Tables
2232
2233 =item Package Constructors and Destructors
2234
2235 =item Perl Classes
2236
2237 =item Perl Modules
2238
2239 =item Making your module threadsafe
2240
2241 =back
2242
2243 =item SEE ALSO
2244
2245 =back
2246
2247 =head2 perlmodinstall - Installing CPAN Modules
2248
2249 =over 4
2250
2251 =item DESCRIPTION
2252
2253 =over 4
2254
2255 =item PREAMBLE
2256
2257 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2258 module (sometimes unnecessary), B<INSTALL> the module
2259
2260 =back
2261
2262 =item PORTABILITY
2263
2264 =item HEY
2265
2266 =item AUTHOR
2267
2268 =item COPYRIGHT
2269
2270 =back
2271
2272 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2273
2274 =over 4
2275
2276 =item DESCRIPTION
2277
2278 =item THE PERL MODULE LIBRARY
2279
2280 =over 4
2281
2282 =item Pragmatic Modules
2283
2284 attributes, attrs, autouse, base, blib, bytes, charnames, constant,
2285 diagnostics, fields, filetest, integer, less, locale, open, ops, overload,
2286 re, sigtrap, strict, subs, threads, utf8, vars, warnings,
2287 warnings::register
2288
2289 =item Standard Modules
2290
2291 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2292 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2293 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2294 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2295 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2296 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2297 Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
2298 Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env,
2299 Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant,
2300 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2301 ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
2302 ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker,
2303 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
2304 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
2305 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
2306 File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions,
2307 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2308 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2309 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate,
2310 I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3,
2311 Lingua::KO::Hangul::Util, Locale::Constants, Locale::Country,
2312 Locale::Currency, Locale::Language, Locale::Maketext,
2313 Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2314 Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
2315 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
2316 Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT,
2317 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2318 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2319 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2320 PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX,
2321 Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select,
2322 Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap,
2323 Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
2324 Socket, Storable, Switch, Symbol, Term::ANSIColor, Term::Cap,
2325 Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More,
2326 Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
2327 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array,
2328 Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash,
2329 Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
2330 Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
2331 User::pwent, Win32
2332
2333 =item Extension Modules
2334
2335 =back
2336
2337 =item CPAN
2338
2339 =over 4
2340
2341 =item Africa
2342
2343 =item Asia
2344
2345 =item Central America
2346
2347 =item Europe
2348
2349 =item North America
2350
2351 =item Oceania
2352
2353 =item South America
2354
2355 =back
2356
2357 =item Modules: Creation, Use, and Abuse
2358
2359 =over 4
2360
2361 =item Guidelines for Module Creation
2362
2363 Adding a Copyright Notice
2364
2365 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2366
2367 =item Guidelines for Reusing Application Code
2368
2369 =back
2370
2371 =item NOTE
2372
2373 =back
2374
2375 =head2 perlmodstyle - Perl module style guide
2376
2377 =over 4
2378
2379 =item INTRODUCTION
2380
2381 =item QUICK CHECKLIST
2382
2383 =over 4
2384
2385 =item Before you start
2386
2387 =item The API
2388
2389 =item Stability
2390
2391 =item Documentation
2392
2393 =item Release considerations
2394
2395 =back
2396
2397 =item BEFORE YOU START WRITING A MODULE
2398
2399 =over 4
2400
2401 =item Has it been done before?
2402
2403 =item Do one thing and do it well
2404
2405 =item What's in a name?
2406
2407 =back
2408
2409 =item DESIGNING AND WRITING YOUR MODULE
2410
2411 =over 4
2412
2413 =item To OO or not to OO?
2414
2415 =item Designing your API
2416
2417 Write simple routines to do simple things, Separate functionality from
2418 output, Provide sensible shortcuts and defaults, Naming conventions,
2419 Parameter passing
2420
2421 =item Strictness and warnings
2422
2423 =item Backwards compatibility
2424
2425 =item Error handling and messages
2426
2427 =back
2428
2429 =item DOCUMENTING YOUR MODULE
2430
2431 =over 4
2432
2433 =item POD
2434
2435 =item README, INSTALL, release notes, changelogs
2436
2437 =back
2438
2439 =item RELEASE CONSIDERATIONS
2440
2441 =over 4
2442
2443 =item Version numbering
2444
2445 =item Pre-requisites
2446
2447 =item Testing
2448
2449 =item Packaging
2450
2451 =item Licensing
2452
2453 =back
2454
2455 =item COMMON PITFALLS
2456
2457 =over 4
2458
2459 =item Reinventing the wheel
2460
2461 =item Trying to do too much
2462
2463 =item Inappropriate documentation
2464
2465 =back
2466
2467 =item SEE ALSO
2468
2469 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2470 http://pause.perl.org/, Any good book on software engineering
2471
2472 =item AUTHOR
2473
2474 =back
2475
2476 =head2 perlnewmod - preparing a new module for distribution
2477
2478 =over 4
2479
2480 =item DESCRIPTION
2481
2482 =over 4
2483
2484 =item Warning
2485
2486 =item What should I make into a module?
2487
2488 =item Step-by-step: Preparing the ground
2489
2490 Look around, Check it's new, Discuss the need, Choose a name, Check again
2491
2492 =item Step-by-step: Making the module
2493
2494 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2495 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2496 documentation|perlpod>, Write tests, Write the README
2497
2498 =item Step-by-step: Distributing your module
2499
2500 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2501 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2502
2503 =back
2504
2505 =item AUTHOR
2506
2507 =item SEE ALSO
2508
2509 =back
2510
2511 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.1 $, $Date:
2512 2001/09/20 03:03:00 $)
2513
2514 =over 4
2515
2516 =item DESCRIPTION
2517
2518 =over 4
2519
2520 =item What is Perl?
2521
2522 =item Who supports Perl?  Who develops it?  Why is it free?
2523
2524 =item Which version of Perl should I use?
2525
2526 =item What are perl4 and perl5?
2527
2528 =item What is perl6?
2529
2530 =item How stable is Perl?
2531
2532 =item Is Perl difficult to learn?
2533
2534 =item How does Perl compare with other languages like Java, Python, REXX,
2535 Scheme, or Tcl?
2536
2537 =item Can I do [task] in Perl?
2538
2539 =item When shouldn't I program in Perl?
2540
2541 =item What's the difference between "perl" and "Perl"?
2542
2543 =item Is it a Perl program or a Perl script?
2544
2545 =item What is a JAPH?
2546
2547 =item Where can I get a list of Larry Wall witticisms?
2548
2549 =item How can I convince my sysadmin/supervisor/employees to use version
2550 5/5.005/Perl instead of some other language?
2551
2552 =back
2553
2554 =item AUTHOR AND COPYRIGHT
2555
2556 =back
2557
2558 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.2 $,
2559 $Date: 2001/10/16 13:27:22 $)
2560
2561 =over 4
2562
2563 =item DESCRIPTION
2564
2565 =over 4
2566
2567 =item What machines support Perl?  Where do I get it?
2568
2569 =item How can I get a binary version of Perl?
2570
2571 =item I don't have a C compiler on my system.  How can I compile perl?
2572
2573 =item I copied the Perl binary from one machine to another, but scripts
2574 don't work.
2575
2576 =item I grabbed the sources and tried to compile but gdbm/dynamic
2577 loading/malloc/linking/... failed.  How do I make it work?
2578
2579 =item What modules and extensions are available for Perl?  What is CPAN?
2580 What does CPAN/src/... mean?
2581
2582 =item Is there an ISO or ANSI certified version of Perl?
2583
2584 =item Where can I get information on Perl?
2585
2586 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2587
2588 =item Where should I post source code?
2589
2590 =item Perl Books
2591
2592 References, Tutorials, Task-Oriented, Special Topics
2593
2594 =item Perl in Magazines
2595
2596 =item Perl on the Net: FTP and WWW Access
2597
2598 =item What mailing lists are there for Perl?
2599
2600 =item Archives of comp.lang.perl.misc
2601
2602 =item Where can I buy a commercial version of Perl?
2603
2604 =item Where do I send bug reports?
2605
2606 =item What is perl.com? Perl Mongers? pm.org? perl.org?
2607
2608 =back
2609
2610 =item AUTHOR AND COPYRIGHT
2611
2612 =back
2613
2614 =head2 perlfaq3 - Programming Tools ($Revision: 1.8 $, $Date: 2001/10/17
2615 14:14:20 $)
2616
2617 =over 4
2618
2619 =item DESCRIPTION
2620
2621 =over 4
2622
2623 =item How do I do (anything)?
2624
2625 =item How can I use Perl interactively?
2626
2627 =item Is there a Perl shell?
2628
2629 =item How do I debug my Perl programs?
2630
2631 =item How do I profile my Perl programs?
2632
2633 =item How do I cross-reference my Perl programs?
2634
2635 =item Is there a pretty-printer (formatter) for Perl?
2636
2637 =item Is there a ctags for Perl?
2638
2639 =item Is there an IDE or Windows Perl Editor?
2640
2641 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+,
2642 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2643 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2644
2645 =item Where can I get Perl macros for vi?
2646
2647 =item Where can I get perl-mode for emacs?
2648
2649 =item How can I use curses with Perl?
2650
2651 =item How can I use X or Tk with Perl?
2652
2653 =item How can I generate simple menus without using CGI or Tk?
2654
2655 =item What is undump?
2656
2657 =item How can I make my Perl program run faster?
2658
2659 =item How can I make my Perl program take less memory?
2660
2661 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
2662 stringification, Pass by reference, Tie large variables to disk
2663
2664 =item Is it unsafe to return a pointer to local data?
2665
2666 =item How can I free an array or hash so my program shrinks?
2667
2668 =item How can I make my CGI script more efficient?
2669
2670 =item How can I hide the source for my Perl program?
2671
2672 =item How can I compile my Perl program into byte code or C?
2673
2674 =item How can I compile Perl into Java?
2675
2676 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
2677
2678 =item Can I write useful Perl programs on the command line?
2679
2680 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
2681
2682 =item Where can I learn about CGI or Web programming in Perl?
2683
2684 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
2685
2686 =item I've read perlembed, perlguts, etc., but I can't embed perl in
2687 my C program; what am I doing wrong?
2688
2689 =item When I tried to run my script, I got this message. What does it
2690 mean?
2691
2692 =item What's MakeMaker?
2693
2694 =back
2695
2696 =item AUTHOR AND COPYRIGHT
2697
2698 =back
2699
2700 =head2 perlfaq4 - Data Manipulation ($Revision: 1.5 $, $Date: 2001/10/12
2701 15:20:13 $)
2702
2703 =over 4
2704
2705 =item DESCRIPTION
2706
2707 =item Data: Numbers
2708
2709 =over 4
2710
2711 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
2712 numbers I should be getting (eg, 19.95)?
2713
2714 =item Why isn't my octal data interpreted correctly?
2715
2716 =item Does Perl have a round() function?  What about ceil() and floor()?
2717 Trig functions?
2718
2719 =item How do I convert bits into ints?
2720
2721 =item Why doesn't & work the way I want it to?
2722
2723 =item How do I multiply matrices?
2724
2725 =item How do I perform an operation on a series of integers?
2726
2727 =item How can I output Roman numerals?
2728
2729 =item Why aren't my random numbers random?
2730
2731 =back
2732
2733 =item Data: Dates
2734
2735 =over 4
2736
2737 =item How do I find the week-of-the-year/day-of-the-year?
2738
2739 =item How do I find the current century or millennium?
2740
2741 =item How can I compare two dates and find the difference?
2742
2743 =item How can I take a string and turn it into epoch seconds?
2744
2745 =item How can I find the Julian Day?
2746
2747 =item How do I find yesterday's date?
2748
2749 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
2750
2751 =back
2752
2753 =item Data: Strings
2754
2755 =over 4
2756
2757 =item How do I validate input?
2758
2759 =item How do I unescape a string?
2760
2761 =item How do I remove consecutive pairs of characters?
2762
2763 =item How do I expand function calls in a string?
2764
2765 =item How do I find matching/nesting anything?
2766
2767 =item How do I reverse a string?
2768
2769 =item How do I expand tabs in a string?
2770
2771 =item How do I reformat a paragraph?
2772
2773 =item How can I access/change the first N letters of a string?
2774
2775 =item How do I change the Nth occurrence of something?
2776
2777 =item How can I count the number of occurrences of a substring within a
2778 string?
2779
2780 =item How do I capitalize all the words on one line?
2781
2782 =item How can I split a [character] delimited string except when inside
2783 [character]? (Comma-separated files)
2784
2785 =item How do I strip blank space from the beginning/end of a string?
2786
2787 =item How do I pad a string with blanks or pad a number with zeroes?
2788
2789 =item How do I extract selected columns from a string?
2790
2791 =item How do I find the soundex value of a string?
2792
2793 =item How can I expand variables in text strings?
2794
2795 =item What's wrong with always quoting "$vars"?
2796
2797 =item Why don't my <<HERE documents work?
2798
2799 1. There must be no space after the << part, 2. There (probably) should be
2800 a semicolon at the end, 3. You can't (easily) have any space in front of
2801 the tag
2802
2803 =back
2804
2805 =item Data: Arrays
2806
2807 =over 4
2808
2809 =item What is the difference between a list and an array?
2810
2811 =item What is the difference between $array[1] and @array[1]?
2812
2813 =item How can I remove duplicate elements from a list or array?
2814
2815 a), b), c), d), e)
2816
2817 =item How can I tell whether a certain element is contained in a list or
2818 array?
2819
2820 =item How do I compute the difference of two arrays?  How do I compute the
2821 intersection of two arrays?
2822
2823 =item How do I test whether two arrays or hashes are equal?
2824
2825 =item How do I find the first array element for which a condition is true?
2826
2827 =item How do I handle linked lists?
2828
2829 =item How do I handle circular lists?
2830
2831 =item How do I shuffle an array randomly?
2832
2833 =item How do I process/modify each element of an array?
2834
2835 =item How do I select a random element from an array?
2836
2837 =item How do I permute N elements of a list?
2838
2839 =item How do I sort an array by (anything)?
2840
2841 =item How do I manipulate arrays of bits?
2842
2843 =item Why does defined() return true on empty arrays and hashes?
2844
2845 =back
2846
2847 =item Data: Hashes (Associative Arrays)
2848
2849 =over 4
2850
2851 =item How do I process an entire hash?
2852
2853 =item What happens if I add or remove keys from a hash while iterating over
2854 it?
2855
2856 =item How do I look up a hash element by value?
2857
2858 =item How can I know how many entries are in a hash?
2859
2860 =item How do I sort a hash (optionally by value instead of key)?
2861
2862 =item How can I always keep my hash sorted?
2863
2864 =item What's the difference between "delete" and "undef" with hashes?
2865
2866 =item Why don't my tied hashes make the defined/exists distinction?
2867
2868 =item How do I reset an each() operation part-way through?
2869
2870 =item How can I get the unique keys from two hashes?
2871
2872 =item How can I store a multidimensional array in a DBM file?
2873
2874 =item How can I make my hash remember the order I put elements into it?
2875
2876 =item Why does passing a subroutine an undefined element in a hash create
2877 it?
2878
2879 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
2880 array of hashes or arrays?
2881
2882 =item How can I use a reference as a hash key?
2883
2884 =back
2885
2886 =item Data: Misc
2887
2888 =over 4
2889
2890 =item How do I handle binary data correctly?
2891
2892 =item How do I determine whether a scalar is a number/whole/integer/float?
2893
2894 =item How do I keep persistent data across program calls?
2895
2896 =item How do I print out or copy a recursive data structure?
2897
2898 =item How do I define methods for every class/object?
2899
2900 =item How do I verify a credit card checksum?
2901
2902 =item How do I pack arrays of doubles or floats for XS code?
2903
2904 =back
2905
2906 =item AUTHOR AND COPYRIGHT
2907
2908 =back
2909
2910 =head2 perlfaq5 - Files and Formats ($Revision: 1.3 $, $Date: 2001/10/16
2911 13:27:22 $)
2912
2913 =over 4
2914
2915 =item DESCRIPTION
2916
2917 =over 4
2918
2919 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
2920
2921 =item How do I change one line in a file/delete a line in a file/insert a
2922 line in the middle of a file/append to the beginning of a file?
2923
2924 =item How do I count the number of lines in a file?
2925
2926 =item How do I make a temporary file name?
2927
2928 =item How can I manipulate fixed-record-length files?
2929
2930 =item How can I make a filehandle local to a subroutine?  How do I pass
2931 filehandles between subroutines?  How do I make an array of filehandles?
2932
2933 =item How can I use a filehandle indirectly?
2934
2935 =item How can I set up a footer format to be used with write()?
2936
2937 =item How can I write() into a string?
2938
2939 =item How can I output my numbers with commas added?
2940
2941 =item How can I translate tildes (~) in a filename?
2942
2943 =item How come when I open a file read-write it wipes it out?
2944
2945 =item Why do I sometimes get an "Argument list too long" when I use <*>?
2946
2947 =item Is there a leak/bug in glob()?
2948
2949 =item How can I open a file with a leading ">" or trailing blanks?
2950
2951 =item How can I reliably rename a file?
2952
2953 =item How can I lock a file?
2954
2955 =item Why can't I just open(FH, ">file.lock")?
2956
2957 =item I still don't get locking.  I just want to increment the number in
2958 the file.  How can I do this?
2959
2960 =item All I want to do is append a small amount of text to the end of a
2961 file.  Do I still have to use locking?
2962
2963 =item How do I randomly update a binary file?
2964
2965 =item How do I get a file's timestamp in perl?
2966
2967 =item How do I set a file's timestamp in perl?
2968
2969 =item How do I print to more than one file at once?
2970
2971 =item How can I read in an entire file all at once?
2972
2973 =item How can I read in a file by paragraphs?
2974
2975 =item How can I read a single character from a file?  From the keyboard?
2976
2977 =item How can I tell whether there's a character waiting on a filehandle?
2978
2979 =item How do I do a C<tail -f> in perl?
2980
2981 =item How do I dup() a filehandle in Perl?
2982
2983 =item How do I close a file descriptor by number?
2984
2985 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
2986 `C:\temp\foo.exe` work?
2987
2988 =item Why doesn't glob("*.*") get all the files?
2989
2990 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
2991 protected files?  Isn't this a bug in Perl?
2992
2993 =item How do I select a random line from a file?
2994
2995 =item Why do I get weird spaces when I print an array of lines?
2996
2997 =back
2998
2999 =item AUTHOR AND COPYRIGHT
3000
3001 =back
3002
3003 =head2 perlfaq6 - Regexes ($Revision: 1.3 $, $Date: 2001/10/16 13:27:22 $)
3004
3005 =over 4
3006
3007 =item DESCRIPTION
3008
3009 =over 4
3010
3011 =item How can I hope to use regular expressions without creating illegible
3012 and unmaintainable code?
3013
3014 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3015
3016 =item I'm having trouble matching over more than one line.  What's wrong?
3017
3018 =item How can I pull out lines between two patterns that are themselves on
3019 different lines?
3020
3021 =item I put a regular expression into $/ but it didn't work. What's wrong?
3022
3023 =item How do I substitute case insensitively on the LHS while preserving
3024 case on the RHS?
3025
3026 =item How can I make C<\w> match national character sets?
3027
3028 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3029
3030 =item How can I quote a variable to use in a regex?
3031
3032 =item What is C</o> really for?
3033
3034 =item How do I use a regular expression to strip C style comments from a
3035 file?
3036
3037 =item Can I use Perl regular expressions to match balanced text?
3038
3039 =item What does it mean that regexes are greedy?  How can I get around it?
3040
3041 =item How do I process each word on each line?
3042
3043 =item How can I print out a word-frequency or line-frequency summary?
3044
3045 =item How can I do approximate matching?
3046
3047 =item How do I efficiently match many regular expressions at once?
3048
3049 =item Why don't word-boundary searches with C<\b> work for me?
3050
3051 =item Why does using $&, $`, or $' slow my program down?
3052
3053 =item What good is C<\G> in a regular expression?
3054
3055 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3056
3057 =item What's wrong with using grep or map in a void context?
3058
3059 =item How can I match strings with multibyte characters?
3060
3061 =item How do I match a pattern that is supplied by the user?
3062
3063 =back
3064
3065 =item AUTHOR AND COPYRIGHT
3066
3067 =back
3068
3069 =head2 perlfaq7 - Perl Language Issues ($Revision: 1.2 $, $Date: 2001/10/16
3070 13:27:22 $)
3071
3072 =over 4
3073
3074 =item DESCRIPTION
3075
3076 =over 4
3077
3078 =item Can I get a BNF/yacc/RE for the Perl language?
3079
3080 =item What are all these $@%&* punctuation signs, and how do I know when to
3081 use them?
3082
3083 =item Do I always/never have to quote my strings or use semicolons and
3084 commas?
3085
3086 =item How do I skip some return values?
3087
3088 =item How do I temporarily block warnings?
3089
3090 =item What's an extension?
3091
3092 =item Why do Perl operators have different precedence than C operators?
3093
3094 =item How do I declare/create a structure?
3095
3096 =item How do I create a module?
3097
3098 =item How do I create a class?
3099
3100 =item How can I tell if a variable is tainted?
3101
3102 =item What's a closure?
3103
3104 =item What is variable suicide and how can I prevent it?
3105
3106 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3107 Regex}?
3108
3109 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3110 Passing Methods
3111
3112 =item How do I create a static variable?
3113
3114 =item What's the difference between dynamic and lexical (static) scoping?
3115 Between local() and my()?
3116
3117 =item How can I access a dynamic variable while a similarly named lexical
3118 is in scope?
3119
3120 =item What's the difference between deep and shallow binding?
3121
3122 =item Why doesn't "my($foo) = <FILE>;" work right?
3123
3124 =item How do I redefine a builtin function, operator, or method?
3125
3126 =item What's the difference between calling a function as &foo and foo()?
3127
3128 =item How do I create a switch or case statement?
3129
3130 =item How can I catch accesses to undefined variables/functions/methods?
3131
3132 =item Why can't a method included in this same file be found?
3133
3134 =item How can I find out my current package?
3135
3136 =item How can I comment out a large block of perl code?
3137
3138 =item How do I clear a package?
3139
3140 =item How can I use a variable as a variable name?
3141
3142 =back
3143
3144 =item AUTHOR AND COPYRIGHT
3145
3146 =back
3147
3148 =head2 perlfaq8 - System Interaction ($Revision: 1.2 $, $Date: 2001/10/16
3149 13:27:22 $)
3150
3151 =over 4
3152
3153 =item DESCRIPTION
3154
3155 =over 4
3156
3157 =item How do I find out which operating system I'm running under?
3158
3159 =item How come exec() doesn't return?
3160
3161 =item How do I do fancy stuff with the keyboard/screen/mouse?
3162
3163 Keyboard, Screen, Mouse
3164
3165 =item How do I print something out in color?
3166
3167 =item How do I read just one key without waiting for a return key?
3168
3169 =item How do I check whether input is ready on the keyboard?
3170
3171 =item How do I clear the screen?
3172
3173 =item How do I get the screen size?
3174
3175 =item How do I ask the user for a password?
3176
3177 =item How do I read and write the serial port?
3178
3179 lockfiles, open mode, end of line, flushing output, non-blocking input
3180
3181 =item How do I decode encrypted password files?
3182
3183 =item How do I start a process in the background?
3184
3185 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3186
3187 =item How do I trap control characters/signals?
3188
3189 =item How do I modify the shadow password file on a Unix system?
3190
3191 =item How do I set the time and date?
3192
3193 =item How can I sleep() or alarm() for under a second?
3194
3195 =item How can I measure time under a second?
3196
3197 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3198
3199 =item Why doesn't my sockets program work under System V (Solaris)?  What
3200 does the error message "Protocol not supported" mean?
3201
3202 =item How can I call my system's unique C functions from Perl?
3203
3204 =item Where do I get the include files to do ioctl() or syscall()?
3205
3206 =item Why do setuid perl scripts complain about kernel problems?
3207
3208 =item How can I open a pipe both to and from a command?
3209
3210 =item Why can't I get the output of a command with system()?
3211
3212 =item How can I capture STDERR from an external command?
3213
3214 =item Why doesn't open() return an error when a pipe open fails?
3215
3216 =item What's wrong with using backticks in a void context?
3217
3218 =item How can I call backticks without shell processing?
3219
3220 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3221 ^Z on MS-DOS)?
3222
3223 =item How can I convert my shell script to perl?
3224
3225 =item Can I use perl to run a telnet or ftp session?
3226
3227 =item How can I write expect in Perl?
3228
3229 =item Is there a way to hide perl's command line from programs such as
3230 "ps"?
3231
3232 =item I {changed directory, modified my environment} in a perl script.  How
3233 come the change disappeared when I exited the script?  How do I get my
3234 changes to be visible?
3235
3236 Unix
3237
3238 =item How do I close a process's filehandle without waiting for it to
3239 complete?
3240
3241 =item How do I fork a daemon process?
3242
3243 =item How do I find out if I'm running interactively or not?
3244
3245 =item How do I timeout a slow event?
3246
3247 =item How do I set CPU limits?
3248
3249 =item How do I avoid zombies on a Unix system?
3250
3251 =item How do I use an SQL database?
3252
3253 =item How do I make a system() exit on control-C?
3254
3255 =item How do I open a file without blocking?
3256
3257 =item How do I install a module from CPAN?
3258
3259 =item What's the difference between require and use?
3260
3261 =item How do I keep my own module/library directory?
3262
3263 =item How do I add the directory my program lives in to the module/library
3264 search path?
3265
3266 =item How do I add a directory to my include path at runtime?
3267
3268 =item What is socket.ph and where do I get it?
3269
3270 =back
3271
3272 =item AUTHOR AND COPYRIGHT
3273
3274 =back
3275
3276 =head2 perlfaq9 - Networking ($Revision: 1.3 $, $Date: 2001/10/16 13:27:22
3277 $)
3278
3279 =over 4
3280
3281 =item DESCRIPTION
3282
3283 =over 4
3284
3285 =item What is the correct form of response from a CGI script?
3286
3287 =item My CGI script runs from the command line but not the browser.  (500
3288 Server Error)
3289
3290 =item How can I get better error messages from a CGI program?
3291
3292 =item How do I remove HTML from a string?
3293
3294 =item How do I extract URLs?
3295
3296 =item How do I download a file from the user's machine?  How do I open a
3297 file on another machine?
3298
3299 =item How do I make a pop-up menu in HTML?
3300
3301 =item How do I fetch an HTML file?
3302
3303 =item How do I automate an HTML form submission?
3304
3305 =item How do I decode or create those %-encodings on the web?
3306
3307 =item How do I redirect to another page?
3308
3309 =item How do I put a password on my web pages?
3310
3311 =item How do I edit my .htpasswd and .htgroup files with Perl?
3312
3313 =item How do I make sure users can't enter values into a form that cause my
3314 CGI script to do bad things?
3315
3316 =item How do I parse a mail header?
3317
3318 =item How do I decode a CGI form?
3319
3320 =item How do I check a valid mail address?
3321
3322 =item How do I decode a MIME/BASE64 string?
3323
3324 =item How do I return the user's mail address?
3325
3326 =item How do I send mail?
3327
3328 =item How do I use MIME to make an attachment to a mail message?
3329
3330 =item How do I read mail?
3331
3332 =item How do I find out my hostname/domainname/IP address?
3333
3334 =item How do I fetch a news article or the active newsgroups?
3335
3336 =item How do I fetch/put an FTP file?
3337
3338 =item How can I do RPC in Perl?
3339
3340 =back
3341
3342 =item AUTHOR AND COPYRIGHT
3343
3344 =back
3345
3346 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3347
3348 =over 4
3349
3350 =item DESCRIPTION
3351
3352 =over 4
3353
3354 =item Layout
3355
3356 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3357
3358 =back
3359
3360 =item Using The Back Ends
3361
3362 =over 4
3363
3364 =item The Cross Referencing Back End
3365
3366 i, &, s, r
3367
3368 =item The Decompiling Back End
3369
3370 =item The Lint Back End
3371
3372 =item The Simple C Back End
3373
3374 =item The Bytecode Back End
3375
3376 =item The Optimized C Back End
3377
3378 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3379 B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj,
3380 B::Stash, B::Terse, B::Xref
3381
3382 =back
3383
3384 =item KNOWN PROBLEMS
3385
3386 =item AUTHOR
3387
3388 =back
3389
3390 =head2 perlembed - how to embed perl in your C program
3391
3392 =over 4
3393
3394 =item DESCRIPTION
3395
3396 =over 4
3397
3398 =item PREAMBLE
3399
3400 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3401 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3402
3403 =item ROADMAP
3404
3405 =item Compiling your C program
3406
3407 =item Adding a Perl interpreter to your C program
3408
3409 =item Calling a Perl subroutine from your C program
3410
3411 =item Evaluating a Perl statement from your C program
3412
3413 =item Performing Perl pattern matches and substitutions from your C program
3414
3415 =item Fiddling with the Perl stack from your C program
3416
3417 =item Maintaining a persistent interpreter
3418
3419 =item Execution of END blocks
3420
3421 =item Maintaining multiple interpreter instances
3422
3423 =item Using Perl modules, which themselves use C libraries, from your C
3424 program
3425
3426 =back
3427
3428 =item Embedding Perl under Win32
3429
3430 =item MORAL
3431
3432 =item AUTHOR
3433
3434 =item COPYRIGHT
3435
3436 =back
3437
3438 =head2 perldebguts - Guts of Perl debugging
3439
3440 =over 4
3441
3442 =item DESCRIPTION
3443
3444 =item Debugger Internals
3445
3446 =over 4
3447
3448 =item Writing Your Own Debugger
3449
3450 =back
3451
3452 =item Frame Listing Output Examples
3453
3454 =item Debugging regular expressions
3455
3456 =over 4
3457
3458 =item Compile-time output
3459
3460 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3461 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3462 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3463 C<anchored(TYPE)>
3464
3465 =item Types of nodes
3466
3467 =item Run-time output
3468
3469 =back
3470
3471 =item Debugging Perl memory usage
3472
3473 =over 4
3474
3475 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3476
3477 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3478 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3479 6144>
3480
3481 =item Example of using B<-DL> switch
3482
3483 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3484
3485 =item B<-DL> details
3486
3487 C<!!!>, C<!!>, C<!>
3488
3489 =item Limitations of B<-DL> statistics
3490
3491 =back
3492
3493 =item SEE ALSO
3494
3495 =back
3496
3497 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3498
3499 =over 4
3500
3501 =item DESCRIPTION
3502
3503 =item SPECIAL NOTES
3504
3505 =over 4
3506
3507 =item make
3508
3509 =item Version caveat
3510
3511 =item Dynamic Loading versus Static Loading
3512
3513 =back
3514
3515 =item TUTORIAL
3516
3517 =over 4
3518
3519 =item EXAMPLE 1
3520
3521 =item EXAMPLE 2
3522
3523 =item What has gone on?
3524
3525 =item Writing good test scripts
3526
3527 =item EXAMPLE 3
3528
3529 =item What's new here?
3530
3531 =item Input and Output Parameters
3532
3533 =item The XSUBPP Program
3534
3535 =item The TYPEMAP file
3536
3537 =item Warning about Output Arguments
3538
3539 =item EXAMPLE 4
3540
3541 =item What has happened here?
3542
3543 =item Anatomy of .xs file
3544
3545 =item Getting the fat out of XSUBs
3546
3547 =item More about XSUB arguments
3548
3549 =item The Argument Stack
3550
3551 =item Extending your Extension
3552
3553 =item Documenting your Extension
3554
3555 =item Installing your Extension
3556
3557 =item EXAMPLE 5
3558
3559 =item New Things in this Example
3560
3561 =item EXAMPLE 6
3562
3563 =item New Things in this Example
3564
3565 =item EXAMPLE 7 (Coming Soon)
3566
3567 =item EXAMPLE 8 (Coming Soon)
3568
3569 =item EXAMPLE 9 (Coming Soon)
3570
3571 =item Troubleshooting these Examples
3572
3573 =back
3574
3575 =item See also
3576
3577 =item Author
3578
3579 =over 4
3580
3581 =item Last Changed
3582
3583 =back
3584
3585 =back
3586
3587 =head2 perlxs - XS language reference manual
3588
3589 =over 4
3590
3591 =item DESCRIPTION
3592
3593 =over 4
3594
3595 =item Introduction
3596
3597 =item On The Road
3598
3599 =item The Anatomy of an XSUB
3600
3601 =item The Argument Stack
3602
3603 =item The RETVAL Variable
3604
3605 =item The MODULE Keyword
3606
3607 =item The PACKAGE Keyword
3608
3609 =item The PREFIX Keyword
3610
3611 =item The OUTPUT: Keyword
3612
3613 =item The NO_OUTPUT Keyword
3614
3615 =item The CODE: Keyword
3616
3617 =item The INIT: Keyword
3618
3619 =item The NO_INIT Keyword
3620
3621 =item Initializing Function Parameters
3622
3623 =item Default Parameter Values
3624
3625 =item The PREINIT: Keyword
3626
3627 =item The SCOPE: Keyword
3628
3629 =item The INPUT: Keyword
3630
3631 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3632
3633 =item Variable-length Parameter Lists
3634
3635 =item The C_ARGS: Keyword
3636
3637 =item The PPCODE: Keyword
3638
3639 =item Returning Undef And Empty Lists
3640
3641 =item The REQUIRE: Keyword
3642
3643 =item The CLEANUP: Keyword
3644
3645 =item The POSTCALL: Keyword
3646
3647 =item The BOOT: Keyword
3648
3649 =item The VERSIONCHECK: Keyword
3650
3651 =item The PROTOTYPES: Keyword
3652
3653 =item The PROTOTYPE: Keyword
3654
3655 =item The ALIAS: Keyword
3656
3657 =item The INTERFACE: Keyword
3658
3659 =item The INTERFACE_MACRO: Keyword
3660
3661 =item The INCLUDE: Keyword
3662
3663 =item The CASE: Keyword
3664
3665 =item The & Unary Operator
3666
3667 =item Inserting POD, Comments and C Preprocessor Directives
3668
3669 =item Using XS With C++
3670
3671 =item Interface Strategy
3672
3673 =item Perl Objects And C Structures
3674
3675 =item The Typemap
3676
3677 =back
3678
3679 =item EXAMPLES
3680
3681 =item XS VERSION
3682
3683 =item AUTHOR
3684
3685 =back
3686
3687 =head2 perlclib - Internal replacements for standard C library functions
3688
3689 =over 4
3690
3691 =item DESCRIPTION
3692
3693 =over 4
3694
3695 =item Conventions
3696
3697 C<t>, C<p>, C<n>, C<s>
3698
3699 =item File Operations
3700
3701 =item File Input and Output
3702
3703 =item File Positioning
3704
3705 =item Memory Management and String Handling
3706
3707 =item Character Class Tests
3708
3709 =item F<stdlib.h> functions
3710
3711 =item Miscellaneous functions
3712
3713 =back
3714
3715 =item SEE ALSO
3716
3717 =back
3718
3719 =head2 perlguts - Introduction to the Perl API
3720
3721 =over 4
3722
3723 =item DESCRIPTION
3724
3725 =item Variables
3726
3727 =over 4
3728
3729 =item Datatypes
3730
3731 =item What is an "IV"?
3732
3733 =item Working with SVs
3734
3735 =item Offsets
3736
3737 =item What's Really Stored in an SV?
3738
3739 =item Working with AVs
3740
3741 =item Working with HVs
3742
3743 =item Hash API Extensions
3744
3745 =item References
3746
3747 =item Blessed References and Class Objects
3748
3749 =item Creating New Variables
3750
3751 =item Reference Counts and Mortality
3752
3753 =item Stashes and Globs
3754
3755 =item Double-Typed SVs
3756
3757 =item Magic Variables
3758
3759 =item Assigning Magic
3760
3761 =item Magic Virtual Tables
3762
3763 =item Finding Magic
3764
3765 =item Understanding the Magic of Tied Hashes and Arrays
3766
3767 =item Localizing changes
3768
3769 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
3770 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
3771 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
3772 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
3773 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
3774 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
3775 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
3776 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
3777 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
3778 save_hptr(HV **hptr)>
3779
3780 =back
3781
3782 =item Subroutines
3783
3784 =over 4
3785
3786 =item XSUBs and the Argument Stack
3787
3788 =item Calling Perl Routines from within C Programs
3789
3790 =item Memory Allocation
3791
3792 =item PerlIO
3793
3794 =item Putting a C value on Perl stack
3795
3796 =item Scratchpads
3797
3798 =item Scratchpads and recursion
3799
3800 =back
3801
3802 =item Compiled code
3803
3804 =over 4
3805
3806 =item Code tree
3807
3808 =item Examining the tree
3809
3810 =item Compile pass 1: check routines
3811
3812 =item Compile pass 1a: constant folding
3813
3814 =item Compile pass 2: context propagation
3815
3816 =item Compile pass 3: peephole optimization
3817
3818 =item Pluggable runops
3819
3820 =back
3821
3822 =item Examining internal data structures with the C<dump> functions
3823
3824 =item How multiple interpreters and concurrency are supported
3825
3826 =over 4
3827
3828 =item Background and PERL_IMPLICIT_CONTEXT
3829
3830 =item So what happened to dTHR?
3831
3832 =item How do I use all this in extensions?
3833
3834 =item Should I do anything special if I call perl from multiple threads?
3835
3836 =item Future Plans and PERL_IMPLICIT_SYS
3837
3838 =back
3839
3840 =item Internal Functions
3841
3842 A, p, d, s, n, r, f, M, o, j, x
3843
3844 =over 4
3845
3846 =item Formatted Printing of IVs, UVs, and NVs
3847
3848 =item Pointer-To-Integer and Integer-To-Pointer
3849
3850 =item Source Documentation
3851
3852 =back
3853
3854 =item Unicode Support
3855
3856 =over 4
3857
3858 =item What B<is> Unicode, anyway?
3859
3860 =item How can I recognise a UTF8 string?
3861
3862 =item How does UTF8 represent Unicode characters?
3863
3864 =item How does Perl store UTF8 strings?
3865
3866 =item How do I convert a string to UTF8?
3867
3868 =item Is there anything else I need to know?
3869
3870 =back
3871
3872 =item Custom Operators
3873
3874 =item AUTHORS
3875
3876 =item SEE ALSO
3877
3878 =back
3879
3880 =head2 perlcall - Perl calling conventions from C
3881
3882 =over 4
3883
3884 =item DESCRIPTION
3885
3886 An Error Handler, An Event Driven Program
3887
3888 =item THE CALL_ FUNCTIONS
3889
3890 call_sv, call_pv, call_method, call_argv
3891
3892 =item FLAG VALUES
3893
3894 =over 4
3895
3896 =item  G_VOID
3897
3898 =item  G_SCALAR
3899
3900 =item G_ARRAY
3901
3902 =item G_DISCARD
3903
3904 =item G_NOARGS
3905
3906 =item G_EVAL
3907
3908 =item G_KEEPERR
3909
3910 =item Determining the Context
3911
3912 =back
3913
3914 =item KNOWN PROBLEMS
3915
3916 =item EXAMPLES
3917
3918 =over 4
3919
3920 =item No Parameters, Nothing returned
3921
3922 =item Passing Parameters
3923
3924 =item Returning a Scalar
3925
3926 =item Returning a list of values
3927
3928 =item Returning a list in a scalar context
3929
3930 =item Returning Data from Perl via the parameter list
3931
3932 =item Using G_EVAL
3933
3934 =item Using G_KEEPERR
3935
3936 =item Using call_sv
3937
3938 =item Using call_argv
3939
3940 =item Using call_method
3941
3942 =item Using GIMME_V
3943
3944 =item Using Perl to dispose of temporaries
3945
3946 =item Strategies for storing Callback Context Information
3947
3948 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
3949 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
3950 callback
3951
3952 =item Alternate Stack Manipulation
3953
3954 =item Creating and calling an anonymous subroutine in C
3955
3956 =back
3957
3958 =item SEE ALSO
3959
3960 =item AUTHOR
3961
3962 =item DATE
3963
3964 =back
3965
3966 =head2 perlutil - utilities packaged with the Perl distribution
3967
3968 =over 4
3969
3970 =item DESCRIPTION
3971
3972 =over 4
3973
3974 =item DOCUMENTATION
3975
3976 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3977 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3978 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3979 L<roffitall|roffitall>
3980
3981 =item CONVERTORS
3982
3983 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3984
3985 =item Administration
3986
3987 L<libnetcfg|libnetcfg>
3988
3989 =item Development
3990
3991 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3992 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3993
3994 =item SEE ALSO
3995
3996 =back
3997
3998 =back
3999
4000 =head2 perlfilter - Source Filters
4001
4002 =over 4
4003
4004 =item DESCRIPTION
4005
4006 =item CONCEPTS
4007
4008 =item USING FILTERS
4009
4010 =item WRITING A SOURCE FILTER
4011
4012 =item WRITING A SOURCE FILTER IN C
4013
4014 B<Decryption Filters>
4015
4016 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4017
4018 =item WRITING A SOURCE FILTER IN PERL
4019
4020 =item USING CONTEXT: THE DEBUG FILTER
4021
4022 =item CONCLUSION
4023
4024 =item REQUIREMENTS
4025
4026 =item AUTHOR
4027
4028 =item Copyrights
4029
4030 =back
4031
4032 =head2 perldbmfilter - Perl DBM Filters
4033
4034 =over 4
4035
4036 =item SYNOPSIS
4037
4038 =item DESCRIPTION
4039
4040 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4041 B<filter_fetch_value>
4042
4043 =over 4
4044
4045 =item The Filter
4046
4047 =item An Example -- the NULL termination problem.
4048
4049 =item Another Example -- Key is a C int.
4050
4051 =back
4052
4053 =item SEE ALSO
4054
4055 =item AUTHOR
4056
4057 =back
4058
4059 =head2 perlapi - autogenerated documentation for the perl public API
4060
4061 =over 4
4062
4063 =item DESCRIPTION
4064
4065 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4066 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4067 ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv,
4068 call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK,
4069 dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND,
4070 fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv,
4071 get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number,
4072 grok_numeric_radix, grok_oct, GvSV, gv_fetchmeth, gv_fetchmethod,
4073 gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
4074 G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
4075 HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete,
4076 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4077 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4078 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
4079 isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
4080 ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy,
4081 mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV,
4082 Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, newSV, NEWSV, newSViv,
4083 newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
4084 newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv,
4085 ORIGMARK, perl_alloc, perl_clone, perl_construct, perl_destruct, perl_free,
4086 perl_parse, perl_run, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef,
4087 PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK,
4088 PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv, RETVAL,
4089 Safefree, savepv, savepvn, SAVETMPS, scan_bin, scan_hex, scan_oct,
4090 sharedsv_find, sharedsv_init, sharedsv_lock, sharedsv_new,
4091 sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock, sortsv, SP,
4092 SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE,
4093 StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp,
4094 SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV,
4095 SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp,
4096 SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK,
4097 SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4098 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4099 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4100 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4101 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetMagicSV,
4102 SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
4103 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV,
4104 SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE,
4105 SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, sv_2cv,
4106 sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4107 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4108 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4109 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4110 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec,
4111 sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
4112 sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
4113 sv_len_utf8, sv_magic, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
4114 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
4115 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
4116 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
4117 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
4118 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4119 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4120 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4121 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
4122 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
4123 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
4124 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER,
4125 toUPPER, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4126 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4127 uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN,
4128 XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV,
4129 XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV,
4130 XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
4131
4132 =item AUTHORS
4133
4134 =item SEE ALSO
4135
4136 =back
4137
4138 =head2 perlintern - autogenerated documentation of purely B<internal>
4139                  Perl functions
4140
4141 =over 4
4142
4143 =item DESCRIPTION
4144
4145 djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn,
4146 PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena,
4147 sv_clean_all, sv_clean_objs, sv_free_arenas
4148
4149 =item AUTHORS
4150
4151 =item SEE ALSO
4152
4153 =back
4154
4155 =head2 perliol - C API for Perl's implementation of IO in Layers.
4156
4157 =over 4
4158
4159 =item SYNOPSIS
4160
4161 =item DESCRIPTION
4162
4163 =over 4
4164
4165 =item History and Background
4166
4167 =item Layers vs Disciplines
4168
4169 =item Data Structures
4170
4171 1. The functions and attributes of the "layer class", 2. The per-instance
4172 data for a particular handle
4173
4174 =item Functions and Attributes
4175
4176 =item Per-instance Data
4177
4178 =item Layers in action.
4179
4180 =item Per-instance flag bits
4181
4182 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4183 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4184 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4185 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4186
4187 =item Methods in Detail
4188
4189  IV             (*Pushed)(PerlIO *f,const char *mode, SV *arg);,  IV
4190     (*Popped)(PerlIO *f);,  PerlIO *        (*Open)(...);, SV *
4191 (*Getarg)(PerlIO *f);, IV       (*Fileno)(PerlIO *f);,  SSize_t
4192 (*Read)(PerlIO *f, void *vbuf, Size_t count);,  SSize_t (*Unread)(PerlIO
4193 *f, const void *vbuf, Size_t count);,  SSize_t (*Write)(PerlIO *f, const
4194 void *vbuf, Size_t count);,  IV               (*Seek)(PerlIO *f, Off_t
4195 offset, int whence);,  Off_t           (*Tell)(PerlIO *f);,  IV
4196    (*Close)(PerlIO *f);,  IV               (*Flush)(PerlIO *f);,  IV
4197        (*Fill)(PerlIO *f);,  IV                (*Eof)(PerlIO *f);,  IV
4198    (*Error)(PerlIO *f);,  void             (*Clearerr)(PerlIO *f);,  void
4199        (*Setlinebuf)(PerlIO *f);,  STDCHAR *   (*Get_base)(PerlIO *f);,
4200 Size_t                (*Get_bufsiz)(PerlIO *f);,  STDCHAR *
4201 (*Get_ptr)(PerlIO *f);,  SSize_t        (*Get_cnt)(PerlIO *f);,  void
4202     (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt);
4203
4204 =item Core Layers
4205
4206 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4207
4208 =item Extension Layers
4209
4210 ":encoding", ":Scalar", ":Object" or ":Perl"
4211
4212 =back
4213
4214 =back
4215
4216 =head2 perlapio - perl's IO abstraction interface.
4217
4218 =over 4
4219
4220 =item SYNOPSIS
4221
4222 =item DESCRIPTION
4223
4224 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4225 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4226 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4227 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4228 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4229 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4230 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4231 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4232 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4233 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4234 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4235
4236 =over 4
4237
4238 =item Co-existence with stdio
4239
4240 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4241 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>
4242
4243 =item "Fast gets" Functions
4244
4245 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4246 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4247 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4248 B<PerlIO_get_bufsiz(f)>
4249
4250 =item Other Functions
4251
4252 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4253 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4254
4255 =back
4256
4257 =back
4258
4259 =head2 perltodo - Perl TO-DO List
4260
4261 =over 4
4262
4263 =item DESCRIPTION
4264
4265 =item To do during 5.6.x
4266
4267 =over 4
4268
4269 =item Support for I/O disciplines
4270
4271 =item Autoload bytes.pm
4272
4273 =item Make "\u{XXXX}" et al work
4274
4275 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4276
4277 =item Overloadable regex assertions
4278
4279 =item Unicode
4280
4281 =item use Thread for iThreads
4282
4283 =item make perl_clone optionally clone ops
4284
4285 =item Work out exit/die semantics for threads
4286
4287 =item Typed lexicals for compiler
4288
4289 =item Compiler workarounds for Win32
4290
4291 =item AUTOLOADing in the compiler
4292
4293 =item Fixing comppadlist when compiling
4294
4295 =item Cleaning up exported namespace
4296
4297 =item Complete signal handling
4298
4299 =item Out-of-source builds
4300
4301 =item POSIX realtime support
4302
4303 =item UNIX98 support
4304
4305 =item IPv6 Support
4306
4307 =item Long double conversion
4308
4309 =item Locales
4310
4311 =item Thread-safe regexes
4312
4313 =item Arithmetic on non-Arabic numerals
4314
4315 =item POSIX Unicode character classes
4316
4317 =item Factoring out common suffices/prefices in regexps (trie optimization)
4318
4319 =item Security audit shipped utilities
4320
4321 =item Custom opcodes
4322
4323 =item spawnvp() on Win32
4324
4325 =item DLL Versioning
4326
4327 =item Introduce @( and @)
4328
4329 =item Floating point handling
4330
4331 =item IV/UV preservation
4332
4333 =item Replace pod2html with something using Pod::Parser
4334
4335 =item Automate module testing on CPAN
4336
4337 =item sendmsg and recvmsg
4338
4339 =item Rewrite perlre documentation
4340
4341 =item Convert example code to IO::Handle filehandles
4342
4343 =item Document Win32 choices
4344
4345 =item Check new modules
4346
4347 =item Make roffitall find pods and libs itself
4348
4349 =back
4350
4351 =item To do at some point
4352
4353 =over 4
4354
4355 =item Remove regular expression recursion
4356
4357 =item Memory leaks after failed eval
4358
4359 =item pack "(stuff)*"
4360
4361 =item bitfields in pack
4362
4363 =item Cross compilation
4364
4365 =item Perl preprocessor / macros
4366
4367 =item Perl lexer in Perl
4368
4369 =item Using POSIX calls internally
4370
4371 =item -i rename file when changed
4372
4373 =item All ARGV input should act like E<lt>E<gt>
4374
4375 =item Support for rerunning debugger
4376
4377 =item Test Suite for the Debugger
4378
4379 =item my sub foo { }
4380
4381 =item One-pass global destruction
4382
4383 =item Rewrite regexp parser
4384
4385 =item Cache recently used regexps
4386
4387 =item Re-entrant functions
4388
4389 =item Cross-compilation support
4390
4391 =item Bit-shifting bitvectors
4392
4393 =item debugger pragma
4394
4395 =item use less pragma
4396
4397 =item switch structures
4398
4399 =item Cache eval tree
4400
4401 =item rcatmaybe
4402
4403 =item Shrink opcode tables
4404
4405 =item Optimize away @_
4406
4407 =item Prototypes versus indirect objects
4408
4409 =item Install HMTL
4410
4411 =item Prototype method calls
4412
4413 =item Return context prototype declarations
4414
4415 =item magic_setisa
4416
4417 =item Garbage collection
4418
4419 =item IO tutorial
4420
4421 =item pack/unpack tutorial
4422
4423 =item Rewrite perldoc
4424
4425 =item Install .3p manpages
4426
4427 =item Unicode tutorial
4428
4429 =item Update POSIX.pm for 1003.1-2
4430
4431 =item Retargetable installation
4432
4433 =item POSIX emulation on non-POSIX systems
4434
4435 =item Rename Win32 headers
4436
4437 =item Finish off lvalue functions
4438
4439 =item Update sprintf documentation
4440
4441 =item Use fchown/fchmod internally
4442
4443 =back
4444
4445 =item Vague ideas
4446
4447 =over 4
4448
4449 =item ref() in list context
4450
4451 =item Make tr/// return histogram of characters in list context
4452
4453 =item Compile to real threaded code
4454
4455 =item Structured types
4456
4457 =item Modifiable $1 et al.
4458
4459 =item Procedural interfaces for IO::*, etc.
4460
4461 =item RPC modules
4462
4463 =item Attach/detach debugger from running program
4464
4465 =item Alternative RE syntax module
4466
4467 =item GUI::Native
4468
4469 =item foreach(reverse ...)
4470
4471 =item Constant function cache
4472
4473 =item Approximate regular expression matching
4474
4475 =back
4476
4477 =item Ongoing
4478
4479 =over 4
4480
4481 =item Update guts documentation
4482
4483 =item Add more tests
4484
4485 =item Update auxiliary tools
4486
4487 =back
4488
4489 =item Recently done things
4490
4491 =over 4
4492
4493 =item Safe signal handling
4494
4495 =item Tie Modules
4496
4497 =item gettimeofday
4498
4499 =item setitimer and getimiter
4500
4501 =item Testing __DIE__ hook
4502
4503 =item CPP equivalent in Perl
4504
4505 =item Explicit switch statements
4506
4507 =item autocroak
4508
4509 =item UTF/EBCDIC
4510
4511 =item UTF Regexes
4512
4513 =item perlcc to produce executable
4514
4515 =item END blocks saved in compiled output
4516
4517 =item Secure temporary file module
4518
4519 =item Integrate Time::HiRes
4520
4521 =item Turn Cwd into XS
4522
4523 =item Mmap for input
4524
4525 =item Byte to/from UTF8 and UTF8 to/from local conversion
4526
4527 =item Add sockatmark support
4528
4529 =item Mailing list archives
4530
4531 =item Bug tracking
4532
4533 =item Integrate MacPerl
4534
4535 =item Web "nerve center" for Perl
4536
4537 =item Regular expression tutorial
4538
4539 =item Debugging Tutorial
4540
4541 =item Integrate new modules
4542
4543 =item Integrate profiler
4544
4545 =item Y2K error detection
4546
4547 =item Regular expression debugger
4548
4549 =item POD checker
4550
4551 =item "Dynamic" lexicals
4552
4553 =item Cache precompiled modules
4554
4555 =back
4556
4557 =item Deprecated Wishes
4558
4559 =over 4
4560
4561 =item Loop control on do{}
4562
4563 =item Lexically scoped typeglobs
4564
4565 =item format BOTTOM
4566
4567 =item report HANDLE
4568
4569 =item Generalised want()/caller())
4570
4571 =item Named prototypes
4572
4573 =item Built-in globbing
4574
4575 =item Regression tests for suidperl
4576
4577 =item Cached hash values
4578
4579 =item Add compression modules
4580
4581 =item Reorganise documentation into tutorials/references
4582
4583 =item Remove distinction between functions and operators
4584
4585 =item Make XS easier to use
4586
4587 =item Make embedding easier to use
4588
4589 =item man for perl
4590
4591 =item my $Package::variable
4592
4593 =item "or" tests defined, not truth
4594
4595 =item "class"-based lexicals
4596
4597 =item byteperl
4598
4599 =item Lazy evaluation / tail recursion removal
4600
4601 =item Make "use utf8" the default
4602
4603 =item Unicode collation and normalization
4604
4605 =item Create debugging macros
4606
4607 =back
4608
4609 =back
4610
4611 =head2 perlhack - How to hack at the Perl internals
4612
4613 =over 4
4614
4615 =item DESCRIPTION
4616
4617 Does concept match the general goals of Perl?, Where is the
4618 implementation?, Backwards compatibility, Could it be a module instead?, Is
4619 the feature generic enough?, Does it potentially introduce new bugs?, Does
4620 it preclude other desirable features?, Is the implementation robust?, Is
4621 the implementation generic enough to be portable?, Is there enough
4622 documentation?, Is there another way to do it?, Does it create too much
4623 work?, Patches speak louder than words
4624
4625 =over 4
4626
4627 =item Keeping in sync
4628
4629 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4630 NFS, rsync'ing the patches
4631
4632 =item Why rsync the source tree
4633
4634 It's easier to rsync the source tree, It's more recent, It's more reliable
4635
4636 =item Why rsync the patches
4637
4638 It's easier to rsync the patches, It's a good reference, Finding a start
4639 point, Finding how to fix a bug, Finding the source of misbehaviour
4640
4641 =item Submitting patches
4642
4643 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4644 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4645
4646 =item Finding Your Way Around
4647
4648 Core modules, Tests, Documentation, Configure, Interpreter
4649
4650 =item Elements of the interpreter
4651
4652 Startup, Parsing, Optimization, Running
4653
4654 =item Internal Variable Types
4655
4656 =item Op Trees
4657
4658 =item Stacks
4659
4660 Argument stack, Mark stack, Save stack
4661
4662 =item Millions of Macros
4663
4664 =item Poking at Perl
4665
4666 =item Using a source-level debugger
4667
4668 run [args], break function_name, break source.c:xxx, step, next, continue,
4669 finish, 'enter', print
4670
4671 =item Dumping Perl Data Structures
4672
4673 =item Patching
4674
4675 =item Patching a core module
4676
4677 =item Adding a new function to the core
4678
4679 =item Writing a test
4680
4681 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
4682 F<t/pod/>, F<t/run/>
4683
4684 =back
4685
4686 =item EXTERNAL TOOLS FOR DEBUGGING PERL
4687
4688 =over 4
4689
4690 =item Rational Software's Purify
4691
4692 =item Purify on Unix
4693
4694 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
4695
4696 =item Purify on NT
4697
4698 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
4699
4700 =item Compaq's/Digital's Third Degree
4701
4702 =item PERL_DESTRUCT_LEVEL
4703
4704 =item Profiling
4705
4706 =item Gprof Profiling
4707
4708 -a, -b, -e routine, -f routine, -s, -z
4709
4710 =item GCC gcov Profiling
4711
4712 =item Pixie Profiling
4713
4714 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
4715 -z[ero]
4716
4717 =item CONCLUSION
4718
4719 I<The Road goes ever on and on, down from the door where it began.>
4720
4721 =back
4722
4723 =item AUTHOR
4724
4725 =back
4726
4727 =head2 perlhist - the Perl history records
4728
4729 =over 4
4730
4731 =item DESCRIPTION
4732
4733 =item INTRODUCTION
4734
4735 =item THE KEEPERS OF THE PUMPKIN
4736
4737 =over 4
4738
4739 =item PUMPKIN?
4740
4741 =back
4742
4743 =item THE RECORDS
4744
4745 =over 4
4746
4747 =item SELECTED RELEASE SIZES
4748
4749 =item SELECTED PATCH SIZES
4750
4751 =back
4752
4753 =item THE KEEPERS OF THE RECORDS
4754
4755 =back
4756
4757 =head2 perldelta - what will be new for perl v5.8.0
4758
4759 =over 4
4760
4761 =item DESCRIPTION
4762
4763 =item Reporting Bugs
4764
4765 =item SEE ALSO
4766
4767 =item HISTORY
4768
4769 =back
4770
4771 =head2 perl572delta - what's new for perl v5.7.2
4772
4773 =over 4
4774
4775 =item DESCRIPTION
4776
4777 =item Security Vulnerability Closed
4778
4779 =item Incompatible Changes
4780
4781 =over 4
4782
4783 =item 64-bit platforms and malloc
4784
4785 =item AIX Dynaloading
4786
4787 =item Socket Extension Dynamic in VMS
4788
4789 =item Different Definition of the Unicode Character Classes \p{In...}
4790
4791 =item Deprecations
4792
4793 =back
4794
4795 =item Core Enhancements
4796
4797 =item Modules and Pragmata
4798
4799 =over 4
4800
4801 =item New Modules and Distributions
4802
4803 =item Updated And Improved Modules and Pragmata
4804
4805 =back
4806
4807 =item Utility Changes
4808
4809 =item New Documentation
4810
4811 =item Installation and Configuration Improvements
4812
4813 =over 4
4814
4815 =item New Or Improved Platforms
4816
4817 =item Generic Improvements
4818
4819 =back
4820
4821 =item Selected Bug Fixes
4822
4823 =over 4
4824
4825 =item Platform Specific Changes and Fixes
4826
4827 =back
4828
4829 =item New or Changed Diagnostics
4830
4831 =item Source Code Enhancements
4832
4833 =over 4
4834
4835 =item MAGIC constants
4836
4837 =item Better commented code
4838
4839 =item Regex pre-/post-compilation items matched up
4840
4841 =item gcc -Wall
4842
4843 =back
4844
4845 =item New Tests
4846
4847 =item Known Problems
4848
4849 =over 4
4850
4851 =item AIX
4852
4853 =item Amiga Perl Invoking Mystery
4854
4855 =item lib/ftmp-security tests warn 'system possibly insecure'
4856
4857 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
4858
4859 =item HP-UX lib/io_multihomed Fails When LP64-Configur
4860
4861 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
4862
4863 =item Linux With Sfio Fails op/misc Test 48
4864
4865 =item OS/390
4866
4867 =item op/sprintf tests 129 and 130
4868
4869 =item  Failure of Thread tests
4870
4871 =item UNICOS
4872
4873 =item UTS
4874
4875 =item VMS
4876
4877 =item Win32
4878
4879 =item Localising a Tied Variable Leaks Memory
4880
4881 =item Self-tying of Arrays and Hashes Is Forbidden
4882
4883 =item Variable Attributes are not Currently Usable for Tieing
4884
4885 =item Building Extensions Can Fail Because Of Largefiles
4886
4887 =item The Compiler Suite Is Still Experimental
4888
4889 =item The Long Double Support is Still Experimental
4890
4891 =back
4892
4893 =item Reporting Bugs
4894
4895 =item SEE ALSO
4896
4897 =item HISTORY
4898
4899 =back
4900
4901 =head2 perl571delta - what's new for perl v5.7.1
4902
4903 =over 4
4904
4905 =item DESCRIPTION
4906
4907 =item Security Vulnerability Closed
4908
4909 =item Incompatible Changes
4910
4911 =item Core Enhancements
4912
4913 =over 4
4914
4915 =item AUTOLOAD Is Now Lvaluable
4916
4917 =item PerlIO is Now The Default
4918
4919 =item Signals Are Now Safe
4920
4921 =back
4922
4923 =item Modules and Pragmata
4924
4925 =over 4
4926
4927 =item New Modules
4928
4929 =item Updated And Improved Modules and Pragmata
4930
4931 =back
4932
4933 =item Performance Enhancements
4934
4935 =item Utility Changes
4936
4937 =item New Documentation
4938
4939 =over 4
4940
4941 =item perlclib
4942
4943 =item perliol
4944
4945 =item README.aix
4946
4947 =item README.bs2000
4948
4949 =item README.macos
4950
4951 =item README.mpeix
4952
4953 =item README.solaris
4954
4955 =item README.vos
4956
4957 =item Porting/repository.pod
4958
4959 =back
4960
4961 =item Installation and Configuration Improvements
4962
4963 =over 4
4964
4965 =item New Or Improved Platforms
4966
4967 =item Generic Improvements
4968
4969 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
4970 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
4971 d_strtoq, d_u32align, d_ualarm, d_usleep
4972
4973 =back
4974
4975 =item Selected Bug Fixes
4976
4977 =over 4
4978
4979 =item Platform Specific Changes and Fixes
4980
4981 =back
4982
4983 =item New or Changed Diagnostics
4984
4985 =item Changed Internals
4986
4987 =item New Tests
4988
4989 =item Known Problems
4990
4991 =over 4
4992
4993 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
4994
4995 =item lib/ftmp-security tests warn 'system possibly insecure'
4996
4997 =item lib/io_multihomed Fails In LP64-Configured HP-UX
4998
4999 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5000
5001 =item lib/b test 19
5002
5003 =item Linux With Sfio Fails op/misc Test 48
5004
5005 =item sigaction test 13 in VMS
5006
5007 =item sprintf tests 129 and 130
5008
5009 =item  Failure of Thread tests
5010
5011 =item Localising a Tied Variable Leaks Memory
5012
5013 =item Self-tying of Arrays and Hashes Is Forbidden
5014
5015 =item Building Extensions Can Fail Because Of Largefiles
5016
5017 =item The Compiler Suite Is Still Experimental
5018
5019 =back
5020
5021 =item Reporting Bugs
5022
5023 =item SEE ALSO
5024
5025 =item HISTORY
5026
5027 =back
5028
5029 =head2 perl570delta - what's new for perl v5.7.0
5030
5031 =over 4
5032
5033 =item DESCRIPTION
5034
5035 =item Security Vulnerability Closed
5036
5037 =item Incompatible Changes
5038
5039 =item Core Enhancements
5040
5041 =item Modules and Pragmata
5042
5043 =over 4
5044
5045 =item New Modules
5046
5047 =item Updated And Improved Modules and Pragmata
5048
5049 =back
5050
5051 =item Utility Changes
5052
5053 =item New Documentation
5054
5055 =item Performance Enhancements
5056
5057 =item Installation and Configuration Improvements
5058
5059 =over 4
5060
5061 =item Generic Improvements
5062
5063 =back
5064
5065 =item Selected Bug Fixes
5066
5067 =over 4
5068
5069 =item Platform Specific Changes and Fixes
5070
5071 =back
5072
5073 =item New or Changed Diagnostics
5074
5075 =item Changed Internals
5076
5077 =item Known Problems
5078
5079 =over 4
5080
5081 =item Unicode Support Still Far From Perfect
5082
5083 =item EBCDIC Still A Lost Platform
5084
5085 =item Building Extensions Can Fail Because Of Largefiles
5086
5087 =item ftmp-security tests warn 'system possibly insecure'
5088
5089 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5090
5091 =item Long Doubles Still Don't Work In Solaris
5092
5093 =item Linux With Sfio Fails op/misc Test 48
5094
5095 =item Storable tests fail in some platforms
5096
5097 =item Threads Are Still Experimental
5098
5099 =item The Compiler Suite Is Still Experimental
5100
5101 =back
5102
5103 =item Reporting Bugs
5104
5105 =item SEE ALSO
5106
5107 =item HISTORY
5108
5109 =back
5110
5111 =head2 perl56delta, perldelta - what's new for perl v5.6.0
5112
5113 =over 4
5114
5115 =item DESCRIPTION
5116
5117 =item Core Enhancements
5118
5119 =over 4
5120
5121 =item Interpreter cloning, threads, and concurrency
5122
5123 =item Lexically scoped warning categories
5124
5125 =item Unicode and UTF-8 support
5126
5127 =item Support for interpolating named characters
5128
5129 =item "our" declarations
5130
5131 =item Support for strings represented as a vector of ordinals
5132
5133 =item Improved Perl version numbering system
5134
5135 =item New syntax for declaring subroutine attributes
5136
5137 =item File and directory handles can be autovivified
5138
5139 =item open() with more than two arguments
5140
5141 =item 64-bit support
5142
5143 =item Large file support
5144
5145 =item Long doubles
5146
5147 =item "more bits"
5148
5149 =item Enhanced support for sort() subroutines
5150
5151 =item C<sort $coderef @foo> allowed
5152
5153 =item File globbing implemented internally
5154
5155 =item Support for CHECK blocks
5156
5157 =item POSIX character class syntax [: :] supported
5158
5159 =item Better pseudo-random number generator
5160
5161 =item Improved C<qw//> operator
5162
5163 =item Better worst-case behavior of hashes
5164
5165 =item pack() format 'Z' supported
5166
5167 =item pack() format modifier '!' supported
5168
5169 =item pack() and unpack() support counted strings
5170
5171 =item Comments in pack() templates
5172
5173 =item Weak references
5174
5175 =item Binary numbers supported
5176
5177 =item Lvalue subroutines
5178
5179 =item Some arrows may be omitted in calls through references
5180
5181 =item Boolean assignment operators are legal lvalues
5182
5183 =item exists() is supported on subroutine names
5184
5185 =item exists() and delete() are supported on array elements
5186
5187 =item Pseudo-hashes work better
5188
5189 =item Automatic flushing of output buffers
5190
5191 =item Better diagnostics on meaningless filehandle operations
5192
5193 =item Where possible, buffered data discarded from duped input filehandle
5194
5195 =item eof() has the same old magic as <>
5196
5197 =item binmode() can be used to set :crlf and :raw modes
5198
5199 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5200
5201 =item system(), backticks and pipe open now reflect exec() failure
5202
5203 =item Improved diagnostics
5204
5205 =item Diagnostics follow STDERR
5206
5207 =item More consistent close-on-exec behavior
5208
5209 =item syswrite() ease-of-use
5210
5211 =item Better syntax checks on parenthesized unary operators
5212
5213 =item Bit operators support full native integer width
5214
5215 =item Improved security features
5216
5217 =item More functional bareword prototype (*)
5218
5219 =item C<require> and C<do> may be overridden
5220
5221 =item $^X variables may now have names longer than one character
5222
5223 =item New variable $^C reflects C<-c> switch
5224
5225 =item New variable $^V contains Perl version as a string
5226
5227 =item Optional Y2K warnings
5228
5229 =item Arrays now always interpolate into double-quoted strings
5230
5231 =back
5232
5233 =item Modules and Pragmata
5234
5235 =over 4
5236
5237 =item Modules
5238
5239 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5240 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5241 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5242 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5243 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5244 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5245 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5246 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5247
5248 =item Pragmata
5249
5250 =back
5251
5252 =item Utility Changes
5253
5254 =over 4
5255
5256 =item dprofpp
5257
5258 =item find2perl
5259
5260 =item h2xs
5261
5262 =item perlcc
5263
5264 =item perldoc
5265
5266 =item The Perl Debugger
5267
5268 =back
5269
5270 =item Improved Documentation
5271
5272 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5273 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5274 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5275 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5276
5277 =item Performance enhancements
5278
5279 =over 4
5280
5281 =item Simple sort() using { $a <=> $b } and the like are optimized
5282
5283 =item Optimized assignments to lexical variables
5284
5285 =item Faster subroutine calls
5286
5287 =item delete(), each(), values() and hash iteration are faster
5288
5289 =back
5290
5291 =item Installation and Configuration Improvements
5292
5293 =over 4
5294
5295 =item -Dusethreads means something different
5296
5297 =item New Configure flags
5298
5299 =item Threadedness and 64-bitness now more daring
5300
5301 =item Long Doubles
5302
5303 =item -Dusemorebits
5304
5305 =item -Duselargefiles
5306
5307 =item installusrbinperl
5308
5309 =item SOCKS support
5310
5311 =item C<-A> flag
5312
5313 =item Enhanced Installation Directories
5314
5315 =back
5316
5317 =item Platform specific changes
5318
5319 =over 4
5320
5321 =item Supported platforms
5322
5323 =item DOS
5324
5325 =item OS390 (OpenEdition MVS)
5326
5327 =item VMS
5328
5329 =item Win32
5330
5331 =back
5332
5333 =item Significant bug fixes
5334
5335 =over 4
5336
5337 =item <HANDLE> on empty files
5338
5339 =item C<eval '...'> improvements
5340
5341 =item All compilation errors are true errors
5342
5343 =item Implicitly closed filehandles are safer
5344
5345 =item Behavior of list slices is more consistent
5346
5347 =item C<(\$)> prototype and C<$foo{a}>
5348
5349 =item C<goto &sub> and AUTOLOAD
5350
5351 =item C<-bareword> allowed under C<use integer>
5352
5353 =item Failures in DESTROY()
5354
5355 =item Locale bugs fixed
5356
5357 =item Memory leaks
5358
5359 =item Spurious subroutine stubs after failed subroutine calls
5360
5361 =item Taint failures under C<-U>
5362
5363 =item END blocks and the C<-c> switch
5364
5365 =item Potential to leak DATA filehandles
5366
5367 =back
5368
5369 =item New or Changed Diagnostics
5370
5371 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
5372 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
5373 / cannot take a count, / must be followed by a, A or Z, / must be followed
5374 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
5375 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
5376 passed through, /%s/ should probably be written as "%s", %s() called too
5377 early to check prototype, %s argument is not a HASH or ARRAY element, %s
5378 argument is not a HASH or ARRAY element or slice, %s argument is not a
5379 subroutine name, %s package attribute may clash with future reserved word:
5380 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
5381 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
5382 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
5383 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
5384 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
5385 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
5386 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
5387 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
5388 weaken a nonreference, Character class [:%s:] unknown, Character class
5389 syntax [%s] belongs inside character classes, Constant is not %s reference,
5390 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
5391 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
5392 "local" instead of "our"?), Document contains no data, entering effective
5393 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
5394 output, flock() on closed filehandle %s, Global symbol "%s" requires
5395 explicit package name, Hexadecimal number > 0xffffffff non-portable,
5396 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
5397 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
5398 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
5399 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
5400 separator character %s in attribute list, Invalid separator character %s in
5401 subroutine attribute list, leaving effective %s failed, Lvalue subs
5402 returning %s not implemented yet, Method %s not permitted, Missing
5403 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
5404 No %s specified for -%c, No package name allowed for variable %s in "our",
5405 No space allowed after -%c, no UTC offset information; assuming local time
5406 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
5407 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
5408 around "%s" list, Possible unintended interpolation of %s in string,
5409 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
5410 instead, Premature end of script headers, Repeat count in pack overflows,
5411 Repeat count in unpack overflows, realloc() of freed memory ignored,
5412 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
5413 zero-length expression, switching effective %s is not implemented, This
5414 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
5415 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
5416 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
5417 escape \\%c passed through, Unterminated attribute parameter in attribute
5418 list, Unterminated attribute list, Unterminated attribute parameter in
5419 subroutine attribute list, Unterminated subroutine attribute list, Value of
5420 CLI symbol "%s" too long, Version number must be a constant number
5421
5422 =item New tests
5423
5424 =item Incompatible Changes
5425
5426 =over 4
5427
5428 =item Perl Source Incompatibilities
5429
5430 CHECK is a new keyword, Treatment of list slices of undef has changed,
5431 Format of $English::PERL_VERSION is different, Literals of the form
5432 C<1.2.3> parse differently, Possibly changed pseudo-random number
5433 generator, Hashing function for hash keys has changed, C<undef> fails on
5434 read only values, Close-on-exec bit may be set on pipe and socket handles,
5435 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
5436 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
5437 Text of some diagnostic output has changed, C<%@> has been removed,
5438 Parenthesized not() behaves like a list operator, Semantics of bareword
5439 prototype C<(*)> have changed, Semantics of bit operators may have changed
5440 on 64-bit platforms, More builtins taint their results
5441
5442 =item C Source Incompatibilities
5443
5444 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
5445
5446 =item Compatible C Source API Changes
5447
5448 C<PATCHLEVEL> is now C<PERL_VERSION>
5449
5450 =item Binary Incompatibilities
5451
5452 =back
5453
5454 =item Known Problems
5455
5456 =over 4
5457
5458 =item Thread test failures
5459
5460 =item EBCDIC platforms not supported
5461
5462 =item In 64-bit HP-UX the lib/io_multihomed test may hang
5463
5464 =item NEXTSTEP 3.3 POSIX test failure
5465
5466 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
5467 gcc
5468
5469 =item UNICOS/mk CC failures during Configure run
5470
5471 =item Arrow operator and arrays
5472
5473 =item Experimental features
5474
5475 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
5476 pseudo-hash data type, The Compiler suite, Internal implementation of file
5477 globbing, The DB module, The regular expression code constructs:
5478
5479 =back
5480
5481 =item Obsolete Diagnostics
5482
5483 Character class syntax [: :] is reserved for future extensions, Ill-formed
5484 logical name |%s| in prime_env_iter, In string, @%s now must be written as
5485 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
5486 to mean "${$}<digit>" is deprecated
5487
5488 =item Reporting Bugs
5489
5490 =item SEE ALSO
5491
5492 =item HISTORY
5493
5494 =back
5495
5496 =head2 perl5005delta, perldelta - what's new for perl5.005
5497
5498 =over 4
5499
5500 =item DESCRIPTION
5501
5502 =item About the new versioning system
5503
5504 =item Incompatible Changes
5505
5506 =over 4
5507
5508 =item WARNING:  This version is not binary compatible with Perl 5.004.
5509
5510 =item Default installation structure has changed
5511
5512 =item Perl Source Compatibility
5513
5514 =item C Source Compatibility
5515
5516 =item Binary Compatibility
5517
5518 =item Security fixes may affect compatibility
5519
5520 =item Relaxed new mandatory warnings introduced in 5.004
5521
5522 =item Licensing
5523
5524 =back
5525
5526 =item Core Changes
5527
5528 =over 4
5529
5530 =item Threads
5531
5532 =item Compiler
5533
5534 =item Regular Expressions
5535
5536 Many new and improved optimizations, Many bug fixes, New regular expression
5537 constructs, New operator for precompiled regular expressions, Other
5538 improvements, Incompatible changes
5539
5540 =item   Improved malloc()
5541
5542 =item Quicksort is internally implemented
5543
5544 =item Reliable signals
5545
5546 =item Reliable stack pointers
5547
5548 =item More generous treatment of carriage returns
5549
5550 =item Memory leaks
5551
5552 =item Better support for multiple interpreters
5553
5554 =item Behavior of local() on array and hash elements is now well-defined
5555
5556 =item C<%!> is transparently tied to the L<Errno> module
5557
5558 =item Pseudo-hashes are supported
5559
5560 =item C<EXPR foreach EXPR> is supported
5561
5562 =item Keywords can be globally overridden
5563
5564 =item C<$^E> is meaningful on Win32
5565
5566 =item C<foreach (1..1000000)> optimized
5567
5568 =item C<Foo::> can be used as implicitly quoted package name
5569
5570 =item C<exists $Foo::{Bar::}> tests existence of a package
5571
5572 =item Better locale support
5573
5574 =item Experimental support for 64-bit platforms
5575
5576 =item prototype() returns useful results on builtins
5577
5578 =item Extended support for exception handling
5579
5580 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
5581
5582 =item All C<printf> format conversions are handled internally
5583
5584 =item New C<INIT> keyword
5585
5586 =item New C<lock> keyword
5587
5588 =item New C<qr//> operator
5589
5590 =item C<our> is now a reserved word
5591
5592 =item Tied arrays are now fully supported
5593
5594 =item Tied handles support is better
5595
5596 =item 4th argument to substr
5597
5598 =item Negative LENGTH argument to splice
5599
5600 =item Magic lvalues are now more magical
5601
5602 =item <> now reads in records
5603
5604 =back
5605
5606 =item Supported Platforms
5607
5608 =over 4
5609
5610 =item New Platforms
5611
5612 =item Changes in existing support
5613
5614 =back
5615
5616 =item Modules and Pragmata
5617
5618 =over 4
5619
5620 =item New Modules
5621
5622 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
5623 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
5624 Thread, attrs, fields, re
5625
5626 =item Changes in existing modules
5627
5628 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
5629 MakeMaker, CPAN, Cwd
5630
5631 =back
5632
5633 =item Utility Changes
5634
5635 =item Documentation Changes
5636
5637 =item New Diagnostics
5638
5639 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
5640 while coercing array into hash, Bareword "%s" refers to nonexistent
5641 package, Can't call method "%s" on an undefined value, Can't check
5642 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
5643 goto subroutine from an eval-string, Can't localize pseudo-hash element,
5644 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
5645 for "%s", Character class syntax [. .] is reserved for future extensions,
5646 Character class syntax [: :] is reserved for future extensions, Character
5647 class syntax [= =] is reserved for future extensions, %s: Eval-group in
5648 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
5649 Eval-group not allowed at run time, Explicit blessing to '' (assuming
5650 package main), Illegal hex digit ignored, No such array field, No such
5651 field "%s" in variable %s of type %s, Out of memory during ridiculously
5652 large request, Range iterator outside integer range, Recursive inheritance
5653 detected while looking for method '%s' %s, Reference found where even-sized
5654 list expected, Undefined value assigned to typeglob, Use of reserved word
5655 "%s" is deprecated, perl: warning: Setting locale failed
5656
5657 =item Obsolete Diagnostics
5658
5659 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
5660 temporary file, regexp too big
5661
5662 =item Configuration Changes
5663
5664 =item BUGS
5665
5666 =item SEE ALSO
5667
5668 =item HISTORY
5669
5670 =back
5671
5672 =head2 perl5004delta, perldelta - what's new for perl5.004
5673
5674 =over 4
5675
5676 =item DESCRIPTION
5677
5678 =item Supported Environments
5679
5680 =item Core Changes
5681
5682 =over 4
5683
5684 =item List assignment to %ENV works
5685
5686 =item Change to "Can't locate Foo.pm in @INC" error
5687
5688 =item Compilation option: Binary compatibility with 5.003
5689
5690 =item $PERL5OPT environment variable
5691
5692 =item Limitations on B<-M>, B<-m>, and B<-T> options
5693
5694 =item More precise warnings
5695
5696 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
5697
5698 =item Previously deprecated %OVERLOAD is no longer usable
5699
5700 =item Subroutine arguments created only when they're modified
5701
5702 =item Group vector changeable with C<$)>
5703
5704 =item Fixed parsing of $$<digit>, &$<digit>, etc.
5705
5706 =item Fixed localization of $<digit>, $&, etc.
5707
5708 =item No resetting of $. on implicit close
5709
5710 =item C<wantarray> may return undef
5711
5712 =item C<eval EXPR> determines value of EXPR in scalar context
5713
5714 =item Changes to tainting checks
5715
5716 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
5717 spawning if tainted $TERM doesn't look like a terminal name
5718
5719 =item New Opcode module and revised Safe module
5720
5721 =item Embedding improvements
5722
5723 =item Internal change: FileHandle class based on IO::* classes
5724
5725 =item Internal change: PerlIO abstraction interface
5726
5727 =item New and changed syntax
5728
5729 $coderef->(PARAMS)
5730
5731 =item New and changed builtin constants
5732
5733 __PACKAGE__
5734
5735 =item New and changed builtin variables
5736
5737 $^E, $^H, $^M
5738
5739 =item New and changed builtin functions
5740
5741 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
5742 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
5743 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
5744 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
5745 nested C<sub{}> closures work now, formats work right on changing lexicals
5746
5747 =item New builtin methods
5748
5749 isa(CLASS), can(METHOD), VERSION( [NEED] )
5750
5751 =item TIEHANDLE now supported
5752
5753 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
5754 LIST, READLINE this, GETC this, DESTROY this
5755
5756 =item Malloc enhancements
5757
5758 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
5759
5760 =item Miscellaneous efficiency enhancements
5761
5762 =back
5763
5764 =item Support for More Operating Systems
5765
5766 =over 4
5767
5768 =item Win32
5769
5770 =item Plan 9
5771
5772 =item QNX
5773
5774 =item AmigaOS
5775
5776 =back
5777
5778 =item Pragmata
5779
5780 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
5781 constant NAME => VALUE, use locale, use ops, use vmsish
5782
5783 =item Modules
5784
5785 =over 4
5786
5787 =item Required Updates
5788
5789 =item Installation directories
5790
5791 =item Module information summary
5792
5793 =item Fcntl
5794
5795 =item IO
5796
5797 =item Math::Complex
5798
5799 =item Math::Trig
5800
5801 =item DB_File
5802
5803 =item Net::Ping
5804
5805 =item Object-oriented overrides for builtin operators
5806
5807 =back
5808
5809 =item Utility Changes
5810
5811 =over 4
5812
5813 =item pod2html
5814
5815 Sends converted HTML to standard output
5816
5817 =item xsubpp
5818
5819 C<void> XSUBs now default to returning nothing
5820
5821 =back
5822
5823 =item C Language API Changes
5824
5825 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
5826 manipulating hashes
5827
5828 =item Documentation Changes
5829
5830 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
5831 L<perlmodlib>, L<perldebug>, L<perlsec>
5832
5833 =item New Diagnostics
5834
5835 "my" variable %s masks earlier declaration in same scope, %s argument is
5836 not a HASH element or slice, Allocation too large: %lx, Allocation too
5837 large, Applying %s to %s will act on scalar(%s), Attempt to free
5838 nonexistent shared string, Attempt to use reference as lvalue in substr,
5839 Bareword "%s" refers to nonexistent package, Can't redefine active sort
5840 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
5841 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
5842 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
5843 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
5844 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
5845 %s, Integer overflow in hex number, Integer overflow in octal number,
5846 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
5847 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
5848 possible typo, Null picture in formline, Offset outside string, Out of
5849 memory!, Out of memory during request for %s, panic: frexp, Possible
5850 attempt to put comments in qw() list, Possible attempt to separate words
5851 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
5852 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
5853 option, untie attempted while %d inner references still exist, Unrecognized
5854 character %s, Unsupported function fork, Use of "$$<digit>" to mean
5855 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
5856 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
5857 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
5858 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
5859 long, Process terminated by SIG%s
5860
5861 =item BUGS
5862
5863 =item SEE ALSO
5864
5865 =item HISTORY
5866
5867 =back
5868
5869 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
5870
5871 =over 4
5872
5873 =item DESCRIPTION
5874
5875 =over 4
5876
5877 =item Compiling Perl 5 on AIX
5878
5879 =item OS level
5880
5881 =item Building Dynamic Extensions on AIX
5882
5883 =item The IBM ANSI C Compiler
5884
5885 =item Using GNU's gcc for building perl
5886
5887 =item Using Large Files with Perl
5888
5889 =item Threaded Perl
5890
5891 =item 64-bit Perl
5892
5893 =item AIX 4.2 and extensions using C++ with statics
5894
5895 =back
5896
5897 =item AUTHOR
5898
5899 =item DATE
5900
5901 =back
5902
5903 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
5904
5905 =over 4
5906
5907 =item DESCRIPTION
5908
5909 =item AUTHOR
5910
5911 =back
5912
5913 =head2 perlamiga - Perl under Amiga OS
5914
5915 =over 4
5916
5917 =item SYNOPSIS
5918
5919 =back
5920
5921 =over 4
5922
5923 =item DESCRIPTION
5924
5925 =over 4
5926
5927 =item Prerequisites for Compiling Perl on AmigaOS
5928
5929 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
5930
5931 =item Starting Perl programs under AmigaOS
5932
5933 =item Shortcomings of Perl under AmigaOS
5934
5935 =back
5936
5937 =item INSTALLATION
5938
5939 =item Accessing documentation
5940
5941 =over 4
5942
5943 =item Manpages for Perl on AmigaOS
5944
5945 =item Perl HTML Documentation on AmigaOS
5946
5947 =item Perl GNU Info Files on AmigaOS
5948
5949 =item Perl LaTeX Documentation on AmigaOS
5950
5951 =back
5952
5953 =item BUILDING PERL ON AMIGAOS
5954
5955 =over 4
5956
5957 =item Build Prerequisites for Perl on AmigaOS
5958
5959 =item Getting the Perl Source for AmigaOS
5960
5961 =item Making Perl on AmigaOS
5962
5963 =item Testing Perl on AmigaOS
5964
5965 =item Installing the built Perl on AmigaOS
5966
5967 =back
5968
5969 =item AUTHORS
5970
5971 =item SEE ALSO
5972
5973 =back
5974
5975 =head2 perlbeos, README.beos - Perl version 5 on BeOS
5976
5977 =over 4
5978
5979 =item DESCRIPTION
5980
5981 =over 4
5982
5983 =item General Issues with Perl on BeOS
5984
5985 =item BeOS Release-specific Notes
5986
5987 R4 x86, R4 PPC
5988
5989 =item Contact Information
5990
5991 =back
5992
5993 =back
5994
5995 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
5996
5997 =over 4
5998
5999 =item SYNOPSIS
6000
6001 =item DESCRIPTION
6002
6003 =over 4
6004
6005 =item gzip on BS2000
6006
6007 =item bison on BS2000
6008
6009 =item Unpacking Perl Distribution on BS2000
6010
6011 =item Compiling Perl on BS2000
6012
6013 =item Testing Perl on BS2000
6014
6015 =item Installing Perl on BS2000
6016
6017 =item Using Perl in the Posix-Shell of BS2000
6018
6019 =item Using Perl in "native" BS2000
6020
6021 =item Floating point anomalies on BS2000
6022
6023 =back
6024
6025 =item AUTHORS
6026
6027 =item SEE ALSO
6028
6029 =over 4
6030
6031 =item Mailing list
6032
6033 =back
6034
6035 =item HISTORY
6036
6037 =back
6038
6039 =over 4
6040
6041 =item Name
6042
6043 =item Description
6044
6045 =item Build
6046
6047 =over 4
6048
6049 =item Tools & SDK
6050
6051 =item Make
6052
6053 =back
6054
6055 =item Acknowledgements
6056
6057 =item Author
6058
6059 =back
6060
6061 =head2 perlcygwin, README.cygwin - Perl for Cygwin
6062
6063 =over 4
6064
6065 =item SYNOPSIS
6066
6067 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
6068
6069 =over 4
6070
6071 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
6072
6073 =item Cygwin Configuration
6074
6075 C<PATH>, I<nroff>, Permissions
6076
6077 =back
6078
6079 =item CONFIGURE PERL ON CYGWIN
6080
6081 =over 4
6082
6083 =item Stripping Perl Binaries on Cygwin
6084
6085 =item Optional Libraries for Perl on Cygwin
6086
6087 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
6088 C<-lcygipc> (C<use IPC::SysV>)
6089
6090 =item Configure-time Options for Perl on Cygwin
6091
6092 C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>,
6093 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
6094
6095 =item Suspicious Warnings on Cygwin
6096
6097 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
6098
6099 =back
6100
6101 =item MAKE ON CYGWIN
6102
6103 =over 4
6104
6105 =item Warnings on Cygwin
6106
6107 =item ld2 on Cygwin
6108
6109 =back
6110
6111 =item TEST ON CYGWIN
6112
6113 =over 4
6114
6115 =item File Permissions on Cygwin
6116
6117 =item Hard Links on Cygwin
6118
6119 =item Filetime Granularity on Cygwin
6120
6121 =item Tainting Checks on Cygwin
6122
6123 =item /etc/group on Cygwin
6124
6125 =item Script Portability on Cygwin
6126
6127 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
6128
6129 =back
6130
6131 =item INSTALL PERL ON CYGWIN
6132
6133 =item MANIFEST ON CYGWIN
6134
6135 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
6136 Source, Compiled Module Source, Perl Modules/Scripts
6137
6138 =item BUGS ON CYGWIN
6139
6140 =item AUTHORS
6141
6142 =item HISTORY
6143
6144 =back
6145
6146 =head2 perldgux - Perl under DG/UX.
6147
6148 =over 4
6149
6150 =item SYNOPSIS
6151
6152 =back
6153
6154 =over 4
6155
6156 =item DESCRIPTION
6157
6158 =item BUILDING PERL ON DG/UX
6159
6160 =over 4
6161
6162 =item Non-threaded Perl on DG/UX
6163
6164 =item Threaded Perl on DG/UX
6165
6166 =item Testing Perl on DG/UX
6167
6168 =item Installing the built perl on DG/UX
6169
6170 =back
6171
6172 =item AUTHOR
6173
6174 =item SEE ALSO
6175
6176 =back
6177
6178 =head2 perlepoc, README.epoc - Perl for EPOC
6179
6180 =over 4
6181
6182 =item SYNOPSIS
6183
6184 =item INTRODUCTION
6185
6186 =item INSTALLING PERL ON EPOC
6187
6188 =item STARTING PERL ON EPOC
6189
6190 =item STOPPING PERL ON EPOC
6191
6192 =item USING PERL ON EPOC
6193
6194 =over 4
6195
6196 =item I/O Redirection on Epoc
6197
6198 =item PATH Names on Epoc
6199
6200 =item Editors on Epoc
6201
6202 =item Features of Perl on Epoc
6203
6204 =item Restrictions of Perl on Epoc
6205
6206 =item Compiling Perl 5 on the EPOC cross compiling environment
6207
6208 =back
6209
6210 =item SUPPORT STATUS OF PERL ON EPOC
6211
6212 =item AUTHOR
6213
6214 =item LAST UPDATE
6215
6216 =back
6217
6218 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
6219 (HP-UX) systems
6220
6221 =over 4
6222
6223 =item DESCRIPTION
6224
6225 =over 4
6226
6227 =item Using perl as shipped with HP-UX
6228
6229 =item Compiling Perl 5 on HP-UX
6230
6231 =item PA-RISC
6232
6233 =item PA-RISC 1.0
6234
6235 =item PA-RISC 1.1
6236
6237 =item PA-RISC 2.0
6238
6239 =item Itanium
6240
6241 =item Portability Between PA-RISC Versions
6242
6243 =item Itanium Processor Family and HP-UX
6244
6245 =item Building Dynamic Extensions on HP-UX
6246
6247 =item The HP ANSI C Compiler
6248
6249 =item Using Large Files with Perl on HP-UX
6250
6251 =item Threaded Perl on HP-UX
6252
6253 =item 64-bit Perl on HP-UX
6254
6255 =item GDBM and Threads on HP-UX
6256
6257 =item NFS filesystems and utime(2) on HP-UX
6258
6259 =item perl -P and // and HP-UX
6260
6261 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
6262
6263 =back
6264
6265 =item nss_delete core dump from op/pwent or op/grent
6266
6267 =item AUTHOR
6268
6269 =item DATE
6270
6271 =back
6272
6273 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
6274
6275 =over 4
6276
6277 =item DESCRIPTION
6278
6279 =over 4
6280
6281 =item Known Problems with Perl on Hurd
6282
6283 =back
6284
6285 =item AUTHOR
6286
6287 =back
6288
6289 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
6290 systems
6291
6292 =over 4
6293
6294 =item DESCRIPTION
6295
6296 =over 4
6297
6298 =item Compiling Perl 5 on MachTen
6299
6300 =item Failures during C<make test> on MachTen
6301
6302 op/lexassign.t, pragma/warnings.t
6303
6304 =item Building external modules on MachTen
6305
6306 =back
6307
6308 =item AUTHOR
6309
6310 =item DATE
6311
6312 =back
6313
6314 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
6315
6316 =over 4
6317
6318 =item SYNOPSIS
6319
6320 =item DESCRIPTION
6321
6322 =item AUTHOR
6323
6324 =item DATE
6325
6326 =back
6327
6328 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
6329
6330 =over 4
6331
6332 =item DESCRIPTION
6333
6334 =item Known problems with Perl on MiNT
6335
6336 =item AUTHOR
6337
6338 =back
6339
6340 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
6341
6342 =over 4
6343
6344 =item SYNOPSIS
6345
6346 =item NOTE
6347
6348 =item What's New in Perl ffor MPE/iX
6349
6350 =item Welcome to Perl/iX
6351
6352 =item System Requirements for Perl/iX
6353
6354 =item How to Obtain Perl/iX
6355
6356 =item Perl/iX Distribution Contents Highlights
6357
6358 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
6359 public_html/feedback.cgi, src/perl-5.6.0-mpe
6360
6361 =item How to Compile Perl/iX
6362
6363  4,  6
6364
6365 =item Getting Started with Perl/iX
6366
6367 =item MPE/iX Implementation Considerations
6368
6369 =item Known Perl/iX Bugs Under Investigation
6370
6371 =item Perl/iX To-Do List
6372
6373 =item Perl/iX Change History
6374
6375 =item AUTHOR
6376
6377 =item Name
6378
6379 =item Description
6380
6381 =item Build
6382
6383 =over 4
6384
6385 =item Tools & SDK
6386
6387 =item Setup
6388
6389 Buildtype.bat, SetNWBld.bat, MPKBuild.bat
6390
6391 =item Make
6392
6393 =item Interpreter
6394
6395 =item Extensions
6396
6397 =back
6398
6399 =item Install
6400
6401 =item Build new extensions
6402
6403 =item Known Issues
6404
6405 =item Acknowledgements
6406
6407 =item Authors
6408
6409 =item Date
6410
6411 =back
6412
6413 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
6414
6415 =over 4
6416
6417 =item SYNOPSIS
6418
6419 =back
6420
6421 =over 4
6422
6423 =item DESCRIPTION
6424
6425 =over 4
6426
6427 =item Target
6428
6429 =item Other OSes
6430
6431 =item Prerequisites
6432
6433 EMX, RSX, HPFS, pdksh
6434
6435 =item Starting Perl programs under OS/2 (and DOS and...)
6436
6437 =item Starting OS/2 (and DOS) programs under Perl
6438
6439 =back
6440
6441 =item Frequently asked questions
6442
6443 =over 4
6444
6445 =item "It does not work"
6446
6447 =item I cannot run external programs
6448
6449 =item I cannot embed perl into my program, or use F<perl.dll> from my
6450 program.
6451
6452 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
6453 L<ExtUtils::Embed>?
6454
6455 =item C<``> and pipe-C<open> do not work under DOS.
6456
6457 =item Cannot start C<find.exe "pattern" file>
6458
6459 =back
6460
6461 =item INSTALLATION
6462
6463 =over 4
6464
6465 =item Automatic binary installation
6466
6467 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
6468
6469 =item Manual binary installation
6470
6471 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
6472 (statically linked), Executables for Perl utilities, Main Perl library,
6473 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
6474 and utilities, Manpages for Perl modules, Source for Perl documentation,
6475 Perl manual in F<.INF> format, Pdksh
6476
6477 =item B<Warning>
6478
6479 =back
6480
6481 =item Accessing documentation
6482
6483 =over 4
6484
6485 =item OS/2 F<.INF> file
6486
6487 =item Plain text
6488
6489 =item Manpages
6490
6491 =item HTML
6492
6493 =item GNU C<info> files
6494
6495 =item F<.PDF> files
6496
6497 =item C<LaTeX> docs
6498
6499 =back
6500
6501 =item BUILD
6502
6503 =over 4
6504
6505 =item The short story
6506
6507 =item Prerequisites
6508
6509 =item Getting perl source
6510
6511 =item Application of the patches
6512
6513 =item Hand-editing
6514
6515 =item Making
6516
6517 =item Testing
6518
6519 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
6520 F<op/stat.t>
6521
6522 =item Installing the built perl
6523
6524 =item C<a.out>-style build
6525
6526 =back
6527
6528 =item Build FAQ
6529
6530 =over 4
6531
6532 =item Some C</> became C<\> in pdksh.
6533
6534 =item C<'errno'> - unresolved external
6535
6536 =item Problems with tr or sed
6537
6538 =item Some problem (forget which ;-)
6539
6540 =item Library ... not found
6541
6542 =item Segfault in make
6543
6544 =item op/sprintf test failure
6545
6546 =back
6547
6548 =item Specific (mis)features of OS/2 port
6549
6550 =over 4
6551
6552 =item C<setpriority>, C<getpriority>
6553
6554 =item C<system()>
6555
6556 =item C<extproc> on the first line
6557
6558 =item Additional modules:
6559
6560 =item Prebuilt methods:
6561
6562 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
6563  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
6564 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
6565 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
6566 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
6567 C<Cwd::extLibpath_set( path [, type ] )>,
6568 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
6569 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
6570 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
6571 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
6572 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
6573
6574 =item Prebuilt variables:
6575
6576 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
6577
6578 =item Misfeatures
6579
6580 =item Modifications
6581
6582 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
6583 C<flock>
6584
6585 =item Identifying DLLs
6586
6587 =item Centralized management of resources
6588
6589 C<HAB>, C<HMQ>
6590
6591 =back
6592
6593 =item Perl flavors
6594
6595 =over 4
6596
6597 =item F<perl.exe>
6598
6599 =item F<perl_.exe>
6600
6601 =item F<perl__.exe>
6602
6603 =item F<perl___.exe>
6604
6605 =item Why strange names?
6606
6607 =item Why dynamic linking?
6608
6609 =item Why chimera build?
6610
6611 =back
6612
6613 =item ENVIRONMENT
6614
6615 =over 4
6616
6617 =item C<PERLLIB_PREFIX>
6618
6619 =item C<PERL_BADLANG>
6620
6621 =item C<PERL_BADFREE>
6622
6623 =item C<PERL_SH_DIR>
6624
6625 =item C<USE_PERL_FLOCK>
6626
6627 =item C<TMP> or C<TEMP>
6628
6629 =back
6630
6631 =item Evolution
6632
6633 =over 4
6634
6635 =item Priorities
6636
6637 =item DLL name mangling: pre 5.6.2
6638
6639 =item DLL name mangling: 5.6.2 and beyond
6640
6641 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
6642 C<LIBPATH>
6643
6644 =item DLL forwarder generation
6645
6646 =item Threading
6647
6648 =item Calls to external programs
6649
6650 =item Memory allocation
6651
6652 =item Threads
6653
6654 C<COND_WAIT>, F<os2.c>
6655
6656 =back
6657
6658 =item BUGS
6659
6660 =back
6661
6662 =over 4
6663
6664 =item AUTHOR
6665
6666 =item SEE ALSO
6667
6668 =back
6669
6670 =head2 perlos390, README.os390 - building and installing Perl for OS/390.
6671
6672 =over 4
6673
6674 =item SYNOPSIS
6675
6676 =item DESCRIPTION
6677
6678 =over 4
6679
6680 =item Unpacking Perl distribution on OS/390
6681
6682 =item Setup and utilities for Perl on OS/390
6683
6684 =item Configure Perl on OS/390
6685
6686 =item Build, Test, Install Perl on OS/390
6687
6688 =item Build Anomalies with Perl on OS/390
6689
6690 =item Testing Anomalies with Perl on OS/390
6691
6692 =item Installation Anomalies with Perl on OS/390
6693
6694 =item Usage Hints for Perl on OS/390
6695
6696 =item Floating Point Anomalies with Perl on OS/390
6697
6698 =item Modules and Extensions for Perl on OS/390
6699
6700 =back
6701
6702 =item AUTHORS
6703
6704 =item SEE ALSO
6705
6706 =over 4
6707
6708 =item Mailing list for Perl on OS/390
6709
6710 =back
6711
6712 =item HISTORY
6713
6714 =back
6715
6716 =head2 perlqnx, README.qnx - Perl version 5 on QNX
6717
6718 =over 4
6719
6720 =item DESCRIPTION
6721
6722 =over 4
6723
6724 =item Required Software for Compiling Perl on QNX4
6725
6726 /bin/sh, ar, nm, cpp, make
6727
6728 =item Outstanding Issues with Perl on QNX4
6729
6730 =item QNX auxiliary files
6731
6732 qnx/ar, qnx/cpp
6733
6734 =item Outstanding issues with perl under QNX6
6735
6736 =back
6737
6738 =item AUTHOR
6739
6740 =back
6741
6742 =head2 perlplan9 - Plan 9-specific documentation for Perl
6743
6744 =over 4
6745
6746 =item DESCRIPTION
6747
6748 =over 4
6749
6750 =item Invoking Perl
6751
6752 =item What's in Plan 9 Perl
6753
6754 =item What's not in Plan 9 Perl
6755
6756 =item Perl5 Functions not currently supported in Plan 9 Perl
6757
6758 =item Signals in Plan 9 Perl
6759
6760 =back
6761
6762 =item COMPILING AND INSTALLING PERL ON PLAN 9
6763
6764 =over 4
6765
6766 =item Installing Perl Documentation on Plan 9
6767
6768 =back
6769
6770 =item BUGS
6771
6772 =item Revision date
6773
6774 =item AUTHOR
6775
6776 =back
6777
6778 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
6779
6780 =over 4
6781
6782 =item DESCRIPTION
6783
6784 =over 4
6785
6786 =item Solaris Version Numbers.
6787
6788 =back
6789
6790 =item RESOURCES
6791
6792 Solaris FAQ, Precompiled Binaries, Solaris Documentation
6793
6794 =item SETTING UP
6795
6796 =over 4
6797
6798 =item File Extraction Problems on Solaris.
6799
6800 =item Compiler and Related Tools on Solaris.
6801
6802 =item Environment for Compiling Perl on Solaris
6803
6804 =back
6805
6806 =item RUN CONFIGURE.
6807
6808 =over 4
6809
6810 =item 64-bit Issues with Perl on Solaris.
6811
6812 =item Threads in Perl on Solaris.
6813
6814 =item Malloc Issues with Perl on Solaris.
6815
6816 =back
6817
6818 =item MAKE PROBLEMS.
6819
6820 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
6821 relocation error:, dlopen: stub interception failed, #error "No
6822 DATAMODEL_NATIVE specified", sh: ar: not found
6823
6824 =item MAKE TEST
6825
6826 =over 4
6827
6828 =item op/stat.t test 4 in Solaris
6829
6830 =item nss_delete core dump from op/pwent or op/grent
6831
6832 =back
6833
6834 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
6835
6836 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
6837
6838 =over 4
6839
6840 =item Limits on Numbers of Open Files on Solaris.
6841
6842 =back
6843
6844 =item SOLARIS-SPECIFIC MODULES.
6845
6846 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
6847
6848 =over 4
6849
6850 =item Proc::ProcessTable on Solaris
6851
6852 =item BSD::Resource on Solaris
6853
6854 =item Net::SSLeay on Solaris
6855
6856 =back
6857
6858 =item AUTHOR
6859
6860 =item LAST MODIFIED
6861
6862 =back
6863
6864 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
6865 Digital UNIX formerly known as DEC OSF/1) systems
6866
6867 =over 4
6868
6869 =item DESCRIPTION
6870
6871 =over 4
6872
6873 =item Compiling Perl 5 on Tru64
6874
6875 =item Using Large Files with Perl on Tru64
6876
6877 =item Threaded Perl on Tru64
6878
6879 =item Long Doubles on Tru64
6880
6881 =item 64-bit Perl on Tru64
6882
6883 =item Warnings about floating-point overflow when compiling Perl on Tru64
6884
6885 =back
6886
6887 =item Testing Perl on Tru64
6888
6889 =item AUTHOR
6890
6891 =back
6892
6893 =head2 perluts - Perl under UTS
6894
6895 =over 4
6896
6897 =item SYNOPSIS
6898
6899 =item DESCRIPTION
6900
6901 =item BUILDING PERL ON UTS
6902
6903 =item Installing the built perl on UTS
6904
6905 =item AUTHOR
6906
6907 =back
6908
6909 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
6910
6911 =over 4
6912
6913 =item SYNOPSIS
6914
6915 =item DESCRIPTION
6916
6917 =over 4
6918
6919 =item Unpacking Perl Distribution on VM/ESA
6920
6921 =item Setup Perl and utilities on VM/ESA
6922
6923 =item Configure Perl on VM/ESA
6924
6925 =item Testing Anomalies of Perl on VM/ESA
6926
6927 =item Usage Hints for Perl on VM/ESA
6928
6929 =back
6930
6931 =item AUTHORS
6932
6933 =item SEE ALSO
6934
6935 =over 4
6936
6937 =item Mailing list for Perl on VM/ESA
6938
6939 =back
6940
6941 =back
6942
6943 =head2 perlvms - VMS-specific documentation for Perl
6944
6945 =over 4
6946
6947 =item DESCRIPTION
6948
6949 =item Installation
6950
6951 =item Organization of Perl Images
6952
6953 =over 4
6954
6955 =item Core Images
6956
6957 =item Perl Extensions
6958
6959 =item Installing static extensions
6960
6961 =item Installing dynamic extensions
6962
6963 =back
6964
6965 =item File specifications
6966
6967 =over 4
6968
6969 =item Syntax
6970
6971 =item Wildcard expansion
6972
6973 =item Pipes
6974
6975 =back
6976
6977 =item PERL5LIB and PERLLIB
6978
6979 =item Command line
6980
6981 =over 4
6982
6983 =item I/O redirection and backgrounding
6984
6985 =item Command line switches
6986
6987 -i, -S, -u
6988
6989 =back
6990
6991 =item Perl functions
6992
6993 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
6994 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
6995 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
6996 LIST, waitpid PID,FLAGS
6997
6998 =item Perl variables
6999
7000 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
7001
7002 =item Standard modules with VMS-specific differences
7003
7004 =over 4
7005
7006 =item SDBM_File
7007
7008 =back
7009
7010 =item Revision date
7011
7012 =item AUTHOR
7013
7014 =back
7015
7016 =head2 perlvos, README.vos - Perl for Stratus VOS
7017
7018 =over 4
7019
7020 =item SYNOPSIS
7021
7022 =over 4
7023
7024 =item Stratus POSIX Support
7025
7026 =back
7027
7028 =item INSTALLING PERL IN VOS
7029
7030 =over 4
7031
7032 =item Compiling Perl 5 on VOS
7033
7034 =item Installing Perl 5 on VOS
7035
7036 =back
7037
7038 =item USING PERL IN VOS
7039
7040 =over 4
7041
7042 =item Unimplemented Features of Perl on VOS
7043
7044 =item Restrictions of Perl on VOS
7045
7046 =back
7047
7048 =item SUPPORT STATUS
7049
7050 =item AUTHOR
7051
7052 =item LAST UPDATE
7053
7054 =back
7055
7056 =head1 PRAGMA DOCUMENTATION
7057
7058 =head2 attrs - set/get attributes of a subroutine (deprecated)
7059
7060 =over 4
7061
7062 =item SYNOPSIS
7063
7064 =item DESCRIPTION
7065
7066 method, locked
7067
7068 =back
7069
7070 =head2 re - Perl pragma to alter regular expression behaviour
7071
7072 =over 4
7073
7074 =item SYNOPSIS
7075
7076 =item DESCRIPTION
7077
7078 =back
7079
7080 =head2 threads - Perl extension allowing use of interpreter based threads
7081 from perl
7082
7083 =over 4
7084
7085 =item SYNOPSIS
7086
7087 =item DESCRIPTION
7088
7089 new, function, LIST, $threads->join, $threads->detach, threads->self,
7090 $threads->tid
7091
7092 =item TODO
7093
7094 Fix so the return value is returned when you join, Add join_all, Fix memory
7095 leaks!
7096
7097 =item AUTHOR and COPYRIGHT
7098
7099 =item BUGS
7100
7101 creating a thread from within a thread is unsafe under win32,
7102 PERL_OLD_SIGNALS are not threadsafe, will not be
7103
7104 =item SEE ALSO
7105
7106 =back
7107
7108 =head2 attributes - get/set subroutine or variable attributes
7109
7110 =over 4
7111
7112 =item SYNOPSIS
7113
7114 =item DESCRIPTION
7115
7116 =over 4
7117
7118 =item Built-in Attributes
7119
7120 locked, method, lvalue
7121
7122 =item Available Subroutines
7123
7124 get, reftype
7125
7126 =item Package-specific Attribute Handling
7127
7128 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
7129
7130 =item Syntax of Attribute Lists
7131
7132 =back
7133
7134 =item EXPORTS
7135
7136 =over 4
7137
7138 =item Default exports
7139
7140 =item Available exports
7141
7142 =item Export tags defined
7143
7144 =back
7145
7146 =item EXAMPLES
7147
7148 =item SEE ALSO
7149
7150 =back
7151
7152 =head2 attrs - set/get attributes of a subroutine (deprecated)
7153
7154 =over 4
7155
7156 =item SYNOPSIS
7157
7158 =item DESCRIPTION
7159
7160 method, locked
7161
7162 =back
7163
7164 =head2 autouse - postpone load of modules until a function is used
7165
7166 =over 4
7167
7168 =item SYNOPSIS
7169
7170 =item DESCRIPTION
7171
7172 =item WARNING
7173
7174 =item AUTHOR
7175
7176 =item SEE ALSO
7177
7178 =back
7179
7180 =head2 base - Establish IS-A relationship with base class at compile time
7181
7182 =over 4
7183
7184 =item SYNOPSIS
7185
7186 =item DESCRIPTION
7187
7188 =item HISTORY
7189
7190 =item SEE ALSO
7191
7192 =back
7193
7194 =head2 blib - Use MakeMaker's uninstalled version of a package
7195
7196 =over 4
7197
7198 =item SYNOPSIS
7199
7200 =item DESCRIPTION
7201
7202 =item BUGS
7203
7204 =item AUTHOR
7205
7206 =back
7207
7208 =head2 bytes - Perl pragma to force byte semantics rather than character
7209 semantics
7210
7211 =over 4
7212
7213 =item SYNOPSIS
7214
7215 =item DESCRIPTION
7216
7217 =item SEE ALSO
7218
7219 =back
7220
7221 =head2 charnames - define character names for C<\N{named}> string literal
7222 escape.
7223
7224 =over 4
7225
7226 =item SYNOPSIS
7227
7228 =item DESCRIPTION
7229
7230 =item CUSTOM TRANSLATORS
7231
7232 =item BUGS
7233
7234 =back
7235
7236 =head2 constant - Perl pragma to declare constants
7237
7238 =over 4
7239
7240 =item SYNOPSIS
7241
7242 =item DESCRIPTION
7243
7244 =item NOTES
7245
7246 =over 4
7247
7248 =item List constants
7249
7250 =item Defining multiple constants at once
7251
7252 =item Magic constants
7253
7254 =back
7255
7256 =item TECHNICAL NOTES
7257
7258 =item BUGS
7259
7260 =item AUTHOR
7261
7262 =item COPYRIGHT
7263
7264 =back
7265
7266 =head2 diagnostics - Perl compiler pragma to force verbose warning
7267 diagnostics
7268
7269 =over 4
7270
7271 =item SYNOPSIS
7272
7273 =item DESCRIPTION
7274
7275 =over 4
7276
7277 =item The C<diagnostics> Pragma
7278
7279 =item The I<splain> Program
7280
7281 =back
7282
7283 =item EXAMPLES
7284
7285 =item INTERNALS
7286
7287 =item BUGS
7288
7289 =item AUTHOR
7290
7291 =back
7292
7293 =head2 fields - compile-time class fields
7294
7295 =over 4
7296
7297 =item SYNOPSIS
7298
7299 =item DESCRIPTION
7300
7301 new, phash
7302
7303 =item SEE ALSO
7304
7305 =back
7306
7307 =head2 filetest - Perl pragma to control the filetest permission operators
7308
7309 =over 4
7310
7311 =item SYNOPSIS
7312
7313 =item DESCRIPTION
7314
7315 =over 4
7316
7317 =item subpragma access
7318
7319 =back
7320
7321 =back
7322
7323 =head2 integer - Perl pragma to use integer arithmetic instead of floating
7324 point
7325
7326 =over 4
7327
7328 =item SYNOPSIS
7329
7330 =item DESCRIPTION
7331
7332 =back
7333
7334 =head2 less - perl pragma to request less of something from the compiler
7335
7336 =over 4
7337
7338 =item SYNOPSIS
7339
7340 =item DESCRIPTION
7341
7342 =back
7343
7344 =head2 lib - manipulate @INC at compile time
7345
7346 =over 4
7347
7348 =item SYNOPSIS
7349
7350 =item DESCRIPTION
7351
7352 =over 4
7353
7354 =item Adding directories to @INC
7355
7356 =item Deleting directories from @INC
7357
7358 =item Restoring original @INC
7359
7360 =back
7361
7362 =item SEE ALSO
7363
7364 =item AUTHOR
7365
7366 =back
7367
7368 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
7369 operations
7370
7371 =over 4
7372
7373 =item SYNOPSIS
7374
7375 =item DESCRIPTION
7376
7377 =back
7378
7379 =head2 open - perl pragma to set default disciplines for input and output
7380
7381 =over 4
7382
7383 =item SYNOPSIS
7384
7385 =item DESCRIPTION
7386
7387 =item NONPERLIO FUNCTIONALITY
7388
7389 =item IMPLEMENTATION DETAILS
7390
7391 =item SEE ALSO
7392
7393 =back
7394
7395 =head2 ops - Perl pragma to restrict unsafe operations when compiling
7396
7397 =over 4
7398
7399 =item SYNOPSIS
7400
7401 =item DESCRIPTION
7402
7403 =item SEE ALSO
7404
7405 =back
7406
7407 =head2 overload - Package for overloading perl operations
7408
7409 =over 4
7410
7411 =item SYNOPSIS
7412
7413 =item DESCRIPTION
7414
7415 =over 4
7416
7417 =item Declaration of overloaded functions
7418
7419 =item Calling Conventions for Binary Operations
7420
7421 FALSE, TRUE, C<undef>
7422
7423 =item Calling Conventions for Unary Operations
7424
7425 =item Calling Conventions for Mutators
7426
7427 C<++> and C<-->, C<x=> and other assignment versions
7428
7429 =item Overloadable Operations
7430
7431 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
7432 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
7433 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
7434
7435 =item Inheritance and overloading
7436
7437 Strings as values of C<use overload> directive, Overloading of an operation
7438 is inherited by derived classes
7439
7440 =back
7441
7442 =item SPECIAL SYMBOLS FOR C<use overload>
7443
7444 =over 4
7445
7446 =item Last Resort
7447
7448 =item Fallback
7449
7450 C<undef>, TRUE, defined, but FALSE
7451
7452 =item Copy Constructor
7453
7454 B<Example>
7455
7456 =back
7457
7458 =item MAGIC AUTOGENERATION
7459
7460 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
7461 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
7462 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
7463 I<Copy operator>
7464
7465 =item Losing overloading
7466
7467 =item Run-time Overloading
7468
7469 =item Public functions
7470
7471 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
7472
7473 =item Overloading constants
7474
7475 integer, float, binary, q, qr
7476
7477 =item IMPLEMENTATION
7478
7479 =item Metaphor clash
7480
7481 =item Cookbook
7482
7483 =over 4
7484
7485 =item Two-face scalars
7486
7487 =item Two-face references
7488
7489 =item Symbolic calculator
7490
7491 =item I<Really> symbolic calculator
7492
7493 =back
7494
7495 =item AUTHOR
7496
7497 =item DIAGNOSTICS
7498
7499 Odd number of arguments for overload::constant, `%s' is not an overloadable
7500 type, `%s' is not a code reference
7501
7502 =item BUGS
7503
7504 =back
7505
7506 =head2 re - Perl pragma to alter regular expression behaviour
7507
7508 =over 4
7509
7510 =item SYNOPSIS
7511
7512 =item DESCRIPTION
7513
7514 =back
7515
7516 =head2 sigtrap - Perl pragma to enable simple signal handling
7517
7518 =over 4
7519
7520 =item SYNOPSIS
7521
7522 =item DESCRIPTION
7523
7524 =item OPTIONS
7525
7526 =over 4
7527
7528 =item SIGNAL HANDLERS
7529
7530 B<stack-trace>, B<die>, B<handler> I<your-handler>
7531
7532 =item SIGNAL LISTS
7533
7534 B<normal-signals>, B<error-signals>, B<old-interface-signals>
7535
7536 =item OTHER
7537
7538 B<untrapped>, B<any>, I<signal>, I<number>
7539
7540 =back
7541
7542 =item EXAMPLES
7543
7544 =back
7545
7546 =head2 strict - Perl pragma to restrict unsafe constructs
7547
7548 =over 4
7549
7550 =item SYNOPSIS
7551
7552 =item DESCRIPTION
7553
7554 C<strict refs>, C<strict vars>, C<strict subs>
7555
7556 =back
7557
7558 =head2 subs - Perl pragma to predeclare sub names
7559
7560 =over 4
7561
7562 =item SYNOPSIS
7563
7564 =item DESCRIPTION
7565
7566 =back
7567
7568 =head2 threads - Perl extension allowing use of interpreter based threads
7569 from perl
7570
7571 =over 4
7572
7573 =item SYNOPSIS
7574
7575 =item DESCRIPTION
7576
7577 new, function, LIST, $threads->join, $threads->detach, threads->self,
7578 $threads->tid
7579
7580 =item TODO
7581
7582 Fix so the return value is returned when you join, Add join_all, Fix memory
7583 leaks!
7584
7585 =item AUTHOR and COPYRIGHT
7586
7587 =item BUGS
7588
7589 creating a thread from within a thread is unsafe under win32,
7590 PERL_OLD_SIGNALS are not threadsafe, will not be
7591
7592 =item SEE ALSO
7593
7594 =back
7595
7596 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
7597 code
7598
7599 =over 4
7600
7601 =item SYNOPSIS
7602
7603 =item DESCRIPTION
7604
7605 =over 4
7606
7607 =item Utility functions
7608
7609 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
7610 utf8::encode($string), $flag = utf8::decode($string)
7611
7612 =back
7613
7614 =item SEE ALSO
7615
7616 =back
7617
7618 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
7619
7620 =over 4
7621
7622 =item SYNOPSIS
7623
7624 =item DESCRIPTION
7625
7626 =back
7627
7628 =head2 warnings - Perl pragma to control optional warnings
7629
7630 =over 4
7631
7632 =item SYNOPSIS
7633
7634 =item DESCRIPTION
7635
7636 use warnings::register, warnings::enabled(), warnings::enabled($category),
7637 warnings::enabled($object), warnings::warn($message),
7638 warnings::warn($category, $message), warnings::warn($object, $message),
7639 warnings::warnif($message), warnings::warnif($category, $message),
7640 warnings::warnif($object, $message)
7641
7642 =back
7643
7644 =head2 warnings::register - warnings import function
7645
7646 =over 4
7647
7648 =item SYNOPSIS
7649
7650 =item DESCRIPTION
7651
7652 =back
7653
7654 =head1 MODULE DOCUMENTATION
7655
7656 =head2 AnyDBM_File - provide framework for multiple DBMs
7657
7658 =over 4
7659
7660 =item SYNOPSIS
7661
7662 =item DESCRIPTION
7663
7664 =over 4
7665
7666 =item DBM Comparisons
7667
7668 [0], [1], [2], [3]
7669
7670 =back
7671
7672 =item SEE ALSO
7673
7674 =back
7675
7676 =head2 Attribute::Handlers - Simpler definition of attribute handlers
7677
7678 =over 4
7679
7680 =item VERSION
7681
7682 =item SYNOPSIS
7683
7684 =item DESCRIPTION
7685
7686 [0], [1], [2], [3], [4], [5]
7687
7688 =over 4
7689
7690 =item Typed lexicals
7691
7692 =item Type-specific attribute handlers
7693
7694 =item Non-interpretive attribute handlers
7695
7696 =item Phase-specific attribute handlers
7697
7698 =item Attributes as C<tie> interfaces
7699
7700 =back
7701
7702 =item EXAMPLES
7703
7704 =item DIAGNOSTICS
7705
7706 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
7707 attributes>, C<Declaration of %s attribute in package %s may clash with
7708 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
7709 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>
7710
7711 =item AUTHOR
7712
7713 =item BUGS
7714
7715 =item COPYRIGHT
7716
7717 =back
7718
7719 =head2 AutoLoader - load subroutines only on demand
7720
7721 =over 4
7722
7723 =item SYNOPSIS
7724
7725 =item DESCRIPTION
7726
7727 =over 4
7728
7729 =item Subroutine Stubs
7730
7731 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
7732
7733 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
7734
7735 =item Package Lexicals
7736
7737 =item Not Using AutoLoader
7738
7739 =item B<AutoLoader> vs. B<SelfLoader>
7740
7741 =back
7742
7743 =item CAVEATS
7744
7745 =item SEE ALSO
7746
7747 =back
7748
7749 =head2 AutoSplit - split a package for autoloading
7750
7751 =over 4
7752
7753 =item SYNOPSIS
7754
7755 =item DESCRIPTION
7756
7757 $keep, $check, $modtime
7758
7759 =over 4
7760
7761 =item Multiple packages
7762
7763 =back
7764
7765 =item DIAGNOSTICS
7766
7767 =back
7768
7769 =head2 B - The Perl Compiler
7770
7771 =over 4
7772
7773 =item SYNOPSIS
7774
7775 =item DESCRIPTION
7776
7777 =item OVERVIEW OF CLASSES
7778
7779 =over 4
7780
7781 =item SV-RELATED CLASSES
7782
7783 =item B::SV METHODS
7784
7785 REFCNT, FLAGS
7786
7787 =item B::IV METHODS
7788
7789 IV, IVX, UVX, int_value, needs64bits, packiv
7790
7791 =item B::NV METHODS
7792
7793 NV, NVX
7794
7795 =item B::RV METHODS
7796
7797 RV
7798
7799 =item B::PV METHODS
7800
7801 PV, PVX
7802
7803 =item B::PVMG METHODS
7804
7805 MAGIC, SvSTASH
7806
7807 =item B::MAGIC METHODS
7808
7809 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
7810
7811 =item B::PVLV METHODS
7812
7813 TARGOFF, TARGLEN, TYPE, TARG
7814
7815 =item B::BM METHODS
7816
7817 USEFUL, PREVIOUS, RARE, TABLE
7818
7819 =item B::GV METHODS
7820
7821 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
7822 LINE, FILE, FILEGV, GvREFCNT, FLAGS
7823
7824 =item B::IO METHODS
7825
7826 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
7827 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
7828
7829 =item B::AV METHODS
7830
7831 FILL, MAX, OFF, ARRAY, AvFLAGS
7832
7833 =item B::CV METHODS
7834
7835 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
7836 CvFLAGS, const_sv
7837
7838 =item B::HV METHODS
7839
7840 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
7841
7842 =item OP-RELATED CLASSES
7843
7844 =item B::OP METHODS
7845
7846 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
7847
7848 =item B::UNOP METHOD
7849
7850 first
7851
7852 =item B::BINOP METHOD
7853
7854 last
7855
7856 =item B::LOGOP METHOD
7857
7858 other
7859
7860 =item B::LISTOP METHOD
7861
7862 children
7863
7864 =item B::PMOP METHODS
7865
7866 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
7867
7868 =item B::SVOP METHOD
7869
7870 sv, gv
7871
7872 =item B::PADOP METHOD
7873
7874 padix
7875
7876 =item B::PVOP METHOD
7877
7878 pv
7879
7880 =item B::LOOP METHODS
7881
7882 redoop, nextop, lastop
7883
7884 =item B::COP METHODS
7885
7886 label, stash, file, cop_seq, arybase, line
7887
7888 =back
7889
7890 =item FUNCTIONS EXPORTED BY C<B>
7891
7892 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
7893 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
7894 walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV),
7895 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ),
7896 threadsv_names
7897
7898 =item AUTHOR
7899
7900 =back
7901
7902 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
7903 bytecode
7904
7905 =over 4
7906
7907 =item SYNOPSIS
7908
7909 =item DESCRIPTION
7910
7911 =item AUTHOR
7912
7913 =back
7914
7915 =head2 B::Assembler - Assemble Perl bytecode
7916
7917 =over 4
7918
7919 =item SYNOPSIS
7920
7921 =item DESCRIPTION
7922
7923 =item AUTHORS
7924
7925 =back
7926
7927 =head2 B::Bblock - Walk basic blocks
7928
7929 =over 4
7930
7931 =item SYNOPSIS
7932
7933 =item DESCRIPTION
7934
7935 =item AUTHOR
7936
7937 =back
7938
7939 =head2 B::Bytecode - Perl compiler's bytecode backend
7940
7941 =over 4
7942
7943 =item SYNOPSIS
7944
7945 =item DESCRIPTION
7946
7947 =item OPTIONS
7948
7949 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
7950 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
7951 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
7952
7953 =item EXAMPLES
7954
7955 =item BUGS
7956
7957 =item AUTHORS
7958
7959 =back
7960
7961 =head2 B::C - Perl compiler's C backend
7962
7963 =over 4
7964
7965 =item SYNOPSIS
7966
7967 =item DESCRIPTION
7968
7969 =item OPTIONS
7970
7971 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
7972 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
7973
7974 =item EXAMPLES
7975
7976 =item BUGS
7977
7978 =item AUTHOR
7979
7980 =back
7981
7982 =head2 B::CC - Perl compiler's optimized C translation backend
7983
7984 =over 4
7985
7986 =item SYNOPSIS
7987
7988 =item DESCRIPTION
7989
7990 =item OPTIONS
7991
7992 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
7993 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
7994 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
7995
7996 =item EXAMPLES
7997
7998 =item BUGS
7999
8000 =item DIFFERENCES
8001
8002 =over 4
8003
8004 =item Loops
8005
8006 =item Context of ".."
8007
8008 =item Arithmetic
8009
8010 =item Deprecated features
8011
8012 =back
8013
8014 =item AUTHOR
8015
8016 =back
8017
8018 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
8019
8020 =over 4
8021
8022 =item SYNOPSIS
8023
8024 =item DESCRIPTION
8025
8026 =item OPTIONS
8027
8028 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
8029 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
8030 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
8031
8032 =item FORMATTING SPECIFICATIONS
8033
8034 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
8035 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
8036 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
8037 B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
8038 B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>,
8039 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
8040 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
8041 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
8042
8043 =item ABBREVIATIONS
8044
8045 =over 4
8046
8047 =item OP flags abbreviations
8048
8049 =item OP class abbreviations
8050
8051 =back
8052
8053 =item Using B::Concise outside of the O framework
8054
8055 =item AUTHOR
8056
8057 =back
8058
8059 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
8060
8061 =over 4
8062
8063 =item SYNOPSIS
8064
8065 =item DESCRIPTION
8066
8067 =item AUTHOR
8068
8069 =back
8070
8071 =head2 B::Deparse - Perl compiler backend to produce perl code
8072
8073 =over 4
8074
8075 =item SYNOPSIS
8076
8077 =item DESCRIPTION
8078
8079 =item OPTIONS
8080
8081 B<-l>, B<-p>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
8082 B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
8083
8084 =item USING B::Deparse AS A MODULE
8085
8086 =over 4
8087
8088 =item Synopsis
8089
8090 =item Description
8091
8092 =item new
8093
8094 =item ambient_pragmas
8095
8096 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
8097
8098 =item coderef2text
8099
8100 =back
8101
8102 =item BUGS
8103
8104 =item AUTHOR
8105
8106 =back
8107
8108 =head2 B::Disassembler - Disassemble Perl bytecode
8109
8110 =over 4
8111
8112 =item SYNOPSIS
8113
8114 =item DESCRIPTION
8115
8116 =item AUTHOR
8117
8118 =back
8119
8120 =head2 B::Lint - Perl lint
8121
8122 =over 4
8123
8124 =item SYNOPSIS
8125
8126 =item DESCRIPTION
8127
8128 =item OPTIONS AND LINT CHECKS
8129
8130 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
8131 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
8132
8133 =item NON LINT-CHECK OPTIONS
8134
8135 B<-u Package>
8136
8137 =item BUGS
8138
8139 =item AUTHOR
8140
8141 =back
8142
8143 =head2 B::O, O - Generic interface to Perl Compiler backends
8144
8145 =over 4
8146
8147 =item SYNOPSIS
8148
8149 =item DESCRIPTION
8150
8151 =item CONVENTIONS
8152
8153 =item IMPLEMENTATION
8154
8155 =item AUTHOR
8156
8157 =back
8158
8159 =head2 B::Showlex - Show lexical variables used in functions or files
8160
8161 =over 4
8162
8163 =item SYNOPSIS
8164
8165 =item DESCRIPTION
8166
8167 =item AUTHOR
8168
8169 =back
8170
8171 =head2 B::Stackobj - Helper module for CC backend
8172
8173 =over 4
8174
8175 =item SYNOPSIS
8176
8177 =item DESCRIPTION
8178
8179 =item AUTHOR
8180
8181 =back
8182
8183 =head2 B::Stash - show what stashes are loaded
8184
8185 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
8186
8187 =over 4
8188
8189 =item SYNOPSIS
8190
8191 =item DESCRIPTION
8192
8193 =item AUTHOR
8194
8195 =back
8196
8197 =head2 B::Xref - Generates cross reference reports for Perl programs
8198
8199 =over 4
8200
8201 =item SYNOPSIS
8202
8203 =item DESCRIPTION
8204
8205 =item OPTIONS
8206
8207 C<-oFILENAME>, C<-r>, C<-D[tO]>
8208
8209 =item BUGS
8210
8211 =item AUTHOR
8212
8213 =back
8214
8215 =head2 Bblock, B::Bblock - Walk basic blocks
8216
8217 =over 4
8218
8219 =item SYNOPSIS
8220
8221 =item DESCRIPTION
8222
8223 =item AUTHOR
8224
8225 =back
8226
8227 =head2 Benchmark - benchmark running times of Perl code
8228
8229 =over 4
8230
8231 =item SYNOPSIS
8232
8233 =item DESCRIPTION
8234
8235 =over 4
8236
8237 =item Methods
8238
8239 new, debug, iters
8240
8241 =item Standard Exports
8242
8243 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
8244 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
8245 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
8246
8247 =item Optional Exports
8248
8249 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
8250 STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
8251 ), enablecache ( ), timesum ( T1, T2 )
8252
8253 =back
8254
8255 =item NOTES
8256
8257 =item EXAMPLES
8258
8259 =item INHERITANCE
8260
8261 =item CAVEATS
8262
8263 =item SEE ALSO
8264
8265 =item AUTHORS
8266
8267 =item MODIFICATION HISTORY
8268
8269 =back
8270
8271 =head2 ByteLoader - load byte compiled perl code
8272
8273 =over 4
8274
8275 =item SYNOPSIS
8276
8277 =item DESCRIPTION
8278
8279 =item AUTHOR
8280
8281 =item SEE ALSO
8282
8283 =back
8284
8285 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
8286
8287 =over 4
8288
8289 =item SYNOPSIS
8290
8291 =item DESCRIPTION
8292
8293 =item OPTIONS
8294
8295 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
8296 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
8297 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
8298
8299 =item EXAMPLES
8300
8301 =item BUGS
8302
8303 =item AUTHORS
8304
8305 =back
8306
8307 =head2 CGI - Simple Common Gateway Interface Class
8308
8309 =over 4
8310
8311 =item SYNOPSIS
8312
8313 =item ABSTRACT
8314
8315 =item DESCRIPTION
8316
8317 =over 4
8318
8319 =item PROGRAMMING STYLE
8320
8321 =item CALLING CGI.PM ROUTINES
8322
8323 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
8324
8325 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
8326
8327 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
8328
8329 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
8330
8331 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
8332
8333 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
8334
8335 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
8336
8337 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
8338
8339 =item DELETING A PARAMETER COMPLETELY:
8340
8341 =item DELETING ALL PARAMETERS:
8342
8343 =item DIRECT ACCESS TO THE PARAMETER LIST:
8344
8345 =item FETCHING THE PARAMETER LIST AS A HASH:
8346
8347 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
8348
8349 =item RETRIEVING CGI ERRORS
8350
8351 =item USING THE FUNCTION-ORIENTED INTERFACE
8352
8353 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
8354 B<:standard>, B<:all>
8355
8356 =item PRAGMAS
8357
8358 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
8359 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
8360 -private_tempfiles
8361
8362 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
8363
8364 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
8365 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
8366 a </UL> tag)
8367
8368 =back
8369
8370 =item GENERATING DYNAMIC DOCUMENTS
8371
8372 =over 4
8373
8374 =item CREATING A STANDARD HTTP HEADER:
8375
8376 =item GENERATING A REDIRECTION HEADER
8377
8378 =item CREATING THE HTML DOCUMENT HEADER
8379
8380 B<Parameters:>, 4, 5, 6..
8381
8382 =item ENDING THE HTML DOCUMENT:
8383
8384 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
8385
8386 =item OBTAINING THE SCRIPT'S URL
8387
8388 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
8389 (B<-query_string>), B<-base>
8390
8391 =item MIXING POST AND URL PARAMETERS
8392
8393 =back
8394
8395 =item CREATING STANDARD HTML ELEMENTS:
8396
8397 =over 4
8398
8399 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
8400
8401 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
8402
8403 =item HTML SHORTCUTS AND LIST INTERPOLATION
8404
8405 =item NON-STANDARD HTML SHORTCUTS
8406
8407 =item AUTOESCAPING HTML
8408
8409 $escaped_string = escapeHTML("unescaped string");, $charset =
8410 charset([$charset]);, $flag = autoEscape([$flag]);
8411
8412 =item PRETTY-PRINTING HTML
8413
8414 =back
8415
8416 =item CREATING FILL-OUT FORMS:
8417
8418 =over 4
8419
8420 =item CREATING AN ISINDEX TAG
8421
8422 =item STARTING AND ENDING A FORM
8423
8424 B<application/x-www-form-urlencoded>, B<multipart/form-data>
8425
8426 =item CREATING A TEXT FIELD
8427
8428 B<Parameters>
8429
8430 =item CREATING A BIG TEXT FIELD
8431
8432 =item CREATING A PASSWORD FIELD
8433
8434 =item CREATING A FILE UPLOAD FIELD
8435
8436 B<Parameters>
8437
8438 =item CREATING A POPUP MENU
8439
8440 =item CREATING A SCROLLING LIST
8441
8442 B<Parameters:>
8443
8444 =item CREATING A GROUP OF RELATED CHECKBOXES
8445
8446 B<Parameters:>
8447
8448 =item CREATING A STANDALONE CHECKBOX
8449
8450 B<Parameters:>
8451
8452 =item CREATING A RADIO BUTTON GROUP
8453
8454 B<Parameters:>
8455
8456 =item CREATING A SUBMIT BUTTON
8457
8458 B<Parameters:>
8459
8460 =item CREATING A RESET BUTTON
8461
8462 =item CREATING A DEFAULT BUTTON
8463
8464 =item CREATING A HIDDEN FIELD
8465
8466 B<Parameters:>
8467
8468 =item CREATING A CLICKABLE IMAGE BUTTON
8469
8470 B<Parameters:>
8471
8472 =item CREATING A JAVASCRIPT ACTION BUTTON
8473
8474 =back
8475
8476 =item HTTP COOKIES
8477
8478 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
8479 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
8480
8481 =item WORKING WITH FRAMES
8482
8483 1. Create a <Frameset> document, 2. Specify the destination for the
8484 document in the HTTP header, 3. Specify the destination for the document in
8485 the <FORM> tag
8486
8487 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
8488
8489 =item DEBUGGING
8490
8491 =over 4
8492
8493 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
8494
8495 =back
8496
8497 =item FETCHING ENVIRONMENT VARIABLES
8498
8499 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
8500 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
8501 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
8502 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
8503 B<request_method()>, B<content_type()>, B<http()>, B<https()>
8504
8505 =item USING NPH SCRIPTS
8506
8507 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
8508 parameters
8509
8510 =item Server Push
8511
8512 multipart_init(), multipart_start(), multipart_end(), multipart_final()
8513
8514 =item Avoiding Denial of Service Attacks
8515
8516 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
8517 basis>, B<2. Globally for all scripts>
8518
8519 =item COMPATIBILITY WITH CGI-LIB.PL
8520
8521 =item AUTHOR INFORMATION
8522
8523 =item CREDITS
8524
8525 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
8526 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
8527 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
8528 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
8529 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
8530 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
8531 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
8532 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
8533 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
8534 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
8535 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
8536 ...and many many more..
8537
8538 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
8539
8540 =item BUGS
8541
8542 =item SEE ALSO
8543
8544 =back
8545
8546 =head2 CGI::Apache - Backward compatibility module for CGI.pm
8547
8548 =over 4
8549
8550 =item SYNOPSIS
8551
8552 =item ABSTRACT
8553
8554 =item DESCRIPTION
8555
8556 =item AUTHOR INFORMATION
8557
8558 =item BUGS
8559
8560 =item SEE ALSO
8561
8562 =back
8563
8564 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
8565 other) error log
8566
8567 =over 4
8568
8569 =item SYNOPSIS
8570
8571 =item DESCRIPTION
8572
8573 =item REDIRECTING ERROR MESSAGES
8574
8575 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
8576
8577 =over 4
8578
8579 =item Changing the default message
8580
8581 =back
8582
8583 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
8584
8585 =item CHANGE LOG
8586
8587 =item AUTHORS
8588
8589 =item SEE ALSO
8590
8591 =back
8592
8593 =head2 CGI::Cookie - Interface to Netscape Cookies
8594
8595 =over 4
8596
8597 =item SYNOPSIS
8598
8599 =item DESCRIPTION
8600
8601 =item USING CGI::Cookie
8602
8603 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
8604
8605 =over 4
8606
8607 =item Creating New Cookies
8608
8609 =item Sending the Cookie to the Browser
8610
8611 =item Recovering Previous Cookies
8612
8613 =item Manipulating Cookies
8614
8615 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
8616
8617 =back
8618
8619 =item AUTHOR INFORMATION
8620
8621 =item BUGS
8622
8623 =item SEE ALSO
8624
8625 =back
8626
8627 =head2 CGI::Fast - CGI Interface for Fast CGI
8628
8629 =over 4
8630
8631 =item SYNOPSIS
8632
8633 =item DESCRIPTION
8634
8635 =item OTHER PIECES OF THE PUZZLE
8636
8637 =item WRITING FASTCGI PERL SCRIPTS
8638
8639 =item INSTALLING FASTCGI SCRIPTS
8640
8641 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
8642
8643 =item EXTERNAL FASTCGI SERVER INVOCATION
8644
8645 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
8646
8647 =item CAVEATS
8648
8649 =item AUTHOR INFORMATION
8650
8651 =item BUGS
8652
8653 =item SEE ALSO
8654
8655 =back
8656
8657 =head2 CGI::Pretty - module to produce nicely formatted HTML code
8658
8659 =over 4
8660
8661 =item SYNOPSIS
8662
8663 =item DESCRIPTION
8664
8665 =over 4
8666
8667 =item Tags that won't be formatted
8668
8669 =item Customizing the Indenting
8670
8671 =back
8672
8673 =item BUGS
8674
8675 =item AUTHOR
8676
8677 =item SEE ALSO
8678
8679 =back
8680
8681 =head2 CGI::Push - Simple Interface to Server Push
8682
8683 =over 4
8684
8685 =item SYNOPSIS
8686
8687 =item DESCRIPTION
8688
8689 =item USING CGI::Push
8690
8691 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
8692
8693 =over 4
8694
8695 =item Heterogeneous Pages
8696
8697 =item Changing the Page Delay on the Fly
8698
8699 =back
8700
8701 =item INSTALLING CGI::Push SCRIPTS
8702
8703 =item AUTHOR INFORMATION
8704
8705 =item BUGS
8706
8707 =item SEE ALSO
8708
8709 =back
8710
8711 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
8712
8713 =over 4
8714
8715 =item SYNOPSIS
8716
8717 =item ABSTRACT
8718
8719 =item DESCRIPTION
8720
8721 =item AUTHOR INFORMATION
8722
8723 =item BUGS
8724
8725 =item SEE ALSO
8726
8727 =back
8728
8729 =head2 CGI::Util - Internal utilities used by CGI module
8730
8731 =over 4
8732
8733 =item SYNOPSIS
8734
8735 =item DESCRIPTION
8736
8737 =item AUTHOR INFORMATION
8738
8739 =item SEE ALSO
8740
8741 =back
8742
8743 =head2 CPAN - query, download and build perl modules from CPAN sites
8744
8745 =over 4
8746
8747 =item SYNOPSIS
8748
8749 =item DESCRIPTION
8750
8751 =over 4
8752
8753 =item Interactive Mode
8754
8755 Searching for authors, bundles, distribution files and modules, make, test,
8756 install, clean  modules or distributions, get, readme, look module or
8757 distribution, ls author, Signals
8758
8759 =item CPAN::Shell
8760
8761 =item autobundle
8762
8763 =item recompile
8764
8765 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
8766
8767 =item Programmer's interface
8768
8769 expand($type,@things), expandany(@things), Programming Examples
8770
8771 =item Methods in the other Classes
8772
8773 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
8774 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
8775 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
8776 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
8777 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
8778 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
8779 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
8780 CPAN::Bundle::readme(), CPAN::Bundle::test(),
8781 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
8782 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
8783 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
8784 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
8785 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
8786 CPAN::Distribution::look(), CPAN::Distribution::make(),
8787 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
8788 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
8789 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
8790 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
8791 CPAN::Module::clean(), CPAN::Module::cpan_file(),
8792 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
8793 CPAN::Module::description(), CPAN::Module::force($method,@args),
8794 CPAN::Module::get(), CPAN::Module::inst_file(),
8795 CPAN::Module::inst_version(), CPAN::Module::install(),
8796 CPAN::Module::look(), CPAN::Module::make(),
8797 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
8798 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
8799
8800 =item Cache Manager
8801
8802 =item Bundles
8803
8804 =item Prerequisites
8805
8806 =item Finding packages and VERSION
8807
8808 =item Debugging
8809
8810 =item Floppy, Zip, Offline Mode
8811
8812 =back
8813
8814 =item CONFIGURATION
8815
8816 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
8817 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
8818 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
8819 [unshift|push|splice] E<lt>listE<gt>>
8820
8821 =over 4
8822
8823 =item Note on urllist parameter's format
8824
8825 =item urllist parameter has CD-ROM support
8826
8827 =back
8828
8829 =item SECURITY
8830
8831 =item EXPORT
8832
8833 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
8834
8835 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
8836
8837 =over 4
8838
8839 =item Three basic types of firewalls
8840
8841 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
8842
8843 =item Configuring lynx or ncftp for going through a firewall
8844
8845 =back
8846
8847 =item FAQ
8848
8849 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
8850
8851 =item BUGS
8852
8853 =item AUTHOR
8854
8855 =item TRANSLATIONS
8856
8857 =item SEE ALSO
8858
8859 =back
8860
8861 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
8862
8863 =over 4
8864
8865 =item SYNOPSIS
8866
8867 =item DESCRIPTION
8868
8869 =back
8870
8871 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
8872 module
8873
8874 =over 4
8875
8876 =item SYNOPSIS
8877
8878 =item DESCRIPTION
8879
8880 =item  SEE ALSO
8881
8882 =back
8883
8884 =head2 Carp, carp    - warn of errors (from perspective of caller)
8885
8886 =over 4
8887
8888 =item SYNOPSIS
8889
8890 =item DESCRIPTION
8891
8892 =over 4
8893
8894 =item Forcing a Stack Trace
8895
8896 =back
8897
8898 =item BUGS
8899
8900 =back
8901
8902 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
8903
8904 =head2 Class::ISA -- report the search path for a class's ISA tree
8905
8906 =over 4
8907
8908 =item SYNOPSIS
8909
8910 =item DESCRIPTION
8911
8912 =item FUNCTIONS
8913
8914 the function Class::ISA::super_path($CLASS), the function
8915 Class::ISA::self_and_super_path($CLASS), the function
8916 Class::ISA::self_and_super_versions($CLASS)
8917
8918 =item CAUTIONARY NOTES
8919
8920 =item COPYRIGHT
8921
8922 =item AUTHOR
8923
8924 =back
8925
8926 =head2 Class::Struct - declare struct-like datatypes as Perl classes
8927
8928 =over 4
8929
8930 =item SYNOPSIS
8931
8932 =item DESCRIPTION
8933
8934 =over 4
8935
8936 =item The C<struct()> function
8937
8938 =item Class Creation at Compile Time
8939
8940 =item Element Types and Accessor Methods
8941
8942 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
8943 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
8944
8945 =item Initializing with C<new>
8946
8947 =back
8948
8949 =item EXAMPLES
8950
8951 Example 1, Example 2, Example 3
8952
8953 =item Author and Modification History
8954
8955 =back
8956
8957 =head2 Config - access Perl configuration information
8958
8959 =over 4
8960
8961 =item SYNOPSIS
8962
8963 =item DESCRIPTION
8964
8965 myconfig(), config_sh(), config_vars(@names)
8966
8967 =item EXAMPLE
8968
8969 =item WARNING
8970
8971 =item GLOSSARY
8972
8973 =over 4
8974
8975 =item _
8976
8977 C<_a>, C<_exe>, C<_o>
8978
8979 =item a
8980
8981 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
8982 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
8983 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
8984 C<awk>
8985
8986 =item b
8987
8988 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
8989 C<byacc>, C<byteorder>
8990
8991 =item c
8992
8993 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
8994 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
8995 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
8996 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
8997 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
8998 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<cryptlib>, C<csh>
8999
9000 =item d
9001
9002 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
9003 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
9004 C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
9005 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
9006 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
9007 C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
9008 C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>,
9009 C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
9010 C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>,
9011 C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
9012 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
9013 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
9014 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
9015 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
9016 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
9017 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
9018 C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>,
9019 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
9020 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getmnt>,
9021 C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
9022 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
9023 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
9024 C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
9025 C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
9026 C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
9027 C<d_htonl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
9028 C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>,
9029 C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>, C<d_lockf>,
9030 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
9031 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
9032 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
9033 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
9034 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
9035 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
9036 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
9037 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
9038 C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>, C<d_off64_t>,
9039 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
9040 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
9041 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
9042 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
9043 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
9044 C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_atfork>, C<d_pthread_yield>,
9045 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
9046 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
9047 C<d_readdir>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
9048 C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
9049 C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
9050 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
9051 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
9052 C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setitimer>,
9053 C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>,
9054 C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>,
9055 C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
9056 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>,
9057 C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>,
9058 C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>,
9059 C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>,
9060 C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
9061 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
9062 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
9063 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
9064 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
9065 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strftime>,
9066 C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>,
9067 C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
9068 C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
9069 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
9070 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
9071 C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
9072 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
9073 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
9074 C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
9075 C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
9076 C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
9077 C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
9078 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
9079 C<doublesize>, C<drand01>, C<dynamic_ext>
9080
9081 =item e
9082
9083 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
9084 C<exe_ext>, C<expr>, C<extensions>, C<extras>
9085
9086 =item f
9087
9088 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
9089 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
9090 C<full_sed>
9091
9092 =item g
9093
9094 C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
9095 C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
9096
9097 =item h
9098
9099 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
9100
9101 =item i
9102
9103 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
9104 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
9105 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_fp>,
9106 C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
9107 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
9108 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
9109 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
9110 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
9111 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
9112 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
9113 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
9114 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
9115 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
9116 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
9117 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
9118 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
9119 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
9120 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
9121 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
9122 C<installman3dir>, C<installprefix>, C<installprefixexp>,
9123 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
9124 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
9125 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
9126 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
9127
9128 =item k
9129
9130 C<known_extensions>, C<ksh>
9131
9132 =item l
9133
9134 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
9135 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
9136 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
9137 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
9138 C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>,
9139 C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
9140
9141 =item m
9142
9143 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
9144 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
9145 C<man3direxp>, C<man3ext>
9146
9147 =item M
9148
9149 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
9150 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
9151
9152 =item n
9153
9154 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
9155 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
9156 C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
9157 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
9158
9159 =item o
9160
9161 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
9162 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
9163
9164 =item p
9165
9166 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
9167 C<perl>, C<perl_patchlevel>
9168
9169 =item P
9170
9171 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
9172 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
9173 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
9174 C<privlibexp>, C<prototype>, C<ptrsize>
9175
9176 =item q
9177
9178 C<quadkind>, C<quadtype>
9179
9180 =item r
9181
9182 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
9183 C<revision>, C<rm>, C<rmail>, C<run>, C<runnm>
9184
9185 =item s
9186
9187 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
9188 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
9189 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
9190 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>,
9191 C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>,
9192 C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
9193 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
9194 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
9195 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
9196 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
9197 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>,
9198 C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
9199 C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
9200 C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
9201
9202 =item t
9203
9204 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
9205 C<timetype>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>
9206
9207 =item u
9208
9209 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
9210 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
9211 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
9212 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
9213 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
9214 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
9215 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
9216 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
9217 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
9218
9219 =item v
9220
9221 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
9222 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
9223 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
9224 C<versiononly>, C<vi>, C<voidflags>
9225
9226 =item x
9227
9228 C<xlibpth>, C<xs_apiversion>
9229
9230 =item y
9231
9232 C<yacc>, C<yaccflags>
9233
9234 =item z
9235
9236 C<zcat>, C<zip>
9237
9238 =back
9239
9240 =item NOTE
9241
9242 =back
9243
9244 =head2 Cwd - get pathname of current working directory
9245
9246 =over 4
9247
9248 =item SYNOPSIS
9249
9250 =item DESCRIPTION
9251
9252 =over 4
9253
9254 =item getcwd and friends
9255
9256 getcwd, cwd, fastcwd, fastgetcwd
9257
9258 =item abs_path and friends
9259
9260 abs_path, realpath, fast_abs_path
9261
9262 =item $ENV{PWD}
9263
9264 =back
9265
9266 =item NOTES
9267
9268 =item SEE ALSO
9269
9270 =back
9271
9272 =head2 DB - programmatic interface to the Perl debugging API (draft,
9273 subject to
9274 change)
9275
9276 =over 4
9277
9278 =item SYNOPSIS
9279
9280 =item DESCRIPTION
9281
9282 =over 4
9283
9284 =item Global Variables
9285
9286  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
9287 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
9288 $DB::lineno
9289
9290 =item API Methods
9291
9292 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
9293 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
9294
9295 =item Client Callback Methods
9296
9297 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
9298 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
9299 CLIENT->output(LIST)
9300
9301 =back
9302
9303 =item BUGS
9304
9305 =item AUTHOR
9306
9307 =back
9308
9309 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
9310
9311 =over 4
9312
9313 =item SYNOPSIS
9314
9315 =item DESCRIPTION
9316
9317 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
9318
9319 =over 4
9320
9321 =item Using DB_File with Berkeley DB version 2 or 3
9322
9323 =item Interface to Berkeley DB
9324
9325 =item Opening a Berkeley DB Database File
9326
9327 =item Default Parameters
9328
9329 =item In Memory Databases
9330
9331 =back
9332
9333 =item DB_HASH
9334
9335 =over 4
9336
9337 =item A Simple Example
9338
9339 =back
9340
9341 =item DB_BTREE
9342
9343 =over 4
9344
9345 =item Changing the BTREE sort order
9346
9347 =item Handling Duplicate Keys
9348
9349 =item The get_dup() Method
9350
9351 =item The find_dup() Method
9352
9353 =item The del_dup() Method
9354
9355 =item Matching Partial Keys
9356
9357 =back
9358
9359 =item DB_RECNO
9360
9361 =over 4
9362
9363 =item The 'bval' Option
9364
9365 =item A Simple Example
9366
9367 =item Extra RECNO Methods
9368
9369 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
9370 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
9371 length, elements);>
9372
9373 =item Another Example
9374
9375 =back
9376
9377 =item THE API INTERFACE
9378
9379 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
9380 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
9381 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
9382 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
9383
9384 =item DBM FILTERS
9385
9386 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
9387 B<filter_fetch_value>
9388
9389 =over 4
9390
9391 =item The Filter
9392
9393 =item An Example -- the NULL termination problem.
9394
9395 =item Another Example -- Key is a C int.
9396
9397 =back
9398
9399 =item HINTS AND TIPS
9400
9401 =over 4
9402
9403 =item Locking: The Trouble with fd
9404
9405 =item Safe ways to lock a database
9406
9407 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
9408
9409 =item Sharing Databases With C Applications
9410
9411 =item The untie() Gotcha
9412
9413 =back
9414
9415 =item COMMON QUESTIONS
9416
9417 =over 4
9418
9419 =item Why is there Perl source in my database?
9420
9421 =item How do I store complex data structures with DB_File?
9422
9423 =item What does "Invalid Argument" mean?
9424
9425 =item What does "Bareword 'DB_File' not allowed" mean?
9426
9427 =back
9428
9429 =item REFERENCES
9430
9431 =item HISTORY
9432
9433 =item BUGS
9434
9435 =item AVAILABILITY
9436
9437 =item COPYRIGHT
9438
9439 =item SEE ALSO
9440
9441 =item AUTHOR
9442
9443 =back
9444
9445 =head2 Data::Dumper - stringified perl data structures, suitable for both
9446 printing and C<eval>
9447
9448 =over 4
9449
9450 =item SYNOPSIS
9451
9452 =item DESCRIPTION
9453
9454 =over 4
9455
9456 =item Methods
9457
9458 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
9459 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
9460 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
9461 I<$OBJ>->Reset
9462
9463 =item Functions
9464
9465 Dumper(I<LIST>)
9466
9467 =item Configuration Variables or Methods
9468
9469 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
9470 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
9471 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
9472 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
9473 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
9474 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
9475 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
9476 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
9477 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
9478 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
9479 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
9480 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
9481 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
9482 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>)
9483
9484 =item Exports
9485
9486 Dumper
9487
9488 =back
9489
9490 =item EXAMPLES
9491
9492 =item BUGS
9493
9494 =item AUTHOR
9495
9496 =item VERSION
9497
9498 =item SEE ALSO
9499
9500 =back
9501
9502 =head2 Devel::DProf - a Perl code profiler
9503
9504 =over 4
9505
9506 =item SYNOPSIS
9507
9508 =item DESCRIPTION
9509
9510 =item PROFILE FORMAT
9511
9512 =item AUTOLOAD
9513
9514 =item ENVIRONMENT
9515
9516 =item BUGS
9517
9518 =item SEE ALSO
9519
9520 =back
9521
9522 =head2 Devel::Peek - A data debugging tool for the XS programmer
9523
9524 =over 4
9525
9526 =item SYNOPSIS
9527
9528 =item DESCRIPTION
9529
9530 =over 4
9531
9532 =item Memory footprint debugging
9533
9534 =back
9535
9536 =item EXAMPLES
9537
9538 =over 4
9539
9540 =item A simple scalar string
9541
9542 =item A simple scalar number
9543
9544 =item A simple scalar with an extra reference
9545
9546 =item A reference to a simple scalar
9547
9548 =item A reference to an array
9549
9550 =item A reference to a hash
9551
9552 =item Dumping a large array or hash
9553
9554 =item A reference to an SV which holds a C pointer
9555
9556 =item A reference to a subroutine
9557
9558 =back
9559
9560 =item EXPORTS
9561
9562 =item BUGS
9563
9564 =item AUTHOR
9565
9566 =item SEE ALSO
9567
9568 =back
9569
9570 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
9571
9572 =over 4
9573
9574 =item SYNOPSIS
9575
9576 =item DESCRIPTION
9577
9578 =back
9579
9580 =head2 Digest:: - Modules that calculate message digests
9581
9582 =over 4
9583
9584 =item SYNOPSIS
9585
9586 =item DESCRIPTION
9587
9588 I<binary>, I<hex>, I<base64>
9589
9590 =item OO INTERFACE
9591
9592 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
9593 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
9594 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
9595
9596 =item SEE ALSO
9597
9598 =item AUTHOR
9599
9600 =back
9601
9602 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
9603
9604 =over 4
9605
9606 =item SYNOPSIS
9607
9608 =item DESCRIPTION
9609
9610 =item FUNCTIONS
9611
9612 md5($data,...), md5_hex($data,...), md5_base64($data,...)
9613
9614 =item METHODS
9615
9616 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
9617 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
9618
9619 =item EXAMPLES
9620
9621 =item SEE ALSO
9622
9623 =item COPYRIGHT
9624
9625 =item AUTHORS
9626
9627 =back
9628
9629 =head2 DirHandle - supply object methods for directory handles
9630
9631 =over 4
9632
9633 =item SYNOPSIS
9634
9635 =item DESCRIPTION
9636
9637 =item NOTES
9638
9639 =back
9640
9641 =head2 Dumpvalue - provides screen dump of Perl data.
9642
9643 =over 4
9644
9645 =item SYNOPSIS
9646
9647 =item DESCRIPTION
9648
9649 =over 4
9650
9651 =item Creation
9652
9653 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
9654 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
9655 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
9656 stopDbSignal
9657
9658 =item Methods
9659
9660 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
9661 veryCompact, set, get
9662
9663 =back
9664
9665 =back
9666
9667 =head2 DynaLoader - Dynamically load C libraries into Perl code
9668
9669 =over 4
9670
9671 =item SYNOPSIS
9672
9673 =item DESCRIPTION
9674
9675 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
9676 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
9677 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
9678 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
9679 bootstrap()
9680
9681 =item AUTHOR
9682
9683 =back
9684
9685 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
9686 Perl code
9687
9688 =over 4
9689
9690 =item SYNOPSIS
9691
9692 =item DESCRIPTION
9693
9694 =item AUTHOR
9695
9696 =back
9697
9698 =head2 Encode - character encodings
9699
9700 =over 4
9701
9702 =item SYNOPSIS
9703
9704 =item DESCRIPTION
9705
9706 =over 4
9707
9708 =item TERMINOLOGY
9709
9710 =back
9711
9712 =item ENCODINGS
9713
9714 =over 4
9715
9716 =item Characteristics of an Encoding
9717
9718 =item Types of Encodings
9719
9720 Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
9721 Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
9722
9723 =item Specifying Encodings
9724
9725 1. By name, 2. As an object
9726
9727 =item Encoding Names
9728
9729 The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry,
9730 The name used by the the organization that defined it
9731
9732 =back
9733
9734 =item PERL ENCODING API
9735
9736 =over 4
9737
9738 =item Generic Encoding Interface
9739
9740 =item Handling Malformed Data
9741
9742 Scheme 1, Scheme 2, Other Schemes
9743
9744 =item UTF-8 / utf8
9745
9746 =item Other Encodings of Unicode
9747
9748 =item Listing available encodings
9749
9750 =item Defining Aliases
9751
9752 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
9753 reference, e.g.:
9754
9755 =item Defining Encodings
9756
9757 =back
9758
9759 =item Encoding and IO
9760
9761 =item Encoding How to ...
9762
9763 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
9764 strings in binary data, Perl/Encode wrappers on non-Unicode XS modules
9765
9766 =item Messing with Perl's Internals
9767
9768 is_utf8(STRING [, CHECK]), valid_utf8(STRING)
9769
9770 =item IMPLEMENTATION CLASSES
9771
9772 -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
9773 -E<gt>decode($octets,$check)
9774
9775 =over 4
9776
9777 =item Compiled Encodings
9778
9779 .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
9780 variants of EBCDIC, symbol and dingbats as used by Tk on X11
9781
9782 =back
9783
9784 =item SEE ALSO
9785
9786 =back
9787
9788 =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
9789 of the Encode extension
9790
9791 =over 4
9792
9793 =item DESCRIPTION
9794
9795 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9796
9797 =item KEYWORDS
9798
9799 =item COPYRIGHT
9800
9801 =back
9802
9803 =head2 Encode::Tcl - Tcl encodings
9804
9805 =head2 EncodeFormat - the format of encoding tables of the Encode extension
9806
9807 =over 4
9808
9809 =item DESCRIPTION
9810
9811 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9812
9813 =item KEYWORDS
9814
9815 =item COPYRIGHT
9816
9817 =back
9818
9819 =head2 English - use nice English (or awk) names for ugly punctuation
9820 variables
9821
9822 =over 4
9823
9824 =item SYNOPSIS
9825
9826 =item DESCRIPTION
9827
9828 =item PERFORMANCE
9829
9830 =back
9831
9832 =head2 Env - perl module that imports environment variables as scalars or
9833 arrays
9834
9835 =over 4
9836
9837 =item SYNOPSIS
9838
9839 =item DESCRIPTION
9840
9841 =item LIMITATIONS
9842
9843 =item AUTHOR
9844
9845 =back
9846
9847 =head2 Errno - System errno constants
9848
9849 =over 4
9850
9851 =item SYNOPSIS
9852
9853 =item DESCRIPTION
9854
9855 =item CAVEATS
9856
9857 =item AUTHOR
9858
9859 =item COPYRIGHT
9860
9861 =back
9862
9863 =head2 Exporter - Implements default import method for modules
9864
9865 =over 4
9866
9867 =item SYNOPSIS
9868
9869 =item DESCRIPTION
9870
9871 =over 4
9872
9873 =item How to Export
9874
9875 =item Selecting What To Export
9876
9877 =item Specialised Import Lists
9878
9879 =item Exporting without using Export's import method
9880
9881 =item Module Version Checking
9882
9883 =item Managing Unknown Symbols
9884
9885 =item Tag Handling Utility Functions
9886
9887 =back
9888
9889 =back
9890
9891 =head2 Exporter::Heavy - Exporter guts
9892
9893 =over 4
9894
9895 =item SYNOPIS
9896
9897 =item DESCRIPTION
9898
9899 =back
9900
9901 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
9902 Makefiles etc.
9903
9904 =over 4
9905
9906 =item SYNOPSIS
9907
9908 =item DESCRIPTION
9909
9910 =back
9911
9912 cat
9913
9914 eqtime src dst
9915
9916 rm_rf files...
9917
9918 rm_f files...
9919
9920 touch files ..
9921
9922 mv source... destination
9923
9924 cp source... destination
9925
9926 chmod mode files..
9927
9928 mkpath directory..
9929
9930 test_f file
9931
9932 =over 4
9933
9934 =item BUGS
9935
9936 =item SEE ALSO
9937
9938 =item AUTHOR
9939
9940 =back
9941
9942 =head2 ExtUtils::Constant - generate XS code to import C header constants
9943
9944 =over 4
9945
9946 =item SYNOPSIS
9947
9948 =item DESCRIPTION
9949
9950 =item USAGE
9951
9952 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
9953
9954 =item FUNCTIONS
9955
9956 =back
9957
9958 C_stringify NAME
9959
9960 constant_types
9961
9962 memEQ_clause NAME, CHECKED_AT, INDENT
9963
9964 assign INDENT, TYPE, PRE, POST, VALUE..
9965
9966 return_clause
9967
9968 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
9969
9970 params WHAT
9971
9972 dump_names
9973
9974 dogfood
9975
9976 C_constant, name, type, value, macro, default, pre, post, def_pre =item
9977 def_post
9978
9979 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
9980
9981 autoload PACKAGE, VERSION, AUTOLOADER
9982
9983 WriteMakefileSnippet
9984
9985 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
9986 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
9987
9988 =over 4
9989
9990 =item AUTHOR
9991
9992 =back
9993
9994 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
9995
9996 =over 4
9997
9998 =item SYNOPSIS
9999
10000 =item DESCRIPTION
10001
10002 =item @EXPORT
10003
10004 =item FUNCTIONS
10005
10006 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
10007 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
10008
10009 =item EXAMPLES
10010
10011 =item SEE ALSO
10012
10013 =item AUTHOR
10014
10015 =back
10016
10017 =head2 ExtUtils::Install - install files from here to there
10018
10019 =over 4
10020
10021 =item SYNOPSIS
10022
10023 =item DESCRIPTION
10024
10025 =back
10026
10027 =head2 ExtUtils::Installed - Inventory management of installed modules
10028
10029 =over 4
10030
10031 =item SYNOPSIS
10032
10033 =item DESCRIPTION
10034
10035 =item USAGE
10036
10037 =item FUNCTIONS
10038
10039 new(), modules(), files(), directories(), directory_tree(), validate(),
10040 packlist(), version()
10041
10042 =item EXAMPLE
10043
10044 =item AUTHOR
10045
10046 =back
10047
10048 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
10049
10050 =over 4
10051
10052 =item SYNOPSIS
10053
10054 =item DESCRIPTION
10055
10056 For static extensions, For dynamic extensions, For dynamic extensions
10057
10058 =over 4
10059
10060 =item EXTRALIBS
10061
10062 =item LDLOADLIBS and LD_RUN_PATH
10063
10064 =item BSLOADLIBS
10065
10066 =back
10067
10068 =item PORTABILITY
10069
10070 =over 4
10071
10072 =item VMS implementation
10073
10074 =item Win32 implementation
10075
10076 =back
10077
10078 =item SEE ALSO
10079
10080 =back
10081
10082 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
10083 ExtUtils::MakeMaker
10084
10085 =over 4
10086
10087 =item SYNOPSIS
10088
10089 =item DESCRIPTION
10090
10091 canonpath, cflags, manifypods, perl_archive
10092
10093 =back
10094
10095 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
10096 ExtUtils::MakeMaker
10097
10098 =over 4
10099
10100 =item SYNOPSIS
10101
10102 =item DESCRIPTION
10103
10104 =back
10105
10106 catfile
10107
10108 constants (o)
10109
10110 static_lib (o)
10111
10112 dynamic_bs (o)
10113
10114 dynamic_lib (o)
10115
10116 canonpath
10117
10118 perl_script
10119
10120 pm_to_blib
10121
10122 test_via_harness (o)
10123
10124 tool_autosplit (override)
10125
10126 tools_other (o)
10127
10128 xs_o (o)
10129
10130 top_targets (o)
10131
10132 htmlifypods (o)
10133
10134 manifypods (o)
10135
10136 dist_ci (o)
10137
10138 dist_core (o)
10139
10140 pasthru (o)
10141
10142 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
10143 ExtUtils::MakeMaker
10144
10145 =over 4
10146
10147 =item SYNOPSIS
10148
10149 =item DESCRIPTION
10150
10151 =item METHODS
10152
10153 =back
10154
10155 perl_archive_after
10156
10157 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
10158
10159 =over 4
10160
10161 =item SYNOPSIS
10162
10163 =item DESCRIPTION
10164
10165 =item METHODS
10166
10167 =over 4
10168
10169 =item Preloaded methods
10170
10171 canonpath
10172
10173 =back
10174
10175 =back
10176
10177 catdir
10178
10179 catfile
10180
10181 curdir
10182
10183 rootdir
10184
10185 updir
10186
10187 =over 4
10188
10189 =item SelfLoaded methods
10190
10191 c_o (o)
10192
10193 =back
10194
10195 cflags (o)
10196
10197 clean (o)
10198
10199 const_cccmd (o)
10200
10201 const_config (o)
10202
10203 const_loadlibs (o)
10204
10205 constants (o)
10206
10207 depend (o)
10208
10209 dir_target (o)
10210
10211 dist (o)
10212
10213 dist_basics (o)
10214
10215 dist_ci (o)
10216
10217 dist_core (o)
10218
10219 dist_dir (o)
10220
10221 dist_test (o)
10222
10223 dlsyms (o)
10224
10225 dynamic (o)
10226
10227 dynamic_bs (o)
10228
10229 dynamic_lib (o)
10230
10231 exescan
10232
10233 extliblist
10234
10235 file_name_is_absolute
10236
10237 find_perl
10238
10239 =over 4
10240
10241 =item Methods to actually produce chunks of text for the Makefile
10242
10243 fixin
10244
10245 =back
10246
10247 force (o)
10248
10249 guess_name
10250
10251 has_link_code
10252
10253 htmlifypods (o)
10254
10255 init_dirscan
10256
10257 init_main
10258
10259 init_others
10260
10261 install (o)
10262
10263 installbin (o)
10264
10265 libscan (o)
10266
10267 linkext (o)
10268
10269 lsdir
10270
10271 macro (o)
10272
10273 makeaperl (o)
10274
10275 makefile (o)
10276
10277 manifypods (o)
10278
10279 maybe_command
10280
10281 maybe_command_in_dirs
10282
10283 needs_linking (o)
10284
10285 nicetext
10286
10287 parse_version
10288
10289 parse_abstract
10290
10291 pasthru (o)
10292
10293 path
10294
10295 perl_script
10296
10297 perldepend (o)
10298
10299 ppd
10300
10301 perm_rw (o)
10302
10303 perm_rwx (o)
10304
10305 pm_to_blib
10306
10307 post_constants (o)
10308
10309 post_initialize (o)
10310
10311 postamble (o)
10312
10313 prefixify
10314
10315 processPL (o)
10316
10317 realclean (o)
10318
10319 replace_manpage_separator
10320
10321 static (o)
10322
10323 static_lib (o)
10324
10325 staticmake (o)
10326
10327 subdir_x (o)
10328
10329 subdirs (o)
10330
10331 test (o)
10332
10333 test_via_harness (o)
10334
10335 test_via_script (o)
10336
10337 tool_autosplit (o)
10338
10339 tools_other (o)
10340
10341 tool_xsubpp (o)
10342
10343 top_targets (o)
10344
10345 writedoc
10346
10347 xs_c (o)
10348
10349 xs_cpp (o)
10350
10351 xs_o (o)
10352
10353 perl_archive
10354
10355 perl_archive_after
10356
10357 export_list
10358
10359 =over 4
10360
10361 =item SEE ALSO
10362
10363 =back
10364
10365 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
10366 ExtUtils::MakeMaker
10367
10368 =over 4
10369
10370 =item SYNOPSIS
10371
10372 =item DESCRIPTION
10373
10374 =over 4
10375
10376 =item Methods always loaded
10377
10378 wraplist
10379
10380 =back
10381
10382 =back
10383
10384 rootdir (override)
10385
10386 =over 4
10387
10388 =item SelfLoaded methods
10389
10390 guess_name (override)
10391
10392 =back
10393
10394 find_perl (override)
10395
10396 path (override)
10397
10398 maybe_command (override)
10399
10400 maybe_command_in_dirs (override)
10401
10402 perl_script (override)
10403
10404 file_name_is_absolute (override)
10405
10406 replace_manpage_separator
10407
10408 init_others (override)
10409
10410 constants (override)
10411
10412 cflags (override)
10413
10414 const_cccmd (override)
10415
10416 pm_to_blib (override)
10417
10418 tool_autosplit (override)
10419
10420 tool_sxubpp (override)
10421
10422 xsubpp_version (override)
10423
10424 tools_other (override)
10425
10426 dist (override)
10427
10428 c_o (override)
10429
10430 xs_c (override)
10431
10432 xs_o (override)
10433
10434 top_targets (override)
10435
10436 dlsyms (override)
10437
10438 dynamic_lib (override)
10439
10440 dynamic_bs (override)
10441
10442 static_lib (override)
10443
10444 manifypods (override)
10445
10446 processPL (override)
10447
10448 installbin (override)
10449
10450 subdir_x (override)
10451
10452 clean (override)
10453
10454 realclean (override)
10455
10456 dist_basics (override)
10457
10458 dist_core (override)
10459
10460 dist_dir (override)
10461
10462 dist_test (override)
10463
10464 install (override)
10465
10466 perldepend (override)
10467
10468 makefile (override)
10469
10470 test (override)
10471
10472 test_via_harness (override)
10473
10474 test_via_script (override)
10475
10476 makeaperl (override)
10477
10478 nicetext (override)
10479
10480 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
10481 ExtUtils::MakeMaker
10482
10483 =over 4
10484
10485 =item SYNOPSIS
10486
10487 =item DESCRIPTION
10488
10489 =back
10490
10491 catfile
10492
10493 constants (o)
10494
10495 static_lib (o)
10496
10497 dynamic_bs (o)
10498
10499 dynamic_lib (o)
10500
10501 canonpath
10502
10503 perl_script
10504
10505 pm_to_blib
10506
10507 test_via_harness (o)
10508
10509 tool_autosplit (override)
10510
10511 tools_other (o)
10512
10513 xs_o (o)
10514
10515 top_targets (o)
10516
10517 htmlifypods (o)
10518
10519 manifypods (o)
10520
10521 dist_ci (o)
10522
10523 dist_core (o)
10524
10525 pasthru (o)
10526
10527 =head2 ExtUtils::MakeMaker - create an extension Makefile
10528
10529 =over 4
10530
10531 =item SYNOPSIS
10532
10533 =item DESCRIPTION
10534
10535 =over 4
10536
10537 =item How To Write A Makefile.PL
10538
10539 =item Default Makefile Behaviour
10540
10541 =item make test
10542
10543 =item make testdb
10544
10545 =item make install
10546
10547 =item PREFIX and LIB attribute
10548
10549 =item AFS users
10550
10551 =item Static Linking of a new Perl Binary
10552
10553 =item Determination of Perl Library and Installation Locations
10554
10555 =item Which architecture dependent directory?
10556
10557 =item Using Attributes and Parameters
10558
10559 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
10560 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
10561 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
10562 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
10563 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
10564 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
10565 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
10566 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
10567 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
10568 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
10569 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE,
10570 PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW,
10571 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
10572 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, SKIP, TEST_LIBS,
10573 VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
10574
10575 =item Additional lowercase attributes
10576
10577 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
10578 tool_autosplit
10579
10580 =item Overriding MakeMaker Methods
10581
10582 =item Hintsfile support
10583
10584 =item Distribution Support
10585
10586    make distcheck,    make skipcheck,    make distclean,    make manifest,
10587   make distdir,    make tardist,    make dist,    make uutardist,    make
10588 shdist,    make zipdist,    make ci
10589
10590 =item Disabling an extension
10591
10592 =back
10593
10594 =item ENVIRONMENT
10595
10596 PERL_MM_OPT
10597
10598 =item SEE ALSO
10599
10600 =item AUTHORS
10601
10602 =back
10603
10604 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
10605
10606 =over 4
10607
10608 =item SYNOPSIS
10609
10610 =item DESCRIPTION
10611
10612 =item MANIFEST.SKIP
10613
10614 =item EXPORT_OK
10615
10616 =item GLOBAL VARIABLES
10617
10618 =item DIAGNOSTICS
10619
10620 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
10621 C<Added to MANIFEST:> I<file>
10622
10623 =item ENVIRONMENT
10624
10625 B<PERL_MM_MANIFEST_DEBUG>
10626
10627 =item SEE ALSO
10628
10629 =item AUTHOR
10630
10631 =back
10632
10633 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
10634
10635 =over 4
10636
10637 =item SYNOPSIS
10638
10639 =item DESCRIPTION
10640
10641 =item SEE ALSO
10642
10643 =back
10644
10645 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
10646
10647 =over 4
10648
10649 =item SYNOPSIS
10650
10651 =item DESCRIPTION
10652
10653 =back
10654
10655 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
10656 extension
10657
10658 =over 4
10659
10660 =item SYNOPSIS
10661
10662 =item DESCRIPTION
10663
10664 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
10665
10666 =item AUTHOR
10667
10668 =item REVISION
10669
10670 =back
10671
10672 =head2 ExtUtils::Packlist - manage .packlist files
10673
10674 =over 4
10675
10676 =item SYNOPSIS
10677
10678 =item DESCRIPTION
10679
10680 =item USAGE
10681
10682 =item FUNCTIONS
10683
10684 new(), read(), write(), validate(), packlist_file()
10685
10686 =item EXAMPLE
10687
10688 =item AUTHOR
10689
10690 =back
10691
10692 =head2 ExtUtils::testlib - add blib/* directories to @INC
10693
10694 =over 4
10695
10696 =item SYNOPSIS
10697
10698 =item DESCRIPTION
10699
10700 =back
10701
10702 =head2 Fatal - replace functions with equivalents which succeed or die
10703
10704 =over 4
10705
10706 =item SYNOPSIS
10707
10708 =item DESCRIPTION
10709
10710 =item AUTHOR
10711
10712 =back
10713
10714 =head2 Fcntl - load the C Fcntl.h defines
10715
10716 =over 4
10717
10718 =item SYNOPSIS
10719
10720 =item DESCRIPTION
10721
10722 =item NOTE
10723
10724 =item EXPORTED SYMBOLS
10725
10726 =back
10727
10728 =head2 File::Basename, fileparse - split a pathname into pieces
10729
10730 =over 4
10731
10732 =item SYNOPSIS
10733
10734 =item DESCRIPTION
10735
10736 fileparse_set_fstype, fileparse
10737
10738 =item EXAMPLES
10739
10740 C<basename>, C<dirname>
10741
10742 =back
10743
10744 =head2 File::CheckTree, validate - run many filetest checks on a tree
10745
10746 =over 4
10747
10748 =item SYNOPSIS
10749
10750 =item DESCRIPTION
10751
10752 =back
10753
10754 =head2 File::Compare - Compare files or filehandles
10755
10756 =over 4
10757
10758 =item SYNOPSIS
10759
10760 =item DESCRIPTION
10761
10762 =item RETURN
10763
10764 =item AUTHOR
10765
10766 =back
10767
10768 =head2 File::Copy - Copy files or filehandles
10769
10770 =over 4
10771
10772 =item SYNOPSIS
10773
10774 =item DESCRIPTION
10775
10776 =over 4
10777
10778 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
10779
10780 rmscopy($from,$to[,$date_flag])
10781
10782 =back
10783
10784 =item RETURN
10785
10786 =item NOTES
10787
10788 =item AUTHOR
10789
10790 =back
10791
10792 =head2 File::DosGlob - DOS like globbing and then some
10793
10794 =over 4
10795
10796 =item SYNOPSIS
10797
10798 =item DESCRIPTION
10799
10800 =item NOTES
10801
10802 =item EXPORTS (by request only)
10803
10804 =item BUGS
10805
10806 =item AUTHOR
10807
10808 =item HISTORY
10809
10810 =item SEE ALSO
10811
10812 =back
10813
10814 =head2 File::Find, find - traverse a file tree
10815
10816 =over 4
10817
10818 =item SYNOPSIS
10819
10820 =item DESCRIPTION
10821
10822 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
10823 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
10824 C<untaint>, C<untaint_pattern>, C<untaint_skip>
10825
10826 =item CAVEAT
10827
10828 =item NOTES
10829
10830 =item HISTORY
10831
10832 =back
10833
10834 =head2 File::Glob - Perl extension for BSD glob routine
10835
10836 =over 4
10837
10838 =item SYNOPSIS
10839
10840 =item DESCRIPTION
10841
10842 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
10843 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
10844 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
10845
10846 =item DIAGNOSTICS
10847
10848 C<GLOB_NOSPACE>, C<GLOB_ABEND>
10849
10850 =item NOTES
10851
10852 =item AUTHOR
10853
10854 =back
10855
10856 =head2 File::Path - create or remove directory trees
10857
10858 =over 4
10859
10860 =item SYNOPSIS
10861
10862 =item DESCRIPTION
10863
10864 =item AUTHORS
10865
10866 =back
10867
10868 =head2 File::Spec - portably perform operations on file names
10869
10870 =over 4
10871
10872 =item SYNOPSIS
10873
10874 =item DESCRIPTION
10875
10876 =item METHODS
10877
10878 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
10879 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
10880 splitdir, catpath(), abs2rel, rel2abs()
10881
10882 =item SEE ALSO
10883
10884 =item AUTHORS
10885
10886 =back
10887
10888 =head2 File::Spec::Epoc - methods for Epoc file specs
10889
10890 =over 4
10891
10892 =item SYNOPSIS
10893
10894 =item DESCRIPTION
10895
10896 devnull
10897
10898 =back
10899
10900 tmpdir
10901
10902 path
10903
10904 canonpath()
10905
10906 splitpath
10907
10908 splitdir
10909
10910 catpath
10911
10912 abs2rel
10913
10914 rel2abs()
10915
10916 =over 4
10917
10918 =item SEE ALSO
10919
10920 =back
10921
10922 =head2 File::Spec::Functions - portably perform operations on file names
10923
10924 =over 4
10925
10926 =item SYNOPSIS
10927
10928 =item DESCRIPTION
10929
10930 =over 4
10931
10932 =item Exports
10933
10934 =back
10935
10936 =item SEE ALSO
10937
10938 =back
10939
10940 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
10941
10942 =over 4
10943
10944 =item SYNOPSIS
10945
10946 =item DESCRIPTION
10947
10948 =item METHODS
10949
10950 canonpath
10951
10952 =back
10953
10954 catdir()
10955
10956 catfile
10957
10958 curdir
10959
10960 devnull
10961
10962 rootdir
10963
10964 tmpdir
10965
10966 updir
10967
10968 file_name_is_absolute
10969
10970 path
10971
10972 splitpath
10973
10974 splitdir
10975
10976 catpath()
10977
10978 abs2rel
10979
10980 rel2abs
10981
10982 =over 4
10983
10984 =item AUTHORS
10985
10986 =item SEE ALSO
10987
10988 =back
10989
10990 =head2 File::Spec::OS2 - methods for OS/2 file specs
10991
10992 =over 4
10993
10994 =item SYNOPSIS
10995
10996 =item DESCRIPTION
10997
10998 =back
10999
11000 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
11001 modules
11002
11003 =over 4
11004
11005 =item SYNOPSIS
11006
11007 =item DESCRIPTION
11008
11009 =item METHODS
11010
11011 canonpath()
11012
11013 =back
11014
11015 catdir()
11016
11017 catfile
11018
11019 curdir
11020
11021 devnull
11022
11023 rootdir
11024
11025 tmpdir
11026
11027 updir
11028
11029 no_upwards
11030
11031 case_tolerant
11032
11033 file_name_is_absolute
11034
11035 path
11036
11037 join
11038
11039 splitpath
11040
11041 splitdir
11042
11043 catpath()
11044
11045 abs2rel
11046
11047 rel2abs()
11048
11049 =over 4
11050
11051 =item SEE ALSO
11052
11053 =back
11054
11055 =head2 File::Spec::VMS - methods for VMS file specs
11056
11057 =over 4
11058
11059 =item SYNOPSIS
11060
11061 =item DESCRIPTION
11062
11063 eliminate_macros
11064
11065 =back
11066
11067 fixpath
11068
11069 =over 4
11070
11071 =item Methods always loaded
11072
11073 canonpath (override)
11074
11075 =back
11076
11077 catdir
11078
11079 catfile
11080
11081 curdir (override)
11082
11083 devnull (override)
11084
11085 rootdir (override)
11086
11087 tmpdir (override)
11088
11089 updir (override)
11090
11091 case_tolerant (override)
11092
11093 path (override)
11094
11095 file_name_is_absolute (override)
11096
11097 splitpath (override)
11098
11099 splitdir (override)
11100
11101 catpath (override)
11102
11103 abs2rel (override)
11104
11105 rel2abs (override)
11106
11107 =over 4
11108
11109 =item SEE ALSO
11110
11111 =back
11112
11113 =head2 File::Spec::Win32 - methods for Win32 file specs
11114
11115 =over 4
11116
11117 =item SYNOPSIS
11118
11119 =item DESCRIPTION
11120
11121 devnull
11122
11123 =back
11124
11125 tmpdir
11126
11127 catfile
11128
11129 canonpath
11130
11131 splitpath
11132
11133 splitdir
11134
11135 catpath
11136
11137 =over 4
11138
11139 =item SEE ALSO
11140
11141 =back
11142
11143 =head2 File::Temp - return name and handle of a temporary file safely
11144
11145 =over 4
11146
11147 =item PORTABILITY
11148
11149 =item SYNOPSIS
11150
11151 =item DESCRIPTION
11152
11153 =back
11154
11155 =over 4
11156
11157 =item FUNCTIONS
11158
11159 B<tempfile>
11160
11161 =back
11162
11163 B<tempdir>
11164
11165 =over 4
11166
11167 =item MKTEMP FUNCTIONS
11168
11169 B<mkstemp>
11170
11171 =back
11172
11173 B<mkstemps>
11174
11175 B<mkdtemp>
11176
11177 B<mktemp>
11178
11179 =over 4
11180
11181 =item POSIX FUNCTIONS
11182
11183 B<tmpnam>
11184
11185 =back
11186
11187 B<tmpfile>
11188
11189 =over 4
11190
11191 =item ADDITIONAL FUNCTIONS
11192
11193 B<tempnam>
11194
11195 =back
11196
11197 =over 4
11198
11199 =item UTILITY FUNCTIONS
11200
11201 B<unlink0>
11202
11203 =back
11204
11205 =over 4
11206
11207 =item PACKAGE VARIABLES
11208
11209 B<safe_level>, STANDARD, MEDIUM, HIGH
11210
11211 =back
11212
11213 TopSystemUID
11214
11215 =over 4
11216
11217 =item WARNING
11218
11219 =over 4
11220
11221 =item Temporary files and NFS
11222
11223 =back
11224
11225 =item HISTORY
11226
11227 =item SEE ALSO
11228
11229 =item AUTHOR
11230
11231 =back
11232
11233 =head2 File::stat - by-name interface to Perl's built-in stat() functions
11234
11235 =over 4
11236
11237 =item SYNOPSIS
11238
11239 =item DESCRIPTION
11240
11241 =item NOTE
11242
11243 =item AUTHOR
11244
11245 =back
11246
11247 =head2 FileCache - keep more files open than the system permits
11248
11249 =over 4
11250
11251 =item SYNOPSIS
11252
11253 =item DESCRIPTION
11254
11255 =item BUGS
11256
11257 =back
11258
11259 =head2 FileHandle - supply object methods for filehandles
11260
11261 =over 4
11262
11263 =item SYNOPSIS
11264
11265 =item DESCRIPTION
11266
11267 $fh->print, $fh->printf, $fh->getline, $fh->getlines
11268
11269 =item SEE ALSO
11270
11271 =back
11272
11273 =head2 Filter::Simple - Simplified source filtering
11274
11275 =over 4
11276
11277 =item SYNOPSIS
11278
11279 =item DESCRIPTION
11280
11281 =over 4
11282
11283 =item The Problem
11284
11285 =item A Solution
11286
11287 =item Disabling or changing <no> behaviour
11288
11289 =item All-in-one interface
11290
11291 =item Using Filter::Simple and Exporter together
11292
11293 =item How it works
11294
11295 =back
11296
11297 =item AUTHOR
11298
11299 =item COPYRIGHT
11300
11301 =back
11302
11303 =head2 Filter::Util::Call - Perl Source Filter Utility Module
11304
11305 =over 4
11306
11307 =item SYNOPSIS
11308
11309 =item DESCRIPTION
11310
11311 =over 4
11312
11313 =item B<use Filter::Util::Call>
11314
11315 =item B<import()>
11316
11317 =item B<filter() and anonymous sub>
11318
11319 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
11320
11321 =back
11322
11323 =item EXAMPLES
11324
11325 =over 4
11326
11327 =item Example 1: A simple filter.
11328
11329 =item Example 2: Using the context
11330
11331 =item Example 3: Using the context within the filter
11332
11333 =item Example 4: Using filter_del
11334
11335 =back
11336
11337 =item Filter::Simple
11338
11339 =item AUTHOR
11340
11341 =item DATE
11342
11343 =back
11344
11345 =head2 FindBin - Locate directory of original perl script
11346
11347 =over 4
11348
11349 =item SYNOPSIS
11350
11351 =item DESCRIPTION
11352
11353 =item EXPORTABLE VARIABLES
11354
11355 =item KNOWN ISSUES
11356
11357 =item KNOWN BUGS
11358
11359 =item AUTHORS
11360
11361 =item COPYRIGHT
11362
11363 =back
11364
11365 =head2 GDBM_File - Perl5 access to the gdbm library.
11366
11367 =over 4
11368
11369 =item SYNOPSIS
11370
11371 =item DESCRIPTION
11372
11373 =item AVAILABILITY
11374
11375 =item BUGS
11376
11377 =item SEE ALSO
11378
11379 =back
11380
11381 =head2 Getopt::Long - Extended processing of command line options
11382
11383 =over 4
11384
11385 =item SYNOPSIS
11386
11387 =item DESCRIPTION
11388
11389 =item Command Line Options, an Introduction
11390
11391 =item Getting Started with Getopt::Long
11392
11393 =over 4
11394
11395 =item Simple options
11396
11397 =item A little bit less simple options
11398
11399 =item Mixing command line option with other arguments
11400
11401 =item Options with values
11402
11403 =item Options with multiple values
11404
11405 =item Options with hash values
11406
11407 =item User-defined subroutines to handle options
11408
11409 =item Options with multiple names
11410
11411 =item Case and abbreviations
11412
11413 =item Summary of Option Specifications
11414
11415 !, +, s, i, o, f, : I<type> [ I<desttype> ]
11416
11417 =back
11418
11419 =item Advanced Possibilities
11420
11421 =over 4
11422
11423 =item Object oriented interface
11424
11425 =item Documentation and help texts
11426
11427 =item Storing options in a hash
11428
11429 =item Bundling
11430
11431 =item The lonesome dash
11432
11433 =item Argument call-back
11434
11435 =back
11436
11437 =item Configuring Getopt::Long
11438
11439 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
11440 require_order, permute, bundling (default: disabled), bundling_override
11441 (default: disabled), ignore_case  (default: enabled), ignore_case_always
11442 (default: disabled), pass_through (default: disabled), prefix,
11443 prefix_pattern, debug (default: disabled)
11444
11445 =item Return values and Errors
11446
11447 =item Legacy
11448
11449 =over 4
11450
11451 =item Default destinations
11452
11453 =item Alternative option starters
11454
11455 =item Configuration variables
11456
11457 =back
11458
11459 =item Trouble Shooting
11460
11461 =over 4
11462
11463 =item Warning: Ignoring '!' modifier for short option
11464
11465 =item GetOptions does not return a false result when an option is not
11466 supplied
11467
11468 =back
11469
11470 =item AUTHOR
11471
11472 =item COPYRIGHT AND DISCLAIMER
11473
11474 =back
11475
11476 =head2 Getopt::Std, getopt - Process single-character switches with switch
11477 clustering
11478
11479 =over 4
11480
11481 =item SYNOPSIS
11482
11483 =item DESCRIPTION
11484
11485 =back
11486
11487 =head2 I18N::Collate - compare 8-bit scalar data according to the current
11488 locale
11489
11490 =over 4
11491
11492 =item SYNOPSIS
11493
11494 =item DESCRIPTION
11495
11496 =back
11497
11498 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
11499 tags
11500
11501 =over 4
11502
11503 =item SYNOPSIS
11504
11505 =item DESCRIPTION
11506
11507 =back
11508
11509 the function is_language_tag($lang1)
11510
11511 the function extract_language_tags($whatever)
11512
11513 the function same_language_tag($lang1, $lang2)
11514
11515 the function similarity_language_tag($lang1, $lang2)
11516
11517 the function is_dialect_of($lang1, $lang2)
11518
11519 the function super_languages($lang1)
11520
11521 the function locale2language_tag($locale_identifier)
11522
11523 the function encode_language_tag($lang1)
11524
11525 the function alternate_language_tags($lang1)
11526
11527 the function @langs = panic_languages(@accept_languages)
11528
11529 =over 4
11530
11531 =item ABOUT LOWERCASING
11532
11533 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
11534
11535 =item SEE ALSO
11536
11537 =item COPYRIGHT
11538
11539 =item AUTHOR
11540
11541 =back
11542
11543 =head2 I18N::LangTags::List -- tags and names for human languages
11544
11545 =over 4
11546
11547 =item SYNOPSIS
11548
11549 =item DESCRIPTION
11550
11551 =item ABOUT LANGUAGE TAGS
11552
11553 =item LIST OF LANGUAGES
11554
11555 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
11556 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
11557 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
11558 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
11559 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
11560 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
11561 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
11562 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
11563 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
11564 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
11565 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
11566 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
11567 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
11568 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
11569 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
11570 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
11571 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
11572 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
11573 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
11574 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
11575 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
11576 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
11577 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
11578 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
11579 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
11580 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
11581 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
11582 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
11583 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
11584 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
11585 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
11586 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
11587 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
11588 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
11589 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
11590 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
11591 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
11592 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
11593 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
11594 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
11595 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
11596 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
11597 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
11598 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
11599 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
11600 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
11601 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
11602 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
11603 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
11604 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
11605 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
11606 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
11607 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
11608 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
11609 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
11610 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
11611 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
11612 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
11613 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
11614 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
11615 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
11616 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
11617 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
11618 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
11619 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
11620 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
11621 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
11622 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
11623 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
11624 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
11625 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
11626 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
11627 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
11628 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
11629 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
11630 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
11631 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
11632 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
11633 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
11634 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
11635 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
11636 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
11637 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
11638 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
11639 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
11640 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
11641 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
11642 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
11643 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
11644 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
11645 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
11646 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
11647 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
11648 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
11649 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
11650 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
11651 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
11652 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
11653 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
11654 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
11655 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
11656 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
11657 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
11658 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
11659 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
11660 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
11661 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
11662 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
11663 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
11664 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
11665 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
11666 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
11667 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
11668 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
11669 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
11670 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
11671 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
11672 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
11673 Zhuang, {zu} : Zulu, {zun} : Zuni
11674
11675 =item SEE ALSO
11676
11677 =item COPYRIGHT AND DISCLAIMER
11678
11679 =item AUTHOR
11680
11681 =back
11682
11683 =head2 I18N::Langinfo - query locale information
11684
11685 =over 4
11686
11687 =item SYNOPSIS
11688
11689 =item DESCRIPTION
11690
11691 =over 4
11692
11693 =item EXPORT
11694
11695 =back
11696
11697 =item SEE ALSO
11698
11699 =item AUTHOR
11700
11701 =item COPYRIGHT AND LICENSE
11702
11703 =back
11704
11705 =head2 IO - load various IO modules
11706
11707 =over 4
11708
11709 =item SYNOPSIS
11710
11711 =item DESCRIPTION
11712
11713 =back
11714
11715 =head2 IO::Dir - supply object methods for directory handles
11716
11717 =over 4
11718
11719 =item SYNOPSIS
11720
11721 =item DESCRIPTION
11722
11723 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
11724 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
11725
11726 =item SEE ALSO
11727
11728 =item AUTHOR
11729
11730 =item COPYRIGHT
11731
11732 =back
11733
11734 =head2 IO::File - supply object methods for filehandles
11735
11736 =over 4
11737
11738 =item SYNOPSIS
11739
11740 =item DESCRIPTION
11741
11742 =item CONSTRUCTOR
11743
11744 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
11745
11746 =item METHODS
11747
11748 open( FILENAME [,MODE [,PERMS]] )
11749
11750 =item SEE ALSO
11751
11752 =item HISTORY
11753
11754 =back
11755
11756 =head2 IO::Handle - supply object methods for I/O handles
11757
11758 =over 4
11759
11760 =item SYNOPSIS
11761
11762 =item DESCRIPTION
11763
11764 =item CONSTRUCTOR
11765
11766 new (), new_from_fd ( FD, MODE )
11767
11768 =item METHODS
11769
11770 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
11771 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
11772 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
11773 $io->blocking ( [ BOOL ] ), $io->untaint
11774
11775 =item NOTE
11776
11777 =item SEE ALSO
11778
11779 =item BUGS
11780
11781 =item HISTORY
11782
11783 =back
11784
11785 =head2 IO::Pipe - supply object methods for pipes
11786
11787 =over 4
11788
11789 =item SYNOPSIS
11790
11791 =item DESCRIPTION
11792
11793 =item CONSTRUCTOR
11794
11795 new ( [READER, WRITER] )
11796
11797 =item METHODS
11798
11799 reader ([ARGS]), writer ([ARGS]), handles ()
11800
11801 =item SEE ALSO
11802
11803 =item AUTHOR
11804
11805 =item COPYRIGHT
11806
11807 =back
11808
11809 =head2 IO::Poll - Object interface to system poll call
11810
11811 =over 4
11812
11813 =item SYNOPSIS
11814
11815 =item DESCRIPTION
11816
11817 =item METHODS
11818
11819 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
11820 IO ), handles( [ EVENT_MASK ] )
11821
11822 =item SEE ALSO
11823
11824 =item AUTHOR
11825
11826 =item COPYRIGHT
11827
11828 =back
11829
11830 =head2 IO::Seekable - supply seek based methods for I/O objects
11831
11832 =over 4
11833
11834 =item SYNOPSIS
11835
11836 =item DESCRIPTION
11837
11838 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
11839 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
11840 $io->tell
11841
11842 =item SEE ALSO
11843
11844 =item HISTORY
11845
11846 =back
11847
11848 =head2 IO::Select - OO interface to the select system call
11849
11850 =over 4
11851
11852 =item SYNOPSIS
11853
11854 =item DESCRIPTION
11855
11856 =item CONSTRUCTOR
11857
11858 new ( [ HANDLES ] )
11859
11860 =item METHODS
11861
11862 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
11863 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
11864 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
11865
11866 =item EXAMPLE
11867
11868 =item AUTHOR
11869
11870 =item COPYRIGHT
11871
11872 =back
11873
11874 =head2 IO::Socket - Object interface to socket communications
11875
11876 =over 4
11877
11878 =item SYNOPSIS
11879
11880 =item DESCRIPTION
11881
11882 =item CONSTRUCTOR
11883
11884 new ( [ARGS] )
11885
11886 =item METHODS
11887
11888 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
11889 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
11890
11891 =item SEE ALSO
11892
11893 =item AUTHOR
11894
11895 =item COPYRIGHT
11896
11897 =back
11898
11899 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
11900
11901 =over 4
11902
11903 =item SYNOPSIS
11904
11905 =item DESCRIPTION
11906
11907 =item CONSTRUCTOR
11908
11909 new ( [ARGS] )
11910
11911 =over 4
11912
11913 =item METHODS
11914
11915 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
11916 ()
11917
11918 =back
11919
11920 =item SEE ALSO
11921
11922 =item AUTHOR
11923
11924 =item COPYRIGHT
11925
11926 =back
11927
11928 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
11929
11930 =over 4
11931
11932 =item SYNOPSIS
11933
11934 =item DESCRIPTION
11935
11936 =item CONSTRUCTOR
11937
11938 new ( [ARGS] )
11939
11940 =item METHODS
11941
11942 hostpath(), peerpath()
11943
11944 =item SEE ALSO
11945
11946 =item AUTHOR
11947
11948 =item COPYRIGHT
11949
11950 =back
11951
11952 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
11953 handles
11954
11955 =over 4
11956
11957 =item SYNOPSIS
11958
11959 =item DESCRIPTION
11960
11961 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
11962 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
11963
11964 =item SEE ALSO
11965
11966 =item AUTHOR
11967
11968 =item COPYRIGHT
11969
11970 =back
11971
11972 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
11973
11974 =over 4
11975
11976 =item SYNOPSIS
11977
11978 =item DESCRIPTION
11979
11980 =item CONSTRUCTOR
11981
11982 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
11983
11984 =item METHODS
11985
11986 open( FILENAME [,MODE [,PERMS]] )
11987
11988 =item SEE ALSO
11989
11990 =item HISTORY
11991
11992 =back
11993
11994 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
11995 handles
11996
11997 =over 4
11998
11999 =item SYNOPSIS
12000
12001 =item DESCRIPTION
12002
12003 =item CONSTRUCTOR
12004
12005 new (), new_from_fd ( FD, MODE )
12006
12007 =item METHODS
12008
12009 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
12010 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
12011 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
12012 $io->blocking ( [ BOOL ] ), $io->untaint
12013
12014 =item NOTE
12015
12016 =item SEE ALSO
12017
12018 =item BUGS
12019
12020 =item HISTORY
12021
12022 =back
12023
12024 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
12025
12026 =over 4
12027
12028 =item SYNOPSIS
12029
12030 =item DESCRIPTION
12031
12032 =item CONSTRUCTOR
12033
12034 new ( [READER, WRITER] )
12035
12036 =item METHODS
12037
12038 reader ([ARGS]), writer ([ARGS]), handles ()
12039
12040 =item SEE ALSO
12041
12042 =item AUTHOR
12043
12044 =item COPYRIGHT
12045
12046 =back
12047
12048 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
12049
12050 =over 4
12051
12052 =item SYNOPSIS
12053
12054 =item DESCRIPTION
12055
12056 =item METHODS
12057
12058 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
12059 IO ), handles( [ EVENT_MASK ] )
12060
12061 =item SEE ALSO
12062
12063 =item AUTHOR
12064
12065 =item COPYRIGHT
12066
12067 =back
12068
12069 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
12070 I/O objects
12071
12072 =over 4
12073
12074 =item SYNOPSIS
12075
12076 =item DESCRIPTION
12077
12078 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
12079 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
12080 $io->tell
12081
12082 =item SEE ALSO
12083
12084 =item HISTORY
12085
12086 =back
12087
12088 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
12089 call
12090
12091 =over 4
12092
12093 =item SYNOPSIS
12094
12095 =item DESCRIPTION
12096
12097 =item CONSTRUCTOR
12098
12099 new ( [ HANDLES ] )
12100
12101 =item METHODS
12102
12103 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
12104 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
12105 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
12106
12107 =item EXAMPLE
12108
12109 =item AUTHOR
12110
12111 =item COPYRIGHT
12112
12113 =back
12114
12115 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
12116 communications
12117
12118 =over 4
12119
12120 =item SYNOPSIS
12121
12122 =item DESCRIPTION
12123
12124 =item CONSTRUCTOR
12125
12126 new ( [ARGS] )
12127
12128 =item METHODS
12129
12130 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
12131 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
12132
12133 =item SEE ALSO
12134
12135 =item AUTHOR
12136
12137 =item COPYRIGHT
12138
12139 =back
12140
12141 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
12142 AF_INET domain sockets
12143
12144 =over 4
12145
12146 =item SYNOPSIS
12147
12148 =item DESCRIPTION
12149
12150 =item CONSTRUCTOR
12151
12152 new ( [ARGS] )
12153
12154 =over 4
12155
12156 =item METHODS
12157
12158 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
12159 ()
12160
12161 =back
12162
12163 =item SEE ALSO
12164
12165 =item AUTHOR
12166
12167 =item COPYRIGHT
12168
12169 =back
12170
12171 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
12172 AF_UNIX domain sockets
12173
12174 =over 4
12175
12176 =item SYNOPSIS
12177
12178 =item DESCRIPTION
12179
12180 =item CONSTRUCTOR
12181
12182 new ( [ARGS] )
12183
12184 =item METHODS
12185
12186 hostpath(), peerpath()
12187
12188 =item SEE ALSO
12189
12190 =item AUTHOR
12191
12192 =item COPYRIGHT
12193
12194 =back
12195
12196 =head2 IPC::Msg - SysV Msg IPC object class
12197
12198 =over 4
12199
12200 =item SYNOPSIS
12201
12202 =item DESCRIPTION
12203
12204 =item METHODS
12205
12206 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
12207 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
12208 FLAGS ] ), stat
12209
12210 =item SEE ALSO
12211
12212 =item AUTHOR
12213
12214 =item COPYRIGHT
12215
12216 =back
12217
12218 =head2 IPC::Open2, open2 - open a process for both reading and writing
12219
12220 =over 4
12221
12222 =item SYNOPSIS
12223
12224 =item DESCRIPTION
12225
12226 =item WARNING
12227
12228 =item SEE ALSO
12229
12230 =back
12231
12232 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
12233 handling
12234
12235 =over 4
12236
12237 =item SYNOPSIS
12238
12239 =item DESCRIPTION
12240
12241 =item WARNING
12242
12243 =back
12244
12245 =head2 IPC::Semaphore - SysV Semaphore IPC object class
12246
12247 =over 4
12248
12249 =item SYNOPSIS
12250
12251 =item DESCRIPTION
12252
12253 =item METHODS
12254
12255 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
12256 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
12257 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
12258 , VALUE ), stat
12259
12260 =item SEE ALSO
12261
12262 =item AUTHOR
12263
12264 =item COPYRIGHT
12265
12266 =back
12267
12268 =head2 IPC::SysV - SysV IPC constants
12269
12270 =over 4
12271
12272 =item SYNOPSIS
12273
12274 =item DESCRIPTION
12275
12276 ftok( PATH, ID )
12277
12278 =item SEE ALSO
12279
12280 =item AUTHORS
12281
12282 =item COPYRIGHT
12283
12284 =back
12285
12286 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
12287
12288 =over 4
12289
12290 =item SYNOPSIS
12291
12292 =item DESCRIPTION
12293
12294 =item METHODS
12295
12296 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
12297 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
12298 FLAGS ] ), stat
12299
12300 =item SEE ALSO
12301
12302 =item AUTHOR
12303
12304 =item COPYRIGHT
12305
12306 =back
12307
12308 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
12309 class
12310
12311 =over 4
12312
12313 =item SYNOPSIS
12314
12315 =item DESCRIPTION
12316
12317 =item METHODS
12318
12319 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
12320 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
12321 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
12322 , VALUE ), stat
12323
12324 =item SEE ALSO
12325
12326 =item AUTHOR
12327
12328 =item COPYRIGHT
12329
12330 =back
12331
12332 =head2 Lingua::KO::Hangul::Util - utility functions for Hangul Syllables
12333
12334 =over 4
12335
12336 =item SYNOPSIS
12337
12338 =item DESCRIPTION
12339
12340 =over 4
12341
12342 =item Composition and Decomposition
12343
12344 C<$string_decomposed = decomposeHangul($codepoint)>, C<@codepoints =
12345 decomposeHangul($codepoint)>, C<$string_composed =
12346 composeHangul($src_string)>, C<@codepoints_composed =
12347 composeHangul($src_string)>
12348
12349 =item Hangul Syllable Name
12350
12351 C<$name = getHangulName($codepoint)>, C<$codepoint =
12352 parseHangulName($name)>
12353
12354 =item EXPORT
12355
12356 =back
12357
12358 =item AUTHOR
12359
12360 =item SEE ALSO
12361
12362 http://www.unicode.org/unicode/reports/tr15
12363
12364 =back
12365
12366 =head2 List::Util - A selection of general-utility list subroutines
12367
12368 =over 4
12369
12370 =item SYNOPSIS
12371
12372 =item DESCRIPTION
12373
12374 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
12375 BLOCK LIST, shuffle LIST, sum LIST
12376
12377 =item SUGGESTED ADDITIONS
12378
12379 =item COPYRIGHT
12380
12381 =back
12382
12383 =head2 List::Utilib::List::Util, List::Util - A selection of
12384 general-utility list subroutines
12385
12386 =over 4
12387
12388 =item SYNOPSIS
12389
12390 =item DESCRIPTION
12391
12392 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
12393 BLOCK LIST, shuffle LIST, sum LIST
12394
12395 =item SUGGESTED ADDITIONS
12396
12397 =item COPYRIGHT
12398
12399 =back
12400
12401 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
12402 general-utility scalar subroutines
12403
12404 =over 4
12405
12406 =item SYNOPSIS
12407
12408 =item DESCRIPTION
12409
12410 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
12411 EXPR, tainted EXPR, weaken REF
12412
12413 =item COPYRIGHT
12414
12415 =item BLATANT PLUG
12416
12417 =back
12418
12419 =head2 Locale::Constants - constants for Locale codes
12420
12421 =over 4
12422
12423 =item SYNOPSIS
12424
12425 =item DESCRIPTION
12426
12427 =item KNOWN BUGS AND LIMITATIONS
12428
12429 =item SEE ALSO
12430
12431 Locale::Language, Locale::Country, Locale::Currency
12432
12433 =item AUTHOR
12434
12435 =item COPYRIGHT
12436
12437 =back
12438
12439 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
12440
12441 =over 4
12442
12443 =item SYNOPSIS
12444
12445 =back
12446
12447 =over 4
12448
12449 =item DESCRIPTION
12450
12451 B<alpha-2>, B<alpha-3>, B<numeric>
12452
12453 =back
12454
12455 =over 4
12456
12457 =item CONVERSION ROUTINES
12458
12459 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
12460 country_code2code( CODE, CODESET, CODESET )
12461
12462 =back
12463
12464 =over 4
12465
12466 =item QUERY ROUTINES
12467
12468 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
12469
12470 =back
12471
12472 =over 4
12473
12474 =item CODE ALIASING
12475
12476 =back
12477
12478 =over 4
12479
12480 =item EXAMPLES
12481
12482 =item DOMAIN NAMES
12483
12484 =item KNOWN BUGS AND LIMITATIONS
12485
12486 =item SEE ALSO
12487
12488 Locale::Language, Locale::Currency, ISO 3166,
12489 http://www.din.de/gremien/nas/nabd/iso3166ma/,
12490 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
12491 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
12492
12493 =item AUTHOR
12494
12495 =item COPYRIGHT
12496
12497 =back
12498
12499 =head2 Locale::Currency - ISO three letter codes for currency
12500 identification (ISO 4217)
12501
12502 =over 4
12503
12504 =item SYNOPSIS
12505
12506 =back
12507
12508 =over 4
12509
12510 =item DESCRIPTION
12511
12512 XTS, XXX
12513
12514 =back
12515
12516 =over 4
12517
12518 =item CONVERSION ROUTINES
12519
12520 code2currency(), currency2code()
12521
12522 =back
12523
12524 =over 4
12525
12526 =item QUERY ROUTINES
12527
12528 C<all_currency_codes()>, C<all_currency_names()>
12529
12530 =back
12531
12532 =over 4
12533
12534 =item EXAMPLES
12535
12536 =item KNOWN BUGS AND LIMITATIONS
12537
12538 =item SEE ALSO
12539
12540 Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
12541
12542 =item AUTHOR
12543
12544 =item COPYRIGHT
12545
12546 =back
12547
12548 =head2 Locale::Language - ISO two letter codes for language identification
12549 (ISO 639)
12550
12551 =over 4
12552
12553 =item SYNOPSIS
12554
12555 =back
12556
12557 =over 4
12558
12559 =item DESCRIPTION
12560
12561 =back
12562
12563 =over 4
12564
12565 =item CONVERSION ROUTINES
12566
12567 code2language(), language2code()
12568
12569 =back
12570
12571 =over 4
12572
12573 =item QUERY ROUTINES
12574
12575 C<all_language_codes()>, C<all_language_names()>
12576
12577 =back
12578
12579 =over 4
12580
12581 =item EXAMPLES
12582
12583 =item KNOWN BUGS AND LIMITATIONS
12584
12585 =item SEE ALSO
12586
12587 Locale::Country, Locale::Currency, ISO 639:1988 (E/F),
12588 http://lcweb.loc.gov/standards/iso639-2/langhome.html
12589
12590 =item AUTHOR
12591
12592 =item COPYRIGHT
12593
12594 =back
12595
12596 =head2 Locale::Maketext -- framework for localization
12597
12598 =over 4
12599
12600 =item SYNOPSIS
12601
12602 =item DESCRIPTION
12603
12604 =item QUICK OVERVIEW
12605
12606 =item METHODS
12607
12608 =over 4
12609
12610 =item Construction Methods
12611
12612 =item The "maketext" Method
12613
12614 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
12615
12616 =item Utility Methods
12617
12618 $language->quant($number, $singular), $language->quant($number, $singular,
12619 $plural), $language->quant($number, $singular, $plural, $negative),
12620 $language->numf($number), $language->sprintf($format, @items),
12621 $language->language_tag(), $language->encoding()
12622
12623 =item Language Handle Attributes and Internals
12624
12625 =back
12626
12627 =item LANGUAGE CLASS HIERARCHIES
12628
12629 =item ENTRIES IN EACH LEXICON
12630
12631 =item BRACKET NOTATION
12632
12633 =item AUTO LEXICONS
12634
12635 =item CONTROLLING LOOKUP FAILURE
12636
12637 =item HOW TO USE MAKETEXT
12638
12639 =item SEE ALSO
12640
12641 =item COPYRIGHT AND DISCLAIMER
12642
12643 =item AUTHOR
12644
12645 =back
12646
12647 =head2 Locale::Maketext::TPJ13 -- article about software localization
12648
12649 =over 4
12650
12651 =item SYNOPSIS
12652
12653 =item DESCRIPTION
12654
12655 =item Localization and Perl: gettext breaks, Maketext fixes
12656
12657 =over 4
12658
12659 =item A Localization Horror Story: It Could Happen To You
12660
12661 =item The Linguistic View
12662
12663 =item Breaking gettext
12664
12665 =item Replacing gettext
12666
12667 =item Buzzwords: Abstraction and Encapsulation
12668
12669 =item Buzzword: Isomorphism
12670
12671 =item Buzzword: Inheritance
12672
12673 =item Buzzword: Concision
12674
12675 =item The Devil in the Details
12676
12677 =item The Proof in the Pudding: Localizing Web Sites
12678
12679 =item References
12680
12681 =back
12682
12683 =back
12684
12685 =head2 MIME::Base64 - Encoding and decoding of base64 strings
12686
12687 =over 4
12688
12689 =item SYNOPSIS
12690
12691 =item DESCRIPTION
12692
12693 encode_base64($str, [$eol]), decode_base64($str)
12694
12695 =item DIAGNOSTICS
12696
12697 Premature end of base64 data, Premature padding of base64 data
12698
12699 =item EXAMPLES
12700
12701 =item COPYRIGHT
12702
12703 =back
12704
12705 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
12706 of quoted-printable strings
12707
12708 =over 4
12709
12710 =item SYNOPSIS
12711
12712 =item DESCRIPTION
12713
12714 encode_qp($str), decode_qp($str);
12715
12716 =item COPYRIGHT
12717
12718 =back
12719
12720 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
12721 strings
12722
12723 =over 4
12724
12725 =item SYNOPSIS
12726
12727 =item DESCRIPTION
12728
12729 encode_qp($str), decode_qp($str);
12730
12731 =item COPYRIGHT
12732
12733 =back
12734
12735 =head2 Math::BigFloat - Arbitrary size floating point math package
12736
12737 =over 4
12738
12739 =item SYNOPSIS
12740
12741 =item DESCRIPTION
12742
12743 =over 4
12744
12745 =item Canonical notation
12746
12747 =item Output
12748
12749 =item C<mantissa()>, C<exponent()> and C<parts()>
12750
12751 =item Accuracy vs. Precision
12752
12753 =item Rounding
12754
12755 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
12756 ), fround  ( -$scale ) and fround ( 0 )
12757
12758 =back
12759
12760 =item EXAMPLES
12761
12762   # not ready yet
12763
12764 =item Autocreating constants
12765
12766 =item BUGS
12767
12768 =item CAVEAT
12769
12770 stringify, bstr(), bdiv, Modifying and =, bpow
12771
12772 =item LICENSE
12773
12774 =item AUTHORS
12775
12776 =back
12777
12778 =head2 Math::BigInt - Arbitrary size integer math package
12779
12780 =over 4
12781
12782 =item SYNOPSIS
12783
12784 =item DESCRIPTION
12785
12786 Canonical notation, Input, Output
12787
12788 =item ACCURACY and PRECISION
12789
12790 =over 4
12791
12792 =item Precision P
12793
12794 =item Accuracy A
12795
12796 =item Fallback F
12797
12798 =item Rounding mode R
12799
12800 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
12801 (significant digits), Setting/Accessing, Creating numbers, Usage,
12802 Precedence, Overriding globals, Local settings, Rounding, Default values,
12803 Remarks
12804
12805 =back
12806
12807 =item INTERNALS
12808
12809 =over 4
12810
12811 =item MATH LIBRARY
12812
12813 =item SIGN
12814
12815 =item mantissa(), exponent() and parts()
12816
12817 =back
12818
12819 =item EXAMPLES
12820
12821   use Math::BigInt qw(bstr);
12822
12823 =item Autocreating constants
12824
12825 =item PERFORMANCE
12826
12827 =over 4
12828
12829 =item Alternative math libraries
12830
12831 =back
12832
12833 =item BUGS
12834
12835 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
12836
12837 =item CAVEATS
12838
12839 stringify, bstr(), bsstr() and 'cmp', int(), bdiv, bdiv, Modifying and =,
12840 bpow, Overloading -$x, Mixing different object types, bsqrt()
12841
12842 =item LICENSE
12843
12844 =item SEE ALSO
12845
12846 =item AUTHORS
12847
12848 =back
12849
12850 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
12851
12852 =over 4
12853
12854 =item SYNOPSIS
12855
12856 =item DESCRIPTION
12857
12858 =item EXPORT
12859
12860 =item WRAP YOUR OWN
12861
12862 =item LICENSE
12863
12864 This program is free software; you may redistribute it and/or modify it
12865 under
12866 the same terms as Perl itself.
12867
12868 =item AUTHORS
12869
12870 =item SEE ALSO
12871
12872 =back
12873
12874 =head2 Math::Complex - complex numbers and associated mathematical
12875 functions
12876
12877 =over 4
12878
12879 =item SYNOPSIS
12880
12881 =item DESCRIPTION
12882
12883 =item OPERATIONS
12884
12885 =item CREATION
12886
12887 =item STRINGIFICATION
12888
12889 =over 4
12890
12891 =item CHANGED IN PERL 5.6
12892
12893 =back
12894
12895 =item USAGE
12896
12897 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
12898
12899 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
12900
12901 =item BUGS
12902
12903 =item AUTHORS
12904
12905 =back
12906
12907 =head2 Math::Trig - trigonometric functions
12908
12909 =over 4
12910
12911 =item SYNOPSIS
12912
12913 =item DESCRIPTION
12914
12915 =item TRIGONOMETRIC FUNCTIONS
12916
12917 B<tan>
12918
12919 =over 4
12920
12921 =item ERRORS DUE TO DIVISION BY ZERO
12922
12923 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
12924
12925 =back
12926
12927 =item PLANE ANGLE CONVERSIONS
12928
12929 =item RADIAL COORDINATE CONVERSIONS
12930
12931 =over 4
12932
12933 =item COORDINATE SYSTEMS
12934
12935 =item 3-D ANGLE CONVERSIONS
12936
12937 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
12938 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
12939
12940 =back
12941
12942 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
12943
12944 =item EXAMPLES
12945
12946 =over 4
12947
12948 =item CAVEAT FOR GREAT CIRCLE FORMULAS
12949
12950 =back
12951
12952 =item BUGS
12953
12954 =item AUTHORS
12955
12956 =back
12957
12958 =head2 Memoize - Make your functions faster by trading space for time
12959
12960 =over 4
12961
12962 =item SYNOPSIS
12963
12964 =item DESCRIPTION
12965
12966 =item DETAILS
12967
12968 =item OPTIONS
12969
12970 =over 4
12971
12972 =item INSTALL
12973
12974 =item NORMALIZER
12975
12976 =item C<SCALAR_CACHE>, C<LIST_CACHE>
12977
12978 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
12979
12980 =back
12981
12982 =item OTHER FACILITIES
12983
12984 =over 4
12985
12986 =item C<unmemoize>
12987
12988 =item C<flush_cache>
12989
12990 =back
12991
12992 =item CAVEATS
12993
12994 =item PERSISTENT CACHE SUPPORT
12995
12996 =item EXPIRATION SUPPORT
12997
12998 =item BUGS
12999
13000 =item MAILING LIST
13001
13002 =item AUTHOR
13003
13004 =item COPYRIGHT AND LICENSE
13005
13006 =item THANK YOU
13007
13008 =back
13009
13010 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
13011 Storable use
13012
13013 =over 4
13014
13015 =item DESCRIPTION
13016
13017 =back
13018
13019 =head2 Memoize::Expire - Plug-in module for automatic expiration of
13020 memoized values
13021
13022 =over 4
13023
13024 =item SYNOPSIS
13025
13026 =item DESCRIPTION
13027
13028 =item INTERFACE
13029
13030  TIEHASH,  EXISTS,  STORE
13031
13032 =item ALTERNATIVES
13033
13034 =item CAVEATS
13035
13036 =item AUTHOR
13037
13038 =item SEE ALSO
13039
13040 =back
13041
13042 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
13043
13044 =over 4
13045
13046 =item DESCRIPTION
13047
13048 =back
13049
13050 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
13051
13052 =over 4
13053
13054 =item DESCRIPTION
13055
13056 =back
13057
13058 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
13059 Storable use
13060
13061 =over 4
13062
13063 =item DESCRIPTION
13064
13065 =back
13066
13067 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
13068 Storable use
13069
13070 =over 4
13071
13072 =item DESCRIPTION
13073
13074 =back
13075
13076 =head2 Memoize::Saves - Plug-in module to specify which return values
13077 should be memoized
13078
13079 =over 4
13080
13081 =item SYNOPSIS
13082
13083 =item DESCRIPTION
13084
13085 =item CAVEATS
13086
13087 =item AUTHOR
13088
13089 =item SEE ALSO
13090
13091 =back
13092
13093 =head2 Memoize::Storable - store Memoized data in Storable database
13094
13095 =over 4
13096
13097 =item DESCRIPTION
13098
13099 =back
13100
13101 =head2 NDBM_File - Tied access to ndbm files
13102
13103 =over 4
13104
13105 =item SYNOPSIS
13106
13107 =item DESCRIPTION
13108
13109 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
13110
13111 =item DIAGNOSTICS
13112
13113 =over 4
13114
13115 =item C<ndbm store returned -1, errno 22, key "..." at ...>
13116
13117 =back
13118
13119 =item BUGS AND WARNINGS
13120
13121 =back
13122
13123 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
13124
13125 =over 4
13126
13127 =item SYNOPSIS
13128
13129 =item DESCRIPTION
13130
13131 =item AUTHOR
13132
13133 =item BUGS AND IRRITATIONS
13134
13135 =item COPYRIGHT
13136
13137 =back
13138
13139 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
13140
13141 =over 4
13142
13143 =item SYNOPSIS
13144
13145 =item DESCRIPTION
13146
13147 =item USER METHODS
13148
13149 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
13150 dataend ()
13151
13152 =item CLASS METHODS
13153
13154 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
13155 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
13156 ungetline ( TEXT ), read_until_dot ()
13157
13158 =item EXPORTS
13159
13160 =item AUTHOR
13161
13162 =item COPYRIGHT
13163
13164 =back
13165
13166 =head2 Net::Config - Local configuration data for libnet
13167
13168 =over 4
13169
13170 =item SYNOPSYS
13171
13172 =item DESCRIPTION
13173
13174 =item METHODS
13175
13176 requires_firewall HOST
13177
13178 =item NetConfig VALUES
13179
13180 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
13181 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
13182 ftp_int_pasive, local_netmask, test_hosts, test_exists
13183
13184 =back
13185
13186 =head2 Net::Domain - Attempt to evaluate the current host's internet name
13187 and domain
13188
13189 =over 4
13190
13191 =item SYNOPSIS
13192
13193 =item DESCRIPTION
13194
13195 hostfqdn (), hostname (), hostdomain ()
13196
13197 =item AUTHOR
13198
13199 =item COPYRIGHT
13200
13201 =back
13202
13203 =head2 Net::FTP - FTP Client class
13204
13205 =over 4
13206
13207 =item SYNOPSIS
13208
13209 =item DESCRIPTION
13210
13211 =item OVERVIEW
13212
13213 =item CONSTRUCTOR
13214
13215 new (HOST [,OPTIONS])
13216
13217 =item METHODS
13218
13219 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
13220 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
13221 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
13222 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
13223 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
13224 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
13225 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
13226 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
13227 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
13228 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
13229 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
13230 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
13231 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
13232
13233 =over 4
13234
13235 =item Methods for the adventurous
13236
13237 quot (CMD [,ARGS])
13238
13239 =back
13240
13241 =item THE dataconn CLASS
13242
13243 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
13244 bytes_read (), abort (), close ()
13245
13246 =item UNIMPLEMENTED
13247
13248 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
13249
13250 =item REPORTING BUGS
13251
13252 =item AUTHOR
13253
13254 =item SEE ALSO
13255
13256 =item USE EXAMPLES
13257
13258 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
13259
13260 =item CREDITS
13261
13262 =item COPYRIGHT
13263
13264 =back
13265
13266 =head2 Net::NNTP - NNTP Client class
13267
13268 =over 4
13269
13270 =item SYNOPSIS
13271
13272 =item DESCRIPTION
13273
13274 =item CONSTRUCTOR
13275
13276 new ( [ HOST ] [, OPTIONS ])
13277
13278 =item METHODS
13279
13280 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
13281 [ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ]
13282 ), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo (
13283 USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews (
13284 SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave
13285 (), quit ()
13286
13287 =over 4
13288
13289 =item Extension methods
13290
13291 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
13292 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
13293 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
13294 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
13295 GROUP ] ), reader
13296
13297 =back
13298
13299 =item UNSUPPORTED
13300
13301 =item DEFINITIONS
13302
13303 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
13304
13305 =item SEE ALSO
13306
13307 =item AUTHOR
13308
13309 =item COPYRIGHT
13310
13311 =back
13312
13313 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081)
13314
13315 =over 4
13316
13317 =item SYNOPSIS
13318
13319 =item DESCRIPTION
13320
13321 =item EXAMPLES
13322
13323 =item CONSTRUCTOR
13324
13325 new ( [ HOST, ] [ OPTIONS ] )
13326
13327 =item METHODS
13328
13329 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER,
13330 PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [,
13331 FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete (
13332 MSGNUM ), reset (), quit ()
13333
13334 =item NOTES
13335
13336 =item SEE ALSO
13337
13338 =item AUTHOR
13339
13340 =item COPYRIGHT
13341
13342 =back
13343
13344 =head2 Net::Ping - check a remote host for reachability
13345
13346 =over 4
13347
13348 =item SYNOPSIS
13349
13350 =item DESCRIPTION
13351
13352 icmp, udp, tcp, stream, external
13353
13354 =over 4
13355
13356 =item Functions
13357
13358 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
13359 $timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
13360
13361 =back
13362
13363 =item NOTES
13364
13365 =back
13366
13367 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
13368
13369 =over 4
13370
13371 =item SYNOPSIS
13372
13373 =item DESCRIPTION
13374
13375 =item EXAMPLES
13376
13377 =item CONSTRUCTOR
13378
13379 new Net::SMTP [ HOST, ] [ OPTIONS ]
13380
13381 =item METHODS
13382
13383 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), mail ( ADDRESS [,
13384 OPTIONS] ), send ( ADDRESS ), send_or_mail ( ADDRESS ), send_and_mail (
13385 ADDRESS ), reset (), recipient ( ADDRESS [, ADDRESS [ ...]] [, OPTIONS ] ),
13386 to ( ADDRESS [, ADDRESS [...]] ), cc ( ADDRESS [, ADDRESS [...]] ), bcc (
13387 ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), verify
13388 ( ADDRESS ), help ( [ $subject ] ), quit ()
13389
13390 =item SEE ALSO
13391
13392 =item AUTHOR
13393
13394 =item COPYRIGHT
13395
13396 =back
13397
13398 =head2 Net::Time - time and daytime network client interface
13399
13400 =over 4
13401
13402 =item SYNOPSIS
13403
13404 =item DESCRIPTION
13405
13406 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
13407 PROTOCOL [, TIMEOUT]]])
13408
13409 =item AUTHOR
13410
13411 =item COPYRIGHT
13412
13413 =back
13414
13415 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
13416 functions
13417
13418 =over 4
13419
13420 =item SYNOPSIS
13421
13422 =item DESCRIPTION
13423
13424 =item EXAMPLES
13425
13426 =item NOTE
13427
13428 =item AUTHOR
13429
13430 =back
13431
13432 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
13433
13434 =over 4
13435
13436 =item DESCRIPTION
13437
13438 =over 4
13439
13440 =item Where to get this document
13441
13442 =item How to contribute to this document
13443
13444 =back
13445
13446 =item Author and Copyright Information
13447
13448 =over 4
13449
13450 =item Disclaimer
13451
13452 =back
13453
13454 =item Obtaining and installing libnet
13455
13456 =over 4
13457
13458 =item What is libnet ?
13459
13460 =item Which version of perl do I need ?
13461
13462 =item What other modules do I need ?
13463
13464 =item What machines support libnet ?
13465
13466 =item Where can I get the latest libnet release
13467
13468 =back
13469
13470 =item Using Net::FTP
13471
13472 =over 4
13473
13474 =item How do I download files from a FTP server ?
13475
13476 =item How do I transfer files in binary mode ?
13477
13478 =item How can I get the size of a file on a remote FTP server ?
13479
13480 =item How can I get the modification time of a file on a remote FTP server
13481 ?
13482
13483 =item How can I change the permissions of a file on a remote server ?
13484
13485 =item Can I do a reget operation like the ftp command ?
13486
13487 =item How do I get a directory listing from a FTP server ?
13488
13489 =item Changeing directory to "" does not fail ?
13490
13491 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
13492
13493 =item I am behind a FTP proxy firewall, but cannot access machines outside
13494 ?
13495
13496 =item My ftp proxy firewall does not listen on port 21
13497
13498 =item Is it possible to change the file permissions of a file on an FTP
13499 server ?
13500
13501 =item I have seen scripts call a method message, but cannot find it
13502 documented ?
13503
13504 =item Why does Net::FTP not implement mput and mget methods
13505
13506 =back
13507
13508 =item Using Net::SMTP
13509
13510 =over 4
13511
13512 =item Why can't the part of an Email address after the @ be used as the
13513 hostname ?
13514
13515 =item Why does Net::SMTP not do DNS MX lookups ?
13516
13517 =item The verify method always returns true ?
13518
13519 =back
13520
13521 =item Debugging scripts
13522
13523 =over 4
13524
13525 =item How can I debug my scripts that use Net::* modules ?
13526
13527 =back
13528
13529 =item AUTHOR AND COPYRIGHT
13530
13531 =back
13532
13533 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
13534 functions
13535
13536 =over 4
13537
13538 =item SYNOPSIS
13539
13540 =item DESCRIPTION
13541
13542 =item EXAMPLES
13543
13544 =item NOTE
13545
13546 =item AUTHOR
13547
13548 =back
13549
13550 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
13551 functions
13552
13553 =over 4
13554
13555 =item SYNOPSIS
13556
13557 =item DESCRIPTION
13558
13559 =item NOTE
13560
13561 =item AUTHOR
13562
13563 =back
13564
13565 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
13566 functions
13567
13568 =over 4
13569
13570 =item SYNOPSIS
13571
13572 =item DESCRIPTION
13573
13574 =item EXAMPLES
13575
13576 =item NOTE
13577
13578 =item AUTHOR
13579
13580 =back
13581
13582 =head2 Netrc, Net::Netrc - OO interface to users netrc file
13583
13584 =over 4
13585
13586 =item SYNOPSIS
13587
13588 =item DESCRIPTION
13589
13590 =item THE .netrc FILE
13591
13592 machine name, default, login name, password string, account string, macdef
13593 name
13594
13595 =item CONSTRUCTOR
13596
13597 lookup ( MACHINE [, LOGIN ])
13598
13599 =item METHODS
13600
13601 login (), password (), account (), lpa ()
13602
13603 =item AUTHOR
13604
13605 =item SEE ALSO
13606
13607 =item COPYRIGHT
13608
13609 =back
13610
13611 =head2 O - Generic interface to Perl Compiler backends
13612
13613 =over 4
13614
13615 =item SYNOPSIS
13616
13617 =item DESCRIPTION
13618
13619 =item CONVENTIONS
13620
13621 =item IMPLEMENTATION
13622
13623 =item AUTHOR
13624
13625 =back
13626
13627 =head2 ODBM_File - Tied access to odbm files
13628
13629 =over 4
13630
13631 =item SYNOPSIS
13632
13633 =item DESCRIPTION
13634
13635 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
13636
13637 =item DIAGNOSTICS
13638
13639 =over 4
13640
13641 =item C<odbm store returned -1, errno 22, key "..." at ...>
13642
13643 =back
13644
13645 =item BUGS AND WARNINGS
13646
13647 =back
13648
13649 =head2 Opcode - Disable named opcodes when compiling perl code
13650
13651 =over 4
13652
13653 =item SYNOPSIS
13654
13655 =item DESCRIPTION
13656
13657 =item NOTE
13658
13659 =item WARNING
13660
13661 =item Operator Names and Operator Lists
13662
13663 an operator name (opname), an operator tag name (optag), a negated opname
13664 or optag, an operator set (opset)
13665
13666 =item Opcode Functions
13667
13668 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
13669 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
13670 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
13671 opdump (PAT)
13672
13673 =item Manipulating Opsets
13674
13675 =item TO DO (maybe)
13676
13677 =back
13678
13679 =over 4
13680
13681 =item Predefined Opcode Tags
13682
13683 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
13684 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
13685 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
13686 :dangerous
13687
13688 =item SEE ALSO
13689
13690 =item AUTHORS
13691
13692 =back
13693
13694 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
13695 compartments
13696
13697 =over 4
13698
13699 =item SYNOPSIS
13700
13701 =item DESCRIPTION
13702
13703 a new namespace, an operator mask
13704
13705 =item WARNING
13706
13707 =over 4
13708
13709 =item RECENT CHANGES
13710
13711 =item Methods in class Safe
13712
13713 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
13714 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
13715 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
13716 root (NAMESPACE), mask (MASK)
13717
13718 =item Some Safety Issues
13719
13720 Memory, CPU, Snooping, Signals, State Changes
13721
13722 =item AUTHOR
13723
13724 =back
13725
13726 =back
13727
13728 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
13729 compiling
13730
13731 =over 4
13732
13733 =item SYNOPSIS
13734
13735 =item DESCRIPTION
13736
13737 =item SEE ALSO
13738
13739 =back
13740
13741 =head2 POSIX - Perl interface to IEEE Std 1003.1
13742
13743 =over 4
13744
13745 =item SYNOPSIS
13746
13747 =item DESCRIPTION
13748
13749 =item NOTE
13750
13751 =item CAVEATS
13752
13753 =item FUNCTIONS
13754
13755 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
13756 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
13757 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
13758 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
13759 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
13760 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
13761 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
13762 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
13763 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
13764 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
13765 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
13766 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
13767 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
13768 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
13769 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
13770 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
13771 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
13772 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
13773 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
13774 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
13775 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
13776 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
13777 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
13778 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
13779 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
13780 wctomb, write
13781
13782 =item CLASSES
13783
13784 =over 4
13785
13786 =item POSIX::SigAction
13787
13788 new
13789
13790 =item POSIX::SigSet
13791
13792 new, addset, delset, emptyset, fillset, ismember
13793
13794 =item POSIX::Termios
13795
13796 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
13797 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
13798 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
13799 field values, c_cflag field values, c_iflag field values, c_lflag field
13800 values, c_oflag field values
13801
13802 =back
13803
13804 =item PATHNAME CONSTANTS
13805
13806 Constants
13807
13808 =item POSIX CONSTANTS
13809
13810 Constants
13811
13812 =item SYSTEM CONFIGURATION
13813
13814 Constants
13815
13816 =item ERRNO
13817
13818 Constants
13819
13820 =item FCNTL
13821
13822 Constants
13823
13824 =item FLOAT
13825
13826 Constants
13827
13828 =item LIMITS
13829
13830 Constants
13831
13832 =item LOCALE
13833
13834 Constants
13835
13836 =item MATH
13837
13838 Constants
13839
13840 =item SIGNAL
13841
13842 Constants
13843
13844 =item STAT
13845
13846 Constants, Macros
13847
13848 =item STDLIB
13849
13850 Constants
13851
13852 =item STDIO
13853
13854 Constants
13855
13856 =item TIME
13857
13858 Constants
13859
13860 =item UNISTD
13861
13862 Constants
13863
13864 =item WAIT
13865
13866 Constants, Macros
13867
13868 =back
13869
13870 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
13871 name space
13872
13873 =over 4
13874
13875 =item SYNOPSIS
13876
13877 =item DESCRIPTION
13878
13879 unix, stdio, perlio, crlf, utf8, raw
13880
13881 =over 4
13882
13883 =item Defaults and how to override them
13884
13885 =back
13886
13887 =item AUTHOR
13888
13889 =item SEE ALSO
13890
13891 =back
13892
13893 =head2 PerlIO::Scalar - support module for in-memory IO.
13894
13895 =over 4
13896
13897 =item SYNOPSIS
13898
13899 =item DESCRIPTION
13900
13901 =back
13902
13903 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
13904
13905 =over 4
13906
13907 =item SYNOPSIS
13908
13909 =item DESCRIPTION
13910
13911 $class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
13912 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
13913 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
13914 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
13915 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
13916 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
13917 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
13918
13919 =back
13920
13921 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
13922
13923 =over 4
13924
13925 =item SYNOPSIS
13926
13927 =item OPTIONS/ARGUMENTS
13928
13929 =over 4
13930
13931 =item podchecker()
13932
13933 B<-warnings> =E<gt> I<val>
13934
13935 =back
13936
13937 =item DESCRIPTION
13938
13939 =item DIAGNOSTICS
13940
13941 =over 4
13942
13943 =item Errors
13944
13945 empty =headn, =over on line I<N> without closing =back, =item without
13946 previous =over, =back without previous =over, No argument for =begin, =end
13947 without =begin, Nested =begin's, =for without formatter specification,
13948 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
13949 interior-sequence "I<SEQ>", nested commands
13950 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
13951 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
13952 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
13953 after =back
13954
13955 =item Warnings
13956
13957 multiple occurence of link target I<name>, line containing nothing but
13958 whitespace in paragraph, file does not start with =head, previous =item has
13959 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
13960 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
13961 items in =over, No argument for =item, empty section in previous paragraph,
13962 Verbatim paragraph in NAME section
13963
13964 =item Hyperlinks
13965
13966 ignoring leading/trailing whitespace in link, (section) in '$page'
13967 deprecated, alternative text/node '%s' contains non-escaped | or /
13968
13969 =back
13970
13971 =item RETURN VALUE
13972
13973 =item EXAMPLES
13974
13975 =item INTERFACE
13976
13977 =back
13978
13979 C<Pod::Checker-E<gt>new( %options )>
13980
13981 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
13982 @args )>
13983
13984 C<$checker-E<gt>num_errors()>
13985
13986 C<$checker-E<gt>name()>
13987
13988 C<$checker-E<gt>node()>
13989
13990 C<$checker-E<gt>idx()>
13991
13992 C<$checker-E<gt>hyperlink()>
13993
13994 =over 4
13995
13996 =item AUTHOR
13997
13998 =back
13999
14000 =head2 Pod::Find - find POD documents in directory trees
14001
14002 =over 4
14003
14004 =item SYNOPSIS
14005
14006 =item DESCRIPTION
14007
14008 =back
14009
14010 =over 4
14011
14012 =item C<pod_find( { %opts } , @directories )>
14013
14014 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
14015 1>
14016
14017 =back
14018
14019 =over 4
14020
14021 =item C<simplify_name( $str )>
14022
14023 =back
14024
14025 =over 4
14026
14027 =item C<pod_where( { %opts }, $pod )>
14028
14029 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
14030 1>
14031
14032 =back
14033
14034 =over 4
14035
14036 =item C<contains_pod( $file , $verbose )>
14037
14038 =back
14039
14040 =over 4
14041
14042 =item AUTHOR
14043
14044 =item SEE ALSO
14045
14046 =back
14047
14048 =head2 Pod::Html - module to convert pod files to HTML
14049
14050 =over 4
14051
14052 =item SYNOPSIS
14053
14054 =item DESCRIPTION
14055
14056 =item ARGUMENTS
14057
14058 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
14059 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
14060 title, verbose
14061
14062 =item EXAMPLE
14063
14064 =item ENVIRONMENT
14065
14066 =item AUTHOR
14067
14068 =item SEE ALSO
14069
14070 =item COPYRIGHT
14071
14072 =back
14073
14074 =head2 Pod::InputObjects - objects representing POD input paragraphs,
14075 commands, etc.
14076
14077 =over 4
14078
14079 =item SYNOPSIS
14080
14081 =item REQUIRES
14082
14083 =item EXPORTS
14084
14085 =item DESCRIPTION
14086
14087 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
14088 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
14089
14090 =back
14091
14092 =over 4
14093
14094 =item B<Pod::InputSource>
14095
14096 =back
14097
14098 =over 4
14099
14100 =item B<new()>
14101
14102 =back
14103
14104 =over 4
14105
14106 =item B<name()>
14107
14108 =back
14109
14110 =over 4
14111
14112 =item B<handle()>
14113
14114 =back
14115
14116 =over 4
14117
14118 =item B<was_cutting()>
14119
14120 =back
14121
14122 =over 4
14123
14124 =item B<Pod::Paragraph>
14125
14126 =back
14127
14128 =over 4
14129
14130 =item Pod::Paragraph-E<gt>B<new()>
14131
14132 =back
14133
14134 =over 4
14135
14136 =item $pod_para-E<gt>B<cmd_name()>
14137
14138 =back
14139
14140 =over 4
14141
14142 =item $pod_para-E<gt>B<text()>
14143
14144 =back
14145
14146 =over 4
14147
14148 =item $pod_para-E<gt>B<raw_text()>
14149
14150 =back
14151
14152 =over 4
14153
14154 =item $pod_para-E<gt>B<cmd_prefix()>
14155
14156 =back
14157
14158 =over 4
14159
14160 =item $pod_para-E<gt>B<cmd_separator()>
14161
14162 =back
14163
14164 =over 4
14165
14166 =item $pod_para-E<gt>B<parse_tree()>
14167
14168 =back
14169
14170 =over 4
14171
14172 =item $pod_para-E<gt>B<file_line()>
14173
14174 =back
14175
14176 =over 4
14177
14178 =item B<Pod::InteriorSequence>
14179
14180 =back
14181
14182 =over 4
14183
14184 =item Pod::InteriorSequence-E<gt>B<new()>
14185
14186 =back
14187
14188 =over 4
14189
14190 =item $pod_seq-E<gt>B<cmd_name()>
14191
14192 =back
14193
14194 =over 4
14195
14196 =item $pod_seq-E<gt>B<prepend()>
14197
14198 =back
14199
14200 =over 4
14201
14202 =item $pod_seq-E<gt>B<append()>
14203
14204 =back
14205
14206 =over 4
14207
14208 =item $pod_seq-E<gt>B<nested()>
14209
14210 =back
14211
14212 =over 4
14213
14214 =item $pod_seq-E<gt>B<raw_text()>
14215
14216 =back
14217
14218 =over 4
14219
14220 =item $pod_seq-E<gt>B<left_delimiter()>
14221
14222 =back
14223
14224 =over 4
14225
14226 =item $pod_seq-E<gt>B<right_delimiter()>
14227
14228 =back
14229
14230 =over 4
14231
14232 =item $pod_seq-E<gt>B<parse_tree()>
14233
14234 =back
14235
14236 =over 4
14237
14238 =item $pod_seq-E<gt>B<file_line()>
14239
14240 =back
14241
14242 =over 4
14243
14244 =item Pod::InteriorSequence::B<DESTROY()>
14245
14246 =back
14247
14248 =over 4
14249
14250 =item B<Pod::ParseTree>
14251
14252 =back
14253
14254 =over 4
14255
14256 =item Pod::ParseTree-E<gt>B<new()>
14257
14258 =back
14259
14260 =over 4
14261
14262 =item $ptree-E<gt>B<top()>
14263
14264 =back
14265
14266 =over 4
14267
14268 =item $ptree-E<gt>B<children()>
14269
14270 =back
14271
14272 =over 4
14273
14274 =item $ptree-E<gt>B<prepend()>
14275
14276 =back
14277
14278 =over 4
14279
14280 =item $ptree-E<gt>B<append()>
14281
14282 =back
14283
14284 =over 4
14285
14286 =item $ptree-E<gt>B<raw_text()>
14287
14288 =back
14289
14290 =over 4
14291
14292 =item Pod::ParseTree::B<DESTROY()>
14293
14294 =back
14295
14296 =over 4
14297
14298 =item SEE ALSO
14299
14300 =item AUTHOR
14301
14302 =back
14303
14304 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
14305
14306 =over 4
14307
14308 =item SYNOPSIS
14309
14310 =item DESCRIPTION
14311
14312 =back
14313
14314 =over 4
14315
14316 =item OBJECT METHODS
14317
14318 C<initialize>
14319
14320 =back
14321
14322 =over 4
14323
14324 =item Data Accessors
14325
14326 B<AddPreamble>
14327
14328 =back
14329
14330 B<AddPostamble>
14331
14332 B<Head1Level>
14333
14334 B<Label>
14335
14336 B<LevelNoNum>
14337
14338 B<MakeIndex>
14339
14340 B<ReplaceNAMEwithSection>
14341
14342 B<StartWithNewPage>
14343
14344 B<TableOfContents>
14345
14346 B<UniqueLabels>
14347
14348 B<UserPreamble>
14349
14350 B<UserPostamble>
14351
14352 B<Lists>
14353
14354 =over 4
14355
14356 =item Subclassed methods
14357
14358 =back
14359
14360 B<begin_pod>
14361
14362 B<end_pod>
14363
14364 B<command>
14365
14366 B<verbatim>
14367
14368 B<textblock>
14369
14370 B<interior_sequence>
14371
14372 =over 4
14373
14374 =item List Methods
14375
14376 B<begin_list>
14377
14378 =back
14379
14380 B<end_list>
14381
14382 B<add_item>
14383
14384 =over 4
14385
14386 =item Methods for headings
14387
14388 B<head>
14389
14390 =back
14391
14392 =over 4
14393
14394 =item Internal methods
14395
14396 B<_output>
14397
14398 =back
14399
14400 B<_replace_special_chars>
14401
14402 B<_create_label>
14403
14404 B<_create_index>
14405
14406 B<_clean_latex_commands>
14407
14408 =over 4
14409
14410 =item NOTES
14411
14412 =item SEE ALSO
14413
14414 =item AUTHORS
14415
14416 =item COPYRIGHT
14417
14418 =item REVISION
14419
14420 =back
14421
14422 =head2 Pod::Man - Convert POD data to formatted *roff input
14423
14424 =over 4
14425
14426 =item SYNOPSIS
14427
14428 =item DESCRIPTION
14429
14430 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
14431 release, section
14432
14433 =item DIAGNOSTICS
14434
14435 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
14436 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
14437 escape EE<lt>%sE<gt>, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back
14438
14439 =item BUGS
14440
14441 =item SEE ALSO
14442
14443 =item AUTHOR
14444
14445 =item COPYRIGHT AND LICENSE
14446
14447 =back
14448
14449 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
14450
14451 =over 4
14452
14453 =item SYNOPSIS
14454
14455 =item DESCRIPTION
14456
14457 =back
14458
14459 =over 4
14460
14461 =item Pod::List
14462
14463 Pod::List-E<gt>new()
14464
14465 =back
14466
14467 $list-E<gt>file()
14468
14469 $list-E<gt>start()
14470
14471 $list-E<gt>indent()
14472
14473 $list-E<gt>type()
14474
14475 $list-E<gt>rx()
14476
14477 $list-E<gt>item()
14478
14479 $list-E<gt>parent()
14480
14481 $list-E<gt>tag()
14482
14483 =over 4
14484
14485 =item Pod::Hyperlink
14486
14487 Pod::Hyperlink-E<gt>new()
14488
14489 =back
14490
14491 $link-E<gt>parse($string)
14492
14493 $link-E<gt>markup($string)
14494
14495 $link-E<gt>text()
14496
14497 $link-E<gt>warning()
14498
14499 $link-E<gt>file(), $link-E<gt>line()
14500
14501 $link-E<gt>page()
14502
14503 $link-E<gt>node()
14504
14505 $link-E<gt>alttext()
14506
14507 $link-E<gt>type()
14508
14509 $link-E<gt>link()
14510
14511 =over 4
14512
14513 =item Pod::Cache
14514
14515 Pod::Cache-E<gt>new()
14516
14517 =back
14518
14519 $cache-E<gt>item()
14520
14521 $cache-E<gt>find_page($name)
14522
14523 =over 4
14524
14525 =item Pod::Cache::Item
14526
14527 Pod::Cache::Item-E<gt>new()
14528
14529 =back
14530
14531 $cacheitem-E<gt>page()
14532
14533 $cacheitem-E<gt>description()
14534
14535 $cacheitem-E<gt>path()
14536
14537 $cacheitem-E<gt>file()
14538
14539 $cacheitem-E<gt>nodes()
14540
14541 $cacheitem-E<gt>find_node($name)
14542
14543 $cacheitem-E<gt>idx()
14544
14545 =over 4
14546
14547 =item AUTHOR
14548
14549 =item SEE ALSO
14550
14551 =back
14552
14553 =head2 Pod::Parser - base class for creating POD filters and translators
14554
14555 =over 4
14556
14557 =item SYNOPSIS
14558
14559 =item REQUIRES
14560
14561 =item EXPORTS
14562
14563 =item DESCRIPTION
14564
14565 =item QUICK OVERVIEW
14566
14567 =item PARSING OPTIONS
14568
14569 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
14570 B<-warnings> (default: unset)
14571
14572 =back
14573
14574 =over 4
14575
14576 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
14577
14578 =back
14579
14580 =over 4
14581
14582 =item B<command()>
14583
14584 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
14585
14586 =back
14587
14588 =over 4
14589
14590 =item B<verbatim()>
14591
14592 C<$text>, C<$line_num>, C<$pod_para>
14593
14594 =back
14595
14596 =over 4
14597
14598 =item B<textblock()>
14599
14600 C<$text>, C<$line_num>, C<$pod_para>
14601
14602 =back
14603
14604 =over 4
14605
14606 =item B<interior_sequence()>
14607
14608 =back
14609
14610 =over 4
14611
14612 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
14613
14614 =back
14615
14616 =over 4
14617
14618 =item B<new()>
14619
14620 =back
14621
14622 =over 4
14623
14624 =item B<initialize()>
14625
14626 =back
14627
14628 =over 4
14629
14630 =item B<begin_pod()>
14631
14632 =back
14633
14634 =over 4
14635
14636 =item B<begin_input()>
14637
14638 =back
14639
14640 =over 4
14641
14642 =item B<end_input()>
14643
14644 =back
14645
14646 =over 4
14647
14648 =item B<end_pod()>
14649
14650 =back
14651
14652 =over 4
14653
14654 =item B<preprocess_line()>
14655
14656 =back
14657
14658 =over 4
14659
14660 =item B<preprocess_paragraph()>
14661
14662 =back
14663
14664 =over 4
14665
14666 =item METHODS FOR PARSING AND PROCESSING
14667
14668 =back
14669
14670 =over 4
14671
14672 =item B<parse_text()>
14673
14674 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
14675 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
14676 I<code-ref>|I<method-name>
14677
14678 =back
14679
14680 =over 4
14681
14682 =item B<interpolate()>
14683
14684 =back
14685
14686 =over 4
14687
14688 =item B<parse_paragraph()>
14689
14690 =back
14691
14692 =over 4
14693
14694 =item B<parse_from_filehandle()>
14695
14696 =back
14697
14698 =over 4
14699
14700 =item B<parse_from_file()>
14701
14702 =back
14703
14704 =over 4
14705
14706 =item ACCESSOR METHODS
14707
14708 =back
14709
14710 =over 4
14711
14712 =item B<errorsub()>
14713
14714 =back
14715
14716 =over 4
14717
14718 =item B<cutting()>
14719
14720 =back
14721
14722 =over 4
14723
14724 =item B<parseopts()>
14725
14726 =back
14727
14728 =over 4
14729
14730 =item B<output_file()>
14731
14732 =back
14733
14734 =over 4
14735
14736 =item B<output_handle()>
14737
14738 =back
14739
14740 =over 4
14741
14742 =item B<input_file()>
14743
14744 =back
14745
14746 =over 4
14747
14748 =item B<input_handle()>
14749
14750 =back
14751
14752 =over 4
14753
14754 =item B<input_streams()>
14755
14756 =back
14757
14758 =over 4
14759
14760 =item B<top_stream()>
14761
14762 =back
14763
14764 =over 4
14765
14766 =item PRIVATE METHODS AND DATA
14767
14768 =back
14769
14770 =over 4
14771
14772 =item B<_push_input_stream()>
14773
14774 =back
14775
14776 =over 4
14777
14778 =item B<_pop_input_stream()>
14779
14780 =back
14781
14782 =over 4
14783
14784 =item TREE-BASED PARSING
14785
14786 =item SEE ALSO
14787
14788 =item AUTHOR
14789
14790 =back
14791
14792 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
14793
14794 =over 4
14795
14796 =item SYNOPSIS
14797
14798 =item DESCRIPTION
14799
14800 =over 4
14801
14802 =item EXPORT
14803
14804 =back
14805
14806 =item AUTHOR
14807
14808 =item SEE ALSO
14809
14810 =back
14811
14812 =head2 Pod::Select, podselect() - extract selected sections of POD from
14813 input
14814
14815 =over 4
14816
14817 =item SYNOPSIS
14818
14819 =item REQUIRES
14820
14821 =item EXPORTS
14822
14823 =item DESCRIPTION
14824
14825 =item SECTION SPECIFICATIONS
14826
14827 =item RANGE SPECIFICATIONS
14828
14829 =back
14830
14831 =over 4
14832
14833 =item OBJECT METHODS
14834
14835 =back
14836
14837 =over 4
14838
14839 =item B<curr_headings()>
14840
14841 =back
14842
14843 =over 4
14844
14845 =item B<select()>
14846
14847 =back
14848
14849 =over 4
14850
14851 =item B<add_selection()>
14852
14853 =back
14854
14855 =over 4
14856
14857 =item B<clear_selections()>
14858
14859 =back
14860
14861 =over 4
14862
14863 =item B<match_section()>
14864
14865 =back
14866
14867 =over 4
14868
14869 =item B<is_selected()>
14870
14871 =back
14872
14873 =over 4
14874
14875 =item EXPORTED FUNCTIONS
14876
14877 =back
14878
14879 =over 4
14880
14881 =item B<podselect()>
14882
14883 B<-output>, B<-sections>, B<-ranges>
14884
14885 =back
14886
14887 =over 4
14888
14889 =item PRIVATE METHODS AND DATA
14890
14891 =back
14892
14893 =over 4
14894
14895 =item B<_compile_section_spec()>
14896
14897 =back
14898
14899 =over 4
14900
14901 =item $self->{_SECTION_HEADINGS}
14902
14903 =back
14904
14905 =over 4
14906
14907 =item $self->{_SELECTED_SECTIONS}
14908
14909 =back
14910
14911 =over 4
14912
14913 =item SEE ALSO
14914
14915 =item AUTHOR
14916
14917 =back
14918
14919 =head2 Pod::Text - Convert POD data to formatted ASCII text
14920
14921 =over 4
14922
14923 =item SYNOPSIS
14924
14925 =item DESCRIPTION
14926
14927 alt, indent, loose, quotes, sentence, width
14928
14929 =item DIAGNOSTICS
14930
14931 Bizarre space in item, Can't open %s for reading: %s, Invalid quote
14932 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
14933 %s, Unknown sequence: %s, Unmatched =back
14934
14935 =item RESTRICTIONS
14936
14937 =item NOTES
14938
14939 =item SEE ALSO
14940
14941 =item AUTHOR
14942
14943 =item COPYRIGHT AND LICENSE
14944
14945 =back
14946
14947 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
14948
14949 =over 4
14950
14951 =item SYNOPSIS
14952
14953 =item DESCRIPTION
14954
14955 =item BUGS
14956
14957 =item SEE ALSO
14958
14959 =item AUTHOR
14960
14961 =item COPYRIGHT AND LICENSE
14962
14963 =back
14964
14965 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
14966 text
14967
14968 =over 4
14969
14970 =item SYNOPSIS
14971
14972 =item DESCRIPTION
14973
14974 =item BUGS
14975
14976 =item SEE ALSO
14977
14978 =item AUTHOR
14979
14980 =item COPYRIGHT AND LICENSE
14981
14982 =back
14983
14984 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
14985 text with format escapes
14986
14987 =over 4
14988
14989 =item SYNOPSIS
14990
14991 =item DESCRIPTION
14992
14993 =item SEE ALSO
14994
14995 =item AUTHOR
14996
14997 =item COPYRIGHT AND LICENSE
14998
14999 =back
15000
15001 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
15002 documentation
15003
15004 =over 4
15005
15006 =item SYNOPSIS
15007
15008 =item ARGUMENTS
15009
15010 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
15011 C<-pathlist>
15012
15013 =item DESCRIPTION
15014
15015 =item EXAMPLES
15016
15017 =over 4
15018
15019 =item Recommended Use
15020
15021 =back
15022
15023 =item CAVEATS
15024
15025 =item AUTHOR
15026
15027 =item ACKNOWLEDGEMENTS
15028
15029 =back
15030
15031 =head2 SDBM_File - Tied access to sdbm files
15032
15033 =over 4
15034
15035 =item SYNOPSIS
15036
15037 =item DESCRIPTION
15038
15039 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15040
15041 =item DIAGNOSTICS
15042
15043 =over 4
15044
15045 =item C<sdbm store returned -1, errno 22, key "..." at ...>
15046
15047 =back
15048
15049 =item BUGS AND WARNINGS
15050
15051 =back
15052
15053 =head2 Safe - Compile and execute code in restricted compartments
15054
15055 =over 4
15056
15057 =item SYNOPSIS
15058
15059 =item DESCRIPTION
15060
15061 a new namespace, an operator mask
15062
15063 =item WARNING
15064
15065 =over 4
15066
15067 =item RECENT CHANGES
15068
15069 =item Methods in class Safe
15070
15071 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
15072 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
15073 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
15074 root (NAMESPACE), mask (MASK)
15075
15076 =item Some Safety Issues
15077
15078 Memory, CPU, Snooping, Signals, State Changes
15079
15080 =item AUTHOR
15081
15082 =back
15083
15084 =back
15085
15086 =head2 Scalar::Util - A selection of general-utility scalar subroutines
15087
15088 =over 4
15089
15090 =item SYNOPSIS
15091
15092 =item DESCRIPTION
15093
15094 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
15095 EXPR, tainted EXPR, weaken REF
15096
15097 =item COPYRIGHT
15098
15099 =item BLATANT PLUG
15100
15101 =back
15102
15103 =head2 Search::Dict, look - search for key in dictionary file
15104
15105 =over 4
15106
15107 =item SYNOPSIS
15108
15109 =item DESCRIPTION
15110
15111 =back
15112
15113 =head2 SelectSaver - save and restore selected file handle
15114
15115 =over 4
15116
15117 =item SYNOPSIS
15118
15119 =item DESCRIPTION
15120
15121 =back
15122
15123 =head2 SelfLoader - load functions only on demand
15124
15125 =over 4
15126
15127 =item SYNOPSIS
15128
15129 =item DESCRIPTION
15130
15131 =over 4
15132
15133 =item The __DATA__ token
15134
15135 =item SelfLoader autoloading
15136
15137 =item Autoloading and package lexicals
15138
15139 =item SelfLoader and AutoLoader
15140
15141 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
15142
15143 =item Classes and inherited methods.
15144
15145 =back
15146
15147 =item Multiple packages and fully qualified subroutine names
15148
15149 =back
15150
15151 =head2 Shell - run shell commands transparently within perl
15152
15153 =over 4
15154
15155 =item SYNOPSIS
15156
15157 =item DESCRIPTION
15158
15159 =over 4
15160
15161 =item OBJECT ORIENTED SYNTAX
15162
15163 =back
15164
15165 =item AUTHOR
15166
15167 =back
15168
15169 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
15170 socket.h defines and structure manipulators
15171
15172 =over 4
15173
15174 =item SYNOPSIS
15175
15176 =item DESCRIPTION
15177
15178 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
15179 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
15180 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
15181 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
15182 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
15183
15184 =back
15185
15186 =head2 Storable - persistency for perl data structures
15187
15188 =over 4
15189
15190 =item SYNOPSIS
15191
15192 =item DESCRIPTION
15193
15194 =item MEMORY STORE
15195
15196 =item ADVISORY LOCKING
15197
15198 =item SPEED
15199
15200 =item CANONICAL REPRESENTATION
15201
15202 =item ERROR REPORTING
15203
15204 =item WIZARDS ONLY
15205
15206 =over 4
15207
15208 =item Hooks
15209
15210 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
15211 I<serialized>, ..
15212
15213 =item Predicates
15214
15215 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
15216 C<Storable::is_retrieving>
15217
15218 =item Recursion
15219
15220 =item Deep Cloning
15221
15222 =back
15223
15224 =item EXAMPLES
15225
15226 =item WARNING
15227
15228 =item BUGS
15229
15230 =item CREDITS
15231
15232 =item TRANSLATIONS
15233
15234 =item AUTHOR
15235
15236 =item SEE ALSO
15237
15238 =back
15239
15240 =head2 Switch - A switch statement for Perl
15241
15242 =over 4
15243
15244 =item VERSION
15245
15246 =item SYNOPSIS
15247
15248 =item BACKGROUND
15249
15250 =item DESCRIPTION
15251
15252 =over 4
15253
15254 =item Allowing fall-through
15255
15256 =item Automating fall-through
15257
15258 =item Alternative syntax
15259
15260 =item Higher-order Operations
15261
15262 =back
15263
15264 =item DEPENDENCIES
15265
15266 =item AUTHOR
15267
15268 =item BUGS
15269
15270 =item COPYRIGHT
15271
15272 =back
15273
15274 =head2 Symbol - manipulate Perl symbols and their names
15275
15276 =over 4
15277
15278 =item SYNOPSIS
15279
15280 =item DESCRIPTION
15281
15282 =back
15283
15284 =head2 Sys::Hostname - Try every conceivable way to get hostname
15285
15286 =over 4
15287
15288 =item SYNOPSIS
15289
15290 =item DESCRIPTION
15291
15292 =item AUTHOR
15293
15294 =back
15295
15296 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
15297 interface to the UNIX syslog(3) calls
15298
15299 =over 4
15300
15301 =item SYNOPSIS
15302
15303 =item DESCRIPTION
15304
15305 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
15306 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
15307 closelog
15308
15309 =item EXAMPLES
15310
15311 =item SEE ALSO
15312
15313 =item AUTHOR
15314
15315 =back
15316
15317 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
15318 Perl interface to the UNIX syslog(3) calls
15319
15320 =over 4
15321
15322 =item SYNOPSIS
15323
15324 =item DESCRIPTION
15325
15326 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
15327 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
15328 closelog
15329
15330 =item EXAMPLES
15331
15332 =item SEE ALSO
15333
15334 =item AUTHOR
15335
15336 =back
15337
15338 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
15339
15340 =over 4
15341
15342 =item SYNOPSIS
15343
15344 =item DESCRIPTION
15345
15346 =item DIAGNOSTICS
15347
15348 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
15349 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
15350 comma allowed after filehandle, No name for escape sequence %s
15351
15352 =item ENVIRONMENT
15353
15354 ANSI_COLORS_DISABLED
15355
15356 =item RESTRICTIONS
15357
15358 =item NOTES
15359
15360 =item SEE ALSO
15361
15362 =item AUTHORS
15363
15364 =item LICENSE
15365
15366 =back
15367
15368 =head2 Term::Cap - Perl termcap interface
15369
15370 =over 4
15371
15372 =item SYNOPSIS
15373
15374 =item DESCRIPTION
15375
15376 =item EXAMPLES
15377
15378 =back
15379
15380 =head2 Term::Complete - Perl word completion module
15381
15382 =over 4
15383
15384 =item SYNOPSIS
15385
15386 =item DESCRIPTION
15387
15388 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
15389
15390 =item DIAGNOSTICS
15391
15392 =item BUGS
15393
15394 =item AUTHOR
15395
15396 =back
15397
15398 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
15399 no real package is found, substitutes stubs instead of basic functions.
15400
15401 =over 4
15402
15403 =item SYNOPSIS
15404
15405 =item DESCRIPTION
15406
15407 =item Minimal set of supported functions
15408
15409 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
15410 C<MinLine>, C<findConsole>, Attribs, C<Features>
15411
15412 =item Additional supported functions
15413
15414 C<tkRunning>, C<ornaments>, C<newTTY>
15415
15416 =item EXPORTS
15417
15418 =item ENVIRONMENT
15419
15420 =item CAVEATS
15421
15422 =back
15423
15424 =head2 Test - provides a simple framework for writing test scripts
15425
15426 =over 4
15427
15428 =item SYNOPSIS
15429
15430 =item DESCRIPTION
15431
15432 =over 4
15433
15434 =item Functions
15435
15436 B<plan>
15437
15438 =back
15439
15440 =back
15441
15442 B<_to_value>
15443
15444 B<ok>
15445
15446 =over 4
15447
15448 =item TEST TYPES
15449
15450 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
15451
15452 =item ONFAIL
15453
15454 =item BUGS and CAVEATS
15455
15456 =item TODO
15457
15458 =item SEE ALSO
15459
15460 =item AUTHOR
15461
15462 =back
15463
15464 =head2 Test::Builder - Backend for building test libraries
15465
15466 =over 4
15467
15468 =item SYNOPSIS
15469
15470 =item DESCRIPTION
15471
15472 =over 4
15473
15474 =item Construction
15475
15476 B<new>
15477
15478 =back
15479
15480 =back
15481
15482 =over 4
15483
15484 =item Setting up tests
15485
15486 B<exported_to>
15487
15488 =back
15489
15490 B<plan>
15491
15492 B<expected_tests>
15493
15494 B<no_plan>
15495
15496 B<skip_all>
15497
15498 =over 4
15499
15500 =item Running tests
15501
15502 B<ok>
15503
15504 =back
15505
15506 B<is_eq>, B<is_num>
15507
15508 B<like>
15509
15510 B<skip>
15511
15512 B<skip_rest>
15513
15514 =over 4
15515
15516 =item Test style
15517
15518 B<level>
15519
15520 =back
15521
15522 B<use_numbers>
15523
15524 B<no_header>, B<no_ending>
15525
15526 =over 4
15527
15528 =item Output
15529
15530 B<diag>
15531
15532 =back
15533
15534 B<_print>
15535
15536 B<output>, B<failure_output>, B<todo_output>
15537
15538 =over 4
15539
15540 =item Test Status and Info
15541
15542 B<current_test>
15543
15544 =back
15545
15546 B<summary>
15547
15548 B<details>  I<UNIMPLEMENTED>, B<todo>
15549
15550 B<caller>
15551
15552 B<_sanity_check>
15553
15554 B<_whoa>
15555
15556 B<_my_exit>
15557
15558 =over 4
15559
15560 =item EXAMPLES
15561
15562 =item AUTHOR
15563
15564 =item SEE ALSO
15565
15566 =back
15567
15568 =head2 Test::Harness - run perl standard test scripts with statistics
15569
15570 =over 4
15571
15572 =item SYNOPSIS
15573
15574 =item DESCRIPTION
15575
15576 =over 4
15577
15578 =item The test script output
15579
15580 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
15581 B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
15582 B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything else>
15583
15584 =item Failure
15585
15586 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
15587 Failed>
15588
15589 =item Functions
15590
15591 B<runtests>
15592
15593 =back
15594
15595 =back
15596
15597 B<_all_ok>
15598
15599 B<_globdir>
15600
15601 B<_run_all_tests>
15602
15603 B<_mk_leader>
15604
15605 =over 4
15606
15607 =item EXPORT
15608
15609 =item DIAGNOSTICS
15610
15611 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
15612 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
15613 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
15614 %s>, C<FAILED--Further testing stopped%s>
15615
15616 =item ENVIRONMENT
15617
15618 C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
15619 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
15620 C<HARNESS_ACTIVE>
15621
15622 =item EXAMPLE
15623
15624 =item SEE ALSO
15625
15626 =item AUTHORS
15627
15628 =item TODO
15629
15630 =item BUGS
15631
15632 =back
15633
15634 =head2 Test::More - yet another framework for writing test scripts
15635
15636 =over 4
15637
15638 =item SYNOPSIS
15639
15640 =item DESCRIPTION
15641
15642 =over 4
15643
15644 =item I love it when a plan comes together
15645
15646 =back
15647
15648 =back
15649
15650 =over 4
15651
15652 =item Test names
15653
15654 =item I'm ok, you're not ok.
15655
15656 B<ok>
15657
15658 =back
15659
15660 B<is>, B<isnt>
15661
15662 B<like>
15663
15664 B<can_ok>
15665
15666 B<isa_ok>
15667
15668 B<pass>, B<fail>
15669
15670 =over 4
15671
15672 =item Module tests
15673
15674 B<use_ok>
15675
15676 =back
15677
15678 B<require_ok>
15679
15680 =over 4
15681
15682 =item Conditional tests
15683
15684 B<SKIP: BLOCK>
15685
15686 =back
15687
15688 B<TODO: BLOCK>
15689
15690 =over 4
15691
15692 =item Comparision functions
15693
15694 B<is_deeply>
15695
15696 =back
15697
15698 B<eq_array>
15699
15700 B<eq_hash>
15701
15702 B<eq_set>
15703
15704 =over 4
15705
15706 =item NOTES
15707
15708 =item BUGS and CAVEATS
15709
15710 Making your own ok(), The eq_* family have some caveats, Test::Harness
15711 upgrades
15712
15713 =item AUTHOR
15714
15715 =item HISTORY
15716
15717 =item SEE ALSO
15718
15719 =back
15720
15721 =head2 Test::Simple - Basic utilities for writing tests.
15722
15723 =over 4
15724
15725 =item SYNOPSIS
15726
15727 =item DESCRIPTION
15728
15729 B<ok>
15730
15731 =back
15732
15733 =over 4
15734
15735 =item EXAMPLE
15736
15737 =item CAVEATS
15738
15739 =item NOTES
15740
15741 =item HISTORY
15742
15743 =item AUTHOR
15744
15745 =item SEE ALSO
15746
15747 L<Test::More>, L<Test>, L<Test::Unit>, L<Pod::Tests>, L<SelfTest>,
15748 L<Test::Harness>
15749
15750 =back
15751
15752 =head2 Test::Tutorial - A tutorial about writing really basic tests
15753
15754 =over 4
15755
15756 =item DESCRIPTION
15757
15758 =over 4
15759
15760 =item Nuts and bolts of testing.
15761
15762 =item Where to start?
15763
15764 =item Names
15765
15766 =item Test the manual
15767
15768 =item Sometimes the tests are wrong
15769
15770 =item Testing lots of values
15771
15772 =item Informative names
15773
15774 =item Skipping tests
15775
15776 =item Todo tests
15777
15778 =item Testing with taint mode.
15779
15780 =back
15781
15782 =item FOOTNOTES
15783
15784 =back
15785
15786 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
15787
15788 =over 4
15789
15790 =item SYNOPSIS
15791
15792 =item DESCRIPTION
15793
15794 =item EXAMPLE
15795
15796 =back
15797
15798 =head2 Text::Balanced - Extract delimited text sequences from strings.
15799
15800 =over 4
15801
15802 =item SYNOPSIS
15803
15804 =item DESCRIPTION
15805
15806 =over 4
15807
15808 =item General behaviour in list contexts
15809
15810 [0], [1], [2]
15811
15812 =item General behaviour in scalar and void contexts
15813
15814 =item A note about prefixes
15815
15816 =item C<extract_delimited>
15817
15818 =item C<extract_bracketed>
15819
15820 =item C<extract_tagged>
15821
15822 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
15823 [0], [1], [2], [3], [4], [5]
15824
15825 =item C<gen_extract_tagged>
15826
15827 =item C<extract_quotelike>
15828
15829 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
15830
15831 =item C<extract_quotelike> and "here documents"
15832
15833 [0], [1], [2], [3], [4], [5], [6], [7..10]
15834
15835 =item C<extract_codeblock>
15836
15837 =item C<extract_multiple>
15838
15839 =item C<gen_delimited_pat>
15840
15841 =back
15842
15843 =item DIAGNOSTICS
15844
15845  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
15846 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
15847 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
15848 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
15849 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
15850 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
15851 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
15852 after dereferencer>, C<Did not find expected opening bracket at %s>,
15853 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
15854 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
15855 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
15856 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
15857 tag>
15858
15859 =item AUTHOR
15860
15861 =item BUGS AND IRRITATIONS
15862
15863 =item COPYRIGHT
15864
15865 =back
15866
15867 =head2 Text::ParseWords - parse text into an array of tokens or array of
15868 arrays
15869
15870 =over 4
15871
15872 =item SYNOPSIS
15873
15874 =item DESCRIPTION
15875
15876 =item EXAMPLES
15877
15878 =item AUTHORS
15879
15880 =back
15881
15882 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
15883 by Knuth
15884
15885 =over 4
15886
15887 =item SYNOPSIS
15888
15889 =item DESCRIPTION
15890
15891 =item EXAMPLES
15892
15893 =item LIMITATIONS
15894
15895 =item AUTHOR
15896
15897 =back
15898
15899 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
15900 unexpand(1)
15901
15902 =over 4
15903
15904 =item SYNOPSIS
15905
15906 =item DESCRIPTION
15907
15908 =item BUGS
15909
15910 =item AUTHOR
15911
15912 =back
15913
15914 =head2 Text::Wrap - line wrapping to form simple paragraphs
15915
15916 =over 4
15917
15918 =item SYNOPSIS
15919
15920 =item DESCRIPTION
15921
15922 =item OVERRIDES
15923
15924 =item EXAMPLE
15925
15926 =item AUTHOR
15927
15928 =back
15929
15930 =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
15931 change)
15932
15933 =over 4
15934
15935 =item CAVEAT
15936
15937 =item SYNOPSIS
15938
15939 =item DESCRIPTION
15940
15941 =item FUNCTIONS
15942
15943 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
15944 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
15945 cond_broadcast VARIABLE, yield
15946
15947 =item METHODS
15948
15949 join, eval, detach, equal, tid, flags, done
15950
15951 =item LIMITATIONS
15952
15953 =item SEE ALSO
15954
15955 =back
15956
15957 =head2 Thread::Queue - thread-safe queues
15958
15959 =over 4
15960
15961 =item SYNOPSIS
15962
15963 =item DESCRIPTION
15964
15965 =item FUNCTIONS AND METHODS
15966
15967 new, enqueue LIST, dequeue, dequeue_nb, pending
15968
15969 =item SEE ALSO
15970
15971 =back
15972
15973 =head2 Thread::Semaphore - thread-safe semaphores
15974
15975 =over 4
15976
15977 =item SYNOPSIS
15978
15979 =item DESCRIPTION
15980
15981 =item FUNCTIONS AND METHODS
15982
15983 new, new NUMBER, down, down NUMBER, up, up NUMBER
15984
15985 =back
15986
15987 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
15988
15989 =over 4
15990
15991 =item SYNOPSIS
15992
15993 =item DESCRIPTION
15994
15995 =item BUGS
15996
15997 =back
15998
15999 =head2 Thread::Specific - thread-specific keys
16000
16001 =over 4
16002
16003 =item SYNOPSIS
16004
16005 =item DESCRIPTION
16006
16007 =back
16008
16009 =head2 Tie::Array - base class for tied arrays
16010
16011 =over 4
16012
16013 =item SYNOPSIS
16014
16015 =item DESCRIPTION
16016
16017 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
16018 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
16019 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
16020 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
16021
16022 =item CAVEATS
16023
16024 =item AUTHOR
16025
16026 =back
16027
16028 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
16029 handles
16030
16031 =over 4
16032
16033 =item SYNOPSIS
16034
16035 =item DESCRIPTION
16036
16037 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
16038 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
16039 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
16040 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
16041
16042 =item MORE INFORMATION
16043
16044 =item COMPATIBILITY
16045
16046 =back
16047
16048 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
16049
16050 =over 4
16051
16052 =item SYNOPSIS
16053
16054 =item DESCRIPTION
16055
16056 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
16057 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
16058
16059 =item CAVEATS
16060
16061 =item MORE INFORMATION
16062
16063 =back
16064
16065 =head2 Tie::RefHash - use references as hash keys
16066
16067 =over 4
16068
16069 =item SYNOPSIS
16070
16071 =item DESCRIPTION
16072
16073 =item EXAMPLE
16074
16075 =item AUTHOR
16076
16077 =item VERSION
16078
16079 =item SEE ALSO
16080
16081 =back
16082
16083 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
16084 scalars
16085
16086 =over 4
16087
16088 =item SYNOPSIS
16089
16090 =item DESCRIPTION
16091
16092 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
16093
16094 =item MORE INFORMATION
16095
16096 =back
16097
16098 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
16099
16100 =over 4
16101
16102 =item SYNOPSIS
16103
16104 =item DESCRIPTION
16105
16106 =item CAVEATS
16107
16108 =back
16109
16110 =head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday
16111
16112 =over 4
16113
16114 =item SYNOPSIS
16115
16116 =item DESCRIPTION
16117
16118 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
16119 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
16120 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
16121 getitimer ( $which )
16122
16123 =item EXAMPLES
16124
16125 =item C API
16126
16127 =item CAVEATS
16128
16129 =item AUTHORS
16130
16131 =item REVISION
16132
16133 =item COPYRIGHT
16134
16135 =back
16136
16137 =head2 Time::Local - efficiently compute time from local and GMT time
16138
16139 =over 4
16140
16141 =item SYNOPSIS
16142
16143 =item DESCRIPTION
16144
16145 =item IMPLEMENTATION
16146
16147 =item BUGS
16148
16149 =back
16150
16151 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
16152 function
16153
16154 =over 4
16155
16156 =item SYNOPSIS
16157
16158 =item DESCRIPTION
16159
16160 =item NOTE
16161
16162 =item AUTHOR
16163
16164 =back
16165
16166 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
16167 function
16168
16169 =over 4
16170
16171 =item SYNOPSIS
16172
16173 =item DESCRIPTION
16174
16175 =item NOTE
16176
16177 =item AUTHOR
16178
16179 =back
16180
16181 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
16182
16183 =over 4
16184
16185 =item SYNOPSIS
16186
16187 =item DESCRIPTION
16188
16189 =item AUTHOR
16190
16191 =back
16192
16193 =head2 UNIVERSAL - base class for ALL classes (blessed references)
16194
16195 =over 4
16196
16197 =item SYNOPSIS
16198
16199 =item DESCRIPTION
16200
16201 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
16202 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
16203
16204 =back
16205
16206 =head2 Unicode::Collate - use UCA (Unicode Collation Algorithm)
16207
16208 =over 4
16209
16210 =item SYNOPSIS
16211
16212 =item DESCRIPTION
16213
16214 =over 4
16215
16216 =item Constructor and Tailoring
16217
16218 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
16219 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
16220 undefChar, katakana_before_hiragana, upper_before_lower
16221
16222 =item Other methods
16223
16224 C<@sorted = $UCA-E<gt>sort(@not_sorted)>, C<$result = $UCA-E<gt>cmp($a,
16225 $b)>, C<$sortKey = $UCA-E<gt>getSortKey($string)>, C<$position =
16226 $UCA-E<gt>index($string, $substring)>, C<($position, $length) =
16227 $UCA-E<gt>index($string, $substring)>
16228
16229 =item EXPORT
16230
16231 =item CAVEAT
16232
16233 =back
16234
16235 =item AUTHOR
16236
16237 =item SEE ALSO
16238
16239 L<Lingua::KO::Hangul::Util>, L<Unicode::Normalize>, Unicode Collation
16240 Algorithm - Unicode TR #10
16241
16242 =back
16243
16244 =head2 Unicode::Normalize - normalized forms of Unicode text
16245
16246 =over 4
16247
16248 =item SYNOPSIS
16249
16250 =item DESCRIPTION
16251
16252 C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>,
16253 C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>,
16254 C<$normalized_string = normalize($form_name, $raw_string)>
16255
16256 =over 4
16257
16258 =item EXPORT
16259
16260 =back
16261
16262 =item AUTHOR
16263
16264 =item SEE ALSO
16265
16266 L<Lingua::KO::Hangul::Util>, http://www.unicode.org/unicode/reports/tr15/
16267
16268 =back
16269
16270 =head2 Unicode::UCD - Unicode character database
16271
16272 =over 4
16273
16274 =item SYNOPSIS
16275
16276 =item DESCRIPTION
16277
16278 =back
16279
16280 =over 4
16281
16282 =item charinfo
16283
16284 =back
16285
16286 =over 4
16287
16288 =item charblock
16289
16290 =back
16291
16292 =over 4
16293
16294 =item charscript
16295
16296 =back
16297
16298 =over 4
16299
16300 =item charblocks
16301
16302 =back
16303
16304 =over 4
16305
16306 =item charscripts
16307
16308 =back
16309
16310 =over 4
16311
16312 =item Blocks versus Scripts
16313
16314 =item Matching Scripts and Blocks
16315
16316 =item Code Point Arguments
16317
16318 =item charinrange
16319
16320 =back
16321
16322 =over 4
16323
16324 =item compexcl
16325
16326 =back
16327
16328 =over 4
16329
16330 =item casefold
16331
16332 =back
16333
16334 =over 4
16335
16336 =item casespec
16337
16338 =back
16339
16340 =over 4
16341
16342 =item Unicode::UCD::UnicodeVersion
16343
16344 =back
16345
16346 =over 4
16347
16348 =item Implementation Note
16349
16350 =back
16351
16352 =over 4
16353
16354 =item AUTHOR
16355
16356 =back
16357
16358 =head2 User::grent - by-name interface to Perl's built-in getgr*()
16359 functions
16360
16361 =over 4
16362
16363 =item SYNOPSIS
16364
16365 =item DESCRIPTION
16366
16367 =item NOTE
16368
16369 =item AUTHOR
16370
16371 =back
16372
16373 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
16374 functions
16375
16376 =over 4
16377
16378 =item SYNOPSIS
16379
16380 =item DESCRIPTION
16381
16382 =over 4
16383
16384 =item System Specifics
16385
16386 =back
16387
16388 =item NOTE
16389
16390 =item AUTHOR
16391
16392 =item HISTORY
16393
16394 March 18th, 2000
16395
16396 =back
16397
16398 =head2 Win32 - Interfaces to some Win32 API Functions
16399
16400 =over 4
16401
16402 =item DESCRIPTION
16403
16404 =over 4
16405
16406 =item Alphabetical Listing of Win32 Functions
16407
16408 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
16409 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
16410 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
16411 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
16412 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
16413 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
16414 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
16415 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
16416 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
16417 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
16418 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
16419 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
16420 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
16421 Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
16422 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
16423 PID), Win32::UnregisterServer(LIBRARYNAME)
16424
16425 =back
16426
16427 =back
16428
16429 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
16430
16431 =over 4
16432
16433 =item SYNOPSIS
16434
16435 =item DESCRIPTION
16436
16437 =back
16438
16439 =over 4
16440
16441 =item NOTES
16442
16443 =item AUTHOR
16444
16445 =back
16446
16447 =head2 XSLoader - Dynamically load C libraries into Perl code
16448
16449 =over 4
16450
16451 =item SYNOPSIS
16452
16453 =item DESCRIPTION
16454
16455 =item AUTHOR
16456
16457 =back
16458
16459 =head1 AUXILIARY DOCUMENTATION
16460
16461 Here should be listed all the extra programs' documentation, but they
16462 don't all have manual pages yet:
16463
16464 =over 4
16465
16466 =item a2p
16467
16468 =item s2p
16469
16470 =item find2perl
16471
16472 =item h2ph
16473
16474 =item c2ph
16475
16476 =item h2xs
16477
16478 =item xsubpp
16479
16480 =item pod2man
16481
16482 =item wrapsuid
16483
16484 =back
16485
16486 =head1 AUTHOR
16487
16488 Larry Wall <F<larry@wall.org>>, with the help of oodles
16489 of other folks.
16490