pod/perltoc.pod

   1
   2 =head1 NAME
   3
   4 perltoc - perl documentation table of contents
   5
   6 =head1 DESCRIPTION
   7
   8 This page provides a brief table of contents for the rest of the Perl
   9 documentation set.  It is meant to be scanned quickly or grepped
  10 through to locate the proper section you're looking for.
  11
  12 =head1 BASIC DOCUMENTATION
  13
  14 =head2 perl - Practical Extraction and Report Language
  15
  16 =over 4
  17
  18 =item SYNOPSIS
  19
  20 =over 4
  21
  22 =item Overview
  23
  24 =item Tutorials
  25
  26 =item Reference Manual
  27
  28 =item Internals and C Language Interface
  29
  30 =item Miscellaneous
  31
  32 =item Language-Specific
  33
  34 =item Platform-Specific
  35
  36 =back
  37
  38 =item DESCRIPTION
  39
  40 =item AVAILABILITY
  41
  42 =item ENVIRONMENT
  43
  44 =item AUTHOR
  45
  46 =item FILES
  47
  48 =item SEE ALSO
  49
  50 =item DIAGNOSTICS
  51
  52 =item BUGS
  53
  54 =item NOTES
  55
  56 =back
  57
  58 =head2 perlintro -- a brief introduction and overview of Perl
  59
  60 =over 4
  61
  62 =item DESCRIPTION
  63
  64 =over 4
  65
  66 =item What is Perl?
  67
  68 =item Running Perl programs
  69
  70 =item Basic syntax overview
  71
  72 =item Perl variable types
  73
  74 Scalars, Arrays, Hashes
  75
  76 =item Variable scoping
  77
  78 =item Conditional and looping constructs
  79
  80 if, while, for, foreach
  81
  82 =item Builtin operators and functions
  83
  84 Arithmetic, Numeric comparison, String comparison, Boolean logic,
  85 Miscellaneous
  86
  87 =item Files and I/O
  88
  89 =item Regular expressions
  90
  91 Simple matching, Simple substitution, More complex regular expressions,
  92 Parentheses for capturing, Other regexp features
  93
  94 =item Writing subroutines
  95
  96 =item OO Perl
  97
  98 =item Using Perl modules
  99
 100 =back
 101
 102 =item AUTHOR
 103
 104 =back
 105
 106 =head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31
 107 17:37:17 $)
 108
 109 =over 4
 110
 111 =item DESCRIPTION
 112
 113 =over 4
 114
 115 =item Where to get the perlfaq
 116
 117 =item How to contribute to the perlfaq
 118
 119 =item What will happen if you mail your Perl programming problems to the
 120 authors
 121
 122 =back
 123
 124 =item Credits
 125
 126 =item Author and Copyright Information
 127
 128 =over 4
 129
 130 =item Bundled Distributions
 131
 132 =item Disclaimer
 133
 134 =back
 135
 136 =item Table of Contents
 137
 138 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
 139 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
 140 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
 141 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
 142 Interaction, perlfaq9 - Networking
 143
 144 =item The Questions
 145
 146 =over 4
 147
 148 =item L<perlfaq1>: General Questions About Perl
 149
 150 =item L<perlfaq2>: Obtaining and Learning about Perl
 151
 152 =item L<perlfaq3>: Programming Tools
 153
 154 =item L<perlfaq4>: Data Manipulation
 155
 156 =item L<perlfaq5>: Files and Formats
 157
 158 =item L<perlfaq6>: Regular Expressions
 159
 160 =item L<perlfaq7>: General Perl Language Issues
 161
 162 =item L<perlfaq8>: System Interaction
 163
 164 =item L<perlfaq9>: Networking
 165
 166 =back
 167
 168 =back
 169
 170 =head2 perlbook - Perl book information
 171
 172 =over 4
 173
 174 =item DESCRIPTION
 175
 176 =back
 177
 178 =head2 perlsyn - Perl syntax
 179
 180 =over 4
 181
 182 =item DESCRIPTION
 183
 184 =over 4
 185
 186 =item Declarations
 187
 188 =item Comments
 189
 190 =item Simple Statements
 191
 192 =item Compound Statements
 193
 194 =item Loop Control
 195
 196 =item For Loops
 197
 198 =item Foreach Loops
 199
 200 =item Basic BLOCKs and Switch Statements
 201
 202 =item Goto
 203
 204 =item PODs: Embedded Documentation
 205
 206 =item Plain Old Comments (Not!)
 207
 208 =back
 209
 210 =back
 211
 212 =head2 perldata - Perl data types
 213
 214 =over 4
 215
 216 =item DESCRIPTION
 217
 218 =over 4
 219
 220 =item Variable names
 221
 222 =item Context
 223
 224 =item Scalar values
 225
 226 =item Scalar value constructors
 227
 228 =item List value constructors
 229
 230 =item Subscripts
 231
 232 =item Slices
 233
 234 =item Typeglobs and Filehandles
 235
 236 =back
 237
 238 =item SEE ALSO
 239
 240 =back
 241
 242 =head2 perlop - Perl operators and precedence
 243
 244 =over 4
 245
 246 =item SYNOPSIS
 247
 248 =item DESCRIPTION
 249
 250 =over 4
 251
 252 =item Terms and List Operators (Leftward)
 253
 254 =item The Arrow Operator
 255
 256 =item Auto-increment and Auto-decrement
 257
 258 =item Exponentiation
 259
 260 =item Symbolic Unary Operators
 261
 262 =item Binding Operators
 263
 264 =item Multiplicative Operators
 265
 266 =item Additive Operators
 267
 268 =item Shift Operators
 269
 270 =item Named Unary Operators
 271
 272 =item Relational Operators
 273
 274 =item Equality Operators
 275
 276 =item Bitwise And
 277
 278 =item Bitwise Or and Exclusive Or
 279
 280 =item C-style Logical And
 281
 282 =item C-style Logical Or
 283
 284 =item C-style Logical Defined-Or
 285
 286 =item Range Operators
 287
 288 =item Conditional Operator
 289
 290 =item Assignment Operators
 291
 292 =item Comma Operator
 293
 294 =item List Operators (Rightward)
 295
 296 =item Logical Not
 297
 298 =item Logical And
 299
 300 =item Logical or, Defined or, and Exclusive Or
 301
 302 =item C Operators Missing From Perl
 303
 304 unary &, unary *, (TYPE)
 305
 306 =item Quote and Quote-like Operators
 307
 308 =item Regexp Quote-Like Operators
 309
 310 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 311 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 312 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 313 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 314
 315 =item Gory details of parsing quoted constructs
 316
 317 Finding the end, Removal of backslashes before delimiters, Interpolation,
 318 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 319 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 320 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 321 regular expressions
 322
 323 =item I/O Operators
 324
 325 =item Constant Folding
 326
 327 =item Bitwise String Operators
 328
 329 =item Integer Arithmetic
 330
 331 =item Floating-point Arithmetic
 332
 333 =item Bigger Numbers
 334
 335 =back
 336
 337 =back
 338
 339 =head2 perlsub - Perl subroutines
 340
 341 =over 4
 342
 343 =item SYNOPSIS
 344
 345 =item DESCRIPTION
 346
 347 =over 4
 348
 349 =item Private Variables via my()
 350
 351 =item Persistent Private Variables
 352
 353 =item Temporary Values via local()
 354
 355 =item Lvalue subroutines
 356
 357 Lvalue subroutines are EXPERIMENTAL
 358
 359 =item Passing Symbol Table Entries (typeglobs)
 360
 361 =item When to Still Use local()
 362
 363 =item Pass by Reference
 364
 365 =item Prototypes
 366
 367 =item Constant Functions
 368
 369 =item Overriding Built-in Functions
 370
 371 =item Autoloading
 372
 373 =item Subroutine Attributes
 374
 375 =back
 376
 377 =item SEE ALSO
 378
 379 =back
 380
 381 =head2 perlfunc - Perl builtin functions
 382
 383 =over 4
 384
 385 =item DESCRIPTION
 386
 387 =over 4
 388
 389 =item Perl Functions by Category
 390
 391 Functions for SCALARs or strings, Regular expressions and pattern matching,
 392 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 393 Functions for real %HASHes, Input and output functions, Functions for fixed
 394 length data or records, Functions for filehandles, files, or directories,
 395 Keywords related to the control flow of your perl program, Keywords related
 396 to scoping, Miscellaneous functions, Functions for processes and process
 397 groups, Keywords related to perl modules, Keywords related to classes and
 398 object-orientedness, Low-level socket functions, System V interprocess
 399 communication functions, Fetching user and group info, Fetching network
 400 info, Time-related functions, Functions new in perl5, Functions obsoleted
 401 in perl5
 402
 403 =item Portability
 404
 405 =item Alphabetical Listing of Perl Functions
 406
 407 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
 408 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 409 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
 410 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
 411 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
 412 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
 413 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 414 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
 415 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
 416 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
 417 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
 418 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
 419 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
 420 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
 421 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
 422 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
 423 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
 424 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
 425 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
 426 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
 427 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
 428 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
 429 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
 430 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 431 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 432 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 433 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
 434 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
 435 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
 436 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
 437 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
 438 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
 439 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
 440 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
 441 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
 442 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
 443 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
 444 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
 445 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
 446 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
 447 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 448 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 449 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 450 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
 451 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
 452 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
 453 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
 454 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
 455 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 456 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 457 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 458 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 459 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 460 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 461 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 462 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 463 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 464 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
 465 parameter index, flags, vector flag, (minimum) width, precision, or maximum
 466 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
 467 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
 468 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
 469 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 470 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 471 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 472 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 473 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 474 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 475 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 476 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 477 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 478 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 479 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
 480 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
 481 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
 482 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
 483
 484 =back
 485
 486 =back
 487
 488 =head2 perlreftut - Mark's very short tutorial about references
 489
 490 =over 4
 491
 492 =item DESCRIPTION
 493
 494 =item Who Needs Complicated Data Structures?
 495
 496 =item The Solution
 497
 498 =item Syntax
 499
 500 =over 4
 501
 502 =item Making References
 503
 504 =item Using References
 505
 506 =item An Example
 507
 508 =item Arrow Rule
 509
 510 =back
 511
 512 =item Solution
 513
 514 =item The Rest
 515
 516 =item Summary
 517
 518 =item Credits
 519
 520 =over 4
 521
 522 =item Distribution Conditions
 523
 524 =back
 525
 526 =back
 527
 528 =head2 perldsc - Perl Data Structures Cookbook
 529
 530 =over 4
 531
 532 =item DESCRIPTION
 533
 534 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 535 more elaborate constructs
 536
 537 =item REFERENCES
 538
 539 =item COMMON MISTAKES
 540
 541 =item CAVEAT ON PRECEDENCE
 542
 543 =item WHY YOU SHOULD ALWAYS C<use strict>
 544
 545 =item DEBUGGING
 546
 547 =item CODE EXAMPLES
 548
 549 =item ARRAYS OF ARRAYS
 550
 551 =over 4
 552
 553 =item Declaration of an ARRAY OF ARRAYS
 554
 555 =item Generation of an ARRAY OF ARRAYS
 556
 557 =item Access and Printing of an ARRAY OF ARRAYS
 558
 559 =back
 560
 561 =item HASHES OF ARRAYS
 562
 563 =over 4
 564
 565 =item Declaration of a HASH OF ARRAYS
 566
 567 =item Generation of a HASH OF ARRAYS
 568
 569 =item Access and Printing of a HASH OF ARRAYS
 570
 571 =back
 572
 573 =item ARRAYS OF HASHES
 574
 575 =over 4
 576
 577 =item Declaration of an ARRAY OF HASHES
 578
 579 =item Generation of an ARRAY OF HASHES
 580
 581 =item Access and Printing of an ARRAY OF HASHES
 582
 583 =back
 584
 585 =item HASHES OF HASHES
 586
 587 =over 4
 588
 589 =item Declaration of a HASH OF HASHES
 590
 591 =item Generation of a HASH OF HASHES
 592
 593 =item Access and Printing of a HASH OF HASHES
 594
 595 =back
 596
 597 =item MORE ELABORATE RECORDS
 598
 599 =over 4
 600
 601 =item Declaration of MORE ELABORATE RECORDS
 602
 603 =item Declaration of a HASH OF COMPLEX RECORDS
 604
 605 =item Generation of a HASH OF COMPLEX RECORDS
 606
 607 =back
 608
 609 =item Database Ties
 610
 611 =item SEE ALSO
 612
 613 =item AUTHOR
 614
 615 =back
 616
 617 =head2 perlrequick - Perl regular expressions quick start
 618
 619 =over 4
 620
 621 =item DESCRIPTION
 622
 623 =item The Guide
 624
 625 =over 4
 626
 627 =item Simple word matching
 628
 629 =item Using character classes
 630
 631 =item Matching this or that
 632
 633 =item Grouping things and hierarchical matching
 634
 635 =item Extracting matches
 636
 637 =item Matching repetitions
 638
 639 =item More matching
 640
 641 =item Search and replace
 642
 643 =item The split operator
 644
 645 =back
 646
 647 =item BUGS
 648
 649 =item SEE ALSO
 650
 651 =item AUTHOR AND COPYRIGHT
 652
 653 =over 4
 654
 655 =item Acknowledgments
 656
 657 =back
 658
 659 =back
 660
 661 =head2 perlpod - the Plain Old Documentation format
 662
 663 =over 4
 664
 665 =item DESCRIPTION
 666
 667 =over 4
 668
 669 =item Ordinary Paragraph
 670
 671 =item Verbatim Paragraph
 672
 673 =item Command Paragraph
 674
 675 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 676 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 677 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 678 I<formatname>>, C<=for I<formatname> I<text...>>
 679
 680 =item Formatting Codes
 681
 682 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 683 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 684 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 685 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 686 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 687 (zero-effect) formatting code
 688
 689 =item The Intent
 690
 691 =item Embedding Pods in Perl Modules
 692
 693 =item Hints for Writing Pod
 694
 695 =back
 696
 697 =item SEE ALSO
 698
 699 =item AUTHOR
 700
 701 =back
 702
 703 =head2 perlpodspec - Plain Old Documentation: format specification and
 704 notes
 705
 706 =over 4
 707
 708 =item DESCRIPTION
 709
 710 =item Pod Definitions
 711
 712 =item Pod Commands
 713
 714 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 715 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 716
 717 =item Pod Formatting Codes
 718
 719 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 720 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 721 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 722 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 723 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 724 contains non-breaking spaces
 725
 726 =item Notes on Implementing Pod Processors
 727
 728 =item About LE<lt>...E<gt> Codes
 729
 730 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 731
 732 =item About =over...=back Regions
 733
 734 =item About Data Paragraphs and "=begin/=end" Regions
 735
 736 =item SEE ALSO
 737
 738 =item AUTHOR
 739
 740 =back
 741
 742 =head2 perlstyle - Perl style guide
 743
 744 =over 4
 745
 746 =item DESCRIPTION
 747
 748 =back
 749
 750 =head2 perltrap - Perl traps for the unwary
 751
 752 =over 4
 753
 754 =item DESCRIPTION
 755
 756 =over 4
 757
 758 =item Awk Traps
 759
 760 =item C/C++ Traps
 761
 762 =item Sed Traps
 763
 764 =item Shell Traps
 765
 766 =item Perl Traps
 767
 768 =item Perl4 to Perl5 Traps
 769
 770 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 771 Traps, General data type traps, Context Traps - scalar, list contexts,
 772 Precedence Traps, General Regular Expression Traps using s///, etc,
 773 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 774
 775 =item Discontinuance, Deprecation, and BugFix traps
 776
 777 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 778 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 779 Discontinuance, Deprecation, Discontinuance, Discontinuance
 780
 781 =item Parsing Traps
 782
 783 Parsing, Parsing, Parsing, Parsing, Parsing
 784
 785 =item Numerical Traps
 786
 787 Numerical, Numerical, Numerical, Bitwise string ops
 788
 789 =item General data type traps
 790
 791 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 792 (Constants), (Scalars), (Variable Suicide)
 793
 794 =item Context Traps - scalar, list contexts
 795
 796 (list context), (scalar context), (scalar context), (list, builtin)
 797
 798 =item Precedence Traps
 799
 800 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 801 Precedence
 802
 803 =item General Regular Expression Traps using s///, etc.
 804
 805 Regular Expression, Regular Expression, Regular Expression, Regular
 806 Expression, Regular Expression, Regular Expression, Regular Expression,
 807 Regular Expression, Regular Expression
 808
 809 =item Subroutine, Signal, Sorting Traps
 810
 811 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 812
 813 =item OS Traps
 814
 815 (SysV), (SysV)
 816
 817 =item Interpolation Traps
 818
 819 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 820 Interpolation, Interpolation, Interpolation, Interpolation
 821
 822 =item DBM Traps
 823
 824 DBM, DBM
 825
 826 =item Unclassified Traps
 827
 828 C<require>/C<do> trap using returned value, C<split> on empty string with
 829 LIMIT specified
 830
 831 =back
 832
 833 =back
 834
 835 =head2 perlrun - how to execute the Perl interpreter
 836
 837 =over 4
 838
 839 =item SYNOPSIS
 840
 841 =item DESCRIPTION
 842
 843 =over 4
 844
 845 =item #! and quoting on non-Unix systems
 846
 847 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 848
 849 =item Location of Perl
 850
 851 =item Command Switches
 852
 853 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
 854 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
 855 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
 856 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 857 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 858 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 859 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 860 B<-X>, B<-x> I<directory>
 861
 862 =back
 863
 864 =item ENVIRONMENT
 865
 866 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 867 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 868 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 869 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
 870 PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
 871 (specific to the VMS port)
 872
 873 =back
 874
 875 =head2 perldiag - various Perl diagnostics
 876
 877 =over 4
 878
 879 =item DESCRIPTION
 880
 881 =back
 882
 883 =head2 perllexwarn - Perl Lexical Warnings
 884
 885 =over 4
 886
 887 =item DESCRIPTION
 888
 889 =over 4
 890
 891 =item Default Warnings and Optional Warnings
 892
 893 =item What's wrong with B<-w> and C<$^W>
 894
 895 =item Controlling Warnings from the Command Line
 896
 897 B<-w>, B<-W>, B<-X>
 898
 899 =item Backward Compatibility
 900
 901 =item Category Hierarchy
 902
 903 =item Fatal Warnings
 904
 905 =item Reporting Warnings from a Module
 906
 907 =back
 908
 909 =item TODO
 910
 911 =item SEE ALSO
 912
 913 =item AUTHOR
 914
 915 =back
 916
 917 =head2 perldebtut - Perl debugging tutorial
 918
 919 =over 4
 920
 921 =item DESCRIPTION
 922
 923 =item use strict
 924
 925 =item Looking at data and -w and v
 926
 927 =item help
 928
 929 =item Stepping through code
 930
 931 =item Placeholder for a, w, t, T
 932
 933 =item REGULAR EXPRESSIONS
 934
 935 =item OUTPUT TIPS
 936
 937 =item CGI
 938
 939 =item GUIs
 940
 941 =item SUMMARY
 942
 943 =item SEE ALSO
 944
 945 =item AUTHOR
 946
 947 =item CONTRIBUTORS
 948
 949 =back
 950
 951 =head2 perldebug - Perl debugging
 952
 953 =over 4
 954
 955 =item DESCRIPTION
 956
 957 =item The Perl Debugger
 958
 959 =over 4
 960
 961 =item Debugger Commands
 962
 963 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 964 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 965 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 966 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 967 subname [condition], b postpone subname [condition], b load filename, b
 968 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 969 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 970 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
 971 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
 972 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
 973 [manpage]
 974
 975 =item Configurable Options
 976
 977 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 978 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 979 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 980 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
 981 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
 982 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
 983 C<NonStop>
 984
 985 =item Debugger input/output
 986
 987 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 988 listing
 989
 990 =item Debugging compile-time statements
 991
 992 =item Debugger Customization
 993
 994 =item Readline Support
 995
 996 =item Editor Support for Debugging
 997
 998 =item The Perl Profiler
 999
1000 =back
1001
1002 =item Debugging regular expressions
1003
1004 =item Debugging memory usage
1005
1006 =item SEE ALSO
1007
1008 =item BUGS
1009
1010 =back
1011
1012 =head2 perlvar - Perl predefined variables
1013
1014 =over 4
1015
1016 =item DESCRIPTION
1017
1018 =over 4
1019
1020 =item Predefined Names
1021
1022 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1023 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
1024 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1025 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1026 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1027 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1028 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1029 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1030 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1031 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1032 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1033 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1034 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1035 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1036 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1037 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1038 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1039 IO::Handle->format_line_break_characters EXPR,
1040 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1041 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1042 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1043 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1044 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1045 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1046 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1047 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1048 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
1049 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
1050 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
1051 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
1052 $SIG{expr}
1053
1054 =item Error Indicators
1055
1056 =item Technical Note on the Syntax of Variable Names
1057
1058 =back
1059
1060 =item BUGS
1061
1062 =back
1063
1064 =head2 perllol - Manipulating Arrays of Arrays in Perl
1065
1066 =over 4
1067
1068 =item DESCRIPTION
1069
1070 =over 4
1071
1072 =item Declaration and Access of Arrays of Arrays
1073
1074 =item Growing Your Own
1075
1076 =item Access and Printing
1077
1078 =item Slices
1079
1080 =back
1081
1082 =item SEE ALSO
1083
1084 =item AUTHOR
1085
1086 =back
1087
1088 =head2 perlopentut - tutorial on opening things in Perl
1089
1090 =over 4
1091
1092 =item DESCRIPTION
1093
1094 =item Open E<agrave> la shell
1095
1096 =over 4
1097
1098 =item Simple Opens
1099
1100 =item Indirect Filehandles
1101
1102 =item Pipe Opens
1103
1104 =item The Minus File
1105
1106 =item Mixing Reads and Writes
1107
1108 =item Filters
1109
1110 =back
1111
1112 =item Open E<agrave> la C
1113
1114 =over 4
1115
1116 =item Permissions E<agrave> la mode
1117
1118 =back
1119
1120 =item Obscure Open Tricks
1121
1122 =over 4
1123
1124 =item Re-Opening Files (dups)
1125
1126 =item Dispelling the Dweomer
1127
1128 =item Paths as Opens
1129
1130 =item Single Argument Open
1131
1132 =item Playing with STDIN and STDOUT
1133
1134 =back
1135
1136 =item Other I/O Issues
1137
1138 =over 4
1139
1140 =item Opening Non-File Files
1141
1142 =item Opening Named Pipes
1143
1144 =item Opening Sockets
1145
1146 =item Binary Files
1147
1148 =item File Locking
1149
1150 =item IO Layers
1151
1152 =back
1153
1154 =item SEE ALSO
1155
1156 =item AUTHOR and COPYRIGHT
1157
1158 =item HISTORY
1159
1160 =back
1161
1162 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1163
1164 =over 4
1165
1166 =item DESCRIPTION
1167
1168 =item The Basic Principle
1169
1170 =item Packing Text
1171
1172 =item Packing Numbers
1173
1174 =over 4
1175
1176 =item Integers
1177
1178 =item Unpacking a Stack Frame
1179
1180 =item How to Eat an Egg on a Net
1181
1182 =item Floating point Numbers
1183
1184 =back
1185
1186 =item Exotic Templates
1187
1188 =over 4
1189
1190 =item Bit Strings
1191
1192 =item Uuencoding
1193
1194 =item Doing Sums
1195
1196 =item  Unicode
1197
1198 =item Another Portable Binary Encoding
1199
1200 =back
1201
1202 =item Template Grouping
1203
1204 =item Lengths and Widths
1205
1206 =over 4
1207
1208 =item String Lengths
1209
1210 =item Dynamic Templates
1211
1212 =item Counting Repetitions
1213
1214 =back
1215
1216 =item Packing and Unpacking C Structures
1217
1218 =over 4
1219
1220 =item The Alignment Pit
1221
1222 =item Alignment, Take 2
1223
1224 =item Alignment, Take 3
1225
1226 =item Pointers for How to Use Them
1227
1228 =back
1229
1230 =item Pack Recipes
1231
1232 =item Funnies Section
1233
1234 =item Authors
1235
1236 =back
1237
1238 =head2 perlretut - Perl regular expressions tutorial
1239
1240 =over 4
1241
1242 =item DESCRIPTION
1243
1244 =item Part 1: The basics
1245
1246 =over 4
1247
1248 =item Simple word matching
1249
1250 =item Using character classes
1251
1252 =item Matching this or that
1253
1254 =item Grouping things and hierarchical matching
1255
1256 =item Extracting matches
1257
1258 =item Matching repetitions
1259
1260 =item Building a regexp
1261
1262 =item Using regular expressions in Perl
1263
1264 =back
1265
1266 =item Part 2: Power tools
1267
1268 =over 4
1269
1270 =item More on characters, strings, and character classes
1271
1272 =item Compiling and saving regular expressions
1273
1274 =item Embedding comments and modifiers in a regular expression
1275
1276 =item Non-capturing groupings
1277
1278 =item Looking ahead and looking behind
1279
1280 =item Using independent subexpressions to prevent backtracking
1281
1282 =item Conditional expressions
1283
1284 =item A bit of magic: executing Perl code in a regular expression
1285
1286 =item Pragmas and debugging
1287
1288 =back
1289
1290 =item BUGS
1291
1292 =item SEE ALSO
1293
1294 =item AUTHOR AND COPYRIGHT
1295
1296 =over 4
1297
1298 =item Acknowledgments
1299
1300 =back
1301
1302 =back
1303
1304 =head2 perlre - Perl regular expressions
1305
1306 =over 4
1307
1308 =item DESCRIPTION
1309
1310 i, m, s, x
1311
1312 =over 4
1313
1314 =item Regular Expressions
1315
1316 [1], [2], [3], cntrl, graph, print, punct, xdigit
1317
1318 =item Extended Patterns
1319
1320 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1321 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1322 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1323 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1324
1325 =item Backtracking
1326
1327 =item Version 8 Regular Expressions
1328
1329 =item Warning on \1 vs $1
1330
1331 =item Repeated patterns matching zero-length substring
1332
1333 =item Combining pieces together
1334
1335 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1336 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1337 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1338 C<(?(condition)yes-pattern|no-pattern)>
1339
1340 =item Creating custom RE engines
1341
1342 =back
1343
1344 =item BUGS
1345
1346 =item SEE ALSO
1347
1348 =back
1349
1350 =head2 perlref - Perl references and nested data structures
1351
1352 =over 4
1353
1354 =item NOTE
1355
1356 =item DESCRIPTION
1357
1358 =over 4
1359
1360 =item Making References
1361
1362 =item Using References
1363
1364 =item Symbolic references
1365
1366 =item Not-so-symbolic references
1367
1368 =item Pseudo-hashes: Using an array as a hash
1369
1370 =item Function Templates
1371
1372 =back
1373
1374 =item WARNING
1375
1376 =item SEE ALSO
1377
1378 =back
1379
1380 =head2 perlform - Perl formats
1381
1382 =over 4
1383
1384 =item DESCRIPTION
1385
1386 =over 4
1387
1388 =item Format Variables
1389
1390 =back
1391
1392 =item NOTES
1393
1394 =over 4
1395
1396 =item Footers
1397
1398 =item Accessing Formatting Internals
1399
1400 =back
1401
1402 =item WARNINGS
1403
1404 =back
1405
1406 =head2 perlboot - Beginner's Object-Oriented Tutorial
1407
1408 =over 4
1409
1410 =item DESCRIPTION
1411
1412 =over 4
1413
1414 =item If we could talk to the animals...
1415
1416 =item Introducing the method invocation arrow
1417
1418 =item Invoking a barnyard
1419
1420 =item The extra parameter of method invocation
1421
1422 =item Calling a second method to simplify things
1423
1424 =item Inheriting the windpipes
1425
1426 =item A few notes about @ISA
1427
1428 =item Overriding the methods
1429
1430 =item Starting the search from a different place
1431
1432 =item The SUPER way of doing things
1433
1434 =item Where we're at so far...
1435
1436 =item A horse is a horse, of course of course -- or is it?
1437
1438 =item Invoking an instance method
1439
1440 =item Accessing the instance data
1441
1442 =item How to build a horse
1443
1444 =item Inheriting the constructor
1445
1446 =item Making a method work with either classes or instances
1447
1448 =item Adding parameters to a method
1449
1450 =item More interesting instances
1451
1452 =item A horse of a different color
1453
1454 =item Summary
1455
1456 =back
1457
1458 =item SEE ALSO
1459
1460 =item COPYRIGHT
1461
1462 =back
1463
1464 =head2 perltoot - Tom's object-oriented tutorial for perl
1465
1466 =over 4
1467
1468 =item DESCRIPTION
1469
1470 =item Creating a Class
1471
1472 =over 4
1473
1474 =item Object Representation
1475
1476 =item Class Interface
1477
1478 =item Constructors and Instance Methods
1479
1480 =item Planning for the Future: Better Constructors
1481
1482 =item Destructors
1483
1484 =item Other Object Methods
1485
1486 =back
1487
1488 =item Class Data
1489
1490 =over 4
1491
1492 =item Accessing Class Data
1493
1494 =item Debugging Methods
1495
1496 =item Class Destructors
1497
1498 =item Documenting the Interface
1499
1500 =back
1501
1502 =item Aggregation
1503
1504 =item Inheritance
1505
1506 =over 4
1507
1508 =item Overridden Methods
1509
1510 =item Multiple Inheritance
1511
1512 =item UNIVERSAL: The Root of All Objects
1513
1514 =back
1515
1516 =item Alternate Object Representations
1517
1518 =over 4
1519
1520 =item Arrays as Objects
1521
1522 =item Closures as Objects
1523
1524 =back
1525
1526 =item AUTOLOAD: Proxy Methods
1527
1528 =over 4
1529
1530 =item Autoloaded Data Methods
1531
1532 =item Inherited Autoloaded Data Methods
1533
1534 =back
1535
1536 =item Metaclassical Tools
1537
1538 =over 4
1539
1540 =item Class::Struct
1541
1542 =item Data Members as Variables
1543
1544 =back
1545
1546 =item NOTES
1547
1548 =over 4
1549
1550 =item Object Terminology
1551
1552 =back
1553
1554 =item SEE ALSO
1555
1556 =item AUTHOR AND COPYRIGHT
1557
1558 =item COPYRIGHT
1559
1560 =over 4
1561
1562 =item Acknowledgments
1563
1564 =back
1565
1566 =back
1567
1568 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1569
1570 =over 4
1571
1572 =item DESCRIPTION
1573
1574 =item Class Data in a Can
1575
1576 =item Class Data as Package Variables
1577
1578 =over 4
1579
1580 =item Putting All Your Eggs in One Basket
1581
1582 =item Inheritance Concerns
1583
1584 =item The Eponymous Meta-Object
1585
1586 =item Indirect References to Class Data
1587
1588 =item Monadic Classes
1589
1590 =item Translucent Attributes
1591
1592 =back
1593
1594 =item Class Data as Lexical Variables
1595
1596 =over 4
1597
1598 =item Privacy and Responsibility
1599
1600 =item File-Scoped Lexicals
1601
1602 =item More Inheritance Concerns
1603
1604 =item Locking the Door and Throwing Away the Key
1605
1606 =item Translucency Revisited
1607
1608 =back
1609
1610 =item NOTES
1611
1612 =item SEE ALSO
1613
1614 =item AUTHOR AND COPYRIGHT
1615
1616 =item ACKNOWLEDGEMENTS
1617
1618 =item HISTORY
1619
1620 =back
1621
1622 =head2 perlobj - Perl objects
1623
1624 =over 4
1625
1626 =item DESCRIPTION
1627
1628 =over 4
1629
1630 =item An Object is Simply a Reference
1631
1632 =item A Class is Simply a Package
1633
1634 =item A Method is Simply a Subroutine
1635
1636 =item Method Invocation
1637
1638 =item Indirect Object Syntax
1639
1640 =item Default UNIVERSAL methods
1641
1642 isa(CLASS), can(METHOD), VERSION( [NEED] )
1643
1644 =item Destructors
1645
1646 =item Summary
1647
1648 =item Two-Phased Garbage Collection
1649
1650 =back
1651
1652 =item SEE ALSO
1653
1654 =back
1655
1656 =head2 perlbot - Bag'o Object Tricks (the BOT)
1657
1658 =over 4
1659
1660 =item DESCRIPTION
1661
1662 =item OO SCALING TIPS
1663
1664 =item INSTANCE VARIABLES
1665
1666 =item SCALAR INSTANCE VARIABLES
1667
1668 =item INSTANCE VARIABLE INHERITANCE
1669
1670 =item OBJECT RELATIONSHIPS
1671
1672 =item OVERRIDING SUPERCLASS METHODS
1673
1674 =item USING RELATIONSHIP WITH SDBM
1675
1676 =item THINKING OF CODE REUSE
1677
1678 =item CLASS CONTEXT AND THE OBJECT
1679
1680 =item INHERITING A CONSTRUCTOR
1681
1682 =item DELEGATION
1683
1684 =item SEE ALSO
1685
1686 =back
1687
1688 =head2 perltie - how to hide an object class in a simple variable
1689
1690 =over 4
1691
1692 =item SYNOPSIS
1693
1694 =item DESCRIPTION
1695
1696 =over 4
1697
1698 =item Tying Scalars
1699
1700 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1701 DESTROY this
1702
1703 =item Tying Arrays
1704
1705 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1706 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1707 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1708 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1709 this
1710
1711 =item Tying Hashes
1712
1713 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1714 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1715 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1716
1717 =item Tying FileHandles
1718
1719 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1720 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1721 DESTROY this
1722
1723 =item UNTIE this
1724
1725 =item The C<untie> Gotcha
1726
1727 =back
1728
1729 =item SEE ALSO
1730
1731 =item BUGS
1732
1733 =item AUTHOR
1734
1735 =back
1736
1737 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1738 safe subprocesses, sockets, and semaphores)
1739
1740 =over 4
1741
1742 =item DESCRIPTION
1743
1744 =item Signals
1745
1746 =over 4
1747
1748 =item Handling the SIGHUP Signal in Daemons
1749
1750 =back
1751
1752 =item Named Pipes
1753
1754 =over 4
1755
1756 =item Deferred Signals (Safe signals)
1757
1758 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
1759 "faults", Signals triggered by operating system state
1760
1761 =back
1762
1763 =item Using open() for IPC
1764
1765 =over 4
1766
1767 =item Filehandles
1768
1769 =item Background Processes
1770
1771 =item Complete Dissociation of Child from Parent
1772
1773 =item Safe Pipe Opens
1774
1775 =item Bidirectional Communication with Another Process
1776
1777 =item Bidirectional Communication with Yourself
1778
1779 =back
1780
1781 =item Sockets: Client/Server Communication
1782
1783 =over 4
1784
1785 =item Internet Line Terminators
1786
1787 =item Internet TCP Clients and Servers
1788
1789 =item Unix-Domain TCP Clients and Servers
1790
1791 =back
1792
1793 =item TCP Clients with IO::Socket
1794
1795 =over 4
1796
1797 =item A Simple Client
1798
1799 C<Proto>, C<PeerAddr>, C<PeerPort>
1800
1801 =item A Webget Client
1802
1803 =item Interactive Client with IO::Socket
1804
1805 =back
1806
1807 =item TCP Servers with IO::Socket
1808
1809 Proto, LocalPort, Listen, Reuse
1810
1811 =item UDP: Message Passing
1812
1813 =item SysV IPC
1814
1815 =item NOTES
1816
1817 =item BUGS
1818
1819 =item AUTHOR
1820
1821 =item SEE ALSO
1822
1823 =back
1824
1825 =head2 perlfork - Perl's fork() emulation
1826
1827 =over 4
1828
1829 =item SYNOPSIS
1830
1831 =item DESCRIPTION
1832
1833 =over 4
1834
1835 =item Behavior of other Perl features in forked pseudo-processes
1836
1837 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1838 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1839 files, directories and network sockets
1840
1841 =item Resource limits
1842
1843 =item Killing the parent process
1844
1845 =item Lifetime of the parent process and pseudo-processes
1846
1847 =item CAVEATS AND LIMITATIONS
1848
1849 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1850 Global state maintained by XSUBs, Interpreter embedded in larger
1851 application, Thread-safety of extensions
1852
1853 =back
1854
1855 =item BUGS
1856
1857 =item AUTHOR
1858
1859 =item SEE ALSO
1860
1861 =back
1862
1863 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1864
1865 =over 4
1866
1867 =item SYNOPSIS
1868
1869 =item DESCRIPTION
1870
1871 =item Storing numbers
1872
1873 =item Numeric operators and numeric conversions
1874
1875 =item Flavors of Perl numeric operations
1876
1877 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
1878 mathematical operators, Bitwise operators, Bitwise operators during C<use
1879 integer>, Operators which expect an integer, Operators which expect a
1880 string
1881
1882 =item AUTHOR
1883
1884 =item SEE ALSO
1885
1886 =back
1887
1888 =head2 perlthrtut - tutorial on threads in Perl
1889
1890 =over 4
1891
1892 =item DESCRIPTION
1893
1894 =item Status
1895
1896 =item What Is A Thread Anyway?
1897
1898 =item Threaded Program Models
1899
1900 =over 4
1901
1902 =item Boss/Worker
1903
1904 =item Work Crew
1905
1906 =item Pipeline
1907
1908 =back
1909
1910 =item Native threads
1911
1912 =item What kind of threads are Perl threads?
1913
1914 =item Thread-Safe Modules
1915
1916 =item Thread Basics
1917
1918 =over 4
1919
1920 =item Basic Thread Support
1921
1922 =item A Note about the Examples
1923
1924 =item Creating Threads
1925
1926 =item Giving up control
1927
1928 =item Waiting For A Thread To Exit
1929
1930 =item Ignoring A Thread
1931
1932 =back
1933
1934 =item Threads And Data
1935
1936 =over 4
1937
1938 =item Shared And Unshared Data
1939
1940 =item Thread Pitfalls: Races
1941
1942 =back
1943
1944 =item Synchronization and control
1945
1946 =over 4
1947
1948 =item Controlling access: lock()
1949
1950 =item A Thread Pitfall: Deadlocks
1951
1952 =item Queues: Passing Data Around
1953
1954 =item Semaphores: Synchronizing Data Access
1955
1956 =item Basic semaphores
1957
1958 =item Advanced Semaphores
1959
1960 =item cond_wait() and cond_signal()
1961
1962 =back
1963
1964 =item General Thread Utility Routines
1965
1966 =over 4
1967
1968 =item What Thread Am I In?
1969
1970 =item Thread IDs
1971
1972 =item Are These Threads The Same?
1973
1974 =item What Threads Are Running?
1975
1976 =back
1977
1978 =item A Complete Example
1979
1980 =item Performance considerations
1981
1982 =item Process-scope Changes
1983
1984 =item Thread-Safety of System Libraries
1985
1986 =item Conclusion
1987
1988 =item Bibliography
1989
1990 =over 4
1991
1992 =item Introductory Texts
1993
1994 =item OS-Related References
1995
1996 =item Other References
1997
1998 =back
1999
2000 =item Acknowledgements
2001
2002 =item AUTHOR
2003
2004 =item Copyrights
2005
2006 =back
2007
2008 =head2 perlothrtut - old tutorial on threads in Perl
2009
2010 =over 4
2011
2012 =item DESCRIPTION
2013
2014 =item What Is A Thread Anyway?
2015
2016 =item Threaded Program Models
2017
2018 =over 4
2019
2020 =item Boss/Worker
2021
2022 =item Work Crew
2023
2024 =item Pipeline
2025
2026 =back
2027
2028 =item Native threads
2029
2030 =item What kind of threads are perl threads?
2031
2032 =item Threadsafe Modules
2033
2034 =item Thread Basics
2035
2036 =over 4
2037
2038 =item Basic Thread Support
2039
2040 =item Creating Threads
2041
2042 =item Giving up control
2043
2044 =item Waiting For A Thread To Exit
2045
2046 =item Errors In Threads
2047
2048 =item Ignoring A Thread
2049
2050 =back
2051
2052 =item Threads And Data
2053
2054 =over 4
2055
2056 =item Shared And Unshared Data
2057
2058 =item Thread Pitfall: Races
2059
2060 =item Controlling access: lock()
2061
2062 =item Thread Pitfall: Deadlocks
2063
2064 =item Queues: Passing Data Around
2065
2066 =back
2067
2068 =item Threads And Code
2069
2070 =over 4
2071
2072 =item Semaphores: Synchronizing Data Access
2073
2074 Basic semaphores, Advanced Semaphores
2075
2076 =item Attributes: Restricting Access To Subroutines
2077
2078 =item Subroutine Locks
2079
2080 =item Methods
2081
2082 =item Locking A Subroutine
2083
2084 =back
2085
2086 =item General Thread Utility Routines
2087
2088 =over 4
2089
2090 =item What Thread Am I In?
2091
2092 =item Thread IDs
2093
2094 =item Are These Threads The Same?
2095
2096 =item What Threads Are Running?
2097
2098 =back
2099
2100 =item A Complete Example
2101
2102 =item Conclusion
2103
2104 =item Bibliography
2105
2106 =over 4
2107
2108 =item Introductory Texts
2109
2110 =item OS-Related References
2111
2112 =item Other References
2113
2114 =back
2115
2116 =item Acknowledgements
2117
2118 =item AUTHOR
2119
2120 =item Copyrights
2121
2122 =back
2123
2124 =head2 perlport - Writing portable Perl
2125
2126 =over 4
2127
2128 =item DESCRIPTION
2129
2130 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2131 portable
2132
2133 =item ISSUES
2134
2135 =over 4
2136
2137 =item Newlines
2138
2139 =item Numbers endianness and Width
2140
2141 =item Files and Filesystems
2142
2143 =item System Interaction
2144
2145 =item Command names versus file pathnames
2146
2147 =item Networking
2148
2149 =item Interprocess Communication (IPC)
2150
2151 =item External Subroutines (XS)
2152
2153 =item Standard Modules
2154
2155 =item Time and Date
2156
2157 =item Character sets and character encoding
2158
2159 =item Internationalisation
2160
2161 =item System Resources
2162
2163 =item Security
2164
2165 =item Style
2166
2167 =back
2168
2169 =item CPAN Testers
2170
2171 Mailing list: cpan-testers@perl.org, Testing results:
2172 http://testers.cpan.org/
2173
2174 =item PLATFORMS
2175
2176 =over 4
2177
2178 =item Unix
2179
2180 =item DOS and Derivatives
2181
2182 =item S<Mac OS>
2183
2184 =item VMS
2185
2186 =item VOS
2187
2188 =item EBCDIC Platforms
2189
2190 =item Acorn RISC OS
2191
2192 =item Other perls
2193
2194 =back
2195
2196 =item FUNCTION IMPLEMENTATIONS
2197
2198 =over 4
2199
2200 =item Alphabetical Listing of Perl Functions
2201
2202 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2203 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2204 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2205 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2206 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2207 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2208 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2209 getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
2210 getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
2211 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
2212 endhostent, endnetent, endprotoent, endservent, getsockopt
2213 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
2214 kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
2215 lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
2216 ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
2217 READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
2218 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
2219 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2220 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2221 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2222 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2223 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2224 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2225 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2226 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2227 wait, waitpid PID,FLAGS
2228
2229 =back
2230
2231 =item CHANGES
2232
2233 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
2234 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
2235 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
2236 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
2237 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
2238 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
2239
2240 =item Supported Platforms
2241
2242 =item SEE ALSO
2243
2244 =item AUTHORS / CONTRIBUTORS
2245
2246 =back
2247
2248 =head2 perllocale - Perl locale handling (internationalization and
2249 localization)
2250
2251 =over 4
2252
2253 =item DESCRIPTION
2254
2255 =item PREPARING TO USE LOCALES
2256
2257 =item USING LOCALES
2258
2259 =over 4
2260
2261 =item The use locale pragma
2262
2263 =item The setlocale function
2264
2265 =item Finding locales
2266
2267 =item LOCALE PROBLEMS
2268
2269 =item Temporarily fixing locale problems
2270
2271 =item Permanently fixing locale problems
2272
2273 =item Permanently fixing your system's locale configuration
2274
2275 =item Fixing system locale configuration
2276
2277 =item The localeconv function
2278
2279 =item I18N::Langinfo
2280
2281 =back
2282
2283 =item LOCALE CATEGORIES
2284
2285 =over 4
2286
2287 =item Category LC_COLLATE: Collation
2288
2289 =item Category LC_CTYPE: Character Types
2290
2291 =item Category LC_NUMERIC: Numeric Formatting
2292
2293 =item Category LC_MONETARY: Formatting of monetary amounts
2294
2295 =item LC_TIME
2296
2297 =item Other categories
2298
2299 =back
2300
2301 =item SECURITY
2302
2303 =item ENVIRONMENT
2304
2305 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2306 LC_NUMERIC, LC_TIME, LANG
2307
2308 =item NOTES
2309
2310 =over 4
2311
2312 =item Backward compatibility
2313
2314 =item I18N:Collate obsolete
2315
2316 =item Sort speed and memory use impacts
2317
2318 =item write() and LC_NUMERIC
2319
2320 =item Freely available locale definitions
2321
2322 =item I18n and l10n
2323
2324 =item An imperfect standard
2325
2326 =back
2327
2328 =item Unicode and UTF-8
2329
2330 =item BUGS
2331
2332 =over 4
2333
2334 =item Broken systems
2335
2336 =back
2337
2338 =item SEE ALSO
2339
2340 =item HISTORY
2341
2342 =back
2343
2344 =head2 perluniintro - Perl Unicode introduction
2345
2346 =over 4
2347
2348 =item DESCRIPTION
2349
2350 =over 4
2351
2352 =item Unicode
2353
2354 =item Perl's Unicode Support
2355
2356 =item Perl's Unicode Model
2357
2358 =item Unicode and EBCDIC
2359
2360 =item Creating Unicode
2361
2362 =item Handling Unicode
2363
2364 =item Legacy Encodings
2365
2366 =item Unicode I/O
2367
2368 =item Displaying Unicode As Text
2369
2370 =item Special Cases
2371
2372 =item Advanced Topics
2373
2374 =item Miscellaneous
2375
2376 =item Questions With Answers
2377
2378 =item Hexadecimal Notation
2379
2380 =item Further Resources
2381
2382 =back
2383
2384 =item UNICODE IN OLDER PERLS
2385
2386 =item SEE ALSO
2387
2388 =item ACKNOWLEDGMENTS
2389
2390 =item AUTHOR, COPYRIGHT, AND LICENSE
2391
2392 =back
2393
2394 =head2 perlunicode - Unicode support in Perl
2395
2396 =over 4
2397
2398 =item DESCRIPTION
2399
2400 =over 4
2401
2402 =item Important Caveats
2403
2404 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
2405 enable UTF-8/UTF-EBCDIC in scripts
2406
2407 =item Byte and Character Semantics
2408
2409 =item Effects of Character Semantics
2410
2411 =item Scripts
2412
2413 =item Blocks
2414
2415 =item User-Defined Character Properties
2416
2417 =item Character Encodings for Input and Output
2418
2419 =item Unicode Regular Expression Support Level
2420
2421 =item Unicode Encodings
2422
2423 =item Security Implications of Unicode
2424
2425 =item Unicode in Perl on EBCDIC
2426
2427 =item Locales
2428
2429 =item When Unicode Does Not Happen
2430
2431 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
2432
2433 =item Using Unicode in XS
2434
2435 =back
2436
2437 =item BUGS
2438
2439 =over 4
2440
2441 =item Interaction with Locales
2442
2443 =item Interaction with Extensions
2444
2445 =item Speed
2446
2447 =item Porting code from perl-5.6.X
2448
2449 =back
2450
2451 =item SEE ALSO
2452
2453 =back
2454
2455 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2456
2457 =over 4
2458
2459 =item DESCRIPTION
2460
2461 =item COMMON CHARACTER CODE SETS
2462
2463 =over 4
2464
2465 =item ASCII
2466
2467 =item ISO 8859
2468
2469 =item Latin 1 (ISO 8859-1)
2470
2471 =item EBCDIC
2472
2473 =item 13 variant characters
2474
2475 =item 0037
2476
2477 =item 1047
2478
2479 =item POSIX-BC
2480
2481 =item Unicode code points versus EBCDIC code points
2482
2483 =item Remaining Perl Unicode problems in EBCDIC
2484
2485 =item Unicode and UTF
2486
2487 =item Using Encode
2488
2489 =back
2490
2491 =item SINGLE OCTET TABLES
2492
2493 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2494
2495 =item IDENTIFYING CHARACTER CODE SETS
2496
2497 =item CONVERSIONS
2498
2499 =over 4
2500
2501 =item tr///
2502
2503 =item iconv
2504
2505 =item C RTL
2506
2507 =back
2508
2509 =item OPERATOR DIFFERENCES
2510
2511 =item FUNCTION DIFFERENCES
2512
2513 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2514
2515 =item REGULAR EXPRESSION DIFFERENCES
2516
2517 =item SOCKETS
2518
2519 =item SORTING
2520
2521 =over 4
2522
2523 =item Ignore ASCII vs. EBCDIC sort differences.
2524
2525 =item MONO CASE then sort data.
2526
2527 =item Convert, sort data, then re convert.
2528
2529 =item Perform sorting on one type of machine only.
2530
2531 =back
2532
2533 =item TRANSFORMATION FORMATS
2534
2535 =over 4
2536
2537 =item URL decoding and encoding
2538
2539 =item uu encoding and decoding
2540
2541 =item Quoted-Printable encoding and decoding
2542
2543 =item Caesarian ciphers
2544
2545 =back
2546
2547 =item Hashing order and checksums
2548
2549 =item I18N AND L10N
2550
2551 =item MULTI OCTET CHARACTER SETS
2552
2553 =item OS ISSUES
2554
2555 =over 4
2556
2557 =item OS/400
2558
2559 PASE, IFS access
2560
2561 =item OS/390, z/OS
2562
2563 chcp, dataset access, OS/390, z/OS iconv, locales
2564
2565 =item VM/ESA?
2566
2567 =item POSIX-BC?
2568
2569 =back
2570
2571 =item BUGS
2572
2573 =item SEE ALSO
2574
2575 =item REFERENCES
2576
2577 =item HISTORY
2578
2579 =item AUTHOR
2580
2581 =back
2582
2583 =head2 perlsec - Perl security
2584
2585 =over 4
2586
2587 =item DESCRIPTION
2588
2589 =over 4
2590
2591 =item Laundering and Detecting Tainted Data
2592
2593 =item Switches On the "#!" Line
2594
2595 =item Cleaning Up Your Path
2596
2597 =item Security Bugs
2598
2599 =item Protecting Your Programs
2600
2601 =item Unicode
2602
2603 =item Algorithmic Complexity Attacks
2604
2605 =back
2606
2607 =item SEE ALSO
2608
2609 =back
2610
2611 =head2 perlmod - Perl modules (packages and symbol tables)
2612
2613 =over 4
2614
2615 =item DESCRIPTION
2616
2617 =over 4
2618
2619 =item Packages
2620
2621 =item Symbol Tables
2622
2623 =item Package Constructors and Destructors
2624
2625 =item Perl Classes
2626
2627 =item Perl Modules
2628
2629 =item Making your module threadsafe
2630
2631 =back
2632
2633 =item SEE ALSO
2634
2635 =back
2636
2637 =head2 perlmodinstall - Installing CPAN Modules
2638
2639 =over 4
2640
2641 =item DESCRIPTION
2642
2643 =over 4
2644
2645 =item PREAMBLE
2646
2647 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2648 module (sometimes unnecessary), B<INSTALL> the module
2649
2650 =back
2651
2652 =item PORTABILITY
2653
2654 =item HEY
2655
2656 =item AUTHOR
2657
2658 =item COPYRIGHT
2659
2660 =back
2661
2662 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2663
2664 =over 4
2665
2666 =item THE PERL MODULE LIBRARY
2667
2668 =over 4
2669
2670 =item Pragmatic Modules
2671
2672 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
2673 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
2674 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
2675 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
2676 vmsish, warnings, warnings::register
2677
2678 =item Standard Modules
2679
2680 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2681 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2682 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2683 B::Terse, B::Xref, Benchmark, CGI, CGI::Apache, CGI::Carp, CGI::Cookie,
2684 CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN,
2685 CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, Class::Struct,
2686 Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, Devel::PPPort,
2687 Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, DirHandle, Dumpvalue,
2688 DynaLoader, Encode, Encode::Alias, Encode::Byte, Encode::CJKConstants,
2689 Encode::CN, Encode::CN::HZ, Encode::Config, Encode::EBCDIC,
2690 Encode::Encoder, Encode::Encoding, Encode::Guess, Encode::JP,
2691 Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR,
2692 Encode::MIME::Header, Encode::PerlIO, Encode::Supported, Encode::Symbol,
2693 Encode::TW, Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno,
2694 Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
2695 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
2696 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
2697 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
2698 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
2699 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2700 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
2701 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
2702 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
2703 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
2704 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
2705 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
2706 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
2707 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
2708 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
2709 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
2710 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
2711 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
2712 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
2713 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
2714 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
2715 Locale::Currency, Locale::Language, Locale::Maketext,
2716 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
2717 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
2718 Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex,
2719 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
2720 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
2721 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
2722 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
2723 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
2724 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
2725 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
2726 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
2727 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
2728 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
2729 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
2730 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
2731 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
2732 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
2733 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
2734 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
2735 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
2736 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
2737 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
2738 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
2739 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
2740 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
2741 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
2742 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
2743 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
2744 XSLoader
2745
2746 =item Extension Modules
2747
2748 =back
2749
2750 =item CPAN
2751
2752 =over 4
2753
2754 =item Africa
2755
2756 South Africa
2757
2758 =item Asia
2759
2760 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
2761 Arabia, Singapore, South Korea, Taiwan
2762
2763 =item Central America
2764
2765 Costa Rica
2766
2767 =item Europe
2768
2769 Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia,
2770 Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
2771 Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia,
2772 Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United
2773 Kingdom
2774
2775 =item North America
2776
2777 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
2778 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
2779 Illinois, Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey,
2780 New York, North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
2781 Utah, Virginia, Washington, Wisconsin
2782
2783 =item Oceania
2784
2785 Australia, New Zealand, United States
2786
2787 =item South America
2788
2789 Argentina, Brazil, Chile
2790
2791 =item RSYNC Mirrors
2792
2793 =back
2794
2795 =item Modules: Creation, Use, and Abuse
2796
2797 =over 4
2798
2799 =item Guidelines for Module Creation
2800
2801 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2802
2803 =item Guidelines for Reusing Application Code
2804
2805 =back
2806
2807 =item NOTE
2808
2809 =back
2810
2811 =head2 perlmodstyle - Perl module style guide
2812
2813 =over 4
2814
2815 =item INTRODUCTION
2816
2817 =item QUICK CHECKLIST
2818
2819 =over 4
2820
2821 =item Before you start
2822
2823 =item The API
2824
2825 =item Stability
2826
2827 =item Documentation
2828
2829 =item Release considerations
2830
2831 =back
2832
2833 =item BEFORE YOU START WRITING A MODULE
2834
2835 =over 4
2836
2837 =item Has it been done before?
2838
2839 =item Do one thing and do it well
2840
2841 =item What's in a name?
2842
2843 =back
2844
2845 =item DESIGNING AND WRITING YOUR MODULE
2846
2847 =over 4
2848
2849 =item To OO or not to OO?
2850
2851 =item Designing your API
2852
2853 Write simple routines to do simple things, Separate functionality from
2854 output, Provide sensible shortcuts and defaults, Naming conventions,
2855 Parameter passing
2856
2857 =item Strictness and warnings
2858
2859 =item Backwards compatibility
2860
2861 =item Error handling and messages
2862
2863 =back
2864
2865 =item DOCUMENTING YOUR MODULE
2866
2867 =over 4
2868
2869 =item POD
2870
2871 =item README, INSTALL, release notes, changelogs
2872
2873 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
2874 perl Build test, perl Build install
2875
2876 =back
2877
2878 =item RELEASE CONSIDERATIONS
2879
2880 =over 4
2881
2882 =item Version numbering
2883
2884 =item Pre-requisites
2885
2886 =item Testing
2887
2888 =item Packaging
2889
2890 =item Licensing
2891
2892 =back
2893
2894 =item COMMON PITFALLS
2895
2896 =over 4
2897
2898 =item Reinventing the wheel
2899
2900 =item Trying to do too much
2901
2902 =item Inappropriate documentation
2903
2904 =back
2905
2906 =item SEE ALSO
2907
2908 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
2909 Testing tools, http://pause.perl.org/, Any good book on software
2910 engineering
2911
2912 =item AUTHOR
2913
2914 =back
2915
2916 =head2 perlnewmod - preparing a new module for distribution
2917
2918 =over 4
2919
2920 =item DESCRIPTION
2921
2922 =over 4
2923
2924 =item Warning
2925
2926 =item What should I make into a module?
2927
2928 =item Step-by-step: Preparing the ground
2929
2930 Look around, Check it's new, Discuss the need, Choose a name, Check again
2931
2932 =item Step-by-step: Making the module
2933
2934 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2935 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2936 documentation|perlpod>, Write tests, Write the README
2937
2938 =item Step-by-step: Distributing your module
2939
2940 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2941 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2942
2943 =back
2944
2945 =item AUTHOR
2946
2947 =item SEE ALSO
2948
2949 =back
2950
2951 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
2952 2003/07/09 15:47:28 $)
2953
2954 =over 4
2955
2956 =item DESCRIPTION
2957
2958 =over 4
2959
2960 =item What is Perl?
2961
2962 =item Who supports Perl?  Who develops it?  Why is it free?
2963
2964 =item Which version of Perl should I use?
2965
2966 =item What are perl4 and perl5?
2967
2968 =item What is Ponie?
2969
2970 =item What is perl6?
2971
2972 =item How stable is Perl?
2973
2974 =item Is Perl difficult to learn?
2975
2976 =item How does Perl compare with other languages like Java, Python, REXX,
2977 Scheme, or Tcl?
2978
2979 =item Can I do [task] in Perl?
2980
2981 =item When shouldn't I program in Perl?
2982
2983 =item What's the difference between "perl" and "Perl"?
2984
2985 =item Is it a Perl program or a Perl script?
2986
2987 =item What is a JAPH?
2988
2989 =item Where can I get a list of Larry Wall witticisms?
2990
2991 =item How can I convince my sysadmin/supervisor/employees to use version
2992 5/5.6.1/Perl instead of some other language?
2993
2994 =back
2995
2996 =item AUTHOR AND COPYRIGHT
2997
2998 =back
2999
3000 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $,
3001 $Date: 2003/01/26 17:50:56 $)
3002
3003 =over 4
3004
3005 =item DESCRIPTION
3006
3007 =over 4
3008
3009 =item What machines support Perl?  Where do I get it?
3010
3011 =item How can I get a binary version of Perl?
3012
3013 =item I don't have a C compiler on my system.  How can I compile perl?
3014
3015 =item I copied the Perl binary from one machine to another, but scripts
3016 don't work.
3017
3018 =item I grabbed the sources and tried to compile but gdbm/dynamic
3019 loading/malloc/linking/... failed.  How do I make it work?
3020
3021 =item What modules and extensions are available for Perl?  What is CPAN?
3022 What does CPAN/src/... mean?
3023
3024 =item Is there an ISO or ANSI certified version of Perl?
3025
3026 =item Where can I get information on Perl?
3027
3028 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
3029
3030 =item Where should I post source code?
3031
3032 =item Perl Books
3033
3034 References, Tutorials, Task-Oriented, Special Topics
3035
3036 =item Perl in Magazines
3037
3038 =item Perl on the Net: FTP and WWW Access
3039
3040 =item What mailing lists are there for Perl?
3041
3042 =item Archives of comp.lang.perl.misc
3043
3044 =item Where can I buy a commercial version of Perl?
3045
3046 =item Where do I send bug reports?
3047
3048 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
3049
3050 =back
3051
3052 =item AUTHOR AND COPYRIGHT
3053
3054 =back
3055
3056 =head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31
3057 17:34:56 $)
3058
3059 =over 4
3060
3061 =item DESCRIPTION
3062
3063 =over 4
3064
3065 =item How do I do (anything)?
3066
3067 =item How can I use Perl interactively?
3068
3069 =item Is there a Perl shell?
3070
3071 =item How do I find which modules are installed on my system?
3072
3073 =item How do I debug my Perl programs?
3074
3075 =item How do I profile my Perl programs?
3076
3077 =item How do I cross-reference my Perl programs?
3078
3079 =item Is there a pretty-printer (formatter) for Perl?
3080
3081 =item Is there a ctags for Perl?
3082
3083 =item Is there an IDE or Windows Perl Editor?
3084
3085 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
3086 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
3087 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3088
3089 =item Where can I get Perl macros for vi?
3090
3091 =item Where can I get perl-mode for emacs?
3092
3093 =item How can I use curses with Perl?
3094
3095 =item How can I use X or Tk with Perl?
3096
3097 =item How can I generate simple menus without using CGI or Tk?
3098
3099 =item How can I make my Perl program run faster?
3100
3101 =item How can I make my Perl program take less memory?
3102
3103 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3104 stringification, Pass by reference, Tie large variables to disk
3105
3106 =item Is it safe to return a reference to local or lexical data?
3107
3108 =item How can I free an array or hash so my program shrinks?
3109
3110 =item How can I make my CGI script more efficient?
3111
3112 =item How can I hide the source for my Perl program?
3113
3114 =item How can I compile my Perl program into byte code or C?
3115
3116 =item How can I compile Perl into Java?
3117
3118 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3119
3120 =item Can I write useful Perl programs on the command line?
3121
3122 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3123
3124 =item Where can I learn about CGI or Web programming in Perl?
3125
3126 =item Where can I learn about object-oriented Perl programming?
3127
3128 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3129
3130 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3131 my C program; what am I doing wrong?
3132
3133 =item When I tried to run my script, I got this message. What does it mean?
3134
3135 =item What's MakeMaker?
3136
3137 =back
3138
3139 =item AUTHOR AND COPYRIGHT
3140
3141 =back
3142
3143 =head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28
3144 17:35:21 $)
3145
3146 =over 4
3147
3148 =item DESCRIPTION
3149
3150 =item Data: Numbers
3151
3152 =over 4
3153
3154 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3155 numbers I should be getting (eg, 19.95)?
3156
3157 =item Why isn't my octal data interpreted correctly?
3158
3159 =item Does Perl have a round() function?  What about ceil() and floor()?
3160 Trig functions?
3161
3162 =item How do I convert between numeric representations?
3163
3164 How do I convert hexadecimal into decimal, How do I convert from decimal to
3165 hexadecimal, How do I convert from octal to decimal, How do I convert from
3166 decimal to octal, How do I convert from binary to decimal, How do I convert
3167 from decimal to binary
3168
3169 =item Why doesn't & work the way I want it to?
3170
3171 =item How do I multiply matrices?
3172
3173 =item How do I perform an operation on a series of integers?
3174
3175 =item How can I output Roman numerals?
3176
3177 =item Why aren't my random numbers random?
3178
3179 =item How do I get a random number between X and Y?
3180
3181 =back
3182
3183 =item Data: Dates
3184
3185 =over 4
3186
3187 =item How do I find the day or week of the year?
3188
3189 =item How can I compare two dates and find the difference?
3190
3191 =item How can I take a string and turn it into epoch seconds?
3192
3193 =item How can I find the Julian Day?
3194
3195 =item How do I find yesterday's date?
3196
3197 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3198
3199 =back
3200
3201 =item Data: Strings
3202
3203 =over 4
3204
3205 =item How do I validate input?
3206
3207 =item How do I unescape a string?
3208
3209 =item How do I remove consecutive pairs of characters?
3210
3211 =item How do I expand function calls in a string?
3212
3213 =item How do I find matching/nesting anything?
3214
3215 =item How do I reverse a string?
3216
3217 =item How do I expand tabs in a string?
3218
3219 =item How do I reformat a paragraph?
3220
3221 =item How can I access or change N characters of a string?
3222
3223 =item How do I change the Nth occurrence of something?
3224
3225 =item How can I count the number of occurrences of a substring within a
3226 string?
3227
3228 =item How do I capitalize all the words on one line?
3229
3230 =item How can I split a [character] delimited string except when inside
3231 [character]?
3232
3233 =item How do I strip blank space from the beginning/end of a string?
3234
3235 =item How do I pad a string with blanks or pad a number with zeroes?
3236
3237 =item How do I extract selected columns from a string?
3238
3239 =item How do I find the soundex value of a string?
3240
3241 =item How can I expand variables in text strings?
3242
3243 =item What's wrong with always quoting "$vars"?
3244
3245 =item Why don't my E<lt>E<lt>HERE documents work?
3246
3247 There must be no space after the E<lt>E<lt> part, There (probably) should
3248 be a semicolon at the end, You can't (easily) have any space in front of
3249 the tag
3250
3251 =back
3252
3253 =item Data: Arrays
3254
3255 =over 4
3256
3257 =item What is the difference between a list and an array?
3258
3259 =item What is the difference between $array[1] and @array[1]?
3260
3261 =item How can I remove duplicate elements from a list or array?
3262
3263 a), b), c), d), e)
3264
3265 =item How can I tell whether a certain element is contained in a list or
3266 array?
3267
3268 =item How do I compute the difference of two arrays?  How do I compute the
3269 intersection of two arrays?
3270
3271 =item How do I test whether two arrays or hashes are equal?
3272
3273 =item How do I find the first array element for which a condition is true?
3274
3275 =item How do I handle linked lists?
3276
3277 =item How do I handle circular lists?
3278
3279 =item How do I shuffle an array randomly?
3280
3281 =item How do I process/modify each element of an array?
3282
3283 =item How do I select a random element from an array?
3284
3285 =item How do I permute N elements of a list?
3286
3287 =item How do I sort an array by (anything)?
3288
3289 =item How do I manipulate arrays of bits?
3290
3291 =item Why does defined() return true on empty arrays and hashes?
3292
3293 =back
3294
3295 =item Data: Hashes (Associative Arrays)
3296
3297 =over 4
3298
3299 =item How do I process an entire hash?
3300
3301 =item What happens if I add or remove keys from a hash while iterating over
3302 it?
3303
3304 =item How do I look up a hash element by value?
3305
3306 =item How can I know how many entries are in a hash?
3307
3308 =item How do I sort a hash (optionally by value instead of key)?
3309
3310 =item How can I always keep my hash sorted?
3311
3312 =item What's the difference between "delete" and "undef" with hashes?
3313
3314 =item Why don't my tied hashes make the defined/exists distinction?
3315
3316 =item How do I reset an each() operation part-way through?
3317
3318 =item How can I get the unique keys from two hashes?
3319
3320 =item How can I store a multidimensional array in a DBM file?
3321
3322 =item How can I make my hash remember the order I put elements into it?
3323
3324 =item Why does passing a subroutine an undefined element in a hash create
3325 it?
3326
3327 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3328 array of hashes or arrays?
3329
3330 =item How can I use a reference as a hash key?
3331
3332 =back
3333
3334 =item Data: Misc
3335
3336 =over 4
3337
3338 =item How do I handle binary data correctly?
3339
3340 =item How do I determine whether a scalar is a number/whole/integer/float?
3341
3342 =item How do I keep persistent data across program calls?
3343
3344 =item How do I print out or copy a recursive data structure?
3345
3346 =item How do I define methods for every class/object?
3347
3348 =item How do I verify a credit card checksum?
3349
3350 =item How do I pack arrays of doubles or floats for XS code?
3351
3352 =back
3353
3354 =item AUTHOR AND COPYRIGHT
3355
3356 =back
3357
3358 =head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
3359 17:45:46 $)
3360
3361 =over 4
3362
3363 =item DESCRIPTION
3364
3365 =over 4
3366
3367 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3368
3369 =item How do I change one line in a file/delete a line in a file/insert a
3370 line in the middle of a file/append to the beginning of a file?
3371
3372 =item How do I count the number of lines in a file?
3373
3374 =item How can I use Perl's C<-i> option from within a program?
3375
3376 =item How do I make a temporary file name?
3377
3378 =item How can I manipulate fixed-record-length files?
3379
3380 =item How can I make a filehandle local to a subroutine?  How do I pass
3381 filehandles between subroutines?  How do I make an array of filehandles?
3382
3383 =item How can I use a filehandle indirectly?
3384
3385 =item How can I set up a footer format to be used with write()?
3386
3387 =item How can I write() into a string?
3388
3389 =item How can I output my numbers with commas added?
3390
3391 =item How can I translate tildes (~) in a filename?
3392
3393 =item How come when I open a file read-write it wipes it out?
3394
3395 =item Why do I sometimes get an "Argument list too long" when I use
3396 E<lt>*E<gt>?
3397
3398 =item Is there a leak/bug in glob()?
3399
3400 =item How can I open a file with a leading ">" or trailing blanks?
3401
3402 =item How can I reliably rename a file?
3403
3404 =item How can I lock a file?
3405
3406 =item Why can't I just open(FH, "E<gt>file.lock")?
3407
3408 =item I still don't get locking.  I just want to increment the number in
3409 the file.  How can I do this?
3410
3411 =item All I want to do is append a small amount of text to the end of a
3412 file.  Do I still have to use locking?
3413
3414 =item How do I randomly update a binary file?
3415
3416 =item How do I get a file's timestamp in perl?
3417
3418 =item How do I set a file's timestamp in perl?
3419
3420 =item How do I print to more than one file at once?
3421
3422 =item How can I read in an entire file all at once?
3423
3424 =item How can I read in a file by paragraphs?
3425
3426 =item How can I read a single character from a file?  From the keyboard?
3427
3428 =item How can I tell whether there's a character waiting on a filehandle?
3429
3430 =item How do I do a C<tail -f> in perl?
3431
3432 =item How do I dup() a filehandle in Perl?
3433
3434 =item How do I close a file descriptor by number?
3435
3436 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3437 `C:\temp\foo.exe` work?
3438
3439 =item Why doesn't glob("*.*") get all the files?
3440
3441 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3442 protected files?  Isn't this a bug in Perl?
3443
3444 =item How do I select a random line from a file?
3445
3446 =item Why do I get weird spaces when I print an array of lines?
3447
3448 =back
3449
3450 =item AUTHOR AND COPYRIGHT
3451
3452 =back
3453
3454 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
3455 20:05:28 $)
3456
3457 =over 4
3458
3459 =item DESCRIPTION
3460
3461 =over 4
3462
3463 =item How can I hope to use regular expressions without creating illegible
3464 and unmaintainable code?
3465
3466 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3467
3468 =item I'm having trouble matching over more than one line.  What's wrong?
3469
3470 =item How can I pull out lines between two patterns that are themselves on
3471 different lines?
3472
3473 =item I put a regular expression into $/ but it didn't work. What's wrong?
3474
3475 =item How do I substitute case insensitively on the LHS while preserving
3476 case on the RHS?
3477
3478 =item How can I make C<\w> match national character sets?
3479
3480 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3481
3482 =item How can I quote a variable to use in a regex?
3483
3484 =item What is C</o> really for?
3485
3486 =item How do I use a regular expression to strip C style comments from a
3487 file?
3488
3489 =item Can I use Perl regular expressions to match balanced text?
3490
3491 =item What does it mean that regexes are greedy?  How can I get around it?
3492
3493 =item How do I process each word on each line?
3494
3495 =item How can I print out a word-frequency or line-frequency summary?
3496
3497 =item How can I do approximate matching?
3498
3499 =item How do I efficiently match many regular expressions at once?
3500
3501 =item Why don't word-boundary searches with C<\b> work for me?
3502
3503 =item Why does using $&, $`, or $' slow my program down?
3504
3505 =item What good is C<\G> in a regular expression?
3506
3507 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3508
3509 =item What's wrong with using grep or map in a void context?
3510
3511 =item How can I match strings with multibyte characters?
3512
3513 =item How do I match a pattern that is supplied by the user?
3514
3515 =back
3516
3517 =item AUTHOR AND COPYRIGHT
3518
3519 =back
3520
3521 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
3522 2003/07/24 02:17:21 $)
3523
3524 =over 4
3525
3526 =item DESCRIPTION
3527
3528 =over 4
3529
3530 =item Can I get a BNF/yacc/RE for the Perl language?
3531
3532 =item What are all these $@%&* punctuation signs, and how do I know when to
3533 use them?
3534
3535 =item Do I always/never have to quote my strings or use semicolons and
3536 commas?
3537
3538 =item How do I skip some return values?
3539
3540 =item How do I temporarily block warnings?
3541
3542 =item What's an extension?
3543
3544 =item Why do Perl operators have different precedence than C operators?
3545
3546 =item How do I declare/create a structure?
3547
3548 =item How do I create a module?
3549
3550 =item How do I create a class?
3551
3552 =item How can I tell if a variable is tainted?
3553
3554 =item What's a closure?
3555
3556 =item What is variable suicide and how can I prevent it?
3557
3558 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3559 Regex}?
3560
3561 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3562 Passing Methods
3563
3564 =item How do I create a static variable?
3565
3566 =item What's the difference between dynamic and lexical (static) scoping?
3567 Between local() and my()?
3568
3569 =item How can I access a dynamic variable while a similarly named lexical
3570 is in scope?
3571
3572 =item What's the difference between deep and shallow binding?
3573
3574 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
3575
3576 =item How do I redefine a builtin function, operator, or method?
3577
3578 =item What's the difference between calling a function as &foo and foo()?
3579
3580 =item How do I create a switch or case statement?
3581
3582 =item How can I catch accesses to undefined variables, functions, or
3583 methods?
3584
3585 =item Why can't a method included in this same file be found?
3586
3587 =item How can I find out my current package?
3588
3589 =item How can I comment out a large block of perl code?
3590
3591 =item How do I clear a package?
3592
3593 =item How can I use a variable as a variable name?
3594
3595 =item What does "bad interpreter" mean?
3596
3597 =back
3598
3599 =item AUTHOR AND COPYRIGHT
3600
3601 =back
3602
3603 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
3604 17:44:04 $)
3605
3606 =over 4
3607
3608 =item DESCRIPTION
3609
3610 =over 4
3611
3612 =item How do I find out which operating system I'm running under?
3613
3614 =item How come exec() doesn't return?
3615
3616 =item How do I do fancy stuff with the keyboard/screen/mouse?
3617
3618 Keyboard, Screen, Mouse
3619
3620 =item How do I print something out in color?
3621
3622 =item How do I read just one key without waiting for a return key?
3623
3624 =item How do I check whether input is ready on the keyboard?
3625
3626 =item How do I clear the screen?
3627
3628 =item How do I get the screen size?
3629
3630 =item How do I ask the user for a password?
3631
3632 =item How do I read and write the serial port?
3633
3634 lockfiles, open mode, end of line, flushing output, non-blocking input
3635
3636 =item How do I decode encrypted password files?
3637
3638 =item How do I start a process in the background?
3639
3640 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3641
3642 =item How do I trap control characters/signals?
3643
3644 =item How do I modify the shadow password file on a Unix system?
3645
3646 =item How do I set the time and date?
3647
3648 =item How can I sleep() or alarm() for under a second?
3649
3650 =item How can I measure time under a second?
3651
3652 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3653
3654 =item Why doesn't my sockets program work under System V (Solaris)?  What
3655 does the error message "Protocol not supported" mean?
3656
3657 =item How can I call my system's unique C functions from Perl?
3658
3659 =item Where do I get the include files to do ioctl() or syscall()?
3660
3661 =item Why do setuid perl scripts complain about kernel problems?
3662
3663 =item How can I open a pipe both to and from a command?
3664
3665 =item Why can't I get the output of a command with system()?
3666
3667 =item How can I capture STDERR from an external command?
3668
3669 =item Why doesn't open() return an error when a pipe open fails?
3670
3671 =item What's wrong with using backticks in a void context?
3672
3673 =item How can I call backticks without shell processing?
3674
3675 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3676 ^Z on MS-DOS)?
3677
3678 =item How can I convert my shell script to perl?
3679
3680 =item Can I use perl to run a telnet or ftp session?
3681
3682 =item How can I write expect in Perl?
3683
3684 =item Is there a way to hide perl's command line from programs such as
3685 "ps"?
3686
3687 =item I {changed directory, modified my environment} in a perl script.  How
3688 come the change disappeared when I exited the script?  How do I get my
3689 changes to be visible?
3690
3691 Unix
3692
3693 =item How do I close a process's filehandle without waiting for it to
3694 complete?
3695
3696 =item How do I fork a daemon process?
3697
3698 =item How do I find out if I'm running interactively or not?
3699
3700 =item How do I timeout a slow event?
3701
3702 =item How do I set CPU limits?
3703
3704 =item How do I avoid zombies on a Unix system?
3705
3706 =item How do I use an SQL database?
3707
3708 =item How do I make a system() exit on control-C?
3709
3710 =item How do I open a file without blocking?
3711
3712 =item How do I install a module from CPAN?
3713
3714 =item What's the difference between require and use?
3715
3716 =item How do I keep my own module/library directory?
3717
3718 =item How do I add the directory my program lives in to the module/library
3719 search path?
3720
3721 =item How do I add a directory to my include path at runtime?
3722
3723 =item What is socket.ph and where do I get it?
3724
3725 =back
3726
3727 =item AUTHOR AND COPYRIGHT
3728
3729 =back
3730
3731 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
3732 $)
3733
3734 =over 4
3735
3736 =item DESCRIPTION
3737
3738 =over 4
3739
3740 =item What is the correct form of response from a CGI script?
3741
3742 =item My CGI script runs from the command line but not the browser.  (500
3743 Server Error)
3744
3745 =item How can I get better error messages from a CGI program?
3746
3747 =item How do I remove HTML from a string?
3748
3749 =item How do I extract URLs?
3750
3751 =item How do I download a file from the user's machine?  How do I open a
3752 file on another machine?
3753
3754 =item How do I make a pop-up menu in HTML?
3755
3756 =item How do I fetch an HTML file?
3757
3758 =item How do I automate an HTML form submission?
3759
3760 =item How do I decode or create those %-encodings on the web?
3761
3762 =item How do I redirect to another page?
3763
3764 =item How do I put a password on my web pages?
3765
3766 =item How do I edit my .htpasswd and .htgroup files with Perl?
3767
3768 =item How do I make sure users can't enter values into a form that cause my
3769 CGI script to do bad things?
3770
3771 =item How do I parse a mail header?
3772
3773 =item How do I decode a CGI form?
3774
3775 =item How do I check a valid mail address?
3776
3777 =item How do I decode a MIME/BASE64 string?
3778
3779 =item How do I return the user's mail address?
3780
3781 =item How do I send mail?
3782
3783 =item How do I use MIME to make an attachment to a mail message?
3784
3785 =item How do I read mail?
3786
3787 =item How do I find out my hostname/domainname/IP address?
3788
3789 =item How do I fetch a news article or the active newsgroups?
3790
3791 =item How do I fetch/put an FTP file?
3792
3793 =item How can I do RPC in Perl?
3794
3795 =back
3796
3797 =item AUTHOR AND COPYRIGHT
3798
3799 =back
3800
3801 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3802
3803 =over 4
3804
3805 =item DESCRIPTION
3806
3807 =over 4
3808
3809 =item Layout
3810
3811 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3812
3813 =back
3814
3815 =item Using The Back Ends
3816
3817 =over 4
3818
3819 =item The Cross Referencing Back End
3820
3821 i, &, s, r
3822
3823 =item The Decompiling Back End
3824
3825 =item The Lint Back End
3826
3827 =item The Simple C Back End
3828
3829 =item The Bytecode Back End
3830
3831 =item The Optimized C Back End
3832
3833 =back
3834
3835 =item Module List for the Compiler Suite
3836
3837 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3838 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3839 B::Stackobj, B::Stash, B::Terse, B::Xref
3840
3841 =item KNOWN PROBLEMS
3842
3843 =item AUTHOR
3844
3845 =back
3846
3847 =head2 perlembed - how to embed perl in your C program
3848
3849 =over 4
3850
3851 =item DESCRIPTION
3852
3853 =over 4
3854
3855 =item PREAMBLE
3856
3857 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3858 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3859
3860 =item ROADMAP
3861
3862 =item Compiling your C program
3863
3864 =item Adding a Perl interpreter to your C program
3865
3866 =item Calling a Perl subroutine from your C program
3867
3868 =item Evaluating a Perl statement from your C program
3869
3870 =item Performing Perl pattern matches and substitutions from your C program
3871
3872 =item Fiddling with the Perl stack from your C program
3873
3874 =item Maintaining a persistent interpreter
3875
3876 =item Execution of END blocks
3877
3878 =item Maintaining multiple interpreter instances
3879
3880 =item Using Perl modules, which themselves use C libraries, from your C
3881 program
3882
3883 =back
3884
3885 =item Embedding Perl under Win32
3886
3887 =item Hiding Perl_
3888
3889 =item MORAL
3890
3891 =item AUTHOR
3892
3893 =item COPYRIGHT
3894
3895 =back
3896
3897 =head2 perldebguts - Guts of Perl debugging
3898
3899 =over 4
3900
3901 =item DESCRIPTION
3902
3903 =item Debugger Internals
3904
3905 =over 4
3906
3907 =item Writing Your Own Debugger
3908
3909 =back
3910
3911 =item Frame Listing Output Examples
3912
3913 =item Debugging regular expressions
3914
3915 =over 4
3916
3917 =item Compile-time output
3918
3919 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3920 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3921 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3922 C<anchored(TYPE)>
3923
3924 =item Types of nodes
3925
3926 =item Run-time output
3927
3928 =back
3929
3930 =item Debugging Perl memory usage
3931
3932 =over 4
3933
3934 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3935
3936 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3937 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3938 6144>
3939
3940 =item Example of using B<-DL> switch
3941
3942 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3943
3944 =item B<-DL> details
3945
3946 C<!!!>, C<!!>, C<!>
3947
3948 =item Limitations of B<-DL> statistics
3949
3950 =back
3951
3952 =item SEE ALSO
3953
3954 =back
3955
3956 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3957
3958 =over 4
3959
3960 =item DESCRIPTION
3961
3962 =item SPECIAL NOTES
3963
3964 =over 4
3965
3966 =item make
3967
3968 =item Version caveat
3969
3970 =item Dynamic Loading versus Static Loading
3971
3972 =back
3973
3974 =item TUTORIAL
3975
3976 =over 4
3977
3978 =item EXAMPLE 1
3979
3980 =item EXAMPLE 2
3981
3982 =item What has gone on?
3983
3984 =item Writing good test scripts
3985
3986 =item EXAMPLE 3
3987
3988 =item What's new here?
3989
3990 =item Input and Output Parameters
3991
3992 =item The XSUBPP Program
3993
3994 =item The TYPEMAP file
3995
3996 =item Warning about Output Arguments
3997
3998 =item EXAMPLE 4
3999
4000 =item What has happened here?
4001
4002 =item Anatomy of .xs file
4003
4004 =item Getting the fat out of XSUBs
4005
4006 =item More about XSUB arguments
4007
4008 =item The Argument Stack
4009
4010 =item Extending your Extension
4011
4012 =item Documenting your Extension
4013
4014 =item Installing your Extension
4015
4016 =item EXAMPLE 5
4017
4018 =item New Things in this Example
4019
4020 =item EXAMPLE 6
4021
4022 =item New Things in this Example
4023
4024 =item EXAMPLE 7 (Coming Soon)
4025
4026 =item EXAMPLE 8 (Coming Soon)
4027
4028 =item EXAMPLE 9 Passing open files to XSes
4029
4030 =item Troubleshooting these Examples
4031
4032 =back
4033
4034 =item See also
4035
4036 =item Author
4037
4038 =over 4
4039
4040 =item Last Changed
4041
4042 =back
4043
4044 =back
4045
4046 =head2 perlxs - XS language reference manual
4047
4048 =over 4
4049
4050 =item DESCRIPTION
4051
4052 =over 4
4053
4054 =item Introduction
4055
4056 =item On The Road
4057
4058 =item The Anatomy of an XSUB
4059
4060 =item The Argument Stack
4061
4062 =item The RETVAL Variable
4063
4064 =item The MODULE Keyword
4065
4066 =item The PACKAGE Keyword
4067
4068 =item The PREFIX Keyword
4069
4070 =item The OUTPUT: Keyword
4071
4072 =item The NO_OUTPUT Keyword
4073
4074 =item The CODE: Keyword
4075
4076 =item The INIT: Keyword
4077
4078 =item The NO_INIT Keyword
4079
4080 =item Initializing Function Parameters
4081
4082 =item Default Parameter Values
4083
4084 =item The PREINIT: Keyword
4085
4086 =item The SCOPE: Keyword
4087
4088 =item The INPUT: Keyword
4089
4090 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4091
4092 =item The C<length(NAME)> Keyword
4093
4094 =item Variable-length Parameter Lists
4095
4096 =item The C_ARGS: Keyword
4097
4098 =item The PPCODE: Keyword
4099
4100 =item Returning Undef And Empty Lists
4101
4102 =item The REQUIRE: Keyword
4103
4104 =item The CLEANUP: Keyword
4105
4106 =item The POSTCALL: Keyword
4107
4108 =item The BOOT: Keyword
4109
4110 =item The VERSIONCHECK: Keyword
4111
4112 =item The PROTOTYPES: Keyword
4113
4114 =item The PROTOTYPE: Keyword
4115
4116 =item The ALIAS: Keyword
4117
4118 =item The OVERLOAD: Keyword
4119
4120 =item The FALLBACK: Keyword
4121
4122 =item The INTERFACE: Keyword
4123
4124 =item The INTERFACE_MACRO: Keyword
4125
4126 =item The INCLUDE: Keyword
4127
4128 =item The CASE: Keyword
4129
4130 =item The & Unary Operator
4131
4132 =item Inserting POD, Comments and C Preprocessor Directives
4133
4134 =item Using XS With C++
4135
4136 =item Interface Strategy
4137
4138 =item Perl Objects And C Structures
4139
4140 =item The Typemap
4141
4142 =item Safely Storing Static Data in XS
4143
4144 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4145
4146 =back
4147
4148 =item EXAMPLES
4149
4150 =item XS VERSION
4151
4152 =item AUTHOR
4153
4154 =back
4155
4156 =head2 perlclib - Internal replacements for standard C library functions
4157
4158 =over 4
4159
4160 =item DESCRIPTION
4161
4162 =over 4
4163
4164 =item Conventions
4165
4166 C<t>, C<p>, C<n>, C<s>
4167
4168 =item File Operations
4169
4170 =item File Input and Output
4171
4172 =item File Positioning
4173
4174 =item Memory Management and String Handling
4175
4176 =item Character Class Tests
4177
4178 =item F<stdlib.h> functions
4179
4180 =item Miscellaneous functions
4181
4182 =back
4183
4184 =item SEE ALSO
4185
4186 =back
4187
4188 =head2 perlguts - Introduction to the Perl API
4189
4190 =over 4
4191
4192 =item DESCRIPTION
4193
4194 =item Variables
4195
4196 =over 4
4197
4198 =item Datatypes
4199
4200 =item What is an "IV"?
4201
4202 =item Working with SVs
4203
4204 =item Offsets
4205
4206 =item What's Really Stored in an SV?
4207
4208 =item Working with AVs
4209
4210 =item Working with HVs
4211
4212 =item Hash API Extensions
4213
4214 =item AVs, HVs and undefined values
4215
4216 =item References
4217
4218 =item Blessed References and Class Objects
4219
4220 =item Creating New Variables
4221
4222 GV_ADDMULTI, GV_ADDWARN
4223
4224 =item Reference Counts and Mortality
4225
4226 =item Stashes and Globs
4227
4228 =item Double-Typed SVs
4229
4230 =item Magic Variables
4231
4232 =item Assigning Magic
4233
4234 =item Magic Virtual Tables
4235
4236 =item Finding Magic
4237
4238 =item Understanding the Magic of Tied Hashes and Arrays
4239
4240 =item Localizing changes
4241
4242 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4243 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4244 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4245 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4246 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4247 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4248 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4249 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4250 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4251 save_hptr(HV **hptr)>
4252
4253 =back
4254
4255 =item Subroutines
4256
4257 =over 4
4258
4259 =item XSUBs and the Argument Stack
4260
4261 =item Calling Perl Routines from within C Programs
4262
4263 =item Memory Allocation
4264
4265 =item PerlIO
4266
4267 =item Putting a C value on Perl stack
4268
4269 =item Scratchpads
4270
4271 =item Scratchpads and recursion
4272
4273 =back
4274
4275 =item Compiled code
4276
4277 =over 4
4278
4279 =item Code tree
4280
4281 =item Examining the tree
4282
4283 =item Compile pass 1: check routines
4284
4285 =item Compile pass 1a: constant folding
4286
4287 =item Compile pass 2: context propagation
4288
4289 =item Compile pass 3: peephole optimization
4290
4291 =item Pluggable runops
4292
4293 =back
4294
4295 =item Examining internal data structures with the C<dump> functions
4296
4297 =item How multiple interpreters and concurrency are supported
4298
4299 =over 4
4300
4301 =item Background and PERL_IMPLICIT_CONTEXT
4302
4303 =item So what happened to dTHR?
4304
4305 =item How do I use all this in extensions?
4306
4307 =item Should I do anything special if I call perl from multiple threads?
4308
4309 =item Future Plans and PERL_IMPLICIT_SYS
4310
4311 =back
4312
4313 =item Internal Functions
4314
4315 A, p, d, s, n, r, f, M, o, j, x
4316
4317 =over 4
4318
4319 =item Formatted Printing of IVs, UVs, and NVs
4320
4321 =item Pointer-To-Integer and Integer-To-Pointer
4322
4323 =item Source Documentation
4324
4325 =back
4326
4327 =item Unicode Support
4328
4329 =over 4
4330
4331 =item What B<is> Unicode, anyway?
4332
4333 =item How can I recognise a UTF8 string?
4334
4335 =item How does UTF8 represent Unicode characters?
4336
4337 =item How does Perl store UTF8 strings?
4338
4339 =item How do I convert a string to UTF8?
4340
4341 =item Is there anything else I need to know?
4342
4343 =back
4344
4345 =item Custom Operators
4346
4347 =item AUTHORS
4348
4349 =item SEE ALSO
4350
4351 =back
4352
4353 =head2 perlcall - Perl calling conventions from C
4354
4355 =over 4
4356
4357 =item DESCRIPTION
4358
4359 An Error Handler, An Event Driven Program
4360
4361 =item THE CALL_ FUNCTIONS
4362
4363 call_sv, call_pv, call_method, call_argv
4364
4365 =item FLAG VALUES
4366
4367 =over 4
4368
4369 =item  G_VOID
4370
4371 =item  G_SCALAR
4372
4373 =item G_ARRAY
4374
4375 =item G_DISCARD
4376
4377 =item G_NOARGS
4378
4379 =item G_EVAL
4380
4381 =item G_KEEPERR
4382
4383 =item Determining the Context
4384
4385 =back
4386
4387 =item KNOWN PROBLEMS
4388
4389 =item EXAMPLES
4390
4391 =over 4
4392
4393 =item No Parameters, Nothing returned
4394
4395 =item Passing Parameters
4396
4397 =item Returning a Scalar
4398
4399 =item Returning a list of values
4400
4401 =item Returning a list in a scalar context
4402
4403 =item Returning Data from Perl via the parameter list
4404
4405 =item Using G_EVAL
4406
4407 =item Using G_KEEPERR
4408
4409 =item Using call_sv
4410
4411 =item Using call_argv
4412
4413 =item Using call_method
4414
4415 =item Using GIMME_V
4416
4417 =item Using Perl to dispose of temporaries
4418
4419 =item Strategies for storing Callback Context Information
4420
4421 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4422 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4423 callback
4424
4425 =item Alternate Stack Manipulation
4426
4427 =item Creating and calling an anonymous subroutine in C
4428
4429 =back
4430
4431 =item SEE ALSO
4432
4433 =item AUTHOR
4434
4435 =item DATE
4436
4437 =back
4438
4439 =head2 perlutil - utilities packaged with the Perl distribution
4440
4441 =over 4
4442
4443 =item DESCRIPTION
4444
4445 =over 4
4446
4447 =item DOCUMENTATION
4448
4449 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4450 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4451 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4452 L<roffitall|roffitall>
4453
4454 =item CONVERTORS
4455
4456 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4457
4458 =item Administration
4459
4460 L<libnetcfg|libnetcfg>
4461
4462 =item Development
4463
4464 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4465 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4466
4467 =item SEE ALSO
4468
4469 =back
4470
4471 =back
4472
4473 =head2 perlfilter - Source Filters
4474
4475 =over 4
4476
4477 =item DESCRIPTION
4478
4479 =item CONCEPTS
4480
4481 =item USING FILTERS
4482
4483 =item WRITING A SOURCE FILTER
4484
4485 =item WRITING A SOURCE FILTER IN C
4486
4487 B<Decryption Filters>
4488
4489 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4490
4491 =item WRITING A SOURCE FILTER IN PERL
4492
4493 =item USING CONTEXT: THE DEBUG FILTER
4494
4495 =item CONCLUSION
4496
4497 =item THINGS TO LOOK OUT FOR
4498
4499 Some Filters Clobber the C<DATA> Handle
4500
4501 =item REQUIREMENTS
4502
4503 =item AUTHOR
4504
4505 =item Copyrights
4506
4507 =back
4508
4509 =head2 perldbmfilter - Perl DBM Filters
4510
4511 =over 4
4512
4513 =item SYNOPSIS
4514
4515 =item DESCRIPTION
4516
4517 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4518 B<filter_fetch_value>
4519
4520 =over 4
4521
4522 =item The Filter
4523
4524 =item An Example -- the NULL termination problem.
4525
4526 =item Another Example -- Key is a C int.
4527
4528 =back
4529
4530 =item SEE ALSO
4531
4532 =item AUTHOR
4533
4534 =back
4535
4536 =head2 perlapi - autogenerated documentation for the perl public API
4537
4538 =over 4
4539
4540 =item DESCRIPTION
4541
4542 =item "Gimme" Values
4543
4544 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4545
4546 =item Array Manipulation Functions
4547
4548 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4549 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4550 get_av, newAV, Nullav, sortsv
4551
4552 =item Callback Functions
4553
4554 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4555 FREETMPS, LEAVE, SAVETMPS
4556
4557 =item Character classes
4558
4559 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4560
4561 =item Cloning an interpreter
4562
4563 perl_clone
4564
4565 =item CV Manipulation Functions
4566
4567 CvSTASH, get_cv, Nullcv
4568
4569 =item Embedding Functions
4570
4571 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4572 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4573
4574 =item Functions in file pp_pack.c
4575
4576 packlist, pack_cat, unpackstring, unpack_str
4577
4578 =item Global Variables
4579
4580 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4581
4582 =item GV Functions
4583
4584 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4585 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4586
4587 =item Handy Values
4588
4589 HEf_SVKEY, Nullch, Nullsv
4590
4591 =item Hash Manipulation Functions
4592
4593 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4594 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4595 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4596 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4597 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4598
4599 =item Magical Functions
4600
4601 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4602 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4603 SvSetSV, SvSetSV_nosteal, SvSHARE
4604
4605 =item Memory Management
4606
4607 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4608 savepv, savepvn, savesharedpv, StructCopy, Zero
4609
4610 =item Miscellaneous Functions
4611
4612 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4613 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4614 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
4615
4616 =item Numeric functions
4617
4618 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4619 scan_hex, scan_oct
4620
4621 =item Optree Manipulation Functions
4622
4623 cv_const_sv, newCONSTSUB, newXS
4624
4625 =item Pad Data Structures
4626
4627 pad_sv
4628
4629 =item Stack Manipulation Macros
4630
4631 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4632 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4633 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4634 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4635 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4636
4637 =item SV Flags
4638
4639 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4640
4641 =item SV Manipulation Functions
4642
4643 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4644 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4645 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4646 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4647 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
4648 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4649 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4650 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4651 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4652 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4653 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
4654 SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
4655 SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
4656 SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
4657 sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
4658 sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
4659 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
4660 sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
4661 sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
4662 sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
4663 sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
4664 sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
4665 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
4666 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
4667 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
4668 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
4669 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4670 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4671 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4672 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
4673 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
4674 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
4675 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4676
4677 =item Unicode Support
4678
4679 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4680 pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display,
4681 to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper,
4682 utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
4683 utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4684 uvuni_to_utf8_flags
4685
4686 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4687
4688 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4689 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4690
4691 =item Warning and Dieing
4692
4693 croak, warn
4694
4695 =item AUTHORS
4696
4697 =item SEE ALSO
4698
4699 =back
4700
4701 =head2 perlintern - autogenerated documentation of purely B<internal>
4702                  Perl functions
4703
4704 =over 4
4705
4706 =item DESCRIPTION
4707
4708 =item CV reference counts and CvOUTSIDE
4709
4710 CvWEAKOUTSIDE
4711
4712 =item Functions in file pad.h
4713
4714 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4715 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4716 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4717 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV,
4718 PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4719
4720 =item Functions in file pp_ctl.c
4721
4722 find_runcv
4723
4724 =item Global Variables
4725
4726 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4727 PL_rs
4728
4729 =item GV Functions
4730
4731 is_gv_magical
4732
4733 =item IO Functions
4734
4735 start_glob
4736
4737 =item Pad Data Structures
4738
4739 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4740 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4741 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4742 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4743
4744 =item Stack Manipulation Macros
4745
4746 djSP, LVRET
4747
4748 =item SV Manipulation Functions
4749
4750 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4751
4752 =item AUTHORS
4753
4754 =item SEE ALSO
4755
4756 =back
4757
4758 =head2 perliol - C API for Perl's implementation of IO in Layers.
4759
4760 =over 4
4761
4762 =item SYNOPSIS
4763
4764 =item DESCRIPTION
4765
4766 =over 4
4767
4768 =item History and Background
4769
4770 =item Layers vs Disciplines
4771
4772 =item Data Structures
4773
4774 =item Functions and Attributes
4775
4776 =item Per-instance Data
4777
4778 =item Layers in action.
4779
4780 =item Per-instance flag bits
4781
4782 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4783 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4784 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4785 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4786
4787 =item Methods in Detail
4788
4789 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4790 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4791 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4792 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4793 Set_ptrcnt
4794
4795 =item Implementing PerlIO Layers
4796
4797 =item Core Layers
4798
4799 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4800
4801 =item Extension Layers
4802
4803 ":encoding", ":scalar", ":via"
4804
4805 =back
4806
4807 =item TODO
4808
4809 =back
4810
4811 =head2 perlapio - perl's IO abstraction interface.
4812
4813 =over 4
4814
4815 =item SYNOPSIS
4816
4817 =item DESCRIPTION
4818
4819 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4820 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4821 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4822 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4823 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4824 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4825 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4826 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4827 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4828 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4829 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4830
4831 =over 4
4832
4833 =item Co-existence with stdio
4834
4835 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4836 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4837
4838 =item "Fast gets" Functions
4839
4840 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4841 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4842 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4843 B<PerlIO_get_bufsiz(f)>
4844
4845 =item Other Functions
4846
4847 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4848 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4849
4850 =back
4851
4852 =back
4853
4854 =head2 perltodo - Perl TO-DO List
4855
4856 =over 4
4857
4858 =item DESCRIPTION
4859
4860 =item To do during 5.6.x
4861
4862 =over 4
4863
4864 =item Support for I/O disciplines
4865
4866 =item Autoload bytes.pm
4867
4868 =item Make "\u{XXXX}" et al work
4869
4870 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4871
4872 =item Overloadable regex assertions
4873
4874 =item Unicode
4875
4876 =item Work out exit/die semantics for threads
4877
4878 =item Better support for nonpreemptive threading systems like GNU pth
4879
4880 =item Typed lexicals for compiler
4881
4882 =item Compiler workarounds for Win32
4883
4884 =item AUTOLOADing in the compiler
4885
4886 =item Fixing comppadlist when compiling
4887
4888 =item Cleaning up exported namespace
4889
4890 =item Complete signal handling
4891
4892 =item Out-of-source builds
4893
4894 =item POSIX realtime support
4895
4896 =item UNIX98 support
4897
4898 =item IPv6 Support
4899
4900 =item Long double conversion
4901
4902 =item Locales
4903
4904 =item Arithmetic on non-Arabic numerals
4905
4906 =item POSIX Unicode character classes
4907
4908 =item Factoring out common suffices/prefices in regexps (trie optimization)
4909
4910 =item Security audit shipped utilities
4911
4912 =item Sort out the uid-setting mess
4913
4914 =item Custom opcodes
4915
4916 =item DLL Versioning
4917
4918 =item Introduce @( and @)
4919
4920 =item Floating point handling
4921
4922 =item IV/UV preservation
4923
4924 =item Replace pod2html with something using Pod::Parser
4925
4926 =item Automate module testing on CPAN
4927
4928 =item sendmsg and recvmsg
4929
4930 =item Rewrite perlre documentation
4931
4932 =item Convert example code to IO::Handle filehandles
4933
4934 =item Document Win32 choices
4935
4936 =item Check new modules
4937
4938 =item Make roffitall find pods and libs itself
4939
4940 =back
4941
4942 =item To do at some point
4943
4944 =over 4
4945
4946 =item Remove regular expression recursion
4947
4948 =item Memory leaks after failed eval
4949
4950 =item bitfields in pack
4951
4952 =item Cross compilation
4953
4954 =item Perl preprocessor / macros
4955
4956 =item Perl lexer in Perl
4957
4958 =item Using POSIX calls internally
4959
4960 =item -i rename file when changed
4961
4962 =item All ARGV input should act like E<lt>E<gt>
4963
4964 =item Support for rerunning debugger
4965
4966 =item Test Suite for the Debugger
4967
4968 =item my sub foo { }
4969
4970 =item One-pass global destruction
4971
4972 =item Rewrite regexp parser
4973
4974 =item Cache recently used regexps
4975
4976 =item Cross-compilation support
4977
4978 =item Bit-shifting bitvectors
4979
4980 =item debugger pragma
4981
4982 =item use less pragma
4983
4984 =item switch structures
4985
4986 =item Cache eval tree
4987
4988 =item rcatmaybe
4989
4990 =item Shrink opcode tables
4991
4992 =item Optimize away @_
4993
4994 =item Prototypes versus indirect objects
4995
4996 =item Install HTML
4997
4998 =item Prototype method calls
4999
5000 =item Return context prototype declarations
5001
5002 =item magic_setisa
5003
5004 =item Garbage collection
5005
5006 =item IO tutorial
5007
5008 =item Rewrite perldoc
5009
5010 =item Install .3p manpages
5011
5012 =item Unicode tutorial
5013
5014 =item Update POSIX.pm for 1003.1-2
5015
5016 =item Retargetable installation
5017
5018 =item POSIX emulation on non-POSIX systems
5019
5020 =item Rename Win32 headers
5021
5022 =item Finish off lvalue functions
5023
5024 =item Update sprintf documentation
5025
5026 =item Use fchown/fchmod internally
5027
5028 =item Make v-strings overloaded objects
5029
5030 =item Allow restricted hash assignment
5031
5032 =item Should overload be inheritable?
5033
5034 =item Taint rethink
5035
5036 =item Perform correctly when XSUBs call subroutines that exit via
5037 goto(LABEL) and friends
5038
5039 =back
5040
5041 =item Vague ideas
5042
5043 =over 4
5044
5045 =item ref() in list context
5046
5047 =item Make tr/// return histogram of characters in list context
5048
5049 =item Compile to real threaded code
5050
5051 =item Structured types
5052
5053 =item Modifiable $1 et al.
5054
5055 =item Procedural interfaces for IO::*, etc.
5056
5057 =item RPC modules
5058
5059 =item Attach/detach debugger from running program
5060
5061 =item GUI::Native
5062
5063 =item foreach(reverse ...)
5064
5065 =item Constant function cache
5066
5067 =item Approximate regular expression matching
5068
5069 =back
5070
5071 =item Ongoing
5072
5073 =over 4
5074
5075 =item Update guts documentation
5076
5077 =item Add more tests
5078
5079 =item Update auxiliary tools
5080
5081 =item Create debugging macros
5082
5083 =item truncate to the people
5084
5085 =item Unicode in Filenames
5086
5087 =back
5088
5089 =item Unicode in %ENV
5090
5091 =item Recently done things
5092
5093 =over 4
5094
5095 =item Alternative RE syntax module
5096
5097 =item Safe signal handling
5098
5099 =item Tie Modules
5100
5101 =item gettimeofday
5102
5103 =item setitimer and getimiter
5104
5105 =item Testing __DIE__ hook
5106
5107 =item CPP equivalent in Perl
5108
5109 =item Explicit switch statements
5110
5111 =item autocroak
5112
5113 =item UTF/EBCDIC
5114
5115 =item UTF Regexes
5116
5117 =item perlcc to produce executable
5118
5119 =item END blocks saved in compiled output
5120
5121 =item Secure temporary file module
5122
5123 =item Integrate Time::HiRes
5124
5125 =item Turn Cwd into XS
5126
5127 =item Mmap for input
5128
5129 =item Byte to/from UTF8 and UTF8 to/from local conversion
5130
5131 =item Add sockatmark support
5132
5133 =item Mailing list archives
5134
5135 =item Bug tracking
5136
5137 =item Integrate MacPerl
5138
5139 =item Web "nerve center" for Perl
5140
5141 =item Regular expression tutorial
5142
5143 =item Debugging Tutorial
5144
5145 =item Integrate new modules
5146
5147 =item Integrate profiler
5148
5149 =item Y2K error detection
5150
5151 =item Regular expression debugger
5152
5153 =item POD checker
5154
5155 =item "Dynamic" lexicals
5156
5157 =item Cache precompiled modules
5158
5159 =back
5160
5161 =item Deprecated Wishes
5162
5163 =over 4
5164
5165 =item Loop control on do{}
5166
5167 =item Lexically scoped typeglobs
5168
5169 =item format BOTTOM
5170
5171 =item report HANDLE
5172
5173 =item Generalised want()/caller())
5174
5175 =item Named prototypes
5176
5177 =item Built-in globbing
5178
5179 =item Regression tests for suidperl
5180
5181 =item Cached hash values
5182
5183 =item Add compression modules
5184
5185 =item Reorganise documentation into tutorials/references
5186
5187 =item Remove distinction between functions and operators
5188
5189 =item Make XS easier to use
5190
5191 =item Make embedding easier to use
5192
5193 =item man for perl
5194
5195 =item my $Package::variable
5196
5197 =item "or" tests defined, not truth
5198
5199 =item "class"-based lexicals
5200
5201 =item byteperl
5202
5203 =item Lazy evaluation / tail recursion removal
5204
5205 =item Make "use utf8" the default
5206
5207 =item Unicode collation and normalization
5208
5209 =item pack/unpack tutorial
5210
5211 =back
5212
5213 =back
5214
5215 =head2 perlhack - How to hack at the Perl internals
5216
5217 =over 4
5218
5219 =item DESCRIPTION
5220
5221 Does concept match the general goals of Perl?, Where is the
5222 implementation?, Backwards compatibility, Could it be a module instead?, Is
5223 the feature generic enough?, Does it potentially introduce new bugs?, Does
5224 it preclude other desirable features?, Is the implementation robust?, Is
5225 the implementation generic enough to be portable?, Is the implementation
5226 tested?, Is there enough documentation?, Is there another way to do it?,
5227 Does it create too much work?, Patches speak louder than words
5228
5229 =over 4
5230
5231 =item Keeping in sync
5232
5233 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5234 NFS, rsync'ing the patches
5235
5236 =item Why rsync the source tree
5237
5238 It's easier to rsync the source tree, It's more reliable
5239
5240 =item Why rsync the patches
5241
5242 It's easier to rsync the patches, It's a good reference, Finding a start
5243 point, Finding how to fix a bug, Finding the source of misbehaviour
5244
5245 =item Perlbug administration
5246
5247 =item Submitting patches
5248
5249 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5250 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5251
5252 =item Finding Your Way Around
5253
5254 Core modules, Tests, Documentation, Configure, Interpreter
5255
5256 =item Elements of the interpreter
5257
5258 Startup, Parsing, Optimization, Running
5259
5260 =item Internal Variable Types
5261
5262 =item Op Trees
5263
5264 =item Stacks
5265
5266 Argument stack, Mark stack, Save stack
5267
5268 =item Millions of Macros
5269
5270 =item The .i Targets
5271
5272 =item Poking at Perl
5273
5274 =item Using a source-level debugger
5275
5276 run [args], break function_name, break source.c:xxx, step, next, continue,
5277 finish, 'enter', print
5278
5279 =item gdb macro support
5280
5281 =item Dumping Perl Data Structures
5282
5283 =item Patching
5284
5285 =item Patching a core module
5286
5287 =item Adding a new function to the core
5288
5289 =item Writing a test
5290
5291 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5292 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5293 t/cmd t/run t/io t/op, t/lib ext lib
5294
5295 =item Special Make Test Targets
5296
5297 coretest, test.deparse, minitest, test.third check.third utest.third
5298 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8,
5299 test_harness
5300
5301 =item Running tests by hand
5302
5303 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5304
5305 =back
5306
5307 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5308
5309 =over 4
5310
5311 =item Rational Software's Purify
5312
5313 =item Purify on Unix
5314
5315 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5316
5317 =item Purify on NT
5318
5319 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5320
5321 =item Compaq's/Digital's/HP's Third Degree
5322
5323 =item PERL_DESTRUCT_LEVEL
5324
5325 =item Profiling
5326
5327 =item Gprof Profiling
5328
5329 -a, -b, -e routine, -f routine, -s, -z
5330
5331 =item GCC gcov Profiling
5332
5333 =item Pixie Profiling
5334
5335 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5336 -z[ero]
5337
5338 =item Miscellaneous tricks
5339
5340 =item CONCLUSION
5341
5342 I<The Road goes ever on and on, down from the door where it began.>
5343
5344 =back
5345
5346 =item AUTHOR
5347
5348 =back
5349
5350 =head2 perldoc - Look up Perl documentation in Pod format.
5351
5352 =over 4
5353
5354 =item SYNOPSIS
5355
5356 =item DESCRIPTION
5357
5358 =item OPTIONS
5359
5360 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5361 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5362 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5363 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5364 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5365 B<-V>
5366
5367 =item SECURITY
5368
5369 =item ENVIRONMENT
5370
5371 =item AUTHOR
5372
5373 =back
5374
5375 =head2 perlhist - the Perl history records
5376
5377 =over 4
5378
5379 =item DESCRIPTION
5380
5381 =item INTRODUCTION
5382
5383 =item THE KEEPERS OF THE PUMPKIN
5384
5385 =over 4
5386
5387 =item PUMPKIN?
5388
5389 =back
5390
5391 =item THE RECORDS
5392
5393 =over 4
5394
5395 =item SELECTED RELEASE SIZES
5396
5397 =item SELECTED PATCH SIZES
5398
5399 =back
5400
5401 =item THE KEEPERS OF THE RECORDS
5402
5403 =back
5404
5405 =head2 perldelta - what is new for perl v5.9.0
5406
5407 =over 4
5408
5409 =item DESCRIPTION
5410
5411 =item Incompatible Changes
5412
5413 =over 4
5414
5415 =item The C<$*> variable has been removed
5416
5417 =back
5418
5419 =item Core Enhancements
5420
5421 =over 4
5422
5423 =item Tied Arrays with Negative Array Indices
5424
5425 =back
5426
5427 =item Modules and Pragmata
5428
5429 =item Utility Changes
5430
5431 =item New Documentation
5432
5433 =item Performance Enhancements
5434
5435 =item Installation and Configuration Improvements
5436
5437 =item Selected Bug Fixes
5438
5439 =item New or Changed Diagnostics
5440
5441 =item Changed Internals
5442
5443 =item New Tests
5444
5445 =item Known Problems
5446
5447 =item Platform Specific Problems
5448
5449 =item Reporting Bugs
5450
5451 =item SEE ALSO
5452
5453 =back
5454
5455 =head2 perl58delta, perldelta - what is new for perl v5.8.0
5456
5457 =over 4
5458
5459 =item DESCRIPTION
5460
5461 =item Highlights In 5.8.0
5462
5463 =item Incompatible Changes
5464
5465 =over 4
5466
5467 =item Binary Incompatibility
5468
5469 =item 64-bit platforms and malloc
5470
5471 =item AIX Dynaloading
5472
5473 =item Attributes for C<my> variables now handled at run-time
5474
5475 =item Socket Extension Dynamic in VMS
5476
5477 =item IEEE-format Floating Point Default on OpenVMS Alpha
5478
5479 =item New Unicode Semantics (no more C<use utf8>, almost)
5480
5481 =item New Unicode Properties
5482
5483 =item REF(...) Instead Of SCALAR(...)
5484
5485 =item pack/unpack D/F recycled
5486
5487 =item glob() now returns filenames in alphabetical order
5488
5489 =item Deprecations
5490
5491 =back
5492
5493 =item Core Enhancements
5494
5495 =over 4
5496
5497 =item Unicode Overhaul
5498
5499 =item PerlIO is Now The Default
5500
5501 =item ithreads
5502
5503 =item Restricted Hashes
5504
5505 =item Safe Signals
5506
5507 =item Understanding of Numbers
5508
5509 =item Arrays now always interpolate into double-quoted strings [561]
5510
5511 =item Miscellaneous Changes
5512
5513 =back
5514
5515 =item Modules and Pragmata
5516
5517 =over 4
5518
5519 =item New Modules and Pragmata
5520
5521 =item Updated And Improved Modules and Pragmata
5522
5523 =back
5524
5525 =item Utility Changes
5526
5527 =item New Documentation
5528
5529 =item Performance Enhancements
5530
5531 =item Installation and Configuration Improvements
5532
5533 =over 4
5534
5535 =item Generic Improvements
5536
5537 =item New Or Improved Platforms
5538
5539 =back
5540
5541 =item Selected Bug Fixes
5542
5543 =over 4
5544
5545 =item Platform Specific Changes and Fixes
5546
5547 =back
5548
5549 =item New or Changed Diagnostics
5550
5551 =item Changed Internals
5552
5553 =item Security Vulnerability Closed [561]
5554
5555 =item New Tests
5556
5557 =item Known Problems
5558
5559 =over 4
5560
5561 =item The Compiler Suite Is Still Very Experimental
5562
5563 =item Localising Tied Arrays and Hashes Is Broken
5564
5565 =item Building Extensions Can Fail Because Of Largefiles
5566
5567 =item Modifying $_ Inside for(..)
5568
5569 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5570
5571 =item lib/ftmp-security tests warn 'system possibly insecure'
5572
5573 =item libwww-perl (LWP) fails base/date #51
5574
5575 =item PDL failing some tests
5576
5577 =item Perl_get_sv
5578
5579 =item Self-tying Problems
5580
5581 =item ext/threads/t/libc
5582
5583 =item Failure of Thread (5.005-style) tests
5584
5585 =item Timing problems
5586
5587 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5588
5589 =item Unicode in package/class and subroutine names does not work
5590
5591 =back
5592
5593 =item Platform Specific Problems
5594
5595 =over 4
5596
5597 =item AIX
5598
5599 =item Alpha systems with old gccs fail several tests
5600
5601 =item AmigaOS
5602
5603 =item BeOS
5604
5605 =item Cygwin "unable to remap"
5606
5607 =item Cygwin ndbm tests fail on FAT
5608
5609 =item DJGPP Failures
5610
5611 =item FreeBSD built with ithreads coredumps reading large directories
5612
5613 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5614
5615 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5616
5617 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5618
5619 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5620
5621 =item Linux With Sfio Fails op/misc Test 48
5622
5623 =item Mac OS X
5624
5625 =item Mac OS X dyld undefined symbols
5626
5627 =item OS/2 Test Failures
5628
5629 =item op/sprintf tests 91, 129, and 130
5630
5631 =item SCO
5632
5633 =item Solaris 2.5
5634
5635 =item Solaris x86 Fails Tests With -Duse64bitint
5636
5637 =item SUPER-UX (NEC SX)
5638
5639 =item Term::ReadKey not working on Win32
5640
5641 =item UNICOS/mk
5642
5643 =item UTS
5644
5645 =item VOS (Stratus)
5646
5647 =item VMS
5648
5649 =item Win32
5650
5651 =item XML::Parser not working
5652
5653 =item z/OS (OS/390)
5654
5655 =item Unicode Support on EBCDIC Still Spotty
5656
5657 =item Seen In Perl 5.7 But Gone Now
5658
5659 =back
5660
5661 =item Reporting Bugs
5662
5663 =item SEE ALSO
5664
5665 =item HISTORY
5666
5667 =back
5668
5669 =head2 perl573delta - what's new for perl v5.7.3
5670
5671 =over 4
5672
5673 =item DESCRIPTION
5674
5675 =item Changes
5676
5677 =item Reporting Bugs
5678
5679 =item SEE ALSO
5680
5681 =item HISTORY
5682
5683 =back
5684
5685 =head2 perl572delta - what's new for perl v5.7.2
5686
5687 =over 4
5688
5689 =item DESCRIPTION
5690
5691 =item Security Vulnerability Closed
5692
5693 =item Incompatible Changes
5694
5695 =over 4
5696
5697 =item 64-bit platforms and malloc
5698
5699 =item AIX Dynaloading
5700
5701 =item Socket Extension Dynamic in VMS
5702
5703 =item Different Definition of the Unicode Character Classes \p{In...}
5704
5705 =item Deprecations
5706
5707 =back
5708
5709 =item Core Enhancements
5710
5711 =item Modules and Pragmata
5712
5713 =over 4
5714
5715 =item New Modules and Distributions
5716
5717 =item Updated And Improved Modules and Pragmata
5718
5719 =back
5720
5721 =item Utility Changes
5722
5723 =item New Documentation
5724
5725 =item Installation and Configuration Improvements
5726
5727 =over 4
5728
5729 =item New Or Improved Platforms
5730
5731 =item Generic Improvements
5732
5733 =back
5734
5735 =item Selected Bug Fixes
5736
5737 =over 4
5738
5739 =item Platform Specific Changes and Fixes
5740
5741 =back
5742
5743 =item New or Changed Diagnostics
5744
5745 =item Source Code Enhancements
5746
5747 =over 4
5748
5749 =item MAGIC constants
5750
5751 =item Better commented code
5752
5753 =item Regex pre-/post-compilation items matched up
5754
5755 =item gcc -Wall
5756
5757 =back
5758
5759 =item New Tests
5760
5761 =item Known Problems
5762
5763 =over 4
5764
5765 =item AIX
5766
5767 =item Amiga Perl Invoking Mystery
5768
5769 =item lib/ftmp-security tests warn 'system possibly insecure'
5770
5771 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5772
5773 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5774
5775 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5776
5777 =item Linux With Sfio Fails op/misc Test 48
5778
5779 =item OS/390
5780
5781 =item op/sprintf tests 129 and 130
5782
5783 =item  Failure of Thread tests
5784
5785 =item UNICOS
5786
5787 =item UTS
5788
5789 =item VMS
5790
5791 =item Win32
5792
5793 =item Localising a Tied Variable Leaks Memory
5794
5795 =item Self-tying of Arrays and Hashes Is Forbidden
5796
5797 =item Variable Attributes are not Currently Usable for Tieing
5798
5799 =item Building Extensions Can Fail Because Of Largefiles
5800
5801 =item The Compiler Suite Is Still Experimental
5802
5803 =item The Long Double Support is Still Experimental
5804
5805 =back
5806
5807 =item Reporting Bugs
5808
5809 =item SEE ALSO
5810
5811 =item HISTORY
5812
5813 =back
5814
5815 =head2 perl571delta - what's new for perl v5.7.1
5816
5817 =over 4
5818
5819 =item DESCRIPTION
5820
5821 =item Security Vulnerability Closed
5822
5823 =item Incompatible Changes
5824
5825 =item Core Enhancements
5826
5827 =over 4
5828
5829 =item AUTOLOAD Is Now Lvaluable
5830
5831 =item PerlIO is Now The Default
5832
5833 =item Signals Are Now Safe
5834
5835 =back
5836
5837 =item Modules and Pragmata
5838
5839 =over 4
5840
5841 =item New Modules
5842
5843 =item Updated And Improved Modules and Pragmata
5844
5845 =back
5846
5847 =item Performance Enhancements
5848
5849 =item Utility Changes
5850
5851 =item New Documentation
5852
5853 =over 4
5854
5855 =item perlclib
5856
5857 =item perliol
5858
5859 =item README.aix
5860
5861 =item README.bs2000
5862
5863 =item README.macos
5864
5865 =item README.mpeix
5866
5867 =item README.solaris
5868
5869 =item README.vos
5870
5871 =item Porting/repository.pod
5872
5873 =back
5874
5875 =item Installation and Configuration Improvements
5876
5877 =over 4
5878
5879 =item New Or Improved Platforms
5880
5881 =item Generic Improvements
5882
5883 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5884 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5885 d_strtoq, d_u32align, d_ualarm, d_usleep
5886
5887 =back
5888
5889 =item Selected Bug Fixes
5890
5891 =over 4
5892
5893 =item Platform Specific Changes and Fixes
5894
5895 =back
5896
5897 =item New or Changed Diagnostics
5898
5899 =item Changed Internals
5900
5901 =item New Tests
5902
5903 =item Known Problems
5904
5905 =over 4
5906
5907 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5908
5909 =item lib/ftmp-security tests warn 'system possibly insecure'
5910
5911 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5912
5913 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5914
5915 =item lib/b test 19
5916
5917 =item Linux With Sfio Fails op/misc Test 48
5918
5919 =item sigaction test 13 in VMS
5920
5921 =item sprintf tests 129 and 130
5922
5923 =item  Failure of Thread tests
5924
5925 =item Localising a Tied Variable Leaks Memory
5926
5927 =item Self-tying of Arrays and Hashes Is Forbidden
5928
5929 =item Building Extensions Can Fail Because Of Largefiles
5930
5931 =item The Compiler Suite Is Still Experimental
5932
5933 =back
5934
5935 =item Reporting Bugs
5936
5937 =item SEE ALSO
5938
5939 =item HISTORY
5940
5941 =back
5942
5943 =head2 perl570delta - what's new for perl v5.7.0
5944
5945 =over 4
5946
5947 =item DESCRIPTION
5948
5949 =item Security Vulnerability Closed
5950
5951 =item Incompatible Changes
5952
5953 =item Core Enhancements
5954
5955 =item Modules and Pragmata
5956
5957 =over 4
5958
5959 =item New Modules
5960
5961 =item Updated And Improved Modules and Pragmata
5962
5963 =back
5964
5965 =item Utility Changes
5966
5967 =item New Documentation
5968
5969 =item Performance Enhancements
5970
5971 =item Installation and Configuration Improvements
5972
5973 =over 4
5974
5975 =item Generic Improvements
5976
5977 =back
5978
5979 =item Selected Bug Fixes
5980
5981 =over 4
5982
5983 =item Platform Specific Changes and Fixes
5984
5985 =back
5986
5987 =item New or Changed Diagnostics
5988
5989 =item Changed Internals
5990
5991 =item Known Problems
5992
5993 =over 4
5994
5995 =item Unicode Support Still Far From Perfect
5996
5997 =item EBCDIC Still A Lost Platform
5998
5999 =item Building Extensions Can Fail Because Of Largefiles
6000
6001 =item ftmp-security tests warn 'system possibly insecure'
6002
6003 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6004
6005 =item Long Doubles Still Don't Work In Solaris
6006
6007 =item Linux With Sfio Fails op/misc Test 48
6008
6009 =item Storable tests fail in some platforms
6010
6011 =item Threads Are Still Experimental
6012
6013 =item The Compiler Suite Is Still Experimental
6014
6015 =back
6016
6017 =item Reporting Bugs
6018
6019 =item SEE ALSO
6020
6021 =item HISTORY
6022
6023 =back
6024
6025 =head2 perl561delta - what's new for perl v5.6.x
6026
6027 =over 4
6028
6029 =item DESCRIPTION
6030
6031 =item Summary of changes between 5.6.0 and 5.6.1
6032
6033 =over 4
6034
6035 =item Security Issues
6036
6037 =item Core bug fixes
6038
6039 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6040 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6041 references to special variables, Lexical warnings, Spurious warnings and
6042 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6043 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6044 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6045 Module;>, Tests
6046
6047 =item Core features
6048
6049 =item Configuration issues
6050
6051 =item Documentation
6052
6053 =item Bundled modules
6054
6055 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6056 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6057 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6058 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6059
6060 =item Platform-specific improvements
6061
6062 NCR MP-RAS, NonStop-UX
6063
6064 =back
6065
6066 =item Core Enhancements
6067
6068 =over 4
6069
6070 =item Interpreter cloning, threads, and concurrency
6071
6072 =item Lexically scoped warning categories
6073
6074 =item Unicode and UTF-8 support
6075
6076 =item Support for interpolating named characters
6077
6078 =item "our" declarations
6079
6080 =item Support for strings represented as a vector of ordinals
6081
6082 =item Improved Perl version numbering system
6083
6084 =item New syntax for declaring subroutine attributes
6085
6086 =item File and directory handles can be autovivified
6087
6088 =item open() with more than two arguments
6089
6090 =item 64-bit support
6091
6092 =item Large file support
6093
6094 =item Long doubles
6095
6096 =item "more bits"
6097
6098 =item Enhanced support for sort() subroutines
6099
6100 =item C<sort $coderef @foo> allowed
6101
6102 =item File globbing implemented internally
6103
6104 =item Support for CHECK blocks
6105
6106 =item POSIX character class syntax [: :] supported
6107
6108 =item Better pseudo-random number generator
6109
6110 =item Improved C<qw//> operator
6111
6112 =item Better worst-case behavior of hashes
6113
6114 =item pack() format 'Z' supported
6115
6116 =item pack() format modifier '!' supported
6117
6118 =item pack() and unpack() support counted strings
6119
6120 =item Comments in pack() templates
6121
6122 =item Weak references
6123
6124 =item Binary numbers supported
6125
6126 =item Lvalue subroutines
6127
6128 =item Some arrows may be omitted in calls through references
6129
6130 =item Boolean assignment operators are legal lvalues
6131
6132 =item exists() is supported on subroutine names
6133
6134 =item exists() and delete() are supported on array elements
6135
6136 =item Pseudo-hashes work better
6137
6138 =item Automatic flushing of output buffers
6139
6140 =item Better diagnostics on meaningless filehandle operations
6141
6142 =item Where possible, buffered data discarded from duped input filehandle
6143
6144 =item eof() has the same old magic as <>
6145
6146 =item binmode() can be used to set :crlf and :raw modes
6147
6148 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6149
6150 =item system(), backticks and pipe open now reflect exec() failure
6151
6152 =item Improved diagnostics
6153
6154 =item Diagnostics follow STDERR
6155
6156 =item More consistent close-on-exec behavior
6157
6158 =item syswrite() ease-of-use
6159
6160 =item Better syntax checks on parenthesized unary operators
6161
6162 =item Bit operators support full native integer width
6163
6164 =item Improved security features
6165
6166 =item More functional bareword prototype (*)
6167
6168 =item C<require> and C<do> may be overridden
6169
6170 =item $^X variables may now have names longer than one character
6171
6172 =item New variable $^C reflects C<-c> switch
6173
6174 =item New variable $^V contains Perl version as a string
6175
6176 =item Optional Y2K warnings
6177
6178 =item Arrays now always interpolate into double-quoted strings
6179
6180 =back
6181
6182 =item Modules and Pragmata
6183
6184 =over 4
6185
6186 =item Modules
6187
6188 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6189 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6190 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6191 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6192 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6193 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6194 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6195 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6196
6197 =item Pragmata
6198
6199 =back
6200
6201 =item Utility Changes
6202
6203 =over 4
6204
6205 =item dprofpp
6206
6207 =item find2perl
6208
6209 =item h2xs
6210
6211 =item perlcc
6212
6213 =item perldoc
6214
6215 =item The Perl Debugger
6216
6217 =back
6218
6219 =item Improved Documentation
6220
6221 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6222 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6223 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6224 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6225
6226 =item Performance enhancements
6227
6228 =over 4
6229
6230 =item Simple sort() using { $a <=> $b } and the like are optimized
6231
6232 =item Optimized assignments to lexical variables
6233
6234 =item Faster subroutine calls
6235
6236 =item delete(), each(), values() and hash iteration are faster
6237
6238 =back
6239
6240 =item Installation and Configuration Improvements
6241
6242 =over 4
6243
6244 =item -Dusethreads means something different
6245
6246 =item New Configure flags
6247
6248 =item Threadedness and 64-bitness now more daring
6249
6250 =item Long Doubles
6251
6252 =item -Dusemorebits
6253
6254 =item -Duselargefiles
6255
6256 =item installusrbinperl
6257
6258 =item SOCKS support
6259
6260 =item C<-A> flag
6261
6262 =item Enhanced Installation Directories
6263
6264 =item gcc automatically tried if 'cc' does not seem to be working
6265
6266 =back
6267
6268 =item Platform specific changes
6269
6270 =over 4
6271
6272 =item Supported platforms
6273
6274 =item DOS
6275
6276 =item OS390 (OpenEdition MVS)
6277
6278 =item VMS
6279
6280 =item Win32
6281
6282 =back
6283
6284 =item Significant bug fixes
6285
6286 =over 4
6287
6288 =item <HANDLE> on empty files
6289
6290 =item C<eval '...'> improvements
6291
6292 =item All compilation errors are true errors
6293
6294 =item Implicitly closed filehandles are safer
6295
6296 =item Behavior of list slices is more consistent
6297
6298 =item C<(\$)> prototype and C<$foo{a}>
6299
6300 =item C<goto &sub> and AUTOLOAD
6301
6302 =item C<-bareword> allowed under C<use integer>
6303
6304 =item Failures in DESTROY()
6305
6306 =item Locale bugs fixed
6307
6308 =item Memory leaks
6309
6310 =item Spurious subroutine stubs after failed subroutine calls
6311
6312 =item Taint failures under C<-U>
6313
6314 =item END blocks and the C<-c> switch
6315
6316 =item Potential to leak DATA filehandles
6317
6318 =back
6319
6320 =item New or Changed Diagnostics
6321
6322 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6323 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6324 / cannot take a count, / must be followed by a, A or Z, / must be followed
6325 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6326 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6327 passed through, /%s/ should probably be written as "%s", %s() called too
6328 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6329 argument is not a HASH or ARRAY element or slice, %s argument is not a
6330 subroutine name, %s package attribute may clash with future reserved word:
6331 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6332 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6333 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6334 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6335 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6336 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6337 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6338 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6339 weaken a nonreference, Character class [:%s:] unknown, Character class
6340 syntax [%s] belongs inside character classes, Constant is not %s reference,
6341 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6342 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6343 "local" instead of "our"?), Document contains no data, entering effective
6344 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6345 output, flock() on closed filehandle %s, Global symbol "%s" requires
6346 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6347 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6348 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6349 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6350 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6351 separator character %s in attribute list, Invalid separator character %s in
6352 subroutine attribute list, leaving effective %s failed, Lvalue subs
6353 returning %s not implemented yet, Method %s not permitted, Missing
6354 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6355 No %s specified for -%c, No package name allowed for variable %s in "our",
6356 No space allowed after -%c, no UTC offset information; assuming local time
6357 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6358 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6359 around "%s" list, Possible unintended interpolation of %s in string,
6360 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6361 instead, Premature end of script headers, Repeat count in pack overflows,
6362 Repeat count in unpack overflows, realloc() of freed memory ignored,
6363 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6364 zero-length expression, switching effective %s is not implemented, This
6365 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6366 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6367 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6368 escape \\%c passed through, Unterminated attribute parameter in attribute
6369 list, Unterminated attribute list, Unterminated attribute parameter in
6370 subroutine attribute list, Unterminated subroutine attribute list, Value of
6371 CLI symbol "%s" too long, Version number must be a constant number
6372
6373 =item New tests
6374
6375 =item Incompatible Changes
6376
6377 =over 4
6378
6379 =item Perl Source Incompatibilities
6380
6381 CHECK is a new keyword, Treatment of list slices of undef has changed,
6382 Format of $English::PERL_VERSION is different, Literals of the form
6383 C<1.2.3> parse differently, Possibly changed pseudo-random number
6384 generator, Hashing function for hash keys has changed, C<undef> fails on
6385 read only values, Close-on-exec bit may be set on pipe and socket handles,
6386 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6387 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6388 Text of some diagnostic output has changed, C<%@> has been removed,
6389 Parenthesized not() behaves like a list operator, Semantics of bareword
6390 prototype C<(*)> have changed, Semantics of bit operators may have changed
6391 on 64-bit platforms, More builtins taint their results
6392
6393 =item C Source Incompatibilities
6394
6395 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6396
6397 =item Compatible C Source API Changes
6398
6399 C<PATCHLEVEL> is now C<PERL_VERSION>
6400
6401 =item Binary Incompatibilities
6402
6403 =back
6404
6405 =item Known Problems
6406
6407 =over 4
6408
6409 =item Localizing a tied hash element may leak memory
6410
6411 =item Known test failures
6412
6413 =item EBCDIC platforms not fully supported
6414
6415 =item UNICOS/mk CC failures during Configure run
6416
6417 =item Arrow operator and arrays
6418
6419 =item Experimental features
6420
6421 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6422 pseudo-hash data type, The Compiler suite, Internal implementation of file
6423 globbing, The DB module, The regular expression code constructs:
6424
6425 =back
6426
6427 =item Obsolete Diagnostics
6428
6429 Character class syntax [: :] is reserved for future extensions, Ill-formed
6430 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6431 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6432 to mean "${$}<digit>" is deprecated
6433
6434 =item Reporting Bugs
6435
6436 =item SEE ALSO
6437
6438 =item HISTORY
6439
6440 =back
6441
6442 =head2 perl56delta - what's new for perl v5.6.0
6443
6444 =over 4
6445
6446 =item DESCRIPTION
6447
6448 =item Core Enhancements
6449
6450 =over 4
6451
6452 =item Interpreter cloning, threads, and concurrency
6453
6454 =item Lexically scoped warning categories
6455
6456 =item Unicode and UTF-8 support
6457
6458 =item Support for interpolating named characters
6459
6460 =item "our" declarations
6461
6462 =item Support for strings represented as a vector of ordinals
6463
6464 =item Improved Perl version numbering system
6465
6466 =item New syntax for declaring subroutine attributes
6467
6468 =item File and directory handles can be autovivified
6469
6470 =item open() with more than two arguments
6471
6472 =item 64-bit support
6473
6474 =item Large file support
6475
6476 =item Long doubles
6477
6478 =item "more bits"
6479
6480 =item Enhanced support for sort() subroutines
6481
6482 =item C<sort $coderef @foo> allowed
6483
6484 =item File globbing implemented internally
6485
6486 =item Support for CHECK blocks
6487
6488 =item POSIX character class syntax [: :] supported
6489
6490 =item Better pseudo-random number generator
6491
6492 =item Improved C<qw//> operator
6493
6494 =item Better worst-case behavior of hashes
6495
6496 =item pack() format 'Z' supported
6497
6498 =item pack() format modifier '!' supported
6499
6500 =item pack() and unpack() support counted strings
6501
6502 =item Comments in pack() templates
6503
6504 =item Weak references
6505
6506 =item Binary numbers supported
6507
6508 =item Lvalue subroutines
6509
6510 =item Some arrows may be omitted in calls through references
6511
6512 =item Boolean assignment operators are legal lvalues
6513
6514 =item exists() is supported on subroutine names
6515
6516 =item exists() and delete() are supported on array elements
6517
6518 =item Pseudo-hashes work better
6519
6520 =item Automatic flushing of output buffers
6521
6522 =item Better diagnostics on meaningless filehandle operations
6523
6524 =item Where possible, buffered data discarded from duped input filehandle
6525
6526 =item eof() has the same old magic as <>
6527
6528 =item binmode() can be used to set :crlf and :raw modes
6529
6530 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6531
6532 =item system(), backticks and pipe open now reflect exec() failure
6533
6534 =item Improved diagnostics
6535
6536 =item Diagnostics follow STDERR
6537
6538 =item More consistent close-on-exec behavior
6539
6540 =item syswrite() ease-of-use
6541
6542 =item Better syntax checks on parenthesized unary operators
6543
6544 =item Bit operators support full native integer width
6545
6546 =item Improved security features
6547
6548 =item More functional bareword prototype (*)
6549
6550 =item C<require> and C<do> may be overridden
6551
6552 =item $^X variables may now have names longer than one character
6553
6554 =item New variable $^C reflects C<-c> switch
6555
6556 =item New variable $^V contains Perl version as a string
6557
6558 =item Optional Y2K warnings
6559
6560 =item Arrays now always interpolate into double-quoted strings
6561
6562 =back
6563
6564 =item Modules and Pragmata
6565
6566 =over 4
6567
6568 =item Modules
6569
6570 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6571 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6572 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6573 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6574 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6575 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6576 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6577 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6578
6579 =item Pragmata
6580
6581 =back
6582
6583 =item Utility Changes
6584
6585 =over 4
6586
6587 =item dprofpp
6588
6589 =item find2perl
6590
6591 =item h2xs
6592
6593 =item perlcc
6594
6595 =item perldoc
6596
6597 =item The Perl Debugger
6598
6599 =back
6600
6601 =item Improved Documentation
6602
6603 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6604 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6605 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6606 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6607
6608 =item Performance enhancements
6609
6610 =over 4
6611
6612 =item Simple sort() using { $a <=> $b } and the like are optimized
6613
6614 =item Optimized assignments to lexical variables
6615
6616 =item Faster subroutine calls
6617
6618 =item delete(), each(), values() and hash iteration are faster
6619
6620 =back
6621
6622 =item Installation and Configuration Improvements
6623
6624 =over 4
6625
6626 =item -Dusethreads means something different
6627
6628 =item New Configure flags
6629
6630 =item Threadedness and 64-bitness now more daring
6631
6632 =item Long Doubles
6633
6634 =item -Dusemorebits
6635
6636 =item -Duselargefiles
6637
6638 =item installusrbinperl
6639
6640 =item SOCKS support
6641
6642 =item C<-A> flag
6643
6644 =item Enhanced Installation Directories
6645
6646 =back
6647
6648 =item Platform specific changes
6649
6650 =over 4
6651
6652 =item Supported platforms
6653
6654 =item DOS
6655
6656 =item OS390 (OpenEdition MVS)
6657
6658 =item VMS
6659
6660 =item Win32
6661
6662 =back
6663
6664 =item Significant bug fixes
6665
6666 =over 4
6667
6668 =item <HANDLE> on empty files
6669
6670 =item C<eval '...'> improvements
6671
6672 =item All compilation errors are true errors
6673
6674 =item Implicitly closed filehandles are safer
6675
6676 =item Behavior of list slices is more consistent
6677
6678 =item C<(\$)> prototype and C<$foo{a}>
6679
6680 =item C<goto &sub> and AUTOLOAD
6681
6682 =item C<-bareword> allowed under C<use integer>
6683
6684 =item Failures in DESTROY()
6685
6686 =item Locale bugs fixed
6687
6688 =item Memory leaks
6689
6690 =item Spurious subroutine stubs after failed subroutine calls
6691
6692 =item Taint failures under C<-U>
6693
6694 =item END blocks and the C<-c> switch
6695
6696 =item Potential to leak DATA filehandles
6697
6698 =back
6699
6700 =item New or Changed Diagnostics
6701
6702 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6703 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6704 / cannot take a count, / must be followed by a, A or Z, / must be followed
6705 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6706 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6707 passed through, /%s/ should probably be written as "%s", %s() called too
6708 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6709 argument is not a HASH or ARRAY element or slice, %s argument is not a
6710 subroutine name, %s package attribute may clash with future reserved word:
6711 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6712 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6713 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6714 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6715 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6716 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6717 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6718 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6719 weaken a nonreference, Character class [:%s:] unknown, Character class
6720 syntax [%s] belongs inside character classes, Constant is not %s reference,
6721 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6722 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6723 "local" instead of "our"?), Document contains no data, entering effective
6724 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6725 output, flock() on closed filehandle %s, Global symbol "%s" requires
6726 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6727 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6728 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6729 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6730 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6731 separator character %s in attribute list, Invalid separator character %s in
6732 subroutine attribute list, leaving effective %s failed, Lvalue subs
6733 returning %s not implemented yet, Method %s not permitted, Missing
6734 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6735 No %s specified for -%c, No package name allowed for variable %s in "our",
6736 No space allowed after -%c, no UTC offset information; assuming local time
6737 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6738 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6739 around "%s" list, Possible unintended interpolation of %s in string,
6740 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6741 instead, Premature end of script headers, Repeat count in pack overflows,
6742 Repeat count in unpack overflows, realloc() of freed memory ignored,
6743 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6744 zero-length expression, switching effective %s is not implemented, This
6745 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6746 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6747 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6748 escape \\%c passed through, Unterminated attribute parameter in attribute
6749 list, Unterminated attribute list, Unterminated attribute parameter in
6750 subroutine attribute list, Unterminated subroutine attribute list, Value of
6751 CLI symbol "%s" too long, Version number must be a constant number
6752
6753 =item New tests
6754
6755 =item Incompatible Changes
6756
6757 =over 4
6758
6759 =item Perl Source Incompatibilities
6760
6761 CHECK is a new keyword, Treatment of list slices of undef has changed,
6762 Format of $English::PERL_VERSION is different, Literals of the form
6763 C<1.2.3> parse differently, Possibly changed pseudo-random number
6764 generator, Hashing function for hash keys has changed, C<undef> fails on
6765 read only values, Close-on-exec bit may be set on pipe and socket handles,
6766 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6767 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6768 Text of some diagnostic output has changed, C<%@> has been removed,
6769 Parenthesized not() behaves like a list operator, Semantics of bareword
6770 prototype C<(*)> have changed, Semantics of bit operators may have changed
6771 on 64-bit platforms, More builtins taint their results
6772
6773 =item C Source Incompatibilities
6774
6775 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6776
6777 =item Compatible C Source API Changes
6778
6779 C<PATCHLEVEL> is now C<PERL_VERSION>
6780
6781 =item Binary Incompatibilities
6782
6783 =back
6784
6785 =item Known Problems
6786
6787 =over 4
6788
6789 =item Thread test failures
6790
6791 =item EBCDIC platforms not supported
6792
6793 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6794
6795 =item NEXTSTEP 3.3 POSIX test failure
6796
6797 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6798 gcc
6799
6800 =item UNICOS/mk CC failures during Configure run
6801
6802 =item Arrow operator and arrays
6803
6804 =item Experimental features
6805
6806 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6807 pseudo-hash data type, The Compiler suite, Internal implementation of file
6808 globbing, The DB module, The regular expression code constructs:
6809
6810 =back
6811
6812 =item Obsolete Diagnostics
6813
6814 Character class syntax [: :] is reserved for future extensions, Ill-formed
6815 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6816 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6817 to mean "${$}<digit>" is deprecated
6818
6819 =item Reporting Bugs
6820
6821 =item SEE ALSO
6822
6823 =item HISTORY
6824
6825 =back
6826
6827 =head2 perl5005delta - what's new for perl5.005
6828
6829 =over 4
6830
6831 =item DESCRIPTION
6832
6833 =item About the new versioning system
6834
6835 =item Incompatible Changes
6836
6837 =over 4
6838
6839 =item WARNING:  This version is not binary compatible with Perl 5.004.
6840
6841 =item Default installation structure has changed
6842
6843 =item Perl Source Compatibility
6844
6845 =item C Source Compatibility
6846
6847 =item Binary Compatibility
6848
6849 =item Security fixes may affect compatibility
6850
6851 =item Relaxed new mandatory warnings introduced in 5.004
6852
6853 =item Licensing
6854
6855 =back
6856
6857 =item Core Changes
6858
6859 =over 4
6860
6861 =item Threads
6862
6863 =item Compiler
6864
6865 =item Regular Expressions
6866
6867 Many new and improved optimizations, Many bug fixes, New regular expression
6868 constructs, New operator for precompiled regular expressions, Other
6869 improvements, Incompatible changes
6870
6871 =item   Improved malloc()
6872
6873 =item Quicksort is internally implemented
6874
6875 =item Reliable signals
6876
6877 =item Reliable stack pointers
6878
6879 =item More generous treatment of carriage returns
6880
6881 =item Memory leaks
6882
6883 =item Better support for multiple interpreters
6884
6885 =item Behavior of local() on array and hash elements is now well-defined
6886
6887 =item C<%!> is transparently tied to the L<Errno> module
6888
6889 =item Pseudo-hashes are supported
6890
6891 =item C<EXPR foreach EXPR> is supported
6892
6893 =item Keywords can be globally overridden
6894
6895 =item C<$^E> is meaningful on Win32
6896
6897 =item C<foreach (1..1000000)> optimized
6898
6899 =item C<Foo::> can be used as implicitly quoted package name
6900
6901 =item C<exists $Foo::{Bar::}> tests existence of a package
6902
6903 =item Better locale support
6904
6905 =item Experimental support for 64-bit platforms
6906
6907 =item prototype() returns useful results on builtins
6908
6909 =item Extended support for exception handling
6910
6911 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6912
6913 =item All C<printf> format conversions are handled internally
6914
6915 =item New C<INIT> keyword
6916
6917 =item New C<lock> keyword
6918
6919 =item New C<qr//> operator
6920
6921 =item C<our> is now a reserved word
6922
6923 =item Tied arrays are now fully supported
6924
6925 =item Tied handles support is better
6926
6927 =item 4th argument to substr
6928
6929 =item Negative LENGTH argument to splice
6930
6931 =item Magic lvalues are now more magical
6932
6933 =item <> now reads in records
6934
6935 =back
6936
6937 =item Supported Platforms
6938
6939 =over 4
6940
6941 =item New Platforms
6942
6943 =item Changes in existing support
6944
6945 =back
6946
6947 =item Modules and Pragmata
6948
6949 =over 4
6950
6951 =item New Modules
6952
6953 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6954 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6955 Thread, attrs, fields, re
6956
6957 =item Changes in existing modules
6958
6959 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6960 MakeMaker, CPAN, Cwd
6961
6962 =back
6963
6964 =item Utility Changes
6965
6966 =item Documentation Changes
6967
6968 =item New Diagnostics
6969
6970 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6971 while coercing array into hash, Bareword "%s" refers to nonexistent
6972 package, Can't call method "%s" on an undefined value, Can't check
6973 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6974 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6975 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6976 for "%s", Character class syntax [. .] is reserved for future extensions,
6977 Character class syntax [: :] is reserved for future extensions, Character
6978 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6979 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6980 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6981 package main), Illegal hex digit ignored, No such array field, No such
6982 field "%s" in variable %s of type %s, Out of memory during ridiculously
6983 large request, Range iterator outside integer range, Recursive inheritance
6984 detected while looking for method '%s' %s, Reference found where even-sized
6985 list expected, Undefined value assigned to typeglob, Use of reserved word
6986 "%s" is deprecated, perl: warning: Setting locale failed
6987
6988 =item Obsolete Diagnostics
6989
6990 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6991 temporary file, regexp too big
6992
6993 =item Configuration Changes
6994
6995 =item BUGS
6996
6997 =item SEE ALSO
6998
6999 =item HISTORY
7000
7001 =back
7002
7003 =head2 perl5004delta - what's new for perl5.004
7004
7005 =over 4
7006
7007 =item DESCRIPTION
7008
7009 =item Supported Environments
7010
7011 =item Core Changes
7012
7013 =over 4
7014
7015 =item List assignment to %ENV works
7016
7017 =item Change to "Can't locate Foo.pm in @INC" error
7018
7019 =item Compilation option: Binary compatibility with 5.003
7020
7021 =item $PERL5OPT environment variable
7022
7023 =item Limitations on B<-M>, B<-m>, and B<-T> options
7024
7025 =item More precise warnings
7026
7027 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7028
7029 =item Previously deprecated %OVERLOAD is no longer usable
7030
7031 =item Subroutine arguments created only when they're modified
7032
7033 =item Group vector changeable with C<$)>
7034
7035 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7036
7037 =item Fixed localization of $<digit>, $&, etc.
7038
7039 =item No resetting of $. on implicit close
7040
7041 =item C<wantarray> may return undef
7042
7043 =item C<eval EXPR> determines value of EXPR in scalar context
7044
7045 =item Changes to tainting checks
7046
7047 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7048 spawning if tainted $TERM doesn't look like a terminal name
7049
7050 =item New Opcode module and revised Safe module
7051
7052 =item Embedding improvements
7053
7054 =item Internal change: FileHandle class based on IO::* classes
7055
7056 =item Internal change: PerlIO abstraction interface
7057
7058 =item New and changed syntax
7059
7060 $coderef->(PARAMS)
7061
7062 =item New and changed builtin constants
7063
7064 __PACKAGE__
7065
7066 =item New and changed builtin variables
7067
7068 $^E, $^H, $^M
7069
7070 =item New and changed builtin functions
7071
7072 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7073 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7074 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7075 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7076 nested C<sub{}> closures work now, formats work right on changing lexicals
7077
7078 =item New builtin methods
7079
7080 isa(CLASS), can(METHOD), VERSION( [NEED] )
7081
7082 =item TIEHANDLE now supported
7083
7084 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7085 LIST, READLINE this, GETC this, DESTROY this
7086
7087 =item Malloc enhancements
7088
7089 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7090
7091 =item Miscellaneous efficiency enhancements
7092
7093 =back
7094
7095 =item Support for More Operating Systems
7096
7097 =over 4
7098
7099 =item Win32
7100
7101 =item Plan 9
7102
7103 =item QNX
7104
7105 =item AmigaOS
7106
7107 =back
7108
7109 =item Pragmata
7110
7111 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7112 constant NAME => VALUE, use locale, use ops, use vmsish
7113
7114 =item Modules
7115
7116 =over 4
7117
7118 =item Required Updates
7119
7120 =item Installation directories
7121
7122 =item Module information summary
7123
7124 =item Fcntl
7125
7126 =item IO
7127
7128 =item Math::Complex
7129
7130 =item Math::Trig
7131
7132 =item DB_File
7133
7134 =item Net::Ping
7135
7136 =item Object-oriented overrides for builtin operators
7137
7138 =back
7139
7140 =item Utility Changes
7141
7142 =over 4
7143
7144 =item pod2html
7145
7146 Sends converted HTML to standard output
7147
7148 =item xsubpp
7149
7150 C<void> XSUBs now default to returning nothing
7151
7152 =back
7153
7154 =item C Language API Changes
7155
7156 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7157 manipulating hashes
7158
7159 =item Documentation Changes
7160
7161 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7162 L<perlmodlib>, L<perldebug>, L<perlsec>
7163
7164 =item New Diagnostics
7165
7166 "my" variable %s masks earlier declaration in same scope, %s argument is
7167 not a HASH element or slice, Allocation too large: %lx, Allocation too
7168 large, Applying %s to %s will act on scalar(%s), Attempt to free
7169 nonexistent shared string, Attempt to use reference as lvalue in substr,
7170 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7171 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7172 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7173 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7174 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7175 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7176 %s, Integer overflow in hex number, Integer overflow in octal number,
7177 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7178 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7179 possible typo, Null picture in formline, Offset outside string, Out of
7180 memory!, Out of memory during request for %s, panic: frexp, Possible
7181 attempt to put comments in qw() list, Possible attempt to separate words
7182 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7183 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7184 option, untie attempted while %d inner references still exist, Unrecognized
7185 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7186 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7187 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7188 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7189 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7190 long, Process terminated by SIG%s
7191
7192 =item BUGS
7193
7194 =item SEE ALSO
7195
7196 =item HISTORY
7197
7198 =back
7199
7200 =head2 perlartistic -- the Perl Artistic License
7201
7202 =over 4
7203
7204 =item SYNOPSIS
7205
7206 =item DESCRIPTION
7207
7208 =item The "Artistic License"
7209
7210 =over 4
7211
7212 =item Preamble
7213
7214 =item Definitions
7215
7216 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7217 copying fee", "Freely Available"
7218
7219 =item Conditions
7220
7221 a), b), c), d), a), b), c), d)
7222
7223 =back
7224
7225 =back
7226
7227 =head2 perlgpl -- the GNU Public General Public License, version 2
7228
7229 =over 4
7230
7231 =item SYNOPSIS
7232
7233 =back
7234
7235 =over 4
7236
7237 =item DESCRIPTION
7238
7239 =item GNU GENERAL PUBLIC LICENSE
7240
7241 =back
7242
7243 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7244
7245 =over 4
7246
7247 =item DESCRIPTION
7248
7249 =over 4
7250
7251 =item Compiling Perl 5 on AIX
7252
7253 =item OS level
7254
7255 =item Building Dynamic Extensions on AIX
7256
7257 =item The IBM ANSI C Compiler
7258
7259 =item Using GNU's gcc for building perl
7260
7261 =item Using Large Files with Perl
7262
7263 =item Threaded Perl
7264
7265 =item 64-bit Perl
7266
7267 =item AIX 4.2 and extensions using C++ with statics
7268
7269 =back
7270
7271 =item AUTHOR
7272
7273 =item DATE
7274
7275 =back
7276
7277 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7278
7279 =over 4
7280
7281 =item DESCRIPTION
7282
7283 =item AUTHOR
7284
7285 =back
7286
7287 =head2 perlamiga - Perl under Amiga OS
7288
7289 =over 4
7290
7291 =item NOTE
7292
7293 =item SYNOPSIS
7294
7295 =back
7296
7297 =over 4
7298
7299 =item DESCRIPTION
7300
7301 =over 4
7302
7303 =item Prerequisites for Compiling Perl on AmigaOS
7304
7305 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7306
7307 =item Starting Perl programs under AmigaOS
7308
7309 =item Shortcomings of Perl under AmigaOS
7310
7311 =back
7312
7313 =item INSTALLATION
7314
7315 =item Accessing documentation
7316
7317 =over 4
7318
7319 =item Manpages for Perl on AmigaOS
7320
7321 =item Perl HTML Documentation on AmigaOS
7322
7323 =item Perl GNU Info Files on AmigaOS
7324
7325 =item Perl LaTeX Documentation on AmigaOS
7326
7327 =back
7328
7329 =item BUILDING PERL ON AMIGAOS
7330
7331 =over 4
7332
7333 =item Build Prerequisites for Perl on AmigaOS
7334
7335 =item Getting the Perl Source for AmigaOS
7336
7337 =item Making Perl on AmigaOS
7338
7339 =item Testing Perl on AmigaOS
7340
7341 =item Installing the built Perl on AmigaOS
7342
7343 =back
7344
7345 =item PERL 5.8.0 BROKEN IN AMIGAOS
7346
7347 =item AUTHORS
7348
7349 =item SEE ALSO
7350
7351 =back
7352
7353 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7354
7355 =over 4
7356
7357 =item DESCRIPTION
7358
7359 =over 4
7360
7361 =item General Issues with Perl on BeOS
7362
7363 =item BeOS Release-specific Notes
7364
7365 R4 x86, R4 PPC
7366
7367 =item Contact Information
7368
7369 =item Update 2002-05-30
7370
7371 =back
7372
7373 =back
7374
7375 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7376
7377 =over 4
7378
7379 =item SYNOPSIS
7380
7381 =item DESCRIPTION
7382
7383 =over 4
7384
7385 =item gzip on BS2000
7386
7387 =item bison on BS2000
7388
7389 =item Unpacking Perl Distribution on BS2000
7390
7391 =item Compiling Perl on BS2000
7392
7393 =item Testing Perl on BS2000
7394
7395 =item Installing Perl on BS2000
7396
7397 =item Using Perl in the Posix-Shell of BS2000
7398
7399 =item Using Perl in "native" BS2000
7400
7401 =item Floating point anomalies on BS2000
7402
7403 =back
7404
7405 =item AUTHORS
7406
7407 =item SEE ALSO
7408
7409 =over 4
7410
7411 =item Mailing list
7412
7413 =back
7414
7415 =item HISTORY
7416
7417 =back
7418
7419 =over 4
7420
7421 =item Name
7422
7423 =item Description
7424
7425 =item Build
7426
7427 =over 4
7428
7429 =item Tools & SDK
7430
7431 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7432 celib-sources, Rainer Keuchel's console-sources
7433
7434 =item Make
7435
7436 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run
7437   compile.bat dist
7438
7439 =back
7440
7441 =item Acknowledgements
7442
7443 =item AUTHORS
7444
7445 =back
7446
7447 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7448
7449 =over 4
7450
7451 =item SYNOPSIS
7452
7453 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7454
7455 =over 4
7456
7457 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7458
7459 =item Cygwin Configuration
7460
7461 C<PATH>, I<nroff>, Permissions
7462
7463 =back
7464
7465 =item CONFIGURE PERL ON CYGWIN
7466
7467 =over 4
7468
7469 =item Stripping Perl Binaries on Cygwin
7470
7471 =item Optional Libraries for Perl on Cygwin
7472
7473 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7474 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7475
7476 =item Configure-time Options for Perl on Cygwin
7477
7478 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7479 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7480 C<-Dmksymlinks>
7481
7482 =item Suspicious Warnings on Cygwin
7483
7484 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7485
7486 =back
7487
7488 =item MAKE ON CYGWIN
7489
7490 =over 4
7491
7492 =item Warnings on Cygwin
7493
7494 =item ld2 on Cygwin
7495
7496 =back
7497
7498 =item TEST ON CYGWIN
7499
7500 =over 4
7501
7502 =item File Permissions on Cygwin
7503
7504 =item NDBM_File and ODBM_File do not work on FAT filesystems
7505
7506 =item C<fork()> failures in io_* tests
7507
7508 =item Script Portability on Cygwin
7509
7510 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
7511
7512 =back
7513
7514 =item INSTALL PERL ON CYGWIN
7515
7516 =item MANIFEST ON CYGWIN
7517
7518 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7519 Source, Compiled Module Source, Perl Modules/Scripts
7520
7521 =item BUGS ON CYGWIN
7522
7523 =item AUTHORS
7524
7525 =item HISTORY
7526
7527 =back
7528
7529 =head2 perldgux - Perl under DG/UX.
7530
7531 =over 4
7532
7533 =item SYNOPSIS
7534
7535 =back
7536
7537 =over 4
7538
7539 =item DESCRIPTION
7540
7541 =item BUILDING PERL ON DG/UX
7542
7543 =over 4
7544
7545 =item Non-threaded Perl on DG/UX
7546
7547 =item Threaded Perl on DG/UX
7548
7549 =item Testing Perl on DG/UX
7550
7551 =item Installing the built perl on DG/UX
7552
7553 =back
7554
7555 =item AUTHOR
7556
7557 =item SEE ALSO
7558
7559 =back
7560
7561 =head2 perldos - Perl under DOS, W31, W95.
7562
7563 =over 4
7564
7565 =item SYNOPSIS
7566
7567 =item DESCRIPTION
7568
7569 =over 4
7570
7571 =item Prerequisites for Compiling Perl on DOS
7572
7573 DJGPP, Pthreads
7574
7575 =item Shortcomings of Perl under DOS
7576
7577 =item Building Perl on DOS
7578
7579 =item Testing Perl on DOS
7580
7581 =item Installation of Perl on DOS
7582
7583 =back
7584
7585 =item BUILDING AND INSTALLING MODULES ON DOS
7586
7587 =over 4
7588
7589 =item Building Prerequisites for Perl on DOS
7590
7591 =item Unpacking CPAN Modules on DOS
7592
7593 =item Building Non-XS Modules on DOS
7594
7595 =item Building XS Modules on DOS
7596
7597 =back
7598
7599 =item AUTHOR
7600
7601 =item SEE ALSO
7602
7603 =back
7604
7605 =head2 perlepoc, README.epoc - Perl for EPOC
7606
7607 =over 4
7608
7609 =item SYNOPSIS
7610
7611 =item INTRODUCTION
7612
7613 =item INSTALLING PERL ON EPOC
7614
7615 =item STARTING PERL ON EPOC
7616
7617 =over 4
7618
7619 =item Editors on Epoc
7620
7621 =item Features of Perl on Epoc
7622
7623 =item Restrictions of Perl on Epoc
7624
7625 =item Compiling Perl 5 on the EPOC cross compiling environment
7626
7627 =back
7628
7629 =item SUPPORT STATUS OF PERL ON EPOC
7630
7631 =item AUTHOR
7632
7633 =item LAST UPDATE
7634
7635 =back
7636
7637 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7638
7639 =over 4
7640
7641 =item DESCRIPTION
7642
7643 =over 4
7644
7645 =item FreeBSD core dumps from readdir_r with ithreads
7646
7647 =item $^X doesn't always contain a full path in FreeBSD
7648
7649 =item Perl will no longer be part of "base FreeBSD"
7650
7651 =back
7652
7653 =item AUTHOR
7654
7655 =back
7656
7657 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7658 (HP-UX) systems
7659
7660 =over 4
7661
7662 =item DESCRIPTION
7663
7664 =over 4
7665
7666 =item Using perl as shipped with HP-UX
7667
7668 =item Using perl from HP's porting centre
7669
7670 =item Compiling Perl 5 on HP-UX
7671
7672 =item PA-RISC
7673
7674 =item PA-RISC 1.0
7675
7676 =item PA-RISC 1.1
7677
7678 =item PA-RISC 2.0
7679
7680 =item Itanium
7681
7682 =item Portability Between PA-RISC Versions
7683
7684 =item Itanium Processor Family and HP-UX
7685
7686 =item Building Dynamic Extensions on HP-UX
7687
7688 =item The HP ANSI C Compiler
7689
7690 =item The GNU C Compiler
7691
7692 =item Using Large Files with Perl on HP-UX
7693
7694 =item Threaded Perl on HP-UX
7695
7696 =item 64-bit Perl on HP-UX
7697
7698 =item Oracle on HP-UX
7699
7700 =item GDBM and Threads on HP-UX
7701
7702 =item NFS filesystems and utime(2) on HP-UX
7703
7704 =item perl -P and // and HP-UX
7705
7706 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7707
7708 =back
7709
7710 =item nss_delete core dump from op/pwent or op/grent
7711
7712 =item AUTHOR
7713
7714 =item DATE
7715
7716 =back
7717
7718 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7719
7720 =over 4
7721
7722 =item DESCRIPTION
7723
7724 =over 4
7725
7726 =item Known Problems with Perl on Hurd
7727
7728 =back
7729
7730 =item AUTHOR
7731
7732 =back
7733
7734 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7735
7736 =over 4
7737
7738 =item DESCRIPTION
7739
7740 =over 4
7741
7742 =item Building 32-bit Perl in Irix
7743
7744 =item Building 64-bit Perl in Irix
7745
7746 =item About Compiler Versions of Irix
7747
7748 =item Linker Problems in Irix
7749
7750 =item Malloc in Irix
7751
7752 =item Building with threads in Irix
7753
7754 =item Irix 5.3
7755
7756 =back
7757
7758 =item AUTHOR
7759
7760 =back
7761
7762 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7763 systems
7764
7765 =over 4
7766
7767 =item DESCRIPTION
7768
7769 =over 4
7770
7771 =item Compiling Perl 5 on MachTen
7772
7773 =item Failures during C<make test> on MachTen
7774
7775 op/lexassign.t, pragma/warnings.t
7776
7777 =item Building external modules on MachTen
7778
7779 =back
7780
7781 =item AUTHOR
7782
7783 =item DATE
7784
7785 =back
7786
7787 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7788
7789 =over 4
7790
7791 =item SYNOPSIS
7792
7793 =item DESCRIPTION
7794
7795 =item AUTHOR
7796
7797 =item DATE
7798
7799 =back
7800
7801 =head2 perlmacosx, README.macosx - Perl under Mac OS X
7802
7803 =over 4
7804
7805 =item SYNOPSIS
7806
7807 =item DESCRIPTION
7808
7809 =item INSTALLATION PREFIX
7810
7811 =item LIBPERL AND PREBINDING
7812
7813 =item UPDATING PANTHER
7814
7815 =item MACPERL
7816
7817 =item CARBON
7818
7819 =item COCOA
7820
7821 =item AUTHOR
7822
7823 =item DATE
7824
7825 =back
7826
7827 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7828
7829 =over 4
7830
7831 =item DESCRIPTION
7832
7833 =item Known problems with Perl on MiNT
7834
7835 =item AUTHOR
7836
7837 =back
7838
7839 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7840
7841 =over 4
7842
7843 =item SYNOPSIS
7844
7845 =item NOTE
7846
7847 =item Binary distribution from HP
7848
7849 =item What's New in Perl for MPE/iX
7850
7851 =item Welcome to Perl/iX
7852
7853 =item System Requirements for Perl/iX
7854
7855 =item How to Obtain Perl/iX
7856
7857 =item Perl/iX Distribution Contents Highlights
7858
7859 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7860 public_html/feedback.cgi, src/perl-5.6.0-mpe
7861
7862 =item How to Compile Perl/iX
7863
7864  4,  6
7865
7866 =item Getting Started with Perl/iX
7867
7868 =item MPE/iX Implementation Considerations
7869
7870 =item Known Perl/iX Bugs Under Investigation
7871
7872 =item Perl/iX To-Do List
7873
7874 =item Perl/iX Change History
7875
7876 =item AUTHOR
7877
7878 =item Name
7879
7880 =item Description
7881
7882 =item Build
7883
7884 =over 4
7885
7886 =item Tools & SDK
7887
7888 =item Setup
7889
7890 SetNWBld.bat, Buildtype.bat
7891
7892 =item Make
7893
7894 =item Interpreter
7895
7896 =item Extensions
7897
7898 =back
7899
7900 =item Install
7901
7902 =item Build new extensions
7903
7904 =item Acknowledgements
7905
7906 =item Authors
7907
7908 =item Date
7909
7910 =back
7911
7912 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7913
7914 =over 4
7915
7916 =item SYNOPSIS
7917
7918 =back
7919
7920 =over 4
7921
7922 =item DESCRIPTION
7923
7924 =over 4
7925
7926 =item Target
7927
7928 =item Other OSes
7929
7930 =item Prerequisites
7931
7932 EMX, RSX, HPFS, pdksh
7933
7934 =item Starting Perl programs under OS/2 (and DOS and...)
7935
7936 =item Starting OS/2 (and DOS) programs under Perl
7937
7938 =back
7939
7940 =item Frequently asked questions
7941
7942 =over 4
7943
7944 =item "It does not work"
7945
7946 =item I cannot run external programs
7947
7948 =item I cannot embed perl into my program, or use F<perl.dll> from my
7949 program.
7950
7951 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7952 L<ExtUtils::Embed>?
7953
7954 =item C<``> and pipe-C<open> do not work under DOS.
7955
7956 =item Cannot start C<find.exe "pattern" file>
7957
7958 =back
7959
7960 =item INSTALLATION
7961
7962 =over 4
7963
7964 =item Automatic binary installation
7965
7966 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7967
7968 =item Manual binary installation
7969
7970 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7971 (statically linked), Executables for Perl utilities, Main Perl library,
7972 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7973 and utilities, Manpages for Perl modules, Source for Perl documentation,
7974 Perl manual in F<.INF> format, Pdksh
7975
7976 =item B<Warning>
7977
7978 =back
7979
7980 =item Accessing documentation
7981
7982 =over 4
7983
7984 =item OS/2 F<.INF> file
7985
7986 =item Plain text
7987
7988 =item Manpages
7989
7990 =item HTML
7991
7992 =item GNU C<info> files
7993
7994 =item F<PDF> files
7995
7996 =item C<LaTeX> docs
7997
7998 =back
7999
8000 =item BUILD
8001
8002 =over 4
8003
8004 =item The short story
8005
8006 =item Prerequisites
8007
8008 =item Getting perl source
8009
8010 =item Application of the patches
8011
8012 =item Hand-editing
8013
8014 =item Making
8015
8016 =item Testing
8017
8018 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8019 F<op/stat.t>
8020
8021 =item Installing the built perl
8022
8023 =item C<a.out>-style build
8024
8025 =back
8026
8027 =item Build FAQ
8028
8029 =over 4
8030
8031 =item Some C</> became C<\> in pdksh.
8032
8033 =item C<'errno'> - unresolved external
8034
8035 =item Problems with tr or sed
8036
8037 =item Some problem (forget which ;-)
8038
8039 =item Library ... not found
8040
8041 =item Segfault in make
8042
8043 =item op/sprintf test failure
8044
8045 =back
8046
8047 =item Specific (mis)features of OS/2 port
8048
8049 =over 4
8050
8051 =item C<setpriority>, C<getpriority>
8052
8053 =item C<system()>
8054
8055 =item C<extproc> on the first line
8056
8057 =item Additional modules:
8058
8059 =item Prebuilt methods:
8060
8061 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8062  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
8063 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
8064 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
8065 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
8066 C<Cwd::extLibpath_set( path [, type ] )>,
8067 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8068 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8069 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8070 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8071 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8072 C<OS2::DLLname([how [, \&xsub]])>
8073
8074 =item Prebuilt variables:
8075
8076 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8077 $OS2::nsyserror
8078
8079 =item Misfeatures
8080
8081 =item Modifications
8082
8083 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8084 C<flock>
8085
8086 =item Identifying DLLs
8087
8088 =item Centralized management of resources
8089
8090 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8091 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8092 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8093 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8094
8095 =back
8096
8097 =item Perl flavors
8098
8099 =over 4
8100
8101 =item F<perl.exe>
8102
8103 =item F<perl_.exe>
8104
8105 =item F<perl__.exe>
8106
8107 =item F<perl___.exe>
8108
8109 =item Why strange names?
8110
8111 =item Why dynamic linking?
8112
8113 =item Why chimera build?
8114
8115 =back
8116
8117 =item ENVIRONMENT
8118
8119 =over 4
8120
8121 =item C<PERLLIB_PREFIX>
8122
8123 =item C<PERL_BADLANG>
8124
8125 =item C<PERL_BADFREE>
8126
8127 =item C<PERL_SH_DIR>
8128
8129 =item C<USE_PERL_FLOCK>
8130
8131 =item C<TMP> or C<TEMP>
8132
8133 =back
8134
8135 =item Evolution
8136
8137 =over 4
8138
8139 =item Text-mode filehandles
8140
8141 =item Priorities
8142
8143 =item DLL name mangling: pre 5.6.2
8144
8145 =item DLL name mangling: 5.6.2 and beyond
8146
8147 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8148 C<LIBPATH>
8149
8150 =item DLL forwarder generation
8151
8152 =item Threading
8153
8154 =item Calls to external programs
8155
8156 =item Memory allocation
8157
8158 =item Threads
8159
8160 C<COND_WAIT>, F<os2.c>
8161
8162 =back
8163
8164 =item BUGS
8165
8166 =back
8167
8168 =over 4
8169
8170 =item AUTHOR
8171
8172 =item SEE ALSO
8173
8174 =back
8175
8176 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8177 and z/OS
8178
8179 =over 4
8180
8181 =item SYNOPSIS
8182
8183 =item DESCRIPTION
8184
8185 =over 4
8186
8187 =item Tools
8188
8189 =item Unpacking Perl distribution on OS/390
8190
8191 =item Setup and utilities for Perl on OS/390
8192
8193 =item Configure Perl on OS/390
8194
8195 =item Build, Test, Install Perl on OS/390
8196
8197 =item Build Anomalies with Perl on OS/390
8198
8199 =item Testing Anomalies with Perl on OS/390
8200
8201 =item Installation Anomalies with Perl on OS/390
8202
8203 =item Usage Hints for Perl on OS/390
8204
8205 =item Floating Point Anomalies with Perl on OS/390
8206
8207 =item Modules and Extensions for Perl on OS/390
8208
8209 =back
8210
8211 =item AUTHORS
8212
8213 =item SEE ALSO
8214
8215 =over 4
8216
8217 =item Mailing list for Perl on OS/390
8218
8219 =back
8220
8221 =item HISTORY
8222
8223 =back
8224
8225 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8226
8227 =over 4
8228
8229 =item DESCRIPTION
8230
8231 =over 4
8232
8233 =item Compiling Perl for OS/400 PASE
8234
8235 =item Installing Perl in OS/400 PASE
8236
8237 =item Using Perl in OS/400 PASE
8238
8239 =item Known Problems
8240
8241 =item Perl on ILE
8242
8243 =back
8244
8245 =item AUTHORS
8246
8247 =back
8248
8249 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8250
8251 =over 4
8252
8253 =item DESCRIPTION
8254
8255 =over 4
8256
8257 =item Required Software for Compiling Perl on QNX4
8258
8259 /bin/sh, ar, nm, cpp, make
8260
8261 =item Outstanding Issues with Perl on QNX4
8262
8263 =item QNX auxiliary files
8264
8265 qnx/ar, qnx/cpp
8266
8267 =item Outstanding issues with perl under QNX6
8268
8269 =back
8270
8271 =item AUTHOR
8272
8273 =back
8274
8275 =head2 perlplan9 - Plan 9-specific documentation for Perl
8276
8277 =over 4
8278
8279 =item DESCRIPTION
8280
8281 =over 4
8282
8283 =item Invoking Perl
8284
8285 =item What's in Plan 9 Perl
8286
8287 =item What's not in Plan 9 Perl
8288
8289 =item Perl5 Functions not currently supported in Plan 9 Perl
8290
8291 =item Signals in Plan 9 Perl
8292
8293 =back
8294
8295 =item COMPILING AND INSTALLING PERL ON PLAN 9
8296
8297 =over 4
8298
8299 =item Installing Perl Documentation on Plan 9
8300
8301 =back
8302
8303 =item BUGS
8304
8305 =item Revision date
8306
8307 =item AUTHOR
8308
8309 =back
8310
8311 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8312
8313 =over 4
8314
8315 =item DESCRIPTION
8316
8317 =over 4
8318
8319 =item Solaris Version Numbers.
8320
8321 =back
8322
8323 =item RESOURCES
8324
8325 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8326
8327 =item SETTING UP
8328
8329 =over 4
8330
8331 =item File Extraction Problems on Solaris.
8332
8333 =item Compiler and Related Tools on Solaris.
8334
8335 =item Environment for Compiling perl on Solaris
8336
8337 =back
8338
8339 =item RUN CONFIGURE.
8340
8341 =over 4
8342
8343 =item 64-bit perl on Solaris.
8344
8345 =item Threads in perl on Solaris.
8346
8347 =item Malloc Issues with perl on Solaris.
8348
8349 =back
8350
8351 =item MAKE PROBLEMS.
8352
8353 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8354 relocation error:, dlopen: stub interception failed, #error "No
8355 DATAMODEL_NATIVE specified", sh: ar: not found
8356
8357 =item MAKE TEST
8358
8359 =over 4
8360
8361 =item op/stat.t test 4 in Solaris
8362
8363 =item nss_delete core dump from op/pwent or op/grent
8364
8365 =back
8366
8367 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8368
8369 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8370
8371 =over 4
8372
8373 =item Limits on Numbers of Open Files on Solaris.
8374
8375 =back
8376
8377 =item SOLARIS-SPECIFIC MODULES.
8378
8379 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8380
8381 =over 4
8382
8383 =item Proc::ProcessTable on Solaris
8384
8385 =item BSD::Resource on Solaris
8386
8387 =item Net::SSLeay on Solaris
8388
8389 =back
8390
8391 =item AUTHOR
8392
8393 =item LAST MODIFIED
8394
8395 =back
8396
8397 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8398 Digital UNIX formerly known as DEC OSF/1) systems
8399
8400 =over 4
8401
8402 =item DESCRIPTION
8403
8404 =over 4
8405
8406 =item Compiling Perl 5 on Tru64
8407
8408 =item Using Large Files with Perl on Tru64
8409
8410 =item Threaded Perl on Tru64
8411
8412 =item Long Doubles on Tru64
8413
8414 =item DB_File tests failing on Tru64
8415
8416 =item 64-bit Perl on Tru64
8417
8418 =item Warnings about floating-point overflow when compiling Perl on Tru64
8419
8420 =back
8421
8422 =item Testing Perl on Tru64
8423
8424 =item ext/ODBM_File/odbm Test Failing With Static Builds
8425
8426 =item Perl Fails Because Of Unresolved Symbol sockatmark
8427
8428 =item AUTHOR
8429
8430 =back
8431
8432 =head2 perluts - Perl under UTS
8433
8434 =over 4
8435
8436 =item SYNOPSIS
8437
8438 =item DESCRIPTION
8439
8440 =item BUILDING PERL ON UTS
8441
8442 =item Installing the built perl on UTS
8443
8444 =item AUTHOR
8445
8446 =back
8447
8448 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8449
8450 =over 4
8451
8452 =item SYNOPSIS
8453
8454 =item DESCRIPTION
8455
8456 =over 4
8457
8458 =item Unpacking Perl Distribution on VM/ESA
8459
8460 =item Setup Perl and utilities on VM/ESA
8461
8462 =item Configure Perl on VM/ESA
8463
8464 =item Testing Anomalies of Perl on VM/ESA
8465
8466 =item Usage Hints for Perl on VM/ESA
8467
8468 =back
8469
8470 =item AUTHORS
8471
8472 =item SEE ALSO
8473
8474 =over 4
8475
8476 =item Mailing list for Perl on VM/ESA
8477
8478 =back
8479
8480 =back
8481
8482 =head2 perlvms - VMS-specific documentation for Perl
8483
8484 =over 4
8485
8486 =item DESCRIPTION
8487
8488 =item Installation
8489
8490 =item Organization of Perl Images
8491
8492 =over 4
8493
8494 =item Core Images
8495
8496 =item Perl Extensions
8497
8498 =item Installing static extensions
8499
8500 =item Installing dynamic extensions
8501
8502 =back
8503
8504 =item File specifications
8505
8506 =over 4
8507
8508 =item Syntax
8509
8510 =item Wildcard expansion
8511
8512 =item Pipes
8513
8514 =back
8515
8516 =item PERL5LIB and PERLLIB
8517
8518 =item Command line
8519
8520 =over 4
8521
8522 =item I/O redirection and backgrounding
8523
8524 =item Command line switches
8525
8526 -i, -S, -u
8527
8528 =back
8529
8530 =item Perl functions
8531
8532 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8533 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8534 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8535 LIST, waitpid PID,FLAGS
8536
8537 =item Perl variables
8538
8539 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8540
8541 =item Standard modules with VMS-specific differences
8542
8543 =over 4
8544
8545 =item SDBM_File
8546
8547 =back
8548
8549 =item Revision date
8550
8551 =item AUTHOR
8552
8553 =back
8554
8555 =head2 perlvos, README.vos - Perl for Stratus VOS
8556
8557 =over 4
8558
8559 =item SYNOPSIS
8560
8561 =item BUILDING PERL FOR VOS
8562
8563 =item INSTALLING PERL IN VOS
8564
8565 =item USING PERL IN VOS
8566
8567 =over 4
8568
8569 =item Restrictions of Perl on VOS
8570
8571 =item Handling of underflow and overflow
8572
8573 =back
8574
8575 =item TEST STATUS
8576
8577 =item SUPPORT STATUS
8578
8579 =item AUTHOR
8580
8581 =item LAST UPDATE
8582
8583 =back
8584
8585 =head2 perlwin32 - Perl under Windows
8586
8587 =over 4
8588
8589 =item SYNOPSIS
8590
8591 =item DESCRIPTION
8592
8593 =over 4
8594
8595 =item Setting Up Perl on Win32
8596
8597 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8598 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
8599
8600 =item Building
8601
8602 =item Testing Perl on Win32
8603
8604 =item Installation of Perl on Win32
8605
8606 =item Usage Hints for Perl on Win32
8607
8608 Environment Variables, File Globbing, Using perl from the command line,
8609 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8610 Extensions, Notes on 64-bit Windows
8611
8612 =item Running Perl Scripts
8613
8614 Miscellaneous Things
8615
8616 =back
8617
8618 =item BUGS AND CAVEATS
8619
8620 =item AUTHORS
8621
8622 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8623 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8624 E<lt>nick@ing-simmons.netE<gt>
8625
8626 =item SEE ALSO
8627
8628 =item HISTORY
8629
8630 =back
8631
8632 =head1 PRAGMA DOCUMENTATION
8633
8634 =head2 attrs - set/get attributes of a subroutine (deprecated)
8635
8636 =over 4
8637
8638 =item SYNOPSIS
8639
8640 =item DESCRIPTION
8641
8642 method, locked
8643
8644 =back
8645
8646 =head2 re - Perl pragma to alter regular expression behaviour
8647
8648 =over 4
8649
8650 =item SYNOPSIS
8651
8652 =item DESCRIPTION
8653
8654 =back
8655
8656 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8657 data structures between threads
8658
8659 =over 4
8660
8661 =item SYNOPSIS
8662
8663 =item DESCRIPTION
8664
8665 =item EXPORT
8666
8667 =item FUNCTIONS
8668
8669 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8670 cond_broadcast VARIABLE
8671
8672 =item NOTES
8673
8674 =item BUGS
8675
8676 =item AUTHOR
8677
8678 =item SEE ALSO
8679
8680 =back
8681
8682 =head2 threads - Perl extension allowing use of interpreter based threads
8683 from perl
8684
8685 =over 4
8686
8687 =item SYNOPSIS
8688
8689 =item DESCRIPTION
8690
8691 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8692 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8693 threads->list();, async BLOCK;
8694
8695 =item WARNINGS
8696
8697 A thread exited while %d other threads were still running
8698
8699 =item TODO
8700
8701 =item BUGS
8702
8703 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8704 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8705
8706 =item AUTHOR and COPYRIGHT
8707
8708 =item SEE ALSO
8709
8710 =back
8711
8712 =head2 assertions - select assertions in blocks of code
8713
8714 =over 4
8715
8716 =item SYNOPSIS
8717
8718 =item DESCRIPTION
8719
8720 =item SEE ALSO
8721
8722 =item AUTHOR
8723
8724 =item COPYRIGHT AND LICENSE
8725
8726 =back
8727
8728 =head2 assertions::activate - activate assertions
8729
8730 =over 4
8731
8732 =item SYNOPSIS
8733
8734 =item DESCRIPTION
8735
8736 =item SEE ALSO
8737
8738 =item AUTHOR
8739
8740 =item COPYRIGHT AND LICENSE
8741
8742 =back
8743
8744 =head2 attributes - get/set subroutine or variable attributes
8745
8746 =over 4
8747
8748 =item SYNOPSIS
8749
8750 =item DESCRIPTION
8751
8752 =over 4
8753
8754 =item Built-in Attributes
8755
8756 locked, method, lvalue
8757
8758 =item Available Subroutines
8759
8760 get, reftype
8761
8762 =item Package-specific Attribute Handling
8763
8764 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8765
8766 =item Syntax of Attribute Lists
8767
8768 =back
8769
8770 =item EXPORTS
8771
8772 =over 4
8773
8774 =item Default exports
8775
8776 =item Available exports
8777
8778 =item Export tags defined
8779
8780 =back
8781
8782 =item EXAMPLES
8783
8784 =item SEE ALSO
8785
8786 =back
8787
8788 =head2 attrs - set/get attributes of a subroutine (deprecated)
8789
8790 =over 4
8791
8792 =item SYNOPSIS
8793
8794 =item DESCRIPTION
8795
8796 method, locked
8797
8798 =back
8799
8800 =head2 autouse - postpone load of modules until a function is used
8801
8802 =over 4
8803
8804 =item SYNOPSIS
8805
8806 =item DESCRIPTION
8807
8808 =item WARNING
8809
8810 =item AUTHOR
8811
8812 =item SEE ALSO
8813
8814 =back
8815
8816 =head2 base - Establish IS-A relationship with base class at compile time
8817
8818 =over 4
8819
8820 =item SYNOPSIS
8821
8822 =item DESCRIPTION
8823
8824 =item HISTORY
8825
8826 =item SEE ALSO
8827
8828 =back
8829
8830 =head2 bigint - Transparent BigInteger support for Perl
8831
8832 =over 4
8833
8834 =item SYNOPSIS
8835
8836 =item DESCRIPTION
8837
8838 =over 4
8839
8840 =item OPTIONS
8841
8842 a or accuracy, p or precision, t or trace, l or lib, v or version
8843
8844 =item MATH LIBRARY
8845
8846 =item INTERNAL FORMAT
8847
8848 =item SIGN
8849
8850 =item METHODS
8851
8852 =item CAVEAT
8853
8854 =back
8855
8856 =item MODULES USED
8857
8858 =item EXAMPLES
8859
8860 =item LICENSE
8861
8862 =item SEE ALSO
8863
8864 =item AUTHORS
8865
8866 =back
8867
8868 =head2 bignum - Transparent BigNumber support for Perl
8869
8870 =over 4
8871
8872 =item SYNOPSIS
8873
8874 =item DESCRIPTION
8875
8876 =over 4
8877
8878 =item OPTIONS
8879
8880 a or accuracy, p or precision, t or trace, l or lib, v or version
8881
8882 =item METHODS
8883
8884 =item CAVEAT
8885
8886 inf(), NaN(), upgrade()
8887
8888 =item MATH LIBRARY
8889
8890 =item INTERNAL FORMAT
8891
8892 =item SIGN
8893
8894 =back
8895
8896 =item MODULES USED
8897
8898 =item EXAMPLES
8899
8900 =item LICENSE
8901
8902 =item SEE ALSO
8903
8904 =item AUTHORS
8905
8906 =back
8907
8908 =head2 bigrat - Transparent BigNumber/BigRationale support for Perl
8909
8910 =over 4
8911
8912 =item SYNOPSIS
8913
8914 =item DESCRIPTION
8915
8916 =over 4
8917
8918 =item MODULES USED
8919
8920 =item MATH LIBRARY
8921
8922 =item SIGN
8923
8924 =item METHODS
8925
8926 =item CAVEAT
8927
8928 =back
8929
8930 =item EXAMPLES
8931
8932         perl -Mbigrat -le 'print sqrt(33)'
8933         perl -Mbigrat -le 'print 2*255'
8934         perl -Mbigrat -le 'print 4.5+2*255'
8935         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8936         perl -Mbigrat -le 'print 12->is_odd()';
8937
8938 =item LICENSE
8939
8940 =item SEE ALSO
8941
8942 =item AUTHORS
8943
8944 =back
8945
8946 =head2 blib - Use MakeMaker's uninstalled version of a package
8947
8948 =over 4
8949
8950 =item SYNOPSIS
8951
8952 =item DESCRIPTION
8953
8954 =item BUGS
8955
8956 =item AUTHOR
8957
8958 =back
8959
8960 =head2 bytes - Perl pragma to force byte semantics rather than character
8961 semantics
8962
8963 =over 4
8964
8965 =item SYNOPSIS
8966
8967 =item DESCRIPTION
8968
8969 =item SEE ALSO
8970
8971 =back
8972
8973 =head2 charnames - define character names for C<\N{named}> string literal
8974 escapes
8975
8976 =over 4
8977
8978 =item SYNOPSIS
8979
8980 =item DESCRIPTION
8981
8982 =item CUSTOM TRANSLATORS
8983
8984 =item CUSTOM ALIASES
8985
8986 =over 4
8987
8988 =item Anonymous hashes
8989
8990 =item Alias file
8991
8992 =item Alias shortcut
8993
8994 =back
8995
8996 =item charnames::viacode(code)
8997
8998 =item charnames::vianame(name)
8999
9000 =item ALIASES
9001
9002 =item ILLEGAL CHARACTERS
9003
9004 =item BUGS
9005
9006 =back
9007
9008 =head2 constant - Perl pragma to declare constants
9009
9010 =over 4
9011
9012 =item SYNOPSIS
9013
9014 =item DESCRIPTION
9015
9016 =item NOTES
9017
9018 =over 4
9019
9020 =item List constants
9021
9022 =item Defining multiple constants at once
9023
9024 =item Magic constants
9025
9026 =back
9027
9028 =item TECHNICAL NOTES
9029
9030 =item BUGS
9031
9032 =item AUTHOR
9033
9034 =item COPYRIGHT
9035
9036 =back
9037
9038 =head2 diagnostics - Perl compiler pragma to force verbose warning
9039 diagnostics
9040
9041 =over 4
9042
9043 =item SYNOPSIS
9044
9045 =item DESCRIPTION
9046
9047 =over 4
9048
9049 =item The C<diagnostics> Pragma
9050
9051 =item The I<splain> Program
9052
9053 =back
9054
9055 =item EXAMPLES
9056
9057 =item INTERNALS
9058
9059 =item BUGS
9060
9061 =item AUTHOR
9062
9063 =back
9064
9065 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9066
9067 =over 4
9068
9069 =item SYNOPSIS
9070
9071 =item ABSTRACT
9072
9073 =over 4
9074
9075 =item Literal Conversions
9076
9077 =item PerlIO layers for C<STD(IN|OUT)>
9078
9079 =back
9080
9081 =item FEATURES THAT REQUIRE 5.8.1
9082
9083 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9084
9085 =item USAGE
9086
9087 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9088 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9089
9090 =item The Filter Option
9091
9092 =over 4
9093
9094 =item Filter-related changes at Encode version 1.87
9095
9096 =back
9097
9098 =item CAVEATS
9099
9100 =over 4
9101
9102 =item NOT SCOPED
9103
9104 =item DO NOT MIX MULTIPLE ENCODINGS
9105
9106 =item tr/// with ranges
9107
9108 Legend of characters above
9109
9110 =back
9111
9112 =item EXAMPLE - Greekperl
9113
9114 =item KNOWN PROBLEMS
9115
9116 literals in regex that are longer than 127 bytes, EBCDIC, format
9117
9118 =item HISTORY
9119
9120 =item SEE ALSO
9121
9122 =back
9123
9124 =head2 fields - compile-time class fields
9125
9126 =over 4
9127
9128 =item SYNOPSIS
9129
9130 =item DESCRIPTION
9131
9132 new, phash
9133
9134 =item SEE ALSO
9135
9136 =back
9137
9138 =head2 filetest - Perl pragma to control the filetest permission operators
9139
9140 =over 4
9141
9142 =item SYNOPSIS
9143
9144 =item DESCRIPTION
9145
9146 =over 4
9147
9148 =item subpragma access
9149
9150 =back
9151
9152 =back
9153
9154 =head2 if - C<use> a Perl module if a condition holds
9155
9156 =over 4
9157
9158 =item SYNOPSIS
9159
9160 =item DESCRIPTION
9161
9162 =item BUGS
9163
9164 =item AUTHOR
9165
9166 =back
9167
9168 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9169 point
9170
9171 =over 4
9172
9173 =item SYNOPSIS
9174
9175 =item DESCRIPTION
9176
9177 =back
9178
9179 =head2 less - perl pragma to request less of something from the compiler
9180
9181 =over 4
9182
9183 =item SYNOPSIS
9184
9185 =item DESCRIPTION
9186
9187 =back
9188
9189 =head2 lib - manipulate @INC at compile time
9190
9191 =over 4
9192
9193 =item SYNOPSIS
9194
9195 =item DESCRIPTION
9196
9197 =over 4
9198
9199 =item Adding directories to @INC
9200
9201 =item Deleting directories from @INC
9202
9203 =item Restoring original @INC
9204
9205 =back
9206
9207 =item CAVEATS
9208
9209 =item NOTES
9210
9211 =item SEE ALSO
9212
9213 =item AUTHOR
9214
9215 =back
9216
9217 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9218 operations
9219
9220 =over 4
9221
9222 =item SYNOPSIS
9223
9224 =item DESCRIPTION
9225
9226 =back
9227
9228 =head2 open - perl pragma to set default PerlIO layers for input and output
9229
9230 =over 4
9231
9232 =item SYNOPSIS
9233
9234 =item DESCRIPTION
9235
9236 =item NONPERLIO FUNCTIONALITY
9237
9238 =item IMPLEMENTATION DETAILS
9239
9240 =item SEE ALSO
9241
9242 =back
9243
9244 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9245
9246 =over 4
9247
9248 =item SYNOPSIS
9249
9250 =item DESCRIPTION
9251
9252 =item SEE ALSO
9253
9254 =back
9255
9256 =head2 overload - Package for overloading perl operations
9257
9258 =over 4
9259
9260 =item SYNOPSIS
9261
9262 =item DESCRIPTION
9263
9264 =over 4
9265
9266 =item Declaration of overloaded functions
9267
9268 =item Calling Conventions for Binary Operations
9269
9270 FALSE, TRUE, C<undef>
9271
9272 =item Calling Conventions for Unary Operations
9273
9274 =item Calling Conventions for Mutators
9275
9276 C<++> and C<-->, C<x=> and other assignment versions
9277
9278 =item Overloadable Operations
9279
9280 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9281 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9282 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9283
9284 =item Inheritance and overloading
9285
9286 Strings as values of C<use overload> directive, Overloading of an operation
9287 is inherited by derived classes
9288
9289 =back
9290
9291 =item SPECIAL SYMBOLS FOR C<use overload>
9292
9293 =over 4
9294
9295 =item Last Resort
9296
9297 =item Fallback
9298
9299 C<undef>, TRUE, defined, but FALSE
9300
9301 =item Copy Constructor
9302
9303 B<Example>
9304
9305 =back
9306
9307 =item MAGIC AUTOGENERATION
9308
9309 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9310 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9311 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9312 I<Copy operator>
9313
9314 =item Losing overloading
9315
9316 =item Run-time Overloading
9317
9318 =item Public functions
9319
9320 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9321
9322 =item Overloading constants
9323
9324 integer, float, binary, q, qr
9325
9326 =item IMPLEMENTATION
9327
9328 =item Metaphor clash
9329
9330 =item Cookbook
9331
9332 =over 4
9333
9334 =item Two-face scalars
9335
9336 =item Two-face references
9337
9338 =item Symbolic calculator
9339
9340 =item I<Really> symbolic calculator
9341
9342 =back
9343
9344 =item AUTHOR
9345
9346 =item DIAGNOSTICS
9347
9348 Odd number of arguments for overload::constant, `%s' is not an overloadable
9349 type, `%s' is not a code reference
9350
9351 =item BUGS
9352
9353 =back
9354
9355 =head2 re - Perl pragma to alter regular expression behaviour
9356
9357 =over 4
9358
9359 =item SYNOPSIS
9360
9361 =item DESCRIPTION
9362
9363 =back
9364
9365 =head2 sigtrap - Perl pragma to enable simple signal handling
9366
9367 =over 4
9368
9369 =item SYNOPSIS
9370
9371 =item DESCRIPTION
9372
9373 =item OPTIONS
9374
9375 =over 4
9376
9377 =item SIGNAL HANDLERS
9378
9379 B<stack-trace>, B<die>, B<handler> I<your-handler>
9380
9381 =item SIGNAL LISTS
9382
9383 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9384
9385 =item OTHER
9386
9387 B<untrapped>, B<any>, I<signal>, I<number>
9388
9389 =back
9390
9391 =item EXAMPLES
9392
9393 =back
9394
9395 =head2 sort - perl pragma to control sort() behaviour
9396
9397 =over 4
9398
9399 =item SYNOPSIS
9400
9401 =item DESCRIPTION
9402
9403 =item CAVEATS
9404
9405 =back
9406
9407 =head2 strict - Perl pragma to restrict unsafe constructs
9408
9409 =over 4
9410
9411 =item SYNOPSIS
9412
9413 =item DESCRIPTION
9414
9415 C<strict refs>, C<strict vars>, C<strict subs>
9416
9417 =item HISTORY
9418
9419 =back
9420
9421 =head2 subs - Perl pragma to predeclare sub names
9422
9423 =over 4
9424
9425 =item SYNOPSIS
9426
9427 =item DESCRIPTION
9428
9429 =back
9430
9431 =head2 threads - Perl extension allowing use of interpreter based threads
9432 from perl
9433
9434 =over 4
9435
9436 =item SYNOPSIS
9437
9438 =item DESCRIPTION
9439
9440 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9441 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9442 threads->list();, async BLOCK;
9443
9444 =item WARNINGS
9445
9446 A thread exited while %d other threads were still running
9447
9448 =item TODO
9449
9450 =item BUGS
9451
9452 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9453 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9454
9455 =item AUTHOR and COPYRIGHT
9456
9457 =item SEE ALSO
9458
9459 =back
9460
9461 =head2 threadshared, threads::shared - Perl extension for sharing data
9462 structures between threads
9463
9464 =over 4
9465
9466 =item SYNOPSIS
9467
9468 =item DESCRIPTION
9469
9470 =item EXPORT
9471
9472 =item FUNCTIONS
9473
9474 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9475 cond_broadcast VARIABLE
9476
9477 =item NOTES
9478
9479 =item BUGS
9480
9481 =item AUTHOR
9482
9483 =item SEE ALSO
9484
9485 =back
9486
9487 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9488 code
9489
9490 =over 4
9491
9492 =item SYNOPSIS
9493
9494 =item DESCRIPTION
9495
9496 =over 4
9497
9498 =item Utility functions
9499
9500 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9501 utf8::encode($string), $flag = utf8::decode($string), $flag =
9502 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
9503
9504 =back
9505
9506 =item BUGS
9507
9508 =item SEE ALSO
9509
9510 =back
9511
9512 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9513
9514 =over 4
9515
9516 =item SYNOPSIS
9517
9518 =item DESCRIPTION
9519
9520 =back
9521
9522 =head2 version - Perl extension for Version Objects
9523
9524 =over 4
9525
9526 =item SYNOPSIS
9527
9528 =item DESCRIPTION
9529
9530 =over 4
9531
9532 =item What IS a version
9533
9534 Numeric Versions, V-String Versions
9535
9536 =item Numeric Versions
9537
9538 =item V-String Versions
9539
9540 =item Object Methods
9541
9542 New Operator, Stringification, Numification, Comparison operators, Logical
9543 Operators
9544
9545 =item Quoting
9546
9547 =item Types of Versions Objects
9548
9549 Ordinary versions, alpha versions
9550
9551 =item Replacement UNIVERSAL::VERSION
9552
9553 =back
9554
9555 =item EXPORT
9556
9557 =item AUTHOR
9558
9559 =item SEE ALSO
9560
9561 =back
9562
9563 =head2 vmsish - Perl pragma to control VMS-specific language features
9564
9565 =over 4
9566
9567 =item SYNOPSIS
9568
9569 =item DESCRIPTION
9570
9571 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9572
9573 =back
9574
9575 =head2 warnings - Perl pragma to control optional warnings
9576
9577 =over 4
9578
9579 =item SYNOPSIS
9580
9581 =item DESCRIPTION
9582
9583 use warnings::register, warnings::enabled(), warnings::enabled($category),
9584 warnings::enabled($object), warnings::warn($message),
9585 warnings::warn($category, $message), warnings::warn($object, $message),
9586 warnings::warnif($message), warnings::warnif($category, $message),
9587 warnings::warnif($object, $message)
9588
9589 =back
9590
9591 =head2 warnings::register - warnings import function
9592
9593 =over 4
9594
9595 =item SYNOPSIS
9596
9597 =item DESCRIPTION
9598
9599 =back
9600
9601 =head1 MODULE DOCUMENTATION
9602
9603 =head2 AnyDBM_File - provide framework for multiple DBMs
9604
9605 =over 4
9606
9607 =item SYNOPSIS
9608
9609 =item DESCRIPTION
9610
9611 =over 4
9612
9613 =item DBM Comparisons
9614
9615 [0], [1], [2], [3]
9616
9617 =back
9618
9619 =item SEE ALSO
9620
9621 =back
9622
9623 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9624
9625 =over 4
9626
9627 =item VERSION
9628
9629 =item SYNOPSIS
9630
9631 =item DESCRIPTION
9632
9633 [0], [1], [2], [3], [4], [5]
9634
9635 =over 4
9636
9637 =item Typed lexicals
9638
9639 =item Type-specific attribute handlers
9640
9641 =item Non-interpretive attribute handlers
9642
9643 =item Phase-specific attribute handlers
9644
9645 =item Attributes as C<tie> interfaces
9646
9647 =back
9648
9649 =item EXAMPLES
9650
9651 =item DIAGNOSTICS
9652
9653 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9654 attributes>, C<Declaration of %s attribute in package %s may clash with
9655 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9656 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9657 be able to apply END handler>
9658
9659 =item AUTHOR
9660
9661 =item BUGS
9662
9663 =item COPYRIGHT
9664
9665 =back
9666
9667 =head2 AutoLoader - load subroutines only on demand
9668
9669 =over 4
9670
9671 =item SYNOPSIS
9672
9673 =item DESCRIPTION
9674
9675 =over 4
9676
9677 =item Subroutine Stubs
9678
9679 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9680
9681 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9682
9683 =item Package Lexicals
9684
9685 =item Not Using AutoLoader
9686
9687 =item B<AutoLoader> vs. B<SelfLoader>
9688
9689 =back
9690
9691 =item CAVEATS
9692
9693 =item SEE ALSO
9694
9695 =back
9696
9697 =head2 AutoSplit - split a package for autoloading
9698
9699 =over 4
9700
9701 =item SYNOPSIS
9702
9703 =item DESCRIPTION
9704
9705 $keep, $check, $modtime
9706
9707 =over 4
9708
9709 =item Multiple packages
9710
9711 =back
9712
9713 =item DIAGNOSTICS
9714
9715 =back
9716
9717 =head2 B - The Perl Compiler
9718
9719 =over 4
9720
9721 =item SYNOPSIS
9722
9723 =item DESCRIPTION
9724
9725 =item OVERVIEW
9726
9727 =item Utility Functions
9728
9729 =over 4
9730
9731 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
9732 objects
9733
9734 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
9735 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
9736
9737 =item Functions for Examining the Symbol Table
9738
9739 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
9740
9741 =item Functions Returning C<B::OP> objects or for walking op trees
9742
9743 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
9744
9745 =item Miscellaneous Utility Functions
9746
9747 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
9748 perlstring(STR), class(OBJ), threadsv_names
9749
9750 =back
9751
9752 =item OVERVIEW OF CLASSES
9753
9754 =over 4
9755
9756 =item SV-RELATED CLASSES
9757
9758 =item B::SV Methods
9759
9760 REFCNT, FLAGS, object_2svref
9761
9762 =item B::IV Methods
9763
9764 IV, IVX, UVX, int_value, needs64bits, packiv
9765
9766 =item B::NV Methods
9767
9768 NV, NVX
9769
9770 =item B::RV Methods
9771
9772 RV
9773
9774 =item B::PV Methods
9775
9776 PV, RV, PVX
9777
9778 =item B::PVMG Methods
9779
9780 MAGIC, SvSTASH
9781
9782 =item B::MAGIC Methods
9783
9784 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9785
9786 =item B::PVLV Methods
9787
9788 TARGOFF, TARGLEN, TYPE, TARG
9789
9790 =item B::BM Methods
9791
9792 USEFUL, PREVIOUS, RARE, TABLE
9793
9794 =item B::GV Methods
9795
9796 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9797 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9798
9799 =item B::IO Methods
9800
9801 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9802 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9803
9804 =item B::AV Methods
9805
9806 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
9807
9808 =item B::CV Methods
9809
9810 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
9811 XSUBANY, CvFLAGS, const_sv
9812
9813 =item B::HV Methods
9814
9815 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9816
9817 =item OP-RELATED CLASSES
9818
9819 =item B::OP Methods
9820
9821 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9822
9823 =item B::UNOP METHOD
9824
9825 first
9826
9827 =item B::BINOP METHOD
9828
9829 last
9830
9831 =item B::LOGOP METHOD
9832
9833 other
9834
9835 =item B::LISTOP METHOD
9836
9837 children
9838
9839 =item B::PMOP Methods
9840
9841 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9842 pmpermflags, precomp, pmoffset
9843
9844 =item B::SVOP METHOD
9845
9846 sv, gv
9847
9848 =item B::PADOP METHOD
9849
9850 padix
9851
9852 =item B::PVOP METHOD
9853
9854 pv
9855
9856 =item B::LOOP Methods
9857
9858 redoop, nextop, lastop
9859
9860 =item B::COP Methods
9861
9862 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
9863
9864 =back
9865
9866 =item AUTHOR
9867
9868 =back
9869
9870 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9871 bytecode
9872
9873 =over 4
9874
9875 =item SYNOPSIS
9876
9877 =item DESCRIPTION
9878
9879 %insn_data, @insn_name, @optype, @specialsv_name
9880
9881 =item AUTHOR
9882
9883 =back
9884
9885 =head2 B::Assembler - Assemble Perl bytecode
9886
9887 =over 4
9888
9889 =item SYNOPSIS
9890
9891 =item DESCRIPTION
9892
9893 =item AUTHORS
9894
9895 =back
9896
9897 =head2 B::Bblock - Walk basic blocks
9898
9899 =over 4
9900
9901 =item SYNOPSIS
9902
9903 =item DESCRIPTION
9904
9905 =over 4
9906
9907 =item Functions
9908
9909 B<find_leaders>
9910
9911 =back
9912
9913 =item AUTHOR
9914
9915 =back
9916
9917 =head2 B::Bytecode - Perl compiler's bytecode backend
9918
9919 =over 4
9920
9921 =item SYNOPSIS
9922
9923 =item DESCRIPTION
9924
9925 =item EXAMPLE
9926
9927 =item OPTIONS
9928
9929 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
9930
9931 =item KNOWN BUGS
9932
9933 =item NOTICE
9934
9935 =item AUTHORS
9936
9937 =back
9938
9939 =head2 B::C - Perl compiler's C backend
9940
9941 =over 4
9942
9943 =item SYNOPSIS
9944
9945 =item DESCRIPTION
9946
9947 =item OPTIONS
9948
9949 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9950 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9951 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9952 B<-llimit>
9953
9954 =item EXAMPLES
9955
9956 =item BUGS
9957
9958 =item AUTHOR
9959
9960 =back
9961
9962 =head2 B::CC - Perl compiler's optimized C translation backend
9963
9964 =over 4
9965
9966 =item SYNOPSIS
9967
9968 =item DESCRIPTION
9969
9970 =item OPTIONS
9971
9972 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9973 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9974 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9975
9976 =item EXAMPLES
9977
9978 =item BUGS
9979
9980 =item DIFFERENCES
9981
9982 =over 4
9983
9984 =item Loops
9985
9986 =item Context of ".."
9987
9988 =item Arithmetic
9989
9990 =item Deprecated features
9991
9992 =back
9993
9994 =item AUTHOR
9995
9996 =back
9997
9998 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9999
10000 =over 4
10001
10002 =item SYNOPSIS
10003
10004 =item DESCRIPTION
10005
10006 =item EXAMPLE
10007
10008 =item OPTIONS
10009
10010 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
10011 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
10012 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10013
10014 =item FORMATTING SPECIFICATIONS
10015
10016 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10017 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10018 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10019 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10020 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10021 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10022 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
10023 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10024
10025 =item ABBREVIATIONS
10026
10027 =over 4
10028
10029 =item OP flags abbreviations
10030
10031 =item OP class abbreviations
10032
10033 =back
10034
10035 =item Using B::Concise outside of the O framework
10036
10037 =item AUTHOR
10038
10039 =back
10040
10041 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10042
10043 =over 4
10044
10045 =item SYNOPSIS
10046
10047 =item DESCRIPTION
10048
10049 =item AUTHOR
10050
10051 =back
10052
10053 =head2 B::Deparse - Perl compiler backend to produce perl code
10054
10055 =over 4
10056
10057 =item SYNOPSIS
10058
10059 =item DESCRIPTION
10060
10061 =item OPTIONS
10062
10063 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10064 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10065
10066 =item USING B::Deparse AS A MODULE
10067
10068 =over 4
10069
10070 =item Synopsis
10071
10072 =item Description
10073
10074 =item new
10075
10076 =item ambient_pragmas
10077
10078 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10079
10080 =item coderef2text
10081
10082 =back
10083
10084 =item BUGS
10085
10086 =item AUTHOR
10087
10088 =back
10089
10090 =head2 B::Disassembler - Disassemble Perl bytecode
10091
10092 =over 4
10093
10094 =item SYNOPSIS
10095
10096 =item DESCRIPTION
10097
10098 =item AUTHOR
10099
10100 =back
10101
10102 =head2 B::Lint - Perl lint
10103
10104 =over 4
10105
10106 =item SYNOPSIS
10107
10108 =item DESCRIPTION
10109
10110 =item OPTIONS AND LINT CHECKS
10111
10112 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10113 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10114 B<regexp-variables>, B<all>, B<none>
10115
10116 =item NON LINT-CHECK OPTIONS
10117
10118 B<-u Package>
10119
10120 =item BUGS
10121
10122 =item AUTHOR
10123
10124 =back
10125
10126 =head2 B::O, O - Generic interface to Perl Compiler backends
10127
10128 =over 4
10129
10130 =item SYNOPSIS
10131
10132 =item DESCRIPTION
10133
10134 =item CONVENTIONS
10135
10136 =item IMPLEMENTATION
10137
10138 =item BUGS
10139
10140 =item AUTHOR
10141
10142 =back
10143
10144 =head2 B::Showlex - Show lexical variables used in functions or files
10145
10146 =over 4
10147
10148 =item SYNOPSIS
10149
10150 =item DESCRIPTION
10151
10152 =item AUTHOR
10153
10154 =back
10155
10156 =head2 B::Stackobj - Helper module for CC backend
10157
10158 =over 4
10159
10160 =item SYNOPSIS
10161
10162 =item DESCRIPTION
10163
10164 =item AUTHOR
10165
10166 =back
10167
10168 =head2 B::Stash - show what stashes are loaded
10169
10170 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10171
10172 =over 4
10173
10174 =item SYNOPSIS
10175
10176 =item DESCRIPTION
10177
10178 =item AUTHOR
10179
10180 =back
10181
10182 =head2 B::Xref - Generates cross reference reports for Perl programs
10183
10184 =over 4
10185
10186 =item SYNOPSIS
10187
10188 =item DESCRIPTION
10189
10190 =item OPTIONS
10191
10192 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10193
10194 =item BUGS
10195
10196 =item AUTHOR
10197
10198 =back
10199
10200 =head2 Bblock, B::Bblock - Walk basic blocks
10201
10202 =over 4
10203
10204 =item SYNOPSIS
10205
10206 =item DESCRIPTION
10207
10208 =over 4
10209
10210 =item Functions
10211
10212 B<find_leaders>
10213
10214 =back
10215
10216 =item AUTHOR
10217
10218 =back
10219
10220 =head2 Benchmark - benchmark running times of Perl code
10221
10222 =over 4
10223
10224 =item SYNOPSIS
10225
10226 =item DESCRIPTION
10227
10228 =over 4
10229
10230 =item Methods
10231
10232 new, debug, iters
10233
10234 =item Standard Exports
10235
10236 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10237 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10238 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10239
10240 =item Optional Exports
10241
10242 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10243 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10244 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10245
10246 =item :hireswallclock
10247
10248 =back
10249
10250 =item NOTES
10251
10252 =item EXAMPLES
10253
10254 =item INHERITANCE
10255
10256 =item CAVEATS
10257
10258 =item SEE ALSO
10259
10260 =item AUTHORS
10261
10262 =item MODIFICATION HISTORY
10263
10264 =back
10265
10266 =head2 ByteLoader - load byte compiled perl code
10267
10268 =over 4
10269
10270 =item SYNOPSIS
10271
10272 =item DESCRIPTION
10273
10274 =item AUTHOR
10275
10276 =item SEE ALSO
10277
10278 =back
10279
10280 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10281
10282 =over 4
10283
10284 =item SYNOPSIS
10285
10286 =item DESCRIPTION
10287
10288 =item EXAMPLE
10289
10290 =item OPTIONS
10291
10292 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10293
10294 =item KNOWN BUGS
10295
10296 =item NOTICE
10297
10298 =item AUTHORS
10299
10300 =back
10301
10302 =head2 CGI - Simple Common Gateway Interface Class
10303
10304 =over 4
10305
10306 =item SYNOPSIS
10307
10308 =item ABSTRACT
10309
10310 =item DESCRIPTION
10311
10312 =over 4
10313
10314 =item PROGRAMMING STYLE
10315
10316 =item CALLING CGI.PM ROUTINES
10317
10318 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10319
10320 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10321
10322 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10323
10324 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10325
10326 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10327
10328 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10329
10330 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10331
10332 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10333
10334 =item DELETING A PARAMETER COMPLETELY:
10335
10336 =item DELETING ALL PARAMETERS:
10337
10338 =item DIRECT ACCESS TO THE PARAMETER LIST:
10339
10340 =item FETCHING THE PARAMETER LIST AS A HASH:
10341
10342 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10343
10344 =item RETRIEVING CGI ERRORS
10345
10346 =item USING THE FUNCTION-ORIENTED INTERFACE
10347
10348 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10349 B<:standard>, B<:all>
10350
10351 =item PRAGMAS
10352
10353 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10354 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10355 -private_tempfiles
10356
10357 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10358
10359 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10360 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10361 a </ul> tag)
10362
10363 =back
10364
10365 =item GENERATING DYNAMIC DOCUMENTS
10366
10367 =over 4
10368
10369 =item CREATING A STANDARD HTTP HEADER:
10370
10371 =item GENERATING A REDIRECTION HEADER
10372
10373 =item CREATING THE HTML DOCUMENT HEADER
10374
10375 B<Parameters:>, 4, 5, 6..
10376
10377 =item ENDING THE HTML DOCUMENT:
10378
10379 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10380
10381 =item OBTAINING THE SCRIPT'S URL
10382
10383 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10384 (B<-query_string>), B<-base>
10385
10386 =item MIXING POST AND URL PARAMETERS
10387
10388 =back
10389
10390 =item CREATING STANDARD HTML ELEMENTS:
10391
10392 =over 4
10393
10394 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10395
10396 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10397
10398 =item HTML SHORTCUTS AND LIST INTERPOLATION
10399
10400 =item NON-STANDARD HTML SHORTCUTS
10401
10402 =item AUTOESCAPING HTML
10403
10404 $escaped_string = escapeHTML("unescaped string");, $charset =
10405 charset([$charset]);, $flag = autoEscape([$flag]);
10406
10407 =item PRETTY-PRINTING HTML
10408
10409 =back
10410
10411 =item CREATING FILL-OUT FORMS:
10412
10413 =over 4
10414
10415 =item CREATING AN ISINDEX TAG
10416
10417 =item STARTING AND ENDING A FORM
10418
10419 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10420
10421 =item CREATING A TEXT FIELD
10422
10423 B<Parameters>
10424
10425 =item CREATING A BIG TEXT FIELD
10426
10427 =item CREATING A PASSWORD FIELD
10428
10429 =item CREATING A FILE UPLOAD FIELD
10430
10431 B<Parameters>
10432
10433 =item CREATING A POPUP MENU
10434
10435 =item CREATING AN OPTION GROUP
10436
10437 =item CREATING A SCROLLING LIST
10438
10439 B<Parameters:>
10440
10441 =item CREATING A GROUP OF RELATED CHECKBOXES
10442
10443 B<Parameters:>
10444
10445 =item CREATING A STANDALONE CHECKBOX
10446
10447 B<Parameters:>
10448
10449 =item CREATING A RADIO BUTTON GROUP
10450
10451 B<Parameters:>
10452
10453 =item CREATING A SUBMIT BUTTON
10454
10455 B<Parameters:>
10456
10457 =item CREATING A RESET BUTTON
10458
10459 =item CREATING A DEFAULT BUTTON
10460
10461 =item CREATING A HIDDEN FIELD
10462
10463 B<Parameters:>
10464
10465 =item CREATING A CLICKABLE IMAGE BUTTON
10466
10467 B<Parameters:>, 3. The third option (-align, optional) is an alignment
10468 type, and may be TOP, BOTTOM or MIDDLE
10469
10470 =item CREATING A JAVASCRIPT ACTION BUTTON
10471
10472 =back
10473
10474 =item HTTP COOKIES
10475
10476 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10477 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10478
10479 =item WORKING WITH FRAMES
10480
10481 1. Create a <Frameset> document, 2. Specify the destination for the
10482 document in the HTTP header, 3. Specify the destination for the document in
10483 the <form> tag
10484
10485 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10486
10487 =item DEBUGGING
10488
10489 =over 4
10490
10491 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10492
10493 =back
10494
10495 =item FETCHING ENVIRONMENT VARIABLES
10496
10497 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10498 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
10499 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
10500 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10501 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10502 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10503
10504 =item USING NPH SCRIPTS
10505
10506 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10507 parameters
10508
10509 =item Server Push
10510
10511 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10512
10513 =item Avoiding Denial of Service Attacks
10514
10515 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10516 basis>, B<2. Globally for all scripts>
10517
10518 =item COMPATIBILITY WITH CGI-LIB.PL
10519
10520 =item AUTHOR INFORMATION
10521
10522 =item CREDITS
10523
10524 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10525 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10526 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10527 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10528 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10529 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10530 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10531 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10532 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10533 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10534 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10535 ...and many many more..
10536
10537 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10538
10539 =item BUGS
10540
10541 =item SEE ALSO
10542
10543 =back
10544
10545 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10546
10547 =over 4
10548
10549 =item SYNOPSIS
10550
10551 =item ABSTRACT
10552
10553 =item DESCRIPTION
10554
10555 =item AUTHOR INFORMATION
10556
10557 =item BUGS
10558
10559 =item SEE ALSO
10560
10561 =back
10562
10563 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10564 other) error log
10565
10566 =over 4
10567
10568 =item SYNOPSIS
10569
10570 =item DESCRIPTION
10571
10572 =item REDIRECTING ERROR MESSAGES
10573
10574 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10575
10576 =over 4
10577
10578 =item Changing the default message
10579
10580 =back
10581
10582 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10583
10584 =item OVERRIDING THE NAME OF THE PROGRAM
10585
10586 =item AUTHORS
10587
10588 =item SEE ALSO
10589
10590 =back
10591
10592 =head2 CGI::Cookie - Interface to Netscape Cookies
10593
10594 =over 4
10595
10596 =item SYNOPSIS
10597
10598 =item DESCRIPTION
10599
10600 =item USING CGI::Cookie
10601
10602 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10603
10604 =over 4
10605
10606 =item Creating New Cookies
10607
10608 =item Sending the Cookie to the Browser
10609
10610 =item Recovering Previous Cookies
10611
10612 =item Manipulating Cookies
10613
10614 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10615
10616 =back
10617
10618 =item AUTHOR INFORMATION
10619
10620 =item BUGS
10621
10622 =item SEE ALSO
10623
10624 =back
10625
10626 =head2 CGI::Fast - CGI Interface for Fast CGI
10627
10628 =over 4
10629
10630 =item SYNOPSIS
10631
10632 =item DESCRIPTION
10633
10634 =item OTHER PIECES OF THE PUZZLE
10635
10636 =item WRITING FASTCGI PERL SCRIPTS
10637
10638 =item INSTALLING FASTCGI SCRIPTS
10639
10640 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10641
10642 =item EXTERNAL FASTCGI SERVER INVOCATION
10643
10644 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10645
10646 =item CAVEATS
10647
10648 =item AUTHOR INFORMATION
10649
10650 =item BUGS
10651
10652 =item SEE ALSO
10653
10654 =back
10655
10656 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10657
10658 =over 4
10659
10660 =item SYNOPSIS
10661
10662 =item DESCRIPTION
10663
10664 =over 4
10665
10666 =item Tags that won't be formatted
10667
10668 =item Customizing the Indenting
10669
10670 =back
10671
10672 =item BUGS
10673
10674 =item AUTHOR
10675
10676 =item SEE ALSO
10677
10678 =back
10679
10680 =head2 CGI::Push - Simple Interface to Server Push
10681
10682 =over 4
10683
10684 =item SYNOPSIS
10685
10686 =item DESCRIPTION
10687
10688 =item USING CGI::Push
10689
10690 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10691
10692 =over 4
10693
10694 =item Heterogeneous Pages
10695
10696 =item Changing the Page Delay on the Fly
10697
10698 =back
10699
10700 =item INSTALLING CGI::Push SCRIPTS
10701
10702 =item AUTHOR INFORMATION
10703
10704 =item BUGS
10705
10706 =item SEE ALSO
10707
10708 =back
10709
10710 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10711
10712 =over 4
10713
10714 =item SYNOPSIS
10715
10716 =item ABSTRACT
10717
10718 =item DESCRIPTION
10719
10720 =item AUTHOR INFORMATION
10721
10722 =item BUGS
10723
10724 =item SEE ALSO
10725
10726 =back
10727
10728 =head2 CGI::Util - Internal utilities used by CGI module
10729
10730 =over 4
10731
10732 =item SYNOPSIS
10733
10734 =item DESCRIPTION
10735
10736 =item AUTHOR INFORMATION
10737
10738 =item SEE ALSO
10739
10740 =back
10741
10742 =head2 CPAN - query, download and build perl modules from CPAN sites
10743
10744 =over 4
10745
10746 =item SYNOPSIS
10747
10748 =item STATUS
10749
10750 =item DESCRIPTION
10751
10752 =over 4
10753
10754 =item Interactive Mode
10755
10756 Searching for authors, bundles, distribution files and modules, make, test,
10757 install, clean  modules or distributions, get, readme, look module or
10758 distribution, ls author, Signals
10759
10760 =item CPAN::Shell
10761
10762 =item autobundle
10763
10764 =item recompile
10765
10766 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10767
10768 =item Programmer's interface
10769
10770 expand($type,@things), expandany(@things), Programming Examples
10771
10772 =item Methods in the other Classes
10773
10774 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10775 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10776 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10777 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10778 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10779 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10780 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10781 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10782 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10783 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10784 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10785 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10786 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10787 CPAN::Distribution::look(), CPAN::Distribution::make(),
10788 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10789 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10790 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10791 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10792 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10793 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10794 CPAN::Module::description(), CPAN::Module::force($method,@args),
10795 CPAN::Module::get(), CPAN::Module::inst_file(),
10796 CPAN::Module::inst_version(), CPAN::Module::install(),
10797 CPAN::Module::look(), CPAN::Module::make(),
10798 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10799 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10800
10801 =item Cache Manager
10802
10803 =item Bundles
10804
10805 =item Prerequisites
10806
10807 =item Finding packages and VERSION
10808
10809 =item Debugging
10810
10811 =item Floppy, Zip, Offline Mode
10812
10813 =back
10814
10815 =item CONFIGURATION
10816
10817 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10818 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10819 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10820 [unshift|push|splice] E<lt>listE<gt>>
10821
10822 =over 4
10823
10824 =item Note on urllist parameter's format
10825
10826 =item urllist parameter has CD-ROM support
10827
10828 =back
10829
10830 =item SECURITY
10831
10832 =item EXPORT
10833
10834 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10835
10836 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10837
10838 =over 4
10839
10840 =item Three basic types of firewalls
10841
10842 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10843
10844 =item Configuring lynx or ncftp for going through a firewall
10845
10846 =back
10847
10848 =item FAQ
10849
10850 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10851
10852 =item BUGS
10853
10854 =item AUTHOR
10855
10856 =item TRANSLATIONS
10857
10858 =item SEE ALSO
10859
10860 =back
10861
10862 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10863
10864 =over 4
10865
10866 =item SYNOPSIS
10867
10868 =item DESCRIPTION
10869
10870 =back
10871
10872 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10873 module
10874
10875 =over 4
10876
10877 =item SYNOPSIS
10878
10879 =item DESCRIPTION
10880
10881 =item  SEE ALSO
10882
10883 =back
10884
10885 =head2 Carp, carp    - warn of errors (from perspective of caller)
10886
10887 =over 4
10888
10889 =item SYNOPSIS
10890
10891 =item DESCRIPTION
10892
10893 =over 4
10894
10895 =item Forcing a Stack Trace
10896
10897 =back
10898
10899 =item BUGS
10900
10901 =back
10902
10903 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10904
10905 =head2 Class::ISA -- report the search path for a class's ISA tree
10906
10907 =over 4
10908
10909 =item SYNOPSIS
10910
10911 =item DESCRIPTION
10912
10913 =item FUNCTIONS
10914
10915 the function Class::ISA::super_path($CLASS), the function
10916 Class::ISA::self_and_super_path($CLASS), the function
10917 Class::ISA::self_and_super_versions($CLASS)
10918
10919 =item CAUTIONARY NOTES
10920
10921 =item COPYRIGHT
10922
10923 =item AUTHOR
10924
10925 =back
10926
10927 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10928
10929 =over 4
10930
10931 =item SYNOPSIS
10932
10933 =item DESCRIPTION
10934
10935 =over 4
10936
10937 =item The C<struct()> function
10938
10939 =item Class Creation at Compile Time
10940
10941 =item Element Types and Accessor Methods
10942
10943 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10944 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10945
10946 =item Initializing with C<new>
10947
10948 =back
10949
10950 =item EXAMPLES
10951
10952 Example 1, Example 2, Example 3
10953
10954 =item Author and Modification History
10955
10956 =back
10957
10958 =head2 Config - access Perl configuration information
10959
10960 =over 4
10961
10962 =item SYNOPSIS
10963
10964 =item DESCRIPTION
10965
10966 myconfig(), config_sh(), config_re($regex), config_vars(@names)
10967
10968 =item EXAMPLE
10969
10970 =item WARNING
10971
10972 =item GLOSSARY
10973
10974 =over 4
10975
10976 =item _
10977
10978 C<_a>, C<_exe>, C<_o>
10979
10980 =item a
10981
10982 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10983 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10984 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10985 C<asctime_r_proto>, C<awk>
10986
10987 =item b
10988
10989 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10990
10991 =item c
10992
10993 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10994 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10995 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10996 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10997 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10998 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10999 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11000
11001 =item d
11002
11003 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11004 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11005 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11006 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11007 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11008 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11009 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11010 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11011 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11012 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11013 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11014 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11015 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11016 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11017 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11018 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11019 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11020 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11021 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11022 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11023 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11024 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11025 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11026 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11027 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11028 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11029 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11030 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11031 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11032 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11033 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11034 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11035 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11036 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11037 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11038 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11039 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11040 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11041 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11042 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11043 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11044 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11045 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11046 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11047 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11048 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11049 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11050 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11051 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11052 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11053 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11054 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11055 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11056 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11057 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11058 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11059 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11060 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11061 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11062 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11063 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11064 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11065 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11066 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11067 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11068 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11069 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11070 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11071 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11072 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11073 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11074 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11075 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11076 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11077 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11078 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11079 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11080 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11081 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11082 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11083 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11084 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11085 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11086 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11087 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11088 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11089 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11090 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11091 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11092 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11093 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11094 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11095
11096 =item e
11097
11098 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11099 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11100 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11101 C<expr>, C<extensions>, C<extras>
11102
11103 =item f
11104
11105 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11106 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11107 C<full_sed>
11108
11109 =item g
11110
11111 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11112 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11113 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11114 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11115 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11116 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11117 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11118 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11119 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11120 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11121
11122 =item h
11123
11124 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11125 C<html3dir>, C<html3direxp>
11126
11127 =item i
11128
11129 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11130 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11131 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11132 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11133 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11134 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11135 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11136 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11137 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11138 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11139 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11140 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11141 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11142 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11143 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11144 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11145 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11146 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11147 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11148 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11149 C<installprefixexp>, C<installprivlib>, C<installscript>,
11150 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11151 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11152 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11153 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11154 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11155 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11156 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11157
11158 =item k
11159
11160 C<known_extensions>, C<ksh>
11161
11162 =item l
11163
11164 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11165 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11166 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11167 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11168 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11169 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11170 C<lseektype>
11171
11172 =item m
11173
11174 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11175 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11176 C<man3direxp>, C<man3ext>
11177
11178 =item M
11179
11180 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11181 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11182 C<myuname>
11183
11184 =item n
11185
11186 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11187 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11188 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11189 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11190 C<nvsize>, C<nvtype>
11191
11192 =item o
11193
11194 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11195 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11196
11197 =item p
11198
11199 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11200 C<perl>, C<perl_patchlevel>
11201
11202 =item P
11203
11204 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11205 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11206 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
11207 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
11208
11209 =item q
11210
11211 C<quadkind>, C<quadtype>
11212
11213 =item r
11214
11215 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11216 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11217 C<rmail>, C<run>, C<runnm>
11218
11219 =item s
11220
11221 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11222 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11223 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11224 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11225 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11226 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11227 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11228 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11229 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11230 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11231 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11232 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11233 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11234 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11235 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11236 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11237 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11238 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11239 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11240 C<submit>, C<subversion>, C<sysman>
11241
11242 =item t
11243
11244 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11245 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11246 C<ttyname_r_proto>
11247
11248 =item u
11249
11250 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11251 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11252 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11253 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11254 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11255 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11256 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11257 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11258 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11259 C<uvXUformat>
11260
11261 =item v
11262
11263 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11264 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11265 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11266 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11267 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11268 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11269 C<versiononly>, C<vi>, C<voidflags>
11270
11271 =item x
11272
11273 C<xlibpth>, C<xs_apiversion>
11274
11275 =item y
11276
11277 C<yacc>, C<yaccflags>
11278
11279 =item z
11280
11281 C<zcat>, C<zip>
11282
11283 =back
11284
11285 =item NOTE
11286
11287 =back
11288
11289 =head2 Cwd - get pathname of current working directory
11290
11291 =over 4
11292
11293 =item SYNOPSIS
11294
11295 =item DESCRIPTION
11296
11297 =over 4
11298
11299 =item getcwd and friends
11300
11301 getcwd, cwd, fastcwd, fastgetcwd
11302
11303 =item abs_path and friends
11304
11305 abs_path, realpath, fast_abs_path
11306
11307 =item $ENV{PWD}
11308
11309 =back
11310
11311 =item NOTES
11312
11313 =item SEE ALSO
11314
11315 =back
11316
11317 =head2 DB - programmatic interface to the Perl debugging API (draft,
11318 subject to
11319 change)
11320
11321 =over 4
11322
11323 =item SYNOPSIS
11324
11325 =item DESCRIPTION
11326
11327 =over 4
11328
11329 =item Global Variables
11330
11331  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
11332 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
11333 $DB::lineno
11334
11335 =item API Methods
11336
11337 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11338 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11339
11340 =item Client Callback Methods
11341
11342 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11343 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11344 CLIENT->output(LIST)
11345
11346 =back
11347
11348 =item BUGS
11349
11350 =item AUTHOR
11351
11352 =back
11353
11354 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11355
11356 =over 4
11357
11358 =item SYNOPSIS
11359
11360 =item DESCRIPTION
11361
11362 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11363
11364 =over 4
11365
11366 =item Using DB_File with Berkeley DB version 2 or greater
11367
11368 =item Interface to Berkeley DB
11369
11370 =item Opening a Berkeley DB Database File
11371
11372 =item Default Parameters
11373
11374 =item In Memory Databases
11375
11376 =back
11377
11378 =item DB_HASH
11379
11380 =over 4
11381
11382 =item A Simple Example
11383
11384 =back
11385
11386 =item DB_BTREE
11387
11388 =over 4
11389
11390 =item Changing the BTREE sort order
11391
11392 =item Handling Duplicate Keys
11393
11394 =item The get_dup() Method
11395
11396 =item The find_dup() Method
11397
11398 =item The del_dup() Method
11399
11400 =item Matching Partial Keys
11401
11402 =back
11403
11404 =item DB_RECNO
11405
11406 =over 4
11407
11408 =item The 'bval' Option
11409
11410 =item A Simple Example
11411
11412 =item Extra RECNO Methods
11413
11414 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11415 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11416 length, elements);>
11417
11418 =item Another Example
11419
11420 =back
11421
11422 =item THE API INTERFACE
11423
11424 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11425 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11426 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11427 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11428
11429 =item DBM FILTERS
11430
11431 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11432 B<filter_fetch_value>
11433
11434 =over 4
11435
11436 =item The Filter
11437
11438 =item An Example -- the NULL termination problem.
11439
11440 =item Another Example -- Key is a C int.
11441
11442 =back
11443
11444 =item HINTS AND TIPS
11445
11446 =over 4
11447
11448 =item Locking: The Trouble with fd
11449
11450 =item Safe ways to lock a database
11451
11452 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11453
11454 =item Sharing Databases With C Applications
11455
11456 =item The untie() Gotcha
11457
11458 =back
11459
11460 =item COMMON QUESTIONS
11461
11462 =over 4
11463
11464 =item Why is there Perl source in my database?
11465
11466 =item How do I store complex data structures with DB_File?
11467
11468 =item What does "Invalid Argument" mean?
11469
11470 =item What does "Bareword 'DB_File' not allowed" mean?
11471
11472 =back
11473
11474 =item REFERENCES
11475
11476 =item HISTORY
11477
11478 =item BUGS
11479
11480 =item AVAILABILITY
11481
11482 =item COPYRIGHT
11483
11484 =item SEE ALSO
11485
11486 =item AUTHOR
11487
11488 =back
11489
11490 =head2 Data::Dumper - stringified perl data structures, suitable for both
11491 printing and C<eval>
11492
11493 =over 4
11494
11495 =item SYNOPSIS
11496
11497 =item DESCRIPTION
11498
11499 =over 4
11500
11501 =item Methods
11502
11503 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11504 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11505 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11506 I<$OBJ>->Reset
11507
11508 =item Functions
11509
11510 Dumper(I<LIST>)
11511
11512 =item Configuration Variables or Methods
11513
11514 =item Exports
11515
11516 Dumper
11517
11518 =back
11519
11520 =item EXAMPLES
11521
11522 =item BUGS
11523
11524 =over 4
11525
11526 =item NOTE
11527
11528 =back
11529
11530 =item AUTHOR
11531
11532 =item VERSION
11533
11534 =item SEE ALSO
11535
11536 =back
11537
11538 =head2 Devel::DProf - a Perl code profiler
11539
11540 =over 4
11541
11542 =item SYNOPSIS
11543
11544 =item DESCRIPTION
11545
11546 =item PROFILE FORMAT
11547
11548 =item AUTOLOAD
11549
11550 =item ENVIRONMENT
11551
11552 =item BUGS
11553
11554 =item SEE ALSO
11555
11556 =back
11557
11558 =head2 Devel::PPPort - Perl/Pollution/Portability
11559
11560 =over 4
11561
11562 =item SYNOPSIS
11563
11564 =item DESCRIPTION
11565
11566 =over 4
11567
11568 =item WriteFile
11569
11570 =back
11571
11572 =item ppport.h
11573
11574 =item AUTHOR
11575
11576 =item SEE ALSO
11577
11578 =back
11579
11580 =head2 Devel::Peek - A data debugging tool for the XS programmer
11581
11582 =over 4
11583
11584 =item SYNOPSIS
11585
11586 =item DESCRIPTION
11587
11588 =over 4
11589
11590 =item Runtime debugging
11591
11592 =item Memory footprint debugging
11593
11594 =back
11595
11596 =item EXAMPLES
11597
11598 =over 4
11599
11600 =item A simple scalar string
11601
11602 =item A simple scalar number
11603
11604 =item A simple scalar with an extra reference
11605
11606 =item A reference to a simple scalar
11607
11608 =item A reference to an array
11609
11610 =item A reference to a hash
11611
11612 =item Dumping a large array or hash
11613
11614 =item A reference to an SV which holds a C pointer
11615
11616 =item A reference to a subroutine
11617
11618 =back
11619
11620 =item EXPORTS
11621
11622 =item BUGS
11623
11624 =item AUTHOR
11625
11626 =item SEE ALSO
11627
11628 =back
11629
11630 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11631
11632 =over 4
11633
11634 =item SYNOPSIS
11635
11636 =item DESCRIPTION
11637
11638 =back
11639
11640 =head2 Digest:: - Modules that calculate message digests
11641
11642 =over 4
11643
11644 =item SYNOPSIS
11645
11646 =item DESCRIPTION
11647
11648 I<binary>, I<hex>, I<base64>
11649
11650 =item OO INTERFACE
11651
11652 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11653 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
11654 $ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
11655 $ctx->hexdigest, $ctx->b64digest
11656
11657 =item SEE ALSO
11658
11659 =item AUTHOR
11660
11661 =back
11662
11663 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11664
11665 =over 4
11666
11667 =item SYNOPSIS
11668
11669 =item DESCRIPTION
11670
11671 =item FUNCTIONS
11672
11673 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11674
11675 =item METHODS
11676
11677 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
11678 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11679
11680 =item EXAMPLES
11681
11682 =item SEE ALSO
11683
11684 =item COPYRIGHT
11685
11686 =item AUTHORS
11687
11688 =back
11689
11690 =head2 DirHandle - supply object methods for directory handles
11691
11692 =over 4
11693
11694 =item SYNOPSIS
11695
11696 =item DESCRIPTION
11697
11698 =item NOTES
11699
11700 =back
11701
11702 =head2 Dumpvalue - provides screen dump of Perl data.
11703
11704 =over 4
11705
11706 =item SYNOPSIS
11707
11708 =item DESCRIPTION
11709
11710 =over 4
11711
11712 =item Creation
11713
11714 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11715 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11716 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11717 stopDbSignal
11718
11719 =item Methods
11720
11721 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11722 compactDump, veryCompact, set, get
11723
11724 =back
11725
11726 =back
11727
11728 =head2 DynaLoader - Dynamically load C libraries into Perl code
11729
11730 =over 4
11731
11732 =item SYNOPSIS
11733
11734 =item DESCRIPTION
11735
11736 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11737 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11738 dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
11739 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11740 bootstrap()
11741
11742 =item AUTHOR
11743
11744 =back
11745
11746 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11747 Perl code
11748
11749 =over 4
11750
11751 =item SYNOPSIS
11752
11753 =item DESCRIPTION
11754
11755 =item AUTHOR
11756
11757 =back
11758
11759 =head2 Encode - character encodings
11760
11761 =over 4
11762
11763 =item SYNOPSIS
11764
11765 =over 4
11766
11767 =item Table of Contents
11768
11769 =back
11770
11771 =item DESCRIPTION
11772
11773 =over 4
11774
11775 =item TERMINOLOGY
11776
11777 =back
11778
11779 =item PERL ENCODING API
11780
11781 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11782 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11783 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11784 CHECK]);
11785
11786 =over 4
11787
11788 =item Listing available encodings
11789
11790 =item Defining Aliases
11791
11792 =back
11793
11794 =item Encoding via PerlIO
11795
11796 =item Handling Malformed Data
11797
11798 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11799 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11800 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11801 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11802 bitmask
11803
11804 =over 4
11805
11806 =item Unimplemented fallback schemes
11807
11808 =back
11809
11810 =item Defining Encodings
11811
11812 =item The UTF-8 flag
11813
11814 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11815
11816 =over 4
11817
11818 =item Messing with Perl's Internals
11819
11820 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11821
11822 =back
11823
11824 =item SEE ALSO
11825
11826 =item MAINTAINER
11827
11828 =back
11829
11830 =head2 Encode::Alias - alias definitions to encodings
11831
11832 =over 4
11833
11834 =item SYNOPSIS
11835
11836 =item DESCRIPTION
11837
11838 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11839 reference, e.g.:
11840
11841 =over 4
11842
11843 =item Alias overloading
11844
11845 =back
11846
11847 =item SEE ALSO
11848
11849 =back
11850
11851 =head2 Encode::Byte - Single Byte Encodings
11852
11853 =over 4
11854
11855 =item SYNOPSIS
11856
11857 =item ABSTRACT
11858
11859 =item DESCRIPTION
11860
11861 =item SEE ALSO
11862
11863 =back
11864
11865 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11866
11867 =head2 Encode::CN - China-based Chinese Encodings
11868
11869 =over 4
11870
11871 =item SYNOPSIS
11872
11873 =item DESCRIPTION
11874
11875 =item NOTES
11876
11877 =item BUGS
11878
11879 =item SEE ALSO
11880
11881 =back
11882
11883 =head2 Encode::CN::HZ -- internally used by Encode::CN
11884
11885 =head2 Encode::Config -- internally used by Encode
11886
11887 =head2 Encode::EBCDIC - EBCDIC Encodings
11888
11889 =over 4
11890
11891 =item SYNOPSIS
11892
11893 =item ABSTRACT
11894
11895 =item DESCRIPTION
11896
11897 =item SEE ALSO
11898
11899 =back
11900
11901 =head2 Encode::Encoding - Encode Implementation Base Class
11902
11903 =over 4
11904
11905 =item SYNOPSIS
11906
11907 =item DESCRIPTION
11908
11909 =over 4
11910
11911 =item Methods you should implement
11912
11913 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11914 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11915
11916 =item Other methods defined in Encode::Encodings
11917
11918 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11919
11920 =item Example: Encode::ROT13
11921
11922 =back
11923
11924 =item Why the heck Encode API is different?
11925
11926 =over 4
11927
11928 =item Compiled Encodings
11929
11930 =back
11931
11932 =item SEE ALSO
11933
11934 Scheme 1, Scheme 2, Other Schemes
11935
11936 =back
11937
11938 =head2 Encode::Guess -- Guesses encoding from data
11939
11940 =over 4
11941
11942 =item SYNOPSIS
11943
11944 =item ABSTRACT
11945
11946 =item DESCRIPTION
11947
11948 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11949 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11950 guess_encoding($data, [, I<list of suspects>])
11951
11952 =item CAVEATS
11953
11954 =item TO DO
11955
11956 =item SEE ALSO
11957
11958 =back
11959
11960 =head2 Encode::JP - Japanese Encodings
11961
11962 =over 4
11963
11964 =item SYNOPSIS
11965
11966 =item ABSTRACT
11967
11968 =item DESCRIPTION
11969
11970 =item Note on ISO-2022-JP(-1)?
11971
11972 =item BUGS
11973
11974 =item SEE ALSO
11975
11976 =back
11977
11978 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11979
11980 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11981
11982 =head2 Encode::KR - Korean Encodings
11983
11984 =over 4
11985
11986 =item SYNOPSIS
11987
11988 =item DESCRIPTION
11989
11990 =item BUGS
11991
11992 =item SEE ALSO
11993
11994 =back
11995
11996 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11997
11998 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11999
12000 =over 4
12001
12002 =item SYNOPSIS
12003
12004 =item ABSTRACT
12005
12006 =item DESCRIPTION
12007
12008 =item BUGS
12009
12010 =item SEE ALSO
12011
12012 =back
12013
12014 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12015
12016 =over 4
12017
12018 =item Overview
12019
12020 =item How does it work?
12021
12022 =item Line Buffering
12023
12024 =over 4
12025
12026 =item How can I tell whether my encoding fully supports PerlIO ?
12027
12028 =back
12029
12030 =item SEE ALSO
12031
12032 =back
12033
12034 =head2 Encode::Supported -- Encodings supported by Encode
12035
12036 =over 4
12037
12038 =item DESCRIPTION
12039
12040 =over 4
12041
12042 =item Encoding Names
12043
12044 =back
12045
12046 =item Supported Encodings
12047
12048 =over 4
12049
12050 =item Built-in Encodings
12051
12052 =item Encode::Unicode -- other Unicode encodings
12053
12054 =item Encode::Byte -- Extended ASCII
12055
12056 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12057 the Cyrillic world, gsm0338 - Hentai Latin 1
12058
12059 =item CJK: Chinese, Japanese, Korean (Multibyte)
12060
12061 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12062 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12063 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12064
12065 =item Miscellaneous encodings
12066
12067 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12068
12069 =back
12070
12071 =item Unsupported encodings
12072
12073   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12074 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12075 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12076 Various Mac encodings, (Mac) Indic encodings
12077
12078 =item Encoding vs. Charset -- terminology
12079
12080 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12081
12082 =over 4
12083
12084 =item Microsoft-related naming mess
12085
12086 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12087
12088 =back
12089
12090 =item Glossary
12091
12092 character repertoire, coded character set (CCS), character encoding scheme
12093 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12094 UTF-16
12095
12096 =item See Also
12097
12098 =item References
12099
12100 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12101 RFC, UC, Unicode Glossary
12102
12103 =over 4
12104
12105 =item Other Notable Sites
12106
12107 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12108 "Introduction to i18n"
12109
12110 =item Offline sources
12111
12112 C<CJKV Information Processing> by Ken Lunde
12113
12114 =back
12115
12116 =back
12117
12118 =head2 Encode::Symbol - Symbol Encodings
12119
12120 =over 4
12121
12122 =item SYNOPSIS
12123
12124 =item ABSTRACT
12125
12126 =item DESCRIPTION
12127
12128 =item SEE ALSO
12129
12130 =back
12131
12132 =head2 Encode::TW - Taiwan-based Chinese Encodings
12133
12134 =over 4
12135
12136 =item SYNOPSIS
12137
12138 =item DESCRIPTION
12139
12140 =item NOTES
12141
12142 =item BUGS
12143
12144 =item SEE ALSO
12145
12146 =back
12147
12148 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12149
12150 =over 4
12151
12152 =item SYNOPSIS
12153
12154 =item ABSTRACT
12155
12156 L<http://www.unicode.org/glossary/> says:, Quick Reference
12157
12158 =item Size, Endianness, and BOM
12159
12160 =over 4
12161
12162 =item by size
12163
12164 =item by endianness
12165
12166 BOM as integer when fetched in network byte order
12167
12168 =back
12169
12170 =item Surrogate Pairs
12171
12172 =item SEE ALSO
12173
12174 =back
12175
12176 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12177
12178 =over 4
12179
12180 =item SYNOPSIS
12181
12182 =item ABSTRACT
12183
12184 =item In Practice
12185
12186 =item SEE ALSO
12187
12188 =back
12189
12190 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12191 encodings
12192
12193 =over 4
12194
12195 =item SYNOPSIS
12196
12197 =item DESCRIPTION
12198
12199 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12200 reference, e.g.:
12201
12202 =over 4
12203
12204 =item Alias overloading
12205
12206 =back
12207
12208 =item SEE ALSO
12209
12210 =back
12211
12212 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12213 Internally used by Encode::??::ISO_2022_*
12214
12215 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12216 Encode::CN
12217
12218 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12219 Encode
12220
12221 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12222 Implementation Base Class
12223
12224 =over 4
12225
12226 =item SYNOPSIS
12227
12228 =item DESCRIPTION
12229
12230 =over 4
12231
12232 =item Methods you should implement
12233
12234 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12235 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12236
12237 =item Other methods defined in Encode::Encodings
12238
12239 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12240
12241 =item Example: Encode::ROT13
12242
12243 =back
12244
12245 =item Why the heck Encode API is different?
12246
12247 =over 4
12248
12249 =item Compiled Encodings
12250
12251 =back
12252
12253 =item SEE ALSO
12254
12255 Scheme 1, Scheme 2, Other Schemes
12256
12257 =back
12258
12259 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12260 data
12261
12262 =over 4
12263
12264 =item SYNOPSIS
12265
12266 =item ABSTRACT
12267
12268 =item DESCRIPTION
12269
12270 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12271 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12272 guess_encoding($data, [, I<list of suspects>])
12273
12274 =item CAVEATS
12275
12276 =item TO DO
12277
12278 =item SEE ALSO
12279
12280 =back
12281
12282 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12283 Encode::JP::2022_JP*
12284
12285 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12286 by Encode::JP
12287
12288 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12289 used by Encode::KR
12290
12291 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12292 and 'Q' header encoding
12293
12294 =over 4
12295
12296 =item SYNOPSIS
12297
12298 =item ABSTRACT
12299
12300 =item DESCRIPTION
12301
12302 =item BUGS
12303
12304 =item SEE ALSO
12305
12306 =back
12307
12308 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12309 on Encode and PerlIO
12310
12311 =over 4
12312
12313 =item Overview
12314
12315 =item How does it work?
12316
12317 =item Line Buffering
12318
12319 =over 4
12320
12321 =item How can I tell whether my encoding fully supports PerlIO ?
12322
12323 =back
12324
12325 =item SEE ALSO
12326
12327 =back
12328
12329 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12330 supported by Encode
12331
12332 =over 4
12333
12334 =item DESCRIPTION
12335
12336 =over 4
12337
12338 =item Encoding Names
12339
12340 =back
12341
12342 =item Supported Encodings
12343
12344 =over 4
12345
12346 =item Built-in Encodings
12347
12348 =item Encode::Unicode -- other Unicode encodings
12349
12350 =item Encode::Byte -- Extended ASCII
12351
12352 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12353 the Cyrillic world, gsm0338 - Hentai Latin 1
12354
12355 =item CJK: Chinese, Japanese, Korean (Multibyte)
12356
12357 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12358 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12359 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12360
12361 =item Miscellaneous encodings
12362
12363 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12364
12365 =back
12366
12367 =item Unsupported encodings
12368
12369   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12370 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12371 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12372 Various Mac encodings, (Mac) Indic encodings
12373
12374 =item Encoding vs. Charset -- terminology
12375
12376 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12377
12378 =over 4
12379
12380 =item Microsoft-related naming mess
12381
12382 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12383
12384 =back
12385
12386 =item Glossary
12387
12388 character repertoire, coded character set (CCS), character encoding scheme
12389 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12390 UTF-16
12391
12392 =item See Also
12393
12394 =item References
12395
12396 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12397 RFC, UC, Unicode Glossary
12398
12399 =over 4
12400
12401 =item Other Notable Sites
12402
12403 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12404 "Introduction to i18n"
12405
12406 =item Offline sources
12407
12408 C<CJKV Information Processing> by Ken Lunde
12409
12410 =back
12411
12412 =back
12413
12414 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12415 encoding
12416
12417 =over 4
12418
12419 =item SYNOPSIS
12420
12421 =item ABSTRACT
12422
12423 =item In Practice
12424
12425 =item SEE ALSO
12426
12427 =back
12428
12429 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12430
12431 =over 4
12432
12433 =item SYNOPSIS
12434
12435 =item ABSTRACT
12436
12437 =item Description
12438
12439 =over 4
12440
12441 =item Predefined Methods
12442
12443 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12444 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12445 $e-E<gt>bytes([$encoding])
12446
12447 =item Example: base64 transcoder
12448
12449 =item Operator Overloading
12450
12451 =back
12452
12453 =item SEE ALSO
12454
12455 =back
12456
12457 =head2 Encodencoding, encoding - allows you to write your script in
12458 non-ascii or non-utf8
12459
12460 =over 4
12461
12462 =item SYNOPSIS
12463
12464 =item ABSTRACT
12465
12466 =over 4
12467
12468 =item Literal Conversions
12469
12470 =item PerlIO layers for C<STD(IN|OUT)>
12471
12472 =back
12473
12474 =item FEATURES THAT REQUIRE 5.8.1
12475
12476 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12477
12478 =item USAGE
12479
12480 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12481 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12482
12483 =item The Filter Option
12484
12485 =over 4
12486
12487 =item Filter-related changes at Encode version 1.87
12488
12489 =back
12490
12491 =item CAVEATS
12492
12493 =over 4
12494
12495 =item NOT SCOPED
12496
12497 =item DO NOT MIX MULTIPLE ENCODINGS
12498
12499 =item tr/// with ranges
12500
12501 Legend of characters above
12502
12503 =back
12504
12505 =item EXAMPLE - Greekperl
12506
12507 =item KNOWN PROBLEMS
12508
12509 literals in regex that are longer than 127 bytes, EBCDIC, format
12510
12511 =item HISTORY
12512
12513 =item SEE ALSO
12514
12515 =back
12516
12517 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12518
12519 =over 4
12520
12521 =item SYNOPSIS
12522
12523 =item ABSTRACT
12524
12525 =item Description
12526
12527 =over 4
12528
12529 =item Predefined Methods
12530
12531 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12532 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12533 $e-E<gt>bytes([$encoding])
12534
12535 =item Example: base64 transcoder
12536
12537 =item Operator Overloading
12538
12539 =back
12540
12541 =item SEE ALSO
12542
12543 =back
12544
12545 =head2 English - use nice English (or awk) names for ugly punctuation
12546 variables
12547
12548 =over 4
12549
12550 =item SYNOPSIS
12551
12552 =item DESCRIPTION
12553
12554 =item PERFORMANCE
12555
12556 =back
12557
12558 =head2 Env - perl module that imports environment variables as scalars or
12559 arrays
12560
12561 =over 4
12562
12563 =item SYNOPSIS
12564
12565 =item DESCRIPTION
12566
12567 =item LIMITATIONS
12568
12569 =item AUTHOR
12570
12571 =back
12572
12573 =head2 Errno - System errno constants
12574
12575 =over 4
12576
12577 =item SYNOPSIS
12578
12579 =item DESCRIPTION
12580
12581 =item CAVEATS
12582
12583 =item AUTHOR
12584
12585 =item COPYRIGHT
12586
12587 =back
12588
12589 =head2 Exporter - Implements default import method for modules
12590
12591 =over 4
12592
12593 =item SYNOPSIS
12594
12595 =item DESCRIPTION
12596
12597 =over 4
12598
12599 =item How to Export
12600
12601 =item Selecting What To Export
12602
12603 =item How to Import
12604
12605 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12606
12607 =back
12608
12609 =item Advanced features
12610
12611 =over 4
12612
12613 =item Specialised Import Lists
12614
12615 =item Exporting without using Exporter's import method
12616
12617 =item Module Version Checking
12618
12619 =item Managing Unknown Symbols
12620
12621 =item Tag Handling Utility Functions
12622
12623 =item Generating combined tags
12624
12625 =item C<AUTOLOAD>ed Constants
12626
12627 =back
12628
12629 =back
12630
12631 =head2 Exporter::Heavy - Exporter guts
12632
12633 =over 4
12634
12635 =item SYNOPSIS
12636
12637 =item DESCRIPTION
12638
12639 =back
12640
12641 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12642 Makefiles etc.
12643
12644 =over 4
12645
12646 =item SYNOPSIS
12647
12648 =item DESCRIPTION
12649
12650 =back
12651
12652 cat
12653
12654 eqtime src dst
12655
12656 rm_rf files...
12657
12658 rm_f files...
12659
12660 touch files ..
12661
12662 mv source... destination
12663
12664 cp source... destination
12665
12666 chmod mode files..
12667
12668 mkpath directory..
12669
12670 test_f file
12671
12672 =over 4
12673
12674 =item BUGS
12675
12676 =item SEE ALSO
12677
12678 =item AUTHOR
12679
12680 =back
12681
12682 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12683
12684 =over 4
12685
12686 =item SYNOPSIS
12687
12688 =item DESCRIPTION
12689
12690 B<test_harness>
12691
12692 =back
12693
12694 B<pod2man>
12695
12696 B<warn_if_old_packlist>
12697
12698 B<perllocal_install>
12699
12700 B<uninstall>
12701
12702 =head2 ExtUtils::Constant - generate XS code to import C header constants
12703
12704 =over 4
12705
12706 =item SYNOPSIS
12707
12708 =item DESCRIPTION
12709
12710 =item USAGE
12711
12712 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12713
12714 =item FUNCTIONS
12715
12716 =back
12717
12718 C_stringify NAME
12719
12720 perl_stringify NAME
12721
12722 constant_types
12723
12724 memEQ_clause NAME, CHECKED_AT, INDENT
12725
12726 assign INDENT, TYPE, PRE, POST, VALUE..
12727
12728 return_clause
12729
12730 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12731
12732 params WHAT
12733
12734 dump_names
12735
12736 dogfood
12737
12738 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12739 def_post, utf8
12740
12741 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12742
12743 autoload PACKAGE, VERSION, AUTOLOADER
12744
12745 WriteMakefileSnippet
12746
12747 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12748 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12749
12750 =over 4
12751
12752 =item AUTHOR
12753
12754 =back
12755
12756 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12757
12758 =over 4
12759
12760 =item SYNOPSIS
12761
12762 =item DESCRIPTION
12763
12764 =item @EXPORT
12765
12766 =item FUNCTIONS
12767
12768 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12769 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12770
12771 =item EXAMPLES
12772
12773 =item SEE ALSO
12774
12775 =item AUTHOR
12776
12777 =back
12778
12779 =head2 ExtUtils::Install - install files from here to there
12780
12781 =over 4
12782
12783 =item SYNOPSIS
12784
12785 =item DESCRIPTION
12786
12787 =over 4
12788
12789 =item Functions
12790
12791 B<install>
12792
12793 =back
12794
12795 =back
12796
12797 B<install_default> I<DISCOURAGED>
12798
12799 B<uninstall>
12800
12801 B<pm_to_blib>
12802
12803 _autosplit
12804
12805 =over 4
12806
12807 =item ENVIRONMENT
12808
12809 B<PERL_INSTALL_ROOT>
12810
12811 =item AUTHOR
12812
12813 =item LICENSE
12814
12815 =back
12816
12817 =head2 ExtUtils::Installed - Inventory management of installed modules
12818
12819 =over 4
12820
12821 =item SYNOPSIS
12822
12823 =item DESCRIPTION
12824
12825 =item USAGE
12826
12827 =item FUNCTIONS
12828
12829 new(), modules(), files(), directories(), directory_tree(), validate(),
12830 packlist(), version()
12831
12832 =item EXAMPLE
12833
12834 =item AUTHOR
12835
12836 =back
12837
12838 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12839
12840 =over 4
12841
12842 =item SYNOPSIS
12843
12844 =item DESCRIPTION
12845
12846 For static extensions, For dynamic extensions at build/link time, For
12847 dynamic extensions at load time
12848
12849 =over 4
12850
12851 =item EXTRALIBS
12852
12853 =item LDLOADLIBS and LD_RUN_PATH
12854
12855 =item BSLOADLIBS
12856
12857 =back
12858
12859 =item PORTABILITY
12860
12861 =over 4
12862
12863 =item VMS implementation
12864
12865 =item Win32 implementation
12866
12867 =back
12868
12869 =item SEE ALSO
12870
12871 =back
12872
12873 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12874
12875 =over 4
12876
12877 =item SYNOPSIS
12878
12879 =item DESCRIPTION
12880
12881 =back
12882
12883 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12884
12885 =over 4
12886
12887 =item SYNOPSIS
12888
12889 =item DESCRIPTION
12890
12891 =item Inherently Cross-Platform Methods
12892
12893 installvars
12894
12895 =back
12896
12897 os_flavor_is
12898
12899 =over 4
12900
12901 =item File::Spec wrappers
12902
12903 catfile
12904
12905 =back
12906
12907 =over 4
12908
12909 =item Thought To Be Cross-Platform Methods
12910
12911 B<split_command>
12912
12913 =back
12914
12915 B<echo>
12916
12917 init_VERSION
12918
12919 wraplist
12920
12921 manifypods
12922
12923 manifypods_target
12924
12925 makemakerdflt_target
12926
12927 special_targets
12928
12929 POD2MAN_EXE_macro
12930
12931 test_via_harness
12932
12933 test_via_script
12934
12935 libscan
12936
12937 tool_autosplit
12938
12939 all_target
12940
12941 metafile_target
12942
12943 metafile_addtomanifest_target
12944
12945 =over 4
12946
12947 =item Abstract methods
12948
12949 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
12950 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
12951 platform_constants
12952
12953 =back
12954
12955 os_flavor
12956
12957 =over 4
12958
12959 =item AUTHOR
12960
12961 =back
12962
12963 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12964 ExtUtils::MakeMaker
12965
12966 =over 4
12967
12968 =item SYNOPSIS
12969
12970 =item DESCRIPTION
12971
12972 =back
12973
12974 os_flavor (o)
12975
12976 init_linker
12977
12978 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12979 ExtUtils::MakeMaker
12980
12981 =over 4
12982
12983 =item SYNOPSIS
12984
12985 =item DESCRIPTION
12986
12987 os_flavor (o)
12988
12989 =back
12990
12991 cflags (o)
12992
12993 replace_manpage_separator (o)
12994
12995 init_linker
12996
12997 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12998
12999 =over 4
13000
13001 =item SYNOPSIS
13002
13003 =item DESCRIPTION
13004
13005 =over 4
13006
13007 =item Overridden methods
13008
13009 os_flavor
13010
13011 =back
13012
13013 =back
13014
13015 B<replace_manpage_separator>
13016
13017 =over 4
13018
13019 =item AUTHOR
13020
13021 =item SEE ALSO
13022
13023 =back
13024
13025 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13026 ExtUtils::MakeMaker
13027
13028 =over 4
13029
13030 =item SYNOPSIS
13031
13032 =item DESCRIPTION
13033
13034 =back
13035
13036 maybe_command
13037
13038 guess_name
13039
13040 macify
13041
13042 patternify
13043
13044 init_main
13045
13046 init_others
13047
13048 init_platform, platform_constants
13049
13050 init_dirscan
13051
13052 init_VERSION (o)
13053
13054 special_targets (o)
13055
13056 static (o)
13057
13058 dlsyms (o)
13059
13060 dynamic (o)
13061
13062 clean (o)
13063
13064 clean_subdirs_target
13065
13066 realclean (o)
13067
13068 realclean_subdirs_target
13069
13070 rulez (o)
13071
13072 processPL (o)
13073
13074 os_flavor
13075
13076 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13077 ExtUtils::MakeMaker
13078
13079 =over 4
13080
13081 =item SYNOPSIS
13082
13083 =item DESCRIPTION
13084
13085 =back
13086
13087 os_flavor
13088
13089 init_platform (o), platform_constants
13090
13091 const_cccmd (o)
13092
13093 static_lib (o)
13094
13095 dynamic_lib (o)
13096
13097 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13098 ExtUtils::MakeMaker
13099
13100 =over 4
13101
13102 =item SYNOPSIS
13103
13104 =item DESCRIPTION
13105
13106 =item METHODS
13107
13108 init_dist (o)
13109
13110 =back
13111
13112 init_linker
13113
13114 os_flavor
13115
13116 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13117
13118 =over 4
13119
13120 =item SYNOPSIS
13121
13122 =item DESCRIPTION
13123
13124 =over 4
13125
13126 =item Overridden methods
13127
13128 os_flavor
13129
13130 =back
13131
13132 =back
13133
13134 B<replace_manpage_separator>
13135
13136 =over 4
13137
13138 =item AUTHOR
13139
13140 =item SEE ALSO
13141
13142 =back
13143
13144 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13145
13146 =over 4
13147
13148 =item SYNOPSIS
13149
13150 =item DESCRIPTION
13151
13152 =item METHODS
13153
13154 =back
13155
13156 =over 4
13157
13158 =item Methods
13159
13160 os_flavor (o)
13161
13162 =back
13163
13164 c_o (o)
13165
13166 cflags (o)
13167
13168 clean (o)
13169
13170 clean_subdirs_target
13171
13172 const_cccmd (o)
13173
13174 const_config (o)
13175
13176 const_loadlibs (o)
13177
13178 constants (o)
13179
13180 depend (o)
13181
13182 dir_target (o)
13183
13184 init_DEST
13185
13186 init_dist
13187
13188 dist (o)
13189
13190 dist_basics (o)
13191
13192 dist_ci (o)
13193
13194 dist_core (o)
13195
13196 B<dist_target>
13197
13198 B<tardist_target>
13199
13200 B<zipdist_target>
13201
13202 B<tarfile_target>
13203
13204 zipfile_target
13205
13206 uutardist_target
13207
13208 shdist_target
13209
13210 distdir
13211
13212 dist_test
13213
13214 dlsyms (o)
13215
13216 dynamic (o)
13217
13218 dynamic_bs (o)
13219
13220 dynamic_lib (o)
13221
13222 exescan
13223
13224 extliblist
13225
13226 find_perl
13227
13228 find_tests
13229
13230 =over 4
13231
13232 =item Methods to actually produce chunks of text for the Makefile
13233
13234 fixin
13235
13236 =back
13237
13238 force (o)
13239
13240 guess_name
13241
13242 has_link_code
13243
13244 init_dirscan
13245
13246 init_DIRFILESEP
13247
13248 init_main
13249
13250 init_others
13251
13252 init_INST
13253
13254 init_INSTALL
13255
13256 init_linker
13257
13258 init_lib2arch
13259
13260 init_PERL
13261
13262 init_platform (o), platform_constants (o)
13263
13264 init_PERM
13265
13266 init_xs
13267
13268 install (o)
13269
13270 installbin (o)
13271
13272 linkext (o)
13273
13274 lsdir
13275
13276 macro (o)
13277
13278 makeaperl (o)
13279
13280 makefile (o)
13281
13282 maybe_command
13283
13284 needs_linking (o)
13285
13286 nicetext
13287
13288 parse_abstract
13289
13290 parse_version
13291
13292 pasthru (o)
13293
13294 perl_script
13295
13296 perldepend (o)
13297
13298 perm_rw (o)
13299
13300 perm_rwx (o)
13301
13302 pm_to_blib
13303
13304 post_constants (o)
13305
13306 post_initialize (o)
13307
13308 postamble (o)
13309
13310 ppd
13311
13312 prefixify
13313
13314 processPL (o)
13315
13316 quote_paren
13317
13318 realclean (o)
13319
13320 realclean_subdirs_target
13321
13322 replace_manpage_separator
13323
13324 oneliner (o)
13325
13326 quote_literal
13327
13328 escape_newlines
13329
13330 max_exec_len
13331
13332 static (o)
13333
13334 static_lib (o)
13335
13336 staticmake (o)
13337
13338 subdir_x (o)
13339
13340 subdirs (o)
13341
13342 test (o)
13343
13344 test_via_harness (override)
13345
13346 test_via_script (override)
13347
13348 tools_other (o)
13349
13350 tool_xsubpp (o)
13351
13352 all_target
13353
13354 top_targets (o)
13355
13356 writedoc
13357
13358 xs_c (o)
13359
13360 xs_cpp (o)
13361
13362 xs_o (o)
13363
13364 =over 4
13365
13366 =item SEE ALSO
13367
13368 =back
13369
13370 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13371 ExtUtils::MakeMaker
13372
13373 =over 4
13374
13375 =item SYNOPSIS
13376
13377 =item DESCRIPTION
13378
13379 =over 4
13380
13381 =item Methods always loaded
13382
13383 wraplist
13384
13385 =back
13386
13387 =back
13388
13389 =over 4
13390
13391 =item Methods
13392
13393 guess_name (override)
13394
13395 =back
13396
13397 find_perl (override)
13398
13399 maybe_command (override)
13400
13401 perl_script (override)
13402
13403 replace_manpage_separator
13404
13405 init_DEST
13406
13407 init_DIRFILESEP
13408
13409 init_main (override)
13410
13411 init_others (override)
13412
13413 init_platform (override)
13414
13415 platform_constants
13416
13417 init_VERSION (override)
13418
13419 constants (override)
13420
13421 special_targets
13422
13423 cflags (override)
13424
13425 const_cccmd (override)
13426
13427 tool_sxubpp (override)
13428
13429 tools_other (override)
13430
13431 init_dist (override)
13432
13433 c_o (override)
13434
13435 xs_c (override)
13436
13437 xs_o (override)
13438
13439 dlsyms (override)
13440
13441 dynamic_lib (override)
13442
13443 dynamic_bs (override)
13444
13445 static_lib (override)
13446
13447 processPL (override)
13448
13449 installbin (override)
13450
13451 subdir_x (override)
13452
13453 clean (override)
13454
13455 clean_subdirs_target
13456
13457 realclean (override)
13458
13459 zipfile_target (o), tarfile_target (o), shdist_target (o)
13460
13461 dist_test (override)
13462
13463 install (override)
13464
13465 perldepend (override)
13466
13467 makefile (override)
13468
13469 find_tests (override)
13470
13471 test (override)
13472
13473 makeaperl (override)
13474
13475 nicetext (override)
13476
13477 prefixify (override)
13478
13479 oneliner (o)
13480
13481 B<echo> (o)
13482
13483 quote_literal
13484
13485 escape_newlines
13486
13487 max_exec_len
13488
13489 init_linker (o)
13490
13491 eliminate_macros
13492
13493 fixpath
13494
13495 os_flavor
13496
13497 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13498 ExtUtils::MakeMaker
13499
13500 =over 4
13501
13502 =item SYNOPSIS
13503
13504 =item DESCRIPTION
13505
13506 =back
13507
13508 =over 4
13509
13510 =item Overridden methods
13511
13512 B<dlsyms>
13513
13514 =back
13515
13516 replace_manpage_separator
13517
13518 B<maybe_command>
13519
13520 B<find_tests>
13521
13522 B<init_DIRFILESEP>
13523
13524 B<init_others>
13525
13526 init_platform (o), platform_constants (o)
13527
13528 special_targets (o)
13529
13530 static_lib (o)
13531
13532 dynamic_lib (o)
13533
13534 clean
13535
13536 init_linker
13537
13538 perl_script
13539
13540 xs_o (o)
13541
13542 pasthru (o)
13543
13544 oneliner (o)
13545
13546 max_exec_len
13547
13548 os_flavor
13549
13550 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13551
13552 =over 4
13553
13554 =item SYNOPSIS
13555
13556 =item DESCRIPTION
13557
13558 =over 4
13559
13560 =item Overriden methods
13561
13562 dist_test
13563
13564 =back
13565
13566 =back
13567
13568 subdir_x
13569
13570 xs_c
13571
13572 xs_cpp
13573
13574 xs_o
13575
13576 clean_subdirs_target
13577
13578 realclean_subdirs_target
13579
13580 max_exec_len
13581
13582 os_flavor
13583
13584 =over 4
13585
13586 =item AUTHOR
13587
13588 =back
13589
13590 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13591
13592 =over 4
13593
13594 =item SYNOPSIS
13595
13596 =item DESCRIPTION
13597
13598 =back
13599
13600 =head2 ExtUtils::MakeMaker - Create a module Makefile
13601
13602 =over 4
13603
13604 =item SYNOPSIS
13605
13606 =item DESCRIPTION
13607
13608 =over 4
13609
13610 =item How To Write A Makefile.PL
13611
13612 =item Default Makefile Behaviour
13613
13614 =item make test
13615
13616 =item make testdb
13617
13618 =item make install
13619
13620 =item PREFIX and LIB attribute
13621
13622 =item AFS users
13623
13624 =item Static Linking of a new Perl Binary
13625
13626 =item Determination of Perl Library and Installation Locations
13627
13628 =item Which architecture dependent directory?
13629
13630 =item Using Attributes and Parameters
13631
13632 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13633 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13634 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13635 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13636 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13637 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13638 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13639 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13640 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13641 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13642 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13643 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
13644 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13645 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
13646 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13647 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13648 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
13649 VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
13650
13651 =item Additional lowercase attributes
13652
13653 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
13654 test, tool_autosplit
13655
13656 =item Overriding MakeMaker Methods
13657
13658 =item The End Of Cargo Cult Programming
13659
13660 C<<MAN3PODS => ' '>>
13661
13662 =item Hintsfile support
13663
13664 =item Distribution Support
13665
13666    make distcheck,    make skipcheck,    make distclean,    make manifest,
13667   make distdir,   make disttest,    make tardist,    make dist,    make
13668 uutardist,    make shdist,    make zipdist,    make ci
13669
13670 =item Module Meta-Data
13671
13672 =item Disabling an extension
13673
13674 =item Other Handy Functions
13675
13676 prompt
13677
13678 =back
13679
13680 =item ENVIRONMENT
13681
13682 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13683
13684 =item SEE ALSO
13685
13686 =item AUTHORS
13687
13688 =item LICENSE
13689
13690 =back
13691
13692 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
13693 MakeMaker
13694
13695 =over 4
13696
13697 =item DESCRIPTION
13698
13699 =over 4
13700
13701 =item Philosophy and History
13702
13703 Why not just use <insert other build config tool here>?, What's
13704 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
13705 shell commands, easier to customize, cleaner internals, less cruft
13706
13707 =item Module Writing
13708
13709 How do I keep my $VERSION up to date without resetting it manually?, What's
13710 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
13711
13712 =item XS
13713
13714 How to I prevent "object version X.XX does not match bootstrap parameter
13715 Y.YY" errors?, How do I make two or more XS files coexist in the same
13716 directory?
13717
13718 =back
13719
13720 =item PATCHING
13721
13722 =item AUTHOR
13723
13724 =item SEE ALSO
13725
13726 =back
13727
13728 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
13729
13730 =over 4
13731
13732 =item SYNOPSIS
13733
13734 =item DESCRIPTION
13735
13736 =over 4
13737
13738 =item The Mantra
13739
13740 =item The Layout
13741
13742 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
13743 bin/
13744
13745 =back
13746
13747 =item SEE ALSO
13748
13749 =back
13750
13751 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
13752
13753 =over 4
13754
13755 =item SYNOPSIS
13756
13757 =item DESCRIPTION
13758
13759 =back
13760
13761 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
13762
13763 =over 4
13764
13765 =item SYNOPSIS
13766
13767 =item DESCRIPTION
13768
13769 =back
13770
13771 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13772
13773 =over 4
13774
13775 =item SYNOPSIS
13776
13777 =item DESCRIPTION
13778
13779 =over 4
13780
13781 =item Functions
13782
13783 mkmanifest
13784
13785 =back
13786
13787 =back
13788
13789 manifind
13790
13791 manicheck
13792
13793 filecheck
13794
13795 fullcheck
13796
13797 skipcheck
13798
13799 maniread
13800
13801 manicopy
13802
13803 maniadd
13804
13805 =over 4
13806
13807 =item MANIFEST
13808
13809 =item MANIFEST.SKIP
13810
13811 =item EXPORT_OK
13812
13813 =item GLOBAL VARIABLES
13814
13815 =back
13816
13817 =over 4
13818
13819 =item DIAGNOSTICS
13820
13821 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13822 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13823
13824 =item ENVIRONMENT
13825
13826 B<PERL_MM_MANIFEST_DEBUG>
13827
13828 =item SEE ALSO
13829
13830 =item AUTHOR
13831
13832 =back
13833
13834 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13835
13836 =over 4
13837
13838 =item SYNOPSIS
13839
13840 =item DESCRIPTION
13841
13842 =back
13843
13844 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13845 extension
13846
13847 =over 4
13848
13849 =item SYNOPSIS
13850
13851 =item DESCRIPTION
13852
13853 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13854
13855 =item AUTHOR
13856
13857 =item REVISION
13858
13859 =back
13860
13861 =head2 ExtUtils::Packlist - manage .packlist files
13862
13863 =over 4
13864
13865 =item SYNOPSIS
13866
13867 =item DESCRIPTION
13868
13869 =item USAGE
13870
13871 =item FUNCTIONS
13872
13873 new(), read(), write(), validate(), packlist_file()
13874
13875 =item EXAMPLE
13876
13877 =item AUTHOR
13878
13879 =back
13880
13881 =head2 ExtUtils::testlib - add blib/* directories to @INC
13882
13883 =over 4
13884
13885 =item SYNOPSIS
13886
13887 =item DESCRIPTION
13888
13889 =back
13890
13891 =head2 Fatal - replace functions with equivalents which succeed or die
13892
13893 =over 4
13894
13895 =item SYNOPSIS
13896
13897 =item DESCRIPTION
13898
13899 =item AUTHOR
13900
13901 =back
13902
13903 =head2 Fcntl - load the C Fcntl.h defines
13904
13905 =over 4
13906
13907 =item SYNOPSIS
13908
13909 =item DESCRIPTION
13910
13911 =item NOTE
13912
13913 =item EXPORTED SYMBOLS
13914
13915 =back
13916
13917 =head2 File::Basename, fileparse - split a pathname into pieces
13918
13919 =over 4
13920
13921 =item SYNOPSIS
13922
13923 =item DESCRIPTION
13924
13925 fileparse_set_fstype, fileparse
13926
13927 =item EXAMPLES
13928
13929 C<basename>, C<dirname>
13930
13931 =back
13932
13933 =head2 File::CheckTree, validate - run many filetest checks on a tree
13934
13935 =over 4
13936
13937 =item SYNOPSIS
13938
13939 =item DESCRIPTION
13940
13941 =item AUTHOR
13942
13943 =item HISTORY
13944
13945 =back
13946
13947 =head2 File::Compare - Compare files or filehandles
13948
13949 =over 4
13950
13951 =item SYNOPSIS
13952
13953 =item DESCRIPTION
13954
13955 =item RETURN
13956
13957 =item AUTHOR
13958
13959 =back
13960
13961 =head2 File::Copy - Copy files or filehandles
13962
13963 =over 4
13964
13965 =item SYNOPSIS
13966
13967 =item DESCRIPTION
13968
13969 =over 4
13970
13971 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13972
13973 rmscopy($from,$to[,$date_flag])
13974
13975 =back
13976
13977 =item RETURN
13978
13979 =item NOTES
13980
13981 =item AUTHOR
13982
13983 =back
13984
13985 =head2 File::DosGlob - DOS like globbing and then some
13986
13987 =over 4
13988
13989 =item SYNOPSIS
13990
13991 =item DESCRIPTION
13992
13993 =item NOTES
13994
13995 =item EXPORTS (by request only)
13996
13997 =item BUGS
13998
13999 =item AUTHOR
14000
14001 =item HISTORY
14002
14003 =item SEE ALSO
14004
14005 =back
14006
14007 =head2 File::Find - Traverse a directory tree.
14008
14009 =over 4
14010
14011 =item SYNOPSIS
14012
14013 =item DESCRIPTION
14014
14015 B<find>, B<finddepth>
14016
14017 =over 4
14018
14019 =item %options
14020
14021 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14022 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14023 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14024
14025 =item The wanted function
14026
14027 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14028 filename within that directory, C<$File::Find::name> is the complete
14029 pathname to the file
14030
14031 =back
14032
14033 =item WARNINGS
14034
14035 =item CAVEAT
14036
14037 $dont_use_nlink, symlinks
14038
14039 =item NOTES
14040
14041 =item HISTORY
14042
14043 =back
14044
14045 =head2 File::Glob - Perl extension for BSD glob routine
14046
14047 =over 4
14048
14049 =item SYNOPSIS
14050
14051 =item DESCRIPTION
14052
14053 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14054 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14055 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14056
14057 =item DIAGNOSTICS
14058
14059 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14060
14061 =item NOTES
14062
14063 =item AUTHOR
14064
14065 =back
14066
14067 =head2 File::Path - create or remove directory trees
14068
14069 =over 4
14070
14071 =item SYNOPSIS
14072
14073 =item DESCRIPTION
14074
14075 =item DIAGNOSTICS
14076
14077 =item AUTHORS
14078
14079 =back
14080
14081 =head2 File::Spec - portably perform operations on file names
14082
14083 =over 4
14084
14085 =item SYNOPSIS
14086
14087 =item DESCRIPTION
14088
14089 =item METHODS
14090
14091 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14092 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14093 splitdir, catpath(), abs2rel, rel2abs()
14094
14095 =item SEE ALSO
14096
14097 =item AUTHORS
14098
14099 =back
14100
14101 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14102
14103 =over 4
14104
14105 =item SYNOPSIS
14106
14107 =item DESCRIPTION
14108
14109 =back
14110
14111 canonpath
14112
14113 file_name_is_absolute
14114
14115 tmpdir (override)
14116
14117 =head2 File::Spec::Epoc - methods for Epoc file specs
14118
14119 =over 4
14120
14121 =item SYNOPSIS
14122
14123 =item DESCRIPTION
14124
14125 =item AUTHORS
14126
14127 =back
14128
14129 canonpath()
14130
14131 =over 4
14132
14133 =item SEE ALSO
14134
14135 =back
14136
14137 =head2 File::Spec::Functions - portably perform operations on file names
14138
14139 =over 4
14140
14141 =item SYNOPSIS
14142
14143 =item DESCRIPTION
14144
14145 =over 4
14146
14147 =item Exports
14148
14149 =back
14150
14151 =item SEE ALSO
14152
14153 =back
14154
14155 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14156
14157 =over 4
14158
14159 =item SYNOPSIS
14160
14161 =item DESCRIPTION
14162
14163 =item METHODS
14164
14165 canonpath
14166
14167 =back
14168
14169 catdir()
14170
14171 catfile
14172
14173 curdir
14174
14175 devnull
14176
14177 rootdir
14178
14179 tmpdir
14180
14181 updir
14182
14183 file_name_is_absolute
14184
14185 path
14186
14187 splitpath
14188
14189 splitdir
14190
14191 catpath
14192
14193 abs2rel
14194
14195 rel2abs
14196
14197 =over 4
14198
14199 =item AUTHORS
14200
14201 =item SEE ALSO
14202
14203 =back
14204
14205 tmpdir
14206
14207 canonpath
14208
14209 splitpath
14210
14211 splitdir
14212
14213 catpath
14214
14215 =head2 File::Spec::OS2 - methods for OS/2 file specs
14216
14217 =over 4
14218
14219 =item SYNOPSIS
14220
14221 =item DESCRIPTION
14222
14223 =back
14224
14225 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14226 modules
14227
14228 =over 4
14229
14230 =item SYNOPSIS
14231
14232 =item DESCRIPTION
14233
14234 =item METHODS
14235
14236 canonpath()
14237
14238 =back
14239
14240 catdir()
14241
14242 catfile
14243
14244 curdir
14245
14246 devnull
14247
14248 rootdir
14249
14250 tmpdir
14251
14252 updir
14253
14254 no_upwards
14255
14256 case_tolerant
14257
14258 file_name_is_absolute
14259
14260 path
14261
14262 join
14263
14264 splitpath
14265
14266 splitdir
14267
14268 catpath()
14269
14270 abs2rel
14271
14272 rel2abs()
14273
14274 =over 4
14275
14276 =item SEE ALSO
14277
14278 =back
14279
14280 =head2 File::Spec::VMS - methods for VMS file specs
14281
14282 =over 4
14283
14284 =item SYNOPSIS
14285
14286 =item DESCRIPTION
14287
14288 eliminate_macros
14289
14290 =back
14291
14292 fixpath
14293
14294 =over 4
14295
14296 =item Methods always loaded
14297
14298 canonpath (override)
14299
14300 =back
14301
14302 catdir
14303
14304 catfile
14305
14306 curdir (override)
14307
14308 devnull (override)
14309
14310 rootdir (override)
14311
14312 tmpdir (override)
14313
14314 updir (override)
14315
14316 case_tolerant (override)
14317
14318 path (override)
14319
14320 file_name_is_absolute (override)
14321
14322 splitpath (override)
14323
14324 splitdir (override)
14325
14326 catpath (override)
14327
14328 abs2rel (override)
14329
14330 rel2abs (override)
14331
14332 =over 4
14333
14334 =item SEE ALSO
14335
14336 =back
14337
14338 =head2 File::Spec::Win32 - methods for Win32 file specs
14339
14340 =over 4
14341
14342 =item SYNOPSIS
14343
14344 =item DESCRIPTION
14345
14346 devnull
14347
14348 =back
14349
14350 tmpdir
14351
14352 catfile
14353
14354 canonpath
14355
14356 splitpath
14357
14358 splitdir
14359
14360 catpath
14361
14362 =over 4
14363
14364 =item Note For File::Spec::Win32 Maintainers
14365
14366 =back
14367
14368 =over 4
14369
14370 =item SEE ALSO
14371
14372 =back
14373
14374 =head2 File::Temp - return name and handle of a temporary file safely
14375
14376 =over 4
14377
14378 =item PORTABILITY
14379
14380 =item SYNOPSIS
14381
14382 =item DESCRIPTION
14383
14384 =back
14385
14386 =over 4
14387
14388 =item FUNCTIONS
14389
14390 B<tempfile>
14391
14392 =back
14393
14394 B<tempdir>
14395
14396 =over 4
14397
14398 =item MKTEMP FUNCTIONS
14399
14400 B<mkstemp>
14401
14402 =back
14403
14404 B<mkstemps>
14405
14406 B<mkdtemp>
14407
14408 B<mktemp>
14409
14410 =over 4
14411
14412 =item POSIX FUNCTIONS
14413
14414 B<tmpnam>
14415
14416 =back
14417
14418 B<tmpfile>
14419
14420 =over 4
14421
14422 =item ADDITIONAL FUNCTIONS
14423
14424 B<tempnam>
14425
14426 =back
14427
14428 =over 4
14429
14430 =item UTILITY FUNCTIONS
14431
14432 B<unlink0>
14433
14434 =back
14435
14436 =over 4
14437
14438 =item PACKAGE VARIABLES
14439
14440 B<safe_level>, STANDARD, MEDIUM, HIGH
14441
14442 =back
14443
14444 TopSystemUID
14445
14446 =over 4
14447
14448 =item WARNING
14449
14450 =over 4
14451
14452 =item Temporary files and NFS
14453
14454 =back
14455
14456 =item HISTORY
14457
14458 =item SEE ALSO
14459
14460 =item AUTHOR
14461
14462 =back
14463
14464 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14465
14466 =over 4
14467
14468 =item SYNOPSIS
14469
14470 =item DESCRIPTION
14471
14472 =item BUGS
14473
14474 =item NOTE
14475
14476 =item AUTHOR
14477
14478 =back
14479
14480 =head2 FileCache - keep more files open than the system permits
14481
14482 =over 4
14483
14484 =item SYNOPSIS
14485
14486 =item DESCRIPTION
14487
14488 cacheout EXPR, cacheout MODE, EXPR
14489
14490 =item CAVEATS
14491
14492 =item BUGS
14493
14494 =item NOTES
14495
14496 =back
14497
14498 =head2 FileHandle - supply object methods for filehandles
14499
14500 =over 4
14501
14502 =item SYNOPSIS
14503
14504 =item DESCRIPTION
14505
14506 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14507
14508 =item SEE ALSO
14509
14510 =back
14511
14512 =head2 Filter::Simple - Simplified source filtering
14513
14514 =over 4
14515
14516 =item SYNOPSIS
14517
14518 =item DESCRIPTION
14519
14520 =over 4
14521
14522 =item The Problem
14523
14524 =item A Solution
14525
14526 =item Disabling or changing <no> behaviour
14527
14528 =item All-in-one interface
14529
14530 =item Filtering only specific components of source code
14531
14532 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14533 C<"all">
14534
14535 =item Filtering only the code parts of source code
14536
14537 Most source code ceases to be grammatically correct when it is broken up
14538 into the pieces between string literals and regexes. So the C<'code'>
14539 component filter behaves slightly differently from the other partial
14540 filters
14541 described in the previous section.
14542
14543 =item Using Filter::Simple with an explicit C<import> subroutine
14544
14545 =item Using Filter::Simple and Exporter together
14546
14547 =item How it works
14548
14549 =back
14550
14551 =item AUTHOR
14552
14553 =item COPYRIGHT
14554
14555 =back
14556
14557 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14558
14559 =over 4
14560
14561 =item SYNOPSIS
14562
14563 =item DESCRIPTION
14564
14565 =over 4
14566
14567 =item B<use Filter::Util::Call>
14568
14569 =item B<import()>
14570
14571 =item B<filter() and anonymous sub>
14572
14573 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14574
14575 =back
14576
14577 =item EXAMPLES
14578
14579 =over 4
14580
14581 =item Example 1: A simple filter.
14582
14583 =item Example 2: Using the context
14584
14585 =item Example 3: Using the context within the filter
14586
14587 =item Example 4: Using filter_del
14588
14589 =back
14590
14591 =item Filter::Simple
14592
14593 =item AUTHOR
14594
14595 =item DATE
14596
14597 =back
14598
14599 =head2 FindBin - Locate directory of original perl script
14600
14601 =over 4
14602
14603 =item SYNOPSIS
14604
14605 =item DESCRIPTION
14606
14607 =item EXPORTABLE VARIABLES
14608
14609 =item KNOWN ISSUES
14610
14611 =item KNOWN BUGS
14612
14613 =item AUTHORS
14614
14615 =item COPYRIGHT
14616
14617 =back
14618
14619 =head2 GDBM_File - Perl5 access to the gdbm library.
14620
14621 =over 4
14622
14623 =item SYNOPSIS
14624
14625 =item DESCRIPTION
14626
14627 =item AVAILABILITY
14628
14629 =item BUGS
14630
14631 =item SEE ALSO
14632
14633 =back
14634
14635 =head2 Getopt::Long - Extended processing of command line options
14636
14637 =over 4
14638
14639 =item SYNOPSIS
14640
14641 =item DESCRIPTION
14642
14643 =item Command Line Options, an Introduction
14644
14645 =item Getting Started with Getopt::Long
14646
14647 =over 4
14648
14649 =item Simple options
14650
14651 =item A little bit less simple options
14652
14653 =item Mixing command line option with other arguments
14654
14655 =item Options with values
14656
14657 =item Options with multiple values
14658
14659 =item Options with hash values
14660
14661 =item User-defined subroutines to handle options
14662
14663 =item Options with multiple names
14664
14665 =item Case and abbreviations
14666
14667 =item Summary of Option Specifications
14668
14669 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
14670 + [ I<desttype> ]
14671
14672 =back
14673
14674 =item Advanced Possibilities
14675
14676 =over 4
14677
14678 =item Object oriented interface
14679
14680 =item Thread Safety
14681
14682 =item Documentation and help texts
14683
14684 =item Storing options in a hash
14685
14686 =item Bundling
14687
14688 =item The lonesome dash
14689
14690 =item Argument callback
14691
14692 =back
14693
14694 =item Configuring Getopt::Long
14695
14696 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
14697 require_order, permute, bundling (default: disabled), bundling_override
14698 (default: disabled), ignore_case  (default: enabled), ignore_case_always
14699 (default: disabled), auto_version (default:disabled), auto_help
14700 (default:disabled), pass_through (default: disabled), prefix,
14701 prefix_pattern, debug (default: disabled)
14702
14703 =item Exportable Methods
14704
14705 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
14706
14707 =item Return values and Errors
14708
14709 =item Legacy
14710
14711 =over 4
14712
14713 =item Default destinations
14714
14715 =item Alternative option starters
14716
14717 =item Configuration variables
14718
14719 =back
14720
14721 =item Trouble Shooting
14722
14723 =over 4
14724
14725 =item Warning: Ignoring '!' modifier for short option
14726
14727 =item GetOptions does not return a false result when an option is not
14728 supplied
14729
14730 =item GetOptions does not split the command line correctly
14731
14732 =item Undefined subroutine &main::GetOptions called
14733
14734 =item How do I put a "-?" option into a Getopt::Long?
14735
14736 =back
14737
14738 =item AUTHOR
14739
14740 =item COPYRIGHT AND DISCLAIMER
14741
14742 =back
14743
14744 =head2 Getopt::Std, getopt - Process single-character switches with switch
14745 clustering
14746
14747 =over 4
14748
14749 =item SYNOPSIS
14750
14751 =item DESCRIPTION
14752
14753 =item C<--help> and C<--version>
14754
14755 =back
14756
14757 =head2 Hash::Util - A selection of general-utility hash subroutines
14758
14759 =over 4
14760
14761 =item SYNOPSIS
14762
14763 =item DESCRIPTION
14764
14765 =over 4
14766
14767 =item Restricted hashes
14768
14769 lock_keys, unlock_keys
14770
14771 =back
14772
14773 =back
14774
14775 lock_value, unlock_value
14776
14777 B<lock_hash>, B<unlock_hash>
14778
14779 =over 4
14780
14781 =item CAVEATS
14782
14783 =item AUTHOR
14784
14785 =item SEE ALSO
14786
14787 =back
14788
14789 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14790 locale
14791
14792 =over 4
14793
14794 =item SYNOPSIS
14795
14796 =item DESCRIPTION
14797
14798 =back
14799
14800 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14801 tags
14802
14803 =over 4
14804
14805 =item SYNOPSIS
14806
14807 =item DESCRIPTION
14808
14809 =back
14810
14811 the function is_language_tag($lang1)
14812
14813 the function extract_language_tags($whatever)
14814
14815 the function same_language_tag($lang1, $lang2)
14816
14817 the function similarity_language_tag($lang1, $lang2)
14818
14819 the function is_dialect_of($lang1, $lang2)
14820
14821 the function super_languages($lang1)
14822
14823 the function locale2language_tag($locale_identifier)
14824
14825 the function encode_language_tag($lang1)
14826
14827 the function alternate_language_tags($lang1)
14828
14829 the function @langs = panic_languages(@accept_languages)
14830
14831 =over 4
14832
14833 =item ABOUT LOWERCASING
14834
14835 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14836
14837 =item SEE ALSO
14838
14839 =item COPYRIGHT
14840
14841 =item AUTHOR
14842
14843 =back
14844
14845 =head2 I18N::LangTags::List -- tags and names for human languages
14846
14847 =over 4
14848
14849 =item SYNOPSIS
14850
14851 =item DESCRIPTION
14852
14853 =item ABOUT LANGUAGE TAGS
14854
14855 =item LIST OF LANGUAGES
14856
14857 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
14858 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
14859 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
14860 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
14861 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
14862 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
14863 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
14864 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
14865 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
14866 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
14867 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
14868 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
14869 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
14870 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
14871 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
14872 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
14873 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
14874 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
14875 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
14876 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
14877 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
14878 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
14879 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
14880 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
14881 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
14882 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
14883 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
14884 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
14885 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
14886 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
14887 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
14888 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
14889 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
14890 English, {enm} : Old English (1100-1500), {ang} : Old English
14891 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
14892 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
14893 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
14894 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
14895 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
14896 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
14897 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
14898 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
14899 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
14900 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
14901 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
14902 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
14903 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14904 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14905 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
14906 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
14907 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
14908 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
14909 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
14910 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
14911 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
14912 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
14913 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
14914 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
14915 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
14916 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
14917 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
14918 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
14919 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
14920 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
14921 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
14922 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
14923 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
14924 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
14925 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
14926 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
14927 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
14928 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
14929 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
14930 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
14931 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
14932 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
14933 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
14934 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
14935 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
14936 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
14937 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14938 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14939 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
14940 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
14941 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
14942 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
14943 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14944 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14945 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14946 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14947 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14948 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14949 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14950 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14951 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14952 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14953 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
14954 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
14955 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
14956 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
14957 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
14958 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
14959 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
14960 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
14961 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
14962 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
14963 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
14964 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
14965 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
14966 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
14967 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
14968 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
14969 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
14970 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
14971 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
14972 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
14973 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
14974 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
14975 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
14976 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
14977 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
14978 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
14979 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
14980 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
14981 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
14982 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
14983 {zun} : Zuni
14984
14985 =item SEE ALSO
14986
14987 =item COPYRIGHT AND DISCLAIMER
14988
14989 =item AUTHOR
14990
14991 =back
14992
14993 =head2 I18N::Langinfo - query locale information
14994
14995 =over 4
14996
14997 =item SYNOPSIS
14998
14999 =item DESCRIPTION
15000
15001 =over 4
15002
15003 =item EXPORT
15004
15005 =back
15006
15007 =item SEE ALSO
15008
15009 =item AUTHOR
15010
15011 =item COPYRIGHT AND LICENSE
15012
15013 =back
15014
15015 =head2 IO - load various IO modules
15016
15017 =over 4
15018
15019 =item SYNOPSIS
15020
15021 =item DESCRIPTION
15022
15023 =item DEPRECATED
15024
15025 =back
15026
15027 =head2 IO::Dir - supply object methods for directory handles
15028
15029 =over 4
15030
15031 =item SYNOPSIS
15032
15033 =item DESCRIPTION
15034
15035 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15036 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15037
15038 =item SEE ALSO
15039
15040 =item AUTHOR
15041
15042 =item COPYRIGHT
15043
15044 =back
15045
15046 =head2 IO::File - supply object methods for filehandles
15047
15048 =over 4
15049
15050 =item SYNOPSIS
15051
15052 =item DESCRIPTION
15053
15054 =item CONSTRUCTOR
15055
15056 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15057
15058 =item METHODS
15059
15060 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15061
15062 =item SEE ALSO
15063
15064 =item HISTORY
15065
15066 =back
15067
15068 =head2 IO::Handle - supply object methods for I/O handles
15069
15070 =over 4
15071
15072 =item SYNOPSIS
15073
15074 =item DESCRIPTION
15075
15076 =item CONSTRUCTOR
15077
15078 new (), new_from_fd ( FD, MODE )
15079
15080 =item METHODS
15081
15082 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15083 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15084 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15085 $io->blocking ( [ BOOL ] ), $io->untaint
15086
15087 =item NOTE
15088
15089 =item SEE ALSO
15090
15091 =item BUGS
15092
15093 =item HISTORY
15094
15095 =back
15096
15097 =head2 IO::Pipe - supply object methods for pipes
15098
15099 =over 4
15100
15101 =item SYNOPSIS
15102
15103 =item DESCRIPTION
15104
15105 =item CONSTRUCTOR
15106
15107 new ( [READER, WRITER] )
15108
15109 =item METHODS
15110
15111 reader ([ARGS]), writer ([ARGS]), handles ()
15112
15113 =item SEE ALSO
15114
15115 =item AUTHOR
15116
15117 =item COPYRIGHT
15118
15119 =back
15120
15121 =head2 IO::Poll - Object interface to system poll call
15122
15123 =over 4
15124
15125 =item SYNOPSIS
15126
15127 =item DESCRIPTION
15128
15129 =item METHODS
15130
15131 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15132 IO ), handles( [ EVENT_MASK ] )
15133
15134 =item SEE ALSO
15135
15136 =item AUTHOR
15137
15138 =item COPYRIGHT
15139
15140 =back
15141
15142 =head2 IO::Seekable - supply seek based methods for I/O objects
15143
15144 =over 4
15145
15146 =item SYNOPSIS
15147
15148 =item DESCRIPTION
15149
15150 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15151 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15152 $io->tell
15153
15154 =item SEE ALSO
15155
15156 =item HISTORY
15157
15158 =back
15159
15160 =head2 IO::Select - OO interface to the select system call
15161
15162 =over 4
15163
15164 =item SYNOPSIS
15165
15166 =item DESCRIPTION
15167
15168 =item CONSTRUCTOR
15169
15170 new ( [ HANDLES ] )
15171
15172 =item METHODS
15173
15174 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15175 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15176 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15177
15178 =item EXAMPLE
15179
15180 =item AUTHOR
15181
15182 =item COPYRIGHT
15183
15184 =back
15185
15186 =head2 IO::Socket - Object interface to socket communications
15187
15188 =over 4
15189
15190 =item SYNOPSIS
15191
15192 =item DESCRIPTION
15193
15194 =item CONSTRUCTOR
15195
15196 new ( [ARGS] )
15197
15198 =item METHODS
15199
15200 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15201 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15202
15203 =item SEE ALSO
15204
15205 =item AUTHOR
15206
15207 =item COPYRIGHT
15208
15209 =back
15210
15211 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15212
15213 =over 4
15214
15215 =item SYNOPSIS
15216
15217 =item DESCRIPTION
15218
15219 =item CONSTRUCTOR
15220
15221 new ( [ARGS] )
15222
15223 =over 4
15224
15225 =item METHODS
15226
15227 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15228 ()
15229
15230 =back
15231
15232 =item SEE ALSO
15233
15234 =item AUTHOR
15235
15236 =item COPYRIGHT
15237
15238 =back
15239
15240 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15241
15242 =over 4
15243
15244 =item SYNOPSIS
15245
15246 =item DESCRIPTION
15247
15248 =item CONSTRUCTOR
15249
15250 new ( [ARGS] )
15251
15252 =item METHODS
15253
15254 hostpath(), peerpath()
15255
15256 =item SEE ALSO
15257
15258 =item AUTHOR
15259
15260 =item COPYRIGHT
15261
15262 =back
15263
15264 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15265 handles
15266
15267 =over 4
15268
15269 =item SYNOPSIS
15270
15271 =item DESCRIPTION
15272
15273 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15274 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15275
15276 =item SEE ALSO
15277
15278 =item AUTHOR
15279
15280 =item COPYRIGHT
15281
15282 =back
15283
15284 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15285
15286 =over 4
15287
15288 =item SYNOPSIS
15289
15290 =item DESCRIPTION
15291
15292 =item CONSTRUCTOR
15293
15294 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15295
15296 =item METHODS
15297
15298 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15299
15300 =item SEE ALSO
15301
15302 =item HISTORY
15303
15304 =back
15305
15306 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15307 handles
15308
15309 =over 4
15310
15311 =item SYNOPSIS
15312
15313 =item DESCRIPTION
15314
15315 =item CONSTRUCTOR
15316
15317 new (), new_from_fd ( FD, MODE )
15318
15319 =item METHODS
15320
15321 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15322 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15323 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15324 $io->blocking ( [ BOOL ] ), $io->untaint
15325
15326 =item NOTE
15327
15328 =item SEE ALSO
15329
15330 =item BUGS
15331
15332 =item HISTORY
15333
15334 =back
15335
15336 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15337
15338 =over 4
15339
15340 =item SYNOPSIS
15341
15342 =item DESCRIPTION
15343
15344 =item CONSTRUCTOR
15345
15346 new ( [READER, WRITER] )
15347
15348 =item METHODS
15349
15350 reader ([ARGS]), writer ([ARGS]), handles ()
15351
15352 =item SEE ALSO
15353
15354 =item AUTHOR
15355
15356 =item COPYRIGHT
15357
15358 =back
15359
15360 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15361
15362 =over 4
15363
15364 =item SYNOPSIS
15365
15366 =item DESCRIPTION
15367
15368 =item METHODS
15369
15370 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15371 IO ), handles( [ EVENT_MASK ] )
15372
15373 =item SEE ALSO
15374
15375 =item AUTHOR
15376
15377 =item COPYRIGHT
15378
15379 =back
15380
15381 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15382 I/O objects
15383
15384 =over 4
15385
15386 =item SYNOPSIS
15387
15388 =item DESCRIPTION
15389
15390 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15391 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15392 $io->tell
15393
15394 =item SEE ALSO
15395
15396 =item HISTORY
15397
15398 =back
15399
15400 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15401 call
15402
15403 =over 4
15404
15405 =item SYNOPSIS
15406
15407 =item DESCRIPTION
15408
15409 =item CONSTRUCTOR
15410
15411 new ( [ HANDLES ] )
15412
15413 =item METHODS
15414
15415 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15416 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15417 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15418
15419 =item EXAMPLE
15420
15421 =item AUTHOR
15422
15423 =item COPYRIGHT
15424
15425 =back
15426
15427 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15428 communications
15429
15430 =over 4
15431
15432 =item SYNOPSIS
15433
15434 =item DESCRIPTION
15435
15436 =item CONSTRUCTOR
15437
15438 new ( [ARGS] )
15439
15440 =item METHODS
15441
15442 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15443 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15444
15445 =item SEE ALSO
15446
15447 =item AUTHOR
15448
15449 =item COPYRIGHT
15450
15451 =back
15452
15453 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15454 AF_INET domain sockets
15455
15456 =over 4
15457
15458 =item SYNOPSIS
15459
15460 =item DESCRIPTION
15461
15462 =item CONSTRUCTOR
15463
15464 new ( [ARGS] )
15465
15466 =over 4
15467
15468 =item METHODS
15469
15470 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15471 ()
15472
15473 =back
15474
15475 =item SEE ALSO
15476
15477 =item AUTHOR
15478
15479 =item COPYRIGHT
15480
15481 =back
15482
15483 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15484 AF_UNIX domain sockets
15485
15486 =over 4
15487
15488 =item SYNOPSIS
15489
15490 =item DESCRIPTION
15491
15492 =item CONSTRUCTOR
15493
15494 new ( [ARGS] )
15495
15496 =item METHODS
15497
15498 hostpath(), peerpath()
15499
15500 =item SEE ALSO
15501
15502 =item AUTHOR
15503
15504 =item COPYRIGHT
15505
15506 =back
15507
15508 =head2 IPC::Msg - SysV Msg IPC object class
15509
15510 =over 4
15511
15512 =item SYNOPSIS
15513
15514 =item DESCRIPTION
15515
15516 =item METHODS
15517
15518 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15519 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15520 FLAGS ] ), stat
15521
15522 =item SEE ALSO
15523
15524 =item AUTHOR
15525
15526 =item COPYRIGHT
15527
15528 =back
15529
15530 =head2 IPC::Open2, open2 - open a process for both reading and writing
15531
15532 =over 4
15533
15534 =item SYNOPSIS
15535
15536 =item DESCRIPTION
15537
15538 =item WARNING
15539
15540 =item SEE ALSO
15541
15542 =back
15543
15544 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15545 handling
15546
15547 =over 4
15548
15549 =item SYNOPSIS
15550
15551 =item DESCRIPTION
15552
15553 =item WARNING
15554
15555 =back
15556
15557 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15558
15559 =over 4
15560
15561 =item SYNOPSIS
15562
15563 =item DESCRIPTION
15564
15565 =item METHODS
15566
15567 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15568 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15569 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15570 , VALUE ), stat
15571
15572 =item SEE ALSO
15573
15574 =item AUTHOR
15575
15576 =item COPYRIGHT
15577
15578 =back
15579
15580 =head2 IPC::SysV - SysV IPC constants
15581
15582 =over 4
15583
15584 =item SYNOPSIS
15585
15586 =item DESCRIPTION
15587
15588 ftok( PATH, ID )
15589
15590 =item SEE ALSO
15591
15592 =item AUTHORS
15593
15594 =item COPYRIGHT
15595
15596 =back
15597
15598 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15599
15600 =over 4
15601
15602 =item SYNOPSIS
15603
15604 =item DESCRIPTION
15605
15606 =item METHODS
15607
15608 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15609 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15610 FLAGS ] ), stat
15611
15612 =item SEE ALSO
15613
15614 =item AUTHOR
15615
15616 =item COPYRIGHT
15617
15618 =back
15619
15620 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15621 class
15622
15623 =over 4
15624
15625 =item SYNOPSIS
15626
15627 =item DESCRIPTION
15628
15629 =item METHODS
15630
15631 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15632 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15633 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15634 , VALUE ), stat
15635
15636 =item SEE ALSO
15637
15638 =item AUTHOR
15639
15640 =item COPYRIGHT
15641
15642 =back
15643
15644 =head2 List::Util - A selection of general-utility list subroutines
15645
15646 =over 4
15647
15648 =item SYNOPSIS
15649
15650 =item DESCRIPTION
15651
15652 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15653 BLOCK LIST, shuffle LIST, sum LIST
15654
15655 =item KNOWN BUGS
15656
15657 =item SUGGESTED ADDITIONS
15658
15659 =item COPYRIGHT
15660
15661 =back
15662
15663 =head2 List::Utilib::List::Util, List::Util - A selection of
15664 general-utility list subroutines
15665
15666 =over 4
15667
15668 =item SYNOPSIS
15669
15670 =item DESCRIPTION
15671
15672 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15673 BLOCK LIST, shuffle LIST, sum LIST
15674
15675 =item KNOWN BUGS
15676
15677 =item SUGGESTED ADDITIONS
15678
15679 =item COPYRIGHT
15680
15681 =back
15682
15683 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
15684 general-utility scalar subroutines
15685
15686 =over 4
15687
15688 =item SYNOPSIS
15689
15690 =item DESCRIPTION
15691
15692 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
15693 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
15694 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
15695
15696 =item KNOWN BUGS
15697
15698 =item COPYRIGHT
15699
15700 =item BLATANT PLUG
15701
15702 =back
15703
15704 =head2 Locale::Constants - constants for Locale codes
15705
15706 =over 4
15707
15708 =item SYNOPSIS
15709
15710 =item DESCRIPTION
15711
15712 =item KNOWN BUGS AND LIMITATIONS
15713
15714 =item SEE ALSO
15715
15716 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
15717
15718 =item AUTHOR
15719
15720 =item COPYRIGHT
15721
15722 =back
15723
15724 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
15725
15726 =over 4
15727
15728 =item SYNOPSIS
15729
15730 =item DESCRIPTION
15731
15732 B<alpha-2>, B<alpha-3>, B<numeric>
15733
15734 =item CONVERSION ROUTINES
15735
15736 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
15737 country_code2code( CODE, CODESET, CODESET )
15738
15739 =item QUERY ROUTINES
15740
15741 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
15742
15743 =item SEMI-PRIVATE ROUTINES
15744
15745 =over 4
15746
15747 =item alias_code
15748
15749 =item rename_country
15750
15751 =back
15752
15753 =item EXAMPLES
15754
15755 =item DOMAIN NAMES
15756
15757 =item KNOWN BUGS AND LIMITATIONS
15758
15759 =item SEE ALSO
15760
15761 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
15762 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
15763 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
15764 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
15765
15766 =item AUTHOR
15767
15768 =item COPYRIGHT
15769
15770 =back
15771
15772 =head2 Locale::Currency - ISO three letter codes for currency
15773 identification (ISO 4217)
15774
15775 =over 4
15776
15777 =item SYNOPSIS
15778
15779 =item DESCRIPTION
15780
15781 XTS, XXX
15782
15783 =item CONVERSION ROUTINES
15784
15785 code2currency(), currency2code()
15786
15787 =item QUERY ROUTINES
15788
15789 C<all_currency_codes()>, C<all_currency_names()>
15790
15791 =item EXAMPLES
15792
15793 =item KNOWN BUGS AND LIMITATIONS
15794
15795 =item SEE ALSO
15796
15797 Locale::Country, Locale::Script, ISO 4217:1995,
15798 http://www.bsi-global.com/iso4217currency
15799
15800 =item AUTHOR
15801
15802 =item COPYRIGHT
15803
15804 =back
15805
15806 =head2 Locale::Language - ISO two letter codes for language identification
15807 (ISO 639)
15808
15809 =over 4
15810
15811 =item SYNOPSIS
15812
15813 =item DESCRIPTION
15814
15815 =item CONVERSION ROUTINES
15816
15817 code2language(), language2code()
15818
15819 =item QUERY ROUTINES
15820
15821 C<all_language_codes()>, C<all_language_names()>
15822
15823 =item EXAMPLES
15824
15825 =item KNOWN BUGS AND LIMITATIONS
15826
15827 =item SEE ALSO
15828
15829 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15830 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15831
15832 =item AUTHOR
15833
15834 =item COPYRIGHT
15835
15836 =back
15837
15838 =head2 Locale::Maketext - framework for localization
15839
15840 =over 4
15841
15842 =item SYNOPSIS
15843
15844 =item DESCRIPTION
15845
15846 =item QUICK OVERVIEW
15847
15848 =item METHODS
15849
15850 =over 4
15851
15852 =item Construction Methods
15853
15854 =item The "maketext" Method
15855
15856 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15857
15858 =item Utility Methods
15859
15860 $language->quant($number, $singular), $language->quant($number, $singular,
15861 $plural), $language->quant($number, $singular, $plural, $negative),
15862 $language->numf($number), $language->sprintf($format, @items),
15863 $language->language_tag(), $language->encoding()
15864
15865 =item Language Handle Attributes and Internals
15866
15867 =back
15868
15869 =item LANGUAGE CLASS HIERARCHIES
15870
15871 =item ENTRIES IN EACH LEXICON
15872
15873 =item BRACKET NOTATION
15874
15875 =item AUTO LEXICONS
15876
15877 =item CONTROLLING LOOKUP FAILURE
15878
15879 =item HOW TO USE MAKETEXT
15880
15881 =item SEE ALSO
15882
15883 =item COPYRIGHT AND DISCLAIMER
15884
15885 =item AUTHOR
15886
15887 =back
15888
15889 =head2 Locale::Maketext::TPJ13 -- article about software localization
15890
15891 =over 4
15892
15893 =item SYNOPSIS
15894
15895 =item DESCRIPTION
15896
15897 =item Localization and Perl: gettext breaks, Maketext fixes
15898
15899 =over 4
15900
15901 =item A Localization Horror Story: It Could Happen To You
15902
15903 =item The Linguistic View
15904
15905 =item Breaking gettext
15906
15907 =item Replacing gettext
15908
15909 =item Buzzwords: Abstraction and Encapsulation
15910
15911 =item Buzzword: Isomorphism
15912
15913 =item Buzzword: Inheritance
15914
15915 =item Buzzword: Concision
15916
15917 =item The Devil in the Details
15918
15919 =item The Proof in the Pudding: Localizing Web Sites
15920
15921 =item References
15922
15923 =back
15924
15925 =back
15926
15927 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15928
15929 =over 4
15930
15931 =item SYNOPSIS
15932
15933 =item DESCRIPTION
15934
15935 B<alpha-2>, B<alpha-3>, B<numeric>
15936
15937 =over 4
15938
15939 =item SPECIAL CODES
15940
15941 =back
15942
15943 =item CONVERSION ROUTINES
15944
15945 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15946 script_code2code( CODE, CODESET, CODESET )
15947
15948 =item QUERY ROUTINES
15949
15950 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15951
15952 =item EXAMPLES
15953
15954 =item KNOWN BUGS AND LIMITATIONS
15955
15956 =item SEE ALSO
15957
15958 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15959 http://www.evertype.com/standards/iso15924/
15960
15961 =item AUTHOR
15962
15963 =item COPYRIGHT
15964
15965 =back
15966
15967 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15968
15969 =over 4
15970
15971 =item SYNOPSIS
15972
15973 =item DESCRIPTION
15974
15975 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
15976
15977 =item DIAGNOSTICS
15978
15979 Premature end of base64 data, Premature padding of base64 data
15980
15981 =item EXAMPLES
15982
15983 =item COPYRIGHT
15984
15985 =back
15986
15987 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15988 of quoted-printable strings
15989
15990 =over 4
15991
15992 =item SYNOPSIS
15993
15994 =item DESCRIPTION
15995
15996 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
15997
15998 =item COPYRIGHT
15999
16000 =back
16001
16002 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16003 strings
16004
16005 =over 4
16006
16007 =item SYNOPSIS
16008
16009 =item DESCRIPTION
16010
16011 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16012
16013 =item COPYRIGHT
16014
16015 =back
16016
16017 =head2 Math::BigFloat - Arbitrary size floating point math package
16018
16019 =over 4
16020
16021 =item SYNOPSIS
16022
16023 =item DESCRIPTION
16024
16025 =over 4
16026
16027 =item Canonical notation
16028
16029 =item Output
16030
16031 =item C<mantissa()>, C<exponent()> and C<parts()>
16032
16033 =item Accuracy vs. Precision
16034
16035 =item Rounding
16036
16037 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16038 ), fround  ( -$scale ) and fround ( 0 )
16039
16040 =back
16041
16042 =item EXAMPLES
16043
16044   # not ready yet
16045
16046 =item Autocreating constants
16047
16048 =over 4
16049
16050 =item Math library
16051
16052 =item Using Math::BigInt::Lite
16053
16054 =back
16055
16056 =item BUGS
16057
16058 =item CAVEATS
16059
16060 stringify, bstr(), bdiv, Modifying and =, bpow
16061
16062 =item SEE ALSO
16063
16064 =item LICENSE
16065
16066 =item AUTHORS
16067
16068 =back
16069
16070 =head2 Math::BigInt - Arbitrary size integer math package
16071
16072 =over 4
16073
16074 =item SYNOPSIS
16075
16076 =item DESCRIPTION
16077
16078 Canonical notation, Input, Output
16079
16080 =item METHODS
16081
16082 =over 4
16083
16084 =item config
16085
16086 =item accuracy
16087
16088 =item precision
16089
16090 =item brsft
16091
16092 =item new
16093
16094 =item bnan
16095
16096 =item bzero
16097
16098 =item binf
16099
16100 =item bone
16101
16102 =item is_one()/is_zero()/is_nan()/is_inf()
16103
16104 =item is_positive()/is_negative()
16105
16106         $x->is_positive();              # true if >= 0
16107         $x->is_negative();              # true if <  0
16108
16109 =item is_odd()/is_even()/is_int()
16110
16111 =item bcmp
16112
16113 =item bacmp
16114
16115 =item sign
16116
16117 =item bcmp
16118
16119 =item bneg
16120
16121 =item babs
16122
16123 =item bnorm
16124
16125 =item bnot
16126
16127 =item binc
16128
16129 =item bdec
16130
16131 =item badd
16132
16133 =item bsub
16134
16135 =item bmul
16136
16137 =item bdiv
16138
16139 =item bmod
16140
16141 =item bmodinv
16142
16143 =item bmodpow
16144
16145 =item bpow
16146
16147 =item blsft
16148
16149 =item brsft
16150
16151 =item band
16152
16153 =item bior
16154
16155 =item bxor
16156
16157 =item bnot
16158
16159 =item bsqrt
16160
16161 =item bfac
16162
16163 =item round
16164
16165 =item bround
16166
16167 =item bfround
16168
16169 =item bfloor
16170
16171 =item bceil
16172
16173 =item bgcd
16174
16175 =item blcm
16176
16177 =item exponent
16178
16179 =item mantissa
16180
16181 =item parts
16182
16183 =item copy
16184
16185 =item as_number
16186
16187 =item bsstr
16188
16189 =item as_hex
16190
16191 =item as_bin
16192
16193 =back
16194
16195 =item ACCURACY and PRECISION
16196
16197 =over 4
16198
16199 =item Precision P
16200
16201 =item Accuracy A
16202
16203 =item Fallback F
16204
16205 =item Rounding mode R
16206
16207 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16208 (significant digits), Setting/Accessing, Creating numbers, Usage,
16209 Precedence, Overriding globals, Local settings, Rounding, Default values,
16210 Remarks
16211
16212 =back
16213
16214 =item INTERNALS
16215
16216 =over 4
16217
16218 =item MATH LIBRARY
16219
16220 =item SIGN
16221
16222 =item mantissa(), exponent() and parts()
16223
16224 =back
16225
16226 =item EXAMPLES
16227
16228   use Math::BigInt;
16229
16230 =item Autocreating constants
16231
16232 =item PERFORMANCE
16233
16234 =over 4
16235
16236 =item Alternative math libraries
16237
16238 =item SUBCLASSING
16239
16240 =back
16241
16242 =item Subclassing Math::BigInt
16243
16244 =item UPGRADING
16245
16246 =over 4
16247
16248 =item Auto-upgrade
16249
16250 bsqrt(), div(), blog()
16251
16252 =back
16253
16254 =item BUGS
16255
16256 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16257 5.6.0
16258
16259 =item CAVEATS
16260
16261 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16262 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16263 types, bsqrt(), brsft()
16264
16265 =item LICENSE
16266
16267 =item SEE ALSO
16268
16269 =item AUTHORS
16270
16271 =back
16272
16273 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16274
16275 =over 4
16276
16277 =item SYNOPSIS
16278
16279 =item DESCRIPTION
16280
16281 =item STORAGE
16282
16283 =item METHODS
16284
16285 =item WRAP YOUR OWN
16286
16287 =item LICENSE
16288
16289 This program is free software; you may redistribute it and/or modify it
16290 under
16291 the same terms as Perl itself.
16292
16293 =item AUTHORS
16294
16295 =item SEE ALSO
16296
16297 =back
16298
16299 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16300 scalars
16301
16302 =over 4
16303
16304 =item SYNOPSIS
16305
16306 =item DESCRIPTION
16307
16308 =item LICENSE
16309
16310 This program is free software; you may redistribute it and/or modify it
16311 under
16312 the same terms as Perl itself.
16313
16314 =item AUTHOR
16315
16316 =item SEE ALSO
16317
16318 =back
16319
16320 =head2 Math::BigRat - arbitrarily big rationales
16321
16322 =over 4
16323
16324 =item SYNOPSIS
16325
16326 =item DESCRIPTION
16327
16328 =over 4
16329
16330 =item MATH LIBRARY
16331
16332 =back
16333
16334 =item METHODS
16335
16336 =over 4
16337
16338 =item new()
16339
16340 =item numerator()
16341
16342 =item denominator()
16343
16344         $d = $x->denominator();
16345
16346 =item parts()
16347
16348 =item as_number()
16349
16350 =item bfac()
16351
16352 =item blog()
16353
16354 =item bround()/round()/bfround()
16355
16356 =item bmod()
16357
16358 =item is_one()
16359
16360 =item is_zero()
16361
16362 =item is_positive()
16363
16364 =item is_negative()
16365
16366 =item is_int()
16367
16368 =item is_odd()
16369
16370 =item is_even()
16371
16372 =item bceil()
16373
16374 =item bfloor()
16375
16376         $x->bfloor();
16377
16378 =item config
16379
16380 =back
16381
16382 =item BUGS
16383
16384 inf handling (partial), NaN handling (partial), rounding (not implemented
16385 except for bceil/bfloor), $x ** $y where $y is not an integer
16386
16387 =item LICENSE
16388
16389 =item SEE ALSO
16390
16391 =item AUTHORS
16392
16393 =back
16394
16395 =head2 Math::Complex - complex numbers and associated mathematical
16396 functions
16397
16398 =over 4
16399
16400 =item SYNOPSIS
16401
16402 =item DESCRIPTION
16403
16404 =item OPERATIONS
16405
16406 =item CREATION
16407
16408 =item STRINGIFICATION
16409
16410 =over 4
16411
16412 =item CHANGED IN PERL 5.6
16413
16414 =back
16415
16416 =item USAGE
16417
16418 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16419
16420 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16421
16422 =item BUGS
16423
16424 =item AUTHORS
16425
16426 =back
16427
16428 =head2 Math::Trig - trigonometric functions
16429
16430 =over 4
16431
16432 =item SYNOPSIS
16433
16434 =item DESCRIPTION
16435
16436 =item TRIGONOMETRIC FUNCTIONS
16437
16438 B<tan>
16439
16440 =over 4
16441
16442 =item ERRORS DUE TO DIVISION BY ZERO
16443
16444 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16445
16446 =back
16447
16448 =item PLANE ANGLE CONVERSIONS
16449
16450 =item RADIAL COORDINATE CONVERSIONS
16451
16452 =over 4
16453
16454 =item COORDINATE SYSTEMS
16455
16456 =item 3-D ANGLE CONVERSIONS
16457
16458 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16459 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16460
16461 =back
16462
16463 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16464
16465 =item EXAMPLES
16466
16467 =over 4
16468
16469 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16470
16471 =back
16472
16473 =item BUGS
16474
16475 =item AUTHORS
16476
16477 =back
16478
16479 =head2 Memoize - Make functions faster by trading space for time
16480
16481 =over 4
16482
16483 =item SYNOPSIS
16484
16485 =item DESCRIPTION
16486
16487 =item DETAILS
16488
16489 =item OPTIONS
16490
16491 =over 4
16492
16493 =item INSTALL
16494
16495 =item NORMALIZER
16496
16497 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16498
16499 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16500
16501 =back
16502
16503 =item OTHER FACILITIES
16504
16505 =over 4
16506
16507 =item C<unmemoize>
16508
16509 =item C<flush_cache>
16510
16511 =back
16512
16513 =item CAVEATS
16514
16515 =item PERSISTENT CACHE SUPPORT
16516
16517 =item EXPIRATION SUPPORT
16518
16519 =item BUGS
16520
16521 =item MAILING LIST
16522
16523 =item AUTHOR
16524
16525 =item COPYRIGHT AND LICENSE
16526
16527 =item THANK YOU
16528
16529 =back
16530
16531 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16532 Storable use
16533
16534 =over 4
16535
16536 =item DESCRIPTION
16537
16538 =back
16539
16540 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16541 memoized values
16542
16543 =over 4
16544
16545 =item SYNOPSIS
16546
16547 =item DESCRIPTION
16548
16549 =item INTERFACE
16550
16551  TIEHASH,  EXISTS,  STORE
16552
16553 =item ALTERNATIVES
16554
16555 =item CAVEATS
16556
16557 =item AUTHOR
16558
16559 =item SEE ALSO
16560
16561 =back
16562
16563 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16564
16565 =over 4
16566
16567 =item DESCRIPTION
16568
16569 =back
16570
16571 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16572
16573 =over 4
16574
16575 =item DESCRIPTION
16576
16577 =back
16578
16579 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16580 Storable use
16581
16582 =over 4
16583
16584 =item DESCRIPTION
16585
16586 =back
16587
16588 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16589 Storable use
16590
16591 =over 4
16592
16593 =item DESCRIPTION
16594
16595 =back
16596
16597 =head2 Memoize::Storable - store Memoized data in Storable database
16598
16599 =over 4
16600
16601 =item DESCRIPTION
16602
16603 =back
16604
16605 =head2 NDBM_File - Tied access to ndbm files
16606
16607 =over 4
16608
16609 =item SYNOPSIS
16610
16611 =item DESCRIPTION
16612
16613 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16614
16615 =item DIAGNOSTICS
16616
16617 =over 4
16618
16619 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16620
16621 =back
16622
16623 =item BUGS AND WARNINGS
16624
16625 =back
16626
16627 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
16628
16629 =over 4
16630
16631 =item SYNOPSIS
16632
16633 =item DESCRIPTION
16634
16635 =over 4
16636
16637 =item Enforcing redispatch
16638
16639 =item Avoiding repetitions
16640
16641 =back
16642
16643 =item AUTHOR
16644
16645 =item BUGS AND IRRITATIONS
16646
16647 =item COPYRIGHT
16648
16649 =back
16650
16651 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
16652
16653 =over 4
16654
16655 =item SYNOPSIS
16656
16657 =item DESCRIPTION
16658
16659 =item USER METHODS
16660
16661 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
16662 dataend ()
16663
16664 =item CLASS METHODS
16665
16666 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
16667 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
16668 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
16669
16670 =item EXPORTS
16671
16672 =item AUTHOR
16673
16674 =item COPYRIGHT
16675
16676 =back
16677
16678 =head2 Net::Config - Local configuration data for libnet
16679
16680 =over 4
16681
16682 =item SYNOPSYS
16683
16684 =item DESCRIPTION
16685
16686 =item METHODS
16687
16688 requires_firewall HOST
16689
16690 =item NetConfig VALUES
16691
16692 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
16693 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
16694 ftp_int_pasive, local_netmask, test_hosts, test_exists
16695
16696 =back
16697
16698 =head2 Net::Domain - Attempt to evaluate the current host's internet name
16699 and domain
16700
16701 =over 4
16702
16703 =item SYNOPSIS
16704
16705 =item DESCRIPTION
16706
16707 hostfqdn (), hostname (), hostdomain ()
16708
16709 =item AUTHOR
16710
16711 =item COPYRIGHT
16712
16713 =back
16714
16715 =head2 Net::FTP - FTP Client class
16716
16717 =over 4
16718
16719 =item SYNOPSIS
16720
16721 =item DESCRIPTION
16722
16723 =item OVERVIEW
16724
16725 =item CONSTRUCTOR
16726
16727 new (HOST [,OPTIONS])
16728
16729 =item METHODS
16730
16731 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
16732 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
16733 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
16734 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
16735 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ),
16736 dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put (
16737 LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ),
16738 append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size
16739 ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
16740 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
16741 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
16742 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
16743 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
16744 abort (), quit ()
16745
16746 =over 4
16747
16748 =item Methods for the adventurous
16749
16750 quot (CMD [,ARGS])
16751
16752 =back
16753
16754 =item THE dataconn CLASS
16755
16756 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
16757 bytes_read (), abort (), close ()
16758
16759 =item UNIMPLEMENTED
16760
16761 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
16762
16763 =item REPORTING BUGS
16764
16765 =item AUTHOR
16766
16767 =item SEE ALSO
16768
16769 =item USE EXAMPLES
16770
16771 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
16772
16773 =item CREDITS
16774
16775 =item COPYRIGHT
16776
16777 =back
16778
16779 =head2 Net::NNTP - NNTP Client class
16780
16781 =over 4
16782
16783 =item SYNOPSIS
16784
16785 =item DESCRIPTION
16786
16787 =item CONSTRUCTOR
16788
16789 new ( [ HOST ] [, OPTIONS ])
16790
16791 =item METHODS
16792
16793 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
16794 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
16795 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
16796 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
16797 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
16798 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
16799 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
16800
16801 =over 4
16802
16803 =item Extension methods
16804
16805 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
16806 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
16807 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
16808 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
16809 GROUP ] ), reader
16810
16811 =back
16812
16813 =item UNSUPPORTED
16814
16815 =item DEFINITIONS
16816
16817 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
16818
16819 =item SEE ALSO
16820
16821 =item AUTHOR
16822
16823 =item COPYRIGHT
16824
16825 =back
16826
16827 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
16828
16829 =over 4
16830
16831 =item SYNOPSIS
16832
16833 =item DESCRIPTION
16834
16835 =item CONSTRUCTOR
16836
16837 new ( [ HOST, ] [ OPTIONS ] )
16838
16839 =item METHODS
16840
16841 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16842 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16843 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16844 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16845
16846 =item NOTES
16847
16848 =item SEE ALSO
16849
16850 =item AUTHOR
16851
16852 =item COPYRIGHT
16853
16854 =back
16855
16856 =head2 Net::Ping - check a remote host for reachability
16857
16858 =over 4
16859
16860 =item SYNOPSIS
16861
16862 =item DESCRIPTION
16863
16864 =over 4
16865
16866 =item Functions
16867
16868 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
16869 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
16870 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
16871 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
16872 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
16873 [, $timeout]);
16874
16875 =back
16876
16877 =item NOTES
16878
16879 =item INSTALL
16880
16881 =item BUGS
16882
16883 =item AUTHORS
16884
16885 =item COPYRIGHT
16886
16887 =back
16888
16889 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16890
16891 =over 4
16892
16893 =item SYNOPSIS
16894
16895 =item DESCRIPTION
16896
16897 =item EXAMPLES
16898
16899 =item CONSTRUCTOR
16900
16901 new Net::SMTP [ HOST, ] [ OPTIONS ]
16902
16903 =item METHODS
16904
16905 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16906 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16907 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16908 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16909 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16910 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16911 quit ()
16912
16913 =item ADDRESSES
16914
16915 =item SEE ALSO
16916
16917 =item AUTHOR
16918
16919 =item COPYRIGHT
16920
16921 =back
16922
16923 =head2 Net::Time - time and daytime network client interface
16924
16925 =over 4
16926
16927 =item SYNOPSIS
16928
16929 =item DESCRIPTION
16930
16931 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16932 PROTOCOL [, TIMEOUT]]])
16933
16934 =item AUTHOR
16935
16936 =item COPYRIGHT
16937
16938 =back
16939
16940 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16941 functions
16942
16943 =over 4
16944
16945 =item SYNOPSIS
16946
16947 =item DESCRIPTION
16948
16949 =item EXAMPLES
16950
16951 =item NOTE
16952
16953 =item AUTHOR
16954
16955 =back
16956
16957 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16958
16959 =over 4
16960
16961 =item DESCRIPTION
16962
16963 =over 4
16964
16965 =item Where to get this document
16966
16967 =item How to contribute to this document
16968
16969 =back
16970
16971 =item Author and Copyright Information
16972
16973 =over 4
16974
16975 =item Disclaimer
16976
16977 =back
16978
16979 =item Obtaining and installing libnet
16980
16981 =over 4
16982
16983 =item What is libnet ?
16984
16985 =item Which version of perl do I need ?
16986
16987 =item What other modules do I need ?
16988
16989 =item What machines support libnet ?
16990
16991 =item Where can I get the latest libnet release
16992
16993 =back
16994
16995 =item Using Net::FTP
16996
16997 =over 4
16998
16999 =item How do I download files from an FTP server ?
17000
17001 =item How do I transfer files in binary mode ?
17002
17003 =item How can I get the size of a file on a remote FTP server ?
17004
17005 =item How can I get the modification time of a file on a remote FTP server
17006 ?
17007
17008 =item How can I change the permissions of a file on a remote server ?
17009
17010 =item Can I do a reget operation like the ftp command ?
17011
17012 =item How do I get a directory listing from an FTP server ?
17013
17014 =item Changing directory to "" does not fail ?
17015
17016 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17017
17018 =item I am behind an FTP proxy firewall, but cannot access machines outside
17019 ?
17020
17021 =item My ftp proxy firewall does not listen on port 21
17022
17023 =item Is it possible to change the file permissions of a file on an FTP
17024 server ?
17025
17026 =item I have seen scripts call a method message, but cannot find it
17027 documented ?
17028
17029 =item Why does Net::FTP not implement mput and mget methods
17030
17031 =back
17032
17033 =item Using Net::SMTP
17034
17035 =over 4
17036
17037 =item Why can't the part of an Email address after the @ be used as the
17038 hostname ?
17039
17040 =item Why does Net::SMTP not do DNS MX lookups ?
17041
17042 =item The verify method always returns true ?
17043
17044 =back
17045
17046 =item Debugging scripts
17047
17048 =over 4
17049
17050 =item How can I debug my scripts that use Net::* modules ?
17051
17052 =back
17053
17054 =item AUTHOR AND COPYRIGHT
17055
17056 =back
17057
17058 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17059 functions
17060
17061 =over 4
17062
17063 =item SYNOPSIS
17064
17065 =item DESCRIPTION
17066
17067 =item EXAMPLES
17068
17069 =item NOTE
17070
17071 =item AUTHOR
17072
17073 =back
17074
17075 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17076 functions
17077
17078 =over 4
17079
17080 =item SYNOPSIS
17081
17082 =item DESCRIPTION
17083
17084 =item NOTE
17085
17086 =item AUTHOR
17087
17088 =back
17089
17090 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17091 functions
17092
17093 =over 4
17094
17095 =item SYNOPSIS
17096
17097 =item DESCRIPTION
17098
17099 =item EXAMPLES
17100
17101 =item NOTE
17102
17103 =item AUTHOR
17104
17105 =back
17106
17107 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17108
17109 =over 4
17110
17111 =item SYNOPSIS
17112
17113 =item DESCRIPTION
17114
17115 =item THE .netrc FILE
17116
17117 machine name, default, login name, password string, account string, macdef
17118 name
17119
17120 =item CONSTRUCTOR
17121
17122 lookup ( MACHINE [, LOGIN ])
17123
17124 =item METHODS
17125
17126 login (), password (), account (), lpa ()
17127
17128 =item AUTHOR
17129
17130 =item SEE ALSO
17131
17132 =item COPYRIGHT
17133
17134 =back
17135
17136 =head2 O - Generic interface to Perl Compiler backends
17137
17138 =over 4
17139
17140 =item SYNOPSIS
17141
17142 =item DESCRIPTION
17143
17144 =item CONVENTIONS
17145
17146 =item IMPLEMENTATION
17147
17148 =item BUGS
17149
17150 =item AUTHOR
17151
17152 =back
17153
17154 =head2 ODBM_File - Tied access to odbm files
17155
17156 =over 4
17157
17158 =item SYNOPSIS
17159
17160 =item DESCRIPTION
17161
17162 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17163
17164 =item DIAGNOSTICS
17165
17166 =over 4
17167
17168 =item C<odbm store returned -1, errno 22, key "..." at ...>
17169
17170 =back
17171
17172 =item BUGS AND WARNINGS
17173
17174 =back
17175
17176 =head2 Opcode - Disable named opcodes when compiling perl code
17177
17178 =over 4
17179
17180 =item SYNOPSIS
17181
17182 =item DESCRIPTION
17183
17184 =item NOTE
17185
17186 =item WARNING
17187
17188 =item Operator Names and Operator Lists
17189
17190 an operator name (opname), an operator tag name (optag), a negated opname
17191 or optag, an operator set (opset)
17192
17193 =item Opcode Functions
17194
17195 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17196 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17197 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17198 opdump (PAT)
17199
17200 =item Manipulating Opsets
17201
17202 =item TO DO (maybe)
17203
17204 =back
17205
17206 =over 4
17207
17208 =item Predefined Opcode Tags
17209
17210 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17211 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17212 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17213 :dangerous
17214
17215 =item SEE ALSO
17216
17217 =item AUTHORS
17218
17219 =back
17220
17221 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17222 compartments
17223
17224 =over 4
17225
17226 =item SYNOPSIS
17227
17228 =item DESCRIPTION
17229
17230 a new namespace, an operator mask
17231
17232 =item WARNING
17233
17234 =over 4
17235
17236 =item RECENT CHANGES
17237
17238 =item Methods in class Safe
17239
17240 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17241 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17242 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17243 root (NAMESPACE), mask (MASK)
17244
17245 =item Some Safety Issues
17246
17247 Memory, CPU, Snooping, Signals, State Changes
17248
17249 =item AUTHOR
17250
17251 =back
17252
17253 =back
17254
17255 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17256 compiling
17257
17258 =over 4
17259
17260 =item SYNOPSIS
17261
17262 =item DESCRIPTION
17263
17264 =item SEE ALSO
17265
17266 =back
17267
17268 =head2 POSIX - Perl interface to IEEE Std 1003.1
17269
17270 =over 4
17271
17272 =item SYNOPSIS
17273
17274 =item DESCRIPTION
17275
17276 =item NOTE
17277
17278 =item CAVEATS
17279
17280 =item FUNCTIONS
17281
17282 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17283 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17284 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17285 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17286 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17287 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17288 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17289 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17290 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17291 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17292 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17293 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17294 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17295 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17296 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17297 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17298 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17299 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17300 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17301 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17302 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17303 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17304 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17305 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17306 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17307 wctomb, write
17308
17309 =item CLASSES
17310
17311 =over 4
17312
17313 =item POSIX::SigAction
17314
17315 new, handler, mask, flags, safe
17316
17317 =item POSIX::SigSet
17318
17319 new, addset, delset, emptyset, fillset, ismember
17320
17321 =item POSIX::Termios
17322
17323 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17324 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17325 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17326 field values, c_cflag field values, c_iflag field values, c_lflag field
17327 values, c_oflag field values
17328
17329 =back
17330
17331 =item PATHNAME CONSTANTS
17332
17333 Constants
17334
17335 =item POSIX CONSTANTS
17336
17337 Constants
17338
17339 =item SYSTEM CONFIGURATION
17340
17341 Constants
17342
17343 =item ERRNO
17344
17345 Constants
17346
17347 =item FCNTL
17348
17349 Constants
17350
17351 =item FLOAT
17352
17353 Constants
17354
17355 =item LIMITS
17356
17357 Constants
17358
17359 =item LOCALE
17360
17361 Constants
17362
17363 =item MATH
17364
17365 Constants
17366
17367 =item SIGNAL
17368
17369 Constants
17370
17371 =item STAT
17372
17373 Constants, Macros
17374
17375 =item STDLIB
17376
17377 Constants
17378
17379 =item STDIO
17380
17381 Constants
17382
17383 =item TIME
17384
17385 Constants
17386
17387 =item UNISTD
17388
17389 Constants
17390
17391 =item WAIT
17392
17393 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17394 WTERMSIG, WIFSTOPPED, WSTOPSIG
17395
17396 =back
17397
17398 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17399 name space
17400
17401 =over 4
17402
17403 =item SYNOPSIS
17404
17405 =item DESCRIPTION
17406
17407 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
17408
17409 =over 4
17410
17411 =item Custom Layers
17412
17413 :encoding, :via
17414
17415 =item Alternatives to raw
17416
17417 =item Defaults and how to override them
17418
17419 =item Querying the layers of filehandle
17420
17421 =back
17422
17423 =item AUTHOR
17424
17425 =item SEE ALSO
17426
17427 =back
17428
17429 =head2 PerlIO::encoding - encoding layer
17430
17431 =over 4
17432
17433 =item SYNOPSIS
17434
17435 =item DESCRIPTION
17436
17437 =item SEE ALSO
17438
17439 =back
17440
17441 =head2 PerlIO::scalar - support module for in-memory IO.
17442
17443 =over 4
17444
17445 =item SYNOPSIS
17446
17447 =item DESCRIPTION
17448
17449 =back
17450
17451 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17452
17453 =over 4
17454
17455 =item SYNOPSIS
17456
17457 =item DESCRIPTION
17458
17459 =item EXPECTED METHODS
17460
17461 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17462 $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
17463 $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
17464 $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
17465 $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
17466 $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
17467 $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
17468 $obj->EOF($fh)
17469
17470 =item EXAMPLES
17471
17472 =over 4
17473
17474 =item Example - a Hexadecimal Handle
17475
17476 =back
17477
17478 =back
17479
17480 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17481
17482 =over 4
17483
17484 =item SYNOPSIS
17485
17486 =item DESCRIPTION
17487
17488 =item SEE ALSO
17489
17490 =item COPYRIGHT
17491
17492 =back
17493
17494 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17495
17496 =over 4
17497
17498 =item SYNOPSIS
17499
17500 =item OPTIONS/ARGUMENTS
17501
17502 =over 4
17503
17504 =item podchecker()
17505
17506 B<-warnings> =E<gt> I<val>
17507
17508 =back
17509
17510 =item DESCRIPTION
17511
17512 =item DIAGNOSTICS
17513
17514 =over 4
17515
17516 =item Errors
17517
17518 empty =headn, =over on line I<N> without closing =back, =item without
17519 previous =over, =back without previous =over, No argument for =begin, =end
17520 without =begin, Nested =begin's, =for without formatter specification,
17521 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17522 interior-sequence "I<SEQ>", nested commands
17523 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17524 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17525 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17526 after =back
17527
17528 =item Warnings
17529
17530 multiple occurrence of link target I<name>, line containing nothing but
17531 whitespace in paragraph, file does not start with =head, previous =item has
17532 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17533 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17534 items in =over, No argument for =item, empty section in previous paragraph,
17535 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17536 level
17537
17538 =item Hyperlinks
17539
17540 ignoring leading/trailing whitespace in link, (section) in '$page'
17541 deprecated, alternative text/node '%s' contains non-escaped | or /
17542
17543 =back
17544
17545 =item RETURN VALUE
17546
17547 =item EXAMPLES
17548
17549 =item INTERFACE
17550
17551 =back
17552
17553 C<Pod::Checker-E<gt>new( %options )>
17554
17555 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17556 @args )>
17557
17558 C<$checker-E<gt>num_errors()>
17559
17560 C<$checker-E<gt>num_warnings()>
17561
17562 C<$checker-E<gt>name()>
17563
17564 C<$checker-E<gt>node()>
17565
17566 C<$checker-E<gt>idx()>
17567
17568 C<$checker-E<gt>hyperlink()>
17569
17570 =over 4
17571
17572 =item AUTHOR
17573
17574 =back
17575
17576 =head2 Pod::Find - find POD documents in directory trees
17577
17578 =over 4
17579
17580 =item SYNOPSIS
17581
17582 =item DESCRIPTION
17583
17584 =back
17585
17586 =over 4
17587
17588 =item C<pod_find( { %opts } , @directories )>
17589
17590 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17591 1>
17592
17593 =back
17594
17595 =over 4
17596
17597 =item C<simplify_name( $str )>
17598
17599 =back
17600
17601 =over 4
17602
17603 =item C<pod_where( { %opts }, $pod )>
17604
17605 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17606 1>
17607
17608 =back
17609
17610 =over 4
17611
17612 =item C<contains_pod( $file , $verbose )>
17613
17614 =back
17615
17616 =over 4
17617
17618 =item AUTHOR
17619
17620 =item SEE ALSO
17621
17622 =back
17623
17624 =head2 Pod::Html - module to convert pod files to HTML
17625
17626 =over 4
17627
17628 =item SYNOPSIS
17629
17630 =item DESCRIPTION
17631
17632 =item ARGUMENTS
17633
17634 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
17635 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
17636 title, verbose
17637
17638 =item EXAMPLE
17639
17640 =item ENVIRONMENT
17641
17642 =item AUTHOR
17643
17644 =item SEE ALSO
17645
17646 =item COPYRIGHT
17647
17648 =back
17649
17650 =head2 Pod::InputObjects - objects representing POD input paragraphs,
17651 commands, etc.
17652
17653 =over 4
17654
17655 =item SYNOPSIS
17656
17657 =item REQUIRES
17658
17659 =item EXPORTS
17660
17661 =item DESCRIPTION
17662
17663 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
17664 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
17665
17666 =back
17667
17668 =over 4
17669
17670 =item B<Pod::InputSource>
17671
17672 =back
17673
17674 =over 4
17675
17676 =item B<new()>
17677
17678 =back
17679
17680 =over 4
17681
17682 =item B<name()>
17683
17684 =back
17685
17686 =over 4
17687
17688 =item B<handle()>
17689
17690 =back
17691
17692 =over 4
17693
17694 =item B<was_cutting()>
17695
17696 =back
17697
17698 =over 4
17699
17700 =item B<Pod::Paragraph>
17701
17702 =back
17703
17704 =over 4
17705
17706 =item Pod::Paragraph-E<gt>B<new()>
17707
17708 =back
17709
17710 =over 4
17711
17712 =item $pod_para-E<gt>B<cmd_name()>
17713
17714 =back
17715
17716 =over 4
17717
17718 =item $pod_para-E<gt>B<text()>
17719
17720 =back
17721
17722 =over 4
17723
17724 =item $pod_para-E<gt>B<raw_text()>
17725
17726 =back
17727
17728 =over 4
17729
17730 =item $pod_para-E<gt>B<cmd_prefix()>
17731
17732 =back
17733
17734 =over 4
17735
17736 =item $pod_para-E<gt>B<cmd_separator()>
17737
17738 =back
17739
17740 =over 4
17741
17742 =item $pod_para-E<gt>B<parse_tree()>
17743
17744 =back
17745
17746 =over 4
17747
17748 =item $pod_para-E<gt>B<file_line()>
17749
17750 =back
17751
17752 =over 4
17753
17754 =item B<Pod::InteriorSequence>
17755
17756 =back
17757
17758 =over 4
17759
17760 =item Pod::InteriorSequence-E<gt>B<new()>
17761
17762 =back
17763
17764 =over 4
17765
17766 =item $pod_seq-E<gt>B<cmd_name()>
17767
17768 =back
17769
17770 =over 4
17771
17772 =item $pod_seq-E<gt>B<prepend()>
17773
17774 =back
17775
17776 =over 4
17777
17778 =item $pod_seq-E<gt>B<append()>
17779
17780 =back
17781
17782 =over 4
17783
17784 =item $pod_seq-E<gt>B<nested()>
17785
17786 =back
17787
17788 =over 4
17789
17790 =item $pod_seq-E<gt>B<raw_text()>
17791
17792 =back
17793
17794 =over 4
17795
17796 =item $pod_seq-E<gt>B<left_delimiter()>
17797
17798 =back
17799
17800 =over 4
17801
17802 =item $pod_seq-E<gt>B<right_delimiter()>
17803
17804 =back
17805
17806 =over 4
17807
17808 =item $pod_seq-E<gt>B<parse_tree()>
17809
17810 =back
17811
17812 =over 4
17813
17814 =item $pod_seq-E<gt>B<file_line()>
17815
17816 =back
17817
17818 =over 4
17819
17820 =item Pod::InteriorSequence::B<DESTROY()>
17821
17822 =back
17823
17824 =over 4
17825
17826 =item B<Pod::ParseTree>
17827
17828 =back
17829
17830 =over 4
17831
17832 =item Pod::ParseTree-E<gt>B<new()>
17833
17834 =back
17835
17836 =over 4
17837
17838 =item $ptree-E<gt>B<top()>
17839
17840 =back
17841
17842 =over 4
17843
17844 =item $ptree-E<gt>B<children()>
17845
17846 =back
17847
17848 =over 4
17849
17850 =item $ptree-E<gt>B<prepend()>
17851
17852 =back
17853
17854 =over 4
17855
17856 =item $ptree-E<gt>B<append()>
17857
17858 =back
17859
17860 =over 4
17861
17862 =item $ptree-E<gt>B<raw_text()>
17863
17864 =back
17865
17866 =over 4
17867
17868 =item Pod::ParseTree::B<DESTROY()>
17869
17870 =back
17871
17872 =over 4
17873
17874 =item SEE ALSO
17875
17876 =item AUTHOR
17877
17878 =back
17879
17880 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17881
17882 =over 4
17883
17884 =item SYNOPSIS
17885
17886 =item DESCRIPTION
17887
17888 =back
17889
17890 =over 4
17891
17892 =item OBJECT METHODS
17893
17894 C<initialize>
17895
17896 =back
17897
17898 =over 4
17899
17900 =item Data Accessors
17901
17902 B<AddPreamble>
17903
17904 =back
17905
17906 B<AddPostamble>
17907
17908 B<Head1Level>
17909
17910 B<Label>
17911
17912 B<LevelNoNum>
17913
17914 B<MakeIndex>
17915
17916 B<ReplaceNAMEwithSection>
17917
17918 B<StartWithNewPage>
17919
17920 B<TableOfContents>
17921
17922 B<UniqueLabels>
17923
17924 B<UserPreamble>
17925
17926 B<UserPostamble>
17927
17928 B<Lists>
17929
17930 =over 4
17931
17932 =item Subclassed methods
17933
17934 =back
17935
17936 B<begin_pod>
17937
17938 B<end_pod>
17939
17940 B<command>
17941
17942 B<verbatim>
17943
17944 B<textblock>
17945
17946 B<interior_sequence>
17947
17948 =over 4
17949
17950 =item List Methods
17951
17952 B<begin_list>
17953
17954 =back
17955
17956 B<end_list>
17957
17958 B<add_item>
17959
17960 =over 4
17961
17962 =item Methods for headings
17963
17964 B<head>
17965
17966 =back
17967
17968 =over 4
17969
17970 =item Internal methods
17971
17972 B<_output>
17973
17974 =back
17975
17976 B<_replace_special_chars>
17977
17978 B<_replace_special_chars_late>
17979
17980 B<_create_label>
17981
17982 B<_create_index>
17983
17984 B<_clean_latex_commands>
17985
17986 B<_split_delimited>
17987
17988 =over 4
17989
17990 =item NOTES
17991
17992 =item SEE ALSO
17993
17994 =item AUTHORS
17995
17996 =item COPYRIGHT
17997
17998 =item REVISION
17999
18000 =back
18001
18002 =head2 Pod::Man - Convert POD data to formatted *roff input
18003
18004 =over 4
18005
18006 =item SYNOPSIS
18007
18008 =item DESCRIPTION
18009
18010 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18011 release, section
18012
18013 =item DIAGNOSTICS
18014
18015 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18016 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18017 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18018 =back
18019
18020 =item BUGS
18021
18022 =item CAVEATS
18023
18024 =item SEE ALSO
18025
18026 =item AUTHOR
18027
18028 =item COPYRIGHT AND LICENSE
18029
18030 =back
18031
18032 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18033
18034 =over 4
18035
18036 =item SYNOPSIS
18037
18038 =item DESCRIPTION
18039
18040 =item SEE ALSO
18041
18042 =item AUTHOR
18043
18044 =item COPYRIGHT AND LICENSE
18045
18046 =back
18047
18048 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18049
18050 =over 4
18051
18052 =item SYNOPSIS
18053
18054 =item DESCRIPTION
18055
18056 =back
18057
18058 =over 4
18059
18060 =item Pod::List
18061
18062 Pod::List-E<gt>new()
18063
18064 =back
18065
18066 $list-E<gt>file()
18067
18068 $list-E<gt>start()
18069
18070 $list-E<gt>indent()
18071
18072 $list-E<gt>type()
18073
18074 $list-E<gt>rx()
18075
18076 $list-E<gt>item()
18077
18078 $list-E<gt>parent()
18079
18080 $list-E<gt>tag()
18081
18082 =over 4
18083
18084 =item Pod::Hyperlink
18085
18086 Pod::Hyperlink-E<gt>new()
18087
18088 =back
18089
18090 $link-E<gt>parse($string)
18091
18092 $link-E<gt>markup($string)
18093
18094 $link-E<gt>text()
18095
18096 $link-E<gt>warning()
18097
18098 $link-E<gt>file(), $link-E<gt>line()
18099
18100 $link-E<gt>page()
18101
18102 $link-E<gt>node()
18103
18104 $link-E<gt>alttext()
18105
18106 $link-E<gt>type()
18107
18108 $link-E<gt>link()
18109
18110 =over 4
18111
18112 =item Pod::Cache
18113
18114 Pod::Cache-E<gt>new()
18115
18116 =back
18117
18118 $cache-E<gt>item()
18119
18120 $cache-E<gt>find_page($name)
18121
18122 =over 4
18123
18124 =item Pod::Cache::Item
18125
18126 Pod::Cache::Item-E<gt>new()
18127
18128 =back
18129
18130 $cacheitem-E<gt>page()
18131
18132 $cacheitem-E<gt>description()
18133
18134 $cacheitem-E<gt>path()
18135
18136 $cacheitem-E<gt>file()
18137
18138 $cacheitem-E<gt>nodes()
18139
18140 $cacheitem-E<gt>find_node($name)
18141
18142 $cacheitem-E<gt>idx()
18143
18144 =over 4
18145
18146 =item AUTHOR
18147
18148 =item SEE ALSO
18149
18150 =back
18151
18152 =head2 Pod::Parser - base class for creating POD filters and translators
18153
18154 =over 4
18155
18156 =item SYNOPSIS
18157
18158 =item REQUIRES
18159
18160 =item EXPORTS
18161
18162 =item DESCRIPTION
18163
18164 =item QUICK OVERVIEW
18165
18166 =item PARSING OPTIONS
18167
18168 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18169 B<-warnings> (default: unset)
18170
18171 =back
18172
18173 =over 4
18174
18175 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18176
18177 =back
18178
18179 =over 4
18180
18181 =item B<command()>
18182
18183 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18184
18185 =back
18186
18187 =over 4
18188
18189 =item B<verbatim()>
18190
18191 C<$text>, C<$line_num>, C<$pod_para>
18192
18193 =back
18194
18195 =over 4
18196
18197 =item B<textblock()>
18198
18199 C<$text>, C<$line_num>, C<$pod_para>
18200
18201 =back
18202
18203 =over 4
18204
18205 =item B<interior_sequence()>
18206
18207 =back
18208
18209 =over 4
18210
18211 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18212
18213 =back
18214
18215 =over 4
18216
18217 =item B<new()>
18218
18219 =back
18220
18221 =over 4
18222
18223 =item B<initialize()>
18224
18225 =back
18226
18227 =over 4
18228
18229 =item B<begin_pod()>
18230
18231 =back
18232
18233 =over 4
18234
18235 =item B<begin_input()>
18236
18237 =back
18238
18239 =over 4
18240
18241 =item B<end_input()>
18242
18243 =back
18244
18245 =over 4
18246
18247 =item B<end_pod()>
18248
18249 =back
18250
18251 =over 4
18252
18253 =item B<preprocess_line()>
18254
18255 =back
18256
18257 =over 4
18258
18259 =item B<preprocess_paragraph()>
18260
18261 =back
18262
18263 =over 4
18264
18265 =item METHODS FOR PARSING AND PROCESSING
18266
18267 =back
18268
18269 =over 4
18270
18271 =item B<parse_text()>
18272
18273 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18274 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18275 I<code-ref>|I<method-name>
18276
18277 =back
18278
18279 =over 4
18280
18281 =item B<interpolate()>
18282
18283 =back
18284
18285 =over 4
18286
18287 =item B<parse_paragraph()>
18288
18289 =back
18290
18291 =over 4
18292
18293 =item B<parse_from_filehandle()>
18294
18295 =back
18296
18297 =over 4
18298
18299 =item B<parse_from_file()>
18300
18301 =back
18302
18303 =over 4
18304
18305 =item ACCESSOR METHODS
18306
18307 =back
18308
18309 =over 4
18310
18311 =item B<errorsub()>
18312
18313 =back
18314
18315 =over 4
18316
18317 =item B<cutting()>
18318
18319 =back
18320
18321 =over 4
18322
18323 =item B<parseopts()>
18324
18325 =back
18326
18327 =over 4
18328
18329 =item B<output_file()>
18330
18331 =back
18332
18333 =over 4
18334
18335 =item B<output_handle()>
18336
18337 =back
18338
18339 =over 4
18340
18341 =item B<input_file()>
18342
18343 =back
18344
18345 =over 4
18346
18347 =item B<input_handle()>
18348
18349 =back
18350
18351 =over 4
18352
18353 =item B<input_streams()>
18354
18355 =back
18356
18357 =over 4
18358
18359 =item B<top_stream()>
18360
18361 =back
18362
18363 =over 4
18364
18365 =item PRIVATE METHODS AND DATA
18366
18367 =back
18368
18369 =over 4
18370
18371 =item B<_push_input_stream()>
18372
18373 =back
18374
18375 =over 4
18376
18377 =item B<_pop_input_stream()>
18378
18379 =back
18380
18381 =over 4
18382
18383 =item TREE-BASED PARSING
18384
18385 =item SEE ALSO
18386
18387 =item AUTHOR
18388
18389 =back
18390
18391 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18392
18393 =over 4
18394
18395 =item SYNOPSIS
18396
18397 =item DESCRIPTION
18398
18399 =item SEE ALSO
18400
18401 =item COPYRIGHT AND DISCLAIMERS
18402
18403 =item AUTHOR
18404
18405 =back
18406
18407 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18408
18409 =over 4
18410
18411 =item SYNOPSIS
18412
18413 =item DESCRIPTION
18414
18415 =item CAVEAT
18416
18417 =item SEE ALSO
18418
18419 =item COPYRIGHT AND DISCLAIMERS
18420
18421 =item AUTHOR
18422
18423 =back
18424
18425 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18426
18427 =over 4
18428
18429 =item SYNOPSIS
18430
18431 =item DESCRIPTION
18432
18433 =item CAVEAT
18434
18435 =item SEE ALSO
18436
18437 =item COPYRIGHT AND DISCLAIMERS
18438
18439 =item AUTHOR
18440
18441 =back
18442
18443 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18444
18445 =over 4
18446
18447 =item SYNOPSIS
18448
18449 =item DESCRIPTION
18450
18451 =item SEE ALSO
18452
18453 =item COPYRIGHT AND DISCLAIMERS
18454
18455 =item AUTHOR
18456
18457 =back
18458
18459 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18460
18461 =over 4
18462
18463 =item SYNOPSIS
18464
18465 =item DESCRIPTION
18466
18467 =item SEE ALSO
18468
18469 =item COPYRIGHT AND DISCLAIMERS
18470
18471 =item AUTHOR
18472
18473 =back
18474
18475 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18476
18477 =over 4
18478
18479 =item SYNOPSIS
18480
18481 =item DESCRIPTION
18482
18483 =item CAVEAT
18484
18485 =item SEE ALSO
18486
18487 =item COPYRIGHT AND DISCLAIMERS
18488
18489 =item AUTHOR
18490
18491 =back
18492
18493 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18494
18495 =over 4
18496
18497 =item SYNOPSIS
18498
18499 =item DESCRIPTION
18500
18501 =item SEE ALSO
18502
18503 =item AUTHOR
18504
18505 =back
18506
18507 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18508
18509 =over 4
18510
18511 =item SYNOPSIS
18512
18513 =item DESCRIPTION
18514
18515 =item SEE ALSO
18516
18517 =item COPYRIGHT AND DISCLAIMERS
18518
18519 =item AUTHOR
18520
18521 =back
18522
18523 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18524
18525 =over 4
18526
18527 =item SYNOPSIS
18528
18529 =item DESCRIPTION
18530
18531 alt, indent, loose, sentence, width
18532
18533 =item DIAGNOSTICS
18534
18535 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18536 Unknown sequence: %s, Unmatched =back
18537
18538 =item RESTRICTIONS
18539
18540 =item NOTES
18541
18542 =item SEE ALSO
18543
18544 =item AUTHOR
18545
18546 =back
18547
18548 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18549
18550 =over 4
18551
18552 =item SYNOPSIS
18553
18554 =item DESCRIPTION
18555
18556 =over 4
18557
18558 =item EXPORT
18559
18560 =back
18561
18562 =item AUTHOR
18563
18564 =item SEE ALSO
18565
18566 =back
18567
18568 =head2 Pod::Select, podselect() - extract selected sections of POD from
18569 input
18570
18571 =over 4
18572
18573 =item SYNOPSIS
18574
18575 =item REQUIRES
18576
18577 =item EXPORTS
18578
18579 =item DESCRIPTION
18580
18581 =item SECTION SPECIFICATIONS
18582
18583 =item RANGE SPECIFICATIONS
18584
18585 =back
18586
18587 =over 4
18588
18589 =item OBJECT METHODS
18590
18591 =back
18592
18593 =over 4
18594
18595 =item B<curr_headings()>
18596
18597 =back
18598
18599 =over 4
18600
18601 =item B<select()>
18602
18603 =back
18604
18605 =over 4
18606
18607 =item B<add_selection()>
18608
18609 =back
18610
18611 =over 4
18612
18613 =item B<clear_selections()>
18614
18615 =back
18616
18617 =over 4
18618
18619 =item B<match_section()>
18620
18621 =back
18622
18623 =over 4
18624
18625 =item B<is_selected()>
18626
18627 =back
18628
18629 =over 4
18630
18631 =item EXPORTED FUNCTIONS
18632
18633 =back
18634
18635 =over 4
18636
18637 =item B<podselect()>
18638
18639 B<-output>, B<-sections>, B<-ranges>
18640
18641 =back
18642
18643 =over 4
18644
18645 =item PRIVATE METHODS AND DATA
18646
18647 =back
18648
18649 =over 4
18650
18651 =item B<_compile_section_spec()>
18652
18653 =back
18654
18655 =over 4
18656
18657 =item $self->{_SECTION_HEADINGS}
18658
18659 =back
18660
18661 =over 4
18662
18663 =item $self->{_SELECTED_SECTIONS}
18664
18665 =back
18666
18667 =over 4
18668
18669 =item SEE ALSO
18670
18671 =item AUTHOR
18672
18673 =back
18674
18675 =head2 Pod::Text - Convert POD data to formatted ASCII text
18676
18677 =over 4
18678
18679 =item SYNOPSIS
18680
18681 =item DESCRIPTION
18682
18683 alt, code, indent, loose, margin, quotes, sentence, width
18684
18685 =item DIAGNOSTICS
18686
18687 Bizarre space in item, Item called without tag, Can't open %s for reading:
18688 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
18689 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
18690 Unmatched =back
18691
18692 =item RESTRICTIONS
18693
18694 =item NOTES
18695
18696 =item SEE ALSO
18697
18698 =item AUTHOR
18699
18700 =item COPYRIGHT AND LICENSE
18701
18702 =back
18703
18704 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
18705
18706 =over 4
18707
18708 =item SYNOPSIS
18709
18710 =item DESCRIPTION
18711
18712 =item BUGS
18713
18714 =item SEE ALSO
18715
18716 =item AUTHOR
18717
18718 =item COPYRIGHT AND LICENSE
18719
18720 =back
18721
18722 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
18723 text
18724
18725 =over 4
18726
18727 =item SYNOPSIS
18728
18729 =item DESCRIPTION
18730
18731 =item BUGS
18732
18733 =item SEE ALSO
18734
18735 =item AUTHOR
18736
18737 =item COPYRIGHT AND LICENSE
18738
18739 =back
18740
18741 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
18742 escapes
18743
18744 =over 4
18745
18746 =item SYNOPSIS
18747
18748 =item DESCRIPTION
18749
18750 =item NOTES
18751
18752 =item SEE ALSO
18753
18754 =item AUTHOR
18755
18756 =item COPYRIGHT AND LICENSE
18757
18758 =back
18759
18760 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
18761 documentation
18762
18763 =over 4
18764
18765 =item SYNOPSIS
18766
18767 =item ARGUMENTS
18768
18769 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
18770 C<-pathlist>
18771
18772 =item DESCRIPTION
18773
18774 =item EXAMPLES
18775
18776 =over 4
18777
18778 =item Recommended Use
18779
18780 =back
18781
18782 =item CAVEATS
18783
18784 =item AUTHOR
18785
18786 =item ACKNOWLEDGEMENTS
18787
18788 =back
18789
18790 =head2 SDBM_File - Tied access to sdbm files
18791
18792 =over 4
18793
18794 =item SYNOPSIS
18795
18796 =item DESCRIPTION
18797
18798 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18799
18800 =item DIAGNOSTICS
18801
18802 =over 4
18803
18804 =item C<sdbm store returned -1, errno 22, key "..." at ...>
18805
18806 =back
18807
18808 =item BUGS AND WARNINGS
18809
18810 =back
18811
18812 =head2 Safe - Compile and execute code in restricted compartments
18813
18814 =over 4
18815
18816 =item SYNOPSIS
18817
18818 =item DESCRIPTION
18819
18820 a new namespace, an operator mask
18821
18822 =item WARNING
18823
18824 =over 4
18825
18826 =item RECENT CHANGES
18827
18828 =item Methods in class Safe
18829
18830 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18831 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18832 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18833 root (NAMESPACE), mask (MASK)
18834
18835 =item Some Safety Issues
18836
18837 Memory, CPU, Snooping, Signals, State Changes
18838
18839 =item AUTHOR
18840
18841 =back
18842
18843 =back
18844
18845 =head2 Scalar::Util - A selection of general-utility scalar subroutines
18846
18847 =over 4
18848
18849 =item SYNOPSIS
18850
18851 =item DESCRIPTION
18852
18853 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
18854 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
18855 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
18856
18857 =item KNOWN BUGS
18858
18859 =item COPYRIGHT
18860
18861 =item BLATANT PLUG
18862
18863 =back
18864
18865 =head2 Search::Dict, look - search for key in dictionary file
18866
18867 =over 4
18868
18869 =item SYNOPSIS
18870
18871 =item DESCRIPTION
18872
18873 =back
18874
18875 =head2 SelectSaver - save and restore selected file handle
18876
18877 =over 4
18878
18879 =item SYNOPSIS
18880
18881 =item DESCRIPTION
18882
18883 =back
18884
18885 =head2 SelfLoader - load functions only on demand
18886
18887 =over 4
18888
18889 =item SYNOPSIS
18890
18891 =item DESCRIPTION
18892
18893 =over 4
18894
18895 =item The __DATA__ token
18896
18897 =item SelfLoader autoloading
18898
18899 =item Autoloading and package lexicals
18900
18901 =item SelfLoader and AutoLoader
18902
18903 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
18904
18905 =item Classes and inherited methods.
18906
18907 =back
18908
18909 =item Multiple packages and fully qualified subroutine names
18910
18911 =back
18912
18913 =head2 Shell - run shell commands transparently within perl
18914
18915 =over 4
18916
18917 =item SYNOPSIS
18918
18919 =item DESCRIPTION
18920
18921 =over 4
18922
18923 =item OBJECT ORIENTED SYNTAX
18924
18925 =back
18926
18927 =item AUTHOR
18928
18929 =back
18930
18931 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
18932 socket.h defines and structure manipulators
18933
18934 =over 4
18935
18936 =item SYNOPSIS
18937
18938 =item DESCRIPTION
18939
18940 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
18941 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
18942 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
18943 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
18944 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
18945
18946 =back
18947
18948 =head2 Storable - persistence for Perl data structures
18949
18950 =over 4
18951
18952 =item SYNOPSIS
18953
18954 =item DESCRIPTION
18955
18956 =item MEMORY STORE
18957
18958 =item ADVISORY LOCKING
18959
18960 =item SPEED
18961
18962 =item CANONICAL REPRESENTATION
18963
18964 =item CODE REFERENCES
18965
18966 =item FORWARD COMPATIBILITY
18967
18968 utf8 data, restricted hashes, files from future versions of Storable
18969
18970 =item ERROR REPORTING
18971
18972 =item WIZARDS ONLY
18973
18974 =over 4
18975
18976 =item Hooks
18977
18978 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18979 I<serialized>, ..
18980
18981 =item Predicates
18982
18983 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18984 C<Storable::is_retrieving>
18985
18986 =item Recursion
18987
18988 =item Deep Cloning
18989
18990 =back
18991
18992 =item Storable magic
18993
18994 =item EXAMPLES
18995
18996 =item WARNING
18997
18998 =item BUGS
18999
19000 =over 4
19001
19002 =item 64 bit data in perl 5.6.0 and 5.6.1
19003
19004 =back
19005
19006 =item CREDITS
19007
19008 =item AUTHOR
19009
19010 =item SEE ALSO
19011
19012 =back
19013
19014 =head2 Switch - A switch statement for Perl
19015
19016 =over 4
19017
19018 =item VERSION
19019
19020 =item SYNOPSIS
19021
19022 =item BACKGROUND
19023
19024 =item DESCRIPTION
19025
19026 =over 4
19027
19028 =item Allowing fall-through
19029
19030 =item Automating fall-through
19031
19032 =item Alternative syntax
19033
19034 =item Higher-order Operations
19035
19036 =back
19037
19038 =item DEPENDENCIES
19039
19040 =item AUTHOR
19041
19042 =item BUGS
19043
19044 =item LIMITATION
19045
19046 =item COPYRIGHT
19047
19048 =back
19049
19050 =head2 Symbol - manipulate Perl symbols and their names
19051
19052 =over 4
19053
19054 =item SYNOPSIS
19055
19056 =item DESCRIPTION
19057
19058 =back
19059
19060 =head2 Sys::Hostname - Try every conceivable way to get hostname
19061
19062 =over 4
19063
19064 =item SYNOPSIS
19065
19066 =item DESCRIPTION
19067
19068 =item AUTHOR
19069
19070 =back
19071
19072 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19073 interface to the UNIX syslog(3) calls
19074
19075 =over 4
19076
19077 =item SYNOPSIS
19078
19079 =item DESCRIPTION
19080
19081 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19082 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19083 in 5.004_02), closelog
19084
19085 =item EXAMPLES
19086
19087 =item SEE ALSO
19088
19089 =item AUTHOR
19090
19091 =back
19092
19093 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19094 Perl interface to the UNIX syslog(3) calls
19095
19096 =over 4
19097
19098 =item SYNOPSIS
19099
19100 =item DESCRIPTION
19101
19102 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19103 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19104 in 5.004_02), closelog
19105
19106 =item EXAMPLES
19107
19108 =item SEE ALSO
19109
19110 =item AUTHOR
19111
19112 =back
19113
19114 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19115
19116 =over 4
19117
19118 =item SYNOPSIS
19119
19120 =item DESCRIPTION
19121
19122 =item DIAGNOSTICS
19123
19124 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19125 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19126 comma allowed after filehandle, No name for escape sequence %s
19127
19128 =item ENVIRONMENT
19129
19130 ANSI_COLORS_DISABLED
19131
19132 =item RESTRICTIONS
19133
19134 =item NOTES
19135
19136 =item SEE ALSO
19137
19138 =item AUTHORS
19139
19140 =item COPYRIGHT AND LICENSE
19141
19142 =back
19143
19144 =head2 Term::Cap - Perl termcap interface
19145
19146 =over 4
19147
19148 =item SYNOPSIS
19149
19150 =item DESCRIPTION
19151
19152 =over 4
19153
19154 =item METHODS
19155
19156 =back
19157
19158 =back
19159
19160 B<Tgetent>, OSPEED, TERM
19161
19162 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19163
19164 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19165
19166 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19167
19168 B<Trequire>
19169
19170 =over 4
19171
19172 =item EXAMPLES
19173
19174 =item COPYRIGHT AND LICENSE
19175
19176 =item AUTHOR
19177
19178 =item SEE ALSO
19179
19180 =back
19181
19182 =head2 Term::Complete - Perl word completion module
19183
19184 =over 4
19185
19186 =item SYNOPSIS
19187
19188 =item DESCRIPTION
19189
19190 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19191
19192 =item DIAGNOSTICS
19193
19194 =item BUGS
19195
19196 =item AUTHOR
19197
19198 =back
19199
19200 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19201 If no real package is found, substitutes stubs instead of basic functions.
19202
19203 =over 4
19204
19205 =item SYNOPSIS
19206
19207 =item DESCRIPTION
19208
19209 =item Minimal set of supported functions
19210
19211 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19212 C<findConsole>, Attribs, C<Features>
19213
19214 =item Additional supported functions
19215
19216 C<tkRunning>, C<ornaments>, C<newTTY>
19217
19218 =item EXPORTS
19219
19220 =item ENVIRONMENT
19221
19222 =item CAVEATS
19223
19224 =back
19225
19226 =head2 Test - provides a simple framework for writing test scripts
19227
19228 =over 4
19229
19230 =item SYNOPSIS
19231
19232 =item DESCRIPTION
19233
19234 =item QUICK START GUIDE
19235
19236 =over 4
19237
19238 =item Functions
19239
19240 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19241 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19242
19243 =back
19244
19245 =back
19246
19247 B<_to_value>
19248
19249 C<ok(...)>
19250
19251 C<skip(I<skip_if_true>, I<args...>)>
19252
19253 =over 4
19254
19255 =item TEST TYPES
19256
19257 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19258
19259 =item ONFAIL
19260
19261 =item BUGS and CAVEATS
19262
19263 =item NOTE
19264
19265 =item SEE ALSO
19266
19267 =item AUTHOR
19268
19269 =back
19270
19271 =head2 Test::Builder - Backend for building test libraries
19272
19273 =over 4
19274
19275 =item SYNOPSIS
19276
19277 =item DESCRIPTION
19278
19279 =over 4
19280
19281 =item Construction
19282
19283 B<new>
19284
19285 =back
19286
19287 =back
19288
19289 =over 4
19290
19291 =item Setting up tests
19292
19293 B<exported_to>
19294
19295 =back
19296
19297 B<plan>
19298
19299 B<expected_tests>
19300
19301 B<no_plan>
19302
19303 B<has_plan>
19304
19305 B<skip_all>
19306
19307 =over 4
19308
19309 =item Running tests
19310
19311 B<ok>
19312
19313 =back
19314
19315 B<is_eq>, B<is_num>
19316
19317 B<isnt_eq>, B<isnt_num>
19318
19319 B<like>, B<unlike>
19320
19321 B<maybe_regex>
19322
19323 B<cmp_ok>
19324
19325 B<BAILOUT>
19326
19327 B<skip>
19328
19329 B<todo_skip>
19330
19331 B<skip_rest>
19332
19333 =over 4
19334
19335 =item Test style
19336
19337 B<level>
19338
19339 =back
19340
19341 B<use_numbers>
19342
19343 B<no_header>, B<no_ending>
19344
19345 =over 4
19346
19347 =item Output
19348
19349 B<diag>
19350
19351 =back
19352
19353 B<_print>
19354
19355 B<output>, B<failure_output>, B<todo_output>
19356
19357 =over 4
19358
19359 =item Test Status and Info
19360
19361 B<current_test>
19362
19363 =back
19364
19365 B<summary>
19366
19367 B<details>
19368
19369 B<todo>
19370
19371 B<caller>
19372
19373 B<_sanity_check>
19374
19375 B<_whoa>
19376
19377 B<_my_exit>
19378
19379 =over 4
19380
19381 =item THREADS
19382
19383 =item EXAMPLES
19384
19385 =item SEE ALSO
19386
19387 =item AUTHORS
19388
19389 =item COPYRIGHT
19390
19391 =back
19392
19393 =head2 Test::Harness - run perl standard test scripts with statistics
19394
19395 =over 4
19396
19397 =item SYNOPSIS
19398
19399 =item DESCRIPTION
19400
19401 =over 4
19402
19403 =item The test script output
19404
19405 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19406 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19407 else>
19408
19409 =item Taint mode
19410
19411 =item Configuration variables.
19412
19413 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19414
19415 =item Failure
19416
19417 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19418 Failed>
19419
19420 =item Functions
19421
19422 B<runtests>
19423
19424 =back
19425
19426 =back
19427
19428 B<_all_ok>
19429
19430 B<_globdir>
19431
19432 B<_run_all_tests>
19433
19434 B<_mk_leader>
19435
19436 B<_leader_width>
19437
19438 =over 4
19439
19440 =item EXPORT
19441
19442 =item DIAGNOSTICS
19443
19444 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19445 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19446 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19447 %s>, C<FAILED--Further testing stopped: %s>
19448
19449 =item ENVIRONMENT
19450
19451 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19452 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19453 C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19454
19455 =item EXAMPLE
19456
19457 =item SEE ALSO
19458
19459 =item AUTHORS
19460
19461 =item LICENSE
19462
19463 =item TODO
19464
19465 =item BUGS
19466
19467 =back
19468
19469 =head2 Test::Harness::Assert - simple assert
19470
19471 =over 4
19472
19473 =item SYNOPSIS
19474
19475 =item DESCRIPTION
19476
19477 =over 4
19478
19479 =item Functions
19480
19481 B<assert>
19482
19483 =back
19484
19485 =back
19486
19487 =over 4
19488
19489 =item AUTHOR
19490
19491 =item SEE ALSO
19492
19493 =back
19494
19495 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19496
19497 =over 4
19498
19499 =item SYNOPSIS
19500
19501 =item DESCRIPTION
19502
19503 =back
19504
19505 =head2 Test::Harness::Straps - detailed analysis of test results
19506
19507 =over 4
19508
19509 =item SYNOPSIS
19510
19511 =item DESCRIPTION
19512
19513 =over 4
19514
19515 =item Construction
19516
19517 B<new>
19518
19519 =back
19520
19521 =back
19522
19523 B<_init>
19524
19525 =over 4
19526
19527 =item Analysis
19528
19529 B<analyze>
19530
19531 =back
19532
19533 B<analyze_fh>
19534
19535 B<analyze_file>
19536
19537 B<_switches>
19538
19539 B<_INC2PERL5LIB>
19540
19541 B<_filtered_INC>
19542
19543 B<_restore_PERL5LIB>
19544
19545 =over 4
19546
19547 =item Parsing
19548
19549 B<_is_comment>
19550
19551 =back
19552
19553 B<_is_header>
19554
19555 B<_is_test>
19556
19557 B<_is_bail_out>
19558
19559 B<_reset_file_state>
19560
19561 =over 4
19562
19563 =item Results
19564
19565 B<_detailize>
19566
19567 =back
19568
19569 =over 4
19570
19571 =item EXAMPLES
19572
19573 =item AUTHOR
19574
19575 =item SEE ALSO
19576
19577 =back
19578
19579 =head2 Test::More - yet another framework for writing test scripts
19580
19581 =over 4
19582
19583 =item SYNOPSIS
19584
19585 =item DESCRIPTION
19586
19587 =over 4
19588
19589 =item I love it when a plan comes together
19590
19591 =back
19592
19593 =back
19594
19595 =over 4
19596
19597 =item Test names
19598
19599 =item I'm ok, you're not ok.
19600
19601 B<ok>
19602
19603 =back
19604
19605 B<is>, B<isnt>
19606
19607 B<like>
19608
19609 B<unlike>
19610
19611 B<cmp_ok>
19612
19613 B<can_ok>
19614
19615 B<isa_ok>
19616
19617 B<pass>, B<fail>
19618
19619 =over 4
19620
19621 =item Diagnostics
19622
19623 B<diag>
19624
19625 =back
19626
19627 =over 4
19628
19629 =item Module tests
19630
19631 B<use_ok>
19632
19633 =back
19634
19635 B<require_ok>
19636
19637 =over 4
19638
19639 =item Conditional tests
19640
19641 B<SKIP: BLOCK>
19642
19643 =back
19644
19645 B<TODO: BLOCK>, B<todo_skip>
19646
19647 When do I use SKIP vs. TODO?
19648
19649 =over 4
19650
19651 =item Comparison functions
19652
19653 B<is_deeply>
19654
19655 =back
19656
19657 B<eq_array>
19658
19659 B<eq_hash>
19660
19661 B<eq_set>
19662
19663 =over 4
19664
19665 =item Extending and Embedding Test::More
19666
19667 B<builder>
19668
19669 =back
19670
19671 =over 4
19672
19673 =item NOTES
19674
19675 =item BUGS and CAVEATS
19676
19677 Making your own ok(), The eq_* family has some caveats, Test::Harness
19678 upgrades
19679
19680 =item HISTORY
19681
19682 =item SEE ALSO
19683
19684 =item AUTHORS
19685
19686 =item COPYRIGHT
19687
19688 =back
19689
19690 =head2 Test::Simple - Basic utilities for writing tests.
19691
19692 =over 4
19693
19694 =item SYNOPSIS
19695
19696 =item DESCRIPTION
19697
19698 B<ok>
19699
19700 =back
19701
19702 =over 4
19703
19704 =item EXAMPLE
19705
19706 =item CAVEATS
19707
19708 =item NOTES
19709
19710 =item HISTORY
19711
19712 =item SEE ALSO
19713
19714 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
19715 L<Test::Harness>
19716
19717 =item AUTHORS
19718
19719 =item COPYRIGHT
19720
19721 =back
19722
19723 =head2 Test::Tutorial - A tutorial about writing really basic tests
19724
19725 =over 4
19726
19727 =item DESCRIPTION
19728
19729 =over 4
19730
19731 =item Nuts and bolts of testing.
19732
19733 =item Where to start?
19734
19735 =item Names
19736
19737 =item Test the manual
19738
19739 =item Sometimes the tests are wrong
19740
19741 =item Testing lots of values
19742
19743 =item Informative names
19744
19745 =item Skipping tests
19746
19747 =item Todo tests
19748
19749 =item Testing with taint mode.
19750
19751 =back
19752
19753 =item FOOTNOTES
19754
19755 =item AUTHORS
19756
19757 =item COPYRIGHT
19758
19759 =back
19760
19761 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
19762
19763 =over 4
19764
19765 =item SYNOPSIS
19766
19767 =item DESCRIPTION
19768
19769 =item EXAMPLE
19770
19771 =back
19772
19773 =head2 Text::Balanced - Extract delimited text sequences from strings.
19774
19775 =over 4
19776
19777 =item SYNOPSIS
19778
19779 =item DESCRIPTION
19780
19781 =over 4
19782
19783 =item General behaviour in list contexts
19784
19785 [0], [1], [2]
19786
19787 =item General behaviour in scalar and void contexts
19788
19789 =item A note about prefixes
19790
19791 =item C<extract_delimited>
19792
19793 =item C<extract_bracketed>
19794
19795 =item C<extract_variable>
19796
19797 [0], [1], [2]
19798
19799 =item C<extract_tagged>
19800
19801 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
19802 [0], [1], [2], [3], [4], [5]
19803
19804 =item C<gen_extract_tagged>
19805
19806 =item C<extract_quotelike>
19807
19808 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
19809
19810 =item C<extract_quotelike> and "here documents"
19811
19812 [0], [1], [2], [3], [4], [5], [6], [7..10]
19813
19814 =item C<extract_codeblock>
19815
19816 =item C<extract_multiple>
19817
19818 =item C<gen_delimited_pat>
19819
19820 =back
19821
19822 =item DIAGNOSTICS
19823
19824  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
19825 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
19826 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
19827 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
19828 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
19829 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
19830 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
19831 after dereferencer>, C<Did not find expected opening bracket at %s>,
19832 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
19833 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
19834 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
19835 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
19836 tag>
19837
19838 =item AUTHOR
19839
19840 =item BUGS AND IRRITATIONS
19841
19842 =item COPYRIGHT
19843
19844 =back
19845
19846 =head2 Text::ParseWords - parse text into an array of tokens or array of
19847 arrays
19848
19849 =over 4
19850
19851 =item SYNOPSIS
19852
19853 =item DESCRIPTION
19854
19855 =item EXAMPLES
19856
19857 =item AUTHORS
19858
19859 =back
19860
19861 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
19862 by Knuth
19863
19864 =over 4
19865
19866 =item SYNOPSIS
19867
19868 =item DESCRIPTION
19869
19870 =item EXAMPLES
19871
19872 =item LIMITATIONS
19873
19874 =item AUTHOR
19875
19876 =back
19877
19878 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
19879 unexpand(1)
19880
19881 =over 4
19882
19883 =item SYNOPSIS
19884
19885 =item DESCRIPTION
19886
19887 =item BUGS
19888
19889 =item AUTHOR
19890
19891 =back
19892
19893 =head2 Text::Wrap - line wrapping to form simple paragraphs
19894
19895 =over 4
19896
19897 =item SYNOPSIS
19898
19899 =item DESCRIPTION
19900
19901 =item OVERRIDES
19902
19903 =item EXAMPLE
19904
19905 =item AUTHOR
19906
19907 =back
19908
19909 =head2 Thread - manipulate threads in Perl (for old code only)
19910
19911 =over 4
19912
19913 =item CAVEAT
19914
19915 =item SYNOPSIS
19916
19917 =item DESCRIPTION
19918
19919 =item FUNCTIONS
19920
19921 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
19922 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
19923 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
19924
19925 =item METHODS
19926
19927 join, eval, detach, equal, tid, flags, done
19928
19929 =item LIMITATIONS
19930
19931 =item SEE ALSO
19932
19933 =back
19934
19935 =head2 Thread::Queue - thread-safe queues
19936
19937 =over 4
19938
19939 =item SYNOPSIS
19940
19941 =item DESCRIPTION
19942
19943 =item FUNCTIONS AND METHODS
19944
19945 new, enqueue LIST, dequeue, dequeue_nb, pending
19946
19947 =item SEE ALSO
19948
19949 =back
19950
19951 =head2 Thread::Semaphore - thread-safe semaphores
19952
19953 =over 4
19954
19955 =item SYNOPSIS
19956
19957 =item DESCRIPTION
19958
19959 =item FUNCTIONS AND METHODS
19960
19961 new, new NUMBER, down, down NUMBER, up, up NUMBER
19962
19963 =back
19964
19965 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
19966 (for old code)
19967
19968 =over 4
19969
19970 =item CAVEAT
19971
19972 =item SYNOPSIS
19973
19974 =item DESCRIPTION
19975
19976 =item BUGS
19977
19978 =back
19979
19980 =head2 Thread::Specific - thread-specific keys
19981
19982 =over 4
19983
19984 =item SYNOPSIS
19985
19986 =item DESCRIPTION
19987
19988 =back
19989
19990 =head2 Tie::Array - base class for tied arrays
19991
19992 =over 4
19993
19994 =item SYNOPSIS
19995
19996 =item DESCRIPTION
19997
19998 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19999 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20000 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20001 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20002
20003 =item CAVEATS
20004
20005 =item AUTHOR
20006
20007 =back
20008
20009 =head2 Tie::File - Access the lines of a disk file via a Perl array
20010
20011 =over 4
20012
20013 =item SYNOPSIS
20014
20015 =item DESCRIPTION
20016
20017 =over 4
20018
20019 =item C<recsep>
20020
20021 =item C<autochomp>
20022
20023 =item C<mode>
20024
20025 =item C<memory>
20026
20027 =item C<dw_size>
20028
20029 =item Option Format
20030
20031 =back
20032
20033 =item Public Methods
20034
20035 =over 4
20036
20037 =item C<flock>
20038
20039 =item C<autochomp>
20040
20041 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20042
20043 =item C<offset>
20044
20045 =back
20046
20047 =item Tying to an already-opened filehandle
20048
20049 =item Deferred Writing
20050
20051 =over 4
20052
20053 =item Autodeferring
20054
20055 =back
20056
20057 =item CONCURRENT ACCESS TO FILES
20058
20059 =item CAVEATS
20060
20061 =item SUBCLASSING
20062
20063 =item WHAT ABOUT C<DB_File>?
20064
20065 =item AUTHOR
20066
20067 =item LICENSE
20068
20069 =item WARRANTY
20070
20071 =item THANKS
20072
20073 =item TODO
20074
20075 =back
20076
20077 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20078 handles
20079
20080 =over 4
20081
20082 =item SYNOPSIS
20083
20084 =item DESCRIPTION
20085
20086 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20087 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20088 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20089 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20090
20091 =item MORE INFORMATION
20092
20093 =item COMPATIBILITY
20094
20095 =back
20096
20097 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20098 tied hashes
20099
20100 =over 4
20101
20102 =item SYNOPSIS
20103
20104 =item DESCRIPTION
20105
20106 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20107 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20108
20109 =item Inheriting from B<Tie::StdHash>
20110
20111 =item Inheriting from B<Tie::ExtraHash>
20112
20113 =item C<UNTIE> and C<DESTROY>
20114
20115 =item MORE INFORMATION
20116
20117 =back
20118
20119 =head2 Tie::Memoize - add data to hash when needed
20120
20121 =over 4
20122
20123 =item SYNOPSIS
20124
20125 =item DESCRIPTION
20126
20127 =item Inheriting from B<Tie::Memoize>
20128
20129 =item EXAMPLE
20130
20131 =item BUGS
20132
20133 =item AUTHOR
20134
20135 =back
20136
20137 =head2 Tie::RefHash - use references as hash keys
20138
20139 =over 4
20140
20141 =item SYNOPSIS
20142
20143 =item DESCRIPTION
20144
20145 =item EXAMPLE
20146
20147 =item AUTHOR
20148
20149 =item VERSION
20150
20151 =item SEE ALSO
20152
20153 =back
20154
20155 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20156 scalars
20157
20158 =over 4
20159
20160 =item SYNOPSIS
20161
20162 =item DESCRIPTION
20163
20164 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20165
20166 =item MORE INFORMATION
20167
20168 =back
20169
20170 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20171
20172 =over 4
20173
20174 =item SYNOPSIS
20175
20176 =item DESCRIPTION
20177
20178 =item CAVEATS
20179
20180 =back
20181
20182 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20183 timers
20184
20185 =over 4
20186
20187 =item SYNOPSIS
20188
20189 =item DESCRIPTION
20190
20191 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20192 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20193 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
20194 getitimer ( $which )
20195
20196 =item EXAMPLES
20197
20198 =item C API
20199
20200 =item DIAGNOSTICS
20201
20202 =over 4
20203
20204 =item negative time not invented yet
20205
20206 =item internal error: useconds < 0 (unsigned ... signed ...)
20207
20208 =back
20209
20210 =item CAVEATS
20211
20212 =item AUTHORS
20213
20214 =item COPYRIGHT AND LICENSE
20215
20216 =back
20217
20218 =head2 Time::Local - efficiently compute time from local and GMT time
20219
20220 =over 4
20221
20222 =item SYNOPSIS
20223
20224 =item DESCRIPTION
20225
20226 =item IMPLEMENTATION
20227
20228 =item BUGS
20229
20230 =item SUPPORT
20231
20232 =item AUTHOR
20233
20234 =back
20235
20236 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20237 function
20238
20239 =over 4
20240
20241 =item SYNOPSIS
20242
20243 =item DESCRIPTION
20244
20245 =item NOTE
20246
20247 =item AUTHOR
20248
20249 =back
20250
20251 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20252 function
20253
20254 =over 4
20255
20256 =item SYNOPSIS
20257
20258 =item DESCRIPTION
20259
20260 =item NOTE
20261
20262 =item AUTHOR
20263
20264 =back
20265
20266 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20267
20268 =over 4
20269
20270 =item SYNOPSIS
20271
20272 =item DESCRIPTION
20273
20274 =item AUTHOR
20275
20276 =back
20277
20278 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20279
20280 =over 4
20281
20282 =item SYNOPSIS
20283
20284 =item DESCRIPTION
20285
20286 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20287 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20288 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20289
20290 =item EXPORTS
20291
20292 =back
20293
20294 =head2 Unicode::Collate - Unicode Collation Algorithm
20295
20296 =over 4
20297
20298 =item SYNOPSIS
20299
20300 =item DESCRIPTION
20301
20302 =over 4
20303
20304 =item Constructor and Tailoring
20305
20306 UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
20307 normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
20308 undefName, undefChar, katakana_before_hiragana, upper_before_lower
20309
20310 =item Methods for Collation
20311
20312 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20313 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20314 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20315 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20316 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20317 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20318 $Collator-E<gt>viewSortKey($string)>
20319
20320 =item Methods for Searching
20321
20322 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20323 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20324 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20325 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20326 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20327 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20328 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20329
20330 =item Other Methods
20331
20332 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
20333 Base_Unicode_Version
20334
20335 =item EXPORT
20336
20337 =item CAVEAT
20338
20339 =item Conformance Test
20340
20341 =back
20342
20343 =item AUTHOR
20344
20345 =item SEE ALSO
20346
20347 http://www.unicode.org/reports/tr10/,
20348 http://www.unicode.org/reports/tr10/allkeys.txt,
20349 http://www.unicode.org/reports/tr10/CollationTest.html
20350 http://www.unicode.org/reports/tr10/CollationTest.zip,
20351 http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
20352
20353 =back
20354
20355 =head2 Unicode::Normalize - Unicode Normalization Forms
20356
20357 =over 4
20358
20359 =item SYNOPSIS
20360
20361 =item DESCRIPTION
20362
20363 =over 4
20364
20365 =item Normalization Forms
20366
20367 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20368 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20369 C<$normalized_string = normalize($form_name, $string)>
20370
20371 =item Decomposition and Composition
20372
20373 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20374 decompose($string, $useCompatMapping)>, C<$reordered_string  =
20375 reorder($string)>, C<$composed_string   = compose($string)>
20376
20377 =item Quick Check
20378
20379 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20380 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20381 check($form_name, $string)>
20382
20383 =item Character Data
20384
20385 C<$canonical_decomposed = getCanon($codepoint)>,
20386 C<$compatibility_decomposed = getCompat($codepoint)>,
20387 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20388 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20389 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20390 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20391 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20392
20393 =item EXPORT
20394
20395 =back
20396
20397 =item AUTHOR
20398
20399 =item SEE ALSO
20400
20401 http://www.unicode.org/unicode/reports/tr15/,
20402 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
20403
20404 =back
20405
20406 =head2 Unicode::UCD - Unicode character database
20407
20408 =over 4
20409
20410 =item SYNOPSIS
20411
20412 =item DESCRIPTION
20413
20414 =back
20415
20416 =over 4
20417
20418 =item charinfo
20419
20420 =back
20421
20422 =over 4
20423
20424 =item charblock
20425
20426 =back
20427
20428 =over 4
20429
20430 =item charscript
20431
20432 =back
20433
20434 =over 4
20435
20436 =item charblocks
20437
20438 =back
20439
20440 =over 4
20441
20442 =item charscripts
20443
20444 =back
20445
20446 =over 4
20447
20448 =item Blocks versus Scripts
20449
20450 =item Matching Scripts and Blocks
20451
20452 =item Code Point Arguments
20453
20454 =item charinrange
20455
20456 =back
20457
20458 =over 4
20459
20460 =item compexcl
20461
20462 =back
20463
20464 =over 4
20465
20466 =item casefold
20467
20468 =back
20469
20470 =over 4
20471
20472 =item casespec
20473
20474 =back
20475
20476 =over 4
20477
20478 =item Unicode::UCD::UnicodeVersion
20479
20480 =back
20481
20482 =over 4
20483
20484 =item Implementation Note
20485
20486 =back
20487
20488 =over 4
20489
20490 =item BUGS
20491
20492 =item AUTHOR
20493
20494 =back
20495
20496 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20497 functions
20498
20499 =over 4
20500
20501 =item SYNOPSIS
20502
20503 =item DESCRIPTION
20504
20505 =item NOTE
20506
20507 =item AUTHOR
20508
20509 =back
20510
20511 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20512 functions
20513
20514 =over 4
20515
20516 =item SYNOPSIS
20517
20518 =item DESCRIPTION
20519
20520 =over 4
20521
20522 =item System Specifics
20523
20524 =back
20525
20526 =item NOTE
20527
20528 =item AUTHOR
20529
20530 =item HISTORY
20531
20532 March 18th, 2000
20533
20534 =back
20535
20536 =head2 Win32 - Interfaces to some Win32 API Functions
20537
20538 =over 4
20539
20540 =item DESCRIPTION
20541
20542 =over 4
20543
20544 =item Alphabetical Listing of Win32 Functions
20545
20546 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20547 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20548 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20549 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20550 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20551 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20552 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20553 Win32::GetOSVersion(), Win32::GetOSName(),
20554 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20555 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20556 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20557 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20558 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20559 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20560 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20561 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20562 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
20563 Win32::UnregisterServer(LIBRARYNAME)
20564
20565 =back
20566
20567 =back
20568
20569 =head2 XSLoader - Dynamically load C libraries into Perl code
20570
20571 =over 4
20572
20573 =item SYNOPSIS
20574
20575 =item DESCRIPTION
20576
20577 =item AUTHOR
20578
20579 =back
20580
20581 =head1 AUXILIARY DOCUMENTATION
20582
20583 Here should be listed all the extra programs' documentation, but they
20584 don't all have manual pages yet:
20585
20586 =over 4
20587
20588 =item a2p
20589
20590 =item s2p
20591
20592 =item find2perl
20593
20594 =item h2ph
20595
20596 =item c2ph
20597
20598 =item h2xs
20599
20600 =item xsubpp
20601
20602 =item pod2man
20603
20604 =item wrapsuid
20605
20606 =back
20607
20608 =head1 AUTHOR
20609
20610 Larry Wall <F<larry@wall.org>>, with the help of oodles
20611 of other folks.
20612