pod/perltoc.pod

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