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