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, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2684 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2685 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2686 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
2687 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
2688 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
2689 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
2690 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
2691 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
2692 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
2693 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
2694 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
2695 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
2696 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2697 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
2698 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
2699 ExtUtils::MM_UWIN, 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 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10267
10268 =over 4
10269
10270 =item SYNOPSIS
10271
10272 =item DESCRIPTION
10273
10274 =item EXAMPLE
10275
10276 =item OPTIONS
10277
10278 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10279
10280 =item KNOWN BUGS
10281
10282 =item NOTICE
10283
10284 =item AUTHORS
10285
10286 =back
10287
10288 =head2 CGI - Simple Common Gateway Interface Class
10289
10290 =over 4
10291
10292 =item SYNOPSIS
10293
10294 =item ABSTRACT
10295
10296 =item DESCRIPTION
10297
10298 =over 4
10299
10300 =item PROGRAMMING STYLE
10301
10302 =item CALLING CGI.PM ROUTINES
10303
10304 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10305
10306 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10307
10308 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10309
10310 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10311
10312 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10313
10314 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10315
10316 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10317
10318 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10319
10320 =item DELETING A PARAMETER COMPLETELY:
10321
10322 =item DELETING ALL PARAMETERS:
10323
10324 =item DIRECT ACCESS TO THE PARAMETER LIST:
10325
10326 =item FETCHING THE PARAMETER LIST AS A HASH:
10327
10328 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10329
10330 =item RETRIEVING CGI ERRORS
10331
10332 =item USING THE FUNCTION-ORIENTED INTERFACE
10333
10334 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10335 B<:standard>, B<:all>
10336
10337 =item PRAGMAS
10338
10339 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10340 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10341 -private_tempfiles
10342
10343 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10344
10345 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10346 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10347 a </ul> tag)
10348
10349 =back
10350
10351 =item GENERATING DYNAMIC DOCUMENTS
10352
10353 =over 4
10354
10355 =item CREATING A STANDARD HTTP HEADER:
10356
10357 =item GENERATING A REDIRECTION HEADER
10358
10359 =item CREATING THE HTML DOCUMENT HEADER
10360
10361 B<Parameters:>, 4, 5, 6..
10362
10363 =item ENDING THE HTML DOCUMENT:
10364
10365 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10366
10367 =item OBTAINING THE SCRIPT'S URL
10368
10369 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10370 (B<-query_string>), B<-base>
10371
10372 =item MIXING POST AND URL PARAMETERS
10373
10374 =back
10375
10376 =item CREATING STANDARD HTML ELEMENTS:
10377
10378 =over 4
10379
10380 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10381
10382 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10383
10384 =item HTML SHORTCUTS AND LIST INTERPOLATION
10385
10386 =item NON-STANDARD HTML SHORTCUTS
10387
10388 =item AUTOESCAPING HTML
10389
10390 $escaped_string = escapeHTML("unescaped string");, $charset =
10391 charset([$charset]);, $flag = autoEscape([$flag]);
10392
10393 =item PRETTY-PRINTING HTML
10394
10395 =back
10396
10397 =item CREATING FILL-OUT FORMS:
10398
10399 =over 4
10400
10401 =item CREATING AN ISINDEX TAG
10402
10403 =item STARTING AND ENDING A FORM
10404
10405 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10406
10407 =item CREATING A TEXT FIELD
10408
10409 B<Parameters>
10410
10411 =item CREATING A BIG TEXT FIELD
10412
10413 =item CREATING A PASSWORD FIELD
10414
10415 =item CREATING A FILE UPLOAD FIELD
10416
10417 B<Parameters>
10418
10419 =item CREATING A POPUP MENU
10420
10421 =item CREATING AN OPTION GROUP
10422
10423 =item CREATING A SCROLLING LIST
10424
10425 B<Parameters:>
10426
10427 =item CREATING A GROUP OF RELATED CHECKBOXES
10428
10429 B<Parameters:>
10430
10431 =item CREATING A STANDALONE CHECKBOX
10432
10433 B<Parameters:>
10434
10435 =item CREATING A RADIO BUTTON GROUP
10436
10437 B<Parameters:>
10438
10439 =item CREATING A SUBMIT BUTTON
10440
10441 B<Parameters:>
10442
10443 =item CREATING A RESET BUTTON
10444
10445 =item CREATING A DEFAULT BUTTON
10446
10447 =item CREATING A HIDDEN FIELD
10448
10449 B<Parameters:>
10450
10451 =item CREATING A CLICKABLE IMAGE BUTTON
10452
10453 B<Parameters:>, 3. The third option (-align, optional) is an alignment
10454 type, and may be TOP, BOTTOM or MIDDLE
10455
10456 =item CREATING A JAVASCRIPT ACTION BUTTON
10457
10458 =back
10459
10460 =item HTTP COOKIES
10461
10462 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10463 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10464
10465 =item WORKING WITH FRAMES
10466
10467 1. Create a <Frameset> document, 2. Specify the destination for the
10468 document in the HTTP header, 3. Specify the destination for the document in
10469 the <form> tag
10470
10471 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10472
10473 =item DEBUGGING
10474
10475 =over 4
10476
10477 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10478
10479 =back
10480
10481 =item FETCHING ENVIRONMENT VARIABLES
10482
10483 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10484 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
10485 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
10486 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10487 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10488 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10489
10490 =item USING NPH SCRIPTS
10491
10492 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10493 parameters
10494
10495 =item Server Push
10496
10497 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10498
10499 =item Avoiding Denial of Service Attacks
10500
10501 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10502 basis>, B<2. Globally for all scripts>
10503
10504 =item COMPATIBILITY WITH CGI-LIB.PL
10505
10506 =item AUTHOR INFORMATION
10507
10508 =item CREDITS
10509
10510 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10511 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10512 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10513 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10514 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10515 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10516 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10517 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10518 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10519 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10520 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10521 ...and many many more..
10522
10523 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10524
10525 =item BUGS
10526
10527 =item SEE ALSO
10528
10529 =back
10530
10531 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10532
10533 =over 4
10534
10535 =item SYNOPSIS
10536
10537 =item ABSTRACT
10538
10539 =item DESCRIPTION
10540
10541 =item AUTHOR INFORMATION
10542
10543 =item BUGS
10544
10545 =item SEE ALSO
10546
10547 =back
10548
10549 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10550 other) error log
10551
10552 =over 4
10553
10554 =item SYNOPSIS
10555
10556 =item DESCRIPTION
10557
10558 =item REDIRECTING ERROR MESSAGES
10559
10560 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10561
10562 =over 4
10563
10564 =item Changing the default message
10565
10566 =back
10567
10568 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10569
10570 =item OVERRIDING THE NAME OF THE PROGRAM
10571
10572 =item AUTHORS
10573
10574 =item SEE ALSO
10575
10576 =back
10577
10578 =head2 CGI::Cookie - Interface to Netscape Cookies
10579
10580 =over 4
10581
10582 =item SYNOPSIS
10583
10584 =item DESCRIPTION
10585
10586 =item USING CGI::Cookie
10587
10588 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10589
10590 =over 4
10591
10592 =item Creating New Cookies
10593
10594 =item Sending the Cookie to the Browser
10595
10596 =item Recovering Previous Cookies
10597
10598 =item Manipulating Cookies
10599
10600 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10601
10602 =back
10603
10604 =item AUTHOR INFORMATION
10605
10606 =item BUGS
10607
10608 =item SEE ALSO
10609
10610 =back
10611
10612 =head2 CGI::Fast - CGI Interface for Fast CGI
10613
10614 =over 4
10615
10616 =item SYNOPSIS
10617
10618 =item DESCRIPTION
10619
10620 =item OTHER PIECES OF THE PUZZLE
10621
10622 =item WRITING FASTCGI PERL SCRIPTS
10623
10624 =item INSTALLING FASTCGI SCRIPTS
10625
10626 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10627
10628 =item EXTERNAL FASTCGI SERVER INVOCATION
10629
10630 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10631
10632 =item CAVEATS
10633
10634 =item AUTHOR INFORMATION
10635
10636 =item BUGS
10637
10638 =item SEE ALSO
10639
10640 =back
10641
10642 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10643
10644 =over 4
10645
10646 =item SYNOPSIS
10647
10648 =item DESCRIPTION
10649
10650 =over 4
10651
10652 =item Tags that won't be formatted
10653
10654 =item Customizing the Indenting
10655
10656 =back
10657
10658 =item BUGS
10659
10660 =item AUTHOR
10661
10662 =item SEE ALSO
10663
10664 =back
10665
10666 =head2 CGI::Push - Simple Interface to Server Push
10667
10668 =over 4
10669
10670 =item SYNOPSIS
10671
10672 =item DESCRIPTION
10673
10674 =item USING CGI::Push
10675
10676 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10677
10678 =over 4
10679
10680 =item Heterogeneous Pages
10681
10682 =item Changing the Page Delay on the Fly
10683
10684 =back
10685
10686 =item INSTALLING CGI::Push SCRIPTS
10687
10688 =item AUTHOR INFORMATION
10689
10690 =item BUGS
10691
10692 =item SEE ALSO
10693
10694 =back
10695
10696 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10697
10698 =over 4
10699
10700 =item SYNOPSIS
10701
10702 =item ABSTRACT
10703
10704 =item DESCRIPTION
10705
10706 =item AUTHOR INFORMATION
10707
10708 =item BUGS
10709
10710 =item SEE ALSO
10711
10712 =back
10713
10714 =head2 CGI::Util - Internal utilities used by CGI module
10715
10716 =over 4
10717
10718 =item SYNOPSIS
10719
10720 =item DESCRIPTION
10721
10722 =item AUTHOR INFORMATION
10723
10724 =item SEE ALSO
10725
10726 =back
10727
10728 =head2 CPAN - query, download and build perl modules from CPAN sites
10729
10730 =over 4
10731
10732 =item SYNOPSIS
10733
10734 =item STATUS
10735
10736 =item DESCRIPTION
10737
10738 =over 4
10739
10740 =item Interactive Mode
10741
10742 Searching for authors, bundles, distribution files and modules, make, test,
10743 install, clean  modules or distributions, get, readme, look module or
10744 distribution, ls author, Signals
10745
10746 =item CPAN::Shell
10747
10748 =item autobundle
10749
10750 =item recompile
10751
10752 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10753
10754 =item Programmer's interface
10755
10756 expand($type,@things), expandany(@things), Programming Examples
10757
10758 =item Methods in the other Classes
10759
10760 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10761 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10762 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10763 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10764 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10765 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10766 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10767 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10768 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10769 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10770 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10771 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10772 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10773 CPAN::Distribution::look(), CPAN::Distribution::make(),
10774 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10775 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10776 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10777 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10778 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10779 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10780 CPAN::Module::description(), CPAN::Module::force($method,@args),
10781 CPAN::Module::get(), CPAN::Module::inst_file(),
10782 CPAN::Module::inst_version(), CPAN::Module::install(),
10783 CPAN::Module::look(), CPAN::Module::make(),
10784 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10785 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10786
10787 =item Cache Manager
10788
10789 =item Bundles
10790
10791 =item Prerequisites
10792
10793 =item Finding packages and VERSION
10794
10795 =item Debugging
10796
10797 =item Floppy, Zip, Offline Mode
10798
10799 =back
10800
10801 =item CONFIGURATION
10802
10803 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10804 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10805 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10806 [unshift|push|splice] E<lt>listE<gt>>
10807
10808 =over 4
10809
10810 =item Note on urllist parameter's format
10811
10812 =item urllist parameter has CD-ROM support
10813
10814 =back
10815
10816 =item SECURITY
10817
10818 =item EXPORT
10819
10820 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10821
10822 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10823
10824 =over 4
10825
10826 =item Three basic types of firewalls
10827
10828 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10829
10830 =item Configuring lynx or ncftp for going through a firewall
10831
10832 =back
10833
10834 =item FAQ
10835
10836 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10837
10838 =item BUGS
10839
10840 =item AUTHOR
10841
10842 =item TRANSLATIONS
10843
10844 =item SEE ALSO
10845
10846 =back
10847
10848 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10849
10850 =over 4
10851
10852 =item SYNOPSIS
10853
10854 =item DESCRIPTION
10855
10856 =back
10857
10858 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10859 module
10860
10861 =over 4
10862
10863 =item SYNOPSIS
10864
10865 =item DESCRIPTION
10866
10867 =item  SEE ALSO
10868
10869 =back
10870
10871 =head2 Carp, carp    - warn of errors (from perspective of caller)
10872
10873 =over 4
10874
10875 =item SYNOPSIS
10876
10877 =item DESCRIPTION
10878
10879 =over 4
10880
10881 =item Forcing a Stack Trace
10882
10883 =back
10884
10885 =item BUGS
10886
10887 =back
10888
10889 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10890
10891 =head2 Class::ISA -- report the search path for a class's ISA tree
10892
10893 =over 4
10894
10895 =item SYNOPSIS
10896
10897 =item DESCRIPTION
10898
10899 =item FUNCTIONS
10900
10901 the function Class::ISA::super_path($CLASS), the function
10902 Class::ISA::self_and_super_path($CLASS), the function
10903 Class::ISA::self_and_super_versions($CLASS)
10904
10905 =item CAUTIONARY NOTES
10906
10907 =item COPYRIGHT
10908
10909 =item AUTHOR
10910
10911 =back
10912
10913 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10914
10915 =over 4
10916
10917 =item SYNOPSIS
10918
10919 =item DESCRIPTION
10920
10921 =over 4
10922
10923 =item The C<struct()> function
10924
10925 =item Class Creation at Compile Time
10926
10927 =item Element Types and Accessor Methods
10928
10929 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10930 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10931
10932 =item Initializing with C<new>
10933
10934 =back
10935
10936 =item EXAMPLES
10937
10938 Example 1, Example 2, Example 3
10939
10940 =item Author and Modification History
10941
10942 =back
10943
10944 =head2 Config - access Perl configuration information
10945
10946 =over 4
10947
10948 =item SYNOPSIS
10949
10950 =item DESCRIPTION
10951
10952 myconfig(), config_sh(), config_re($regex), config_vars(@names)
10953
10954 =item EXAMPLE
10955
10956 =item WARNING
10957
10958 =item GLOSSARY
10959
10960 =over 4
10961
10962 =item _
10963
10964 C<_a>, C<_exe>, C<_o>
10965
10966 =item a
10967
10968 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10969 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10970 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10971 C<asctime_r_proto>, C<awk>
10972
10973 =item b
10974
10975 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10976
10977 =item c
10978
10979 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10980 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10981 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10982 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10983 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10984 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10985 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10986
10987 =item d
10988
10989 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
10990 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
10991 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
10992 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
10993 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
10994 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
10995 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
10996 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
10997 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
10998 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
10999 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11000 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11001 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11002 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11003 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11004 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11005 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11006 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11007 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11008 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11009 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11010 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11011 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11012 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11013 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11014 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11015 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11016 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11017 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11018 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11019 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11020 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11021 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11022 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11023 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11024 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11025 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11026 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11027 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11028 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11029 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11030 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11031 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11032 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11033 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11034 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11035 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11036 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11037 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11038 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11039 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11040 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11041 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11042 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11043 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11044 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11045 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11046 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11047 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11048 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11049 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11050 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11051 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11052 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11053 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11054 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11055 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11056 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11057 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11058 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11059 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11060 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11061 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11062 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11063 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11064 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11065 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11066 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11067 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11068 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11069 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11070 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11071 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11072 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11073 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11074 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11075 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11076 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11077 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11078 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11079 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11080 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11081
11082 =item e
11083
11084 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11085 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11086 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11087 C<expr>, C<extensions>, C<extras>
11088
11089 =item f
11090
11091 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11092 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11093 C<full_sed>
11094
11095 =item g
11096
11097 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11098 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11099 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11100 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11101 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11102 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11103 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11104 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11105 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11106 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11107
11108 =item h
11109
11110 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11111 C<html3dir>, C<html3direxp>
11112
11113 =item i
11114
11115 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11116 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11117 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11118 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11119 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11120 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11121 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11122 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11123 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11124 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11125 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11126 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11127 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11128 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11129 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11130 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11131 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11132 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11133 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11134 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11135 C<installprefixexp>, C<installprivlib>, C<installscript>,
11136 C<installsitearch>, C<installsitebin>, C<installsitehtml1>,
11137 C<installsitehtml3>, C<installsitelib>, C<installsiteman1>,
11138 C<installsiteman3>, C<installsitescript>, C<installstyle>,
11139 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11140 C<installvendorhtml1>, C<installvendorhtml3>, C<installvendorlib>,
11141 C<installvendorman1>, C<installvendorman3>, C<installvendorscript>,
11142 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11143
11144 =item k
11145
11146 C<known_extensions>, C<ksh>
11147
11148 =item l
11149
11150 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11151 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11152 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11153 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11154 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11155 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11156 C<lseektype>
11157
11158 =item m
11159
11160 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11161 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11162 C<man3direxp>, C<man3ext>
11163
11164 =item M
11165
11166 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11167 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11168 C<myuname>
11169
11170 =item n
11171
11172 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11173 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11174 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11175 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11176 C<nvsize>, C<nvtype>
11177
11178 =item o
11179
11180 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11181 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11182
11183 =item p
11184
11185 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11186 C<perl>, C<perl_patchlevel>
11187
11188 =item P
11189
11190 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11191 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11192 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
11193 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
11194
11195 =item q
11196
11197 C<quadkind>, C<quadtype>
11198
11199 =item r
11200
11201 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11202 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11203 C<rmail>, C<run>, C<runnm>
11204
11205 =item s
11206
11207 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11208 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11209 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11210 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11211 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11212 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11213 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11214 C<sitebinexp>, C<sitehtml1>, C<sitehtml1exp>, C<sitehtml3>,
11215 C<sitehtml3exp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteman1>,
11216 C<siteman1exp>, C<siteman3>, C<siteman3exp>, C<siteprefix>,
11217 C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, C<sizesize>,
11218 C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, C<socketlib>,
11219 C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, C<sPRId64>,
11220 C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, C<sPRIgldbl>,
11221 C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>,
11222 C<srand48_r_proto>, C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>,
11223 C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
11224 C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
11225 C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, C<submit>,
11226 C<subversion>, C<sysman>
11227
11228 =item t
11229
11230 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11231 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11232 C<ttyname_r_proto>
11233
11234 =item u
11235
11236 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11237 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11238 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11239 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11240 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11241 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11242 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11243 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11244 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11245 C<uvXUformat>
11246
11247 =item v
11248
11249 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11250 C<vendorhtml1>, C<vendorhtml1exp>, C<vendorhtml3>, C<vendorhtml3exp>,
11251 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorman1>,
11252 C<vendorman1exp>, C<vendorman3>, C<vendorman3exp>, C<vendorprefix>,
11253 C<vendorprefixexp>, C<vendorscript>, C<vendorscriptexp>, C<version>,
11254 C<version_patchlevel_string>, C<versiononly>, C<vi>, C<voidflags>
11255
11256 =item x
11257
11258 C<xlibpth>, C<xs_apiversion>
11259
11260 =item y
11261
11262 C<yacc>, C<yaccflags>
11263
11264 =item z
11265
11266 C<zcat>, C<zip>
11267
11268 =back
11269
11270 =item NOTE
11271
11272 =back
11273
11274 =head2 Cwd - get pathname of current working directory
11275
11276 =over 4
11277
11278 =item SYNOPSIS
11279
11280 =item DESCRIPTION
11281
11282 =over 4
11283
11284 =item getcwd and friends
11285
11286 getcwd, cwd, fastcwd, fastgetcwd
11287
11288 =item abs_path and friends
11289
11290 abs_path, realpath, fast_abs_path
11291
11292 =item $ENV{PWD}
11293
11294 =back
11295
11296 =item NOTES
11297
11298 =item SEE ALSO
11299
11300 =back
11301
11302 =head2 DB - programmatic interface to the Perl debugging API (draft,
11303 subject to
11304 change)
11305
11306 =over 4
11307
11308 =item SYNOPSIS
11309
11310 =item DESCRIPTION
11311
11312 =over 4
11313
11314 =item Global Variables
11315
11316  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
11317 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
11318 $DB::lineno
11319
11320 =item API Methods
11321
11322 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11323 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11324
11325 =item Client Callback Methods
11326
11327 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11328 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11329 CLIENT->output(LIST)
11330
11331 =back
11332
11333 =item BUGS
11334
11335 =item AUTHOR
11336
11337 =back
11338
11339 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11340
11341 =over 4
11342
11343 =item SYNOPSIS
11344
11345 =item DESCRIPTION
11346
11347 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11348
11349 =over 4
11350
11351 =item Using DB_File with Berkeley DB version 2 or greater
11352
11353 =item Interface to Berkeley DB
11354
11355 =item Opening a Berkeley DB Database File
11356
11357 =item Default Parameters
11358
11359 =item In Memory Databases
11360
11361 =back
11362
11363 =item DB_HASH
11364
11365 =over 4
11366
11367 =item A Simple Example
11368
11369 =back
11370
11371 =item DB_BTREE
11372
11373 =over 4
11374
11375 =item Changing the BTREE sort order
11376
11377 =item Handling Duplicate Keys
11378
11379 =item The get_dup() Method
11380
11381 =item The find_dup() Method
11382
11383 =item The del_dup() Method
11384
11385 =item Matching Partial Keys
11386
11387 =back
11388
11389 =item DB_RECNO
11390
11391 =over 4
11392
11393 =item The 'bval' Option
11394
11395 =item A Simple Example
11396
11397 =item Extra RECNO Methods
11398
11399 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11400 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11401 length, elements);>
11402
11403 =item Another Example
11404
11405 =back
11406
11407 =item THE API INTERFACE
11408
11409 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11410 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11411 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11412 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11413
11414 =item DBM FILTERS
11415
11416 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11417 B<filter_fetch_value>
11418
11419 =over 4
11420
11421 =item The Filter
11422
11423 =item An Example -- the NULL termination problem.
11424
11425 =item Another Example -- Key is a C int.
11426
11427 =back
11428
11429 =item HINTS AND TIPS
11430
11431 =over 4
11432
11433 =item Locking: The Trouble with fd
11434
11435 =item Safe ways to lock a database
11436
11437 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11438
11439 =item Sharing Databases With C Applications
11440
11441 =item The untie() Gotcha
11442
11443 =back
11444
11445 =item COMMON QUESTIONS
11446
11447 =over 4
11448
11449 =item Why is there Perl source in my database?
11450
11451 =item How do I store complex data structures with DB_File?
11452
11453 =item What does "Invalid Argument" mean?
11454
11455 =item What does "Bareword 'DB_File' not allowed" mean?
11456
11457 =back
11458
11459 =item REFERENCES
11460
11461 =item HISTORY
11462
11463 =item BUGS
11464
11465 =item AVAILABILITY
11466
11467 =item COPYRIGHT
11468
11469 =item SEE ALSO
11470
11471 =item AUTHOR
11472
11473 =back
11474
11475 =head2 Data::Dumper - stringified perl data structures, suitable for both
11476 printing and C<eval>
11477
11478 =over 4
11479
11480 =item SYNOPSIS
11481
11482 =item DESCRIPTION
11483
11484 =over 4
11485
11486 =item Methods
11487
11488 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11489 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11490 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11491 I<$OBJ>->Reset
11492
11493 =item Functions
11494
11495 Dumper(I<LIST>)
11496
11497 =item Configuration Variables or Methods
11498
11499 =item Exports
11500
11501 Dumper
11502
11503 =back
11504
11505 =item EXAMPLES
11506
11507 =item BUGS
11508
11509 =over 4
11510
11511 =item NOTE
11512
11513 =back
11514
11515 =item AUTHOR
11516
11517 =item VERSION
11518
11519 =item SEE ALSO
11520
11521 =back
11522
11523 =head2 Devel::DProf - a Perl code profiler
11524
11525 =over 4
11526
11527 =item SYNOPSIS
11528
11529 =item DESCRIPTION
11530
11531 =item PROFILE FORMAT
11532
11533 =item AUTOLOAD
11534
11535 =item ENVIRONMENT
11536
11537 =item BUGS
11538
11539 =item SEE ALSO
11540
11541 =back
11542
11543 =head2 Devel::PPPort - Perl/Pollution/Portability
11544
11545 =over 4
11546
11547 =item SYNOPSIS
11548
11549 =item DESCRIPTION
11550
11551 =over 4
11552
11553 =item WriteFile
11554
11555 =back
11556
11557 =item ppport.h
11558
11559 =item AUTHOR
11560
11561 =item SEE ALSO
11562
11563 =back
11564
11565 =head2 Devel::Peek - A data debugging tool for the XS programmer
11566
11567 =over 4
11568
11569 =item SYNOPSIS
11570
11571 =item DESCRIPTION
11572
11573 =over 4
11574
11575 =item Runtime debugging
11576
11577 =item Memory footprint debugging
11578
11579 =back
11580
11581 =item EXAMPLES
11582
11583 =over 4
11584
11585 =item A simple scalar string
11586
11587 =item A simple scalar number
11588
11589 =item A simple scalar with an extra reference
11590
11591 =item A reference to a simple scalar
11592
11593 =item A reference to an array
11594
11595 =item A reference to a hash
11596
11597 =item Dumping a large array or hash
11598
11599 =item A reference to an SV which holds a C pointer
11600
11601 =item A reference to a subroutine
11602
11603 =back
11604
11605 =item EXPORTS
11606
11607 =item BUGS
11608
11609 =item AUTHOR
11610
11611 =item SEE ALSO
11612
11613 =back
11614
11615 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11616
11617 =over 4
11618
11619 =item SYNOPSIS
11620
11621 =item DESCRIPTION
11622
11623 =back
11624
11625 =head2 Digest:: - Modules that calculate message digests
11626
11627 =over 4
11628
11629 =item SYNOPSIS
11630
11631 =item DESCRIPTION
11632
11633 I<binary>, I<hex>, I<base64>
11634
11635 =item OO INTERFACE
11636
11637 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11638 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
11639 $ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
11640 $ctx->hexdigest, $ctx->b64digest
11641
11642 =item SEE ALSO
11643
11644 =item AUTHOR
11645
11646 =back
11647
11648 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11649
11650 =over 4
11651
11652 =item SYNOPSIS
11653
11654 =item DESCRIPTION
11655
11656 =item FUNCTIONS
11657
11658 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11659
11660 =item METHODS
11661
11662 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
11663 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11664
11665 =item EXAMPLES
11666
11667 =item SEE ALSO
11668
11669 =item COPYRIGHT
11670
11671 =item AUTHORS
11672
11673 =back
11674
11675 =head2 DirHandle - supply object methods for directory handles
11676
11677 =over 4
11678
11679 =item SYNOPSIS
11680
11681 =item DESCRIPTION
11682
11683 =item NOTES
11684
11685 =back
11686
11687 =head2 Dumpvalue - provides screen dump of Perl data.
11688
11689 =over 4
11690
11691 =item SYNOPSIS
11692
11693 =item DESCRIPTION
11694
11695 =over 4
11696
11697 =item Creation
11698
11699 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11700 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11701 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11702 stopDbSignal
11703
11704 =item Methods
11705
11706 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11707 compactDump, veryCompact, set, get
11708
11709 =back
11710
11711 =back
11712
11713 =head2 DynaLoader - Dynamically load C libraries into Perl code
11714
11715 =over 4
11716
11717 =item SYNOPSIS
11718
11719 =item DESCRIPTION
11720
11721 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11722 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11723 dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
11724 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11725 bootstrap()
11726
11727 =item AUTHOR
11728
11729 =back
11730
11731 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11732 Perl code
11733
11734 =over 4
11735
11736 =item SYNOPSIS
11737
11738 =item DESCRIPTION
11739
11740 =item AUTHOR
11741
11742 =back
11743
11744 =head2 Encode - character encodings
11745
11746 =over 4
11747
11748 =item SYNOPSIS
11749
11750 =over 4
11751
11752 =item Table of Contents
11753
11754 =back
11755
11756 =item DESCRIPTION
11757
11758 =over 4
11759
11760 =item TERMINOLOGY
11761
11762 =back
11763
11764 =item PERL ENCODING API
11765
11766 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11767 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11768 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11769 CHECK]);
11770
11771 =over 4
11772
11773 =item Listing available encodings
11774
11775 =item Defining Aliases
11776
11777 =back
11778
11779 =item Encoding via PerlIO
11780
11781 =item Handling Malformed Data
11782
11783 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11784 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11785 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11786 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11787 bitmask
11788
11789 =over 4
11790
11791 =item Unimplemented fallback schemes
11792
11793 =back
11794
11795 =item Defining Encodings
11796
11797 =item The UTF-8 flag
11798
11799 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11800
11801 =over 4
11802
11803 =item Messing with Perl's Internals
11804
11805 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11806
11807 =back
11808
11809 =item SEE ALSO
11810
11811 =item MAINTAINER
11812
11813 =back
11814
11815 =head2 Encode::Alias - alias definitions to encodings
11816
11817 =over 4
11818
11819 =item SYNOPSIS
11820
11821 =item DESCRIPTION
11822
11823 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11824 reference, e.g.:
11825
11826 =over 4
11827
11828 =item Alias overloading
11829
11830 =back
11831
11832 =item SEE ALSO
11833
11834 =back
11835
11836 =head2 Encode::Byte - Single Byte Encodings
11837
11838 =over 4
11839
11840 =item SYNOPSIS
11841
11842 =item ABSTRACT
11843
11844 =item DESCRIPTION
11845
11846 =item SEE ALSO
11847
11848 =back
11849
11850 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11851
11852 =head2 Encode::CN - China-based Chinese Encodings
11853
11854 =over 4
11855
11856 =item SYNOPSIS
11857
11858 =item DESCRIPTION
11859
11860 =item NOTES
11861
11862 =item BUGS
11863
11864 =item SEE ALSO
11865
11866 =back
11867
11868 =head2 Encode::CN::HZ -- internally used by Encode::CN
11869
11870 =head2 Encode::Config -- internally used by Encode
11871
11872 =head2 Encode::EBCDIC - EBCDIC Encodings
11873
11874 =over 4
11875
11876 =item SYNOPSIS
11877
11878 =item ABSTRACT
11879
11880 =item DESCRIPTION
11881
11882 =item SEE ALSO
11883
11884 =back
11885
11886 =head2 Encode::Encoding - Encode Implementation Base Class
11887
11888 =over 4
11889
11890 =item SYNOPSIS
11891
11892 =item DESCRIPTION
11893
11894 =over 4
11895
11896 =item Methods you should implement
11897
11898 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11899 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11900
11901 =item Other methods defined in Encode::Encodings
11902
11903 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11904
11905 =item Example: Encode::ROT13
11906
11907 =back
11908
11909 =item Why the heck Encode API is different?
11910
11911 =over 4
11912
11913 =item Compiled Encodings
11914
11915 =back
11916
11917 =item SEE ALSO
11918
11919 Scheme 1, Scheme 2, Other Schemes
11920
11921 =back
11922
11923 =head2 Encode::Guess -- Guesses encoding from data
11924
11925 =over 4
11926
11927 =item SYNOPSIS
11928
11929 =item ABSTRACT
11930
11931 =item DESCRIPTION
11932
11933 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11934 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11935 guess_encoding($data, [, I<list of suspects>])
11936
11937 =item CAVEATS
11938
11939 =item TO DO
11940
11941 =item SEE ALSO
11942
11943 =back
11944
11945 =head2 Encode::JP - Japanese Encodings
11946
11947 =over 4
11948
11949 =item SYNOPSIS
11950
11951 =item ABSTRACT
11952
11953 =item DESCRIPTION
11954
11955 =item Note on ISO-2022-JP(-1)?
11956
11957 =item BUGS
11958
11959 =item SEE ALSO
11960
11961 =back
11962
11963 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11964
11965 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11966
11967 =head2 Encode::KR - Korean Encodings
11968
11969 =over 4
11970
11971 =item SYNOPSIS
11972
11973 =item DESCRIPTION
11974
11975 =item BUGS
11976
11977 =item SEE ALSO
11978
11979 =back
11980
11981 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11982
11983 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11984
11985 =over 4
11986
11987 =item SYNOPSIS
11988
11989 =item ABSTRACT
11990
11991 =item DESCRIPTION
11992
11993 =item BUGS
11994
11995 =item SEE ALSO
11996
11997 =back
11998
11999 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12000
12001 =over 4
12002
12003 =item Overview
12004
12005 =item How does it work?
12006
12007 =item Line Buffering
12008
12009 =over 4
12010
12011 =item How can I tell whether my encoding fully supports PerlIO ?
12012
12013 =back
12014
12015 =item SEE ALSO
12016
12017 =back
12018
12019 =head2 Encode::Supported -- Encodings supported by Encode
12020
12021 =over 4
12022
12023 =item DESCRIPTION
12024
12025 =over 4
12026
12027 =item Encoding Names
12028
12029 =back
12030
12031 =item Supported Encodings
12032
12033 =over 4
12034
12035 =item Built-in Encodings
12036
12037 =item Encode::Unicode -- other Unicode encodings
12038
12039 =item Encode::Byte -- Extended ASCII
12040
12041 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12042 the Cyrillic world, gsm0338 - Hentai Latin 1
12043
12044 =item CJK: Chinese, Japanese, Korean (Multibyte)
12045
12046 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12047 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12048 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12049
12050 =item Miscellaneous encodings
12051
12052 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12053
12054 =back
12055
12056 =item Unsupported encodings
12057
12058   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12059 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12060 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12061 Various Mac encodings, (Mac) Indic encodings
12062
12063 =item Encoding vs. Charset -- terminology
12064
12065 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12066
12067 =over 4
12068
12069 =item Microsoft-related naming mess
12070
12071 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12072
12073 =back
12074
12075 =item Glossary
12076
12077 character repertoire, coded character set (CCS), character encoding scheme
12078 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12079 UTF-16
12080
12081 =item See Also
12082
12083 =item References
12084
12085 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12086 RFC, UC, Unicode Glossary
12087
12088 =over 4
12089
12090 =item Other Notable Sites
12091
12092 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12093 "Introduction to i18n"
12094
12095 =item Offline sources
12096
12097 C<CJKV Information Processing> by Ken Lunde
12098
12099 =back
12100
12101 =back
12102
12103 =head2 Encode::Symbol - Symbol Encodings
12104
12105 =over 4
12106
12107 =item SYNOPSIS
12108
12109 =item ABSTRACT
12110
12111 =item DESCRIPTION
12112
12113 =item SEE ALSO
12114
12115 =back
12116
12117 =head2 Encode::TW - Taiwan-based Chinese Encodings
12118
12119 =over 4
12120
12121 =item SYNOPSIS
12122
12123 =item DESCRIPTION
12124
12125 =item NOTES
12126
12127 =item BUGS
12128
12129 =item SEE ALSO
12130
12131 =back
12132
12133 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12134
12135 =over 4
12136
12137 =item SYNOPSIS
12138
12139 =item ABSTRACT
12140
12141 L<http://www.unicode.org/glossary/> says:, Quick Reference
12142
12143 =item Size, Endianness, and BOM
12144
12145 =over 4
12146
12147 =item by size
12148
12149 =item by endianness
12150
12151 BOM as integer when fetched in network byte order
12152
12153 =back
12154
12155 =item Surrogate Pairs
12156
12157 =item SEE ALSO
12158
12159 =back
12160
12161 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12162
12163 =over 4
12164
12165 =item SYNOPSIS
12166
12167 =item ABSTRACT
12168
12169 =item In Practice
12170
12171 =item SEE ALSO
12172
12173 =back
12174
12175 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12176 encodings
12177
12178 =over 4
12179
12180 =item SYNOPSIS
12181
12182 =item DESCRIPTION
12183
12184 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12185 reference, e.g.:
12186
12187 =over 4
12188
12189 =item Alias overloading
12190
12191 =back
12192
12193 =item SEE ALSO
12194
12195 =back
12196
12197 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12198 Internally used by Encode::??::ISO_2022_*
12199
12200 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12201 Encode::CN
12202
12203 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12204 Encode
12205
12206 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12207 Implementation Base Class
12208
12209 =over 4
12210
12211 =item SYNOPSIS
12212
12213 =item DESCRIPTION
12214
12215 =over 4
12216
12217 =item Methods you should implement
12218
12219 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12220 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12221
12222 =item Other methods defined in Encode::Encodings
12223
12224 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12225
12226 =item Example: Encode::ROT13
12227
12228 =back
12229
12230 =item Why the heck Encode API is different?
12231
12232 =over 4
12233
12234 =item Compiled Encodings
12235
12236 =back
12237
12238 =item SEE ALSO
12239
12240 Scheme 1, Scheme 2, Other Schemes
12241
12242 =back
12243
12244 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12245 data
12246
12247 =over 4
12248
12249 =item SYNOPSIS
12250
12251 =item ABSTRACT
12252
12253 =item DESCRIPTION
12254
12255 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12256 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12257 guess_encoding($data, [, I<list of suspects>])
12258
12259 =item CAVEATS
12260
12261 =item TO DO
12262
12263 =item SEE ALSO
12264
12265 =back
12266
12267 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12268 Encode::JP::2022_JP*
12269
12270 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12271 by Encode::JP
12272
12273 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12274 used by Encode::KR
12275
12276 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12277 and 'Q' header encoding
12278
12279 =over 4
12280
12281 =item SYNOPSIS
12282
12283 =item ABSTRACT
12284
12285 =item DESCRIPTION
12286
12287 =item BUGS
12288
12289 =item SEE ALSO
12290
12291 =back
12292
12293 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12294 on Encode and PerlIO
12295
12296 =over 4
12297
12298 =item Overview
12299
12300 =item How does it work?
12301
12302 =item Line Buffering
12303
12304 =over 4
12305
12306 =item How can I tell whether my encoding fully supports PerlIO ?
12307
12308 =back
12309
12310 =item SEE ALSO
12311
12312 =back
12313
12314 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12315 supported by Encode
12316
12317 =over 4
12318
12319 =item DESCRIPTION
12320
12321 =over 4
12322
12323 =item Encoding Names
12324
12325 =back
12326
12327 =item Supported Encodings
12328
12329 =over 4
12330
12331 =item Built-in Encodings
12332
12333 =item Encode::Unicode -- other Unicode encodings
12334
12335 =item Encode::Byte -- Extended ASCII
12336
12337 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12338 the Cyrillic world, gsm0338 - Hentai Latin 1
12339
12340 =item CJK: Chinese, Japanese, Korean (Multibyte)
12341
12342 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12343 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12344 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12345
12346 =item Miscellaneous encodings
12347
12348 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12349
12350 =back
12351
12352 =item Unsupported encodings
12353
12354   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12355 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12356 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12357 Various Mac encodings, (Mac) Indic encodings
12358
12359 =item Encoding vs. Charset -- terminology
12360
12361 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12362
12363 =over 4
12364
12365 =item Microsoft-related naming mess
12366
12367 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12368
12369 =back
12370
12371 =item Glossary
12372
12373 character repertoire, coded character set (CCS), character encoding scheme
12374 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12375 UTF-16
12376
12377 =item See Also
12378
12379 =item References
12380
12381 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12382 RFC, UC, Unicode Glossary
12383
12384 =over 4
12385
12386 =item Other Notable Sites
12387
12388 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12389 "Introduction to i18n"
12390
12391 =item Offline sources
12392
12393 C<CJKV Information Processing> by Ken Lunde
12394
12395 =back
12396
12397 =back
12398
12399 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12400 encoding
12401
12402 =over 4
12403
12404 =item SYNOPSIS
12405
12406 =item ABSTRACT
12407
12408 =item In Practice
12409
12410 =item SEE ALSO
12411
12412 =back
12413
12414 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12415
12416 =over 4
12417
12418 =item SYNOPSIS
12419
12420 =item ABSTRACT
12421
12422 =item Description
12423
12424 =over 4
12425
12426 =item Predefined Methods
12427
12428 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12429 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12430 $e-E<gt>bytes([$encoding])
12431
12432 =item Example: base64 transcoder
12433
12434 =item Operator Overloading
12435
12436 =back
12437
12438 =item SEE ALSO
12439
12440 =back
12441
12442 =head2 Encodencoding, encoding - allows you to write your script in
12443 non-ascii or non-utf8
12444
12445 =over 4
12446
12447 =item SYNOPSIS
12448
12449 =item ABSTRACT
12450
12451 =over 4
12452
12453 =item Literal Conversions
12454
12455 =item PerlIO layers for C<STD(IN|OUT)>
12456
12457 =back
12458
12459 =item FEATURES THAT REQUIRE 5.8.1
12460
12461 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12462
12463 =item USAGE
12464
12465 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12466 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12467
12468 =item The Filter Option
12469
12470 =over 4
12471
12472 =item Filter-related changes at Encode version 1.87
12473
12474 =back
12475
12476 =item CAVEATS
12477
12478 =over 4
12479
12480 =item NOT SCOPED
12481
12482 =item DO NOT MIX MULTIPLE ENCODINGS
12483
12484 =item tr/// with ranges
12485
12486 Legend of characters above
12487
12488 =back
12489
12490 =item EXAMPLE - Greekperl
12491
12492 =item KNOWN PROBLEMS
12493
12494 literals in regex that are longer than 127 bytes, EBCDIC, format
12495
12496 =item HISTORY
12497
12498 =item SEE ALSO
12499
12500 =back
12501
12502 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12503
12504 =over 4
12505
12506 =item SYNOPSIS
12507
12508 =item ABSTRACT
12509
12510 =item Description
12511
12512 =over 4
12513
12514 =item Predefined Methods
12515
12516 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12517 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12518 $e-E<gt>bytes([$encoding])
12519
12520 =item Example: base64 transcoder
12521
12522 =item Operator Overloading
12523
12524 =back
12525
12526 =item SEE ALSO
12527
12528 =back
12529
12530 =head2 English - use nice English (or awk) names for ugly punctuation
12531 variables
12532
12533 =over 4
12534
12535 =item SYNOPSIS
12536
12537 =item DESCRIPTION
12538
12539 =item PERFORMANCE
12540
12541 =back
12542
12543 =head2 Env - perl module that imports environment variables as scalars or
12544 arrays
12545
12546 =over 4
12547
12548 =item SYNOPSIS
12549
12550 =item DESCRIPTION
12551
12552 =item LIMITATIONS
12553
12554 =item AUTHOR
12555
12556 =back
12557
12558 =head2 Errno - System errno constants
12559
12560 =over 4
12561
12562 =item SYNOPSIS
12563
12564 =item DESCRIPTION
12565
12566 =item CAVEATS
12567
12568 =item AUTHOR
12569
12570 =item COPYRIGHT
12571
12572 =back
12573
12574 =head2 Exporter - Implements default import method for modules
12575
12576 =over 4
12577
12578 =item SYNOPSIS
12579
12580 =item DESCRIPTION
12581
12582 =over 4
12583
12584 =item How to Export
12585
12586 =item Selecting What To Export
12587
12588 =item How to Import
12589
12590 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12591
12592 =back
12593
12594 =item Advanced features
12595
12596 =over 4
12597
12598 =item Specialised Import Lists
12599
12600 =item Exporting without using Exporter's import method
12601
12602 =item Module Version Checking
12603
12604 =item Managing Unknown Symbols
12605
12606 =item Tag Handling Utility Functions
12607
12608 =item Generating combined tags
12609
12610 =item C<AUTOLOAD>ed Constants
12611
12612 =back
12613
12614 =back
12615
12616 =head2 Exporter::Heavy - Exporter guts
12617
12618 =over 4
12619
12620 =item SYNOPSIS
12621
12622 =item DESCRIPTION
12623
12624 =back
12625
12626 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12627 Makefiles etc.
12628
12629 =over 4
12630
12631 =item SYNOPSIS
12632
12633 =item DESCRIPTION
12634
12635 =back
12636
12637 cat
12638
12639 eqtime src dst
12640
12641 rm_rf files...
12642
12643 rm_f files...
12644
12645 touch files ..
12646
12647 mv source... destination
12648
12649 cp source... destination
12650
12651 chmod mode files..
12652
12653 mkpath directory..
12654
12655 test_f file
12656
12657 =over 4
12658
12659 =item BUGS
12660
12661 =item SEE ALSO
12662
12663 =item AUTHOR
12664
12665 =back
12666
12667 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12668
12669 =over 4
12670
12671 =item SYNOPSIS
12672
12673 =item DESCRIPTION
12674
12675 B<test_harness>
12676
12677 =back
12678
12679 B<pod2man>
12680
12681 B<warn_if_old_packlist>
12682
12683 B<perllocal_install>
12684
12685 B<uninstall>
12686
12687 =head2 ExtUtils::Constant - generate XS code to import C header constants
12688
12689 =over 4
12690
12691 =item SYNOPSIS
12692
12693 =item DESCRIPTION
12694
12695 =item USAGE
12696
12697 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12698
12699 =item FUNCTIONS
12700
12701 =back
12702
12703 C_stringify NAME
12704
12705 perl_stringify NAME
12706
12707 constant_types
12708
12709 memEQ_clause NAME, CHECKED_AT, INDENT
12710
12711 assign INDENT, TYPE, PRE, POST, VALUE..
12712
12713 return_clause
12714
12715 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12716
12717 params WHAT
12718
12719 dump_names
12720
12721 dogfood
12722
12723 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12724 def_post, utf8
12725
12726 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12727
12728 autoload PACKAGE, VERSION, AUTOLOADER
12729
12730 WriteMakefileSnippet
12731
12732 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12733 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12734
12735 =over 4
12736
12737 =item AUTHOR
12738
12739 =back
12740
12741 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12742
12743 =over 4
12744
12745 =item SYNOPSIS
12746
12747 =item DESCRIPTION
12748
12749 =item @EXPORT
12750
12751 =item FUNCTIONS
12752
12753 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12754 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12755
12756 =item EXAMPLES
12757
12758 =item SEE ALSO
12759
12760 =item AUTHOR
12761
12762 =back
12763
12764 =head2 ExtUtils::Install - install files from here to there
12765
12766 =over 4
12767
12768 =item SYNOPSIS
12769
12770 =item DESCRIPTION
12771
12772 =over 4
12773
12774 =item Functions
12775
12776 B<install>
12777
12778 =back
12779
12780 =back
12781
12782 B<install_default> I<DISCOURAGED>
12783
12784 B<uninstall>
12785
12786 B<pm_to_blib>
12787
12788 _autosplit
12789
12790 =over 4
12791
12792 =item ENVIRONMENT
12793
12794 B<PERL_INSTALL_ROOT>
12795
12796 =item AUTHOR
12797
12798 =item LICENSE
12799
12800 =back
12801
12802 =head2 ExtUtils::Installed - Inventory management of installed modules
12803
12804 =over 4
12805
12806 =item SYNOPSIS
12807
12808 =item DESCRIPTION
12809
12810 =item USAGE
12811
12812 =item FUNCTIONS
12813
12814 new(), modules(), files(), directories(), directory_tree(), validate(),
12815 packlist(), version()
12816
12817 =item EXAMPLE
12818
12819 =item AUTHOR
12820
12821 =back
12822
12823 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12824
12825 =over 4
12826
12827 =item SYNOPSIS
12828
12829 =item DESCRIPTION
12830
12831 For static extensions, For dynamic extensions at build/link time, For
12832 dynamic extensions at load time
12833
12834 =over 4
12835
12836 =item EXTRALIBS
12837
12838 =item LDLOADLIBS and LD_RUN_PATH
12839
12840 =item BSLOADLIBS
12841
12842 =back
12843
12844 =item PORTABILITY
12845
12846 =over 4
12847
12848 =item VMS implementation
12849
12850 =item Win32 implementation
12851
12852 =back
12853
12854 =item SEE ALSO
12855
12856 =back
12857
12858 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12859
12860 =over 4
12861
12862 =item SYNOPSIS
12863
12864 =item DESCRIPTION
12865
12866 =back
12867
12868 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12869
12870 =over 4
12871
12872 =item SYNOPSIS
12873
12874 =item DESCRIPTION
12875
12876 =item Inherently Cross-Platform Methods
12877
12878 installvars
12879
12880 =back
12881
12882 os_flavor_is
12883
12884 =over 4
12885
12886 =item File::Spec wrappers
12887
12888 catfile
12889
12890 =back
12891
12892 =over 4
12893
12894 =item Thought To Be Cross-Platform Methods
12895
12896 B<split_command>
12897
12898 =back
12899
12900 B<echo>
12901
12902 init_VERSION
12903
12904 wraplist
12905
12906 manifypods
12907
12908 manifypods_target
12909
12910 makemakerdflt_target
12911
12912 special_targets
12913
12914 POD2MAN_EXE_macro
12915
12916 test_via_harness
12917
12918 test_via_script
12919
12920 libscan
12921
12922 tool_autosplit
12923
12924 all_target
12925
12926 metafile_target
12927
12928 metafile_addtomanifest_target
12929
12930 =over 4
12931
12932 =item Abstract methods
12933
12934 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
12935 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
12936 platform_constants
12937
12938 =back
12939
12940 os_flavor
12941
12942 =over 4
12943
12944 =item AUTHOR
12945
12946 =back
12947
12948 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12949 ExtUtils::MakeMaker
12950
12951 =over 4
12952
12953 =item SYNOPSIS
12954
12955 =item DESCRIPTION
12956
12957 =back
12958
12959 os_flavor (o)
12960
12961 init_linker
12962
12963 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12964 ExtUtils::MakeMaker
12965
12966 =over 4
12967
12968 =item SYNOPSIS
12969
12970 =item DESCRIPTION
12971
12972 os_flavor (o)
12973
12974 =back
12975
12976 cflags (o)
12977
12978 replace_manpage_separator (o)
12979
12980 init_linker
12981
12982 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12983
12984 =over 4
12985
12986 =item SYNOPSIS
12987
12988 =item DESCRIPTION
12989
12990 =over 4
12991
12992 =item Overridden methods
12993
12994 os_flavor
12995
12996 =back
12997
12998 =back
12999
13000 B<replace_manpage_separator>
13001
13002 =over 4
13003
13004 =item AUTHOR
13005
13006 =item SEE ALSO
13007
13008 =back
13009
13010 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13011 ExtUtils::MakeMaker
13012
13013 =over 4
13014
13015 =item SYNOPSIS
13016
13017 =item DESCRIPTION
13018
13019 =back
13020
13021 maybe_command
13022
13023 guess_name
13024
13025 macify
13026
13027 patternify
13028
13029 init_main
13030
13031 init_others
13032
13033 init_platform, platform_constants
13034
13035 init_dirscan
13036
13037 init_VERSION (o)
13038
13039 special_targets (o)
13040
13041 static (o)
13042
13043 dlsyms (o)
13044
13045 dynamic (o)
13046
13047 clean (o)
13048
13049 clean_subdirs_target
13050
13051 realclean (o)
13052
13053 realclean_subdirs_target
13054
13055 rulez (o)
13056
13057 processPL (o)
13058
13059 os_flavor
13060
13061 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13062 ExtUtils::MakeMaker
13063
13064 =over 4
13065
13066 =item SYNOPSIS
13067
13068 =item DESCRIPTION
13069
13070 =back
13071
13072 os_flavor
13073
13074 init_platform (o), platform_constants
13075
13076 const_cccmd (o)
13077
13078 static_lib (o)
13079
13080 dynamic_lib (o)
13081
13082 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13083 ExtUtils::MakeMaker
13084
13085 =over 4
13086
13087 =item SYNOPSIS
13088
13089 =item DESCRIPTION
13090
13091 =item METHODS
13092
13093 init_dist (o)
13094
13095 =back
13096
13097 init_linker
13098
13099 os_flavor
13100
13101 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13102
13103 =over 4
13104
13105 =item SYNOPSIS
13106
13107 =item DESCRIPTION
13108
13109 =over 4
13110
13111 =item Overridden methods
13112
13113 os_flavor
13114
13115 =back
13116
13117 =back
13118
13119 B<replace_manpage_separator>
13120
13121 =over 4
13122
13123 =item AUTHOR
13124
13125 =item SEE ALSO
13126
13127 =back
13128
13129 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13130
13131 =over 4
13132
13133 =item SYNOPSIS
13134
13135 =item DESCRIPTION
13136
13137 =item METHODS
13138
13139 =back
13140
13141 =over 4
13142
13143 =item Methods
13144
13145 os_flavor (o)
13146
13147 =back
13148
13149 c_o (o)
13150
13151 cflags (o)
13152
13153 clean (o)
13154
13155 clean_subdirs_target
13156
13157 const_cccmd (o)
13158
13159 const_config (o)
13160
13161 const_loadlibs (o)
13162
13163 constants (o)
13164
13165 depend (o)
13166
13167 dir_target (o)
13168
13169 init_DEST
13170
13171 init_dist
13172
13173 dist (o)
13174
13175 dist_basics (o)
13176
13177 dist_ci (o)
13178
13179 dist_core (o)
13180
13181 B<dist_target>
13182
13183 B<tardist_target>
13184
13185 B<zipdist_target>
13186
13187 B<tarfile_target>
13188
13189 zipfile_target
13190
13191 uutardist_target
13192
13193 shdist_target
13194
13195 distdir
13196
13197 dist_test
13198
13199 dlsyms (o)
13200
13201 dynamic (o)
13202
13203 dynamic_bs (o)
13204
13205 dynamic_lib (o)
13206
13207 exescan
13208
13209 extliblist
13210
13211 find_perl
13212
13213 find_tests
13214
13215 =over 4
13216
13217 =item Methods to actually produce chunks of text for the Makefile
13218
13219 fixin
13220
13221 =back
13222
13223 force (o)
13224
13225 guess_name
13226
13227 has_link_code
13228
13229 init_dirscan
13230
13231 init_DIRFILESEP
13232
13233 init_main
13234
13235 init_others
13236
13237 init_INST
13238
13239 init_INSTALL
13240
13241 init_linker
13242
13243 init_lib2arch
13244
13245 init_PERL
13246
13247 init_platform (o), platform_constants (o)
13248
13249 init_PERM
13250
13251 init_xs
13252
13253 install (o)
13254
13255 installbin (o)
13256
13257 linkext (o)
13258
13259 lsdir
13260
13261 macro (o)
13262
13263 makeaperl (o)
13264
13265 makefile (o)
13266
13267 maybe_command
13268
13269 needs_linking (o)
13270
13271 nicetext
13272
13273 parse_abstract
13274
13275 parse_version
13276
13277 pasthru (o)
13278
13279 perl_script
13280
13281 perldepend (o)
13282
13283 perm_rw (o)
13284
13285 perm_rwx (o)
13286
13287 pm_to_blib
13288
13289 post_constants (o)
13290
13291 post_initialize (o)
13292
13293 postamble (o)
13294
13295 ppd
13296
13297 prefixify
13298
13299 processPL (o)
13300
13301 quote_paren
13302
13303 realclean (o)
13304
13305 realclean_subdirs_target
13306
13307 replace_manpage_separator
13308
13309 oneliner (o)
13310
13311 quote_literal
13312
13313 escape_newlines
13314
13315 max_exec_len
13316
13317 static (o)
13318
13319 static_lib (o)
13320
13321 staticmake (o)
13322
13323 subdir_x (o)
13324
13325 subdirs (o)
13326
13327 test (o)
13328
13329 test_via_harness (override)
13330
13331 test_via_script (override)
13332
13333 tools_other (o)
13334
13335 tool_xsubpp (o)
13336
13337 all_target
13338
13339 top_targets (o)
13340
13341 writedoc
13342
13343 xs_c (o)
13344
13345 xs_cpp (o)
13346
13347 xs_o (o)
13348
13349 =over 4
13350
13351 =item SEE ALSO
13352
13353 =back
13354
13355 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13356 ExtUtils::MakeMaker
13357
13358 =over 4
13359
13360 =item SYNOPSIS
13361
13362 =item DESCRIPTION
13363
13364 =over 4
13365
13366 =item Methods always loaded
13367
13368 wraplist
13369
13370 =back
13371
13372 =back
13373
13374 =over 4
13375
13376 =item Methods
13377
13378 guess_name (override)
13379
13380 =back
13381
13382 find_perl (override)
13383
13384 maybe_command (override)
13385
13386 perl_script (override)
13387
13388 replace_manpage_separator
13389
13390 init_DEST
13391
13392 init_DIRFILESEP
13393
13394 init_main (override)
13395
13396 init_others (override)
13397
13398 init_platform (override)
13399
13400 platform_constants
13401
13402 init_VERSION (override)
13403
13404 constants (override)
13405
13406 special_targets
13407
13408 cflags (override)
13409
13410 const_cccmd (override)
13411
13412 tool_sxubpp (override)
13413
13414 tools_other (override)
13415
13416 init_dist (override)
13417
13418 c_o (override)
13419
13420 xs_c (override)
13421
13422 xs_o (override)
13423
13424 dlsyms (override)
13425
13426 dynamic_lib (override)
13427
13428 dynamic_bs (override)
13429
13430 static_lib (override)
13431
13432 processPL (override)
13433
13434 installbin (override)
13435
13436 subdir_x (override)
13437
13438 clean (override)
13439
13440 clean_subdirs_target
13441
13442 realclean (override)
13443
13444 zipfile_target (o), tarfile_target (o), shdist_target (o)
13445
13446 dist_test (override)
13447
13448 install (override)
13449
13450 perldepend (override)
13451
13452 makefile (override)
13453
13454 find_tests (override)
13455
13456 test (override)
13457
13458 makeaperl (override)
13459
13460 nicetext (override)
13461
13462 prefixify (override)
13463
13464 oneliner (o)
13465
13466 B<echo> (o)
13467
13468 quote_literal
13469
13470 escape_newlines
13471
13472 max_exec_len
13473
13474 init_linker (o)
13475
13476 eliminate_macros
13477
13478 fixpath
13479
13480 os_flavor
13481
13482 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13483 ExtUtils::MakeMaker
13484
13485 =over 4
13486
13487 =item SYNOPSIS
13488
13489 =item DESCRIPTION
13490
13491 =back
13492
13493 =over 4
13494
13495 =item Overridden methods
13496
13497 B<dlsyms>
13498
13499 =back
13500
13501 replace_manpage_separator
13502
13503 B<maybe_command>
13504
13505 B<find_tests>
13506
13507 B<init_DIRFILESEP>
13508
13509 B<init_others>
13510
13511 init_platform (o), platform_constants (o)
13512
13513 special_targets (o)
13514
13515 static_lib (o)
13516
13517 dynamic_lib (o)
13518
13519 clean
13520
13521 init_linker
13522
13523 perl_script
13524
13525 xs_o (o)
13526
13527 pasthru (o)
13528
13529 oneliner (o)
13530
13531 max_exec_len
13532
13533 os_flavor
13534
13535 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13536
13537 =over 4
13538
13539 =item SYNOPSIS
13540
13541 =item DESCRIPTION
13542
13543 =over 4
13544
13545 =item Overriden methods
13546
13547 dist_test
13548
13549 =back
13550
13551 =back
13552
13553 subdir_x
13554
13555 xs_c
13556
13557 xs_cpp
13558
13559 xs_o
13560
13561 clean_subdirs_target
13562
13563 realclean_subdirs_target
13564
13565 max_exec_len
13566
13567 os_flavor
13568
13569 =over 4
13570
13571 =item AUTHOR
13572
13573 =back
13574
13575 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13576
13577 =over 4
13578
13579 =item SYNOPSIS
13580
13581 =item DESCRIPTION
13582
13583 =back
13584
13585 =head2 ExtUtils::MakeMaker - Create a module Makefile
13586
13587 =over 4
13588
13589 =item SYNOPSIS
13590
13591 =item DESCRIPTION
13592
13593 =over 4
13594
13595 =item How To Write A Makefile.PL
13596
13597 =item Default Makefile Behaviour
13598
13599 =item make test
13600
13601 =item make testdb
13602
13603 =item make install
13604
13605 =item PREFIX and LIB attribute
13606
13607 =item AFS users
13608
13609 =item Static Linking of a new Perl Binary
13610
13611 =item Determination of Perl Library and Installation Locations
13612
13613 =item Which architecture dependent directory?
13614
13615 =item Using Attributes and Parameters
13616
13617 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13618 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13619 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13620 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13621 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13622 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13623 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13624 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13625 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13626 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13627 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13628 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
13629 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13630 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
13631 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13632 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13633 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
13634 VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
13635
13636 =item Additional lowercase attributes
13637
13638 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
13639 test, tool_autosplit
13640
13641 =item Overriding MakeMaker Methods
13642
13643 =item The End Of Cargo Cult Programming
13644
13645 C<<MAN3PODS => ' '>>
13646
13647 =item Hintsfile support
13648
13649 =item Distribution Support
13650
13651    make distcheck,    make skipcheck,    make distclean,    make manifest,
13652   make distdir,   make disttest,    make tardist,    make dist,    make
13653 uutardist,    make shdist,    make zipdist,    make ci
13654
13655 =item Module Meta-Data
13656
13657 =item Disabling an extension
13658
13659 =item Other Handy Functions
13660
13661 prompt
13662
13663 =back
13664
13665 =item ENVIRONMENT
13666
13667 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13668
13669 =item SEE ALSO
13670
13671 =item AUTHORS
13672
13673 =item LICENSE
13674
13675 =back
13676
13677 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
13678 MakeMaker
13679
13680 =over 4
13681
13682 =item DESCRIPTION
13683
13684 =over 4
13685
13686 =item Philosophy and History
13687
13688 Why not just use <insert other build config tool here>?, What's
13689 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
13690 shell commands, easier to customize, cleaner internals, less cruft
13691
13692 =item Module Writing
13693
13694 How do I keep my $VERSION up to date without resetting it manually?, What's
13695 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
13696
13697 =item XS
13698
13699 How to I prevent "object version X.XX does not match bootstrap parameter
13700 Y.YY" errors?, How do I make two or more XS files coexist in the same
13701 directory?
13702
13703 =back
13704
13705 =item PATCHING
13706
13707 =item AUTHOR
13708
13709 =item SEE ALSO
13710
13711 =back
13712
13713 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
13714
13715 =over 4
13716
13717 =item SYNOPSIS
13718
13719 =item DESCRIPTION
13720
13721 =over 4
13722
13723 =item The Mantra
13724
13725 =item The Layout
13726
13727 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
13728 bin/
13729
13730 =back
13731
13732 =item SEE ALSO
13733
13734 =back
13735
13736 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
13737
13738 =over 4
13739
13740 =item SYNOPSIS
13741
13742 =item DESCRIPTION
13743
13744 =back
13745
13746 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
13747
13748 =over 4
13749
13750 =item SYNOPSIS
13751
13752 =item DESCRIPTION
13753
13754 =back
13755
13756 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13757
13758 =over 4
13759
13760 =item SYNOPSIS
13761
13762 =item DESCRIPTION
13763
13764 =over 4
13765
13766 =item Functions
13767
13768 mkmanifest
13769
13770 =back
13771
13772 =back
13773
13774 manifind
13775
13776 manicheck
13777
13778 filecheck
13779
13780 fullcheck
13781
13782 skipcheck
13783
13784 maniread
13785
13786 manicopy
13787
13788 maniadd
13789
13790 =over 4
13791
13792 =item MANIFEST
13793
13794 =item MANIFEST.SKIP
13795
13796 =item EXPORT_OK
13797
13798 =item GLOBAL VARIABLES
13799
13800 =back
13801
13802 =over 4
13803
13804 =item DIAGNOSTICS
13805
13806 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13807 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13808
13809 =item ENVIRONMENT
13810
13811 B<PERL_MM_MANIFEST_DEBUG>
13812
13813 =item SEE ALSO
13814
13815 =item AUTHOR
13816
13817 =back
13818
13819 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13820
13821 =over 4
13822
13823 =item SYNOPSIS
13824
13825 =item DESCRIPTION
13826
13827 =back
13828
13829 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13830 extension
13831
13832 =over 4
13833
13834 =item SYNOPSIS
13835
13836 =item DESCRIPTION
13837
13838 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13839
13840 =item AUTHOR
13841
13842 =item REVISION
13843
13844 =back
13845
13846 =head2 ExtUtils::Packlist - manage .packlist files
13847
13848 =over 4
13849
13850 =item SYNOPSIS
13851
13852 =item DESCRIPTION
13853
13854 =item USAGE
13855
13856 =item FUNCTIONS
13857
13858 new(), read(), write(), validate(), packlist_file()
13859
13860 =item EXAMPLE
13861
13862 =item AUTHOR
13863
13864 =back
13865
13866 =head2 ExtUtils::testlib - add blib/* directories to @INC
13867
13868 =over 4
13869
13870 =item SYNOPSIS
13871
13872 =item DESCRIPTION
13873
13874 =back
13875
13876 =head2 Fatal - replace functions with equivalents which succeed or die
13877
13878 =over 4
13879
13880 =item SYNOPSIS
13881
13882 =item DESCRIPTION
13883
13884 =item AUTHOR
13885
13886 =back
13887
13888 =head2 Fcntl - load the C Fcntl.h defines
13889
13890 =over 4
13891
13892 =item SYNOPSIS
13893
13894 =item DESCRIPTION
13895
13896 =item NOTE
13897
13898 =item EXPORTED SYMBOLS
13899
13900 =back
13901
13902 =head2 File::Basename, fileparse - split a pathname into pieces
13903
13904 =over 4
13905
13906 =item SYNOPSIS
13907
13908 =item DESCRIPTION
13909
13910 fileparse_set_fstype, fileparse
13911
13912 =item EXAMPLES
13913
13914 C<basename>, C<dirname>
13915
13916 =back
13917
13918 =head2 File::CheckTree, validate - run many filetest checks on a tree
13919
13920 =over 4
13921
13922 =item SYNOPSIS
13923
13924 =item DESCRIPTION
13925
13926 =item AUTHOR
13927
13928 =item HISTORY
13929
13930 =back
13931
13932 =head2 File::Compare - Compare files or filehandles
13933
13934 =over 4
13935
13936 =item SYNOPSIS
13937
13938 =item DESCRIPTION
13939
13940 =item RETURN
13941
13942 =item AUTHOR
13943
13944 =back
13945
13946 =head2 File::Copy - Copy files or filehandles
13947
13948 =over 4
13949
13950 =item SYNOPSIS
13951
13952 =item DESCRIPTION
13953
13954 =over 4
13955
13956 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13957
13958 rmscopy($from,$to[,$date_flag])
13959
13960 =back
13961
13962 =item RETURN
13963
13964 =item NOTES
13965
13966 =item AUTHOR
13967
13968 =back
13969
13970 =head2 File::DosGlob - DOS like globbing and then some
13971
13972 =over 4
13973
13974 =item SYNOPSIS
13975
13976 =item DESCRIPTION
13977
13978 =item NOTES
13979
13980 =item EXPORTS (by request only)
13981
13982 =item BUGS
13983
13984 =item AUTHOR
13985
13986 =item HISTORY
13987
13988 =item SEE ALSO
13989
13990 =back
13991
13992 =head2 File::Find - Traverse a directory tree.
13993
13994 =over 4
13995
13996 =item SYNOPSIS
13997
13998 =item DESCRIPTION
13999
14000 B<find>, B<finddepth>
14001
14002 =over 4
14003
14004 =item %options
14005
14006 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14007 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14008 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14009
14010 =item The wanted function
14011
14012 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14013 filename within that directory, C<$File::Find::name> is the complete
14014 pathname to the file
14015
14016 =back
14017
14018 =item WARNINGS
14019
14020 =item CAVEAT
14021
14022 $dont_use_nlink, symlinks
14023
14024 =item NOTES
14025
14026 =item HISTORY
14027
14028 =back
14029
14030 =head2 File::Glob - Perl extension for BSD glob routine
14031
14032 =over 4
14033
14034 =item SYNOPSIS
14035
14036 =item DESCRIPTION
14037
14038 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14039 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14040 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14041
14042 =item DIAGNOSTICS
14043
14044 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14045
14046 =item NOTES
14047
14048 =item AUTHOR
14049
14050 =back
14051
14052 =head2 File::Path - create or remove directory trees
14053
14054 =over 4
14055
14056 =item SYNOPSIS
14057
14058 =item DESCRIPTION
14059
14060 =item DIAGNOSTICS
14061
14062 =item AUTHORS
14063
14064 =back
14065
14066 =head2 File::Spec - portably perform operations on file names
14067
14068 =over 4
14069
14070 =item SYNOPSIS
14071
14072 =item DESCRIPTION
14073
14074 =item METHODS
14075
14076 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14077 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14078 splitdir, catpath(), abs2rel, rel2abs()
14079
14080 =item SEE ALSO
14081
14082 =item AUTHORS
14083
14084 =back
14085
14086 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14087
14088 =over 4
14089
14090 =item SYNOPSIS
14091
14092 =item DESCRIPTION
14093
14094 =back
14095
14096 canonpath
14097
14098 file_name_is_absolute
14099
14100 tmpdir (override)
14101
14102 =head2 File::Spec::Epoc - methods for Epoc file specs
14103
14104 =over 4
14105
14106 =item SYNOPSIS
14107
14108 =item DESCRIPTION
14109
14110 =item AUTHORS
14111
14112 =back
14113
14114 canonpath()
14115
14116 =over 4
14117
14118 =item SEE ALSO
14119
14120 =back
14121
14122 =head2 File::Spec::Functions - portably perform operations on file names
14123
14124 =over 4
14125
14126 =item SYNOPSIS
14127
14128 =item DESCRIPTION
14129
14130 =over 4
14131
14132 =item Exports
14133
14134 =back
14135
14136 =item SEE ALSO
14137
14138 =back
14139
14140 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14141
14142 =over 4
14143
14144 =item SYNOPSIS
14145
14146 =item DESCRIPTION
14147
14148 =item METHODS
14149
14150 canonpath
14151
14152 =back
14153
14154 catdir()
14155
14156 catfile
14157
14158 curdir
14159
14160 devnull
14161
14162 rootdir
14163
14164 tmpdir
14165
14166 updir
14167
14168 file_name_is_absolute
14169
14170 path
14171
14172 splitpath
14173
14174 splitdir
14175
14176 catpath
14177
14178 abs2rel
14179
14180 rel2abs
14181
14182 =over 4
14183
14184 =item AUTHORS
14185
14186 =item SEE ALSO
14187
14188 =back
14189
14190 tmpdir
14191
14192 canonpath
14193
14194 splitpath
14195
14196 splitdir
14197
14198 catpath
14199
14200 =head2 File::Spec::OS2 - methods for OS/2 file specs
14201
14202 =over 4
14203
14204 =item SYNOPSIS
14205
14206 =item DESCRIPTION
14207
14208 =back
14209
14210 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14211 modules
14212
14213 =over 4
14214
14215 =item SYNOPSIS
14216
14217 =item DESCRIPTION
14218
14219 =item METHODS
14220
14221 canonpath()
14222
14223 =back
14224
14225 catdir()
14226
14227 catfile
14228
14229 curdir
14230
14231 devnull
14232
14233 rootdir
14234
14235 tmpdir
14236
14237 updir
14238
14239 no_upwards
14240
14241 case_tolerant
14242
14243 file_name_is_absolute
14244
14245 path
14246
14247 join
14248
14249 splitpath
14250
14251 splitdir
14252
14253 catpath()
14254
14255 abs2rel
14256
14257 rel2abs()
14258
14259 =over 4
14260
14261 =item SEE ALSO
14262
14263 =back
14264
14265 =head2 File::Spec::VMS - methods for VMS file specs
14266
14267 =over 4
14268
14269 =item SYNOPSIS
14270
14271 =item DESCRIPTION
14272
14273 eliminate_macros
14274
14275 =back
14276
14277 fixpath
14278
14279 =over 4
14280
14281 =item Methods always loaded
14282
14283 canonpath (override)
14284
14285 =back
14286
14287 catdir
14288
14289 catfile
14290
14291 curdir (override)
14292
14293 devnull (override)
14294
14295 rootdir (override)
14296
14297 tmpdir (override)
14298
14299 updir (override)
14300
14301 case_tolerant (override)
14302
14303 path (override)
14304
14305 file_name_is_absolute (override)
14306
14307 splitpath (override)
14308
14309 splitdir (override)
14310
14311 catpath (override)
14312
14313 abs2rel (override)
14314
14315 rel2abs (override)
14316
14317 =over 4
14318
14319 =item SEE ALSO
14320
14321 =back
14322
14323 =head2 File::Spec::Win32 - methods for Win32 file specs
14324
14325 =over 4
14326
14327 =item SYNOPSIS
14328
14329 =item DESCRIPTION
14330
14331 devnull
14332
14333 =back
14334
14335 tmpdir
14336
14337 catfile
14338
14339 canonpath
14340
14341 splitpath
14342
14343 splitdir
14344
14345 catpath
14346
14347 =over 4
14348
14349 =item Note For File::Spec::Win32 Maintainers
14350
14351 =back
14352
14353 =over 4
14354
14355 =item SEE ALSO
14356
14357 =back
14358
14359 =head2 File::Temp - return name and handle of a temporary file safely
14360
14361 =over 4
14362
14363 =item PORTABILITY
14364
14365 =item SYNOPSIS
14366
14367 =item DESCRIPTION
14368
14369 =back
14370
14371 =over 4
14372
14373 =item FUNCTIONS
14374
14375 B<tempfile>
14376
14377 =back
14378
14379 B<tempdir>
14380
14381 =over 4
14382
14383 =item MKTEMP FUNCTIONS
14384
14385 B<mkstemp>
14386
14387 =back
14388
14389 B<mkstemps>
14390
14391 B<mkdtemp>
14392
14393 B<mktemp>
14394
14395 =over 4
14396
14397 =item POSIX FUNCTIONS
14398
14399 B<tmpnam>
14400
14401 =back
14402
14403 B<tmpfile>
14404
14405 =over 4
14406
14407 =item ADDITIONAL FUNCTIONS
14408
14409 B<tempnam>
14410
14411 =back
14412
14413 =over 4
14414
14415 =item UTILITY FUNCTIONS
14416
14417 B<unlink0>
14418
14419 =back
14420
14421 =over 4
14422
14423 =item PACKAGE VARIABLES
14424
14425 B<safe_level>, STANDARD, MEDIUM, HIGH
14426
14427 =back
14428
14429 TopSystemUID
14430
14431 =over 4
14432
14433 =item WARNING
14434
14435 =over 4
14436
14437 =item Temporary files and NFS
14438
14439 =back
14440
14441 =item HISTORY
14442
14443 =item SEE ALSO
14444
14445 =item AUTHOR
14446
14447 =back
14448
14449 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14450
14451 =over 4
14452
14453 =item SYNOPSIS
14454
14455 =item DESCRIPTION
14456
14457 =item BUGS
14458
14459 =item NOTE
14460
14461 =item AUTHOR
14462
14463 =back
14464
14465 =head2 FileCache - keep more files open than the system permits
14466
14467 =over 4
14468
14469 =item SYNOPSIS
14470
14471 =item DESCRIPTION
14472
14473 cacheout EXPR, cacheout MODE, EXPR
14474
14475 =item CAVEATS
14476
14477 =item BUGS
14478
14479 =item NOTES
14480
14481 =back
14482
14483 =head2 FileHandle - supply object methods for filehandles
14484
14485 =over 4
14486
14487 =item SYNOPSIS
14488
14489 =item DESCRIPTION
14490
14491 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14492
14493 =item SEE ALSO
14494
14495 =back
14496
14497 =head2 Filter::Simple - Simplified source filtering
14498
14499 =over 4
14500
14501 =item SYNOPSIS
14502
14503 =item DESCRIPTION
14504
14505 =over 4
14506
14507 =item The Problem
14508
14509 =item A Solution
14510
14511 =item Disabling or changing <no> behaviour
14512
14513 =item All-in-one interface
14514
14515 =item Filtering only specific components of source code
14516
14517 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14518 C<"all">
14519
14520 =item Filtering only the code parts of source code
14521
14522 Most source code ceases to be grammatically correct when it is broken up
14523 into the pieces between string literals and regexes. So the C<'code'>
14524 component filter behaves slightly differently from the other partial
14525 filters
14526 described in the previous section.
14527
14528 =item Using Filter::Simple with an explicit C<import> subroutine
14529
14530 =item Using Filter::Simple and Exporter together
14531
14532 =item How it works
14533
14534 =back
14535
14536 =item AUTHOR
14537
14538 =item COPYRIGHT
14539
14540 =back
14541
14542 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14543
14544 =over 4
14545
14546 =item SYNOPSIS
14547
14548 =item DESCRIPTION
14549
14550 =over 4
14551
14552 =item B<use Filter::Util::Call>
14553
14554 =item B<import()>
14555
14556 =item B<filter() and anonymous sub>
14557
14558 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14559
14560 =back
14561
14562 =item EXAMPLES
14563
14564 =over 4
14565
14566 =item Example 1: A simple filter.
14567
14568 =item Example 2: Using the context
14569
14570 =item Example 3: Using the context within the filter
14571
14572 =item Example 4: Using filter_del
14573
14574 =back
14575
14576 =item Filter::Simple
14577
14578 =item AUTHOR
14579
14580 =item DATE
14581
14582 =back
14583
14584 =head2 FindBin - Locate directory of original perl script
14585
14586 =over 4
14587
14588 =item SYNOPSIS
14589
14590 =item DESCRIPTION
14591
14592 =item EXPORTABLE VARIABLES
14593
14594 =item KNOWN ISSUES
14595
14596 =item KNOWN BUGS
14597
14598 =item AUTHORS
14599
14600 =item COPYRIGHT
14601
14602 =back
14603
14604 =head2 GDBM_File - Perl5 access to the gdbm library.
14605
14606 =over 4
14607
14608 =item SYNOPSIS
14609
14610 =item DESCRIPTION
14611
14612 =item AVAILABILITY
14613
14614 =item BUGS
14615
14616 =item SEE ALSO
14617
14618 =back
14619
14620 =head2 Getopt::Long - Extended processing of command line options
14621
14622 =over 4
14623
14624 =item SYNOPSIS
14625
14626 =item DESCRIPTION
14627
14628 =item Command Line Options, an Introduction
14629
14630 =item Getting Started with Getopt::Long
14631
14632 =over 4
14633
14634 =item Simple options
14635
14636 =item A little bit less simple options
14637
14638 =item Mixing command line option with other arguments
14639
14640 =item Options with values
14641
14642 =item Options with multiple values
14643
14644 =item Options with hash values
14645
14646 =item User-defined subroutines to handle options
14647
14648 =item Options with multiple names
14649
14650 =item Case and abbreviations
14651
14652 =item Summary of Option Specifications
14653
14654 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
14655 + [ I<desttype> ]
14656
14657 =back
14658
14659 =item Advanced Possibilities
14660
14661 =over 4
14662
14663 =item Object oriented interface
14664
14665 =item Thread Safety
14666
14667 =item Documentation and help texts
14668
14669 =item Storing options in a hash
14670
14671 =item Bundling
14672
14673 =item The lonesome dash
14674
14675 =item Argument callback
14676
14677 =back
14678
14679 =item Configuring Getopt::Long
14680
14681 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
14682 require_order, permute, bundling (default: disabled), bundling_override
14683 (default: disabled), ignore_case  (default: enabled), ignore_case_always
14684 (default: disabled), auto_version (default:disabled), auto_help
14685 (default:disabled), pass_through (default: disabled), prefix,
14686 prefix_pattern, debug (default: disabled)
14687
14688 =item Exportable Methods
14689
14690 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
14691
14692 =item Return values and Errors
14693
14694 =item Legacy
14695
14696 =over 4
14697
14698 =item Default destinations
14699
14700 =item Alternative option starters
14701
14702 =item Configuration variables
14703
14704 =back
14705
14706 =item Trouble Shooting
14707
14708 =over 4
14709
14710 =item Warning: Ignoring '!' modifier for short option
14711
14712 =item GetOptions does not return a false result when an option is not
14713 supplied
14714
14715 =item GetOptions does not split the command line correctly
14716
14717 =item Undefined subroutine &main::GetOptions called
14718
14719 =item How do I put a "-?" option into a Getopt::Long?
14720
14721 =back
14722
14723 =item AUTHOR
14724
14725 =item COPYRIGHT AND DISCLAIMER
14726
14727 =back
14728
14729 =head2 Getopt::Std, getopt - Process single-character switches with switch
14730 clustering
14731
14732 =over 4
14733
14734 =item SYNOPSIS
14735
14736 =item DESCRIPTION
14737
14738 =item C<--help> and C<--version>
14739
14740 =back
14741
14742 =head2 Hash::Util - A selection of general-utility hash subroutines
14743
14744 =over 4
14745
14746 =item SYNOPSIS
14747
14748 =item DESCRIPTION
14749
14750 =over 4
14751
14752 =item Restricted hashes
14753
14754 lock_keys, unlock_keys
14755
14756 =back
14757
14758 =back
14759
14760 lock_value, unlock_value
14761
14762 B<lock_hash>, B<unlock_hash>
14763
14764 =over 4
14765
14766 =item CAVEATS
14767
14768 =item AUTHOR
14769
14770 =item SEE ALSO
14771
14772 =back
14773
14774 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14775 locale
14776
14777 =over 4
14778
14779 =item SYNOPSIS
14780
14781 =item DESCRIPTION
14782
14783 =back
14784
14785 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14786 tags
14787
14788 =over 4
14789
14790 =item SYNOPSIS
14791
14792 =item DESCRIPTION
14793
14794 =back
14795
14796 the function is_language_tag($lang1)
14797
14798 the function extract_language_tags($whatever)
14799
14800 the function same_language_tag($lang1, $lang2)
14801
14802 the function similarity_language_tag($lang1, $lang2)
14803
14804 the function is_dialect_of($lang1, $lang2)
14805
14806 the function super_languages($lang1)
14807
14808 the function locale2language_tag($locale_identifier)
14809
14810 the function encode_language_tag($lang1)
14811
14812 the function alternate_language_tags($lang1)
14813
14814 the function @langs = panic_languages(@accept_languages)
14815
14816 =over 4
14817
14818 =item ABOUT LOWERCASING
14819
14820 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14821
14822 =item SEE ALSO
14823
14824 =item COPYRIGHT
14825
14826 =item AUTHOR
14827
14828 =back
14829
14830 =head2 I18N::LangTags::List -- tags and names for human languages
14831
14832 =over 4
14833
14834 =item SYNOPSIS
14835
14836 =item DESCRIPTION
14837
14838 =item ABOUT LANGUAGE TAGS
14839
14840 =item LIST OF LANGUAGES
14841
14842 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
14843 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
14844 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
14845 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
14846 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
14847 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
14848 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
14849 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
14850 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
14851 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
14852 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
14853 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
14854 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
14855 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
14856 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
14857 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
14858 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
14859 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
14860 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
14861 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
14862 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
14863 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
14864 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
14865 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
14866 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
14867 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
14868 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
14869 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
14870 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
14871 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
14872 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
14873 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
14874 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
14875 English, {enm} : Old English (1100-1500), {ang} : Old English
14876 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
14877 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
14878 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
14879 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
14880 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
14881 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
14882 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
14883 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
14884 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
14885 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
14886 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
14887 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
14888 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14889 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14890 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
14891 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
14892 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
14893 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
14894 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
14895 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
14896 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
14897 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
14898 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
14899 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
14900 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
14901 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
14902 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
14903 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
14904 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
14905 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
14906 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
14907 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
14908 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
14909 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
14910 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
14911 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
14912 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
14913 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
14914 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
14915 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
14916 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
14917 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
14918 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
14919 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
14920 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
14921 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
14922 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14923 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14924 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
14925 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
14926 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
14927 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
14928 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14929 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14930 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14931 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14932 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14933 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14934 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14935 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14936 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14937 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14938 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
14939 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
14940 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
14941 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
14942 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
14943 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
14944 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
14945 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
14946 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
14947 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
14948 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
14949 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
14950 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
14951 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
14952 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
14953 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
14954 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
14955 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
14956 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
14957 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
14958 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
14959 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
14960 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
14961 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
14962 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
14963 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
14964 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
14965 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
14966 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
14967 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
14968 {zun} : Zuni
14969
14970 =item SEE ALSO
14971
14972 =item COPYRIGHT AND DISCLAIMER
14973
14974 =item AUTHOR
14975
14976 =back
14977
14978 =head2 I18N::Langinfo - query locale information
14979
14980 =over 4
14981
14982 =item SYNOPSIS
14983
14984 =item DESCRIPTION
14985
14986 =over 4
14987
14988 =item EXPORT
14989
14990 =back
14991
14992 =item SEE ALSO
14993
14994 =item AUTHOR
14995
14996 =item COPYRIGHT AND LICENSE
14997
14998 =back
14999
15000 =head2 IO - load various IO modules
15001
15002 =over 4
15003
15004 =item SYNOPSIS
15005
15006 =item DESCRIPTION
15007
15008 =item DEPRECATED
15009
15010 =back
15011
15012 =head2 IO::Dir - supply object methods for directory handles
15013
15014 =over 4
15015
15016 =item SYNOPSIS
15017
15018 =item DESCRIPTION
15019
15020 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15021 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15022
15023 =item SEE ALSO
15024
15025 =item AUTHOR
15026
15027 =item COPYRIGHT
15028
15029 =back
15030
15031 =head2 IO::File - supply object methods for filehandles
15032
15033 =over 4
15034
15035 =item SYNOPSIS
15036
15037 =item DESCRIPTION
15038
15039 =item CONSTRUCTOR
15040
15041 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15042
15043 =item METHODS
15044
15045 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15046
15047 =item SEE ALSO
15048
15049 =item HISTORY
15050
15051 =back
15052
15053 =head2 IO::Handle - supply object methods for I/O handles
15054
15055 =over 4
15056
15057 =item SYNOPSIS
15058
15059 =item DESCRIPTION
15060
15061 =item CONSTRUCTOR
15062
15063 new (), new_from_fd ( FD, MODE )
15064
15065 =item METHODS
15066
15067 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15068 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15069 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15070 $io->blocking ( [ BOOL ] ), $io->untaint
15071
15072 =item NOTE
15073
15074 =item SEE ALSO
15075
15076 =item BUGS
15077
15078 =item HISTORY
15079
15080 =back
15081
15082 =head2 IO::Pipe - supply object methods for pipes
15083
15084 =over 4
15085
15086 =item SYNOPSIS
15087
15088 =item DESCRIPTION
15089
15090 =item CONSTRUCTOR
15091
15092 new ( [READER, WRITER] )
15093
15094 =item METHODS
15095
15096 reader ([ARGS]), writer ([ARGS]), handles ()
15097
15098 =item SEE ALSO
15099
15100 =item AUTHOR
15101
15102 =item COPYRIGHT
15103
15104 =back
15105
15106 =head2 IO::Poll - Object interface to system poll call
15107
15108 =over 4
15109
15110 =item SYNOPSIS
15111
15112 =item DESCRIPTION
15113
15114 =item METHODS
15115
15116 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15117 IO ), handles( [ EVENT_MASK ] )
15118
15119 =item SEE ALSO
15120
15121 =item AUTHOR
15122
15123 =item COPYRIGHT
15124
15125 =back
15126
15127 =head2 IO::Seekable - supply seek based methods for I/O objects
15128
15129 =over 4
15130
15131 =item SYNOPSIS
15132
15133 =item DESCRIPTION
15134
15135 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15136 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15137 $io->tell
15138
15139 =item SEE ALSO
15140
15141 =item HISTORY
15142
15143 =back
15144
15145 =head2 IO::Select - OO interface to the select system call
15146
15147 =over 4
15148
15149 =item SYNOPSIS
15150
15151 =item DESCRIPTION
15152
15153 =item CONSTRUCTOR
15154
15155 new ( [ HANDLES ] )
15156
15157 =item METHODS
15158
15159 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15160 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15161 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15162
15163 =item EXAMPLE
15164
15165 =item AUTHOR
15166
15167 =item COPYRIGHT
15168
15169 =back
15170
15171 =head2 IO::Socket - Object interface to socket communications
15172
15173 =over 4
15174
15175 =item SYNOPSIS
15176
15177 =item DESCRIPTION
15178
15179 =item CONSTRUCTOR
15180
15181 new ( [ARGS] )
15182
15183 =item METHODS
15184
15185 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15186 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15187
15188 =item SEE ALSO
15189
15190 =item AUTHOR
15191
15192 =item COPYRIGHT
15193
15194 =back
15195
15196 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15197
15198 =over 4
15199
15200 =item SYNOPSIS
15201
15202 =item DESCRIPTION
15203
15204 =item CONSTRUCTOR
15205
15206 new ( [ARGS] )
15207
15208 =over 4
15209
15210 =item METHODS
15211
15212 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15213 ()
15214
15215 =back
15216
15217 =item SEE ALSO
15218
15219 =item AUTHOR
15220
15221 =item COPYRIGHT
15222
15223 =back
15224
15225 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15226
15227 =over 4
15228
15229 =item SYNOPSIS
15230
15231 =item DESCRIPTION
15232
15233 =item CONSTRUCTOR
15234
15235 new ( [ARGS] )
15236
15237 =item METHODS
15238
15239 hostpath(), peerpath()
15240
15241 =item SEE ALSO
15242
15243 =item AUTHOR
15244
15245 =item COPYRIGHT
15246
15247 =back
15248
15249 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15250 handles
15251
15252 =over 4
15253
15254 =item SYNOPSIS
15255
15256 =item DESCRIPTION
15257
15258 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15259 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15260
15261 =item SEE ALSO
15262
15263 =item AUTHOR
15264
15265 =item COPYRIGHT
15266
15267 =back
15268
15269 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15270
15271 =over 4
15272
15273 =item SYNOPSIS
15274
15275 =item DESCRIPTION
15276
15277 =item CONSTRUCTOR
15278
15279 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15280
15281 =item METHODS
15282
15283 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15284
15285 =item SEE ALSO
15286
15287 =item HISTORY
15288
15289 =back
15290
15291 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15292 handles
15293
15294 =over 4
15295
15296 =item SYNOPSIS
15297
15298 =item DESCRIPTION
15299
15300 =item CONSTRUCTOR
15301
15302 new (), new_from_fd ( FD, MODE )
15303
15304 =item METHODS
15305
15306 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15307 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15308 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15309 $io->blocking ( [ BOOL ] ), $io->untaint
15310
15311 =item NOTE
15312
15313 =item SEE ALSO
15314
15315 =item BUGS
15316
15317 =item HISTORY
15318
15319 =back
15320
15321 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15322
15323 =over 4
15324
15325 =item SYNOPSIS
15326
15327 =item DESCRIPTION
15328
15329 =item CONSTRUCTOR
15330
15331 new ( [READER, WRITER] )
15332
15333 =item METHODS
15334
15335 reader ([ARGS]), writer ([ARGS]), handles ()
15336
15337 =item SEE ALSO
15338
15339 =item AUTHOR
15340
15341 =item COPYRIGHT
15342
15343 =back
15344
15345 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15346
15347 =over 4
15348
15349 =item SYNOPSIS
15350
15351 =item DESCRIPTION
15352
15353 =item METHODS
15354
15355 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15356 IO ), handles( [ EVENT_MASK ] )
15357
15358 =item SEE ALSO
15359
15360 =item AUTHOR
15361
15362 =item COPYRIGHT
15363
15364 =back
15365
15366 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15367 I/O objects
15368
15369 =over 4
15370
15371 =item SYNOPSIS
15372
15373 =item DESCRIPTION
15374
15375 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15376 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15377 $io->tell
15378
15379 =item SEE ALSO
15380
15381 =item HISTORY
15382
15383 =back
15384
15385 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15386 call
15387
15388 =over 4
15389
15390 =item SYNOPSIS
15391
15392 =item DESCRIPTION
15393
15394 =item CONSTRUCTOR
15395
15396 new ( [ HANDLES ] )
15397
15398 =item METHODS
15399
15400 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15401 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15402 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15403
15404 =item EXAMPLE
15405
15406 =item AUTHOR
15407
15408 =item COPYRIGHT
15409
15410 =back
15411
15412 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15413 communications
15414
15415 =over 4
15416
15417 =item SYNOPSIS
15418
15419 =item DESCRIPTION
15420
15421 =item CONSTRUCTOR
15422
15423 new ( [ARGS] )
15424
15425 =item METHODS
15426
15427 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15428 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15429
15430 =item SEE ALSO
15431
15432 =item AUTHOR
15433
15434 =item COPYRIGHT
15435
15436 =back
15437
15438 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15439 AF_INET domain sockets
15440
15441 =over 4
15442
15443 =item SYNOPSIS
15444
15445 =item DESCRIPTION
15446
15447 =item CONSTRUCTOR
15448
15449 new ( [ARGS] )
15450
15451 =over 4
15452
15453 =item METHODS
15454
15455 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15456 ()
15457
15458 =back
15459
15460 =item SEE ALSO
15461
15462 =item AUTHOR
15463
15464 =item COPYRIGHT
15465
15466 =back
15467
15468 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15469 AF_UNIX domain sockets
15470
15471 =over 4
15472
15473 =item SYNOPSIS
15474
15475 =item DESCRIPTION
15476
15477 =item CONSTRUCTOR
15478
15479 new ( [ARGS] )
15480
15481 =item METHODS
15482
15483 hostpath(), peerpath()
15484
15485 =item SEE ALSO
15486
15487 =item AUTHOR
15488
15489 =item COPYRIGHT
15490
15491 =back
15492
15493 =head2 IPC::Msg - SysV Msg IPC object class
15494
15495 =over 4
15496
15497 =item SYNOPSIS
15498
15499 =item DESCRIPTION
15500
15501 =item METHODS
15502
15503 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15504 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15505 FLAGS ] ), stat
15506
15507 =item SEE ALSO
15508
15509 =item AUTHOR
15510
15511 =item COPYRIGHT
15512
15513 =back
15514
15515 =head2 IPC::Open2, open2 - open a process for both reading and writing
15516
15517 =over 4
15518
15519 =item SYNOPSIS
15520
15521 =item DESCRIPTION
15522
15523 =item WARNING
15524
15525 =item SEE ALSO
15526
15527 =back
15528
15529 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15530 handling
15531
15532 =over 4
15533
15534 =item SYNOPSIS
15535
15536 =item DESCRIPTION
15537
15538 =item WARNING
15539
15540 =back
15541
15542 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15543
15544 =over 4
15545
15546 =item SYNOPSIS
15547
15548 =item DESCRIPTION
15549
15550 =item METHODS
15551
15552 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15553 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15554 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15555 , VALUE ), stat
15556
15557 =item SEE ALSO
15558
15559 =item AUTHOR
15560
15561 =item COPYRIGHT
15562
15563 =back
15564
15565 =head2 IPC::SysV - SysV IPC constants
15566
15567 =over 4
15568
15569 =item SYNOPSIS
15570
15571 =item DESCRIPTION
15572
15573 ftok( PATH, ID )
15574
15575 =item SEE ALSO
15576
15577 =item AUTHORS
15578
15579 =item COPYRIGHT
15580
15581 =back
15582
15583 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15584
15585 =over 4
15586
15587 =item SYNOPSIS
15588
15589 =item DESCRIPTION
15590
15591 =item METHODS
15592
15593 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15594 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15595 FLAGS ] ), stat
15596
15597 =item SEE ALSO
15598
15599 =item AUTHOR
15600
15601 =item COPYRIGHT
15602
15603 =back
15604
15605 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15606 class
15607
15608 =over 4
15609
15610 =item SYNOPSIS
15611
15612 =item DESCRIPTION
15613
15614 =item METHODS
15615
15616 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15617 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15618 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15619 , VALUE ), stat
15620
15621 =item SEE ALSO
15622
15623 =item AUTHOR
15624
15625 =item COPYRIGHT
15626
15627 =back
15628
15629 =head2 List::Util - A selection of general-utility list subroutines
15630
15631 =over 4
15632
15633 =item SYNOPSIS
15634
15635 =item DESCRIPTION
15636
15637 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15638 BLOCK LIST, shuffle LIST, sum LIST
15639
15640 =item KNOWN BUGS
15641
15642 =item SUGGESTED ADDITIONS
15643
15644 =item COPYRIGHT
15645
15646 =back
15647
15648 =head2 List::Utilib::List::Util, List::Util - A selection of
15649 general-utility list subroutines
15650
15651 =over 4
15652
15653 =item SYNOPSIS
15654
15655 =item DESCRIPTION
15656
15657 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15658 BLOCK LIST, shuffle LIST, sum LIST
15659
15660 =item KNOWN BUGS
15661
15662 =item SUGGESTED ADDITIONS
15663
15664 =item COPYRIGHT
15665
15666 =back
15667
15668 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
15669 general-utility scalar subroutines
15670
15671 =over 4
15672
15673 =item SYNOPSIS
15674
15675 =item DESCRIPTION
15676
15677 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
15678 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
15679 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
15680
15681 =item KNOWN BUGS
15682
15683 =item COPYRIGHT
15684
15685 =item BLATANT PLUG
15686
15687 =back
15688
15689 =head2 Locale::Constants - constants for Locale codes
15690
15691 =over 4
15692
15693 =item SYNOPSIS
15694
15695 =item DESCRIPTION
15696
15697 =item KNOWN BUGS AND LIMITATIONS
15698
15699 =item SEE ALSO
15700
15701 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
15702
15703 =item AUTHOR
15704
15705 =item COPYRIGHT
15706
15707 =back
15708
15709 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
15710
15711 =over 4
15712
15713 =item SYNOPSIS
15714
15715 =item DESCRIPTION
15716
15717 B<alpha-2>, B<alpha-3>, B<numeric>
15718
15719 =item CONVERSION ROUTINES
15720
15721 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
15722 country_code2code( CODE, CODESET, CODESET )
15723
15724 =item QUERY ROUTINES
15725
15726 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
15727
15728 =item SEMI-PRIVATE ROUTINES
15729
15730 =over 4
15731
15732 =item alias_code
15733
15734 =item rename_country
15735
15736 =back
15737
15738 =item EXAMPLES
15739
15740 =item DOMAIN NAMES
15741
15742 =item KNOWN BUGS AND LIMITATIONS
15743
15744 =item SEE ALSO
15745
15746 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
15747 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
15748 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
15749 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
15750
15751 =item AUTHOR
15752
15753 =item COPYRIGHT
15754
15755 =back
15756
15757 =head2 Locale::Currency - ISO three letter codes for currency
15758 identification (ISO 4217)
15759
15760 =over 4
15761
15762 =item SYNOPSIS
15763
15764 =item DESCRIPTION
15765
15766 XTS, XXX
15767
15768 =item CONVERSION ROUTINES
15769
15770 code2currency(), currency2code()
15771
15772 =item QUERY ROUTINES
15773
15774 C<all_currency_codes()>, C<all_currency_names()>
15775
15776 =item EXAMPLES
15777
15778 =item KNOWN BUGS AND LIMITATIONS
15779
15780 =item SEE ALSO
15781
15782 Locale::Country, Locale::Script, ISO 4217:1995,
15783 http://www.bsi-global.com/iso4217currency
15784
15785 =item AUTHOR
15786
15787 =item COPYRIGHT
15788
15789 =back
15790
15791 =head2 Locale::Language - ISO two letter codes for language identification
15792 (ISO 639)
15793
15794 =over 4
15795
15796 =item SYNOPSIS
15797
15798 =item DESCRIPTION
15799
15800 =item CONVERSION ROUTINES
15801
15802 code2language(), language2code()
15803
15804 =item QUERY ROUTINES
15805
15806 C<all_language_codes()>, C<all_language_names()>
15807
15808 =item EXAMPLES
15809
15810 =item KNOWN BUGS AND LIMITATIONS
15811
15812 =item SEE ALSO
15813
15814 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15815 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15816
15817 =item AUTHOR
15818
15819 =item COPYRIGHT
15820
15821 =back
15822
15823 =head2 Locale::Maketext - framework for localization
15824
15825 =over 4
15826
15827 =item SYNOPSIS
15828
15829 =item DESCRIPTION
15830
15831 =item QUICK OVERVIEW
15832
15833 =item METHODS
15834
15835 =over 4
15836
15837 =item Construction Methods
15838
15839 =item The "maketext" Method
15840
15841 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15842
15843 =item Utility Methods
15844
15845 $language->quant($number, $singular), $language->quant($number, $singular,
15846 $plural), $language->quant($number, $singular, $plural, $negative),
15847 $language->numf($number), $language->sprintf($format, @items),
15848 $language->language_tag(), $language->encoding()
15849
15850 =item Language Handle Attributes and Internals
15851
15852 =back
15853
15854 =item LANGUAGE CLASS HIERARCHIES
15855
15856 =item ENTRIES IN EACH LEXICON
15857
15858 =item BRACKET NOTATION
15859
15860 =item AUTO LEXICONS
15861
15862 =item CONTROLLING LOOKUP FAILURE
15863
15864 =item HOW TO USE MAKETEXT
15865
15866 =item SEE ALSO
15867
15868 =item COPYRIGHT AND DISCLAIMER
15869
15870 =item AUTHOR
15871
15872 =back
15873
15874 =head2 Locale::Maketext::TPJ13 -- article about software localization
15875
15876 =over 4
15877
15878 =item SYNOPSIS
15879
15880 =item DESCRIPTION
15881
15882 =item Localization and Perl: gettext breaks, Maketext fixes
15883
15884 =over 4
15885
15886 =item A Localization Horror Story: It Could Happen To You
15887
15888 =item The Linguistic View
15889
15890 =item Breaking gettext
15891
15892 =item Replacing gettext
15893
15894 =item Buzzwords: Abstraction and Encapsulation
15895
15896 =item Buzzword: Isomorphism
15897
15898 =item Buzzword: Inheritance
15899
15900 =item Buzzword: Concision
15901
15902 =item The Devil in the Details
15903
15904 =item The Proof in the Pudding: Localizing Web Sites
15905
15906 =item References
15907
15908 =back
15909
15910 =back
15911
15912 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15913
15914 =over 4
15915
15916 =item SYNOPSIS
15917
15918 =item DESCRIPTION
15919
15920 B<alpha-2>, B<alpha-3>, B<numeric>
15921
15922 =over 4
15923
15924 =item SPECIAL CODES
15925
15926 =back
15927
15928 =item CONVERSION ROUTINES
15929
15930 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15931 script_code2code( CODE, CODESET, CODESET )
15932
15933 =item QUERY ROUTINES
15934
15935 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15936
15937 =item EXAMPLES
15938
15939 =item KNOWN BUGS AND LIMITATIONS
15940
15941 =item SEE ALSO
15942
15943 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15944 http://www.evertype.com/standards/iso15924/
15945
15946 =item AUTHOR
15947
15948 =item COPYRIGHT
15949
15950 =back
15951
15952 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15953
15954 =over 4
15955
15956 =item SYNOPSIS
15957
15958 =item DESCRIPTION
15959
15960 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
15961
15962 =item DIAGNOSTICS
15963
15964 Premature end of base64 data, Premature padding of base64 data
15965
15966 =item EXAMPLES
15967
15968 =item COPYRIGHT
15969
15970 =back
15971
15972 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15973 of quoted-printable strings
15974
15975 =over 4
15976
15977 =item SYNOPSIS
15978
15979 =item DESCRIPTION
15980
15981 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
15982
15983 =item COPYRIGHT
15984
15985 =back
15986
15987 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15988 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 Math::BigFloat - Arbitrary size floating point math package
16003
16004 =over 4
16005
16006 =item SYNOPSIS
16007
16008 =item DESCRIPTION
16009
16010 =over 4
16011
16012 =item Canonical notation
16013
16014 =item Output
16015
16016 =item C<mantissa()>, C<exponent()> and C<parts()>
16017
16018 =item Accuracy vs. Precision
16019
16020 =item Rounding
16021
16022 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16023 ), fround  ( -$scale ) and fround ( 0 )
16024
16025 =back
16026
16027 =item EXAMPLES
16028
16029   # not ready yet
16030
16031 =item Autocreating constants
16032
16033 =over 4
16034
16035 =item Math library
16036
16037 =item Using Math::BigInt::Lite
16038
16039 =back
16040
16041 =item BUGS
16042
16043 =item CAVEATS
16044
16045 stringify, bstr(), bdiv, Modifying and =, bpow
16046
16047 =item SEE ALSO
16048
16049 =item LICENSE
16050
16051 =item AUTHORS
16052
16053 =back
16054
16055 =head2 Math::BigInt - Arbitrary size integer math package
16056
16057 =over 4
16058
16059 =item SYNOPSIS
16060
16061 =item DESCRIPTION
16062
16063 Canonical notation, Input, Output
16064
16065 =item METHODS
16066
16067 =over 4
16068
16069 =item config
16070
16071 =item accuracy
16072
16073 =item precision
16074
16075 =item brsft
16076
16077 =item new
16078
16079 =item bnan
16080
16081 =item bzero
16082
16083 =item binf
16084
16085 =item bone
16086
16087 =item is_one()/is_zero()/is_nan()/is_inf()
16088
16089 =item is_positive()/is_negative()
16090
16091         $x->is_positive();              # true if >= 0
16092         $x->is_negative();              # true if <  0
16093
16094 =item is_odd()/is_even()/is_int()
16095
16096 =item bcmp
16097
16098 =item bacmp
16099
16100 =item sign
16101
16102 =item bcmp
16103
16104 =item bneg
16105
16106 =item babs
16107
16108 =item bnorm
16109
16110 =item bnot
16111
16112 =item binc
16113
16114 =item bdec
16115
16116 =item badd
16117
16118 =item bsub
16119
16120 =item bmul
16121
16122 =item bdiv
16123
16124 =item bmod
16125
16126 =item bmodinv
16127
16128 =item bmodpow
16129
16130 =item bpow
16131
16132 =item blsft
16133
16134 =item brsft
16135
16136 =item band
16137
16138 =item bior
16139
16140 =item bxor
16141
16142 =item bnot
16143
16144 =item bsqrt
16145
16146 =item bfac
16147
16148 =item round
16149
16150 =item bround
16151
16152 =item bfround
16153
16154 =item bfloor
16155
16156 =item bceil
16157
16158 =item bgcd
16159
16160 =item blcm
16161
16162 =item exponent
16163
16164 =item mantissa
16165
16166 =item parts
16167
16168 =item copy
16169
16170 =item as_number
16171
16172 =item bsstr
16173
16174 =item as_hex
16175
16176 =item as_bin
16177
16178 =back
16179
16180 =item ACCURACY and PRECISION
16181
16182 =over 4
16183
16184 =item Precision P
16185
16186 =item Accuracy A
16187
16188 =item Fallback F
16189
16190 =item Rounding mode R
16191
16192 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16193 (significant digits), Setting/Accessing, Creating numbers, Usage,
16194 Precedence, Overriding globals, Local settings, Rounding, Default values,
16195 Remarks
16196
16197 =back
16198
16199 =item INTERNALS
16200
16201 =over 4
16202
16203 =item MATH LIBRARY
16204
16205 =item SIGN
16206
16207 =item mantissa(), exponent() and parts()
16208
16209 =back
16210
16211 =item EXAMPLES
16212
16213   use Math::BigInt;
16214
16215 =item Autocreating constants
16216
16217 =item PERFORMANCE
16218
16219 =over 4
16220
16221 =item Alternative math libraries
16222
16223 =item SUBCLASSING
16224
16225 =back
16226
16227 =item Subclassing Math::BigInt
16228
16229 =item UPGRADING
16230
16231 =over 4
16232
16233 =item Auto-upgrade
16234
16235 bsqrt(), div(), blog()
16236
16237 =back
16238
16239 =item BUGS
16240
16241 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16242 5.6.0
16243
16244 =item CAVEATS
16245
16246 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16247 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16248 types, bsqrt(), brsft()
16249
16250 =item LICENSE
16251
16252 =item SEE ALSO
16253
16254 =item AUTHORS
16255
16256 =back
16257
16258 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16259
16260 =over 4
16261
16262 =item SYNOPSIS
16263
16264 =item DESCRIPTION
16265
16266 =item STORAGE
16267
16268 =item METHODS
16269
16270 =item WRAP YOUR OWN
16271
16272 =item LICENSE
16273
16274 This program is free software; you may redistribute it and/or modify it
16275 under
16276 the same terms as Perl itself.
16277
16278 =item AUTHORS
16279
16280 =item SEE ALSO
16281
16282 =back
16283
16284 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16285 scalars
16286
16287 =over 4
16288
16289 =item SYNOPSIS
16290
16291 =item DESCRIPTION
16292
16293 =item LICENSE
16294
16295 This program is free software; you may redistribute it and/or modify it
16296 under
16297 the same terms as Perl itself.
16298
16299 =item AUTHOR
16300
16301 =item SEE ALSO
16302
16303 =back
16304
16305 =head2 Math::BigRat - arbitrarily big rationales
16306
16307 =over 4
16308
16309 =item SYNOPSIS
16310
16311 =item DESCRIPTION
16312
16313 =over 4
16314
16315 =item MATH LIBRARY
16316
16317 =back
16318
16319 =item METHODS
16320
16321 =over 4
16322
16323 =item new()
16324
16325 =item numerator()
16326
16327 =item denominator()
16328
16329         $d = $x->denominator();
16330
16331 =item parts()
16332
16333 =item as_number()
16334
16335 =item bfac()
16336
16337 =item blog()
16338
16339 =item bround()/round()/bfround()
16340
16341 =item bmod()
16342
16343 =item is_one()
16344
16345 =item is_zero()
16346
16347 =item is_positive()
16348
16349 =item is_negative()
16350
16351 =item is_int()
16352
16353 =item is_odd()
16354
16355 =item is_even()
16356
16357 =item bceil()
16358
16359 =item bfloor()
16360
16361         $x->bfloor();
16362
16363 =item config
16364
16365 =back
16366
16367 =item BUGS
16368
16369 inf handling (partial), NaN handling (partial), rounding (not implemented
16370 except for bceil/bfloor), $x ** $y where $y is not an integer
16371
16372 =item LICENSE
16373
16374 =item SEE ALSO
16375
16376 =item AUTHORS
16377
16378 =back
16379
16380 =head2 Math::Complex - complex numbers and associated mathematical
16381 functions
16382
16383 =over 4
16384
16385 =item SYNOPSIS
16386
16387 =item DESCRIPTION
16388
16389 =item OPERATIONS
16390
16391 =item CREATION
16392
16393 =item STRINGIFICATION
16394
16395 =over 4
16396
16397 =item CHANGED IN PERL 5.6
16398
16399 =back
16400
16401 =item USAGE
16402
16403 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16404
16405 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16406
16407 =item BUGS
16408
16409 =item AUTHORS
16410
16411 =back
16412
16413 =head2 Math::Trig - trigonometric functions
16414
16415 =over 4
16416
16417 =item SYNOPSIS
16418
16419 =item DESCRIPTION
16420
16421 =item TRIGONOMETRIC FUNCTIONS
16422
16423 B<tan>
16424
16425 =over 4
16426
16427 =item ERRORS DUE TO DIVISION BY ZERO
16428
16429 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16430
16431 =back
16432
16433 =item PLANE ANGLE CONVERSIONS
16434
16435 =item RADIAL COORDINATE CONVERSIONS
16436
16437 =over 4
16438
16439 =item COORDINATE SYSTEMS
16440
16441 =item 3-D ANGLE CONVERSIONS
16442
16443 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16444 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16445
16446 =back
16447
16448 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16449
16450 =item EXAMPLES
16451
16452 =over 4
16453
16454 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16455
16456 =back
16457
16458 =item BUGS
16459
16460 =item AUTHORS
16461
16462 =back
16463
16464 =head2 Memoize - Make functions faster by trading space for time
16465
16466 =over 4
16467
16468 =item SYNOPSIS
16469
16470 =item DESCRIPTION
16471
16472 =item DETAILS
16473
16474 =item OPTIONS
16475
16476 =over 4
16477
16478 =item INSTALL
16479
16480 =item NORMALIZER
16481
16482 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16483
16484 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16485
16486 =back
16487
16488 =item OTHER FACILITIES
16489
16490 =over 4
16491
16492 =item C<unmemoize>
16493
16494 =item C<flush_cache>
16495
16496 =back
16497
16498 =item CAVEATS
16499
16500 =item PERSISTENT CACHE SUPPORT
16501
16502 =item EXPIRATION SUPPORT
16503
16504 =item BUGS
16505
16506 =item MAILING LIST
16507
16508 =item AUTHOR
16509
16510 =item COPYRIGHT AND LICENSE
16511
16512 =item THANK YOU
16513
16514 =back
16515
16516 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16517 Storable use
16518
16519 =over 4
16520
16521 =item DESCRIPTION
16522
16523 =back
16524
16525 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16526 memoized values
16527
16528 =over 4
16529
16530 =item SYNOPSIS
16531
16532 =item DESCRIPTION
16533
16534 =item INTERFACE
16535
16536  TIEHASH,  EXISTS,  STORE
16537
16538 =item ALTERNATIVES
16539
16540 =item CAVEATS
16541
16542 =item AUTHOR
16543
16544 =item SEE ALSO
16545
16546 =back
16547
16548 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16549
16550 =over 4
16551
16552 =item DESCRIPTION
16553
16554 =back
16555
16556 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16557
16558 =over 4
16559
16560 =item DESCRIPTION
16561
16562 =back
16563
16564 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16565 Storable use
16566
16567 =over 4
16568
16569 =item DESCRIPTION
16570
16571 =back
16572
16573 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16574 Storable use
16575
16576 =over 4
16577
16578 =item DESCRIPTION
16579
16580 =back
16581
16582 =head2 Memoize::Storable - store Memoized data in Storable database
16583
16584 =over 4
16585
16586 =item DESCRIPTION
16587
16588 =back
16589
16590 =head2 NDBM_File - Tied access to ndbm files
16591
16592 =over 4
16593
16594 =item SYNOPSIS
16595
16596 =item DESCRIPTION
16597
16598 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16599
16600 =item DIAGNOSTICS
16601
16602 =over 4
16603
16604 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16605
16606 =back
16607
16608 =item BUGS AND WARNINGS
16609
16610 =back
16611
16612 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
16613
16614 =over 4
16615
16616 =item SYNOPSIS
16617
16618 =item DESCRIPTION
16619
16620 =over 4
16621
16622 =item Enforcing redispatch
16623
16624 =item Avoiding repetitions
16625
16626 =back
16627
16628 =item AUTHOR
16629
16630 =item BUGS AND IRRITATIONS
16631
16632 =item COPYRIGHT
16633
16634 =back
16635
16636 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
16637
16638 =over 4
16639
16640 =item SYNOPSIS
16641
16642 =item DESCRIPTION
16643
16644 =item USER METHODS
16645
16646 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
16647 dataend ()
16648
16649 =item CLASS METHODS
16650
16651 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
16652 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
16653 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
16654
16655 =item EXPORTS
16656
16657 =item AUTHOR
16658
16659 =item COPYRIGHT
16660
16661 =back
16662
16663 =head2 Net::Config - Local configuration data for libnet
16664
16665 =over 4
16666
16667 =item SYNOPSYS
16668
16669 =item DESCRIPTION
16670
16671 =item METHODS
16672
16673 requires_firewall HOST
16674
16675 =item NetConfig VALUES
16676
16677 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
16678 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
16679 ftp_int_pasive, local_netmask, test_hosts, test_exists
16680
16681 =back
16682
16683 =head2 Net::Domain - Attempt to evaluate the current host's internet name
16684 and domain
16685
16686 =over 4
16687
16688 =item SYNOPSIS
16689
16690 =item DESCRIPTION
16691
16692 hostfqdn (), hostname (), hostdomain ()
16693
16694 =item AUTHOR
16695
16696 =item COPYRIGHT
16697
16698 =back
16699
16700 =head2 Net::FTP - FTP Client class
16701
16702 =over 4
16703
16704 =item SYNOPSIS
16705
16706 =item DESCRIPTION
16707
16708 =item OVERVIEW
16709
16710 =item CONSTRUCTOR
16711
16712 new (HOST [,OPTIONS])
16713
16714 =item METHODS
16715
16716 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
16717 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
16718 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
16719 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
16720 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ),
16721 dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put (
16722 LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ),
16723 append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size
16724 ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
16725 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
16726 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
16727 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
16728 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
16729 abort (), quit ()
16730
16731 =over 4
16732
16733 =item Methods for the adventurous
16734
16735 quot (CMD [,ARGS])
16736
16737 =back
16738
16739 =item THE dataconn CLASS
16740
16741 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
16742 bytes_read (), abort (), close ()
16743
16744 =item UNIMPLEMENTED
16745
16746 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
16747
16748 =item REPORTING BUGS
16749
16750 =item AUTHOR
16751
16752 =item SEE ALSO
16753
16754 =item USE EXAMPLES
16755
16756 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
16757
16758 =item CREDITS
16759
16760 =item COPYRIGHT
16761
16762 =back
16763
16764 =head2 Net::NNTP - NNTP Client class
16765
16766 =over 4
16767
16768 =item SYNOPSIS
16769
16770 =item DESCRIPTION
16771
16772 =item CONSTRUCTOR
16773
16774 new ( [ HOST ] [, OPTIONS ])
16775
16776 =item METHODS
16777
16778 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
16779 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
16780 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
16781 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
16782 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
16783 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
16784 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
16785
16786 =over 4
16787
16788 =item Extension methods
16789
16790 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
16791 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
16792 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
16793 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
16794 GROUP ] ), reader
16795
16796 =back
16797
16798 =item UNSUPPORTED
16799
16800 =item DEFINITIONS
16801
16802 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
16803
16804 =item SEE ALSO
16805
16806 =item AUTHOR
16807
16808 =item COPYRIGHT
16809
16810 =back
16811
16812 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
16813
16814 =over 4
16815
16816 =item SYNOPSIS
16817
16818 =item DESCRIPTION
16819
16820 =item CONSTRUCTOR
16821
16822 new ( [ HOST, ] [ OPTIONS ] )
16823
16824 =item METHODS
16825
16826 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16827 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16828 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16829 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16830
16831 =item NOTES
16832
16833 =item SEE ALSO
16834
16835 =item AUTHOR
16836
16837 =item COPYRIGHT
16838
16839 =back
16840
16841 =head2 Net::Ping - check a remote host for reachability
16842
16843 =over 4
16844
16845 =item SYNOPSIS
16846
16847 =item DESCRIPTION
16848
16849 =over 4
16850
16851 =item Functions
16852
16853 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
16854 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
16855 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
16856 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
16857 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
16858 [, $timeout]);
16859
16860 =back
16861
16862 =item NOTES
16863
16864 =item INSTALL
16865
16866 =item BUGS
16867
16868 =item AUTHORS
16869
16870 =item COPYRIGHT
16871
16872 =back
16873
16874 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16875
16876 =over 4
16877
16878 =item SYNOPSIS
16879
16880 =item DESCRIPTION
16881
16882 =item EXAMPLES
16883
16884 =item CONSTRUCTOR
16885
16886 new Net::SMTP [ HOST, ] [ OPTIONS ]
16887
16888 =item METHODS
16889
16890 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16891 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16892 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16893 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16894 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16895 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16896 quit ()
16897
16898 =item ADDRESSES
16899
16900 =item SEE ALSO
16901
16902 =item AUTHOR
16903
16904 =item COPYRIGHT
16905
16906 =back
16907
16908 =head2 Net::Time - time and daytime network client interface
16909
16910 =over 4
16911
16912 =item SYNOPSIS
16913
16914 =item DESCRIPTION
16915
16916 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16917 PROTOCOL [, TIMEOUT]]])
16918
16919 =item AUTHOR
16920
16921 =item COPYRIGHT
16922
16923 =back
16924
16925 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16926 functions
16927
16928 =over 4
16929
16930 =item SYNOPSIS
16931
16932 =item DESCRIPTION
16933
16934 =item EXAMPLES
16935
16936 =item NOTE
16937
16938 =item AUTHOR
16939
16940 =back
16941
16942 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16943
16944 =over 4
16945
16946 =item DESCRIPTION
16947
16948 =over 4
16949
16950 =item Where to get this document
16951
16952 =item How to contribute to this document
16953
16954 =back
16955
16956 =item Author and Copyright Information
16957
16958 =over 4
16959
16960 =item Disclaimer
16961
16962 =back
16963
16964 =item Obtaining and installing libnet
16965
16966 =over 4
16967
16968 =item What is libnet ?
16969
16970 =item Which version of perl do I need ?
16971
16972 =item What other modules do I need ?
16973
16974 =item What machines support libnet ?
16975
16976 =item Where can I get the latest libnet release
16977
16978 =back
16979
16980 =item Using Net::FTP
16981
16982 =over 4
16983
16984 =item How do I download files from an FTP server ?
16985
16986 =item How do I transfer files in binary mode ?
16987
16988 =item How can I get the size of a file on a remote FTP server ?
16989
16990 =item How can I get the modification time of a file on a remote FTP server
16991 ?
16992
16993 =item How can I change the permissions of a file on a remote server ?
16994
16995 =item Can I do a reget operation like the ftp command ?
16996
16997 =item How do I get a directory listing from an FTP server ?
16998
16999 =item Changing directory to "" does not fail ?
17000
17001 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17002
17003 =item I am behind an FTP proxy firewall, but cannot access machines outside
17004 ?
17005
17006 =item My ftp proxy firewall does not listen on port 21
17007
17008 =item Is it possible to change the file permissions of a file on an FTP
17009 server ?
17010
17011 =item I have seen scripts call a method message, but cannot find it
17012 documented ?
17013
17014 =item Why does Net::FTP not implement mput and mget methods
17015
17016 =back
17017
17018 =item Using Net::SMTP
17019
17020 =over 4
17021
17022 =item Why can't the part of an Email address after the @ be used as the
17023 hostname ?
17024
17025 =item Why does Net::SMTP not do DNS MX lookups ?
17026
17027 =item The verify method always returns true ?
17028
17029 =back
17030
17031 =item Debugging scripts
17032
17033 =over 4
17034
17035 =item How can I debug my scripts that use Net::* modules ?
17036
17037 =back
17038
17039 =item AUTHOR AND COPYRIGHT
17040
17041 =back
17042
17043 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17044 functions
17045
17046 =over 4
17047
17048 =item SYNOPSIS
17049
17050 =item DESCRIPTION
17051
17052 =item EXAMPLES
17053
17054 =item NOTE
17055
17056 =item AUTHOR
17057
17058 =back
17059
17060 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17061 functions
17062
17063 =over 4
17064
17065 =item SYNOPSIS
17066
17067 =item DESCRIPTION
17068
17069 =item NOTE
17070
17071 =item AUTHOR
17072
17073 =back
17074
17075 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17076 functions
17077
17078 =over 4
17079
17080 =item SYNOPSIS
17081
17082 =item DESCRIPTION
17083
17084 =item EXAMPLES
17085
17086 =item NOTE
17087
17088 =item AUTHOR
17089
17090 =back
17091
17092 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17093
17094 =over 4
17095
17096 =item SYNOPSIS
17097
17098 =item DESCRIPTION
17099
17100 =item THE .netrc FILE
17101
17102 machine name, default, login name, password string, account string, macdef
17103 name
17104
17105 =item CONSTRUCTOR
17106
17107 lookup ( MACHINE [, LOGIN ])
17108
17109 =item METHODS
17110
17111 login (), password (), account (), lpa ()
17112
17113 =item AUTHOR
17114
17115 =item SEE ALSO
17116
17117 =item COPYRIGHT
17118
17119 =back
17120
17121 =head2 O - Generic interface to Perl Compiler backends
17122
17123 =over 4
17124
17125 =item SYNOPSIS
17126
17127 =item DESCRIPTION
17128
17129 =item CONVENTIONS
17130
17131 =item IMPLEMENTATION
17132
17133 =item BUGS
17134
17135 =item AUTHOR
17136
17137 =back
17138
17139 =head2 ODBM_File - Tied access to odbm files
17140
17141 =over 4
17142
17143 =item SYNOPSIS
17144
17145 =item DESCRIPTION
17146
17147 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17148
17149 =item DIAGNOSTICS
17150
17151 =over 4
17152
17153 =item C<odbm store returned -1, errno 22, key "..." at ...>
17154
17155 =back
17156
17157 =item BUGS AND WARNINGS
17158
17159 =back
17160
17161 =head2 Opcode - Disable named opcodes when compiling perl code
17162
17163 =over 4
17164
17165 =item SYNOPSIS
17166
17167 =item DESCRIPTION
17168
17169 =item NOTE
17170
17171 =item WARNING
17172
17173 =item Operator Names and Operator Lists
17174
17175 an operator name (opname), an operator tag name (optag), a negated opname
17176 or optag, an operator set (opset)
17177
17178 =item Opcode Functions
17179
17180 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17181 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17182 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17183 opdump (PAT)
17184
17185 =item Manipulating Opsets
17186
17187 =item TO DO (maybe)
17188
17189 =back
17190
17191 =over 4
17192
17193 =item Predefined Opcode Tags
17194
17195 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17196 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17197 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17198 :dangerous
17199
17200 =item SEE ALSO
17201
17202 =item AUTHORS
17203
17204 =back
17205
17206 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17207 compartments
17208
17209 =over 4
17210
17211 =item SYNOPSIS
17212
17213 =item DESCRIPTION
17214
17215 a new namespace, an operator mask
17216
17217 =item WARNING
17218
17219 =over 4
17220
17221 =item RECENT CHANGES
17222
17223 =item Methods in class Safe
17224
17225 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17226 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17227 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17228 root (NAMESPACE), mask (MASK)
17229
17230 =item Some Safety Issues
17231
17232 Memory, CPU, Snooping, Signals, State Changes
17233
17234 =item AUTHOR
17235
17236 =back
17237
17238 =back
17239
17240 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17241 compiling
17242
17243 =over 4
17244
17245 =item SYNOPSIS
17246
17247 =item DESCRIPTION
17248
17249 =item SEE ALSO
17250
17251 =back
17252
17253 =head2 POSIX - Perl interface to IEEE Std 1003.1
17254
17255 =over 4
17256
17257 =item SYNOPSIS
17258
17259 =item DESCRIPTION
17260
17261 =item NOTE
17262
17263 =item CAVEATS
17264
17265 =item FUNCTIONS
17266
17267 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17268 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17269 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17270 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17271 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17272 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17273 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17274 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17275 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17276 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17277 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17278 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17279 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17280 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17281 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17282 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17283 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17284 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17285 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17286 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17287 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17288 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17289 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17290 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17291 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17292 wctomb, write
17293
17294 =item CLASSES
17295
17296 =over 4
17297
17298 =item POSIX::SigAction
17299
17300 new, handler, mask, flags, safe
17301
17302 =item POSIX::SigSet
17303
17304 new, addset, delset, emptyset, fillset, ismember
17305
17306 =item POSIX::Termios
17307
17308 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17309 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17310 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17311 field values, c_cflag field values, c_iflag field values, c_lflag field
17312 values, c_oflag field values
17313
17314 =back
17315
17316 =item PATHNAME CONSTANTS
17317
17318 Constants
17319
17320 =item POSIX CONSTANTS
17321
17322 Constants
17323
17324 =item SYSTEM CONFIGURATION
17325
17326 Constants
17327
17328 =item ERRNO
17329
17330 Constants
17331
17332 =item FCNTL
17333
17334 Constants
17335
17336 =item FLOAT
17337
17338 Constants
17339
17340 =item LIMITS
17341
17342 Constants
17343
17344 =item LOCALE
17345
17346 Constants
17347
17348 =item MATH
17349
17350 Constants
17351
17352 =item SIGNAL
17353
17354 Constants
17355
17356 =item STAT
17357
17358 Constants, Macros
17359
17360 =item STDLIB
17361
17362 Constants
17363
17364 =item STDIO
17365
17366 Constants
17367
17368 =item TIME
17369
17370 Constants
17371
17372 =item UNISTD
17373
17374 Constants
17375
17376 =item WAIT
17377
17378 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17379 WTERMSIG, WIFSTOPPED, WSTOPSIG
17380
17381 =back
17382
17383 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17384 name space
17385
17386 =over 4
17387
17388 =item SYNOPSIS
17389
17390 =item DESCRIPTION
17391
17392 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
17393
17394 =over 4
17395
17396 =item Custom Layers
17397
17398 :encoding, :via
17399
17400 =item Alternatives to raw
17401
17402 =item Defaults and how to override them
17403
17404 =item Querying the layers of filehandle
17405
17406 =back
17407
17408 =item AUTHOR
17409
17410 =item SEE ALSO
17411
17412 =back
17413
17414 =head2 PerlIO::encoding - encoding layer
17415
17416 =over 4
17417
17418 =item SYNOPSIS
17419
17420 =item DESCRIPTION
17421
17422 =item SEE ALSO
17423
17424 =back
17425
17426 =head2 PerlIO::scalar - support module for in-memory IO.
17427
17428 =over 4
17429
17430 =item SYNOPSIS
17431
17432 =item DESCRIPTION
17433
17434 =back
17435
17436 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17437
17438 =over 4
17439
17440 =item SYNOPSIS
17441
17442 =item DESCRIPTION
17443
17444 =item EXPECTED METHODS
17445
17446 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17447 $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
17448 $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
17449 $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
17450 $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
17451 $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
17452 $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
17453 $obj->EOF($fh)
17454
17455 =item EXAMPLES
17456
17457 =over 4
17458
17459 =item Example - a Hexadecimal Handle
17460
17461 =back
17462
17463 =back
17464
17465 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17466
17467 =over 4
17468
17469 =item SYNOPSIS
17470
17471 =item DESCRIPTION
17472
17473 =item SEE ALSO
17474
17475 =item COPYRIGHT
17476
17477 =back
17478
17479 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17480
17481 =over 4
17482
17483 =item SYNOPSIS
17484
17485 =item OPTIONS/ARGUMENTS
17486
17487 =over 4
17488
17489 =item podchecker()
17490
17491 B<-warnings> =E<gt> I<val>
17492
17493 =back
17494
17495 =item DESCRIPTION
17496
17497 =item DIAGNOSTICS
17498
17499 =over 4
17500
17501 =item Errors
17502
17503 empty =headn, =over on line I<N> without closing =back, =item without
17504 previous =over, =back without previous =over, No argument for =begin, =end
17505 without =begin, Nested =begin's, =for without formatter specification,
17506 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17507 interior-sequence "I<SEQ>", nested commands
17508 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17509 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17510 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17511 after =back
17512
17513 =item Warnings
17514
17515 multiple occurrence of link target I<name>, line containing nothing but
17516 whitespace in paragraph, file does not start with =head, previous =item has
17517 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17518 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17519 items in =over, No argument for =item, empty section in previous paragraph,
17520 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17521 level
17522
17523 =item Hyperlinks
17524
17525 ignoring leading/trailing whitespace in link, (section) in '$page'
17526 deprecated, alternative text/node '%s' contains non-escaped | or /
17527
17528 =back
17529
17530 =item RETURN VALUE
17531
17532 =item EXAMPLES
17533
17534 =item INTERFACE
17535
17536 =back
17537
17538 C<Pod::Checker-E<gt>new( %options )>
17539
17540 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17541 @args )>
17542
17543 C<$checker-E<gt>num_errors()>
17544
17545 C<$checker-E<gt>num_warnings()>
17546
17547 C<$checker-E<gt>name()>
17548
17549 C<$checker-E<gt>node()>
17550
17551 C<$checker-E<gt>idx()>
17552
17553 C<$checker-E<gt>hyperlink()>
17554
17555 =over 4
17556
17557 =item AUTHOR
17558
17559 =back
17560
17561 =head2 Pod::Find - find POD documents in directory trees
17562
17563 =over 4
17564
17565 =item SYNOPSIS
17566
17567 =item DESCRIPTION
17568
17569 =back
17570
17571 =over 4
17572
17573 =item C<pod_find( { %opts } , @directories )>
17574
17575 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17576 1>
17577
17578 =back
17579
17580 =over 4
17581
17582 =item C<simplify_name( $str )>
17583
17584 =back
17585
17586 =over 4
17587
17588 =item C<pod_where( { %opts }, $pod )>
17589
17590 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17591 1>
17592
17593 =back
17594
17595 =over 4
17596
17597 =item C<contains_pod( $file , $verbose )>
17598
17599 =back
17600
17601 =over 4
17602
17603 =item AUTHOR
17604
17605 =item SEE ALSO
17606
17607 =back
17608
17609 =head2 Pod::Html - module to convert pod files to HTML
17610
17611 =over 4
17612
17613 =item SYNOPSIS
17614
17615 =item DESCRIPTION
17616
17617 =item ARGUMENTS
17618
17619 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
17620 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
17621 title, verbose
17622
17623 =item EXAMPLE
17624
17625 =item ENVIRONMENT
17626
17627 =item AUTHOR
17628
17629 =item SEE ALSO
17630
17631 =item COPYRIGHT
17632
17633 =back
17634
17635 =head2 Pod::InputObjects - objects representing POD input paragraphs,
17636 commands, etc.
17637
17638 =over 4
17639
17640 =item SYNOPSIS
17641
17642 =item REQUIRES
17643
17644 =item EXPORTS
17645
17646 =item DESCRIPTION
17647
17648 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
17649 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
17650
17651 =back
17652
17653 =over 4
17654
17655 =item B<Pod::InputSource>
17656
17657 =back
17658
17659 =over 4
17660
17661 =item B<new()>
17662
17663 =back
17664
17665 =over 4
17666
17667 =item B<name()>
17668
17669 =back
17670
17671 =over 4
17672
17673 =item B<handle()>
17674
17675 =back
17676
17677 =over 4
17678
17679 =item B<was_cutting()>
17680
17681 =back
17682
17683 =over 4
17684
17685 =item B<Pod::Paragraph>
17686
17687 =back
17688
17689 =over 4
17690
17691 =item Pod::Paragraph-E<gt>B<new()>
17692
17693 =back
17694
17695 =over 4
17696
17697 =item $pod_para-E<gt>B<cmd_name()>
17698
17699 =back
17700
17701 =over 4
17702
17703 =item $pod_para-E<gt>B<text()>
17704
17705 =back
17706
17707 =over 4
17708
17709 =item $pod_para-E<gt>B<raw_text()>
17710
17711 =back
17712
17713 =over 4
17714
17715 =item $pod_para-E<gt>B<cmd_prefix()>
17716
17717 =back
17718
17719 =over 4
17720
17721 =item $pod_para-E<gt>B<cmd_separator()>
17722
17723 =back
17724
17725 =over 4
17726
17727 =item $pod_para-E<gt>B<parse_tree()>
17728
17729 =back
17730
17731 =over 4
17732
17733 =item $pod_para-E<gt>B<file_line()>
17734
17735 =back
17736
17737 =over 4
17738
17739 =item B<Pod::InteriorSequence>
17740
17741 =back
17742
17743 =over 4
17744
17745 =item Pod::InteriorSequence-E<gt>B<new()>
17746
17747 =back
17748
17749 =over 4
17750
17751 =item $pod_seq-E<gt>B<cmd_name()>
17752
17753 =back
17754
17755 =over 4
17756
17757 =item $pod_seq-E<gt>B<prepend()>
17758
17759 =back
17760
17761 =over 4
17762
17763 =item $pod_seq-E<gt>B<append()>
17764
17765 =back
17766
17767 =over 4
17768
17769 =item $pod_seq-E<gt>B<nested()>
17770
17771 =back
17772
17773 =over 4
17774
17775 =item $pod_seq-E<gt>B<raw_text()>
17776
17777 =back
17778
17779 =over 4
17780
17781 =item $pod_seq-E<gt>B<left_delimiter()>
17782
17783 =back
17784
17785 =over 4
17786
17787 =item $pod_seq-E<gt>B<right_delimiter()>
17788
17789 =back
17790
17791 =over 4
17792
17793 =item $pod_seq-E<gt>B<parse_tree()>
17794
17795 =back
17796
17797 =over 4
17798
17799 =item $pod_seq-E<gt>B<file_line()>
17800
17801 =back
17802
17803 =over 4
17804
17805 =item Pod::InteriorSequence::B<DESTROY()>
17806
17807 =back
17808
17809 =over 4
17810
17811 =item B<Pod::ParseTree>
17812
17813 =back
17814
17815 =over 4
17816
17817 =item Pod::ParseTree-E<gt>B<new()>
17818
17819 =back
17820
17821 =over 4
17822
17823 =item $ptree-E<gt>B<top()>
17824
17825 =back
17826
17827 =over 4
17828
17829 =item $ptree-E<gt>B<children()>
17830
17831 =back
17832
17833 =over 4
17834
17835 =item $ptree-E<gt>B<prepend()>
17836
17837 =back
17838
17839 =over 4
17840
17841 =item $ptree-E<gt>B<append()>
17842
17843 =back
17844
17845 =over 4
17846
17847 =item $ptree-E<gt>B<raw_text()>
17848
17849 =back
17850
17851 =over 4
17852
17853 =item Pod::ParseTree::B<DESTROY()>
17854
17855 =back
17856
17857 =over 4
17858
17859 =item SEE ALSO
17860
17861 =item AUTHOR
17862
17863 =back
17864
17865 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17866
17867 =over 4
17868
17869 =item SYNOPSIS
17870
17871 =item DESCRIPTION
17872
17873 =back
17874
17875 =over 4
17876
17877 =item OBJECT METHODS
17878
17879 C<initialize>
17880
17881 =back
17882
17883 =over 4
17884
17885 =item Data Accessors
17886
17887 B<AddPreamble>
17888
17889 =back
17890
17891 B<AddPostamble>
17892
17893 B<Head1Level>
17894
17895 B<Label>
17896
17897 B<LevelNoNum>
17898
17899 B<MakeIndex>
17900
17901 B<ReplaceNAMEwithSection>
17902
17903 B<StartWithNewPage>
17904
17905 B<TableOfContents>
17906
17907 B<UniqueLabels>
17908
17909 B<UserPreamble>
17910
17911 B<UserPostamble>
17912
17913 B<Lists>
17914
17915 =over 4
17916
17917 =item Subclassed methods
17918
17919 =back
17920
17921 B<begin_pod>
17922
17923 B<end_pod>
17924
17925 B<command>
17926
17927 B<verbatim>
17928
17929 B<textblock>
17930
17931 B<interior_sequence>
17932
17933 =over 4
17934
17935 =item List Methods
17936
17937 B<begin_list>
17938
17939 =back
17940
17941 B<end_list>
17942
17943 B<add_item>
17944
17945 =over 4
17946
17947 =item Methods for headings
17948
17949 B<head>
17950
17951 =back
17952
17953 =over 4
17954
17955 =item Internal methods
17956
17957 B<_output>
17958
17959 =back
17960
17961 B<_replace_special_chars>
17962
17963 B<_replace_special_chars_late>
17964
17965 B<_create_label>
17966
17967 B<_create_index>
17968
17969 B<_clean_latex_commands>
17970
17971 B<_split_delimited>
17972
17973 =over 4
17974
17975 =item NOTES
17976
17977 =item SEE ALSO
17978
17979 =item AUTHORS
17980
17981 =item COPYRIGHT
17982
17983 =item REVISION
17984
17985 =back
17986
17987 =head2 Pod::Man - Convert POD data to formatted *roff input
17988
17989 =over 4
17990
17991 =item SYNOPSIS
17992
17993 =item DESCRIPTION
17994
17995 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17996 release, section
17997
17998 =item DIAGNOSTICS
17999
18000 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18001 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18002 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18003 =back
18004
18005 =item BUGS
18006
18007 =item CAVEATS
18008
18009 =item SEE ALSO
18010
18011 =item AUTHOR
18012
18013 =item COPYRIGHT AND LICENSE
18014
18015 =back
18016
18017 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18018
18019 =over 4
18020
18021 =item SYNOPSIS
18022
18023 =item DESCRIPTION
18024
18025 =item SEE ALSO
18026
18027 =item AUTHOR
18028
18029 =item COPYRIGHT AND LICENSE
18030
18031 =back
18032
18033 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18034
18035 =over 4
18036
18037 =item SYNOPSIS
18038
18039 =item DESCRIPTION
18040
18041 =back
18042
18043 =over 4
18044
18045 =item Pod::List
18046
18047 Pod::List-E<gt>new()
18048
18049 =back
18050
18051 $list-E<gt>file()
18052
18053 $list-E<gt>start()
18054
18055 $list-E<gt>indent()
18056
18057 $list-E<gt>type()
18058
18059 $list-E<gt>rx()
18060
18061 $list-E<gt>item()
18062
18063 $list-E<gt>parent()
18064
18065 $list-E<gt>tag()
18066
18067 =over 4
18068
18069 =item Pod::Hyperlink
18070
18071 Pod::Hyperlink-E<gt>new()
18072
18073 =back
18074
18075 $link-E<gt>parse($string)
18076
18077 $link-E<gt>markup($string)
18078
18079 $link-E<gt>text()
18080
18081 $link-E<gt>warning()
18082
18083 $link-E<gt>file(), $link-E<gt>line()
18084
18085 $link-E<gt>page()
18086
18087 $link-E<gt>node()
18088
18089 $link-E<gt>alttext()
18090
18091 $link-E<gt>type()
18092
18093 $link-E<gt>link()
18094
18095 =over 4
18096
18097 =item Pod::Cache
18098
18099 Pod::Cache-E<gt>new()
18100
18101 =back
18102
18103 $cache-E<gt>item()
18104
18105 $cache-E<gt>find_page($name)
18106
18107 =over 4
18108
18109 =item Pod::Cache::Item
18110
18111 Pod::Cache::Item-E<gt>new()
18112
18113 =back
18114
18115 $cacheitem-E<gt>page()
18116
18117 $cacheitem-E<gt>description()
18118
18119 $cacheitem-E<gt>path()
18120
18121 $cacheitem-E<gt>file()
18122
18123 $cacheitem-E<gt>nodes()
18124
18125 $cacheitem-E<gt>find_node($name)
18126
18127 $cacheitem-E<gt>idx()
18128
18129 =over 4
18130
18131 =item AUTHOR
18132
18133 =item SEE ALSO
18134
18135 =back
18136
18137 =head2 Pod::Parser - base class for creating POD filters and translators
18138
18139 =over 4
18140
18141 =item SYNOPSIS
18142
18143 =item REQUIRES
18144
18145 =item EXPORTS
18146
18147 =item DESCRIPTION
18148
18149 =item QUICK OVERVIEW
18150
18151 =item PARSING OPTIONS
18152
18153 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18154 B<-warnings> (default: unset)
18155
18156 =back
18157
18158 =over 4
18159
18160 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18161
18162 =back
18163
18164 =over 4
18165
18166 =item B<command()>
18167
18168 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18169
18170 =back
18171
18172 =over 4
18173
18174 =item B<verbatim()>
18175
18176 C<$text>, C<$line_num>, C<$pod_para>
18177
18178 =back
18179
18180 =over 4
18181
18182 =item B<textblock()>
18183
18184 C<$text>, C<$line_num>, C<$pod_para>
18185
18186 =back
18187
18188 =over 4
18189
18190 =item B<interior_sequence()>
18191
18192 =back
18193
18194 =over 4
18195
18196 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18197
18198 =back
18199
18200 =over 4
18201
18202 =item B<new()>
18203
18204 =back
18205
18206 =over 4
18207
18208 =item B<initialize()>
18209
18210 =back
18211
18212 =over 4
18213
18214 =item B<begin_pod()>
18215
18216 =back
18217
18218 =over 4
18219
18220 =item B<begin_input()>
18221
18222 =back
18223
18224 =over 4
18225
18226 =item B<end_input()>
18227
18228 =back
18229
18230 =over 4
18231
18232 =item B<end_pod()>
18233
18234 =back
18235
18236 =over 4
18237
18238 =item B<preprocess_line()>
18239
18240 =back
18241
18242 =over 4
18243
18244 =item B<preprocess_paragraph()>
18245
18246 =back
18247
18248 =over 4
18249
18250 =item METHODS FOR PARSING AND PROCESSING
18251
18252 =back
18253
18254 =over 4
18255
18256 =item B<parse_text()>
18257
18258 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18259 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18260 I<code-ref>|I<method-name>
18261
18262 =back
18263
18264 =over 4
18265
18266 =item B<interpolate()>
18267
18268 =back
18269
18270 =over 4
18271
18272 =item B<parse_paragraph()>
18273
18274 =back
18275
18276 =over 4
18277
18278 =item B<parse_from_filehandle()>
18279
18280 =back
18281
18282 =over 4
18283
18284 =item B<parse_from_file()>
18285
18286 =back
18287
18288 =over 4
18289
18290 =item ACCESSOR METHODS
18291
18292 =back
18293
18294 =over 4
18295
18296 =item B<errorsub()>
18297
18298 =back
18299
18300 =over 4
18301
18302 =item B<cutting()>
18303
18304 =back
18305
18306 =over 4
18307
18308 =item B<parseopts()>
18309
18310 =back
18311
18312 =over 4
18313
18314 =item B<output_file()>
18315
18316 =back
18317
18318 =over 4
18319
18320 =item B<output_handle()>
18321
18322 =back
18323
18324 =over 4
18325
18326 =item B<input_file()>
18327
18328 =back
18329
18330 =over 4
18331
18332 =item B<input_handle()>
18333
18334 =back
18335
18336 =over 4
18337
18338 =item B<input_streams()>
18339
18340 =back
18341
18342 =over 4
18343
18344 =item B<top_stream()>
18345
18346 =back
18347
18348 =over 4
18349
18350 =item PRIVATE METHODS AND DATA
18351
18352 =back
18353
18354 =over 4
18355
18356 =item B<_push_input_stream()>
18357
18358 =back
18359
18360 =over 4
18361
18362 =item B<_pop_input_stream()>
18363
18364 =back
18365
18366 =over 4
18367
18368 =item TREE-BASED PARSING
18369
18370 =item SEE ALSO
18371
18372 =item AUTHOR
18373
18374 =back
18375
18376 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18377
18378 =over 4
18379
18380 =item SYNOPSIS
18381
18382 =item DESCRIPTION
18383
18384 =item SEE ALSO
18385
18386 =item COPYRIGHT AND DISCLAIMERS
18387
18388 =item AUTHOR
18389
18390 =back
18391
18392 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18393
18394 =over 4
18395
18396 =item SYNOPSIS
18397
18398 =item DESCRIPTION
18399
18400 =item CAVEAT
18401
18402 =item SEE ALSO
18403
18404 =item COPYRIGHT AND DISCLAIMERS
18405
18406 =item AUTHOR
18407
18408 =back
18409
18410 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18411
18412 =over 4
18413
18414 =item SYNOPSIS
18415
18416 =item DESCRIPTION
18417
18418 =item CAVEAT
18419
18420 =item SEE ALSO
18421
18422 =item COPYRIGHT AND DISCLAIMERS
18423
18424 =item AUTHOR
18425
18426 =back
18427
18428 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18429
18430 =over 4
18431
18432 =item SYNOPSIS
18433
18434 =item DESCRIPTION
18435
18436 =item SEE ALSO
18437
18438 =item COPYRIGHT AND DISCLAIMERS
18439
18440 =item AUTHOR
18441
18442 =back
18443
18444 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18445
18446 =over 4
18447
18448 =item SYNOPSIS
18449
18450 =item DESCRIPTION
18451
18452 =item SEE ALSO
18453
18454 =item COPYRIGHT AND DISCLAIMERS
18455
18456 =item AUTHOR
18457
18458 =back
18459
18460 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18461
18462 =over 4
18463
18464 =item SYNOPSIS
18465
18466 =item DESCRIPTION
18467
18468 =item CAVEAT
18469
18470 =item SEE ALSO
18471
18472 =item COPYRIGHT AND DISCLAIMERS
18473
18474 =item AUTHOR
18475
18476 =back
18477
18478 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18479
18480 =over 4
18481
18482 =item SYNOPSIS
18483
18484 =item DESCRIPTION
18485
18486 =item SEE ALSO
18487
18488 =item AUTHOR
18489
18490 =back
18491
18492 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18493
18494 =over 4
18495
18496 =item SYNOPSIS
18497
18498 =item DESCRIPTION
18499
18500 =item SEE ALSO
18501
18502 =item COPYRIGHT AND DISCLAIMERS
18503
18504 =item AUTHOR
18505
18506 =back
18507
18508 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18509
18510 =over 4
18511
18512 =item SYNOPSIS
18513
18514 =item DESCRIPTION
18515
18516 alt, indent, loose, sentence, width
18517
18518 =item DIAGNOSTICS
18519
18520 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18521 Unknown sequence: %s, Unmatched =back
18522
18523 =item RESTRICTIONS
18524
18525 =item NOTES
18526
18527 =item SEE ALSO
18528
18529 =item AUTHOR
18530
18531 =back
18532
18533 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18534
18535 =over 4
18536
18537 =item SYNOPSIS
18538
18539 =item DESCRIPTION
18540
18541 =over 4
18542
18543 =item EXPORT
18544
18545 =back
18546
18547 =item AUTHOR
18548
18549 =item SEE ALSO
18550
18551 =back
18552
18553 =head2 Pod::Select, podselect() - extract selected sections of POD from
18554 input
18555
18556 =over 4
18557
18558 =item SYNOPSIS
18559
18560 =item REQUIRES
18561
18562 =item EXPORTS
18563
18564 =item DESCRIPTION
18565
18566 =item SECTION SPECIFICATIONS
18567
18568 =item RANGE SPECIFICATIONS
18569
18570 =back
18571
18572 =over 4
18573
18574 =item OBJECT METHODS
18575
18576 =back
18577
18578 =over 4
18579
18580 =item B<curr_headings()>
18581
18582 =back
18583
18584 =over 4
18585
18586 =item B<select()>
18587
18588 =back
18589
18590 =over 4
18591
18592 =item B<add_selection()>
18593
18594 =back
18595
18596 =over 4
18597
18598 =item B<clear_selections()>
18599
18600 =back
18601
18602 =over 4
18603
18604 =item B<match_section()>
18605
18606 =back
18607
18608 =over 4
18609
18610 =item B<is_selected()>
18611
18612 =back
18613
18614 =over 4
18615
18616 =item EXPORTED FUNCTIONS
18617
18618 =back
18619
18620 =over 4
18621
18622 =item B<podselect()>
18623
18624 B<-output>, B<-sections>, B<-ranges>
18625
18626 =back
18627
18628 =over 4
18629
18630 =item PRIVATE METHODS AND DATA
18631
18632 =back
18633
18634 =over 4
18635
18636 =item B<_compile_section_spec()>
18637
18638 =back
18639
18640 =over 4
18641
18642 =item $self->{_SECTION_HEADINGS}
18643
18644 =back
18645
18646 =over 4
18647
18648 =item $self->{_SELECTED_SECTIONS}
18649
18650 =back
18651
18652 =over 4
18653
18654 =item SEE ALSO
18655
18656 =item AUTHOR
18657
18658 =back
18659
18660 =head2 Pod::Text - Convert POD data to formatted ASCII text
18661
18662 =over 4
18663
18664 =item SYNOPSIS
18665
18666 =item DESCRIPTION
18667
18668 alt, code, indent, loose, margin, quotes, sentence, width
18669
18670 =item DIAGNOSTICS
18671
18672 Bizarre space in item, Item called without tag, Can't open %s for reading:
18673 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
18674 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
18675 Unmatched =back
18676
18677 =item RESTRICTIONS
18678
18679 =item NOTES
18680
18681 =item SEE ALSO
18682
18683 =item AUTHOR
18684
18685 =item COPYRIGHT AND LICENSE
18686
18687 =back
18688
18689 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
18690
18691 =over 4
18692
18693 =item SYNOPSIS
18694
18695 =item DESCRIPTION
18696
18697 =item BUGS
18698
18699 =item SEE ALSO
18700
18701 =item AUTHOR
18702
18703 =item COPYRIGHT AND LICENSE
18704
18705 =back
18706
18707 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
18708 text
18709
18710 =over 4
18711
18712 =item SYNOPSIS
18713
18714 =item DESCRIPTION
18715
18716 =item BUGS
18717
18718 =item SEE ALSO
18719
18720 =item AUTHOR
18721
18722 =item COPYRIGHT AND LICENSE
18723
18724 =back
18725
18726 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
18727 escapes
18728
18729 =over 4
18730
18731 =item SYNOPSIS
18732
18733 =item DESCRIPTION
18734
18735 =item NOTES
18736
18737 =item SEE ALSO
18738
18739 =item AUTHOR
18740
18741 =item COPYRIGHT AND LICENSE
18742
18743 =back
18744
18745 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
18746 documentation
18747
18748 =over 4
18749
18750 =item SYNOPSIS
18751
18752 =item ARGUMENTS
18753
18754 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
18755 C<-pathlist>
18756
18757 =item DESCRIPTION
18758
18759 =item EXAMPLES
18760
18761 =over 4
18762
18763 =item Recommended Use
18764
18765 =back
18766
18767 =item CAVEATS
18768
18769 =item AUTHOR
18770
18771 =item ACKNOWLEDGEMENTS
18772
18773 =back
18774
18775 =head2 SDBM_File - Tied access to sdbm files
18776
18777 =over 4
18778
18779 =item SYNOPSIS
18780
18781 =item DESCRIPTION
18782
18783 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18784
18785 =item DIAGNOSTICS
18786
18787 =over 4
18788
18789 =item C<sdbm store returned -1, errno 22, key "..." at ...>
18790
18791 =back
18792
18793 =item BUGS AND WARNINGS
18794
18795 =back
18796
18797 =head2 Safe - Compile and execute code in restricted compartments
18798
18799 =over 4
18800
18801 =item SYNOPSIS
18802
18803 =item DESCRIPTION
18804
18805 a new namespace, an operator mask
18806
18807 =item WARNING
18808
18809 =over 4
18810
18811 =item RECENT CHANGES
18812
18813 =item Methods in class Safe
18814
18815 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18816 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18817 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18818 root (NAMESPACE), mask (MASK)
18819
18820 =item Some Safety Issues
18821
18822 Memory, CPU, Snooping, Signals, State Changes
18823
18824 =item AUTHOR
18825
18826 =back
18827
18828 =back
18829
18830 =head2 Scalar::Util - A selection of general-utility scalar subroutines
18831
18832 =over 4
18833
18834 =item SYNOPSIS
18835
18836 =item DESCRIPTION
18837
18838 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
18839 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
18840 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
18841
18842 =item KNOWN BUGS
18843
18844 =item COPYRIGHT
18845
18846 =item BLATANT PLUG
18847
18848 =back
18849
18850 =head2 Search::Dict, look - search for key in dictionary file
18851
18852 =over 4
18853
18854 =item SYNOPSIS
18855
18856 =item DESCRIPTION
18857
18858 =back
18859
18860 =head2 SelectSaver - save and restore selected file handle
18861
18862 =over 4
18863
18864 =item SYNOPSIS
18865
18866 =item DESCRIPTION
18867
18868 =back
18869
18870 =head2 SelfLoader - load functions only on demand
18871
18872 =over 4
18873
18874 =item SYNOPSIS
18875
18876 =item DESCRIPTION
18877
18878 =over 4
18879
18880 =item The __DATA__ token
18881
18882 =item SelfLoader autoloading
18883
18884 =item Autoloading and package lexicals
18885
18886 =item SelfLoader and AutoLoader
18887
18888 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
18889
18890 =item Classes and inherited methods.
18891
18892 =back
18893
18894 =item Multiple packages and fully qualified subroutine names
18895
18896 =back
18897
18898 =head2 Shell - run shell commands transparently within perl
18899
18900 =over 4
18901
18902 =item SYNOPSIS
18903
18904 =item DESCRIPTION
18905
18906 =over 4
18907
18908 =item OBJECT ORIENTED SYNTAX
18909
18910 =back
18911
18912 =item AUTHOR
18913
18914 =back
18915
18916 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
18917 socket.h defines and structure manipulators
18918
18919 =over 4
18920
18921 =item SYNOPSIS
18922
18923 =item DESCRIPTION
18924
18925 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
18926 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
18927 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
18928 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
18929 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
18930
18931 =back
18932
18933 =head2 Storable - persistence for Perl data structures
18934
18935 =over 4
18936
18937 =item SYNOPSIS
18938
18939 =item DESCRIPTION
18940
18941 =item MEMORY STORE
18942
18943 =item ADVISORY LOCKING
18944
18945 =item SPEED
18946
18947 =item CANONICAL REPRESENTATION
18948
18949 =item CODE REFERENCES
18950
18951 =item FORWARD COMPATIBILITY
18952
18953 utf8 data, restricted hashes, files from future versions of Storable
18954
18955 =item ERROR REPORTING
18956
18957 =item WIZARDS ONLY
18958
18959 =over 4
18960
18961 =item Hooks
18962
18963 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18964 I<serialized>, ..
18965
18966 =item Predicates
18967
18968 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18969 C<Storable::is_retrieving>
18970
18971 =item Recursion
18972
18973 =item Deep Cloning
18974
18975 =back
18976
18977 =item Storable magic
18978
18979 =item EXAMPLES
18980
18981 =item WARNING
18982
18983 =item BUGS
18984
18985 =over 4
18986
18987 =item 64 bit data in perl 5.6.0 and 5.6.1
18988
18989 =back
18990
18991 =item CREDITS
18992
18993 =item AUTHOR
18994
18995 =item SEE ALSO
18996
18997 =back
18998
18999 =head2 Switch - A switch statement for Perl
19000
19001 =over 4
19002
19003 =item VERSION
19004
19005 =item SYNOPSIS
19006
19007 =item BACKGROUND
19008
19009 =item DESCRIPTION
19010
19011 =over 4
19012
19013 =item Allowing fall-through
19014
19015 =item Automating fall-through
19016
19017 =item Alternative syntax
19018
19019 =item Higher-order Operations
19020
19021 =back
19022
19023 =item DEPENDENCIES
19024
19025 =item AUTHOR
19026
19027 =item BUGS
19028
19029 =item LIMITATION
19030
19031 =item COPYRIGHT
19032
19033 =back
19034
19035 =head2 Symbol - manipulate Perl symbols and their names
19036
19037 =over 4
19038
19039 =item SYNOPSIS
19040
19041 =item DESCRIPTION
19042
19043 =back
19044
19045 =head2 Sys::Hostname - Try every conceivable way to get hostname
19046
19047 =over 4
19048
19049 =item SYNOPSIS
19050
19051 =item DESCRIPTION
19052
19053 =item AUTHOR
19054
19055 =back
19056
19057 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19058 interface to the UNIX syslog(3) calls
19059
19060 =over 4
19061
19062 =item SYNOPSIS
19063
19064 =item DESCRIPTION
19065
19066 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19067 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19068 in 5.004_02), closelog
19069
19070 =item EXAMPLES
19071
19072 =item SEE ALSO
19073
19074 =item AUTHOR
19075
19076 =back
19077
19078 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19079 Perl interface to the UNIX syslog(3) calls
19080
19081 =over 4
19082
19083 =item SYNOPSIS
19084
19085 =item DESCRIPTION
19086
19087 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19088 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19089 in 5.004_02), closelog
19090
19091 =item EXAMPLES
19092
19093 =item SEE ALSO
19094
19095 =item AUTHOR
19096
19097 =back
19098
19099 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19100
19101 =over 4
19102
19103 =item SYNOPSIS
19104
19105 =item DESCRIPTION
19106
19107 =item DIAGNOSTICS
19108
19109 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19110 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19111 comma allowed after filehandle, No name for escape sequence %s
19112
19113 =item ENVIRONMENT
19114
19115 ANSI_COLORS_DISABLED
19116
19117 =item RESTRICTIONS
19118
19119 =item NOTES
19120
19121 =item SEE ALSO
19122
19123 =item AUTHORS
19124
19125 =item COPYRIGHT AND LICENSE
19126
19127 =back
19128
19129 =head2 Term::Cap - Perl termcap interface
19130
19131 =over 4
19132
19133 =item SYNOPSIS
19134
19135 =item DESCRIPTION
19136
19137 =over 4
19138
19139 =item METHODS
19140
19141 =back
19142
19143 =back
19144
19145 B<Tgetent>, OSPEED, TERM
19146
19147 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19148
19149 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19150
19151 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19152
19153 B<Trequire>
19154
19155 =over 4
19156
19157 =item EXAMPLES
19158
19159 =item COPYRIGHT AND LICENSE
19160
19161 =item AUTHOR
19162
19163 =item SEE ALSO
19164
19165 =back
19166
19167 =head2 Term::Complete - Perl word completion module
19168
19169 =over 4
19170
19171 =item SYNOPSIS
19172
19173 =item DESCRIPTION
19174
19175 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19176
19177 =item DIAGNOSTICS
19178
19179 =item BUGS
19180
19181 =item AUTHOR
19182
19183 =back
19184
19185 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19186 If no real package is found, substitutes stubs instead of basic functions.
19187
19188 =over 4
19189
19190 =item SYNOPSIS
19191
19192 =item DESCRIPTION
19193
19194 =item Minimal set of supported functions
19195
19196 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19197 C<findConsole>, Attribs, C<Features>
19198
19199 =item Additional supported functions
19200
19201 C<tkRunning>, C<ornaments>, C<newTTY>
19202
19203 =item EXPORTS
19204
19205 =item ENVIRONMENT
19206
19207 =item CAVEATS
19208
19209 =back
19210
19211 =head2 Test - provides a simple framework for writing test scripts
19212
19213 =over 4
19214
19215 =item SYNOPSIS
19216
19217 =item DESCRIPTION
19218
19219 =item QUICK START GUIDE
19220
19221 =over 4
19222
19223 =item Functions
19224
19225 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19226 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19227
19228 =back
19229
19230 =back
19231
19232 B<_to_value>
19233
19234 C<ok(...)>
19235
19236 C<skip(I<skip_if_true>, I<args...>)>
19237
19238 =over 4
19239
19240 =item TEST TYPES
19241
19242 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19243
19244 =item ONFAIL
19245
19246 =item BUGS and CAVEATS
19247
19248 =item NOTE
19249
19250 =item SEE ALSO
19251
19252 =item AUTHOR
19253
19254 =back
19255
19256 =head2 Test::Builder - Backend for building test libraries
19257
19258 =over 4
19259
19260 =item SYNOPSIS
19261
19262 =item DESCRIPTION
19263
19264 =over 4
19265
19266 =item Construction
19267
19268 B<new>
19269
19270 =back
19271
19272 =back
19273
19274 =over 4
19275
19276 =item Setting up tests
19277
19278 B<exported_to>
19279
19280 =back
19281
19282 B<plan>
19283
19284 B<expected_tests>
19285
19286 B<no_plan>
19287
19288 B<has_plan>
19289
19290 B<skip_all>
19291
19292 =over 4
19293
19294 =item Running tests
19295
19296 B<ok>
19297
19298 =back
19299
19300 B<is_eq>, B<is_num>
19301
19302 B<isnt_eq>, B<isnt_num>
19303
19304 B<like>, B<unlike>
19305
19306 B<maybe_regex>
19307
19308 B<cmp_ok>
19309
19310 B<BAILOUT>
19311
19312 B<skip>
19313
19314 B<todo_skip>
19315
19316 B<skip_rest>
19317
19318 =over 4
19319
19320 =item Test style
19321
19322 B<level>
19323
19324 =back
19325
19326 B<use_numbers>
19327
19328 B<no_header>, B<no_ending>
19329
19330 =over 4
19331
19332 =item Output
19333
19334 B<diag>
19335
19336 =back
19337
19338 B<_print>
19339
19340 B<output>, B<failure_output>, B<todo_output>
19341
19342 =over 4
19343
19344 =item Test Status and Info
19345
19346 B<current_test>
19347
19348 =back
19349
19350 B<summary>
19351
19352 B<details>
19353
19354 B<todo>
19355
19356 B<caller>
19357
19358 B<_sanity_check>
19359
19360 B<_whoa>
19361
19362 B<_my_exit>
19363
19364 =over 4
19365
19366 =item THREADS
19367
19368 =item EXAMPLES
19369
19370 =item SEE ALSO
19371
19372 =item AUTHORS
19373
19374 =item COPYRIGHT
19375
19376 =back
19377
19378 =head2 Test::Harness - run perl standard test scripts with statistics
19379
19380 =over 4
19381
19382 =item SYNOPSIS
19383
19384 =item DESCRIPTION
19385
19386 =over 4
19387
19388 =item The test script output
19389
19390 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19391 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19392 else>
19393
19394 =item Taint mode
19395
19396 =item Configuration variables.
19397
19398 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19399
19400 =item Failure
19401
19402 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19403 Failed>
19404
19405 =item Functions
19406
19407 B<runtests>
19408
19409 =back
19410
19411 =back
19412
19413 B<_all_ok>
19414
19415 B<_globdir>
19416
19417 B<_run_all_tests>
19418
19419 B<_mk_leader>
19420
19421 B<_leader_width>
19422
19423 =over 4
19424
19425 =item EXPORT
19426
19427 =item DIAGNOSTICS
19428
19429 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19430 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19431 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19432 %s>, C<FAILED--Further testing stopped: %s>
19433
19434 =item ENVIRONMENT
19435
19436 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19437 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19438 C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19439
19440 =item EXAMPLE
19441
19442 =item SEE ALSO
19443
19444 =item AUTHORS
19445
19446 =item LICENSE
19447
19448 =item TODO
19449
19450 =item BUGS
19451
19452 =back
19453
19454 =head2 Test::Harness::Assert - simple assert
19455
19456 =over 4
19457
19458 =item SYNOPSIS
19459
19460 =item DESCRIPTION
19461
19462 =over 4
19463
19464 =item Functions
19465
19466 B<assert>
19467
19468 =back
19469
19470 =back
19471
19472 =over 4
19473
19474 =item AUTHOR
19475
19476 =item SEE ALSO
19477
19478 =back
19479
19480 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19481
19482 =over 4
19483
19484 =item SYNOPSIS
19485
19486 =item DESCRIPTION
19487
19488 =back
19489
19490 =head2 Test::Harness::Straps - detailed analysis of test results
19491
19492 =over 4
19493
19494 =item SYNOPSIS
19495
19496 =item DESCRIPTION
19497
19498 =over 4
19499
19500 =item Construction
19501
19502 B<new>
19503
19504 =back
19505
19506 =back
19507
19508 B<_init>
19509
19510 =over 4
19511
19512 =item Analysis
19513
19514 B<analyze>
19515
19516 =back
19517
19518 B<analyze_fh>
19519
19520 B<analyze_file>
19521
19522 B<_switches>
19523
19524 B<_INC2PERL5LIB>
19525
19526 B<_filtered_INC>
19527
19528 B<_restore_PERL5LIB>
19529
19530 =over 4
19531
19532 =item Parsing
19533
19534 B<_is_comment>
19535
19536 =back
19537
19538 B<_is_header>
19539
19540 B<_is_test>
19541
19542 B<_is_bail_out>
19543
19544 B<_reset_file_state>
19545
19546 =over 4
19547
19548 =item Results
19549
19550 B<_detailize>
19551
19552 =back
19553
19554 =over 4
19555
19556 =item EXAMPLES
19557
19558 =item AUTHOR
19559
19560 =item SEE ALSO
19561
19562 =back
19563
19564 =head2 Test::More - yet another framework for writing test scripts
19565
19566 =over 4
19567
19568 =item SYNOPSIS
19569
19570 =item DESCRIPTION
19571
19572 =over 4
19573
19574 =item I love it when a plan comes together
19575
19576 =back
19577
19578 =back
19579
19580 =over 4
19581
19582 =item Test names
19583
19584 =item I'm ok, you're not ok.
19585
19586 B<ok>
19587
19588 =back
19589
19590 B<is>, B<isnt>
19591
19592 B<like>
19593
19594 B<unlike>
19595
19596 B<cmp_ok>
19597
19598 B<can_ok>
19599
19600 B<isa_ok>
19601
19602 B<pass>, B<fail>
19603
19604 =over 4
19605
19606 =item Diagnostics
19607
19608 B<diag>
19609
19610 =back
19611
19612 =over 4
19613
19614 =item Module tests
19615
19616 B<use_ok>
19617
19618 =back
19619
19620 B<require_ok>
19621
19622 =over 4
19623
19624 =item Conditional tests
19625
19626 B<SKIP: BLOCK>
19627
19628 =back
19629
19630 B<TODO: BLOCK>, B<todo_skip>
19631
19632 When do I use SKIP vs. TODO?
19633
19634 =over 4
19635
19636 =item Comparison functions
19637
19638 B<is_deeply>
19639
19640 =back
19641
19642 B<eq_array>
19643
19644 B<eq_hash>
19645
19646 B<eq_set>
19647
19648 =over 4
19649
19650 =item Extending and Embedding Test::More
19651
19652 B<builder>
19653
19654 =back
19655
19656 =over 4
19657
19658 =item NOTES
19659
19660 =item BUGS and CAVEATS
19661
19662 Making your own ok(), The eq_* family has some caveats, Test::Harness
19663 upgrades
19664
19665 =item HISTORY
19666
19667 =item SEE ALSO
19668
19669 =item AUTHORS
19670
19671 =item COPYRIGHT
19672
19673 =back
19674
19675 =head2 Test::Simple - Basic utilities for writing tests.
19676
19677 =over 4
19678
19679 =item SYNOPSIS
19680
19681 =item DESCRIPTION
19682
19683 B<ok>
19684
19685 =back
19686
19687 =over 4
19688
19689 =item EXAMPLE
19690
19691 =item CAVEATS
19692
19693 =item NOTES
19694
19695 =item HISTORY
19696
19697 =item SEE ALSO
19698
19699 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
19700 L<Test::Harness>
19701
19702 =item AUTHORS
19703
19704 =item COPYRIGHT
19705
19706 =back
19707
19708 =head2 Test::Tutorial - A tutorial about writing really basic tests
19709
19710 =over 4
19711
19712 =item DESCRIPTION
19713
19714 =over 4
19715
19716 =item Nuts and bolts of testing.
19717
19718 =item Where to start?
19719
19720 =item Names
19721
19722 =item Test the manual
19723
19724 =item Sometimes the tests are wrong
19725
19726 =item Testing lots of values
19727
19728 =item Informative names
19729
19730 =item Skipping tests
19731
19732 =item Todo tests
19733
19734 =item Testing with taint mode.
19735
19736 =back
19737
19738 =item FOOTNOTES
19739
19740 =item AUTHORS
19741
19742 =item COPYRIGHT
19743
19744 =back
19745
19746 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
19747
19748 =over 4
19749
19750 =item SYNOPSIS
19751
19752 =item DESCRIPTION
19753
19754 =item EXAMPLE
19755
19756 =back
19757
19758 =head2 Text::Balanced - Extract delimited text sequences from strings.
19759
19760 =over 4
19761
19762 =item SYNOPSIS
19763
19764 =item DESCRIPTION
19765
19766 =over 4
19767
19768 =item General behaviour in list contexts
19769
19770 [0], [1], [2]
19771
19772 =item General behaviour in scalar and void contexts
19773
19774 =item A note about prefixes
19775
19776 =item C<extract_delimited>
19777
19778 =item C<extract_bracketed>
19779
19780 =item C<extract_variable>
19781
19782 [0], [1], [2]
19783
19784 =item C<extract_tagged>
19785
19786 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
19787 [0], [1], [2], [3], [4], [5]
19788
19789 =item C<gen_extract_tagged>
19790
19791 =item C<extract_quotelike>
19792
19793 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
19794
19795 =item C<extract_quotelike> and "here documents"
19796
19797 [0], [1], [2], [3], [4], [5], [6], [7..10]
19798
19799 =item C<extract_codeblock>
19800
19801 =item C<extract_multiple>
19802
19803 =item C<gen_delimited_pat>
19804
19805 =back
19806
19807 =item DIAGNOSTICS
19808
19809  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
19810 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
19811 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
19812 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
19813 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
19814 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
19815 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
19816 after dereferencer>, C<Did not find expected opening bracket at %s>,
19817 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
19818 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
19819 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
19820 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
19821 tag>
19822
19823 =item AUTHOR
19824
19825 =item BUGS AND IRRITATIONS
19826
19827 =item COPYRIGHT
19828
19829 =back
19830
19831 =head2 Text::ParseWords - parse text into an array of tokens or array of
19832 arrays
19833
19834 =over 4
19835
19836 =item SYNOPSIS
19837
19838 =item DESCRIPTION
19839
19840 =item EXAMPLES
19841
19842 =item AUTHORS
19843
19844 =back
19845
19846 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
19847 by Knuth
19848
19849 =over 4
19850
19851 =item SYNOPSIS
19852
19853 =item DESCRIPTION
19854
19855 =item EXAMPLES
19856
19857 =item LIMITATIONS
19858
19859 =item AUTHOR
19860
19861 =back
19862
19863 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
19864 unexpand(1)
19865
19866 =over 4
19867
19868 =item SYNOPSIS
19869
19870 =item DESCRIPTION
19871
19872 =item BUGS
19873
19874 =item AUTHOR
19875
19876 =back
19877
19878 =head2 Text::Wrap - line wrapping to form simple paragraphs
19879
19880 =over 4
19881
19882 =item SYNOPSIS
19883
19884 =item DESCRIPTION
19885
19886 =item OVERRIDES
19887
19888 =item EXAMPLE
19889
19890 =item AUTHOR
19891
19892 =back
19893
19894 =head2 Thread - manipulate threads in Perl (for old code only)
19895
19896 =over 4
19897
19898 =item CAVEAT
19899
19900 =item SYNOPSIS
19901
19902 =item DESCRIPTION
19903
19904 =item FUNCTIONS
19905
19906 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
19907 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
19908 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
19909
19910 =item METHODS
19911
19912 join, eval, detach, equal, tid, flags, done
19913
19914 =item LIMITATIONS
19915
19916 =item SEE ALSO
19917
19918 =back
19919
19920 =head2 Thread::Queue - thread-safe queues
19921
19922 =over 4
19923
19924 =item SYNOPSIS
19925
19926 =item DESCRIPTION
19927
19928 =item FUNCTIONS AND METHODS
19929
19930 new, enqueue LIST, dequeue, dequeue_nb, pending
19931
19932 =item SEE ALSO
19933
19934 =back
19935
19936 =head2 Thread::Semaphore - thread-safe semaphores
19937
19938 =over 4
19939
19940 =item SYNOPSIS
19941
19942 =item DESCRIPTION
19943
19944 =item FUNCTIONS AND METHODS
19945
19946 new, new NUMBER, down, down NUMBER, up, up NUMBER
19947
19948 =back
19949
19950 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
19951 (for old code)
19952
19953 =over 4
19954
19955 =item CAVEAT
19956
19957 =item SYNOPSIS
19958
19959 =item DESCRIPTION
19960
19961 =item BUGS
19962
19963 =back
19964
19965 =head2 Thread::Specific - thread-specific keys
19966
19967 =over 4
19968
19969 =item SYNOPSIS
19970
19971 =item DESCRIPTION
19972
19973 =back
19974
19975 =head2 Tie::Array - base class for tied arrays
19976
19977 =over 4
19978
19979 =item SYNOPSIS
19980
19981 =item DESCRIPTION
19982
19983 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19984 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19985 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19986 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19987
19988 =item CAVEATS
19989
19990 =item AUTHOR
19991
19992 =back
19993
19994 =head2 Tie::File - Access the lines of a disk file via a Perl array
19995
19996 =over 4
19997
19998 =item SYNOPSIS
19999
20000 =item DESCRIPTION
20001
20002 =over 4
20003
20004 =item C<recsep>
20005
20006 =item C<autochomp>
20007
20008 =item C<mode>
20009
20010 =item C<memory>
20011
20012 =item C<dw_size>
20013
20014 =item Option Format
20015
20016 =back
20017
20018 =item Public Methods
20019
20020 =over 4
20021
20022 =item C<flock>
20023
20024 =item C<autochomp>
20025
20026 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20027
20028 =item C<offset>
20029
20030 =back
20031
20032 =item Tying to an already-opened filehandle
20033
20034 =item Deferred Writing
20035
20036 =over 4
20037
20038 =item Autodeferring
20039
20040 =back
20041
20042 =item CONCURRENT ACCESS TO FILES
20043
20044 =item CAVEATS
20045
20046 =item SUBCLASSING
20047
20048 =item WHAT ABOUT C<DB_File>?
20049
20050 =item AUTHOR
20051
20052 =item LICENSE
20053
20054 =item WARRANTY
20055
20056 =item THANKS
20057
20058 =item TODO
20059
20060 =back
20061
20062 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20063 handles
20064
20065 =over 4
20066
20067 =item SYNOPSIS
20068
20069 =item DESCRIPTION
20070
20071 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20072 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20073 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20074 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20075
20076 =item MORE INFORMATION
20077
20078 =item COMPATIBILITY
20079
20080 =back
20081
20082 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20083 tied hashes
20084
20085 =over 4
20086
20087 =item SYNOPSIS
20088
20089 =item DESCRIPTION
20090
20091 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20092 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20093
20094 =item Inheriting from B<Tie::StdHash>
20095
20096 =item Inheriting from B<Tie::ExtraHash>
20097
20098 =item C<UNTIE> and C<DESTROY>
20099
20100 =item MORE INFORMATION
20101
20102 =back
20103
20104 =head2 Tie::Memoize - add data to hash when needed
20105
20106 =over 4
20107
20108 =item SYNOPSIS
20109
20110 =item DESCRIPTION
20111
20112 =item Inheriting from B<Tie::Memoize>
20113
20114 =item EXAMPLE
20115
20116 =item BUGS
20117
20118 =item AUTHOR
20119
20120 =back
20121
20122 =head2 Tie::RefHash - use references as hash keys
20123
20124 =over 4
20125
20126 =item SYNOPSIS
20127
20128 =item DESCRIPTION
20129
20130 =item EXAMPLE
20131
20132 =item AUTHOR
20133
20134 =item VERSION
20135
20136 =item SEE ALSO
20137
20138 =back
20139
20140 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20141 scalars
20142
20143 =over 4
20144
20145 =item SYNOPSIS
20146
20147 =item DESCRIPTION
20148
20149 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20150
20151 =item MORE INFORMATION
20152
20153 =back
20154
20155 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20156
20157 =over 4
20158
20159 =item SYNOPSIS
20160
20161 =item DESCRIPTION
20162
20163 =item CAVEATS
20164
20165 =back
20166
20167 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20168 timers
20169
20170 =over 4
20171
20172 =item SYNOPSIS
20173
20174 =item DESCRIPTION
20175
20176 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20177 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20178 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
20179 getitimer ( $which )
20180
20181 =item EXAMPLES
20182
20183 =item C API
20184
20185 =item DIAGNOSTICS
20186
20187 =over 4
20188
20189 =item negative time not invented yet
20190
20191 =item internal error: useconds < 0 (unsigned ... signed ...)
20192
20193 =back
20194
20195 =item CAVEATS
20196
20197 =item AUTHORS
20198
20199 =item COPYRIGHT AND LICENSE
20200
20201 =back
20202
20203 =head2 Time::Local - efficiently compute time from local and GMT time
20204
20205 =over 4
20206
20207 =item SYNOPSIS
20208
20209 =item DESCRIPTION
20210
20211 =item IMPLEMENTATION
20212
20213 =item BUGS
20214
20215 =item SUPPORT
20216
20217 =item AUTHOR
20218
20219 =back
20220
20221 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20222 function
20223
20224 =over 4
20225
20226 =item SYNOPSIS
20227
20228 =item DESCRIPTION
20229
20230 =item NOTE
20231
20232 =item AUTHOR
20233
20234 =back
20235
20236 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
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::tm - internal object used by Time::gmtime and Time::localtime
20252
20253 =over 4
20254
20255 =item SYNOPSIS
20256
20257 =item DESCRIPTION
20258
20259 =item AUTHOR
20260
20261 =back
20262
20263 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20264
20265 =over 4
20266
20267 =item SYNOPSIS
20268
20269 =item DESCRIPTION
20270
20271 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20272 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20273 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20274
20275 =item EXPORTS
20276
20277 =back
20278
20279 =head2 Unicode::Collate - Unicode Collation Algorithm
20280
20281 =over 4
20282
20283 =item SYNOPSIS
20284
20285 =item DESCRIPTION
20286
20287 =over 4
20288
20289 =item Constructor and Tailoring
20290
20291 UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
20292 normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
20293 undefName, undefChar, katakana_before_hiragana, upper_before_lower
20294
20295 =item Methods for Collation
20296
20297 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20298 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20299 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20300 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20301 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20302 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20303 $Collator-E<gt>viewSortKey($string)>
20304
20305 =item Methods for Searching
20306
20307 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20308 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20309 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20310 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20311 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20312 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20313 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20314
20315 =item Other Methods
20316
20317 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
20318 Base_Unicode_Version
20319
20320 =item EXPORT
20321
20322 =item CAVEAT
20323
20324 =item Conformance Test
20325
20326 =back
20327
20328 =item AUTHOR
20329
20330 =item SEE ALSO
20331
20332 http://www.unicode.org/reports/tr10/,
20333 http://www.unicode.org/reports/tr10/allkeys.txt,
20334 http://www.unicode.org/reports/tr10/CollationTest.html
20335 http://www.unicode.org/reports/tr10/CollationTest.zip,
20336 http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
20337
20338 =back
20339
20340 =head2 Unicode::Normalize - Unicode Normalization Forms
20341
20342 =over 4
20343
20344 =item SYNOPSIS
20345
20346 =item DESCRIPTION
20347
20348 =over 4
20349
20350 =item Normalization Forms
20351
20352 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20353 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20354 C<$normalized_string = normalize($form_name, $string)>
20355
20356 =item Decomposition and Composition
20357
20358 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20359 decompose($string, $useCompatMapping)>, C<$reordered_string  =
20360 reorder($string)>, C<$composed_string   = compose($string)>
20361
20362 =item Quick Check
20363
20364 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20365 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20366 check($form_name, $string)>
20367
20368 =item Character Data
20369
20370 C<$canonical_decomposed = getCanon($codepoint)>,
20371 C<$compatibility_decomposed = getCompat($codepoint)>,
20372 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20373 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20374 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20375 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20376 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20377
20378 =item EXPORT
20379
20380 =back
20381
20382 =item AUTHOR
20383
20384 =item SEE ALSO
20385
20386 http://www.unicode.org/unicode/reports/tr15/,
20387 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
20388
20389 =back
20390
20391 =head2 Unicode::UCD - Unicode character database
20392
20393 =over 4
20394
20395 =item SYNOPSIS
20396
20397 =item DESCRIPTION
20398
20399 =back
20400
20401 =over 4
20402
20403 =item charinfo
20404
20405 =back
20406
20407 =over 4
20408
20409 =item charblock
20410
20411 =back
20412
20413 =over 4
20414
20415 =item charscript
20416
20417 =back
20418
20419 =over 4
20420
20421 =item charblocks
20422
20423 =back
20424
20425 =over 4
20426
20427 =item charscripts
20428
20429 =back
20430
20431 =over 4
20432
20433 =item Blocks versus Scripts
20434
20435 =item Matching Scripts and Blocks
20436
20437 =item Code Point Arguments
20438
20439 =item charinrange
20440
20441 =back
20442
20443 =over 4
20444
20445 =item compexcl
20446
20447 =back
20448
20449 =over 4
20450
20451 =item casefold
20452
20453 =back
20454
20455 =over 4
20456
20457 =item casespec
20458
20459 =back
20460
20461 =over 4
20462
20463 =item Unicode::UCD::UnicodeVersion
20464
20465 =back
20466
20467 =over 4
20468
20469 =item Implementation Note
20470
20471 =back
20472
20473 =over 4
20474
20475 =item BUGS
20476
20477 =item AUTHOR
20478
20479 =back
20480
20481 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20482 functions
20483
20484 =over 4
20485
20486 =item SYNOPSIS
20487
20488 =item DESCRIPTION
20489
20490 =item NOTE
20491
20492 =item AUTHOR
20493
20494 =back
20495
20496 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20497 functions
20498
20499 =over 4
20500
20501 =item SYNOPSIS
20502
20503 =item DESCRIPTION
20504
20505 =over 4
20506
20507 =item System Specifics
20508
20509 =back
20510
20511 =item NOTE
20512
20513 =item AUTHOR
20514
20515 =item HISTORY
20516
20517 March 18th, 2000
20518
20519 =back
20520
20521 =head2 Win32 - Interfaces to some Win32 API Functions
20522
20523 =over 4
20524
20525 =item DESCRIPTION
20526
20527 =over 4
20528
20529 =item Alphabetical Listing of Win32 Functions
20530
20531 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20532 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20533 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20534 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20535 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20536 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20537 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20538 Win32::GetOSVersion(), Win32::GetOSName(),
20539 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20540 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20541 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20542 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20543 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20544 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20545 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20546 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20547 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
20548 Win32::UnregisterServer(LIBRARYNAME)
20549
20550 =back
20551
20552 =back
20553
20554 =head2 XSLoader - Dynamically load C libraries into Perl code
20555
20556 =over 4
20557
20558 =item SYNOPSIS
20559
20560 =item DESCRIPTION
20561
20562 =item AUTHOR
20563
20564 =back
20565
20566 =head1 AUXILIARY DOCUMENTATION
20567
20568 Here should be listed all the extra programs' documentation, but they
20569 don't all have manual pages yet:
20570
20571 =over 4
20572
20573 =item a2p
20574
20575 =item s2p
20576
20577 =item find2perl
20578
20579 =item h2ph
20580
20581 =item c2ph
20582
20583 =item h2xs
20584
20585 =item xsubpp
20586
20587 =item pod2man
20588
20589 =item wrapsuid
20590
20591 =back
20592
20593 =head1 AUTHOR
20594
20595 Larry Wall <F<larry@wall.org>>, with the help of oodles
20596 of other folks.
20597