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: 2002/03/11
 107 21:32:23 $)
 108
 109 =over 4
 110
 111 =item DESCRIPTION
 112
 113 =over 4
 114
 115 =item perlfaq: Structural overview of the FAQ.
 116
 117 =item L<perlfaq1>: General Questions About Perl
 118
 119 =item L<perlfaq2>: Obtaining and Learning about Perl
 120
 121 =item L<perlfaq3>: Programming Tools
 122
 123 =item L<perlfaq4>: Data Manipulation
 124
 125 =item L<perlfaq5>: Files and Formats
 126
 127 =item L<perlfaq6>: Regular Expressions
 128
 129 =item L<perlfaq7>: General Perl Language Issues
 130
 131 =item L<perlfaq8>: System Interaction
 132
 133 =item L<perlfaq9>: Networking
 134
 135 =back
 136
 137 =item About the perlfaq documents
 138
 139 =over 4
 140
 141 =item Where to get the perlfaq
 142
 143 =item How to contribute to the perlfaq
 144
 145 =item What will happen if you mail your Perl programming problems to the
 146 authors
 147
 148 =back
 149
 150 =item Credits
 151
 152 =item Author and Copyright Information
 153
 154 =over 4
 155
 156 =item Bundled Distributions
 157
 158 =item Disclaimer
 159
 160 =back
 161
 162 =item Changes
 163
 164 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98,
 165 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
 166 Initial Release: 11/March/97
 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 Simple statements
 189
 190 =item Compound statements
 191
 192 =item Loop Control
 193
 194 =item For Loops
 195
 196 =item Foreach Loops
 197
 198 =item Basic BLOCKs and Switch Statements
 199
 200 =item Goto
 201
 202 =item PODs: Embedded Documentation
 203
 204 =item Plain Old Comments (Not!)
 205
 206 =back
 207
 208 =back
 209
 210 =head2 perldata - Perl data types
 211
 212 =over 4
 213
 214 =item DESCRIPTION
 215
 216 =over 4
 217
 218 =item Variable names
 219
 220 =item Context
 221
 222 =item Scalar values
 223
 224 =item Scalar value constructors
 225
 226 =item List value constructors
 227
 228 =item Slices
 229
 230 =item Typeglobs and Filehandles
 231
 232 =back
 233
 234 =item SEE ALSO
 235
 236 =back
 237
 238 =head2 perlop - Perl operators and precedence
 239
 240 =over 4
 241
 242 =item SYNOPSIS
 243
 244 =item DESCRIPTION
 245
 246 =over 4
 247
 248 =item Terms and List Operators (Leftward)
 249
 250 =item The Arrow Operator
 251
 252 =item Auto-increment and Auto-decrement
 253
 254 =item Exponentiation
 255
 256 =item Symbolic Unary Operators
 257
 258 =item Binding Operators
 259
 260 =item Multiplicative Operators
 261
 262 =item Additive Operators
 263
 264 =item Shift Operators
 265
 266 =item Named Unary Operators
 267
 268 =item Relational Operators
 269
 270 =item Equality Operators
 271
 272 =item Bitwise And
 273
 274 =item Bitwise Or and Exclusive Or
 275
 276 =item C-style Logical And
 277
 278 =item C-style Logical Or
 279
 280 =item Range Operators
 281
 282 =item Conditional Operator
 283
 284 =item Assignment Operators
 285
 286 =item Comma Operator
 287
 288 =item List Operators (Rightward)
 289
 290 =item Logical Not
 291
 292 =item Logical And
 293
 294 =item Logical or and Exclusive Or
 295
 296 =item C Operators Missing From Perl
 297
 298 unary &, unary *, (TYPE)
 299
 300 =item Quote and Quote-like Operators
 301
 302 =item Regexp Quote-Like Operators
 303
 304 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 305 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 306 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 307 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 308
 309 =item Gory details of parsing quoted constructs
 310
 311 Finding the end, Removal of backslashes before delimiters, Interpolation,
 312 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 313 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 314 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 315 regular expressions
 316
 317 =item I/O Operators
 318
 319 =item Constant Folding
 320
 321 =item Bitwise String Operators
 322
 323 =item Integer Arithmetic
 324
 325 =item Floating-point Arithmetic
 326
 327 =item Bigger Numbers
 328
 329 =back
 330
 331 =back
 332
 333 =head2 perlsub - Perl subroutines
 334
 335 =over 4
 336
 337 =item SYNOPSIS
 338
 339 =item DESCRIPTION
 340
 341 =over 4
 342
 343 =item Private Variables via my()
 344
 345 =item Persistent Private Variables
 346
 347 =item Temporary Values via local()
 348
 349 =item Lvalue subroutines
 350
 351 Lvalue subroutines are EXPERIMENTAL
 352
 353 =item Passing Symbol Table Entries (typeglobs)
 354
 355 =item When to Still Use local()
 356
 357 =item Pass by Reference
 358
 359 =item Prototypes
 360
 361 =item Constant Functions
 362
 363 =item Overriding Built-in Functions
 364
 365 =item Autoloading
 366
 367 =item Subroutine Attributes
 368
 369 =back
 370
 371 =item SEE ALSO
 372
 373 =back
 374
 375 =head2 perlfunc - Perl builtin functions
 376
 377 =over 4
 378
 379 =item DESCRIPTION
 380
 381 =over 4
 382
 383 =item Perl Functions by Category
 384
 385 Functions for SCALARs or strings, Regular expressions and pattern matching,
 386 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 387 Functions for real %HASHes, Input and output functions, Functions for fixed
 388 length data or records, Functions for filehandles, files, or directories,
 389 Keywords related to the control flow of your perl program, Keywords related
 390 to scoping, Miscellaneous functions, Functions for processes and process
 391 groups, Keywords related to perl modules, Keywords related to classes and
 392 object-orientedness, Low-level socket functions, System V interprocess
 393 communication functions, Fetching user and group info, Fetching network
 394 info, Time-related functions, Functions new in perl5, Functions obsoleted
 395 in perl5
 396
 397 =item Portability
 398
 399 =item Alphabetical Listing of Perl Functions
 400
 401 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 402 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 403 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
 404 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
 405 chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr
 406 NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir
 407 DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt
 408 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR,
 409 defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR,
 410 dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval
 411 BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp,
 412 fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
 413 FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE,
 414 getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority
 415 WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname
 416 NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname
 417 NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE,
 418 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
 419 gethostent, getnetent, getprotoent, getservent, setpwent, setgrent,
 420 sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent
 421 STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent,
 422 endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR,
 423 glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep
 424 EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index
 425 STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join
 426 EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc,
 427 lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen
 428 SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock THING, log EXPR, log,
 429 lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK,
 430 mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv
 431 ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES,
 432 next LABEL, next, no Module VERSION LIST, no Module VERSION, no Module
 433 LIST, no Module, oct EXPR, oct, open FILEHANDLE,EXPR, open
 434 FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
 435 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
 436 EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package
 437 NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
 438 SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
 439 FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
 440 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
 441 quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 442 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 443 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 444 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
 445 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
 446 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
 447 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
 448 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
 449 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 450 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 451 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 452 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 453 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 454 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 455 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 456 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 457 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 458 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
 459 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
 460 study, sub BLOCK, sub NAME, sub NAME BLOCK, substr
 461 EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 462 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 463 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 464 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 465 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 466 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 467 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 468 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 469 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 470 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 471 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
 472 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
 473 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
 474 LIST, write FILEHANDLE, write EXPR, write, y///
 475
 476 =back
 477
 478 =back
 479
 480 =head2 perlreftut - Mark's very short tutorial about references
 481
 482 =over 4
 483
 484 =item DESCRIPTION
 485
 486 =item Who Needs Complicated Data Structures?
 487
 488 =item The Solution
 489
 490 =item Syntax
 491
 492 =over 4
 493
 494 =item Making References
 495
 496 =item Using References
 497
 498 =back
 499
 500 =item An Example
 501
 502 =item Arrow Rule
 503
 504 =item Solution
 505
 506 =item The Rest
 507
 508 =item Summary
 509
 510 =item Credits
 511
 512 =over 4
 513
 514 =item Distribution Conditions
 515
 516 =back
 517
 518 =back
 519
 520 =head2 perldsc - Perl Data Structures Cookbook
 521
 522 =over 4
 523
 524 =item DESCRIPTION
 525
 526 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 527 more elaborate constructs
 528
 529 =item REFERENCES
 530
 531 =item COMMON MISTAKES
 532
 533 =item CAVEAT ON PRECEDENCE
 534
 535 =item WHY YOU SHOULD ALWAYS C<use strict>
 536
 537 =item DEBUGGING
 538
 539 =item CODE EXAMPLES
 540
 541 =item ARRAYS OF ARRAYS
 542
 543 =over 4
 544
 545 =item Declaration of an ARRAY OF ARRAYS
 546
 547 =item Generation of an ARRAY OF ARRAYS
 548
 549 =item Access and Printing of an ARRAY OF ARRAYS
 550
 551 =back
 552
 553 =item HASHES OF ARRAYS
 554
 555 =over 4
 556
 557 =item Declaration of a HASH OF ARRAYS
 558
 559 =item Generation of a HASH OF ARRAYS
 560
 561 =item Access and Printing of a HASH OF ARRAYS
 562
 563 =back
 564
 565 =item ARRAYS OF HASHES
 566
 567 =over 4
 568
 569 =item Declaration of an ARRAY OF HASHES
 570
 571 =item Generation of an ARRAY OF HASHES
 572
 573 =item Access and Printing of an ARRAY OF HASHES
 574
 575 =back
 576
 577 =item HASHES OF HASHES
 578
 579 =over 4
 580
 581 =item Declaration of a HASH OF HASHES
 582
 583 =item Generation of a HASH OF HASHES
 584
 585 =item Access and Printing of a HASH OF HASHES
 586
 587 =back
 588
 589 =item MORE ELABORATE RECORDS
 590
 591 =over 4
 592
 593 =item Declaration of MORE ELABORATE RECORDS
 594
 595 =item Declaration of a HASH OF COMPLEX RECORDS
 596
 597 =item Generation of a HASH OF COMPLEX RECORDS
 598
 599 =back
 600
 601 =item Database Ties
 602
 603 =item SEE ALSO
 604
 605 =item AUTHOR
 606
 607 =back
 608
 609 =head2 perlrequick - Perl regular expressions quick start
 610
 611 =over 4
 612
 613 =item DESCRIPTION
 614
 615 =item The Guide
 616
 617 =over 4
 618
 619 =item Simple word matching
 620
 621 =item Using character classes
 622
 623 =item Matching this or that
 624
 625 =item Grouping things and hierarchical matching
 626
 627 =item Extracting matches
 628
 629 =item Matching repetitions
 630
 631 =item More matching
 632
 633 =item Search and replace
 634
 635 =item The split operator
 636
 637 =back
 638
 639 =item BUGS
 640
 641 =item SEE ALSO
 642
 643 =item AUTHOR AND COPYRIGHT
 644
 645 =over 4
 646
 647 =item Acknowledgments
 648
 649 =back
 650
 651 =back
 652
 653 =head2 perlpod - the Plain Old Documentation format
 654
 655 =over 4
 656
 657 =item DESCRIPTION
 658
 659 =over 4
 660
 661 =item Ordinary Paragraph
 662
 663 =item Verbatim Paragraph
 664
 665 =item Command Paragraph
 666
 667 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 668 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 669 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 670 I<formatname>>, C<=for I<formatname> I<text...>>
 671
 672 =item Formatting Codes
 673
 674 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 675 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 676 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 677 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 678 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 679 (zero-effect) formatting code
 680
 681 =item The Intent
 682
 683 =item Embedding Pods in Perl Modules
 684
 685 =item Hints for Writing Pod
 686
 687 =back
 688
 689 =item SEE ALSO
 690
 691 =item AUTHOR
 692
 693 =back
 694
 695 =head2 perlpodspec - Plain Old Documentation: format specification and
 696 notes
 697
 698 =over 4
 699
 700 =item DESCRIPTION
 701
 702 =item Pod Definitions
 703
 704 =item Pod Commands
 705
 706 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 707 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 708
 709 =item Pod Formatting Codes
 710
 711 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 712 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 713 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 714 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 715 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 716 contains non-breaking spaces
 717
 718 =item Notes on Implementing Pod Processors
 719
 720 =item About LE<lt>...E<gt> Codes
 721
 722 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 723
 724 =item About =over...=back Regions
 725
 726 =item About Data Paragraphs and "=begin/=end" Regions
 727
 728 =item SEE ALSO
 729
 730 =item AUTHOR
 731
 732 =back
 733
 734 =head2 perlstyle - Perl style guide
 735
 736 =over 4
 737
 738 =item DESCRIPTION
 739
 740 =back
 741
 742 =head2 perltrap - Perl traps for the unwary
 743
 744 =over 4
 745
 746 =item DESCRIPTION
 747
 748 =over 4
 749
 750 =item Awk Traps
 751
 752 =item C Traps
 753
 754 =item Sed Traps
 755
 756 =item Shell Traps
 757
 758 =item Perl Traps
 759
 760 =item Perl4 to Perl5 Traps
 761
 762 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 763 Traps, General data type traps, Context Traps - scalar, list contexts,
 764 Precedence Traps, General Regular Expression Traps using s///, etc,
 765 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 766
 767 =item Discontinuance, Deprecation, and BugFix traps
 768
 769 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 770 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 771 Discontinuance, Deprecation, Discontinuance, Discontinuance
 772
 773 =item Parsing Traps
 774
 775 Parsing, Parsing, Parsing, Parsing, Parsing
 776
 777 =item Numerical Traps
 778
 779 Numerical, Numerical, Numerical, Bitwise string ops
 780
 781 =item General data type traps
 782
 783 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 784 (Constants), (Scalars), (Variable Suicide)
 785
 786 =item Context Traps - scalar, list contexts
 787
 788 (list context), (scalar context), (scalar context), (list, builtin)
 789
 790 =item Precedence Traps
 791
 792 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 793 Precedence
 794
 795 =item General Regular Expression Traps using s///, etc.
 796
 797 Regular Expression, Regular Expression, Regular Expression, Regular
 798 Expression, Regular Expression, Regular Expression, Regular Expression,
 799 Regular Expression
 800
 801 =item Subroutine, Signal, Sorting Traps
 802
 803 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 804
 805 =item OS Traps
 806
 807 (SysV), (SysV)
 808
 809 =item Interpolation Traps
 810
 811 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 812 Interpolation, Interpolation, Interpolation, Interpolation
 813
 814 =item DBM Traps
 815
 816 DBM, DBM
 817
 818 =item Unclassified Traps
 819
 820 C<require>/C<do> trap using returned value, C<split> on empty string with
 821 LIMIT specified
 822
 823 =back
 824
 825 =back
 826
 827 =head2 perlrun - how to execute the Perl interpreter
 828
 829 =over 4
 830
 831 =item SYNOPSIS
 832
 833 =item DESCRIPTION
 834
 835 =over 4
 836
 837 =item #! and quoting on non-Unix systems
 838
 839 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 840
 841 =item Location of Perl
 842
 843 =item Command Switches
 844
 845 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 846 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 847 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 848 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 849 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 850 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 851 B<-X>, B<-x> I<directory>
 852
 853 =back
 854
 855 =item ENVIRONMENT
 856
 857 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 858 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 859 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 860 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
 861 SYS$LOGIN (specific to the VMS port)
 862
 863 =back
 864
 865 =head2 perldiag - various Perl diagnostics
 866
 867 =over 4
 868
 869 =item DESCRIPTION
 870
 871 =back
 872
 873 =head2 perllexwarn - Perl Lexical Warnings
 874
 875 =over 4
 876
 877 =item DESCRIPTION
 878
 879 =over 4
 880
 881 =item Default Warnings and Optional Warnings
 882
 883 =item What's wrong with B<-w> and C<$^W>
 884
 885 =item Controlling Warnings from the Command Line
 886
 887 B<-w>, B<-W>, B<-X>
 888
 889 =item Backward Compatibility
 890
 891 =item Category Hierarchy
 892
 893 =item Fatal Warnings
 894
 895 =item Reporting Warnings from a Module
 896
 897 =back
 898
 899 =item TODO
 900
 901 =item SEE ALSO
 902
 903 =item AUTHOR
 904
 905 =back
 906
 907 =head2 perldebtut - Perl debugging tutorial
 908
 909 =over 4
 910
 911 =item DESCRIPTION
 912
 913 =item use strict
 914
 915 =item Looking at data and -w and v
 916
 917 =item help
 918
 919 =item Stepping through code
 920
 921 =item Placeholder for a, w, t, T
 922
 923 =item REGULAR EXPRESSIONS
 924
 925 =item OUTPUT TIPS
 926
 927 =item CGI
 928
 929 =item GUIs
 930
 931 =item SUMMARY
 932
 933 =item SEE ALSO
 934
 935 =item AUTHOR
 936
 937 =item CONTRIBUTORS
 938
 939 =back
 940
 941 =head2 perldebug - Perl debugging
 942
 943 =over 4
 944
 945 =item DESCRIPTION
 946
 947 =item The Perl Debugger
 948
 949 =over 4
 950
 951 =item Debugger Commands
 952
 953 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 954 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 955 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 956 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 957 subname [condition], b postpone subname [condition], b load filename, b
 958 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 959 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 960 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
 961 command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or
 962 ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
 963
 964 =item Configurable Options
 965
 966 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 967 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 968 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 969 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
 970 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
 971 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
 972 C<NonStop>
 973
 974 =item Debugger input/output
 975
 976 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 977 listing
 978
 979 =item Debugging compile-time statements
 980
 981 =item Debugger Customization
 982
 983 =item Readline Support
 984
 985 =item Editor Support for Debugging
 986
 987 =item The Perl Profiler
 988
 989 =back
 990
 991 =item Debugging regular expressions
 992
 993 =item Debugging memory usage
 994
 995 =item SEE ALSO
 996
 997 =item BUGS
 998
 999 =back
1000
1001 =head2 perlvar - Perl predefined variables
1002
1003 =over 4
1004
1005 =item DESCRIPTION
1006
1007 =over 4
1008
1009 =item Predefined Names
1010
1011 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1012 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1013 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1014 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1015 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1016 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1017 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1018 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1019 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1020 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1021 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1022 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1023 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1024 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1025 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1026 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1027 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1028 IO::Handle->format_line_break_characters EXPR,
1029 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1030 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1031 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1032 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1033 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1034 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1035 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1036 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1037 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1038 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1039 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1040 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1041
1042 =item Error Indicators
1043
1044 =item Technical Note on the Syntax of Variable Names
1045
1046 =back
1047
1048 =item BUGS
1049
1050 =back
1051
1052 =head2 perllol - Manipulating Arrays of Arrays in Perl
1053
1054 =over 4
1055
1056 =item DESCRIPTION
1057
1058 =over 4
1059
1060 =item Declaration and Access of Arrays of Arrays
1061
1062 =item Growing Your Own
1063
1064 =item Access and Printing
1065
1066 =item Slices
1067
1068 =back
1069
1070 =item SEE ALSO
1071
1072 =item AUTHOR
1073
1074 =back
1075
1076 =head2 perlopentut - tutorial on opening things in Perl
1077
1078 =over 4
1079
1080 =item DESCRIPTION
1081
1082 =item Open E<agrave> la shell
1083
1084 =over 4
1085
1086 =item Simple Opens
1087
1088 =item Pipe Opens
1089
1090 =item The Minus File
1091
1092 =item Mixing Reads and Writes
1093
1094 =item Filters
1095
1096 =back
1097
1098 =item Open E<agrave> la C
1099
1100 =over 4
1101
1102 =item Permissions E<agrave> la mode
1103
1104 =back
1105
1106 =item Obscure Open Tricks
1107
1108 =over 4
1109
1110 =item Re-Opening Files (dups)
1111
1112 =item Dispelling the Dweomer
1113
1114 =item Paths as Opens
1115
1116 =item Single Argument Open
1117
1118 =item Playing with STDIN and STDOUT
1119
1120 =back
1121
1122 =item Other I/O Issues
1123
1124 =over 4
1125
1126 =item Opening Non-File Files
1127
1128 =item Binary Files
1129
1130 =item File Locking
1131
1132 =back
1133
1134 =item SEE ALSO
1135
1136 =item AUTHOR and COPYRIGHT
1137
1138 =item HISTORY
1139
1140 =back
1141
1142 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1143
1144 =over 4
1145
1146 =item DESCRIPTION
1147
1148 =item The Basic Principle
1149
1150 =item Packing Text
1151
1152 =item Packing Numbers
1153
1154 =over 4
1155
1156 =item Integers
1157
1158 =item Unpacking a Stack Frame
1159
1160 =item How to Eat an Egg on a Net
1161
1162 =item Floating point Numbers
1163
1164 =back
1165
1166 =item Exotic Templates
1167
1168 =over 4
1169
1170 =item Bit Strings
1171
1172 =item Uuencoding
1173
1174 =item Doing Sums
1175
1176 =item  Unicode
1177
1178 =item Another Portable Binary Encoding
1179
1180 =back
1181
1182 =item Lengths and Widths
1183
1184 =over 4
1185
1186 =item String Lengths
1187
1188 =item Dynamic Templates
1189
1190 =back
1191
1192 =item Packing and Unpacking C Structures
1193
1194 =over 4
1195
1196 =item The Alignment Pit
1197
1198 =item Alignment, Take 2
1199
1200 =item Alignment, Take 3
1201
1202 =item Pointers for How to Use Them
1203
1204 =back
1205
1206 =item Pack Recipes
1207
1208 =item Funnies Section
1209
1210 =item Authors
1211
1212 =back
1213
1214 =head2 perlretut - Perl regular expressions tutorial
1215
1216 =over 4
1217
1218 =item DESCRIPTION
1219
1220 =item Part 1: The basics
1221
1222 =over 4
1223
1224 =item Simple word matching
1225
1226 =item Using character classes
1227
1228 =item Matching this or that
1229
1230 =item Grouping things and hierarchical matching
1231
1232 =item Extracting matches
1233
1234 =item Matching repetitions
1235
1236 =item Building a regexp
1237
1238 =item Using regular expressions in Perl
1239
1240 =back
1241
1242 =item Part 2: Power tools
1243
1244 =over 4
1245
1246 =item More on characters, strings, and character classes
1247
1248 =item Compiling and saving regular expressions
1249
1250 =item Embedding comments and modifiers in a regular expression
1251
1252 =item Non-capturing groupings
1253
1254 =item Looking ahead and looking behind
1255
1256 =item Using independent subexpressions to prevent backtracking
1257
1258 =item Conditional expressions
1259
1260 =item A bit of magic: executing Perl code in a regular expression
1261
1262 =item Pragmas and debugging
1263
1264 =back
1265
1266 =item BUGS
1267
1268 =item SEE ALSO
1269
1270 =item AUTHOR AND COPYRIGHT
1271
1272 =over 4
1273
1274 =item Acknowledgments
1275
1276 =back
1277
1278 =back
1279
1280 =head2 perlre - Perl regular expressions
1281
1282 =over 4
1283
1284 =item DESCRIPTION
1285
1286 i, m, s, x
1287
1288 =over 4
1289
1290 =item Regular Expressions
1291
1292 [1], [2], [3], cntrl, graph, print, punct, xdigit
1293
1294 =item Extended Patterns
1295
1296 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1297 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1298 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1299 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1300
1301 =item Backtracking
1302
1303 =item Version 8 Regular Expressions
1304
1305 =item Warning on \1 vs $1
1306
1307 =item Repeated patterns matching zero-length substring
1308
1309 =item Combining pieces together
1310
1311 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1312 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1313 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1314 C<(?(condition)yes-pattern|no-pattern)>
1315
1316 =item Creating custom RE engines
1317
1318 =back
1319
1320 =item BUGS
1321
1322 =item SEE ALSO
1323
1324 =back
1325
1326 =head2 perlref - Perl references and nested data structures
1327
1328 =over 4
1329
1330 =item NOTE
1331
1332 =item DESCRIPTION
1333
1334 =over 4
1335
1336 =item Making References
1337
1338 =item Using References
1339
1340 =item Symbolic references
1341
1342 =item Not-so-symbolic references
1343
1344 =item Pseudo-hashes: Using an array as a hash
1345
1346 =item Function Templates
1347
1348 =back
1349
1350 =item WARNING
1351
1352 =item SEE ALSO
1353
1354 =back
1355
1356 =head2 perlform - Perl formats
1357
1358 =over 4
1359
1360 =item DESCRIPTION
1361
1362 =over 4
1363
1364 =item Format Variables
1365
1366 =back
1367
1368 =item NOTES
1369
1370 =over 4
1371
1372 =item Footers
1373
1374 =item Accessing Formatting Internals
1375
1376 =back
1377
1378 =item WARNINGS
1379
1380 =back
1381
1382 =head2 perlboot - Beginner's Object-Oriented Tutorial
1383
1384 =over 4
1385
1386 =item DESCRIPTION
1387
1388 =over 4
1389
1390 =item If we could talk to the animals...
1391
1392 =item Introducing the method invocation arrow
1393
1394 =item Invoking a barnyard
1395
1396 =item The extra parameter of method invocation
1397
1398 =item Calling a second method to simplify things
1399
1400 =item Inheriting the windpipes
1401
1402 =item A few notes about @ISA
1403
1404 =item Overriding the methods
1405
1406 =item Starting the search from a different place
1407
1408 =item The SUPER way of doing things
1409
1410 =item Where we're at so far...
1411
1412 =item A horse is a horse, of course of course -- or is it?
1413
1414 =item Invoking an instance method
1415
1416 =item Accessing the instance data
1417
1418 =item How to build a horse
1419
1420 =item Inheriting the constructor
1421
1422 =item Making a method work with either classes or instances
1423
1424 =item Adding parameters to a method
1425
1426 =item More interesting instances
1427
1428 =item A horse of a different color
1429
1430 =item Summary
1431
1432 =back
1433
1434 =item SEE ALSO
1435
1436 =item COPYRIGHT
1437
1438 =back
1439
1440 =head2 perltoot - Tom's object-oriented tutorial for perl
1441
1442 =over 4
1443
1444 =item DESCRIPTION
1445
1446 =item Creating a Class
1447
1448 =over 4
1449
1450 =item Object Representation
1451
1452 =item Class Interface
1453
1454 =item Constructors and Instance Methods
1455
1456 =item Planning for the Future: Better Constructors
1457
1458 =item Destructors
1459
1460 =item Other Object Methods
1461
1462 =back
1463
1464 =item Class Data
1465
1466 =over 4
1467
1468 =item Accessing Class Data
1469
1470 =item Debugging Methods
1471
1472 =item Class Destructors
1473
1474 =item Documenting the Interface
1475
1476 =back
1477
1478 =item Aggregation
1479
1480 =item Inheritance
1481
1482 =over 4
1483
1484 =item Overridden Methods
1485
1486 =item Multiple Inheritance
1487
1488 =item UNIVERSAL: The Root of All Objects
1489
1490 =back
1491
1492 =item Alternate Object Representations
1493
1494 =over 4
1495
1496 =item Arrays as Objects
1497
1498 =item Closures as Objects
1499
1500 =back
1501
1502 =item AUTOLOAD: Proxy Methods
1503
1504 =over 4
1505
1506 =item Autoloaded Data Methods
1507
1508 =item Inherited Autoloaded Data Methods
1509
1510 =back
1511
1512 =item Metaclassical Tools
1513
1514 =over 4
1515
1516 =item Class::Struct
1517
1518 =item Data Members as Variables
1519
1520 =back
1521
1522 =item NOTES
1523
1524 =over 4
1525
1526 =item Object Terminology
1527
1528 =back
1529
1530 =item SEE ALSO
1531
1532 =item AUTHOR AND COPYRIGHT
1533
1534 =item COPYRIGHT
1535
1536 =over 4
1537
1538 =item Acknowledgments
1539
1540 =back
1541
1542 =back
1543
1544 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1545
1546 =over 4
1547
1548 =item DESCRIPTION
1549
1550 =item Class Data in a Can
1551
1552 =item Class Data as Package Variables
1553
1554 =over 4
1555
1556 =item Putting All Your Eggs in One Basket
1557
1558 =item Inheritance Concerns
1559
1560 =item The Eponymous Meta-Object
1561
1562 =item Indirect References to Class Data
1563
1564 =item Monadic Classes
1565
1566 =item Translucent Attributes
1567
1568 =back
1569
1570 =item Class Data as Lexical Variables
1571
1572 =over 4
1573
1574 =item Privacy and Responsibility
1575
1576 =item File-Scoped Lexicals
1577
1578 =item More Inheritance Concerns
1579
1580 =item Locking the Door and Throwing Away the Key
1581
1582 =item Translucency Revisited
1583
1584 =back
1585
1586 =item NOTES
1587
1588 =item SEE ALSO
1589
1590 =item AUTHOR AND COPYRIGHT
1591
1592 =item ACKNOWLEDGEMENTS
1593
1594 =item HISTORY
1595
1596 =back
1597
1598 =head2 perlobj - Perl objects
1599
1600 =over 4
1601
1602 =item DESCRIPTION
1603
1604 =over 4
1605
1606 =item An Object is Simply a Reference
1607
1608 =item A Class is Simply a Package
1609
1610 =item A Method is Simply a Subroutine
1611
1612 =item Method Invocation
1613
1614 =item Indirect Object Syntax
1615
1616 =item Default UNIVERSAL methods
1617
1618 isa(CLASS), can(METHOD), VERSION( [NEED] )
1619
1620 =item Destructors
1621
1622 =item Summary
1623
1624 =item Two-Phased Garbage Collection
1625
1626 =back
1627
1628 =item SEE ALSO
1629
1630 =back
1631
1632 =head2 perlbot - Bag'o Object Tricks (the BOT)
1633
1634 =over 4
1635
1636 =item DESCRIPTION
1637
1638 =item OO SCALING TIPS
1639
1640 =item INSTANCE VARIABLES
1641
1642 =item SCALAR INSTANCE VARIABLES
1643
1644 =item INSTANCE VARIABLE INHERITANCE
1645
1646 =item OBJECT RELATIONSHIPS
1647
1648 =item OVERRIDING SUPERCLASS METHODS
1649
1650 =item USING RELATIONSHIP WITH SDBM
1651
1652 =item THINKING OF CODE REUSE
1653
1654 =item CLASS CONTEXT AND THE OBJECT
1655
1656 =item INHERITING A CONSTRUCTOR
1657
1658 =item DELEGATION
1659
1660 =back
1661
1662 =head2 perltie - how to hide an object class in a simple variable
1663
1664 =over 4
1665
1666 =item SYNOPSIS
1667
1668 =item DESCRIPTION
1669
1670 =over 4
1671
1672 =item Tying Scalars
1673
1674 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1675 DESTROY this
1676
1677 =item Tying Arrays
1678
1679 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1680 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1681 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1682 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1683 this
1684
1685 =item Tying Hashes
1686
1687 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1688 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1689 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1690
1691 =item Tying FileHandles
1692
1693 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1694 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1695 DESTROY this
1696
1697 =item UNTIE this
1698
1699 =item The C<untie> Gotcha
1700
1701 =back
1702
1703 =item SEE ALSO
1704
1705 =item BUGS
1706
1707 =item AUTHOR
1708
1709 =back
1710
1711 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1712 safe subprocesses, sockets, and semaphores)
1713
1714 =over 4
1715
1716 =item DESCRIPTION
1717
1718 =item Signals
1719
1720 =over 4
1721
1722 =item Handling the SIGHUP Signal in Daemons
1723
1724 =back
1725
1726 =item Named Pipes
1727
1728 =over 4
1729
1730 =item Deferred Signals
1731
1732 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1733 triggered by operating system state
1734
1735 =back
1736
1737 =item Using open() for IPC
1738
1739 =over 4
1740
1741 =item Filehandles
1742
1743 =item Background Processes
1744
1745 =item Complete Dissociation of Child from Parent
1746
1747 =item Safe Pipe Opens
1748
1749 =item Bidirectional Communication with Another Process
1750
1751 =item Bidirectional Communication with Yourself
1752
1753 =back
1754
1755 =item Sockets: Client/Server Communication
1756
1757 =over 4
1758
1759 =item Internet Line Terminators
1760
1761 =item Internet TCP Clients and Servers
1762
1763 =item Unix-Domain TCP Clients and Servers
1764
1765 =back
1766
1767 =item TCP Clients with IO::Socket
1768
1769 =over 4
1770
1771 =item A Simple Client
1772
1773 C<Proto>, C<PeerAddr>, C<PeerPort>
1774
1775 =item A Webget Client
1776
1777 =item Interactive Client with IO::Socket
1778
1779 =back
1780
1781 =item TCP Servers with IO::Socket
1782
1783 Proto, LocalPort, Listen, Reuse
1784
1785 =item UDP: Message Passing
1786
1787 =item SysV IPC
1788
1789 =item NOTES
1790
1791 =item BUGS
1792
1793 =item AUTHOR
1794
1795 =item SEE ALSO
1796
1797 =back
1798
1799 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
1800
1801 =over 4
1802
1803 =item SYNOPSIS
1804
1805 =item DESCRIPTION
1806
1807 =over 4
1808
1809 =item Behavior of other Perl features in forked pseudo-processes
1810
1811 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1812 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1813 files, directories and network sockets
1814
1815 =item Resource limits
1816
1817 =item Killing the parent process
1818
1819 =item Lifetime of the parent process and pseudo-processes
1820
1821 =item CAVEATS AND LIMITATIONS
1822
1823 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1824 Global state maintained by XSUBs, Interpreter embedded in larger
1825 application, Thread-safety of extensions
1826
1827 =back
1828
1829 =item BUGS
1830
1831 =item AUTHOR
1832
1833 =item SEE ALSO
1834
1835 =back
1836
1837 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1838
1839 =over 4
1840
1841 =item SYNOPSIS
1842
1843 =item DESCRIPTION
1844
1845 =item Storing numbers
1846
1847 =item Numeric operators and numeric conversions
1848
1849 =item Flavors of Perl numeric operations
1850
1851 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1852 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1853 integer>, Operators which expect an integer, Operators which expect a
1854 string
1855
1856 =item AUTHOR
1857
1858 =item SEE ALSO
1859
1860 =back
1861
1862 =head2 perlthrtut - tutorial on threads in Perl
1863
1864 =over 4
1865
1866 =item DESCRIPTION
1867
1868 =item Status
1869
1870 =item What Is A Thread Anyway?
1871
1872 =item Threaded Program Models
1873
1874 =over 4
1875
1876 =item Boss/Worker
1877
1878 =item Work Crew
1879
1880 =item Pipeline
1881
1882 =back
1883
1884 =item Native threads
1885
1886 =item What kind of threads are Perl threads?
1887
1888 =item Threadsafe Modules
1889
1890 =item Thread Basics
1891
1892 =over 4
1893
1894 =item Basic Thread Support
1895
1896 =item Creating Threads
1897
1898 =item Giving up control
1899
1900 =item Waiting For A Thread To Exit
1901
1902 =item Ignoring A Thread
1903
1904 =back
1905
1906 =item Threads And Data
1907
1908 =over 4
1909
1910 =item Shared And Unshared Data
1911
1912 =item Thread Pitfalls: Races
1913
1914 =back
1915
1916 =item Synchronization and control
1917
1918 =over 4
1919
1920 =item Controlling access: lock()
1921
1922 =item A Thread Pitfall: Deadlocks
1923
1924 =item Queues: Passing Data Around
1925
1926 =item Semaphores: Synchronizing Data Access
1927
1928 =item Basic semaphores
1929
1930 =item Advanced Semaphores
1931
1932 =item cond_wait() and cond_signal()
1933
1934 =back
1935
1936 =item General Thread Utility Routines
1937
1938 =over 4
1939
1940 =item What Thread Am I In?
1941
1942 =item Thread IDs
1943
1944 =item Are These Threads The Same?
1945
1946 =item What Threads Are Running?
1947
1948 =back
1949
1950 =item A Complete Example
1951
1952 =item Performance considerations
1953
1954 =item Threadsafety of System Libraries
1955
1956 =item Conclusion
1957
1958 =item Bibliography
1959
1960 =over 4
1961
1962 =item Introductory Texts
1963
1964 =item OS-Related References
1965
1966 =item Other References
1967
1968 =back
1969
1970 =item Acknowledgements
1971
1972 =item AUTHOR
1973
1974 =item Copyrights
1975
1976 =back
1977
1978 =head2 perlothrtut - old tutorial on threads in Perl
1979
1980 =over 4
1981
1982 =item DESCRIPTION
1983
1984 =item What Is A Thread Anyway?
1985
1986 =item Threaded Program Models
1987
1988 =over 4
1989
1990 =item Boss/Worker
1991
1992 =item Work Crew
1993
1994 =item Pipeline
1995
1996 =back
1997
1998 =item Native threads
1999
2000 =item What kind of threads are perl threads?
2001
2002 =item Threadsafe Modules
2003
2004 =item Thread Basics
2005
2006 =over 4
2007
2008 =item Basic Thread Support
2009
2010 =item Creating Threads
2011
2012 =item Giving up control
2013
2014 =item Waiting For A Thread To Exit
2015
2016 =item Errors In Threads
2017
2018 =item Ignoring A Thread
2019
2020 =back
2021
2022 =item Threads And Data
2023
2024 =over 4
2025
2026 =item Shared And Unshared Data
2027
2028 =item Thread Pitfall: Races
2029
2030 =item Controlling access: lock()
2031
2032 =item Thread Pitfall: Deadlocks
2033
2034 =item Queues: Passing Data Around
2035
2036 =back
2037
2038 =item Threads And Code
2039
2040 =over 4
2041
2042 =item Semaphores: Synchronizing Data Access
2043
2044 Basic semaphores, Advanced Semaphores
2045
2046 =item Attributes: Restricting Access To Subroutines
2047
2048 =item Subroutine Locks
2049
2050 =item Methods
2051
2052 =item Locking A Subroutine
2053
2054 =back
2055
2056 =item General Thread Utility Routines
2057
2058 =over 4
2059
2060 =item What Thread Am I In?
2061
2062 =item Thread IDs
2063
2064 =item Are These Threads The Same?
2065
2066 =item What Threads Are Running?
2067
2068 =back
2069
2070 =item A Complete Example
2071
2072 =item Conclusion
2073
2074 =item Bibliography
2075
2076 =over 4
2077
2078 =item Introductory Texts
2079
2080 =item OS-Related References
2081
2082 =item Other References
2083
2084 =back
2085
2086 =item Acknowledgements
2087
2088 =item AUTHOR
2089
2090 =item Copyrights
2091
2092 =back
2093
2094 =head2 perlport - Writing portable Perl
2095
2096 =over 4
2097
2098 =item DESCRIPTION
2099
2100 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2101 portable
2102
2103 =item ISSUES
2104
2105 =over 4
2106
2107 =item Newlines
2108
2109 =item Numbers endianness and Width
2110
2111 =item Files and Filesystems
2112
2113 =item System Interaction
2114
2115 =item Command names versus file pathnames
2116
2117 =item Interprocess Communication (IPC)
2118
2119 =item External Subroutines (XS)
2120
2121 =item Standard Modules
2122
2123 =item Time and Date
2124
2125 =item Character sets and character encoding
2126
2127 =item Internationalisation
2128
2129 =item System Resources
2130
2131 =item Security
2132
2133 =item Style
2134
2135 =back
2136
2137 =item CPAN Testers
2138
2139 Mailing list: cpan-testers@perl.org, Testing results:
2140 http://testers.cpan.org/
2141
2142 =item PLATFORMS
2143
2144 =over 4
2145
2146 =item Unix
2147
2148 =item DOS and Derivatives
2149
2150 =item S<Mac OS>
2151
2152 =item VMS
2153
2154 =item VOS
2155
2156 =item EBCDIC Platforms
2157
2158 =item Acorn RISC OS
2159
2160 =item Other perls
2161
2162 =back
2163
2164 =item FUNCTION IMPLEMENTATIONS
2165
2166 =over 4
2167
2168 =item Alphabetical Listing of Perl Functions
2169
2170 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2171 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2172 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2173 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2174 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2175 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2176 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2177 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2178 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2179 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2180 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2181 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2182 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2183 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2184 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2185 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2186 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2187 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2188 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2189 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2190 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2191 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2192 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2193 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2194 wait, waitpid PID,FLAGS
2195
2196 =back
2197
2198 =item CHANGES
2199
2200 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2201 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2202 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2203 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2204 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2205 v1.30, 03 August 1998, v1.23, 10 July 1998
2206
2207 =item Supported Platforms
2208
2209 =item SEE ALSO
2210
2211 =item AUTHORS / CONTRIBUTORS
2212
2213 =back
2214
2215 =head2 perllocale - Perl locale handling (internationalization and
2216 localization)
2217
2218 =over 4
2219
2220 =item DESCRIPTION
2221
2222 =item PREPARING TO USE LOCALES
2223
2224 =item USING LOCALES
2225
2226 =over 4
2227
2228 =item The use locale pragma
2229
2230 =item The setlocale function
2231
2232 =item Finding locales
2233
2234 =item LOCALE PROBLEMS
2235
2236 =item Temporarily fixing locale problems
2237
2238 =item Permanently fixing locale problems
2239
2240 =item Permanently fixing your system's locale configuration
2241
2242 =item Fixing system locale configuration
2243
2244 =item The localeconv function
2245
2246 =item I18N::Langinfo
2247
2248 =back
2249
2250 =item LOCALE CATEGORIES
2251
2252 =over 4
2253
2254 =item Category LC_COLLATE: Collation
2255
2256 =item Category LC_CTYPE: Character Types
2257
2258 =item Category LC_NUMERIC: Numeric Formatting
2259
2260 =item Category LC_MONETARY: Formatting of monetary amounts
2261
2262 =item LC_TIME
2263
2264 =item Other categories
2265
2266 =back
2267
2268 =item SECURITY
2269
2270 =item ENVIRONMENT
2271
2272 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2273 LC_NUMERIC, LC_TIME, LANG
2274
2275 =item NOTES
2276
2277 =over 4
2278
2279 =item Backward compatibility
2280
2281 =item I18N:Collate obsolete
2282
2283 =item Sort speed and memory use impacts
2284
2285 =item write() and LC_NUMERIC
2286
2287 =item Freely available locale definitions
2288
2289 =item I18n and l10n
2290
2291 =item An imperfect standard
2292
2293 =back
2294
2295 =item Unicode and UTF-8
2296
2297 =item BUGS
2298
2299 =over 4
2300
2301 =item Broken systems
2302
2303 =back
2304
2305 =item SEE ALSO
2306
2307 =item HISTORY
2308
2309 =back
2310
2311 =head2 perluniintro - Perl Unicode introduction
2312
2313 =over 4
2314
2315 =item DESCRIPTION
2316
2317 =over 4
2318
2319 =item Unicode
2320
2321 =item Perl's Unicode Support
2322
2323 =item Perl's Unicode Model
2324
2325 =item Unicode and EBCDIC
2326
2327 =item Creating Unicode
2328
2329 =item Handling Unicode
2330
2331 =item Legacy Encodings
2332
2333 =item Unicode I/O
2334
2335 =item Displaying Unicode As Text
2336
2337 =item Special Cases
2338
2339 =item Advanced Topics
2340
2341 =item Miscellaneous
2342
2343 =item Questions With Answers
2344
2345 =item Hexadecimal Notation
2346
2347 =item Further Resources
2348
2349 =back
2350
2351 =item UNICODE IN OLDER PERLS
2352
2353 =item SEE ALSO
2354
2355 =item ACKNOWLEDGMENTS
2356
2357 =item AUTHOR, COPYRIGHT, AND LICENSE
2358
2359 =back
2360
2361 =head2 perlunicode - Unicode support in Perl
2362
2363 =over 4
2364
2365 =item DESCRIPTION
2366
2367 =over 4
2368
2369 =item Important Caveats
2370
2371 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2372 to enable UTF-8/UTF-EBCDIC in scripts
2373
2374 =item Byte and Character Semantics
2375
2376 =item Effects of Character Semantics
2377
2378 =item Scripts
2379
2380 =item Blocks
2381
2382 =item User-Defined Character Properties
2383
2384 =item Character Encodings for Input and Output
2385
2386 =item Unicode Regular Expression Support Level
2387
2388 =item Unicode Encodings
2389
2390 =item Security Implications of Unicode
2391
2392 =item Unicode in Perl on EBCDIC
2393
2394 =item Locales
2395
2396 =item Using Unicode in XS
2397
2398 =back
2399
2400 =item BUGS
2401
2402 =over 4
2403
2404 =item Interaction with Locales
2405
2406 =item Interaction with Extensions
2407
2408 =item Speed
2409
2410 =back
2411
2412 =item SEE ALSO
2413
2414 =back
2415
2416 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2417
2418 =over 4
2419
2420 =item DESCRIPTION
2421
2422 =item COMMON CHARACTER CODE SETS
2423
2424 =over 4
2425
2426 =item ASCII
2427
2428 =item ISO 8859
2429
2430 =item Latin 1 (ISO 8859-1)
2431
2432 =item EBCDIC
2433
2434 =item 13 variant characters
2435
2436 =item 0037
2437
2438 =item 1047
2439
2440 =item POSIX-BC
2441
2442 =item Unicode code points versus EBCDIC code points
2443
2444 =item Remaining Perl Unicode problems in EBCDIC
2445
2446 =item Unicode and UTF
2447
2448 =item Using Encode
2449
2450 =back
2451
2452 =item SINGLE OCTET TABLES
2453
2454 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2455
2456 =item IDENTIFYING CHARACTER CODE SETS
2457
2458 =item CONVERSIONS
2459
2460 =over 4
2461
2462 =item tr///
2463
2464 =item iconv
2465
2466 =item C RTL
2467
2468 =back
2469
2470 =item OPERATOR DIFFERENCES
2471
2472 =item FUNCTION DIFFERENCES
2473
2474 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2475
2476 =item REGULAR EXPRESSION DIFFERENCES
2477
2478 =item SOCKETS
2479
2480 =item SORTING
2481
2482 =over 4
2483
2484 =item Ignore ASCII vs. EBCDIC sort differences.
2485
2486 =item MONO CASE then sort data.
2487
2488 =item Convert, sort data, then re convert.
2489
2490 =item Perform sorting on one type of machine only.
2491
2492 =back
2493
2494 =item TRANSFORMATION FORMATS
2495
2496 =over 4
2497
2498 =item URL decoding and encoding
2499
2500 =item uu encoding and decoding
2501
2502 =item Quoted-Printable encoding and decoding
2503
2504 =item Caesarian ciphers
2505
2506 =back
2507
2508 =item Hashing order and checksums
2509
2510 =item I18N AND L10N
2511
2512 =item MULTI OCTET CHARACTER SETS
2513
2514 =item OS ISSUES
2515
2516 =over 4
2517
2518 =item OS/400
2519
2520 IFS access
2521
2522 =item OS/390, z/OS
2523
2524 chcp, dataset access, OS/390, z/OS iconv, locales
2525
2526 =item VM/ESA?
2527
2528 =item POSIX-BC?
2529
2530 =back
2531
2532 =item BUGS
2533
2534 =item SEE ALSO
2535
2536 =item REFERENCES
2537
2538 =item HISTORY
2539
2540 =item AUTHOR
2541
2542 =back
2543
2544 =head2 perlsec - Perl security
2545
2546 =over 4
2547
2548 =item DESCRIPTION
2549
2550 =over 4
2551
2552 =item Laundering and Detecting Tainted Data
2553
2554 =item Switches On the "#!" Line
2555
2556 =item Cleaning Up Your Path
2557
2558 =item Security Bugs
2559
2560 =item Protecting Your Programs
2561
2562 =item Unicode
2563
2564 =back
2565
2566 =item SEE ALSO
2567
2568 =back
2569
2570 =head2 perlmod - Perl modules (packages and symbol tables)
2571
2572 =over 4
2573
2574 =item DESCRIPTION
2575
2576 =over 4
2577
2578 =item Packages
2579
2580 =item Symbol Tables
2581
2582 =item Package Constructors and Destructors
2583
2584 =item Perl Classes
2585
2586 =item Perl Modules
2587
2588 =item Making your module threadsafe
2589
2590 =back
2591
2592 =item SEE ALSO
2593
2594 =back
2595
2596 =head2 perlmodinstall - Installing CPAN Modules
2597
2598 =over 4
2599
2600 =item DESCRIPTION
2601
2602 =over 4
2603
2604 =item PREAMBLE
2605
2606 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2607 module (sometimes unnecessary), B<INSTALL> the module
2608
2609 =back
2610
2611 =item PORTABILITY
2612
2613 =item HEY
2614
2615 =item AUTHOR
2616
2617 =item COPYRIGHT
2618
2619 =back
2620
2621 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2622
2623 =over 4
2624
2625 =item DESCRIPTION
2626
2627 =item THE PERL MODULE LIBRARY
2628
2629 =over 4
2630
2631 =item Pragmatic Modules
2632
2633 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2634 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2635 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2636 threads, utf8, vars, vmsish, warnings, warnings::register
2637
2638 =item Standard Modules
2639
2640 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2641 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2642 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2643 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2644 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2645 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2646 Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
2647 Dumpvalue, Encode, English, Env, Exporter, Exporter::Heavy,
2648 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
2649 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2650 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
2651 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
2652 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2653 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2654 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2655 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2656 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2657 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2658 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2659 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2660 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2661 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2662 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2663 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2664 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2665 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2666 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2667 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2668 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2669 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2670 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2671 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2672 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2673 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2674 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, Pod::t::basic,
2675 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
2676 Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete,
2677 Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert,
2678 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2679 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2680 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2681 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2682 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2683 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2684 Unicode::UCD, User::grent, User::pwent, Win32
2685
2686 =item Extension Modules
2687
2688 =back
2689
2690 =item CPAN
2691
2692 =over 4
2693
2694 =item Africa
2695
2696 =item Asia
2697
2698 =item Central America
2699
2700 =item Europe
2701
2702 =item North America
2703
2704 =item Oceania
2705
2706 =item South America
2707
2708 =back
2709
2710 =item Modules: Creation, Use, and Abuse
2711
2712 =over 4
2713
2714 =item Guidelines for Module Creation
2715
2716 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2717
2718 =item Guidelines for Reusing Application Code
2719
2720 =back
2721
2722 =item NOTE
2723
2724 =back
2725
2726 =head2 perlmodstyle - Perl module style guide
2727
2728 =over 4
2729
2730 =item INTRODUCTION
2731
2732 =item QUICK CHECKLIST
2733
2734 =over 4
2735
2736 =item Before you start
2737
2738 =item The API
2739
2740 =item Stability
2741
2742 =item Documentation
2743
2744 =item Release considerations
2745
2746 =back
2747
2748 =item BEFORE YOU START WRITING A MODULE
2749
2750 =over 4
2751
2752 =item Has it been done before?
2753
2754 =item Do one thing and do it well
2755
2756 =item What's in a name?
2757
2758 =back
2759
2760 =item DESIGNING AND WRITING YOUR MODULE
2761
2762 =over 4
2763
2764 =item To OO or not to OO?
2765
2766 =item Designing your API
2767
2768 Write simple routines to do simple things, Separate functionality from
2769 output, Provide sensible shortcuts and defaults, Naming conventions,
2770 Parameter passing
2771
2772 =item Strictness and warnings
2773
2774 =item Backwards compatibility
2775
2776 =item Error handling and messages
2777
2778 =back
2779
2780 =item DOCUMENTING YOUR MODULE
2781
2782 =over 4
2783
2784 =item POD
2785
2786 =item README, INSTALL, release notes, changelogs
2787
2788 =back
2789
2790 =item RELEASE CONSIDERATIONS
2791
2792 =over 4
2793
2794 =item Version numbering
2795
2796 =item Pre-requisites
2797
2798 =item Testing
2799
2800 =item Packaging
2801
2802 =item Licensing
2803
2804 =back
2805
2806 =item COMMON PITFALLS
2807
2808 =over 4
2809
2810 =item Reinventing the wheel
2811
2812 =item Trying to do too much
2813
2814 =item Inappropriate documentation
2815
2816 =back
2817
2818 =item SEE ALSO
2819
2820 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2821 http://pause.perl.org/, Any good book on software engineering
2822
2823 =item AUTHOR
2824
2825 =back
2826
2827 =head2 perlnewmod - preparing a new module for distribution
2828
2829 =over 4
2830
2831 =item DESCRIPTION
2832
2833 =over 4
2834
2835 =item Warning
2836
2837 =item What should I make into a module?
2838
2839 =item Step-by-step: Preparing the ground
2840
2841 Look around, Check it's new, Discuss the need, Choose a name, Check again
2842
2843 =item Step-by-step: Making the module
2844
2845 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2846 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2847 documentation|perlpod>, Write tests, Write the README
2848
2849 =item Step-by-step: Distributing your module
2850
2851 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2852 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2853
2854 =back
2855
2856 =item AUTHOR
2857
2858 =item SEE ALSO
2859
2860 =back
2861
2862 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2863 2002/04/07 18:46:13 $)
2864
2865 =over 4
2866
2867 =item DESCRIPTION
2868
2869 =over 4
2870
2871 =item What is Perl?
2872
2873 =item Who supports Perl?  Who develops it?  Why is it free?
2874
2875 =item Which version of Perl should I use?
2876
2877 =item What are perl4 and perl5?
2878
2879 =item What is perl6?
2880
2881 =item How stable is Perl?
2882
2883 =item Is Perl difficult to learn?
2884
2885 =item How does Perl compare with other languages like Java, Python, REXX,
2886 Scheme, or Tcl?
2887
2888 =item Can I do [task] in Perl?
2889
2890 =item When shouldn't I program in Perl?
2891
2892 =item What's the difference between "perl" and "Perl"?
2893
2894 =item Is it a Perl program or a Perl script?
2895
2896 =item What is a JAPH?
2897
2898 =item Where can I get a list of Larry Wall witticisms?
2899
2900 =item How can I convince my sysadmin/supervisor/employees to use version
2901 5/5.6.1/Perl instead of some other language?
2902
2903 =back
2904
2905 =item AUTHOR AND COPYRIGHT
2906
2907 =back
2908
2909 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2910 $Date: 2002/04/26 16:56:35 $)
2911
2912 =over 4
2913
2914 =item DESCRIPTION
2915
2916 =over 4
2917
2918 =item What machines support Perl?  Where do I get it?
2919
2920 =item How can I get a binary version of Perl?
2921
2922 =item I don't have a C compiler on my system.  How can I compile perl?
2923
2924 =item I copied the Perl binary from one machine to another, but scripts
2925 don't work.
2926
2927 =item I grabbed the sources and tried to compile but gdbm/dynamic
2928 loading/malloc/linking/... failed.  How do I make it work?
2929
2930 =item What modules and extensions are available for Perl?  What is CPAN?
2931 What does CPAN/src/... mean?
2932
2933 =item Is there an ISO or ANSI certified version of Perl?
2934
2935 =item Where can I get information on Perl?
2936
2937 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2938
2939 =item Where should I post source code?
2940
2941 =item Perl Books
2942
2943 References, Tutorials, Task-Oriented, Special Topics
2944
2945 =item Perl in Magazines
2946
2947 =item Perl on the Net: FTP and WWW Access
2948
2949 =item What mailing lists are there for Perl?
2950
2951 =item Archives of comp.lang.perl.misc
2952
2953 =item Where can I buy a commercial version of Perl?
2954
2955 =item Where do I send bug reports?
2956
2957 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2958
2959 =back
2960
2961 =item AUTHOR AND COPYRIGHT
2962
2963 =back
2964
2965 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
2966 13:11:13 $)
2967
2968 =over 4
2969
2970 =item DESCRIPTION
2971
2972 =over 4
2973
2974 =item How do I do (anything)?
2975
2976 =item How can I use Perl interactively?
2977
2978 =item Is there a Perl shell?
2979
2980 =item How do I debug my Perl programs?
2981
2982 =item How do I profile my Perl programs?
2983
2984 =item How do I cross-reference my Perl programs?
2985
2986 =item Is there a pretty-printer (formatter) for Perl?
2987
2988 =item Is there a ctags for Perl?
2989
2990 =item Is there an IDE or Windows Perl Editor?
2991
2992 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
2993 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2994 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2995
2996 =item Where can I get Perl macros for vi?
2997
2998 =item Where can I get perl-mode for emacs?
2999
3000 =item How can I use curses with Perl?
3001
3002 =item How can I use X or Tk with Perl?
3003
3004 =item How can I generate simple menus without using CGI or Tk?
3005
3006 =item How can I make my Perl program run faster?
3007
3008 =item How can I make my Perl program take less memory?
3009
3010 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3011 stringification, Pass by reference, Tie large variables to disk
3012
3013 =item Is it unsafe to return a pointer to local data?
3014
3015 =item How can I free an array or hash so my program shrinks?
3016
3017 =item How can I make my CGI script more efficient?
3018
3019 =item How can I hide the source for my Perl program?
3020
3021 =item How can I compile my Perl program into byte code or C?
3022
3023 =item How can I compile Perl into Java?
3024
3025 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3026
3027 =item Can I write useful Perl programs on the command line?
3028
3029 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3030
3031 =item Where can I learn about CGI or Web programming in Perl?
3032
3033 =item Where can I learn about object-oriented Perl programming?
3034
3035 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3036
3037 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3038 my C program; what am I doing wrong?
3039
3040 =item When I tried to run my script, I got this message. What does it mean?
3041
3042 =item What's MakeMaker?
3043
3044 =back
3045
3046 =item AUTHOR AND COPYRIGHT
3047
3048 =back
3049
3050 =head2 perlfaq4 - Data Manipulation ($Revision: 1.24 $, $Date: 2002/05/20
3051 16:50:08 $)
3052
3053 =over 4
3054
3055 =item DESCRIPTION
3056
3057 =item Data: Numbers
3058
3059 =over 4
3060
3061 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3062 numbers I should be getting (eg, 19.95)?
3063
3064 =item Why isn't my octal data interpreted correctly?
3065
3066 =item Does Perl have a round() function?  What about ceil() and floor()?
3067 Trig functions?
3068
3069 =item How do I convert between numeric representations?
3070
3071 How do I convert hexadecimal into decimal, How do I convert from decimal to
3072 hexadecimal, How do I convert from octal to decimal, How do I convert from
3073 decimal to octal, How do I convert from binary to decimal, How do I convert
3074 from decimal to binary
3075
3076 =item Why doesn't & work the way I want it to?
3077
3078 =item How do I multiply matrices?
3079
3080 =item How do I perform an operation on a series of integers?
3081
3082 =item How can I output Roman numerals?
3083
3084 =item Why aren't my random numbers random?
3085
3086 =item How do I get a random number between X and Y?
3087
3088 =back
3089
3090 =item Data: Dates
3091
3092 =over 4
3093
3094 =item How do I find the week-of-the-year/day-of-the-year?
3095
3096 =item How do I find the current century or millennium?
3097
3098 =item How can I compare two dates and find the difference?
3099
3100 =item How can I take a string and turn it into epoch seconds?
3101
3102 =item How can I find the Julian Day?
3103
3104 =item How do I find yesterday's date?
3105
3106 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3107
3108 =back
3109
3110 =item Data: Strings
3111
3112 =over 4
3113
3114 =item How do I validate input?
3115
3116 =item How do I unescape a string?
3117
3118 =item How do I remove consecutive pairs of characters?
3119
3120 =item How do I expand function calls in a string?
3121
3122 =item How do I find matching/nesting anything?
3123
3124 =item How do I reverse a string?
3125
3126 =item How do I expand tabs in a string?
3127
3128 =item How do I reformat a paragraph?
3129
3130 =item How can I access/change the first N letters of a string?
3131
3132 =item How do I change the Nth occurrence of something?
3133
3134 =item How can I count the number of occurrences of a substring within a
3135 string?
3136
3137 =item How do I capitalize all the words on one line?
3138
3139 =item How can I split a [character] delimited string except when inside
3140 [character]? (Comma-separated files)
3141
3142 =item How do I strip blank space from the beginning/end of a string?
3143
3144 =item How do I pad a string with blanks or pad a number with zeroes?
3145
3146 =item How do I extract selected columns from a string?
3147
3148 =item How do I find the soundex value of a string?
3149
3150 =item How can I expand variables in text strings?
3151
3152 =item What's wrong with always quoting "$vars"?
3153
3154 =item Why don't my <<HERE documents work?
3155
3156 1. There must be no space after the << part, 2. There (probably) should be
3157 a semicolon at the end, 3. You can't (easily) have any space in front of
3158 the tag
3159
3160 =back
3161
3162 =item Data: Arrays
3163
3164 =over 4
3165
3166 =item What is the difference between a list and an array?
3167
3168 =item What is the difference between $array[1] and @array[1]?
3169
3170 =item How can I remove duplicate elements from a list or array?
3171
3172 a), b), c), d), e)
3173
3174 =item How can I tell whether a certain element is contained in a list or
3175 array?
3176
3177 =item How do I compute the difference of two arrays?  How do I compute the
3178 intersection of two arrays?
3179
3180 =item How do I test whether two arrays or hashes are equal?
3181
3182 =item How do I find the first array element for which a condition is true?
3183
3184 =item How do I handle linked lists?
3185
3186 =item How do I handle circular lists?
3187
3188 =item How do I shuffle an array randomly?
3189
3190 =item How do I process/modify each element of an array?
3191
3192 =item How do I select a random element from an array?
3193
3194 =item How do I permute N elements of a list?
3195
3196 =item How do I sort an array by (anything)?
3197
3198 =item How do I manipulate arrays of bits?
3199
3200 =item Why does defined() return true on empty arrays and hashes?
3201
3202 =back
3203
3204 =item Data: Hashes (Associative Arrays)
3205
3206 =over 4
3207
3208 =item How do I process an entire hash?
3209
3210 =item What happens if I add or remove keys from a hash while iterating over
3211 it?
3212
3213 =item How do I look up a hash element by value?
3214
3215 =item How can I know how many entries are in a hash?
3216
3217 =item How do I sort a hash (optionally by value instead of key)?
3218
3219 =item How can I always keep my hash sorted?
3220
3221 =item What's the difference between "delete" and "undef" with hashes?
3222
3223 =item Why don't my tied hashes make the defined/exists distinction?
3224
3225 =item How do I reset an each() operation part-way through?
3226
3227 =item How can I get the unique keys from two hashes?
3228
3229 =item How can I store a multidimensional array in a DBM file?
3230
3231 =item How can I make my hash remember the order I put elements into it?
3232
3233 =item Why does passing a subroutine an undefined element in a hash create
3234 it?
3235
3236 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3237 array of hashes or arrays?
3238
3239 =item How can I use a reference as a hash key?
3240
3241 =back
3242
3243 =item Data: Misc
3244
3245 =over 4
3246
3247 =item How do I handle binary data correctly?
3248
3249 =item How do I determine whether a scalar is a number/whole/integer/float?
3250
3251 =item How do I keep persistent data across program calls?
3252
3253 =item How do I print out or copy a recursive data structure?
3254
3255 =item How do I define methods for every class/object?
3256
3257 =item How do I verify a credit card checksum?
3258
3259 =item How do I pack arrays of doubles or floats for XS code?
3260
3261 =back
3262
3263 =item AUTHOR AND COPYRIGHT
3264
3265 =back
3266
3267 =head2 perlfaq5 - Files and Formats ($Revision: 1.17 $, $Date: 2002/05/23
3268 19:33:50 $)
3269
3270 =over 4
3271
3272 =item DESCRIPTION
3273
3274 =over 4
3275
3276 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3277
3278 =item How do I change one line in a file/delete a line in a file/insert a
3279 line in the middle of a file/append to the beginning of a file?
3280
3281 =item How do I count the number of lines in a file?
3282
3283 =item How do I make a temporary file name?
3284
3285 =item How can I manipulate fixed-record-length files?
3286
3287 =item How can I make a filehandle local to a subroutine?  How do I pass
3288 filehandles between subroutines?  How do I make an array of filehandles?
3289
3290 =item How can I use a filehandle indirectly?
3291
3292 =item How can I set up a footer format to be used with write()?
3293
3294 =item How can I write() into a string?
3295
3296 =item How can I output my numbers with commas added?
3297
3298 =item How can I translate tildes (~) in a filename?
3299
3300 =item How come when I open a file read-write it wipes it out?
3301
3302 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3303
3304 =item Is there a leak/bug in glob()?
3305
3306 =item How can I open a file with a leading ">" or trailing blanks?
3307
3308 =item How can I reliably rename a file?
3309
3310 =item How can I lock a file?
3311
3312 =item Why can't I just open(FH, ">file.lock")?
3313
3314 =item I still don't get locking.  I just want to increment the number in
3315 the file.  How can I do this?
3316
3317 =item All I want to do is append a small amount of text to the end of a
3318 file.  Do I still have to use locking?
3319
3320 =item How do I randomly update a binary file?
3321
3322 =item How do I get a file's timestamp in perl?
3323
3324 =item How do I set a file's timestamp in perl?
3325
3326 =item How do I print to more than one file at once?
3327
3328 =item How can I read in an entire file all at once?
3329
3330 =item How can I read in a file by paragraphs?
3331
3332 =item How can I read a single character from a file?  From the keyboard?
3333
3334 =item How can I tell whether there's a character waiting on a filehandle?
3335
3336 =item How do I do a C<tail -f> in perl?
3337
3338 =item How do I dup() a filehandle in Perl?
3339
3340 =item How do I close a file descriptor by number?
3341
3342 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3343 `C:\temp\foo.exe` work?
3344
3345 =item Why doesn't glob("*.*") get all the files?
3346
3347 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3348 protected files?  Isn't this a bug in Perl?
3349
3350 =item How do I select a random line from a file?
3351
3352 =item Why do I get weird spaces when I print an array of lines?
3353
3354 =back
3355
3356 =item AUTHOR AND COPYRIGHT
3357
3358 =back
3359
3360 =head2 perlfaq6 - Regular Expressions ($Revision: 1.11 $, $Date: 2002/05/23
3361 15:47:37 $)
3362
3363 =over 4
3364
3365 =item DESCRIPTION
3366
3367 =over 4
3368
3369 =item How can I hope to use regular expressions without creating illegible
3370 and unmaintainable code?
3371
3372 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3373
3374 =item I'm having trouble matching over more than one line.  What's wrong?
3375
3376 =item How can I pull out lines between two patterns that are themselves on
3377 different lines?
3378
3379 =item I put a regular expression into $/ but it didn't work. What's wrong?
3380
3381 =item How do I substitute case insensitively on the LHS while preserving
3382 case on the RHS?
3383
3384 =item How can I make C<\w> match national character sets?
3385
3386 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3387
3388 =item How can I quote a variable to use in a regex?
3389
3390 =item What is C</o> really for?
3391
3392 =item How do I use a regular expression to strip C style comments from a
3393 file?
3394
3395 =item Can I use Perl regular expressions to match balanced text?
3396
3397 =item What does it mean that regexes are greedy?  How can I get around it?
3398
3399 =item How do I process each word on each line?
3400
3401 =item How can I print out a word-frequency or line-frequency summary?
3402
3403 =item How can I do approximate matching?
3404
3405 =item How do I efficiently match many regular expressions at once?
3406
3407 =item Why don't word-boundary searches with C<\b> work for me?
3408
3409 =item Why does using $&, $`, or $' slow my program down?
3410
3411 =item What good is C<\G> in a regular expression?
3412
3413 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3414
3415 =item What's wrong with using grep or map in a void context?
3416
3417 =item How can I match strings with multibyte characters?
3418
3419 =item How do I match a pattern that is supplied by the user?
3420
3421 =back
3422
3423 =item AUTHOR AND COPYRIGHT
3424
3425 =back
3426
3427 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3428 2002/03/26 15:48:32 $)
3429
3430 =over 4
3431
3432 =item DESCRIPTION
3433
3434 =over 4
3435
3436 =item Can I get a BNF/yacc/RE for the Perl language?
3437
3438 =item What are all these $@%&* punctuation signs, and how do I know when to
3439 use them?
3440
3441 =item Do I always/never have to quote my strings or use semicolons and
3442 commas?
3443
3444 =item How do I skip some return values?
3445
3446 =item How do I temporarily block warnings?
3447
3448 =item What's an extension?
3449
3450 =item Why do Perl operators have different precedence than C operators?
3451
3452 =item How do I declare/create a structure?
3453
3454 =item How do I create a module?
3455
3456 =item How do I create a class?
3457
3458 =item How can I tell if a variable is tainted?
3459
3460 =item What's a closure?
3461
3462 =item What is variable suicide and how can I prevent it?
3463
3464 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3465 Regex}?
3466
3467 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3468 Passing Methods
3469
3470 =item How do I create a static variable?
3471
3472 =item What's the difference between dynamic and lexical (static) scoping?
3473 Between local() and my()?
3474
3475 =item How can I access a dynamic variable while a similarly named lexical
3476 is in scope?
3477
3478 =item What's the difference between deep and shallow binding?
3479
3480 =item Why doesn't "my($foo) = <FILE>;" work right?
3481
3482 =item How do I redefine a builtin function, operator, or method?
3483
3484 =item What's the difference between calling a function as &foo and foo()?
3485
3486 =item How do I create a switch or case statement?
3487
3488 =item How can I catch accesses to undefined variables/functions/methods?
3489
3490 =item Why can't a method included in this same file be found?
3491
3492 =item How can I find out my current package?
3493
3494 =item How can I comment out a large block of perl code?
3495
3496 =item How do I clear a package?
3497
3498 =item How can I use a variable as a variable name?
3499
3500 =back
3501
3502 =item AUTHOR AND COPYRIGHT
3503
3504 =back
3505
3506 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3507 12:41:42 $)
3508
3509 =over 4
3510
3511 =item DESCRIPTION
3512
3513 =over 4
3514
3515 =item How do I find out which operating system I'm running under?
3516
3517 =item How come exec() doesn't return?
3518
3519 =item How do I do fancy stuff with the keyboard/screen/mouse?
3520
3521 Keyboard, Screen, Mouse
3522
3523 =item How do I print something out in color?
3524
3525 =item How do I read just one key without waiting for a return key?
3526
3527 =item How do I check whether input is ready on the keyboard?
3528
3529 =item How do I clear the screen?
3530
3531 =item How do I get the screen size?
3532
3533 =item How do I ask the user for a password?
3534
3535 =item How do I read and write the serial port?
3536
3537 lockfiles, open mode, end of line, flushing output, non-blocking input
3538
3539 =item How do I decode encrypted password files?
3540
3541 =item How do I start a process in the background?
3542
3543 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3544
3545 =item How do I trap control characters/signals?
3546
3547 =item How do I modify the shadow password file on a Unix system?
3548
3549 =item How do I set the time and date?
3550
3551 =item How can I sleep() or alarm() for under a second?
3552
3553 =item How can I measure time under a second?
3554
3555 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3556
3557 =item Why doesn't my sockets program work under System V (Solaris)?  What
3558 does the error message "Protocol not supported" mean?
3559
3560 =item How can I call my system's unique C functions from Perl?
3561
3562 =item Where do I get the include files to do ioctl() or syscall()?
3563
3564 =item Why do setuid perl scripts complain about kernel problems?
3565
3566 =item How can I open a pipe both to and from a command?
3567
3568 =item Why can't I get the output of a command with system()?
3569
3570 =item How can I capture STDERR from an external command?
3571
3572 =item Why doesn't open() return an error when a pipe open fails?
3573
3574 =item What's wrong with using backticks in a void context?
3575
3576 =item How can I call backticks without shell processing?
3577
3578 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3579 ^Z on MS-DOS)?
3580
3581 =item How can I convert my shell script to perl?
3582
3583 =item Can I use perl to run a telnet or ftp session?
3584
3585 =item How can I write expect in Perl?
3586
3587 =item Is there a way to hide perl's command line from programs such as
3588 "ps"?
3589
3590 =item I {changed directory, modified my environment} in a perl script.  How
3591 come the change disappeared when I exited the script?  How do I get my
3592 changes to be visible?
3593
3594 Unix
3595
3596 =item How do I close a process's filehandle without waiting for it to
3597 complete?
3598
3599 =item How do I fork a daemon process?
3600
3601 =item How do I find out if I'm running interactively or not?
3602
3603 =item How do I timeout a slow event?
3604
3605 =item How do I set CPU limits?
3606
3607 =item How do I avoid zombies on a Unix system?
3608
3609 =item How do I use an SQL database?
3610
3611 =item How do I make a system() exit on control-C?
3612
3613 =item How do I open a file without blocking?
3614
3615 =item How do I install a module from CPAN?
3616
3617 =item What's the difference between require and use?
3618
3619 =item How do I keep my own module/library directory?
3620
3621 =item How do I add the directory my program lives in to the module/library
3622 search path?
3623
3624 =item How do I add a directory to my include path at runtime?
3625
3626 =item What is socket.ph and where do I get it?
3627
3628 =back
3629
3630 =item AUTHOR AND COPYRIGHT
3631
3632 =back
3633
3634 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3635 $)
3636
3637 =over 4
3638
3639 =item DESCRIPTION
3640
3641 =over 4
3642
3643 =item What is the correct form of response from a CGI script?
3644
3645 =item My CGI script runs from the command line but not the browser.  (500
3646 Server Error)
3647
3648 =item How can I get better error messages from a CGI program?
3649
3650 =item How do I remove HTML from a string?
3651
3652 =item How do I extract URLs?
3653
3654 =item How do I download a file from the user's machine?  How do I open a
3655 file on another machine?
3656
3657 =item How do I make a pop-up menu in HTML?
3658
3659 =item How do I fetch an HTML file?
3660
3661 =item How do I automate an HTML form submission?
3662
3663 =item How do I decode or create those %-encodings on the web?
3664
3665 =item How do I redirect to another page?
3666
3667 =item How do I put a password on my web pages?
3668
3669 =item How do I edit my .htpasswd and .htgroup files with Perl?
3670
3671 =item How do I make sure users can't enter values into a form that cause my
3672 CGI script to do bad things?
3673
3674 =item How do I parse a mail header?
3675
3676 =item How do I decode a CGI form?
3677
3678 =item How do I check a valid mail address?
3679
3680 =item How do I decode a MIME/BASE64 string?
3681
3682 =item How do I return the user's mail address?
3683
3684 =item How do I send mail?
3685
3686 =item How do I use MIME to make an attachment to a mail message?
3687
3688 =item How do I read mail?
3689
3690 =item How do I find out my hostname/domainname/IP address?
3691
3692 =item How do I fetch a news article or the active newsgroups?
3693
3694 =item How do I fetch/put an FTP file?
3695
3696 =item How can I do RPC in Perl?
3697
3698 =back
3699
3700 =item AUTHOR AND COPYRIGHT
3701
3702 =back
3703
3704 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3705
3706 =over 4
3707
3708 =item DESCRIPTION
3709
3710 =over 4
3711
3712 =item Layout
3713
3714 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3715
3716 =back
3717
3718 =item Using The Back Ends
3719
3720 =over 4
3721
3722 =item The Cross Referencing Back End
3723
3724 i, &, s, r
3725
3726 =item The Decompiling Back End
3727
3728 =item The Lint Back End
3729
3730 =item The Simple C Back End
3731
3732 =item The Bytecode Back End
3733
3734 =item The Optimized C Back End
3735
3736 =back
3737
3738 =item Module List for the Compiler Suite
3739
3740 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3741 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3742 B::Stackobj, B::Stash, B::Terse, B::Xref
3743
3744 =item KNOWN PROBLEMS
3745
3746 =item AUTHOR
3747
3748 =back
3749
3750 =head2 perlembed - how to embed perl in your C program
3751
3752 =over 4
3753
3754 =item DESCRIPTION
3755
3756 =over 4
3757
3758 =item PREAMBLE
3759
3760 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3761 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3762
3763 =item ROADMAP
3764
3765 =item Compiling your C program
3766
3767 =item Adding a Perl interpreter to your C program
3768
3769 =item Calling a Perl subroutine from your C program
3770
3771 =item Evaluating a Perl statement from your C program
3772
3773 =item Performing Perl pattern matches and substitutions from your C program
3774
3775 =item Fiddling with the Perl stack from your C program
3776
3777 =item Maintaining a persistent interpreter
3778
3779 =item Execution of END blocks
3780
3781 =item Maintaining multiple interpreter instances
3782
3783 =item Using Perl modules, which themselves use C libraries, from your C
3784 program
3785
3786 =back
3787
3788 =item Embedding Perl under Win32
3789
3790 =item MORAL
3791
3792 =item AUTHOR
3793
3794 =item COPYRIGHT
3795
3796 =back
3797
3798 =head2 perldebguts - Guts of Perl debugging
3799
3800 =over 4
3801
3802 =item DESCRIPTION
3803
3804 =item Debugger Internals
3805
3806 =over 4
3807
3808 =item Writing Your Own Debugger
3809
3810 =back
3811
3812 =item Frame Listing Output Examples
3813
3814 =item Debugging regular expressions
3815
3816 =over 4
3817
3818 =item Compile-time output
3819
3820 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3821 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3822 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3823 C<anchored(TYPE)>
3824
3825 =item Types of nodes
3826
3827 =item Run-time output
3828
3829 =back
3830
3831 =item Debugging Perl memory usage
3832
3833 =over 4
3834
3835 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3836
3837 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3838 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3839 6144>
3840
3841 =item Example of using B<-DL> switch
3842
3843 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3844
3845 =item B<-DL> details
3846
3847 C<!!!>, C<!!>, C<!>
3848
3849 =item Limitations of B<-DL> statistics
3850
3851 =back
3852
3853 =item SEE ALSO
3854
3855 =back
3856
3857 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3858
3859 =over 4
3860
3861 =item DESCRIPTION
3862
3863 =item SPECIAL NOTES
3864
3865 =over 4
3866
3867 =item make
3868
3869 =item Version caveat
3870
3871 =item Dynamic Loading versus Static Loading
3872
3873 =back
3874
3875 =item TUTORIAL
3876
3877 =over 4
3878
3879 =item EXAMPLE 1
3880
3881 =item EXAMPLE 2
3882
3883 =item What has gone on?
3884
3885 =item Writing good test scripts
3886
3887 =item EXAMPLE 3
3888
3889 =item What's new here?
3890
3891 =item Input and Output Parameters
3892
3893 =item The XSUBPP Program
3894
3895 =item The TYPEMAP file
3896
3897 =item Warning about Output Arguments
3898
3899 =item EXAMPLE 4
3900
3901 =item What has happened here?
3902
3903 =item Anatomy of .xs file
3904
3905 =item Getting the fat out of XSUBs
3906
3907 =item More about XSUB arguments
3908
3909 =item The Argument Stack
3910
3911 =item Extending your Extension
3912
3913 =item Documenting your Extension
3914
3915 =item Installing your Extension
3916
3917 =item EXAMPLE 5
3918
3919 =item New Things in this Example
3920
3921 =item EXAMPLE 6
3922
3923 =item New Things in this Example
3924
3925 =item EXAMPLE 7 (Coming Soon)
3926
3927 =item EXAMPLE 8 (Coming Soon)
3928
3929 =item EXAMPLE 9 Passing open files to XSes
3930
3931 =item Troubleshooting these Examples
3932
3933 =back
3934
3935 =item See also
3936
3937 =item Author
3938
3939 =over 4
3940
3941 =item Last Changed
3942
3943 =back
3944
3945 =back
3946
3947 =head2 perlxs - XS language reference manual
3948
3949 =over 4
3950
3951 =item DESCRIPTION
3952
3953 =over 4
3954
3955 =item Introduction
3956
3957 =item On The Road
3958
3959 =item The Anatomy of an XSUB
3960
3961 =item The Argument Stack
3962
3963 =item The RETVAL Variable
3964
3965 =item The MODULE Keyword
3966
3967 =item The PACKAGE Keyword
3968
3969 =item The PREFIX Keyword
3970
3971 =item The OUTPUT: Keyword
3972
3973 =item The NO_OUTPUT Keyword
3974
3975 =item The CODE: Keyword
3976
3977 =item The INIT: Keyword
3978
3979 =item The NO_INIT Keyword
3980
3981 =item Initializing Function Parameters
3982
3983 =item Default Parameter Values
3984
3985 =item The PREINIT: Keyword
3986
3987 =item The SCOPE: Keyword
3988
3989 =item The INPUT: Keyword
3990
3991 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3992
3993 =item The C<length(NAME)> Keyword
3994
3995 =item Variable-length Parameter Lists
3996
3997 =item The C_ARGS: Keyword
3998
3999 =item The PPCODE: Keyword
4000
4001 =item Returning Undef And Empty Lists
4002
4003 =item The REQUIRE: Keyword
4004
4005 =item The CLEANUP: Keyword
4006
4007 =item The POSTCALL: Keyword
4008
4009 =item The BOOT: Keyword
4010
4011 =item The VERSIONCHECK: Keyword
4012
4013 =item The PROTOTYPES: Keyword
4014
4015 =item The PROTOTYPE: Keyword
4016
4017 =item The ALIAS: Keyword
4018
4019 =item The OVERLOAD: Keyword
4020
4021 =item The INTERFACE: Keyword
4022
4023 =item The INTERFACE_MACRO: Keyword
4024
4025 =item The INCLUDE: Keyword
4026
4027 =item The CASE: Keyword
4028
4029 =item The & Unary Operator
4030
4031 =item Inserting POD, Comments and C Preprocessor Directives
4032
4033 =item Using XS With C++
4034
4035 =item Interface Strategy
4036
4037 =item Perl Objects And C Structures
4038
4039 =item The Typemap
4040
4041 =item Safely Storing Static Data in XS
4042
4043 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4044
4045 =back
4046
4047 =item EXAMPLES
4048
4049 =item XS VERSION
4050
4051 =item AUTHOR
4052
4053 =back
4054
4055 =head2 perlclib - Internal replacements for standard C library functions
4056
4057 =over 4
4058
4059 =item DESCRIPTION
4060
4061 =over 4
4062
4063 =item Conventions
4064
4065 C<t>, C<p>, C<n>, C<s>
4066
4067 =item File Operations
4068
4069 =item File Input and Output
4070
4071 =item File Positioning
4072
4073 =item Memory Management and String Handling
4074
4075 =item Character Class Tests
4076
4077 =item F<stdlib.h> functions
4078
4079 =item Miscellaneous functions
4080
4081 =back
4082
4083 =item SEE ALSO
4084
4085 =back
4086
4087 =head2 perlguts - Introduction to the Perl API
4088
4089 =over 4
4090
4091 =item DESCRIPTION
4092
4093 =item Variables
4094
4095 =over 4
4096
4097 =item Datatypes
4098
4099 =item What is an "IV"?
4100
4101 =item Working with SVs
4102
4103 =item Offsets
4104
4105 =item What's Really Stored in an SV?
4106
4107 =item Working with AVs
4108
4109 =item Working with HVs
4110
4111 =item Hash API Extensions
4112
4113 =item References
4114
4115 =item Blessed References and Class Objects
4116
4117 =item Creating New Variables
4118
4119 GV_ADDMULTI, GV_ADDWARN
4120
4121 =item Reference Counts and Mortality
4122
4123 =item Stashes and Globs
4124
4125 =item Double-Typed SVs
4126
4127 =item Magic Variables
4128
4129 =item Assigning Magic
4130
4131 =item Magic Virtual Tables
4132
4133 =item Finding Magic
4134
4135 =item Understanding the Magic of Tied Hashes and Arrays
4136
4137 =item Localizing changes
4138
4139 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4140 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4141 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4142 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4143 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4144 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4145 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4146 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4147 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4148 save_hptr(HV **hptr)>
4149
4150 =back
4151
4152 =item Subroutines
4153
4154 =over 4
4155
4156 =item XSUBs and the Argument Stack
4157
4158 =item Calling Perl Routines from within C Programs
4159
4160 =item Memory Allocation
4161
4162 =item PerlIO
4163
4164 =item Putting a C value on Perl stack
4165
4166 =item Scratchpads
4167
4168 =item Scratchpads and recursion
4169
4170 =back
4171
4172 =item Compiled code
4173
4174 =over 4
4175
4176 =item Code tree
4177
4178 =item Examining the tree
4179
4180 =item Compile pass 1: check routines
4181
4182 =item Compile pass 1a: constant folding
4183
4184 =item Compile pass 2: context propagation
4185
4186 =item Compile pass 3: peephole optimization
4187
4188 =item Pluggable runops
4189
4190 =back
4191
4192 =item Examining internal data structures with the C<dump> functions
4193
4194 =item How multiple interpreters and concurrency are supported
4195
4196 =over 4
4197
4198 =item Background and PERL_IMPLICIT_CONTEXT
4199
4200 =item So what happened to dTHR?
4201
4202 =item How do I use all this in extensions?
4203
4204 =item Should I do anything special if I call perl from multiple threads?
4205
4206 =item Future Plans and PERL_IMPLICIT_SYS
4207
4208 =back
4209
4210 =item Internal Functions
4211
4212 A, p, d, s, n, r, f, M, o, j, x
4213
4214 =over 4
4215
4216 =item Formatted Printing of IVs, UVs, and NVs
4217
4218 =item Pointer-To-Integer and Integer-To-Pointer
4219
4220 =item Source Documentation
4221
4222 =back
4223
4224 =item Unicode Support
4225
4226 =over 4
4227
4228 =item What B<is> Unicode, anyway?
4229
4230 =item How can I recognise a UTF8 string?
4231
4232 =item How does UTF8 represent Unicode characters?
4233
4234 =item How does Perl store UTF8 strings?
4235
4236 =item How do I convert a string to UTF8?
4237
4238 =item Is there anything else I need to know?
4239
4240 =back
4241
4242 =item Custom Operators
4243
4244 =item AUTHORS
4245
4246 =item SEE ALSO
4247
4248 =back
4249
4250 =head2 perlcall - Perl calling conventions from C
4251
4252 =over 4
4253
4254 =item DESCRIPTION
4255
4256 An Error Handler, An Event Driven Program
4257
4258 =item THE CALL_ FUNCTIONS
4259
4260 call_sv, call_pv, call_method, call_argv
4261
4262 =item FLAG VALUES
4263
4264 =over 4
4265
4266 =item  G_VOID
4267
4268 =item  G_SCALAR
4269
4270 =item G_ARRAY
4271
4272 =item G_DISCARD
4273
4274 =item G_NOARGS
4275
4276 =item G_EVAL
4277
4278 =item G_KEEPERR
4279
4280 =item Determining the Context
4281
4282 =back
4283
4284 =item KNOWN PROBLEMS
4285
4286 =item EXAMPLES
4287
4288 =over 4
4289
4290 =item No Parameters, Nothing returned
4291
4292 =item Passing Parameters
4293
4294 =item Returning a Scalar
4295
4296 =item Returning a list of values
4297
4298 =item Returning a list in a scalar context
4299
4300 =item Returning Data from Perl via the parameter list
4301
4302 =item Using G_EVAL
4303
4304 =item Using G_KEEPERR
4305
4306 =item Using call_sv
4307
4308 =item Using call_argv
4309
4310 =item Using call_method
4311
4312 =item Using GIMME_V
4313
4314 =item Using Perl to dispose of temporaries
4315
4316 =item Strategies for storing Callback Context Information
4317
4318 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4319 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4320 callback
4321
4322 =item Alternate Stack Manipulation
4323
4324 =item Creating and calling an anonymous subroutine in C
4325
4326 =back
4327
4328 =item SEE ALSO
4329
4330 =item AUTHOR
4331
4332 =item DATE
4333
4334 =back
4335
4336 =head2 perlutil - utilities packaged with the Perl distribution
4337
4338 =over 4
4339
4340 =item DESCRIPTION
4341
4342 =over 4
4343
4344 =item DOCUMENTATION
4345
4346 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4347 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4348 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4349 L<roffitall|roffitall>
4350
4351 =item CONVERTORS
4352
4353 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4354
4355 =item Administration
4356
4357 L<libnetcfg|libnetcfg>
4358
4359 =item Development
4360
4361 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4362 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4363
4364 =item SEE ALSO
4365
4366 =back
4367
4368 =back
4369
4370 =head2 perlfilter - Source Filters
4371
4372 =over 4
4373
4374 =item DESCRIPTION
4375
4376 =item CONCEPTS
4377
4378 =item USING FILTERS
4379
4380 =item WRITING A SOURCE FILTER
4381
4382 =item WRITING A SOURCE FILTER IN C
4383
4384 B<Decryption Filters>
4385
4386 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4387
4388 =item WRITING A SOURCE FILTER IN PERL
4389
4390 =item USING CONTEXT: THE DEBUG FILTER
4391
4392 =item CONCLUSION
4393
4394 =item REQUIREMENTS
4395
4396 =item AUTHOR
4397
4398 =item Copyrights
4399
4400 =back
4401
4402 =head2 perldbmfilter - Perl DBM Filters
4403
4404 =over 4
4405
4406 =item SYNOPSIS
4407
4408 =item DESCRIPTION
4409
4410 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4411 B<filter_fetch_value>
4412
4413 =over 4
4414
4415 =item The Filter
4416
4417 =item An Example -- the NULL termination problem.
4418
4419 =item Another Example -- Key is a C int.
4420
4421 =back
4422
4423 =item SEE ALSO
4424
4425 =item AUTHOR
4426
4427 =back
4428
4429 =head2 perlapi - autogenerated documentation for the perl public API
4430
4431 =over 4
4432
4433 =item DESCRIPTION
4434
4435 =item "Gimme" Values
4436
4437 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4438
4439 =item Array Manipulation Functions
4440
4441 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4442 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4443 get_av, newAV, Nullav, sortsv
4444
4445 =item Callback Functions
4446
4447 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4448 FREETMPS, LEAVE, SAVETMPS
4449
4450 =item Character classes
4451
4452 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4453
4454 =item Cloning an interpreter
4455
4456 perl_clone
4457
4458 =item CV Manipulation Functions
4459
4460 CvSTASH, get_cv, Nullcv
4461
4462 =item Embedding Functions
4463
4464 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4465 perl_free, perl_parse, perl_run, require_pv
4466
4467 =item Functions in file pp_pack.c
4468
4469 pack_cat, unpack_str
4470
4471 =item Global Variables
4472
4473 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4474
4475 =item GV Functions
4476
4477 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4478 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4479
4480 =item Handy Values
4481
4482 HEf_SVKEY, Nullch, Nullsv
4483
4484 =item Hash Manipulation Functions
4485
4486 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4487 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4488 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4489 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4490 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4491
4492 =item Magical Functions
4493
4494 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4495 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4496 SvSetSV, SvSetSV_nosteal, SvSHARE
4497
4498 =item Memory Management
4499
4500 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4501 savepv, savepvn, savesharedpv, StructCopy, Zero
4502
4503 =item Miscellaneous Functions
4504
4505 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4506 strNE, strnEQ, strnNE
4507
4508 =item Numeric functions
4509
4510 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4511 scan_hex, scan_oct
4512
4513 =item Optree Manipulation Functions
4514
4515 cv_const_sv, newCONSTSUB, newXS
4516
4517 =item Stack Manipulation Macros
4518
4519 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4520 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4521 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4522 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4523 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4524
4525 =item SV Flags
4526
4527 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4528
4529 =item SV Manipulation Functions
4530
4531 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4532 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4533 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4534 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4535 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4536 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4537 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4538 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4539 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4540 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4541 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4542 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4543 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4544 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4545 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4546 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4547 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4548 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4549 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4550 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4551 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4552 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4553 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4554 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4555 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4556 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4557 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4558 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4559 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4560 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4561 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4562 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4563 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4564
4565 =item Unicode Support
4566
4567 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4568 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4569 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4570 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4571 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4572
4573 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4574
4575 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4576 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4577
4578 =item Warning and Dieing
4579
4580 croak, warn
4581
4582 =item AUTHORS
4583
4584 =item SEE ALSO
4585
4586 =back
4587
4588 =head2 perlintern - autogenerated documentation of purely B<internal>
4589                  Perl functions
4590
4591 =over 4
4592
4593 =item DESCRIPTION
4594
4595 =item Global Variables
4596
4597 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4598 PL_rs
4599
4600 =item GV Functions
4601
4602 is_gv_magical
4603
4604 =item IO Functions
4605
4606 start_glob
4607
4608 =item Pad Data Structures
4609
4610 CvPADLIST
4611
4612 =item Stack Manipulation Macros
4613
4614 djSP, LVRET
4615
4616 =item SV Manipulation Functions
4617
4618 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4619
4620 =item AUTHORS
4621
4622 =item SEE ALSO
4623
4624 =back
4625
4626 =head2 perliol - C API for Perl's implementation of IO in Layers.
4627
4628 =over 4
4629
4630 =item SYNOPSIS
4631
4632 =item DESCRIPTION
4633
4634 =over 4
4635
4636 =item History and Background
4637
4638 =item Layers vs Disciplines
4639
4640 =item Data Structures
4641
4642 =item Functions and Attributes
4643
4644 =item Per-instance Data
4645
4646 =item Layers in action.
4647
4648 =item Per-instance flag bits
4649
4650 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4651 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4652 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4653 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4654
4655 =item Methods in Detail
4656
4657 name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
4658 PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
4659 Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
4660 Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
4661
4662 =item Core Layers
4663
4664 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4665
4666 =item Extension Layers
4667
4668 ":encoding", ":Scalar", ":Via"
4669
4670 =back
4671
4672 =item TODO
4673
4674 =back
4675
4676 =head2 perlapio - perl's IO abstraction interface.
4677
4678 =over 4
4679
4680 =item SYNOPSIS
4681
4682 =item DESCRIPTION
4683
4684 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4685 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4686 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4687 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4688 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4689 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4690 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4691 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4692 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4693 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4694 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4695
4696 =over 4
4697
4698 =item Co-existence with stdio
4699
4700 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4701 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4702
4703 =item "Fast gets" Functions
4704
4705 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4706 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4707 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4708 B<PerlIO_get_bufsiz(f)>
4709
4710 =item Other Functions
4711
4712 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4713 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4714
4715 =back
4716
4717 =back
4718
4719 =head2 perltodo - Perl TO-DO List
4720
4721 =over 4
4722
4723 =item DESCRIPTION
4724
4725 =item To do during 5.6.x
4726
4727 =over 4
4728
4729 =item Support for I/O disciplines
4730
4731 =item Autoload bytes.pm
4732
4733 =item Make "\u{XXXX}" et al work
4734
4735 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4736
4737 =item Overloadable regex assertions
4738
4739 =item Unicode
4740
4741 =item Work out exit/die semantics for threads
4742
4743 =item Better support for nonpreemptive threading systems like GNU pth
4744
4745 =item Typed lexicals for compiler
4746
4747 =item Compiler workarounds for Win32
4748
4749 =item AUTOLOADing in the compiler
4750
4751 =item Fixing comppadlist when compiling
4752
4753 =item Cleaning up exported namespace
4754
4755 =item Complete signal handling
4756
4757 =item Out-of-source builds
4758
4759 =item POSIX realtime support
4760
4761 =item UNIX98 support
4762
4763 =item IPv6 Support
4764
4765 =item Long double conversion
4766
4767 =item Locales
4768
4769 =item Arithmetic on non-Arabic numerals
4770
4771 =item POSIX Unicode character classes
4772
4773 =item Factoring out common suffices/prefices in regexps (trie optimization)
4774
4775 =item Security audit shipped utilities
4776
4777 =item Sort out the uid-setting mess
4778
4779 =item Custom opcodes
4780
4781 =item DLL Versioning
4782
4783 =item Introduce @( and @)
4784
4785 =item Floating point handling
4786
4787 =item IV/UV preservation
4788
4789 =item Replace pod2html with something using Pod::Parser
4790
4791 =item Automate module testing on CPAN
4792
4793 =item sendmsg and recvmsg
4794
4795 =item Rewrite perlre documentation
4796
4797 =item Convert example code to IO::Handle filehandles
4798
4799 =item Document Win32 choices
4800
4801 =item Check new modules
4802
4803 =item Make roffitall find pods and libs itself
4804
4805 =back
4806
4807 =item To do at some point
4808
4809 =over 4
4810
4811 =item Remove regular expression recursion
4812
4813 =item Memory leaks after failed eval
4814
4815 =item bitfields in pack
4816
4817 =item Cross compilation
4818
4819 =item Perl preprocessor / macros
4820
4821 =item Perl lexer in Perl
4822
4823 =item Using POSIX calls internally
4824
4825 =item -i rename file when changed
4826
4827 =item All ARGV input should act like E<lt>E<gt>
4828
4829 =item Support for rerunning debugger
4830
4831 =item Test Suite for the Debugger
4832
4833 =item my sub foo { }
4834
4835 =item One-pass global destruction
4836
4837 =item Rewrite regexp parser
4838
4839 =item Cache recently used regexps
4840
4841 =item Cross-compilation support
4842
4843 =item Bit-shifting bitvectors
4844
4845 =item debugger pragma
4846
4847 =item use less pragma
4848
4849 =item switch structures
4850
4851 =item Cache eval tree
4852
4853 =item rcatmaybe
4854
4855 =item Shrink opcode tables
4856
4857 =item Optimize away @_
4858
4859 =item Prototypes versus indirect objects
4860
4861 =item Install HTML
4862
4863 =item Prototype method calls
4864
4865 =item Return context prototype declarations
4866
4867 =item magic_setisa
4868
4869 =item Garbage collection
4870
4871 =item IO tutorial
4872
4873 =item Rewrite perldoc
4874
4875 =item Install .3p manpages
4876
4877 =item Unicode tutorial
4878
4879 =item Update POSIX.pm for 1003.1-2
4880
4881 =item Retargetable installation
4882
4883 =item POSIX emulation on non-POSIX systems
4884
4885 =item Rename Win32 headers
4886
4887 =item Finish off lvalue functions
4888
4889 =item Update sprintf documentation
4890
4891 =item Use fchown/fchmod internally
4892
4893 =item Make v-strings overloaded objects
4894
4895 =item Allow restricted hash assignment
4896
4897 =item Should overload be inheritable?
4898
4899 =item Taint rethink
4900
4901 =back
4902
4903 =item Vague ideas
4904
4905 =over 4
4906
4907 =item ref() in list context
4908
4909 =item Make tr/// return histogram of characters in list context
4910
4911 =item Compile to real threaded code
4912
4913 =item Structured types
4914
4915 =item Modifiable $1 et al.
4916
4917 =item Procedural interfaces for IO::*, etc.
4918
4919 =item RPC modules
4920
4921 =item Attach/detach debugger from running program
4922
4923 =item GUI::Native
4924
4925 =item foreach(reverse ...)
4926
4927 =item Constant function cache
4928
4929 =item Approximate regular expression matching
4930
4931 =back
4932
4933 =item Ongoing
4934
4935 =over 4
4936
4937 =item Update guts documentation
4938
4939 =item Add more tests
4940
4941 =item Update auxiliary tools
4942
4943 =item Create debugging macros
4944
4945 =item truncate to the people
4946
4947 =item Unicode in Filenames
4948
4949 =back
4950
4951 =item Recently done things
4952
4953 =over 4
4954
4955 =item Alternative RE syntax module
4956
4957 =item Safe signal handling
4958
4959 =item Tie Modules
4960
4961 =item gettimeofday
4962
4963 =item setitimer and getimiter
4964
4965 =item Testing __DIE__ hook
4966
4967 =item CPP equivalent in Perl
4968
4969 =item Explicit switch statements
4970
4971 =item autocroak
4972
4973 =item UTF/EBCDIC
4974
4975 =item UTF Regexes
4976
4977 =item perlcc to produce executable
4978
4979 =item END blocks saved in compiled output
4980
4981 =item Secure temporary file module
4982
4983 =item Integrate Time::HiRes
4984
4985 =item Turn Cwd into XS
4986
4987 =item Mmap for input
4988
4989 =item Byte to/from UTF8 and UTF8 to/from local conversion
4990
4991 =item Add sockatmark support
4992
4993 =item Mailing list archives
4994
4995 =item Bug tracking
4996
4997 =item Integrate MacPerl
4998
4999 =item Web "nerve center" for Perl
5000
5001 =item Regular expression tutorial
5002
5003 =item Debugging Tutorial
5004
5005 =item Integrate new modules
5006
5007 =item Integrate profiler
5008
5009 =item Y2K error detection
5010
5011 =item Regular expression debugger
5012
5013 =item POD checker
5014
5015 =item "Dynamic" lexicals
5016
5017 =item Cache precompiled modules
5018
5019 =back
5020
5021 =item Deprecated Wishes
5022
5023 =over 4
5024
5025 =item Loop control on do{}
5026
5027 =item Lexically scoped typeglobs
5028
5029 =item format BOTTOM
5030
5031 =item report HANDLE
5032
5033 =item Generalised want()/caller())
5034
5035 =item Named prototypes
5036
5037 =item Built-in globbing
5038
5039 =item Regression tests for suidperl
5040
5041 =item Cached hash values
5042
5043 =item Add compression modules
5044
5045 =item Reorganise documentation into tutorials/references
5046
5047 =item Remove distinction between functions and operators
5048
5049 =item Make XS easier to use
5050
5051 =item Make embedding easier to use
5052
5053 =item man for perl
5054
5055 =item my $Package::variable
5056
5057 =item "or" tests defined, not truth
5058
5059 =item "class"-based lexicals
5060
5061 =item byteperl
5062
5063 =item Lazy evaluation / tail recursion removal
5064
5065 =item Make "use utf8" the default
5066
5067 =item Unicode collation and normalization
5068
5069 =item pack/unpack tutorial
5070
5071 =back
5072
5073 =back
5074
5075 =head2 perlhack - How to hack at the Perl internals
5076
5077 =over 4
5078
5079 =item DESCRIPTION
5080
5081 Does concept match the general goals of Perl?, Where is the
5082 implementation?, Backwards compatibility, Could it be a module instead?, Is
5083 the feature generic enough?, Does it potentially introduce new bugs?, Does
5084 it preclude other desirable features?, Is the implementation robust?, Is
5085 the implementation generic enough to be portable?, Is the implementation
5086 tested?, Is there enough documentation?, Is there another way to do it?,
5087 Does it create too much work?, Patches speak louder than words
5088
5089 =over 4
5090
5091 =item Keeping in sync
5092
5093 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5094 NFS, rsync'ing the patches
5095
5096 =item Why rsync the source tree
5097
5098 It's easier to rsync the source tree, It's more recent, It's more reliable
5099
5100 =item Why rsync the patches
5101
5102 It's easier to rsync the patches, It's a good reference, Finding a start
5103 point, Finding how to fix a bug, Finding the source of misbehaviour
5104
5105 =item Perlbug remote interface
5106
5107 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5108 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5109
5110 =item Submitting patches
5111
5112 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5113 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5114
5115 =item Finding Your Way Around
5116
5117 Core modules, Tests, Documentation, Configure, Interpreter
5118
5119 =item Elements of the interpreter
5120
5121 Startup, Parsing, Optimization, Running
5122
5123 =item Internal Variable Types
5124
5125 =item Op Trees
5126
5127 =item Stacks
5128
5129 Argument stack, Mark stack, Save stack
5130
5131 =item Millions of Macros
5132
5133 =item Poking at Perl
5134
5135 =item Using a source-level debugger
5136
5137 run [args], break function_name, break source.c:xxx, step, next, continue,
5138 finish, 'enter', print
5139
5140 =item Dumping Perl Data Structures
5141
5142 =item Patching
5143
5144 =item Patching a core module
5145
5146 =item Adding a new function to the core
5147
5148 =item Writing a test
5149
5150 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5151 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5152
5153 =item Special Make Test Targets
5154
5155 coretest, test.deparse, minitest, test.third check.third utest.third
5156 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5157
5158 =back
5159
5160 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5161
5162 =over 4
5163
5164 =item Rational Software's Purify
5165
5166 =item Purify on Unix
5167
5168 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5169
5170 =item Purify on NT
5171
5172 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5173
5174 =item Compaq's/Digital's/HP's Third Degree
5175
5176 =item PERL_DESTRUCT_LEVEL
5177
5178 =item Profiling
5179
5180 =item Gprof Profiling
5181
5182 -a, -b, -e routine, -f routine, -s, -z
5183
5184 =item GCC gcov Profiling
5185
5186 =item Pixie Profiling
5187
5188 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5189 -z[ero]
5190
5191 =item Miscellaneous tricks
5192
5193 =item CONCLUSION
5194
5195 I<The Road goes ever on and on, down from the door where it began.>
5196
5197 =back
5198
5199 =item AUTHOR
5200
5201 =back
5202
5203 =head2 perlhist - the Perl history records
5204
5205 =over 4
5206
5207 =item DESCRIPTION
5208
5209 =item INTRODUCTION
5210
5211 =item THE KEEPERS OF THE PUMPKIN
5212
5213 =over 4
5214
5215 =item PUMPKIN?
5216
5217 =back
5218
5219 =item THE RECORDS
5220
5221 =over 4
5222
5223 =item SELECTED RELEASE SIZES
5224
5225 =item SELECTED PATCH SIZES
5226
5227 =back
5228
5229 =item THE KEEPERS OF THE RECORDS
5230
5231 =back
5232
5233 =over 4
5234
5235 =item DESCRIPTION
5236
5237 =item Highlights In 5.8.0
5238
5239 =item Incompatible Changes
5240
5241 =over 4
5242
5243 =item Binary Incompatibility
5244
5245 =item 64-bit platforms and malloc
5246
5247 =item AIX Dynaloading
5248
5249 =item Attributes for C<my> variables now handled at run-time.
5250
5251 =item Socket Extension Dynamic in VMS
5252
5253 =item IEEE-format Floating Point Default on OpenVMS Alpha
5254
5255 =item New Unicode Properties
5256
5257 =item REF(...) Instead Of SCALAR(...)
5258
5259 =item pack/unpack D/F recycled
5260
5261 =item Deprecations
5262
5263 =back
5264
5265 =item Core Enhancements
5266
5267 =over 4
5268
5269 =item PerlIO is Now The Default
5270
5271 =item Restricted Hashes
5272
5273 =item Safe Signals
5274
5275 =item Unicode Overhaul
5276
5277 =item Understanding of Numbers
5278
5279 =item Miscellaneous Changes
5280
5281 =back
5282
5283 =item Modules and Pragmata
5284
5285 =over 4
5286
5287 =item New Modules and Pragmata
5288
5289 =item Updated And Improved Modules and Pragmata
5290
5291 =back
5292
5293 =item Utility Changes
5294
5295 =item New Documentation
5296
5297 =item Performance Enhancements
5298
5299 =item Installation and Configuration Improvements
5300
5301 =over 4
5302
5303 =item Generic Improvements
5304
5305 =item New Or Improved Platforms
5306
5307 =back
5308
5309 =item Selected Bug Fixes
5310
5311 =over 4
5312
5313 =item Platform Specific Changes and Fixes
5314
5315 =back
5316
5317 =item New or Changed Diagnostics
5318
5319 =item Changed Internals
5320
5321 =item Security Vulnerability Closed
5322
5323 =item New Tests
5324
5325 =item Known Problems
5326
5327 =over 4
5328
5329 =item AIX
5330
5331 =item BeOS
5332
5333 =item ext/threads/t/libc
5334
5335 =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
5336
5337 =item Modifying $_ Inside for(..)
5338
5339 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5340
5341 =item lib/ftmp-security tests warn 'system possibly insecure'
5342
5343 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5344
5345 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5346
5347 =item Linux With Sfio Fails op/misc Test 48
5348
5349 =item Mac OS X
5350
5351 =item op/sprintf tests 91, 129, and 130
5352
5353 =item Solaris 2.5
5354
5355 =item Stratus VOS
5356
5357 =item Term::ReadKey not working on Win32
5358
5359 =item Failure of Thread (5.005-style) tests
5360
5361 =item UNICOS
5362
5363 =item UNICOS/mk
5364
5365 =item UTS
5366
5367 =item VMS
5368
5369 =item Win32
5370
5371 =item XML::Parser not working
5372
5373 =item z/OS (OS/390)
5374
5375 =item Localising Tied Arrays and Hashes Is Broken
5376
5377 =item Self-tying Problems
5378
5379 =item Building Extensions Can Fail Because Of Largefiles
5380
5381 =item Unicode Support on EBCDIC Still Spotty
5382
5383 =item The Compiler Suite Is Still Very Experimental
5384
5385 =item The Long Double Support Is Still Experimental
5386
5387 =item Seen In Perl 5.7 But Gone Now
5388
5389 =back
5390
5391 =item Reporting Bugs
5392
5393 =item SEE ALSO
5394
5395 =item HISTORY
5396
5397 =back
5398
5399 =head2 perl572delta - what's new for perl v5.7.2
5400
5401 =over 4
5402
5403 =item DESCRIPTION
5404
5405 =item Security Vulnerability Closed
5406
5407 =item Incompatible Changes
5408
5409 =over 4
5410
5411 =item 64-bit platforms and malloc
5412
5413 =item AIX Dynaloading
5414
5415 =item Socket Extension Dynamic in VMS
5416
5417 =item Different Definition of the Unicode Character Classes \p{In...}
5418
5419 =item Deprecations
5420
5421 =back
5422
5423 =item Core Enhancements
5424
5425 =item Modules and Pragmata
5426
5427 =over 4
5428
5429 =item New Modules and Distributions
5430
5431 =item Updated And Improved Modules and Pragmata
5432
5433 =back
5434
5435 =item Utility Changes
5436
5437 =item New Documentation
5438
5439 =item Installation and Configuration Improvements
5440
5441 =over 4
5442
5443 =item New Or Improved Platforms
5444
5445 =item Generic Improvements
5446
5447 =back
5448
5449 =item Selected Bug Fixes
5450
5451 =over 4
5452
5453 =item Platform Specific Changes and Fixes
5454
5455 =back
5456
5457 =item New or Changed Diagnostics
5458
5459 =item Source Code Enhancements
5460
5461 =over 4
5462
5463 =item MAGIC constants
5464
5465 =item Better commented code
5466
5467 =item Regex pre-/post-compilation items matched up
5468
5469 =item gcc -Wall
5470
5471 =back
5472
5473 =item New Tests
5474
5475 =item Known Problems
5476
5477 =over 4
5478
5479 =item AIX
5480
5481 =item Amiga Perl Invoking Mystery
5482
5483 =item lib/ftmp-security tests warn 'system possibly insecure'
5484
5485 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5486
5487 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5488
5489 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5490
5491 =item Linux With Sfio Fails op/misc Test 48
5492
5493 =item OS/390
5494
5495 =item op/sprintf tests 129 and 130
5496
5497 =item  Failure of Thread tests
5498
5499 =item UNICOS
5500
5501 =item UTS
5502
5503 =item VMS
5504
5505 =item Win32
5506
5507 =item Localising a Tied Variable Leaks Memory
5508
5509 =item Self-tying of Arrays and Hashes Is Forbidden
5510
5511 =item Variable Attributes are not Currently Usable for Tieing
5512
5513 =item Building Extensions Can Fail Because Of Largefiles
5514
5515 =item The Compiler Suite Is Still Experimental
5516
5517 =item The Long Double Support is Still Experimental
5518
5519 =back
5520
5521 =item Reporting Bugs
5522
5523 =item SEE ALSO
5524
5525 =item HISTORY
5526
5527 =back
5528
5529 =head2 perl571delta - what's new for perl v5.7.1
5530
5531 =over 4
5532
5533 =item DESCRIPTION
5534
5535 =item Security Vulnerability Closed
5536
5537 =item Incompatible Changes
5538
5539 =item Core Enhancements
5540
5541 =over 4
5542
5543 =item AUTOLOAD Is Now Lvaluable
5544
5545 =item PerlIO is Now The Default
5546
5547 =item Signals Are Now Safe
5548
5549 =back
5550
5551 =item Modules and Pragmata
5552
5553 =over 4
5554
5555 =item New Modules
5556
5557 =item Updated And Improved Modules and Pragmata
5558
5559 =back
5560
5561 =item Performance Enhancements
5562
5563 =item Utility Changes
5564
5565 =item New Documentation
5566
5567 =over 4
5568
5569 =item perlclib
5570
5571 =item perliol
5572
5573 =item README.aix
5574
5575 =item README.bs2000
5576
5577 =item README.macos
5578
5579 =item README.mpeix
5580
5581 =item README.solaris
5582
5583 =item README.vos
5584
5585 =item Porting/repository.pod
5586
5587 =back
5588
5589 =item Installation and Configuration Improvements
5590
5591 =over 4
5592
5593 =item New Or Improved Platforms
5594
5595 =item Generic Improvements
5596
5597 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5598 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5599 d_strtoq, d_u32align, d_ualarm, d_usleep
5600
5601 =back
5602
5603 =item Selected Bug Fixes
5604
5605 =over 4
5606
5607 =item Platform Specific Changes and Fixes
5608
5609 =back
5610
5611 =item New or Changed Diagnostics
5612
5613 =item Changed Internals
5614
5615 =item New Tests
5616
5617 =item Known Problems
5618
5619 =over 4
5620
5621 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5622
5623 =item lib/ftmp-security tests warn 'system possibly insecure'
5624
5625 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5626
5627 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5628
5629 =item lib/b test 19
5630
5631 =item Linux With Sfio Fails op/misc Test 48
5632
5633 =item sigaction test 13 in VMS
5634
5635 =item sprintf tests 129 and 130
5636
5637 =item  Failure of Thread tests
5638
5639 =item Localising a Tied Variable Leaks Memory
5640
5641 =item Self-tying of Arrays and Hashes Is Forbidden
5642
5643 =item Building Extensions Can Fail Because Of Largefiles
5644
5645 =item The Compiler Suite Is Still Experimental
5646
5647 =back
5648
5649 =item Reporting Bugs
5650
5651 =item SEE ALSO
5652
5653 =item HISTORY
5654
5655 =back
5656
5657 =head2 perl570delta - what's new for perl v5.7.0
5658
5659 =over 4
5660
5661 =item DESCRIPTION
5662
5663 =item Security Vulnerability Closed
5664
5665 =item Incompatible Changes
5666
5667 =item Core Enhancements
5668
5669 =item Modules and Pragmata
5670
5671 =over 4
5672
5673 =item New Modules
5674
5675 =item Updated And Improved Modules and Pragmata
5676
5677 =back
5678
5679 =item Utility Changes
5680
5681 =item New Documentation
5682
5683 =item Performance Enhancements
5684
5685 =item Installation and Configuration Improvements
5686
5687 =over 4
5688
5689 =item Generic Improvements
5690
5691 =back
5692
5693 =item Selected Bug Fixes
5694
5695 =over 4
5696
5697 =item Platform Specific Changes and Fixes
5698
5699 =back
5700
5701 =item New or Changed Diagnostics
5702
5703 =item Changed Internals
5704
5705 =item Known Problems
5706
5707 =over 4
5708
5709 =item Unicode Support Still Far From Perfect
5710
5711 =item EBCDIC Still A Lost Platform
5712
5713 =item Building Extensions Can Fail Because Of Largefiles
5714
5715 =item ftmp-security tests warn 'system possibly insecure'
5716
5717 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5718
5719 =item Long Doubles Still Don't Work In Solaris
5720
5721 =item Linux With Sfio Fails op/misc Test 48
5722
5723 =item Storable tests fail in some platforms
5724
5725 =item Threads Are Still Experimental
5726
5727 =item The Compiler Suite Is Still Experimental
5728
5729 =back
5730
5731 =item Reporting Bugs
5732
5733 =item SEE ALSO
5734
5735 =item HISTORY
5736
5737 =back
5738
5739 =head2 perl561delta - what's new for perl v5.6.x
5740
5741 =over 4
5742
5743 =item DESCRIPTION
5744
5745 =item Summary of changes between 5.6.0 and 5.6.1
5746
5747 =over 4
5748
5749 =item Security Issues
5750
5751 =item Core bug fixes
5752
5753 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5754 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5755 references to special variables, Lexical warnings, Spurious warnings and
5756 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5757 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5758 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5759 Module;>, Tests
5760
5761 =item Core features
5762
5763 =item Configuration issues
5764
5765 =item Documentation
5766
5767 =item Bundled modules
5768
5769 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5770 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5771 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5772 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5773
5774 =item Platform-specific improvements
5775
5776 NCR MP-RAS, NonStop-UX
5777
5778 =back
5779
5780 =item Core Enhancements
5781
5782 =over 4
5783
5784 =item Interpreter cloning, threads, and concurrency
5785
5786 =item Lexically scoped warning categories
5787
5788 =item Unicode and UTF-8 support
5789
5790 =item Support for interpolating named characters
5791
5792 =item "our" declarations
5793
5794 =item Support for strings represented as a vector of ordinals
5795
5796 =item Improved Perl version numbering system
5797
5798 =item New syntax for declaring subroutine attributes
5799
5800 =item File and directory handles can be autovivified
5801
5802 =item open() with more than two arguments
5803
5804 =item 64-bit support
5805
5806 =item Large file support
5807
5808 =item Long doubles
5809
5810 =item "more bits"
5811
5812 =item Enhanced support for sort() subroutines
5813
5814 =item C<sort $coderef @foo> allowed
5815
5816 =item File globbing implemented internally
5817
5818 =item Support for CHECK blocks
5819
5820 =item POSIX character class syntax [: :] supported
5821
5822 =item Better pseudo-random number generator
5823
5824 =item Improved C<qw//> operator
5825
5826 =item Better worst-case behavior of hashes
5827
5828 =item pack() format 'Z' supported
5829
5830 =item pack() format modifier '!' supported
5831
5832 =item pack() and unpack() support counted strings
5833
5834 =item Comments in pack() templates
5835
5836 =item Weak references
5837
5838 =item Binary numbers supported
5839
5840 =item Lvalue subroutines
5841
5842 =item Some arrows may be omitted in calls through references
5843
5844 =item Boolean assignment operators are legal lvalues
5845
5846 =item exists() is supported on subroutine names
5847
5848 =item exists() and delete() are supported on array elements
5849
5850 =item Pseudo-hashes work better
5851
5852 =item Automatic flushing of output buffers
5853
5854 =item Better diagnostics on meaningless filehandle operations
5855
5856 =item Where possible, buffered data discarded from duped input filehandle
5857
5858 =item eof() has the same old magic as <>
5859
5860 =item binmode() can be used to set :crlf and :raw modes
5861
5862 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5863
5864 =item system(), backticks and pipe open now reflect exec() failure
5865
5866 =item Improved diagnostics
5867
5868 =item Diagnostics follow STDERR
5869
5870 =item More consistent close-on-exec behavior
5871
5872 =item syswrite() ease-of-use
5873
5874 =item Better syntax checks on parenthesized unary operators
5875
5876 =item Bit operators support full native integer width
5877
5878 =item Improved security features
5879
5880 =item More functional bareword prototype (*)
5881
5882 =item C<require> and C<do> may be overridden
5883
5884 =item $^X variables may now have names longer than one character
5885
5886 =item New variable $^C reflects C<-c> switch
5887
5888 =item New variable $^V contains Perl version as a string
5889
5890 =item Optional Y2K warnings
5891
5892 =item Arrays now always interpolate into double-quoted strings
5893
5894 =back
5895
5896 =item Modules and Pragmata
5897
5898 =over 4
5899
5900 =item Modules
5901
5902 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5903 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5904 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5905 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5906 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5907 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5908 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5909 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5910
5911 =item Pragmata
5912
5913 =back
5914
5915 =item Utility Changes
5916
5917 =over 4
5918
5919 =item dprofpp
5920
5921 =item find2perl
5922
5923 =item h2xs
5924
5925 =item perlcc
5926
5927 =item perldoc
5928
5929 =item The Perl Debugger
5930
5931 =back
5932
5933 =item Improved Documentation
5934
5935 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5936 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5937 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5938 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5939
5940 =item Performance enhancements
5941
5942 =over 4
5943
5944 =item Simple sort() using { $a <=> $b } and the like are optimized
5945
5946 =item Optimized assignments to lexical variables
5947
5948 =item Faster subroutine calls
5949
5950 =item delete(), each(), values() and hash iteration are faster
5951
5952 =back
5953
5954 =item Installation and Configuration Improvements
5955
5956 =over 4
5957
5958 =item -Dusethreads means something different
5959
5960 =item New Configure flags
5961
5962 =item Threadedness and 64-bitness now more daring
5963
5964 =item Long Doubles
5965
5966 =item -Dusemorebits
5967
5968 =item -Duselargefiles
5969
5970 =item installusrbinperl
5971
5972 =item SOCKS support
5973
5974 =item C<-A> flag
5975
5976 =item Enhanced Installation Directories
5977
5978 =item gcc automatically tried if 'cc' does not seem to be working
5979
5980 =back
5981
5982 =item Platform specific changes
5983
5984 =over 4
5985
5986 =item Supported platforms
5987
5988 =item DOS
5989
5990 =item OS390 (OpenEdition MVS)
5991
5992 =item VMS
5993
5994 =item Win32
5995
5996 =back
5997
5998 =item Significant bug fixes
5999
6000 =over 4
6001
6002 =item <HANDLE> on empty files
6003
6004 =item C<eval '...'> improvements
6005
6006 =item All compilation errors are true errors
6007
6008 =item Implicitly closed filehandles are safer
6009
6010 =item Behavior of list slices is more consistent
6011
6012 =item C<(\$)> prototype and C<$foo{a}>
6013
6014 =item C<goto &sub> and AUTOLOAD
6015
6016 =item C<-bareword> allowed under C<use integer>
6017
6018 =item Failures in DESTROY()
6019
6020 =item Locale bugs fixed
6021
6022 =item Memory leaks
6023
6024 =item Spurious subroutine stubs after failed subroutine calls
6025
6026 =item Taint failures under C<-U>
6027
6028 =item END blocks and the C<-c> switch
6029
6030 =item Potential to leak DATA filehandles
6031
6032 =back
6033
6034 =item New or Changed Diagnostics
6035
6036 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6037 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6038 / cannot take a count, / must be followed by a, A or Z, / must be followed
6039 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6040 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6041 passed through, /%s/ should probably be written as "%s", %s() called too
6042 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6043 argument is not a HASH or ARRAY element or slice, %s argument is not a
6044 subroutine name, %s package attribute may clash with future reserved word:
6045 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6046 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6047 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6048 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6049 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6050 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6051 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6052 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6053 weaken a nonreference, Character class [:%s:] unknown, Character class
6054 syntax [%s] belongs inside character classes, Constant is not %s reference,
6055 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6056 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6057 "local" instead of "our"?), Document contains no data, entering effective
6058 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6059 output, flock() on closed filehandle %s, Global symbol "%s" requires
6060 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6061 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6062 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6063 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6064 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6065 separator character %s in attribute list, Invalid separator character %s in
6066 subroutine attribute list, leaving effective %s failed, Lvalue subs
6067 returning %s not implemented yet, Method %s not permitted, Missing
6068 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6069 No %s specified for -%c, No package name allowed for variable %s in "our",
6070 No space allowed after -%c, no UTC offset information; assuming local time
6071 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6072 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6073 around "%s" list, Possible unintended interpolation of %s in string,
6074 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6075 instead, Premature end of script headers, Repeat count in pack overflows,
6076 Repeat count in unpack overflows, realloc() of freed memory ignored,
6077 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6078 zero-length expression, switching effective %s is not implemented, This
6079 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6080 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6081 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6082 escape \\%c passed through, Unterminated attribute parameter in attribute
6083 list, Unterminated attribute list, Unterminated attribute parameter in
6084 subroutine attribute list, Unterminated subroutine attribute list, Value of
6085 CLI symbol "%s" too long, Version number must be a constant number
6086
6087 =item New tests
6088
6089 =item Incompatible Changes
6090
6091 =over 4
6092
6093 =item Perl Source Incompatibilities
6094
6095 CHECK is a new keyword, Treatment of list slices of undef has changed,
6096 Format of $English::PERL_VERSION is different, Literals of the form
6097 C<1.2.3> parse differently, Possibly changed pseudo-random number
6098 generator, Hashing function for hash keys has changed, C<undef> fails on
6099 read only values, Close-on-exec bit may be set on pipe and socket handles,
6100 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6101 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6102 Text of some diagnostic output has changed, C<%@> has been removed,
6103 Parenthesized not() behaves like a list operator, Semantics of bareword
6104 prototype C<(*)> have changed, Semantics of bit operators may have changed
6105 on 64-bit platforms, More builtins taint their results
6106
6107 =item C Source Incompatibilities
6108
6109 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6110
6111 =item Compatible C Source API Changes
6112
6113 C<PATCHLEVEL> is now C<PERL_VERSION>
6114
6115 =item Binary Incompatibilities
6116
6117 =back
6118
6119 =item Known Problems
6120
6121 =over 4
6122
6123 =item Localizing a tied hash element may leak memory
6124
6125 =item Known test failures
6126
6127 =item EBCDIC platforms not fully supported
6128
6129 =item UNICOS/mk CC failures during Configure run
6130
6131 =item Arrow operator and arrays
6132
6133 =item Experimental features
6134
6135 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6136 pseudo-hash data type, The Compiler suite, Internal implementation of file
6137 globbing, The DB module, The regular expression code constructs:
6138
6139 =back
6140
6141 =item Obsolete Diagnostics
6142
6143 Character class syntax [: :] is reserved for future extensions, Ill-formed
6144 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6145 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6146 to mean "${$}<digit>" is deprecated
6147
6148 =item Reporting Bugs
6149
6150 =item SEE ALSO
6151
6152 =item HISTORY
6153
6154 =back
6155
6156 =head2 perl56delta - what's new for perl v5.6.0
6157
6158 =over 4
6159
6160 =item DESCRIPTION
6161
6162 =item Core Enhancements
6163
6164 =over 4
6165
6166 =item Interpreter cloning, threads, and concurrency
6167
6168 =item Lexically scoped warning categories
6169
6170 =item Unicode and UTF-8 support
6171
6172 =item Support for interpolating named characters
6173
6174 =item "our" declarations
6175
6176 =item Support for strings represented as a vector of ordinals
6177
6178 =item Improved Perl version numbering system
6179
6180 =item New syntax for declaring subroutine attributes
6181
6182 =item File and directory handles can be autovivified
6183
6184 =item open() with more than two arguments
6185
6186 =item 64-bit support
6187
6188 =item Large file support
6189
6190 =item Long doubles
6191
6192 =item "more bits"
6193
6194 =item Enhanced support for sort() subroutines
6195
6196 =item C<sort $coderef @foo> allowed
6197
6198 =item File globbing implemented internally
6199
6200 =item Support for CHECK blocks
6201
6202 =item POSIX character class syntax [: :] supported
6203
6204 =item Better pseudo-random number generator
6205
6206 =item Improved C<qw//> operator
6207
6208 =item Better worst-case behavior of hashes
6209
6210 =item pack() format 'Z' supported
6211
6212 =item pack() format modifier '!' supported
6213
6214 =item pack() and unpack() support counted strings
6215
6216 =item Comments in pack() templates
6217
6218 =item Weak references
6219
6220 =item Binary numbers supported
6221
6222 =item Lvalue subroutines
6223
6224 =item Some arrows may be omitted in calls through references
6225
6226 =item Boolean assignment operators are legal lvalues
6227
6228 =item exists() is supported on subroutine names
6229
6230 =item exists() and delete() are supported on array elements
6231
6232 =item Pseudo-hashes work better
6233
6234 =item Automatic flushing of output buffers
6235
6236 =item Better diagnostics on meaningless filehandle operations
6237
6238 =item Where possible, buffered data discarded from duped input filehandle
6239
6240 =item eof() has the same old magic as <>
6241
6242 =item binmode() can be used to set :crlf and :raw modes
6243
6244 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6245
6246 =item system(), backticks and pipe open now reflect exec() failure
6247
6248 =item Improved diagnostics
6249
6250 =item Diagnostics follow STDERR
6251
6252 =item More consistent close-on-exec behavior
6253
6254 =item syswrite() ease-of-use
6255
6256 =item Better syntax checks on parenthesized unary operators
6257
6258 =item Bit operators support full native integer width
6259
6260 =item Improved security features
6261
6262 =item More functional bareword prototype (*)
6263
6264 =item C<require> and C<do> may be overridden
6265
6266 =item $^X variables may now have names longer than one character
6267
6268 =item New variable $^C reflects C<-c> switch
6269
6270 =item New variable $^V contains Perl version as a string
6271
6272 =item Optional Y2K warnings
6273
6274 =item Arrays now always interpolate into double-quoted strings
6275
6276 =back
6277
6278 =item Modules and Pragmata
6279
6280 =over 4
6281
6282 =item Modules
6283
6284 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6285 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6286 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6287 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6288 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6289 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6290 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6291 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6292
6293 =item Pragmata
6294
6295 =back
6296
6297 =item Utility Changes
6298
6299 =over 4
6300
6301 =item dprofpp
6302
6303 =item find2perl
6304
6305 =item h2xs
6306
6307 =item perlcc
6308
6309 =item perldoc
6310
6311 =item The Perl Debugger
6312
6313 =back
6314
6315 =item Improved Documentation
6316
6317 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6318 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6319 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6320 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6321
6322 =item Performance enhancements
6323
6324 =over 4
6325
6326 =item Simple sort() using { $a <=> $b } and the like are optimized
6327
6328 =item Optimized assignments to lexical variables
6329
6330 =item Faster subroutine calls
6331
6332 =item delete(), each(), values() and hash iteration are faster
6333
6334 =back
6335
6336 =item Installation and Configuration Improvements
6337
6338 =over 4
6339
6340 =item -Dusethreads means something different
6341
6342 =item New Configure flags
6343
6344 =item Threadedness and 64-bitness now more daring
6345
6346 =item Long Doubles
6347
6348 =item -Dusemorebits
6349
6350 =item -Duselargefiles
6351
6352 =item installusrbinperl
6353
6354 =item SOCKS support
6355
6356 =item C<-A> flag
6357
6358 =item Enhanced Installation Directories
6359
6360 =back
6361
6362 =item Platform specific changes
6363
6364 =over 4
6365
6366 =item Supported platforms
6367
6368 =item DOS
6369
6370 =item OS390 (OpenEdition MVS)
6371
6372 =item VMS
6373
6374 =item Win32
6375
6376 =back
6377
6378 =item Significant bug fixes
6379
6380 =over 4
6381
6382 =item <HANDLE> on empty files
6383
6384 =item C<eval '...'> improvements
6385
6386 =item All compilation errors are true errors
6387
6388 =item Implicitly closed filehandles are safer
6389
6390 =item Behavior of list slices is more consistent
6391
6392 =item C<(\$)> prototype and C<$foo{a}>
6393
6394 =item C<goto &sub> and AUTOLOAD
6395
6396 =item C<-bareword> allowed under C<use integer>
6397
6398 =item Failures in DESTROY()
6399
6400 =item Locale bugs fixed
6401
6402 =item Memory leaks
6403
6404 =item Spurious subroutine stubs after failed subroutine calls
6405
6406 =item Taint failures under C<-U>
6407
6408 =item END blocks and the C<-c> switch
6409
6410 =item Potential to leak DATA filehandles
6411
6412 =back
6413
6414 =item New or Changed Diagnostics
6415
6416 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6417 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6418 / cannot take a count, / must be followed by a, A or Z, / must be followed
6419 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6420 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6421 passed through, /%s/ should probably be written as "%s", %s() called too
6422 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6423 argument is not a HASH or ARRAY element or slice, %s argument is not a
6424 subroutine name, %s package attribute may clash with future reserved word:
6425 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6426 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6427 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6428 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6429 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6430 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6431 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6432 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6433 weaken a nonreference, Character class [:%s:] unknown, Character class
6434 syntax [%s] belongs inside character classes, Constant is not %s reference,
6435 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6436 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6437 "local" instead of "our"?), Document contains no data, entering effective
6438 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6439 output, flock() on closed filehandle %s, Global symbol "%s" requires
6440 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6441 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6442 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6443 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6444 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6445 separator character %s in attribute list, Invalid separator character %s in
6446 subroutine attribute list, leaving effective %s failed, Lvalue subs
6447 returning %s not implemented yet, Method %s not permitted, Missing
6448 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6449 No %s specified for -%c, No package name allowed for variable %s in "our",
6450 No space allowed after -%c, no UTC offset information; assuming local time
6451 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6452 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6453 around "%s" list, Possible unintended interpolation of %s in string,
6454 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6455 instead, Premature end of script headers, Repeat count in pack overflows,
6456 Repeat count in unpack overflows, realloc() of freed memory ignored,
6457 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6458 zero-length expression, switching effective %s is not implemented, This
6459 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6460 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6461 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6462 escape \\%c passed through, Unterminated attribute parameter in attribute
6463 list, Unterminated attribute list, Unterminated attribute parameter in
6464 subroutine attribute list, Unterminated subroutine attribute list, Value of
6465 CLI symbol "%s" too long, Version number must be a constant number
6466
6467 =item New tests
6468
6469 =item Incompatible Changes
6470
6471 =over 4
6472
6473 =item Perl Source Incompatibilities
6474
6475 CHECK is a new keyword, Treatment of list slices of undef has changed,
6476 Format of $English::PERL_VERSION is different, Literals of the form
6477 C<1.2.3> parse differently, Possibly changed pseudo-random number
6478 generator, Hashing function for hash keys has changed, C<undef> fails on
6479 read only values, Close-on-exec bit may be set on pipe and socket handles,
6480 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6481 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6482 Text of some diagnostic output has changed, C<%@> has been removed,
6483 Parenthesized not() behaves like a list operator, Semantics of bareword
6484 prototype C<(*)> have changed, Semantics of bit operators may have changed
6485 on 64-bit platforms, More builtins taint their results
6486
6487 =item C Source Incompatibilities
6488
6489 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6490
6491 =item Compatible C Source API Changes
6492
6493 C<PATCHLEVEL> is now C<PERL_VERSION>
6494
6495 =item Binary Incompatibilities
6496
6497 =back
6498
6499 =item Known Problems
6500
6501 =over 4
6502
6503 =item Thread test failures
6504
6505 =item EBCDIC platforms not supported
6506
6507 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6508
6509 =item NEXTSTEP 3.3 POSIX test failure
6510
6511 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6512 gcc
6513
6514 =item UNICOS/mk CC failures during Configure run
6515
6516 =item Arrow operator and arrays
6517
6518 =item Experimental features
6519
6520 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6521 pseudo-hash data type, The Compiler suite, Internal implementation of file
6522 globbing, The DB module, The regular expression code constructs:
6523
6524 =back
6525
6526 =item Obsolete Diagnostics
6527
6528 Character class syntax [: :] is reserved for future extensions, Ill-formed
6529 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6530 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6531 to mean "${$}<digit>" is deprecated
6532
6533 =item Reporting Bugs
6534
6535 =item SEE ALSO
6536
6537 =item HISTORY
6538
6539 =back
6540
6541 =head2 perl5005delta - what's new for perl5.005
6542
6543 =over 4
6544
6545 =item DESCRIPTION
6546
6547 =item About the new versioning system
6548
6549 =item Incompatible Changes
6550
6551 =over 4
6552
6553 =item WARNING:  This version is not binary compatible with Perl 5.004.
6554
6555 =item Default installation structure has changed
6556
6557 =item Perl Source Compatibility
6558
6559 =item C Source Compatibility
6560
6561 =item Binary Compatibility
6562
6563 =item Security fixes may affect compatibility
6564
6565 =item Relaxed new mandatory warnings introduced in 5.004
6566
6567 =item Licensing
6568
6569 =back
6570
6571 =item Core Changes
6572
6573 =over 4
6574
6575 =item Threads
6576
6577 =item Compiler
6578
6579 =item Regular Expressions
6580
6581 Many new and improved optimizations, Many bug fixes, New regular expression
6582 constructs, New operator for precompiled regular expressions, Other
6583 improvements, Incompatible changes
6584
6585 =item   Improved malloc()
6586
6587 =item Quicksort is internally implemented
6588
6589 =item Reliable signals
6590
6591 =item Reliable stack pointers
6592
6593 =item More generous treatment of carriage returns
6594
6595 =item Memory leaks
6596
6597 =item Better support for multiple interpreters
6598
6599 =item Behavior of local() on array and hash elements is now well-defined
6600
6601 =item C<%!> is transparently tied to the L<Errno> module
6602
6603 =item Pseudo-hashes are supported
6604
6605 =item C<EXPR foreach EXPR> is supported
6606
6607 =item Keywords can be globally overridden
6608
6609 =item C<$^E> is meaningful on Win32
6610
6611 =item C<foreach (1..1000000)> optimized
6612
6613 =item C<Foo::> can be used as implicitly quoted package name
6614
6615 =item C<exists $Foo::{Bar::}> tests existence of a package
6616
6617 =item Better locale support
6618
6619 =item Experimental support for 64-bit platforms
6620
6621 =item prototype() returns useful results on builtins
6622
6623 =item Extended support for exception handling
6624
6625 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6626
6627 =item All C<printf> format conversions are handled internally
6628
6629 =item New C<INIT> keyword
6630
6631 =item New C<lock> keyword
6632
6633 =item New C<qr//> operator
6634
6635 =item C<our> is now a reserved word
6636
6637 =item Tied arrays are now fully supported
6638
6639 =item Tied handles support is better
6640
6641 =item 4th argument to substr
6642
6643 =item Negative LENGTH argument to splice
6644
6645 =item Magic lvalues are now more magical
6646
6647 =item <> now reads in records
6648
6649 =back
6650
6651 =item Supported Platforms
6652
6653 =over 4
6654
6655 =item New Platforms
6656
6657 =item Changes in existing support
6658
6659 =back
6660
6661 =item Modules and Pragmata
6662
6663 =over 4
6664
6665 =item New Modules
6666
6667 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6668 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6669 Thread, attrs, fields, re
6670
6671 =item Changes in existing modules
6672
6673 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6674 MakeMaker, CPAN, Cwd
6675
6676 =back
6677
6678 =item Utility Changes
6679
6680 =item Documentation Changes
6681
6682 =item New Diagnostics
6683
6684 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6685 while coercing array into hash, Bareword "%s" refers to nonexistent
6686 package, Can't call method "%s" on an undefined value, Can't check
6687 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6688 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6689 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6690 for "%s", Character class syntax [. .] is reserved for future extensions,
6691 Character class syntax [: :] is reserved for future extensions, Character
6692 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6693 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6694 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6695 package main), Illegal hex digit ignored, No such array field, No such
6696 field "%s" in variable %s of type %s, Out of memory during ridiculously
6697 large request, Range iterator outside integer range, Recursive inheritance
6698 detected while looking for method '%s' %s, Reference found where even-sized
6699 list expected, Undefined value assigned to typeglob, Use of reserved word
6700 "%s" is deprecated, perl: warning: Setting locale failed
6701
6702 =item Obsolete Diagnostics
6703
6704 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6705 temporary file, regexp too big
6706
6707 =item Configuration Changes
6708
6709 =item BUGS
6710
6711 =item SEE ALSO
6712
6713 =item HISTORY
6714
6715 =back
6716
6717 =head2 perl5004delta - what's new for perl5.004
6718
6719 =over 4
6720
6721 =item DESCRIPTION
6722
6723 =item Supported Environments
6724
6725 =item Core Changes
6726
6727 =over 4
6728
6729 =item List assignment to %ENV works
6730
6731 =item Change to "Can't locate Foo.pm in @INC" error
6732
6733 =item Compilation option: Binary compatibility with 5.003
6734
6735 =item $PERL5OPT environment variable
6736
6737 =item Limitations on B<-M>, B<-m>, and B<-T> options
6738
6739 =item More precise warnings
6740
6741 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6742
6743 =item Previously deprecated %OVERLOAD is no longer usable
6744
6745 =item Subroutine arguments created only when they're modified
6746
6747 =item Group vector changeable with C<$)>
6748
6749 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6750
6751 =item Fixed localization of $<digit>, $&, etc.
6752
6753 =item No resetting of $. on implicit close
6754
6755 =item C<wantarray> may return undef
6756
6757 =item C<eval EXPR> determines value of EXPR in scalar context
6758
6759 =item Changes to tainting checks
6760
6761 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6762 spawning if tainted $TERM doesn't look like a terminal name
6763
6764 =item New Opcode module and revised Safe module
6765
6766 =item Embedding improvements
6767
6768 =item Internal change: FileHandle class based on IO::* classes
6769
6770 =item Internal change: PerlIO abstraction interface
6771
6772 =item New and changed syntax
6773
6774 $coderef->(PARAMS)
6775
6776 =item New and changed builtin constants
6777
6778 __PACKAGE__
6779
6780 =item New and changed builtin variables
6781
6782 $^E, $^H, $^M
6783
6784 =item New and changed builtin functions
6785
6786 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6787 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6788 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6789 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6790 nested C<sub{}> closures work now, formats work right on changing lexicals
6791
6792 =item New builtin methods
6793
6794 isa(CLASS), can(METHOD), VERSION( [NEED] )
6795
6796 =item TIEHANDLE now supported
6797
6798 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6799 LIST, READLINE this, GETC this, DESTROY this
6800
6801 =item Malloc enhancements
6802
6803 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6804
6805 =item Miscellaneous efficiency enhancements
6806
6807 =back
6808
6809 =item Support for More Operating Systems
6810
6811 =over 4
6812
6813 =item Win32
6814
6815 =item Plan 9
6816
6817 =item QNX
6818
6819 =item AmigaOS
6820
6821 =back
6822
6823 =item Pragmata
6824
6825 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6826 constant NAME => VALUE, use locale, use ops, use vmsish
6827
6828 =item Modules
6829
6830 =over 4
6831
6832 =item Required Updates
6833
6834 =item Installation directories
6835
6836 =item Module information summary
6837
6838 =item Fcntl
6839
6840 =item IO
6841
6842 =item Math::Complex
6843
6844 =item Math::Trig
6845
6846 =item DB_File
6847
6848 =item Net::Ping
6849
6850 =item Object-oriented overrides for builtin operators
6851
6852 =back
6853
6854 =item Utility Changes
6855
6856 =over 4
6857
6858 =item pod2html
6859
6860 Sends converted HTML to standard output
6861
6862 =item xsubpp
6863
6864 C<void> XSUBs now default to returning nothing
6865
6866 =back
6867
6868 =item C Language API Changes
6869
6870 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6871 manipulating hashes
6872
6873 =item Documentation Changes
6874
6875 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6876 L<perlmodlib>, L<perldebug>, L<perlsec>
6877
6878 =item New Diagnostics
6879
6880 "my" variable %s masks earlier declaration in same scope, %s argument is
6881 not a HASH element or slice, Allocation too large: %lx, Allocation too
6882 large, Applying %s to %s will act on scalar(%s), Attempt to free
6883 nonexistent shared string, Attempt to use reference as lvalue in substr,
6884 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6885 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6886 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6887 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6888 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6889 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6890 %s, Integer overflow in hex number, Integer overflow in octal number,
6891 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6892 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6893 possible typo, Null picture in formline, Offset outside string, Out of
6894 memory!, Out of memory during request for %s, panic: frexp, Possible
6895 attempt to put comments in qw() list, Possible attempt to separate words
6896 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6897 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6898 option, untie attempted while %d inner references still exist, Unrecognized
6899 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6900 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6901 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6902 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6903 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6904 long, Process terminated by SIG%s
6905
6906 =item BUGS
6907
6908 =item SEE ALSO
6909
6910 =item HISTORY
6911
6912 =back
6913
6914 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6915
6916 =over 4
6917
6918 =item DESCRIPTION
6919
6920 =over 4
6921
6922 =item Compiling Perl 5 on AIX
6923
6924 =item OS level
6925
6926 =item Building Dynamic Extensions on AIX
6927
6928 =item The IBM ANSI C Compiler
6929
6930 =item Using GNU's gcc for building perl
6931
6932 =item Using Large Files with Perl
6933
6934 =item Threaded Perl
6935
6936 =item 64-bit Perl
6937
6938 =item AIX 4.2 and extensions using C++ with statics
6939
6940 =back
6941
6942 =item AUTHOR
6943
6944 =item DATE
6945
6946 =back
6947
6948 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6949
6950 =over 4
6951
6952 =item DESCRIPTION
6953
6954 =item AUTHOR
6955
6956 =back
6957
6958 =head2 perlamiga - Perl under Amiga OS
6959
6960 =over 4
6961
6962 =item SYNOPSIS
6963
6964 =back
6965
6966 =over 4
6967
6968 =item DESCRIPTION
6969
6970 =over 4
6971
6972 =item Prerequisites for Compiling Perl on AmigaOS
6973
6974 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
6975
6976 =item Starting Perl programs under AmigaOS
6977
6978 =item Shortcomings of Perl under AmigaOS
6979
6980 =back
6981
6982 =item INSTALLATION
6983
6984 =item Accessing documentation
6985
6986 =over 4
6987
6988 =item Manpages for Perl on AmigaOS
6989
6990 =item Perl HTML Documentation on AmigaOS
6991
6992 =item Perl GNU Info Files on AmigaOS
6993
6994 =item Perl LaTeX Documentation on AmigaOS
6995
6996 =back
6997
6998 =item BUILDING PERL ON AMIGAOS
6999
7000 =over 4
7001
7002 =item Build Prerequisites for Perl on AmigaOS
7003
7004 =item Getting the Perl Source for AmigaOS
7005
7006 =item Making Perl on AmigaOS
7007
7008 =item Testing Perl on AmigaOS
7009
7010 =item Installing the built Perl on AmigaOS
7011
7012 =back
7013
7014 =item AUTHORS
7015
7016 =item SEE ALSO
7017
7018 =back
7019
7020 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7021
7022 =over 4
7023
7024 =item DESCRIPTION
7025
7026 =over 4
7027
7028 =item General Issues with Perl on BeOS
7029
7030 =item BeOS Release-specific Notes
7031
7032 R4 x86, R4 PPC
7033
7034 =item Contact Information
7035
7036 =item Update 2002-05-30
7037
7038 =back
7039
7040 =back
7041
7042 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7043
7044 =over 4
7045
7046 =item SYNOPSIS
7047
7048 =item DESCRIPTION
7049
7050 =over 4
7051
7052 =item gzip on BS2000
7053
7054 =item bison on BS2000
7055
7056 =item Unpacking Perl Distribution on BS2000
7057
7058 =item Compiling Perl on BS2000
7059
7060 =item Testing Perl on BS2000
7061
7062 =item Installing Perl on BS2000
7063
7064 =item Using Perl in the Posix-Shell of BS2000
7065
7066 =item Using Perl in "native" BS2000
7067
7068 =item Floating point anomalies on BS2000
7069
7070 =back
7071
7072 =item AUTHORS
7073
7074 =item SEE ALSO
7075
7076 =over 4
7077
7078 =item Mailing list
7079
7080 =back
7081
7082 =item HISTORY
7083
7084 =back
7085
7086 =over 4
7087
7088 =item Name
7089
7090 =item Description
7091
7092 =item Build
7093
7094 =over 4
7095
7096 =item Tools & SDK
7097
7098 =item Make
7099
7100 =back
7101
7102 =item Acknowledgements
7103
7104 =item Author
7105
7106 =back
7107
7108 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7109
7110 =over 4
7111
7112 =item SYNOPSIS
7113
7114 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7115
7116 =over 4
7117
7118 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7119
7120 =item Cygwin Configuration
7121
7122 C<PATH>, I<nroff>, Permissions
7123
7124 =back
7125
7126 =item CONFIGURE PERL ON CYGWIN
7127
7128 =over 4
7129
7130 =item Stripping Perl Binaries on Cygwin
7131
7132 =item Optional Libraries for Perl on Cygwin
7133
7134 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7135 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7136
7137 =item Configure-time Options for Perl on Cygwin
7138
7139 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7140 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7141 C<-Dmksymlinks>
7142
7143 =item Suspicious Warnings on Cygwin
7144
7145 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7146
7147 =back
7148
7149 =item MAKE ON CYGWIN
7150
7151 =over 4
7152
7153 =item Warnings on Cygwin
7154
7155 =item ld2 on Cygwin
7156
7157 =back
7158
7159 =item TEST ON CYGWIN
7160
7161 =over 4
7162
7163 =item File Permissions on Cygwin
7164
7165 =item Script Portability on Cygwin
7166
7167 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7168
7169 =back
7170
7171 =item INSTALL PERL ON CYGWIN
7172
7173 =item MANIFEST ON CYGWIN
7174
7175 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7176 Source, Compiled Module Source, Perl Modules/Scripts
7177
7178 =item BUGS ON CYGWIN
7179
7180 =item AUTHORS
7181
7182 =item HISTORY
7183
7184 =back
7185
7186 =head2 perldgux - Perl under DG/UX.
7187
7188 =over 4
7189
7190 =item SYNOPSIS
7191
7192 =back
7193
7194 =over 4
7195
7196 =item DESCRIPTION
7197
7198 =item BUILDING PERL ON DG/UX
7199
7200 =over 4
7201
7202 =item Non-threaded Perl on DG/UX
7203
7204 =item Threaded Perl on DG/UX
7205
7206 =item Testing Perl on DG/UX
7207
7208 =item Installing the built perl on DG/UX
7209
7210 =back
7211
7212 =item AUTHOR
7213
7214 =item SEE ALSO
7215
7216 =back
7217
7218 =head2 perldos - Perl under DOS, W31, W95.
7219
7220 =over 4
7221
7222 =item SYNOPSIS
7223
7224 =item DESCRIPTION
7225
7226 =over 4
7227
7228 =item Prerequisites for Compiling Perl on DOS
7229
7230 DJGPP, Pthreads
7231
7232 =item Shortcomings of Perl under DOS
7233
7234 =item Building Perl on DOS
7235
7236 =item Testing Perl on DOS
7237
7238 =item Installation of Perl on DOS
7239
7240 =back
7241
7242 =item BUILDING AND INSTALLING MODULES ON DOS
7243
7244 =over 4
7245
7246 =item Building Prerequisites for Perl on DOS
7247
7248 =item Unpacking CPAN Modules on DOS
7249
7250 =item Building Non-XS Modules on DOS
7251
7252 =item Building XS Modules on DOS
7253
7254 =back
7255
7256 =item AUTHOR
7257
7258 =item SEE ALSO
7259
7260 =back
7261
7262 =head2 perlepoc, README.epoc - Perl for EPOC
7263
7264 =over 4
7265
7266 =item SYNOPSIS
7267
7268 =item INTRODUCTION
7269
7270 =item INSTALLING PERL ON EPOC
7271
7272 =item STARTING PERL ON EPOC
7273
7274 =over 4
7275
7276 =item Editors on Epoc
7277
7278 =item Features of Perl on Epoc
7279
7280 =item Restrictions of Perl on Epoc
7281
7282 =item Compiling Perl 5 on the EPOC cross compiling environment
7283
7284 =back
7285
7286 =item SUPPORT STATUS OF PERL ON EPOC
7287
7288 =item AUTHOR
7289
7290 =item LAST UPDATE
7291
7292 =back
7293
7294 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7295 (HP-UX) systems
7296
7297 =over 4
7298
7299 =item DESCRIPTION
7300
7301 =over 4
7302
7303 =item Using perl as shipped with HP-UX
7304
7305 =item Compiling Perl 5 on HP-UX
7306
7307 =item PA-RISC
7308
7309 =item PA-RISC 1.0
7310
7311 =item PA-RISC 1.1
7312
7313 =item PA-RISC 2.0
7314
7315 =item Itanium
7316
7317 =item Portability Between PA-RISC Versions
7318
7319 =item Itanium Processor Family and HP-UX
7320
7321 =item Building Dynamic Extensions on HP-UX
7322
7323 =item The HP ANSI C Compiler
7324
7325 =item The GNU C Compiler
7326
7327 =item Using Large Files with Perl on HP-UX
7328
7329 =item Threaded Perl on HP-UX
7330
7331 =item 64-bit Perl on HP-UX
7332
7333 =item Oracle on HP-UX
7334
7335 =item GDBM and Threads on HP-UX
7336
7337 =item NFS filesystems and utime(2) on HP-UX
7338
7339 =item perl -P and // and HP-UX
7340
7341 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7342
7343 =back
7344
7345 =item nss_delete core dump from op/pwent or op/grent
7346
7347 =item AUTHOR
7348
7349 =item DATE
7350
7351 =back
7352
7353 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7354
7355 =over 4
7356
7357 =item DESCRIPTION
7358
7359 =over 4
7360
7361 =item Known Problems with Perl on Hurd
7362
7363 =back
7364
7365 =item AUTHOR
7366
7367 =back
7368
7369 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7370 systems
7371
7372 =over 4
7373
7374 =item DESCRIPTION
7375
7376 =over 4
7377
7378 =item Compiling Perl 5 on MachTen
7379
7380 =item Failures during C<make test> on MachTen
7381
7382 op/lexassign.t, pragma/warnings.t
7383
7384 =item Building external modules on MachTen
7385
7386 =back
7387
7388 =item AUTHOR
7389
7390 =item DATE
7391
7392 =back
7393
7394 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7395
7396 =over 4
7397
7398 =item SYNOPSIS
7399
7400 =item DESCRIPTION
7401
7402 =item AUTHOR
7403
7404 =item DATE
7405
7406 =back
7407
7408 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7409
7410 =over 4
7411
7412 =item DESCRIPTION
7413
7414 =item Known problems with Perl on MiNT
7415
7416 =item AUTHOR
7417
7418 =back
7419
7420 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7421
7422 =over 4
7423
7424 =item SYNOPSIS
7425
7426 =item NOTE
7427
7428 =item Binary distribution from HP
7429
7430 =item What's New in Perl for MPE/iX
7431
7432 =item Welcome to Perl/iX
7433
7434 =item System Requirements for Perl/iX
7435
7436 =item How to Obtain Perl/iX
7437
7438 =item Perl/iX Distribution Contents Highlights
7439
7440 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7441 public_html/feedback.cgi, src/perl-5.6.0-mpe
7442
7443 =item How to Compile Perl/iX
7444
7445  4,  6
7446
7447 =item Getting Started with Perl/iX
7448
7449 =item MPE/iX Implementation Considerations
7450
7451 =item Known Perl/iX Bugs Under Investigation
7452
7453 =item Perl/iX To-Do List
7454
7455 =item Perl/iX Change History
7456
7457 =item AUTHOR
7458
7459 =item Name
7460
7461 =item Description
7462
7463 =item Build
7464
7465 =over 4
7466
7467 =item Tools & SDK
7468
7469 =item Setup
7470
7471 SetNWDef.bat, Custom Build Environment, Buildtype.bat, SetNWBld.bat
7472
7473 =item Make
7474
7475 =item Interpreter
7476
7477 =item Extensions
7478
7479 =back
7480
7481 =item Install
7482
7483 =item Build new extensions
7484
7485 =item Acknowledgements
7486
7487 =item Authors
7488
7489 =item Date
7490
7491 =back
7492
7493 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7494
7495 =over 4
7496
7497 =item SYNOPSIS
7498
7499 =back
7500
7501 =over 4
7502
7503 =item DESCRIPTION
7504
7505 =over 4
7506
7507 =item Target
7508
7509 =item Other OSes
7510
7511 =item Prerequisites
7512
7513 EMX, RSX, HPFS, pdksh
7514
7515 =item Starting Perl programs under OS/2 (and DOS and...)
7516
7517 =item Starting OS/2 (and DOS) programs under Perl
7518
7519 =back
7520
7521 =item Frequently asked questions
7522
7523 =over 4
7524
7525 =item "It does not work"
7526
7527 =item I cannot run external programs
7528
7529 =item I cannot embed perl into my program, or use F<perl.dll> from my
7530 program.
7531
7532 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7533 L<ExtUtils::Embed>?
7534
7535 =item C<``> and pipe-C<open> do not work under DOS.
7536
7537 =item Cannot start C<find.exe "pattern" file>
7538
7539 =back
7540
7541 =item INSTALLATION
7542
7543 =over 4
7544
7545 =item Automatic binary installation
7546
7547 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7548
7549 =item Manual binary installation
7550
7551 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7552 (statically linked), Executables for Perl utilities, Main Perl library,
7553 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7554 and utilities, Manpages for Perl modules, Source for Perl documentation,
7555 Perl manual in F<.INF> format, Pdksh
7556
7557 =item B<Warning>
7558
7559 =back
7560
7561 =item Accessing documentation
7562
7563 =over 4
7564
7565 =item OS/2 F<.INF> file
7566
7567 =item Plain text
7568
7569 =item Manpages
7570
7571 =item HTML
7572
7573 =item GNU C<info> files
7574
7575 =item F<PDF> files
7576
7577 =item C<LaTeX> docs
7578
7579 =back
7580
7581 =item BUILD
7582
7583 =over 4
7584
7585 =item The short story
7586
7587 =item Prerequisites
7588
7589 =item Getting perl source
7590
7591 =item Application of the patches
7592
7593 =item Hand-editing
7594
7595 =item Making
7596
7597 =item Testing
7598
7599 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7600 F<op/stat.t>
7601
7602 =item Installing the built perl
7603
7604 =item C<a.out>-style build
7605
7606 =back
7607
7608 =item Build FAQ
7609
7610 =over 4
7611
7612 =item Some C</> became C<\> in pdksh.
7613
7614 =item C<'errno'> - unresolved external
7615
7616 =item Problems with tr or sed
7617
7618 =item Some problem (forget which ;-)
7619
7620 =item Library ... not found
7621
7622 =item Segfault in make
7623
7624 =item op/sprintf test failure
7625
7626 =back
7627
7628 =item Specific (mis)features of OS/2 port
7629
7630 =over 4
7631
7632 =item C<setpriority>, C<getpriority>
7633
7634 =item C<system()>
7635
7636 =item C<extproc> on the first line
7637
7638 =item Additional modules:
7639
7640 =item Prebuilt methods:
7641
7642 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7643  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
7644 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
7645 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
7646 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
7647 C<Cwd::extLibpath_set( path [, type ] )>,
7648 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7649 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7650 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7651 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7652 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7653
7654 =item Prebuilt variables:
7655
7656 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7657
7658 =item Misfeatures
7659
7660 =item Modifications
7661
7662 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7663 C<flock>
7664
7665 =item Identifying DLLs
7666
7667 =item Centralized management of resources
7668
7669 C<HAB>, C<HMQ>
7670
7671 =back
7672
7673 =item Perl flavors
7674
7675 =over 4
7676
7677 =item F<perl.exe>
7678
7679 =item F<perl_.exe>
7680
7681 =item F<perl__.exe>
7682
7683 =item F<perl___.exe>
7684
7685 =item Why strange names?
7686
7687 =item Why dynamic linking?
7688
7689 =item Why chimera build?
7690
7691 =back
7692
7693 =item ENVIRONMENT
7694
7695 =over 4
7696
7697 =item C<PERLLIB_PREFIX>
7698
7699 =item C<PERL_BADLANG>
7700
7701 =item C<PERL_BADFREE>
7702
7703 =item C<PERL_SH_DIR>
7704
7705 =item C<USE_PERL_FLOCK>
7706
7707 =item C<TMP> or C<TEMP>
7708
7709 =back
7710
7711 =item Evolution
7712
7713 =over 4
7714
7715 =item Priorities
7716
7717 =item DLL name mangling: pre 5.6.2
7718
7719 =item DLL name mangling: 5.6.2 and beyond
7720
7721 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7722 C<LIBPATH>
7723
7724 =item DLL forwarder generation
7725
7726 =item Threading
7727
7728 =item Calls to external programs
7729
7730 =item Memory allocation
7731
7732 =item Threads
7733
7734 C<COND_WAIT>, F<os2.c>
7735
7736 =back
7737
7738 =item BUGS
7739
7740 =back
7741
7742 =over 4
7743
7744 =item AUTHOR
7745
7746 =item SEE ALSO
7747
7748 =back
7749
7750 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7751 and z/OS
7752
7753 =over 4
7754
7755 =item SYNOPSIS
7756
7757 =item DESCRIPTION
7758
7759 =over 4
7760
7761 =item Tools
7762
7763 =item Unpacking Perl distribution on OS/390
7764
7765 =item Setup and utilities for Perl on OS/390
7766
7767 =item Configure Perl on OS/390
7768
7769 =item Build, Test, Install Perl on OS/390
7770
7771 =item Build Anomalies with Perl on OS/390
7772
7773 =item Testing Anomalies with Perl on OS/390
7774
7775 =item Installation Anomalies with Perl on OS/390
7776
7777 =item Usage Hints for Perl on OS/390
7778
7779 =item Floating Point Anomalies with Perl on OS/390
7780
7781 =item Modules and Extensions for Perl on OS/390
7782
7783 =back
7784
7785 =item AUTHORS
7786
7787 =item SEE ALSO
7788
7789 =over 4
7790
7791 =item Mailing list for Perl on OS/390
7792
7793 =back
7794
7795 =item HISTORY
7796
7797 =back
7798
7799 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7800
7801 =over 4
7802
7803 =item DESCRIPTION
7804
7805 =over 4
7806
7807 =item Required Software for Compiling Perl on QNX4
7808
7809 /bin/sh, ar, nm, cpp, make
7810
7811 =item Outstanding Issues with Perl on QNX4
7812
7813 =item QNX auxiliary files
7814
7815 qnx/ar, qnx/cpp
7816
7817 =item Outstanding issues with perl under QNX6
7818
7819 =back
7820
7821 =item AUTHOR
7822
7823 =back
7824
7825 =head2 perlplan9 - Plan 9-specific documentation for Perl
7826
7827 =over 4
7828
7829 =item DESCRIPTION
7830
7831 =over 4
7832
7833 =item Invoking Perl
7834
7835 =item What's in Plan 9 Perl
7836
7837 =item What's not in Plan 9 Perl
7838
7839 =item Perl5 Functions not currently supported in Plan 9 Perl
7840
7841 =item Signals in Plan 9 Perl
7842
7843 =back
7844
7845 =item COMPILING AND INSTALLING PERL ON PLAN 9
7846
7847 =over 4
7848
7849 =item Installing Perl Documentation on Plan 9
7850
7851 =back
7852
7853 =item BUGS
7854
7855 =item Revision date
7856
7857 =item AUTHOR
7858
7859 =back
7860
7861 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7862
7863 =over 4
7864
7865 =item DESCRIPTION
7866
7867 =over 4
7868
7869 =item Solaris Version Numbers.
7870
7871 =back
7872
7873 =item RESOURCES
7874
7875 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7876
7877 =item SETTING UP
7878
7879 =over 4
7880
7881 =item File Extraction Problems on Solaris.
7882
7883 =item Compiler and Related Tools on Solaris.
7884
7885 =item Environment for Compiling Perl on Solaris
7886
7887 =back
7888
7889 =item RUN CONFIGURE.
7890
7891 =over 4
7892
7893 =item 64-bit Issues with Perl on Solaris.
7894
7895 =item Threads in Perl on Solaris.
7896
7897 =item Malloc Issues with Perl on Solaris.
7898
7899 =back
7900
7901 =item MAKE PROBLEMS.
7902
7903 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
7904 relocation error:, dlopen: stub interception failed, #error "No
7905 DATAMODEL_NATIVE specified", sh: ar: not found
7906
7907 =item MAKE TEST
7908
7909 =over 4
7910
7911 =item op/stat.t test 4 in Solaris
7912
7913 =item nss_delete core dump from op/pwent or op/grent
7914
7915 =back
7916
7917 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
7918
7919 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
7920
7921 =over 4
7922
7923 =item Limits on Numbers of Open Files on Solaris.
7924
7925 =back
7926
7927 =item SOLARIS-SPECIFIC MODULES.
7928
7929 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
7930
7931 =over 4
7932
7933 =item Proc::ProcessTable on Solaris
7934
7935 =item BSD::Resource on Solaris
7936
7937 =item Net::SSLeay on Solaris
7938
7939 =back
7940
7941 =item AUTHOR
7942
7943 =item LAST MODIFIED
7944
7945 =back
7946
7947 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
7948 Digital UNIX formerly known as DEC OSF/1) systems
7949
7950 =over 4
7951
7952 =item DESCRIPTION
7953
7954 =over 4
7955
7956 =item Compiling Perl 5 on Tru64
7957
7958 =item Using Large Files with Perl on Tru64
7959
7960 =item Threaded Perl on Tru64
7961
7962 =item Long Doubles on Tru64
7963
7964 =item 64-bit Perl on Tru64
7965
7966 =item Warnings about floating-point overflow when compiling Perl on Tru64
7967
7968 =back
7969
7970 =item Testing Perl on Tru64
7971
7972 =item ext/ODBM_File/odbm Test Failing With Static Builds
7973
7974 =item Perl Fails Because Of Unresolved Symbol sockatmark
7975
7976 =item AUTHOR
7977
7978 =back
7979
7980 =head2 perluts - Perl under UTS
7981
7982 =over 4
7983
7984 =item SYNOPSIS
7985
7986 =item DESCRIPTION
7987
7988 =item BUILDING PERL ON UTS
7989
7990 =item Installing the built perl on UTS
7991
7992 =item AUTHOR
7993
7994 =back
7995
7996 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
7997
7998 =over 4
7999
8000 =item SYNOPSIS
8001
8002 =item DESCRIPTION
8003
8004 =over 4
8005
8006 =item Unpacking Perl Distribution on VM/ESA
8007
8008 =item Setup Perl and utilities on VM/ESA
8009
8010 =item Configure Perl on VM/ESA
8011
8012 =item Testing Anomalies of Perl on VM/ESA
8013
8014 =item Usage Hints for Perl on VM/ESA
8015
8016 =back
8017
8018 =item AUTHORS
8019
8020 =item SEE ALSO
8021
8022 =over 4
8023
8024 =item Mailing list for Perl on VM/ESA
8025
8026 =back
8027
8028 =back
8029
8030 =head2 perlvms - VMS-specific documentation for Perl
8031
8032 =over 4
8033
8034 =item DESCRIPTION
8035
8036 =item Installation
8037
8038 =item Organization of Perl Images
8039
8040 =over 4
8041
8042 =item Core Images
8043
8044 =item Perl Extensions
8045
8046 =item Installing static extensions
8047
8048 =item Installing dynamic extensions
8049
8050 =back
8051
8052 =item File specifications
8053
8054 =over 4
8055
8056 =item Syntax
8057
8058 =item Wildcard expansion
8059
8060 =item Pipes
8061
8062 =back
8063
8064 =item PERL5LIB and PERLLIB
8065
8066 =item Command line
8067
8068 =over 4
8069
8070 =item I/O redirection and backgrounding
8071
8072 =item Command line switches
8073
8074 -i, -S, -u
8075
8076 =back
8077
8078 =item Perl functions
8079
8080 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8081 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8082 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8083 LIST, waitpid PID,FLAGS
8084
8085 =item Perl variables
8086
8087 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8088
8089 =item Standard modules with VMS-specific differences
8090
8091 =over 4
8092
8093 =item SDBM_File
8094
8095 =back
8096
8097 =item Revision date
8098
8099 =item AUTHOR
8100
8101 =back
8102
8103 =head2 perlvos, README.vos - Perl for Stratus VOS
8104
8105 =over 4
8106
8107 =item SYNOPSIS
8108
8109 =over 4
8110
8111 =item Multiple methods to build perl for VOS
8112
8113 =item Stratus POSIX Support
8114
8115 =back
8116
8117 =item INSTALLING PERL IN VOS
8118
8119 =over 4
8120
8121 =item Compiling Perl 5 on VOS
8122
8123 =item Installing Perl 5 on VOS
8124
8125 =back
8126
8127 =item USING PERL IN VOS
8128
8129 =over 4
8130
8131 =item Unimplemented Features of Perl on VOS
8132
8133 =item Restrictions of Perl on VOS
8134
8135 =item Handling of underflow and overflow
8136
8137 =back
8138
8139 =item TEST STATUS
8140
8141 =item SUPPORT STATUS
8142
8143 =item AUTHOR
8144
8145 =item LAST UPDATE
8146
8147 =back
8148
8149 =head2 perlwin32 - Perl under Windows
8150
8151 =over 4
8152
8153 =item SYNOPSIS
8154
8155 =item DESCRIPTION
8156
8157 =over 4
8158
8159 =item Setting Up Perl on Win32
8160
8161 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8162 SDK 64-bit Compiler, Mingw32 with GCC
8163
8164 =item Building
8165
8166 =item Testing Perl on Win32
8167
8168 =item Installation of Perl on Win32
8169
8170 =item Usage Hints for Perl on Win32
8171
8172 Environment Variables, File Globbing, Using perl from the command line,
8173 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8174 Extensions, Notes on 64-bit Windows, Running Perl Scripts, Miscellaneous
8175 Things
8176
8177 =back
8178
8179 =item BUGS AND CAVEATS
8180
8181 =item AUTHORS
8182
8183 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8184 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8185 E<lt>nick@ing-simmons.netE<gt>
8186
8187 =item SEE ALSO
8188
8189 =item HISTORY
8190
8191 =back
8192
8193 =head1 PRAGMA DOCUMENTATION
8194
8195 =head2 attrs - set/get attributes of a subroutine (deprecated)
8196
8197 =over 4
8198
8199 =item SYNOPSIS
8200
8201 =item DESCRIPTION
8202
8203 method, locked
8204
8205 =back
8206
8207 =head2 re - Perl pragma to alter regular expression behaviour
8208
8209 =over 4
8210
8211 =item SYNOPSIS
8212
8213 =item DESCRIPTION
8214
8215 =back
8216
8217 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8218
8219 =over 4
8220
8221 =item SYNOPSIS
8222
8223 =item DESCRIPTION
8224
8225 =item FUNCTIONS AND METHODS
8226
8227 new, enqueue LIST, dequeue, dequeue_nb, pending
8228
8229 =item SEE ALSO
8230
8231 =back
8232
8233 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8234 semaphores
8235
8236 =over 4
8237
8238 =item SYNOPSIS
8239
8240 =item DESCRIPTION
8241
8242 =item FUNCTIONS AND METHODS
8243
8244 new, new NUMBER, down, down NUMBER, up, up NUMBER
8245
8246 =back
8247
8248 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8249 data structures between threads
8250
8251 =over 4
8252
8253 =item SYNOPSIS
8254
8255 =item DESCRIPTION
8256
8257 =item EXPORT
8258
8259 =item FUNCTIONS
8260
8261 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8262 cond_broadcast VARIABLE
8263
8264 =item NOTES
8265
8266 =item BUGS
8267
8268 =item AUTHOR
8269
8270 =item SEE ALSO
8271
8272 =back
8273
8274 =head2 threads - Perl extension allowing use of interpreter based threads
8275 from perl
8276
8277 =over 4
8278
8279 =item SYNOPSIS
8280
8281 =item DESCRIPTION
8282
8283 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8284 threads->self, $thread->tid, threads->yield();, threads->list();, async
8285 BLOCK;
8286
8287 =item WARNINGS
8288
8289 A thread exited while %d other threads were still running
8290
8291 =item BUGS / TODO
8292
8293 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8294 not threadsafe, will not be
8295
8296 =item AUTHOR and COPYRIGHT
8297
8298 =item SEE ALSO
8299
8300 =back
8301
8302 =head2 attributes - get/set subroutine or variable attributes
8303
8304 =over 4
8305
8306 =item SYNOPSIS
8307
8308 =item DESCRIPTION
8309
8310 =over 4
8311
8312 =item Built-in Attributes
8313
8314 locked, method, lvalue
8315
8316 =item Available Subroutines
8317
8318 get, reftype
8319
8320 =item Package-specific Attribute Handling
8321
8322 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8323
8324 =item Syntax of Attribute Lists
8325
8326 =back
8327
8328 =item EXPORTS
8329
8330 =over 4
8331
8332 =item Default exports
8333
8334 =item Available exports
8335
8336 =item Export tags defined
8337
8338 =back
8339
8340 =item EXAMPLES
8341
8342 =item SEE ALSO
8343
8344 =back
8345
8346 =head2 attrs - set/get attributes of a subroutine (deprecated)
8347
8348 =over 4
8349
8350 =item SYNOPSIS
8351
8352 =item DESCRIPTION
8353
8354 method, locked
8355
8356 =back
8357
8358 =head2 autouse - postpone load of modules until a function is used
8359
8360 =over 4
8361
8362 =item SYNOPSIS
8363
8364 =item DESCRIPTION
8365
8366 =item WARNING
8367
8368 =item AUTHOR
8369
8370 =item SEE ALSO
8371
8372 =back
8373
8374 =head2 base - Establish IS-A relationship with base class at compile time
8375
8376 =over 4
8377
8378 =item SYNOPSIS
8379
8380 =item DESCRIPTION
8381
8382 =item HISTORY
8383
8384 =item SEE ALSO
8385
8386 =back
8387
8388 =head2 bigint - Transparent big integer support for Perl
8389
8390 =over 4
8391
8392 =item SYNOPSIS
8393
8394 =item DESCRIPTION
8395
8396 =over 4
8397
8398 =item OPTIONS
8399
8400 a or accuracy, p or precision, t or trace, l or lib, v or version
8401
8402 =item MATH LIBRARY
8403
8404 =item INTERNAL FORMAT
8405
8406 =item SIGN
8407
8408 =item METHODS
8409
8410 =back
8411
8412 =item MODULES USED
8413
8414 =item EXAMPLES
8415
8416 =item LICENSE
8417
8418 =item SEE ALSO
8419
8420 =item AUTHORS
8421
8422 =back
8423
8424 =head2 bignum - Transparent BigNumber support for Perl
8425
8426 =over 4
8427
8428 =item SYNOPSIS
8429
8430 =item DESCRIPTION
8431
8432 =over 4
8433
8434 =item OPTIONS
8435
8436 a or accuracy, p or precision, t or trace, l or lib, v or version
8437
8438 =item MATH LIBRARY
8439
8440 =item INTERNAL FORMAT
8441
8442 =item SIGN
8443
8444 =item METHODS
8445
8446 =back
8447
8448 =item MODULES USED
8449
8450 =item EXAMPLES
8451
8452 =item LICENSE
8453
8454 =item SEE ALSO
8455
8456 =item AUTHORS
8457
8458 =back
8459
8460 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8461
8462 =over 4
8463
8464 =item SYNOPSIS
8465
8466 =item DESCRIPTION
8467
8468 =over 4
8469
8470 =item MODULES USED
8471
8472 =item MATH LIBRARY
8473
8474 =item SIGN
8475
8476 =item METHODS
8477
8478 =back
8479
8480 =item EXAMPLES
8481
8482         perl -Mbigrat -le 'print sqrt(33)'
8483         perl -Mbigrat -le 'print 2*255'
8484         perl -Mbigrat -le 'print 4.5+2*255'
8485         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8486         perl -Mbigrat -le 'print 12->is_odd()';
8487
8488 =item LICENSE
8489
8490 =item SEE ALSO
8491
8492 =item AUTHORS
8493
8494 =back
8495
8496 =head2 blib - Use MakeMaker's uninstalled version of a package
8497
8498 =over 4
8499
8500 =item SYNOPSIS
8501
8502 =item DESCRIPTION
8503
8504 =item BUGS
8505
8506 =item AUTHOR
8507
8508 =back
8509
8510 =head2 bytes - Perl pragma to force byte semantics rather than character
8511 semantics
8512
8513 =over 4
8514
8515 =item SYNOPSIS
8516
8517 =item DESCRIPTION
8518
8519 =item SEE ALSO
8520
8521 =back
8522
8523 =head2 charnames - define character names for C<\N{named}> string literal
8524 escapes
8525
8526 =over 4
8527
8528 =item SYNOPSIS
8529
8530 =item DESCRIPTION
8531
8532 =item CUSTOM TRANSLATORS
8533
8534 =item charnames::viacode(code)
8535
8536 =item charnames::vianame(name)
8537
8538 =item ALIASES
8539
8540 =item ILLEGAL CHARACTERS
8541
8542 =item BUGS
8543
8544 =back
8545
8546 =head2 constant - Perl pragma to declare constants
8547
8548 =over 4
8549
8550 =item SYNOPSIS
8551
8552 =item DESCRIPTION
8553
8554 =item NOTES
8555
8556 =over 4
8557
8558 =item List constants
8559
8560 =item Defining multiple constants at once
8561
8562 =item Magic constants
8563
8564 =back
8565
8566 =item TECHNICAL NOTES
8567
8568 =item BUGS
8569
8570 =item AUTHOR
8571
8572 =item COPYRIGHT
8573
8574 =back
8575
8576 =head2 diagnostics - Perl compiler pragma to force verbose warning
8577 diagnostics
8578
8579 =over 4
8580
8581 =item SYNOPSIS
8582
8583 =item DESCRIPTION
8584
8585 =over 4
8586
8587 =item The C<diagnostics> Pragma
8588
8589 =item The I<splain> Program
8590
8591 =back
8592
8593 =item EXAMPLES
8594
8595 =item INTERNALS
8596
8597 =item BUGS
8598
8599 =item AUTHOR
8600
8601 =back
8602
8603 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8604
8605 =over 4
8606
8607 =item SYNOPSIS
8608
8609 =item ABSTRACT
8610
8611 =item USAGE
8612
8613 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8614 I<ENCNAME_IN> ...] ;, no encoding;
8615
8616 =item CAVEATS
8617
8618 =over 4
8619
8620 =item NOT SCOPED
8621
8622 =item DO NOT MIX MULTIPLE ENCODINGS
8623
8624 =back
8625
8626 =item Non-ASCII Identifiers and Filter option
8627
8628 use encoding I<ENCNAME> Filter=E<gt>1;
8629
8630 =item EXAMPLE - Greekperl
8631
8632 =item KNOWN PROBLEMS
8633
8634 =item SEE ALSO
8635
8636 =back
8637
8638 =head2 fields - compile-time class fields
8639
8640 =over 4
8641
8642 =item SYNOPSIS
8643
8644 =item DESCRIPTION
8645
8646 new, phash
8647
8648 =item SEE ALSO
8649
8650 =back
8651
8652 =head2 filetest - Perl pragma to control the filetest permission operators
8653
8654 =over 4
8655
8656 =item SYNOPSIS
8657
8658 =item DESCRIPTION
8659
8660 =over 4
8661
8662 =item subpragma access
8663
8664 =back
8665
8666 =back
8667
8668 =head2 if - C<use> a Perl module if a condition holds
8669
8670 =over 4
8671
8672 =item SYNOPSIS
8673
8674 =item DESCRIPTION
8675
8676 =item BUGS
8677
8678 =item AUTHOR
8679
8680 =back
8681
8682 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8683 point
8684
8685 =over 4
8686
8687 =item SYNOPSIS
8688
8689 =item DESCRIPTION
8690
8691 =back
8692
8693 =head2 less - perl pragma to request less of something from the compiler
8694
8695 =over 4
8696
8697 =item SYNOPSIS
8698
8699 =item DESCRIPTION
8700
8701 =back
8702
8703 =head2 lib - manipulate @INC at compile time
8704
8705 =over 4
8706
8707 =item SYNOPSIS
8708
8709 =item DESCRIPTION
8710
8711 =over 4
8712
8713 =item Adding directories to @INC
8714
8715 =item Deleting directories from @INC
8716
8717 =item Restoring original @INC
8718
8719 =back
8720
8721 =item CAVEATS
8722
8723 =item SEE ALSO
8724
8725 =item AUTHOR
8726
8727 =back
8728
8729 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8730 operations
8731
8732 =over 4
8733
8734 =item SYNOPSIS
8735
8736 =item DESCRIPTION
8737
8738 =back
8739
8740 =head2 open - perl pragma to set default disciplines for input and output
8741
8742 =over 4
8743
8744 =item SYNOPSIS
8745
8746 =item DESCRIPTION
8747
8748 =item NONPERLIO FUNCTIONALITY
8749
8750 =item IMPLEMENTATION DETAILS
8751
8752 =item SEE ALSO
8753
8754 =back
8755
8756 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8757
8758 =over 4
8759
8760 =item SYNOPSIS
8761
8762 =item DESCRIPTION
8763
8764 =item SEE ALSO
8765
8766 =back
8767
8768 =head2 overload - Package for overloading perl operations
8769
8770 =over 4
8771
8772 =item SYNOPSIS
8773
8774 =item DESCRIPTION
8775
8776 =over 4
8777
8778 =item Declaration of overloaded functions
8779
8780 =item Calling Conventions for Binary Operations
8781
8782 FALSE, TRUE, C<undef>
8783
8784 =item Calling Conventions for Unary Operations
8785
8786 =item Calling Conventions for Mutators
8787
8788 C<++> and C<-->, C<x=> and other assignment versions
8789
8790 =item Overloadable Operations
8791
8792 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8793 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8794 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8795
8796 =item Inheritance and overloading
8797
8798 Strings as values of C<use overload> directive, Overloading of an operation
8799 is inherited by derived classes
8800
8801 =back
8802
8803 =item SPECIAL SYMBOLS FOR C<use overload>
8804
8805 =over 4
8806
8807 =item Last Resort
8808
8809 =item Fallback
8810
8811 C<undef>, TRUE, defined, but FALSE
8812
8813 =item Copy Constructor
8814
8815 B<Example>
8816
8817 =back
8818
8819 =item MAGIC AUTOGENERATION
8820
8821 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8822 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8823 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8824 I<Copy operator>
8825
8826 =item Losing overloading
8827
8828 =item Run-time Overloading
8829
8830 =item Public functions
8831
8832 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8833
8834 =item Overloading constants
8835
8836 integer, float, binary, q, qr
8837
8838 =item IMPLEMENTATION
8839
8840 =item Metaphor clash
8841
8842 =item Cookbook
8843
8844 =over 4
8845
8846 =item Two-face scalars
8847
8848 =item Two-face references
8849
8850 =item Symbolic calculator
8851
8852 =item I<Really> symbolic calculator
8853
8854 =back
8855
8856 =item AUTHOR
8857
8858 =item DIAGNOSTICS
8859
8860 Odd number of arguments for overload::constant, `%s' is not an overloadable
8861 type, `%s' is not a code reference
8862
8863 =item BUGS
8864
8865 =back
8866
8867 =head2 re - Perl pragma to alter regular expression behaviour
8868
8869 =over 4
8870
8871 =item SYNOPSIS
8872
8873 =item DESCRIPTION
8874
8875 =back
8876
8877 =head2 sigtrap - Perl pragma to enable simple signal handling
8878
8879 =over 4
8880
8881 =item SYNOPSIS
8882
8883 =item DESCRIPTION
8884
8885 =item OPTIONS
8886
8887 =over 4
8888
8889 =item SIGNAL HANDLERS
8890
8891 B<stack-trace>, B<die>, B<handler> I<your-handler>
8892
8893 =item SIGNAL LISTS
8894
8895 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8896
8897 =item OTHER
8898
8899 B<untrapped>, B<any>, I<signal>, I<number>
8900
8901 =back
8902
8903 =item EXAMPLES
8904
8905 =back
8906
8907 =head2 sort - perl pragma to control sort() behaviour
8908
8909 =over 4
8910
8911 =item SYNOPSIS
8912
8913 =item DESCRIPTION
8914
8915 =item CAVEATS
8916
8917 =back
8918
8919 =head2 strict - Perl pragma to restrict unsafe constructs
8920
8921 =over 4
8922
8923 =item SYNOPSIS
8924
8925 =item DESCRIPTION
8926
8927 C<strict refs>, C<strict vars>, C<strict subs>
8928
8929 =back
8930
8931 =head2 subs - Perl pragma to predeclare sub names
8932
8933 =over 4
8934
8935 =item SYNOPSIS
8936
8937 =item DESCRIPTION
8938
8939 =back
8940
8941 =head2 threads - Perl extension allowing use of interpreter based threads
8942 from perl
8943
8944 =over 4
8945
8946 =item SYNOPSIS
8947
8948 =item DESCRIPTION
8949
8950 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8951 threads->self, $thread->tid, threads->yield();, threads->list();, async
8952 BLOCK;
8953
8954 =item WARNINGS
8955
8956 A thread exited while %d other threads were still running
8957
8958 =item BUGS / TODO
8959
8960 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8961 not threadsafe, will not be
8962
8963 =item AUTHOR and COPYRIGHT
8964
8965 =item SEE ALSO
8966
8967 =back
8968
8969 =head2 threadshared, threads::shared - Perl extension for sharing data
8970 structures between threads
8971
8972 =over 4
8973
8974 =item SYNOPSIS
8975
8976 =item DESCRIPTION
8977
8978 =item EXPORT
8979
8980 =item FUNCTIONS
8981
8982 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8983 cond_broadcast VARIABLE
8984
8985 =item NOTES
8986
8987 =item BUGS
8988
8989 =item AUTHOR
8990
8991 =item SEE ALSO
8992
8993 =back
8994
8995 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8996
8997 =over 4
8998
8999 =item SYNOPSIS
9000
9001 =item DESCRIPTION
9002
9003 =item FUNCTIONS AND METHODS
9004
9005 new, enqueue LIST, dequeue, dequeue_nb, pending
9006
9007 =item SEE ALSO
9008
9009 =back
9010
9011 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
9012 semaphores
9013
9014 =over 4
9015
9016 =item SYNOPSIS
9017
9018 =item DESCRIPTION
9019
9020 =item FUNCTIONS AND METHODS
9021
9022 new, new NUMBER, down, down NUMBER, up, up NUMBER
9023
9024 =back
9025
9026 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9027 code
9028
9029 =over 4
9030
9031 =item SYNOPSIS
9032
9033 =item DESCRIPTION
9034
9035 =over 4
9036
9037 =item Utility functions
9038
9039 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9040 utf8::encode($string), $flag = utf8::decode($string), $flag =
9041 utf8::valid(STRING)
9042
9043 =back
9044
9045 =item SEE ALSO
9046
9047 =back
9048
9049 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9050
9051 =over 4
9052
9053 =item SYNOPSIS
9054
9055 =item DESCRIPTION
9056
9057 =back
9058
9059 =head2 vmsish - Perl pragma to control VMS-specific language features
9060
9061 =over 4
9062
9063 =item SYNOPSIS
9064
9065 =item DESCRIPTION
9066
9067 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9068
9069 =back
9070
9071 =head2 warnings - Perl pragma to control optional warnings
9072
9073 =over 4
9074
9075 =item SYNOPSIS
9076
9077 =item DESCRIPTION
9078
9079 use warnings::register, warnings::enabled(), warnings::enabled($category),
9080 warnings::enabled($object), warnings::warn($message),
9081 warnings::warn($category, $message), warnings::warn($object, $message),
9082 warnings::warnif($message), warnings::warnif($category, $message),
9083 warnings::warnif($object, $message)
9084
9085 =back
9086
9087 =head2 warnings::register - warnings import function
9088
9089 =over 4
9090
9091 =item SYNOPSIS
9092
9093 =item DESCRIPTION
9094
9095 =back
9096
9097 =head1 MODULE DOCUMENTATION
9098
9099 =head2 AnyDBM_File - provide framework for multiple DBMs
9100
9101 =over 4
9102
9103 =item SYNOPSIS
9104
9105 =item DESCRIPTION
9106
9107 =over 4
9108
9109 =item DBM Comparisons
9110
9111 [0], [1], [2], [3]
9112
9113 =back
9114
9115 =item SEE ALSO
9116
9117 =back
9118
9119 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9120
9121 =over 4
9122
9123 =item VERSION
9124
9125 =item SYNOPSIS
9126
9127 =item DESCRIPTION
9128
9129 [0], [1], [2], [3], [4], [5]
9130
9131 =over 4
9132
9133 =item Typed lexicals
9134
9135 =item Type-specific attribute handlers
9136
9137 =item Non-interpretive attribute handlers
9138
9139 =item Phase-specific attribute handlers
9140
9141 =item Attributes as C<tie> interfaces
9142
9143 =back
9144
9145 =item EXAMPLES
9146
9147 =item DIAGNOSTICS
9148
9149 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9150 attributes>, C<Declaration of %s attribute in package %s may clash with
9151 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9152 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9153 be able to apply END handler>
9154
9155 =item AUTHOR
9156
9157 =item BUGS
9158
9159 =item COPYRIGHT
9160
9161 =back
9162
9163 =head2 AutoLoader - load subroutines only on demand
9164
9165 =over 4
9166
9167 =item SYNOPSIS
9168
9169 =item DESCRIPTION
9170
9171 =over 4
9172
9173 =item Subroutine Stubs
9174
9175 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9176
9177 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9178
9179 =item Package Lexicals
9180
9181 =item Not Using AutoLoader
9182
9183 =item B<AutoLoader> vs. B<SelfLoader>
9184
9185 =back
9186
9187 =item CAVEATS
9188
9189 =item SEE ALSO
9190
9191 =back
9192
9193 =head2 AutoSplit - split a package for autoloading
9194
9195 =over 4
9196
9197 =item SYNOPSIS
9198
9199 =item DESCRIPTION
9200
9201 $keep, $check, $modtime
9202
9203 =over 4
9204
9205 =item Multiple packages
9206
9207 =back
9208
9209 =item DIAGNOSTICS
9210
9211 =back
9212
9213 =head2 B - The Perl Compiler
9214
9215 =over 4
9216
9217 =item SYNOPSIS
9218
9219 =item DESCRIPTION
9220
9221 =item OVERVIEW OF CLASSES
9222
9223 =over 4
9224
9225 =item SV-RELATED CLASSES
9226
9227 =item B::SV METHODS
9228
9229 REFCNT, FLAGS
9230
9231 =item B::IV METHODS
9232
9233 IV, IVX, UVX, int_value, needs64bits, packiv
9234
9235 =item B::NV METHODS
9236
9237 NV, NVX
9238
9239 =item B::RV METHODS
9240
9241 RV
9242
9243 =item B::PV METHODS
9244
9245 PV, RV, PVX
9246
9247 =item B::PVMG METHODS
9248
9249 MAGIC, SvSTASH
9250
9251 =item B::MAGIC METHODS
9252
9253 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9254
9255 =item B::PVLV METHODS
9256
9257 TARGOFF, TARGLEN, TYPE, TARG
9258
9259 =item B::BM METHODS
9260
9261 USEFUL, PREVIOUS, RARE, TABLE
9262
9263 =item B::GV METHODS
9264
9265 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9266 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9267
9268 =item B::IO METHODS
9269
9270 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9271 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9272
9273 =item B::AV METHODS
9274
9275 FILL, MAX, OFF, ARRAY, AvFLAGS
9276
9277 =item B::CV METHODS
9278
9279 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9280 CvFLAGS, const_sv
9281
9282 =item B::HV METHODS
9283
9284 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9285
9286 =item OP-RELATED CLASSES
9287
9288 =item B::OP METHODS
9289
9290 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9291
9292 =item B::UNOP METHOD
9293
9294 first
9295
9296 =item B::BINOP METHOD
9297
9298 last
9299
9300 =item B::LOGOP METHOD
9301
9302 other
9303
9304 =item B::LISTOP METHOD
9305
9306 children
9307
9308 =item B::PMOP METHODS
9309
9310 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9311 pmpermflags, precomp, pmoffet
9312
9313 =item B::SVOP METHOD
9314
9315 sv, gv
9316
9317 =item B::PADOP METHOD
9318
9319 padix
9320
9321 =item B::PVOP METHOD
9322
9323 pv
9324
9325 =item B::LOOP METHODS
9326
9327 redoop, nextop, lastop
9328
9329 =item B::COP METHODS
9330
9331 label, stash, file, cop_seq, arybase, line
9332
9333 =back
9334
9335 =item FUNCTIONS EXPORTED BY C<B>
9336
9337 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9338 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9339 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9340 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9341 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9342
9343 =item AUTHOR
9344
9345 =back
9346
9347 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9348 bytecode
9349
9350 =over 4
9351
9352 =item SYNOPSIS
9353
9354 =item DESCRIPTION
9355
9356 %insn_data, @insn_name, @optype, @specialsv_name
9357
9358 =item AUTHOR
9359
9360 =back
9361
9362 =head2 B::Assembler - Assemble Perl bytecode
9363
9364 =over 4
9365
9366 =item SYNOPSIS
9367
9368 =item DESCRIPTION
9369
9370 =item AUTHORS
9371
9372 =back
9373
9374 =head2 B::Bblock - Walk basic blocks
9375
9376 =over 4
9377
9378 =item SYNOPSIS
9379
9380 =item DESCRIPTION
9381
9382 =over 4
9383
9384 =item Functions
9385
9386 B<find_leaders>
9387
9388 =back
9389
9390 =item AUTHOR
9391
9392 =back
9393
9394 =head2 B::Bytecode - Perl compiler's bytecode backend
9395
9396 =over 4
9397
9398 =item SYNOPSIS
9399
9400 =item DESCRIPTION
9401
9402 =item OPTIONS
9403
9404 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9405 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9406 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9407
9408 =item EXAMPLES
9409
9410 =item BUGS
9411
9412 =item AUTHORS
9413
9414 =back
9415
9416 =head2 B::C - Perl compiler's C backend
9417
9418 =over 4
9419
9420 =item SYNOPSIS
9421
9422 =item DESCRIPTION
9423
9424 =item OPTIONS
9425
9426 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9427 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9428 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9429 B<-llimit>
9430
9431 =item EXAMPLES
9432
9433 =item BUGS
9434
9435 =item AUTHOR
9436
9437 =back
9438
9439 =head2 B::CC - Perl compiler's optimized C translation backend
9440
9441 =over 4
9442
9443 =item SYNOPSIS
9444
9445 =item DESCRIPTION
9446
9447 =item OPTIONS
9448
9449 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9450 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9451 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9452
9453 =item EXAMPLES
9454
9455 =item BUGS
9456
9457 =item DIFFERENCES
9458
9459 =over 4
9460
9461 =item Loops
9462
9463 =item Context of ".."
9464
9465 =item Arithmetic
9466
9467 =item Deprecated features
9468
9469 =back
9470
9471 =item AUTHOR
9472
9473 =back
9474
9475 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9476
9477 =over 4
9478
9479 =item SYNOPSIS
9480
9481 =item DESCRIPTION
9482
9483 =item EXAMPLE
9484
9485 =item OPTIONS
9486
9487 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9488 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9489 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9490
9491 =item FORMATTING SPECIFICATIONS
9492
9493 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9494 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9495 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9496 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9497 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9498 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9499 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9500 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9501
9502 =item ABBREVIATIONS
9503
9504 =over 4
9505
9506 =item OP flags abbreviations
9507
9508 =item OP class abbreviations
9509
9510 =back
9511
9512 =item Using B::Concise outside of the O framework
9513
9514 =item AUTHOR
9515
9516 =back
9517
9518 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9519
9520 =over 4
9521
9522 =item SYNOPSIS
9523
9524 =item DESCRIPTION
9525
9526 =item AUTHOR
9527
9528 =back
9529
9530 =head2 B::Deparse - Perl compiler backend to produce perl code
9531
9532 =over 4
9533
9534 =item SYNOPSIS
9535
9536 =item DESCRIPTION
9537
9538 =item OPTIONS
9539
9540 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9541 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9542
9543 =item USING B::Deparse AS A MODULE
9544
9545 =over 4
9546
9547 =item Synopsis
9548
9549 =item Description
9550
9551 =item new
9552
9553 =item ambient_pragmas
9554
9555 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9556
9557 =item coderef2text
9558
9559 =back
9560
9561 =item BUGS
9562
9563 =item AUTHOR
9564
9565 =back
9566
9567 =head2 B::Disassembler - Disassemble Perl bytecode
9568
9569 =over 4
9570
9571 =item SYNOPSIS
9572
9573 =item DESCRIPTION
9574
9575 =item AUTHOR
9576
9577 =back
9578
9579 =head2 B::Lint - Perl lint
9580
9581 =over 4
9582
9583 =item SYNOPSIS
9584
9585 =item DESCRIPTION
9586
9587 =item OPTIONS AND LINT CHECKS
9588
9589 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9590 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9591
9592 =item NON LINT-CHECK OPTIONS
9593
9594 B<-u Package>
9595
9596 =item BUGS
9597
9598 =item AUTHOR
9599
9600 =back
9601
9602 =head2 B::O, O - Generic interface to Perl Compiler backends
9603
9604 =over 4
9605
9606 =item SYNOPSIS
9607
9608 =item DESCRIPTION
9609
9610 =item CONVENTIONS
9611
9612 =item IMPLEMENTATION
9613
9614 =item BUGS
9615
9616 =item AUTHOR
9617
9618 =back
9619
9620 =head2 B::Showlex - Show lexical variables used in functions or files
9621
9622 =over 4
9623
9624 =item SYNOPSIS
9625
9626 =item DESCRIPTION
9627
9628 =item AUTHOR
9629
9630 =back
9631
9632 =head2 B::Stackobj - Helper module for CC backend
9633
9634 =over 4
9635
9636 =item SYNOPSIS
9637
9638 =item DESCRIPTION
9639
9640 =item AUTHOR
9641
9642 =back
9643
9644 =head2 B::Stash - show what stashes are loaded
9645
9646 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9647
9648 =over 4
9649
9650 =item SYNOPSIS
9651
9652 =item DESCRIPTION
9653
9654 =item AUTHOR
9655
9656 =back
9657
9658 =head2 B::Xref - Generates cross reference reports for Perl programs
9659
9660 =over 4
9661
9662 =item SYNOPSIS
9663
9664 =item DESCRIPTION
9665
9666 =item OPTIONS
9667
9668 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9669
9670 =item BUGS
9671
9672 =item AUTHOR
9673
9674 =back
9675
9676 =head2 Bblock, B::Bblock - Walk basic blocks
9677
9678 =over 4
9679
9680 =item SYNOPSIS
9681
9682 =item DESCRIPTION
9683
9684 =over 4
9685
9686 =item Functions
9687
9688 B<find_leaders>
9689
9690 =back
9691
9692 =item AUTHOR
9693
9694 =back
9695
9696 =head2 Benchmark - benchmark running times of Perl code
9697
9698 =over 4
9699
9700 =item SYNOPSIS
9701
9702 =item DESCRIPTION
9703
9704 =over 4
9705
9706 =item Methods
9707
9708 new, debug, iters
9709
9710 =item Standard Exports
9711
9712 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9713 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9714 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9715
9716 =item Optional Exports
9717
9718 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9719 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9720 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9721
9722 =back
9723
9724 =item NOTES
9725
9726 =item EXAMPLES
9727
9728 =item INHERITANCE
9729
9730 =item CAVEATS
9731
9732 =item SEE ALSO
9733
9734 =item AUTHORS
9735
9736 =item MODIFICATION HISTORY
9737
9738 =back
9739
9740 =head2 ByteLoader - load byte compiled perl code
9741
9742 =over 4
9743
9744 =item SYNOPSIS
9745
9746 =item DESCRIPTION
9747
9748 =item AUTHOR
9749
9750 =item SEE ALSO
9751
9752 =back
9753
9754 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9755
9756 =over 4
9757
9758 =item SYNOPSIS
9759
9760 =item DESCRIPTION
9761
9762 =item OPTIONS
9763
9764 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9765 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9766 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9767
9768 =item EXAMPLES
9769
9770 =item BUGS
9771
9772 =item AUTHORS
9773
9774 =back
9775
9776 =head2 CGI - Simple Common Gateway Interface Class
9777
9778 =over 4
9779
9780 =item SYNOPSIS
9781
9782 =item ABSTRACT
9783
9784 =item DESCRIPTION
9785
9786 =over 4
9787
9788 =item PROGRAMMING STYLE
9789
9790 =item CALLING CGI.PM ROUTINES
9791
9792 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9793
9794 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9795
9796 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9797
9798 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9799
9800 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9801
9802 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9803
9804 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9805
9806 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9807
9808 =item DELETING A PARAMETER COMPLETELY:
9809
9810 =item DELETING ALL PARAMETERS:
9811
9812 =item DIRECT ACCESS TO THE PARAMETER LIST:
9813
9814 =item FETCHING THE PARAMETER LIST AS A HASH:
9815
9816 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9817
9818 =item RETRIEVING CGI ERRORS
9819
9820 =item USING THE FUNCTION-ORIENTED INTERFACE
9821
9822 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9823 B<:standard>, B<:all>
9824
9825 =item PRAGMAS
9826
9827 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9828 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9829 -private_tempfiles
9830
9831 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9832
9833 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9834 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9835 a </ul> tag)
9836
9837 =back
9838
9839 =item GENERATING DYNAMIC DOCUMENTS
9840
9841 =over 4
9842
9843 =item CREATING A STANDARD HTTP HEADER:
9844
9845 =item GENERATING A REDIRECTION HEADER
9846
9847 =item CREATING THE HTML DOCUMENT HEADER
9848
9849 B<Parameters:>, 4, 5, 6..
9850
9851 =item ENDING THE HTML DOCUMENT:
9852
9853 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9854
9855 =item OBTAINING THE SCRIPT'S URL
9856
9857 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9858 (B<-query_string>), B<-base>
9859
9860 =item MIXING POST AND URL PARAMETERS
9861
9862 =back
9863
9864 =item CREATING STANDARD HTML ELEMENTS:
9865
9866 =over 4
9867
9868 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9869
9870 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9871
9872 =item HTML SHORTCUTS AND LIST INTERPOLATION
9873
9874 =item NON-STANDARD HTML SHORTCUTS
9875
9876 =item AUTOESCAPING HTML
9877
9878 $escaped_string = escapeHTML("unescaped string");, $charset =
9879 charset([$charset]);, $flag = autoEscape([$flag]);
9880
9881 =item PRETTY-PRINTING HTML
9882
9883 =back
9884
9885 =item CREATING FILL-OUT FORMS:
9886
9887 =over 4
9888
9889 =item CREATING AN ISINDEX TAG
9890
9891 =item STARTING AND ENDING A FORM
9892
9893 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9894
9895 =item CREATING A TEXT FIELD
9896
9897 B<Parameters>
9898
9899 =item CREATING A BIG TEXT FIELD
9900
9901 =item CREATING A PASSWORD FIELD
9902
9903 =item CREATING A FILE UPLOAD FIELD
9904
9905 B<Parameters>
9906
9907 =item CREATING A POPUP MENU
9908
9909 =item CREATING A SCROLLING LIST
9910
9911 B<Parameters:>
9912
9913 =item CREATING A GROUP OF RELATED CHECKBOXES
9914
9915 B<Parameters:>
9916
9917 =item CREATING A STANDALONE CHECKBOX
9918
9919 B<Parameters:>
9920
9921 =item CREATING A RADIO BUTTON GROUP
9922
9923 B<Parameters:>
9924
9925 =item CREATING A SUBMIT BUTTON
9926
9927 B<Parameters:>
9928
9929 =item CREATING A RESET BUTTON
9930
9931 =item CREATING A DEFAULT BUTTON
9932
9933 =item CREATING A HIDDEN FIELD
9934
9935 B<Parameters:>
9936
9937 =item CREATING A CLICKABLE IMAGE BUTTON
9938
9939 B<Parameters:>
9940
9941 =item CREATING A JAVASCRIPT ACTION BUTTON
9942
9943 =back
9944
9945 =item HTTP COOKIES
9946
9947 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
9948 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
9949
9950 =item WORKING WITH FRAMES
9951
9952 1. Create a <Frameset> document, 2. Specify the destination for the
9953 document in the HTTP header, 3. Specify the destination for the document in
9954 the <form> tag
9955
9956 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
9957
9958 =item DEBUGGING
9959
9960 =over 4
9961
9962 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
9963
9964 =back
9965
9966 =item FETCHING ENVIRONMENT VARIABLES
9967
9968 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
9969 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
9970 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
9971 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
9972 B<request_method()>, B<content_type()>, B<http()>, B<https()>
9973
9974 =item USING NPH SCRIPTS
9975
9976 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
9977 parameters
9978
9979 =item Server Push
9980
9981 multipart_init(), multipart_start(), multipart_end(), multipart_final()
9982
9983 =item Avoiding Denial of Service Attacks
9984
9985 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
9986 basis>, B<2. Globally for all scripts>
9987
9988 =item COMPATIBILITY WITH CGI-LIB.PL
9989
9990 =item AUTHOR INFORMATION
9991
9992 =item CREDITS
9993
9994 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
9995 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
9996 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
9997 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
9998 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
9999 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10000 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10001 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10002 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10003 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10004 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10005 ...and many many more..
10006
10007 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10008
10009 =item BUGS
10010
10011 =item SEE ALSO
10012
10013 =back
10014
10015 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10016
10017 =over 4
10018
10019 =item SYNOPSIS
10020
10021 =item ABSTRACT
10022
10023 =item DESCRIPTION
10024
10025 =item AUTHOR INFORMATION
10026
10027 =item BUGS
10028
10029 =item SEE ALSO
10030
10031 =back
10032
10033 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10034 other) error log
10035
10036 =over 4
10037
10038 =item SYNOPSIS
10039
10040 =item DESCRIPTION
10041
10042 =item REDIRECTING ERROR MESSAGES
10043
10044 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10045
10046 =over 4
10047
10048 =item Changing the default message
10049
10050 =back
10051
10052 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10053
10054 =item CHANGE LOG
10055
10056 =item AUTHORS
10057
10058 =item SEE ALSO
10059
10060 =back
10061
10062 =head2 CGI::Cookie - Interface to Netscape Cookies
10063
10064 =over 4
10065
10066 =item SYNOPSIS
10067
10068 =item DESCRIPTION
10069
10070 =item USING CGI::Cookie
10071
10072 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10073
10074 =over 4
10075
10076 =item Creating New Cookies
10077
10078 =item Sending the Cookie to the Browser
10079
10080 =item Recovering Previous Cookies
10081
10082 =item Manipulating Cookies
10083
10084 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10085
10086 =back
10087
10088 =item AUTHOR INFORMATION
10089
10090 =item BUGS
10091
10092 =item SEE ALSO
10093
10094 =back
10095
10096 =head2 CGI::Fast - CGI Interface for Fast CGI
10097
10098 =over 4
10099
10100 =item SYNOPSIS
10101
10102 =item DESCRIPTION
10103
10104 =item OTHER PIECES OF THE PUZZLE
10105
10106 =item WRITING FASTCGI PERL SCRIPTS
10107
10108 =item INSTALLING FASTCGI SCRIPTS
10109
10110 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10111
10112 =item EXTERNAL FASTCGI SERVER INVOCATION
10113
10114 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10115
10116 =item CAVEATS
10117
10118 =item AUTHOR INFORMATION
10119
10120 =item BUGS
10121
10122 =item SEE ALSO
10123
10124 =back
10125
10126 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10127
10128 =over 4
10129
10130 =item SYNOPSIS
10131
10132 =item DESCRIPTION
10133
10134 =over 4
10135
10136 =item Tags that won't be formatted
10137
10138 =item Customizing the Indenting
10139
10140 =back
10141
10142 =item BUGS
10143
10144 =item AUTHOR
10145
10146 =item SEE ALSO
10147
10148 =back
10149
10150 =head2 CGI::Push - Simple Interface to Server Push
10151
10152 =over 4
10153
10154 =item SYNOPSIS
10155
10156 =item DESCRIPTION
10157
10158 =item USING CGI::Push
10159
10160 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10161
10162 =over 4
10163
10164 =item Heterogeneous Pages
10165
10166 =item Changing the Page Delay on the Fly
10167
10168 =back
10169
10170 =item INSTALLING CGI::Push SCRIPTS
10171
10172 =item AUTHOR INFORMATION
10173
10174 =item BUGS
10175
10176 =item SEE ALSO
10177
10178 =back
10179
10180 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10181
10182 =over 4
10183
10184 =item SYNOPSIS
10185
10186 =item ABSTRACT
10187
10188 =item DESCRIPTION
10189
10190 =item AUTHOR INFORMATION
10191
10192 =item BUGS
10193
10194 =item SEE ALSO
10195
10196 =back
10197
10198 =head2 CGI::Util - Internal utilities used by CGI module
10199
10200 =over 4
10201
10202 =item SYNOPSIS
10203
10204 =item DESCRIPTION
10205
10206 =item AUTHOR INFORMATION
10207
10208 =item SEE ALSO
10209
10210 =back
10211
10212 =head2 CPAN - query, download and build perl modules from CPAN sites
10213
10214 =over 4
10215
10216 =item SYNOPSIS
10217
10218 =item DESCRIPTION
10219
10220 =over 4
10221
10222 =item Interactive Mode
10223
10224 Searching for authors, bundles, distribution files and modules, make, test,
10225 install, clean  modules or distributions, get, readme, look module or
10226 distribution, ls author, Signals
10227
10228 =item CPAN::Shell
10229
10230 =item autobundle
10231
10232 =item recompile
10233
10234 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10235
10236 =item Programmer's interface
10237
10238 expand($type,@things), expandany(@things), Programming Examples
10239
10240 =item Methods in the other Classes
10241
10242 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10243 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10244 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10245 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10246 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10247 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10248 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10249 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10250 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10251 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10252 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10253 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10254 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10255 CPAN::Distribution::look(), CPAN::Distribution::make(),
10256 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10257 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10258 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10259 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10260 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10261 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10262 CPAN::Module::description(), CPAN::Module::force($method,@args),
10263 CPAN::Module::get(), CPAN::Module::inst_file(),
10264 CPAN::Module::inst_version(), CPAN::Module::install(),
10265 CPAN::Module::look(), CPAN::Module::make(),
10266 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10267 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10268
10269 =item Cache Manager
10270
10271 =item Bundles
10272
10273 =item Prerequisites
10274
10275 =item Finding packages and VERSION
10276
10277 =item Debugging
10278
10279 =item Floppy, Zip, Offline Mode
10280
10281 =back
10282
10283 =item CONFIGURATION
10284
10285 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10286 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10287 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10288 [unshift|push|splice] E<lt>listE<gt>>
10289
10290 =over 4
10291
10292 =item Note on urllist parameter's format
10293
10294 =item urllist parameter has CD-ROM support
10295
10296 =back
10297
10298 =item SECURITY
10299
10300 =item EXPORT
10301
10302 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10303
10304 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10305
10306 =over 4
10307
10308 =item Three basic types of firewalls
10309
10310 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10311
10312 =item Configuring lynx or ncftp for going through a firewall
10313
10314 =back
10315
10316 =item FAQ
10317
10318 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10319
10320 =item BUGS
10321
10322 =item AUTHOR
10323
10324 =item TRANSLATIONS
10325
10326 =item SEE ALSO
10327
10328 =back
10329
10330 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10331
10332 =over 4
10333
10334 =item SYNOPSIS
10335
10336 =item DESCRIPTION
10337
10338 =back
10339
10340 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10341 module
10342
10343 =over 4
10344
10345 =item SYNOPSIS
10346
10347 =item DESCRIPTION
10348
10349 =item  SEE ALSO
10350
10351 =back
10352
10353 =head2 Carp, carp    - warn of errors (from perspective of caller)
10354
10355 =over 4
10356
10357 =item SYNOPSIS
10358
10359 =item DESCRIPTION
10360
10361 =over 4
10362
10363 =item Forcing a Stack Trace
10364
10365 =back
10366
10367 =item BUGS
10368
10369 =back
10370
10371 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10372
10373 =head2 Class::ISA -- report the search path for a class's ISA tree
10374
10375 =over 4
10376
10377 =item SYNOPSIS
10378
10379 =item DESCRIPTION
10380
10381 =item FUNCTIONS
10382
10383 the function Class::ISA::super_path($CLASS), the function
10384 Class::ISA::self_and_super_path($CLASS), the function
10385 Class::ISA::self_and_super_versions($CLASS)
10386
10387 =item CAUTIONARY NOTES
10388
10389 =item COPYRIGHT
10390
10391 =item AUTHOR
10392
10393 =back
10394
10395 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10396
10397 =over 4
10398
10399 =item SYNOPSIS
10400
10401 =item DESCRIPTION
10402
10403 =over 4
10404
10405 =item The C<struct()> function
10406
10407 =item Class Creation at Compile Time
10408
10409 =item Element Types and Accessor Methods
10410
10411 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10412 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10413
10414 =item Initializing with C<new>
10415
10416 =back
10417
10418 =item EXAMPLES
10419
10420 Example 1, Example 2, Example 3
10421
10422 =item Author and Modification History
10423
10424 =back
10425
10426 =head2 Config - access Perl configuration information
10427
10428 =over 4
10429
10430 =item SYNOPSIS
10431
10432 =item DESCRIPTION
10433
10434 myconfig(), config_sh(), config_vars(@names)
10435
10436 =item EXAMPLE
10437
10438 =item WARNING
10439
10440 =item GLOSSARY
10441
10442 =over 4
10443
10444 =item _
10445
10446 C<_a>, C<_exe>, C<_o>
10447
10448 =item a
10449
10450 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10451 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10452 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10453 C<asctime_r_proto>, C<awk>
10454
10455 =item b
10456
10457 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10458
10459 =item c
10460
10461 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10462 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10463 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10464 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10465 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10466 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10467 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10468
10469 =item d
10470
10471 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10472 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10473 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10474 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10475 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10476 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10477 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10478 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10479 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10480 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10481 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10482 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10483 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10484 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10485 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10486 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10487 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10488 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10489 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10490 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10491 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10492 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10493 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10494 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10495 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10496 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10497 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10498 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10499 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10500 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10501 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10502 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10503 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10504 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10505 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10506 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10507 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10508 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10509 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10510 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10511 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10512 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10513 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10514 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10515 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10516 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10517 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10518 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10519 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10520 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10521 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10522 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10523 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10524 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10525 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10526 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10527 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10528 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10529 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10530 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10531 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10532 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10533 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10534 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10535 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10536 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10537 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10538 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10539 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10540 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10541 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10542 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10543 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10544 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10545 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10546 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10547 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10548 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10549 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10550 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10551 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10552 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10553 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10554 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10555 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10556 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10557 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10558 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10559 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10560 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10561
10562 =item e
10563
10564 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10565 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10566 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10567 C<expr>, C<extensions>, C<extras>
10568
10569 =item f
10570
10571 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10572 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10573 C<full_sed>
10574
10575 =item g
10576
10577 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10578 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10579 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10580 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10581 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10582 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10583 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10584 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10585 C<gmtime_r_proto>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
10586
10587 =item h
10588
10589 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10590
10591 =item i
10592
10593 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10594 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10595 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10596 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10597 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10598 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10599 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10600 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10601 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10602 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10603 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10604 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10605 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10606 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10607 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10608 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10609 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10610 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10611 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10612 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10613 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10614 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10615 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10616 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10617
10618 =item k
10619
10620 C<known_extensions>, C<ksh>
10621
10622 =item l
10623
10624 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10625 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10626 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10627 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10628 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10629 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10630 C<lseektype>
10631
10632 =item m
10633
10634 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10635 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10636 C<man3direxp>, C<man3ext>
10637
10638 =item M
10639
10640 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10641 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10642
10643 =item n
10644
10645 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10646 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10647 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10648 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10649 C<nvsize>, C<nvtype>
10650
10651 =item o
10652
10653 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10654 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10655
10656 =item p
10657
10658 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10659 C<perl>, C<perl_patchlevel>
10660
10661 =item P
10662
10663 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10664 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10665 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10666 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10667
10668 =item q
10669
10670 C<quadkind>, C<quadtype>
10671
10672 =item r
10673
10674 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10675 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10676 C<rmail>, C<run>, C<runnm>
10677
10678 =item s
10679
10680 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10681 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10682 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10683 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10684 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10685 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10686 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10687 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10688 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10689 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10690 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10691 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10692 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10693 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10694 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10695 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10696 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10697
10698 =item t
10699
10700 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10701 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10702 C<ttyname_r_proto>
10703
10704 =item u
10705
10706 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10707 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10708 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10709 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10710 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10711 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10712 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10713 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10714 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10715
10716 =item v
10717
10718 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10719 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10720 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10721 C<versiononly>, C<vi>, C<voidflags>
10722
10723 =item x
10724
10725 C<xlibpth>, C<xs_apiversion>
10726
10727 =item y
10728
10729 C<yacc>, C<yaccflags>
10730
10731 =item z
10732
10733 C<zcat>, C<zip>
10734
10735 =back
10736
10737 =item NOTE
10738
10739 =back
10740
10741 =head2 Cwd - get pathname of current working directory
10742
10743 =over 4
10744
10745 =item SYNOPSIS
10746
10747 =item DESCRIPTION
10748
10749 =over 4
10750
10751 =item getcwd and friends
10752
10753 getcwd, cwd, fastcwd, fastgetcwd
10754
10755 =item abs_path and friends
10756
10757 abs_path, realpath, fast_abs_path
10758
10759 =item $ENV{PWD}
10760
10761 =back
10762
10763 =item NOTES
10764
10765 =item SEE ALSO
10766
10767 =back
10768
10769 =head2 DB - programmatic interface to the Perl debugging API (draft,
10770 subject to
10771 change)
10772
10773 =over 4
10774
10775 =item SYNOPSIS
10776
10777 =item DESCRIPTION
10778
10779 =over 4
10780
10781 =item Global Variables
10782
10783  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
10784 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
10785 $DB::lineno
10786
10787 =item API Methods
10788
10789 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10790 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10791
10792 =item Client Callback Methods
10793
10794 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10795 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10796 CLIENT->output(LIST)
10797
10798 =back
10799
10800 =item BUGS
10801
10802 =item AUTHOR
10803
10804 =back
10805
10806 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10807
10808 =over 4
10809
10810 =item SYNOPSIS
10811
10812 =item DESCRIPTION
10813
10814 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10815
10816 =over 4
10817
10818 =item Using DB_File with Berkeley DB version 2 or greater
10819
10820 =item Interface to Berkeley DB
10821
10822 =item Opening a Berkeley DB Database File
10823
10824 =item Default Parameters
10825
10826 =item In Memory Databases
10827
10828 =back
10829
10830 =item DB_HASH
10831
10832 =over 4
10833
10834 =item A Simple Example
10835
10836 =back
10837
10838 =item DB_BTREE
10839
10840 =over 4
10841
10842 =item Changing the BTREE sort order
10843
10844 =item Handling Duplicate Keys
10845
10846 =item The get_dup() Method
10847
10848 =item The find_dup() Method
10849
10850 =item The del_dup() Method
10851
10852 =item Matching Partial Keys
10853
10854 =back
10855
10856 =item DB_RECNO
10857
10858 =over 4
10859
10860 =item The 'bval' Option
10861
10862 =item A Simple Example
10863
10864 =item Extra RECNO Methods
10865
10866 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10867 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10868 length, elements);>
10869
10870 =item Another Example
10871
10872 =back
10873
10874 =item THE API INTERFACE
10875
10876 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10877 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10878 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10879 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10880
10881 =item DBM FILTERS
10882
10883 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10884 B<filter_fetch_value>
10885
10886 =over 4
10887
10888 =item The Filter
10889
10890 =item An Example -- the NULL termination problem.
10891
10892 =item Another Example -- Key is a C int.
10893
10894 =back
10895
10896 =item HINTS AND TIPS
10897
10898 =over 4
10899
10900 =item Locking: The Trouble with fd
10901
10902 =item Safe ways to lock a database
10903
10904 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10905
10906 =item Sharing Databases With C Applications
10907
10908 =item The untie() Gotcha
10909
10910 =back
10911
10912 =item COMMON QUESTIONS
10913
10914 =over 4
10915
10916 =item Why is there Perl source in my database?
10917
10918 =item How do I store complex data structures with DB_File?
10919
10920 =item What does "Invalid Argument" mean?
10921
10922 =item What does "Bareword 'DB_File' not allowed" mean?
10923
10924 =back
10925
10926 =item REFERENCES
10927
10928 =item HISTORY
10929
10930 =item BUGS
10931
10932 =item AVAILABILITY
10933
10934 =item COPYRIGHT
10935
10936 =item SEE ALSO
10937
10938 =item AUTHOR
10939
10940 =back
10941
10942 =head2 Data::Dumper - stringified perl data structures, suitable for both
10943 printing and C<eval>
10944
10945 =over 4
10946
10947 =item SYNOPSIS
10948
10949 =item DESCRIPTION
10950
10951 =over 4
10952
10953 =item Methods
10954
10955 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
10956 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
10957 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
10958 I<$OBJ>->Reset
10959
10960 =item Functions
10961
10962 Dumper(I<LIST>)
10963
10964 =item Configuration Variables or Methods
10965
10966 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
10967 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
10968 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
10969 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
10970 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
10971 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
10972 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
10973 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
10974 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
10975 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
10976 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
10977 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
10978 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
10979 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
10980 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
10981
10982 =item Exports
10983
10984 Dumper
10985
10986 =back
10987
10988 =item EXAMPLES
10989
10990 =item BUGS
10991
10992 =item AUTHOR
10993
10994 =item VERSION
10995
10996 =item SEE ALSO
10997
10998 =back
10999
11000 =head2 Devel::DProf - a Perl code profiler
11001
11002 =over 4
11003
11004 =item SYNOPSIS
11005
11006 =item DESCRIPTION
11007
11008 =item PROFILE FORMAT
11009
11010 =item AUTOLOAD
11011
11012 =item ENVIRONMENT
11013
11014 =item BUGS
11015
11016 =item SEE ALSO
11017
11018 =back
11019
11020 =head2 Devel::PPPort, Perl/Pollution/Portability
11021
11022 =over 4
11023
11024 =item SYNOPSIS
11025
11026 =item DESCRIPTION
11027
11028 =over 4
11029
11030 =item WriteFile
11031
11032 =back
11033
11034 =item ppport.h
11035
11036 =item AUTHOR
11037
11038 =item SEE ALSO
11039
11040 =back
11041
11042 =head2 Devel::Peek - A data debugging tool for the XS programmer
11043
11044 =over 4
11045
11046 =item SYNOPSIS
11047
11048 =item DESCRIPTION
11049
11050 =over 4
11051
11052 =item Runtime debugging
11053
11054 =item Memory footprint debugging
11055
11056 =back
11057
11058 =item EXAMPLES
11059
11060 =over 4
11061
11062 =item A simple scalar string
11063
11064 =item A simple scalar number
11065
11066 =item A simple scalar with an extra reference
11067
11068 =item A reference to a simple scalar
11069
11070 =item A reference to an array
11071
11072 =item A reference to a hash
11073
11074 =item Dumping a large array or hash
11075
11076 =item A reference to an SV which holds a C pointer
11077
11078 =item A reference to a subroutine
11079
11080 =back
11081
11082 =item EXPORTS
11083
11084 =item BUGS
11085
11086 =item AUTHOR
11087
11088 =item SEE ALSO
11089
11090 =back
11091
11092 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11093
11094 =over 4
11095
11096 =item SYNOPSIS
11097
11098 =item DESCRIPTION
11099
11100 =back
11101
11102 =head2 Digest:: - Modules that calculate message digests
11103
11104 =over 4
11105
11106 =item SYNOPSIS
11107
11108 =item DESCRIPTION
11109
11110 I<binary>, I<hex>, I<base64>
11111
11112 =item OO INTERFACE
11113
11114 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11115 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11116 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11117
11118 =item SEE ALSO
11119
11120 =item AUTHOR
11121
11122 =back
11123
11124 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11125
11126 =over 4
11127
11128 =item SYNOPSIS
11129
11130 =item DESCRIPTION
11131
11132 =item FUNCTIONS
11133
11134 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11135
11136 =item METHODS
11137
11138 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11139 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11140
11141 =item EXAMPLES
11142
11143 =item SEE ALSO
11144
11145 =item COPYRIGHT
11146
11147 =item AUTHORS
11148
11149 =back
11150
11151 =head2 DirHandle - supply object methods for directory handles
11152
11153 =over 4
11154
11155 =item SYNOPSIS
11156
11157 =item DESCRIPTION
11158
11159 =item NOTES
11160
11161 =back
11162
11163 =head2 Dumpvalue - provides screen dump of Perl data.
11164
11165 =over 4
11166
11167 =item SYNOPSIS
11168
11169 =item DESCRIPTION
11170
11171 =over 4
11172
11173 =item Creation
11174
11175 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11176 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11177 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11178 stopDbSignal
11179
11180 =item Methods
11181
11182 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11183 compactDump, veryCompact, set, get
11184
11185 =back
11186
11187 =back
11188
11189 =head2 DynaLoader - Dynamically load C libraries into Perl code
11190
11191 =over 4
11192
11193 =item SYNOPSIS
11194
11195 =item DESCRIPTION
11196
11197 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11198 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11199 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11200 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11201 bootstrap()
11202
11203 =item AUTHOR
11204
11205 =back
11206
11207 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11208 Perl code
11209
11210 =over 4
11211
11212 =item SYNOPSIS
11213
11214 =item DESCRIPTION
11215
11216 =item AUTHOR
11217
11218 =back
11219
11220 =head2 Encode - character encodings
11221
11222 =over 4
11223
11224 =item SYNOPSIS
11225
11226 =over 4
11227
11228 =item Table of Contents
11229
11230 =back
11231
11232 =item DESCRIPTION
11233
11234 =over 4
11235
11236 =item TERMINOLOGY
11237
11238 =back
11239
11240 =item PERL ENCODING API
11241
11242 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11243 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11244 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11245 CHECK]);
11246
11247 =over 4
11248
11249 =item Listing available encodings
11250
11251 =item Defining Aliases
11252
11253 =back
11254
11255 =item Encoding via PerlIO
11256
11257 =item Handling Malformed Data
11258
11259 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11260 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11261 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11262 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11263 bitmask
11264
11265 =over 4
11266
11267 =item Unimplemented fallback schemes
11268
11269 =back
11270
11271 =item Defining Encodings
11272
11273 =item The UTF-8 flag
11274
11275 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11276
11277 =over 4
11278
11279 =item Messing with Perl's Internals
11280
11281 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11282
11283 =back
11284
11285 =item SEE ALSO
11286
11287 =item MAINTAINER
11288
11289 =back
11290
11291 =head2 Encode::Alias - alias definitions to encodings
11292
11293 =over 4
11294
11295 =item SYNOPSIS
11296
11297 =item DESCRIPTION
11298
11299 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11300 reference, e.g.:
11301
11302 =over 4
11303
11304 =item Alias overloading
11305
11306 =back
11307
11308 =item SEE ALSO
11309
11310 =back
11311
11312 =head2 Encode::Byte - Single Byte Encodings
11313
11314 =over 4
11315
11316 =item SYNOPSIS
11317
11318 =item ABSTRACT
11319
11320 =item DESCRIPTION
11321
11322 =item SEE ALSO
11323
11324 =back
11325
11326 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11327
11328 =head2 Encode::CN - China-based Chinese Encodings
11329
11330 =over 4
11331
11332 =item SYNOPSIS
11333
11334 =item DESCRIPTION
11335
11336 =item NOTES
11337
11338 =item BUGS
11339
11340 =item SEE ALSO
11341
11342 =back
11343
11344 =head2 Encode::CN::HZ -- internally used by Encode::CN
11345
11346 =head2 Encode::Config -- internally used by Encode
11347
11348 =head2 Encode::EBCDIC - EBCDIC Encodings
11349
11350 =over 4
11351
11352 =item SYNOPSIS
11353
11354 =item ABSTRACT
11355
11356 =item DESCRIPTION
11357
11358 =item SEE ALSO
11359
11360 =back
11361
11362 =head2 Encode::Encoding - Encode Implementation Base Class
11363
11364 =over 4
11365
11366 =item SYNOPSIS
11367
11368 =item DESCRIPTION
11369
11370 =over 4
11371
11372 =item Methods you should implement
11373
11374 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11375
11376 =item Other methods defined in Encode::Encodings
11377
11378 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11379
11380 =item Example: Encode::ROT13
11381
11382 =back
11383
11384 =item Why the heck Encode API is different?
11385
11386 =over 4
11387
11388 =item Compiled Encodings
11389
11390 =back
11391
11392 =item SEE ALSO
11393
11394 Scheme 1, Scheme 2, Other Schemes
11395
11396 =back
11397
11398 =head2 Encode::Guess -- Guesses encoding from data
11399
11400 =over 4
11401
11402 =item SYNOPSIS
11403
11404 =item ABSTRACT
11405
11406 =item DESCRIPTION
11407
11408 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11409 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11410 guess_encoding($data, [, I<list of suspects>])
11411
11412 =item CAVEATS
11413
11414 =item TO DO
11415
11416 =item SEE ALSO
11417
11418 =back
11419
11420 =head2 Encode::JP - Japanese Encodings
11421
11422 =over 4
11423
11424 =item SYNOPSIS
11425
11426 =item ABSTRACT
11427
11428 =item DESCRIPTION
11429
11430 =item Note on ISO-2022-JP(-1)?
11431
11432 =item BUGS
11433
11434 =item SEE ALSO
11435
11436 =back
11437
11438 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11439
11440 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11441
11442 =head2 Encode::KR - Korean Encodings
11443
11444 =over 4
11445
11446 =item SYNOPSIS
11447
11448 =item DESCRIPTION
11449
11450 =item BUGS
11451
11452 =item SEE ALSO
11453
11454 =back
11455
11456 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11457
11458 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11459
11460 =over 4
11461
11462 =item SYNOPSIS
11463
11464 =item ABSTRACT
11465
11466 =item DESCRIPTION
11467
11468 =item BUGS
11469
11470 =item SEE ALSO
11471
11472 =back
11473
11474 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11475
11476 =over 4
11477
11478 =item Overview
11479
11480 =item How does it work?
11481
11482 =item BUGS
11483
11484 =over 4
11485
11486 =item Workaround
11487
11488 =item How can I tell whether my encoding fully supports PerlIO ?
11489
11490 =back
11491
11492 =item SEE ALSO
11493
11494 =back
11495
11496 =head2 Encode::Supported -- Encodings supported by Encode
11497
11498 =over 4
11499
11500 =item DESCRIPTION
11501
11502 =over 4
11503
11504 =item Encoding Names
11505
11506 =back
11507
11508 =item Supported Encodings
11509
11510 =over 4
11511
11512 =item Built-in Encodings
11513
11514 =item Encode::Unicode -- other Unicode encodings
11515
11516 =item Encode::Byte -- Extended ASCII
11517
11518 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11519 the Cyrillic world, gsm0338 - Hentai Latin 1
11520
11521 =item CJK: Chinese, Japanese, Korean (Multibyte)
11522
11523 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11524 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11525 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11526
11527 =item Miscellaneous encodings
11528
11529 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11530
11531 =back
11532
11533 =item Unsupported encodings
11534
11535   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11536 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11537 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11538 Various Mac encodings, (Mac) Indic encodings
11539
11540 =item Encoding vs. Charset -- terminology
11541
11542 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11543
11544 =over 4
11545
11546 =item Microsoft-related naming mess
11547
11548 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11549
11550 =back
11551
11552 =item Glossary
11553
11554 character repertoire, coded character set (CCS), character encoding scheme
11555 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11556 UTF-16
11557
11558 =item See Also
11559
11560 =item References
11561
11562 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11563 RFC, UC, Unicode Glossary
11564
11565 =over 4
11566
11567 =item Other Notable Sites
11568
11569 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11570 "Introduction to i18n"
11571
11572 =item Offline sources
11573
11574 C<CJKV Information Processing> by Ken Lunde
11575
11576 =back
11577
11578 =back
11579
11580 =head2 Encode::Symbol - Symbol Encodings
11581
11582 =over 4
11583
11584 =item SYNOPSIS
11585
11586 =item ABSTRACT
11587
11588 =item DESCRIPTION
11589
11590 =item SEE ALSO
11591
11592 =back
11593
11594 =head2 Encode::TW - Taiwan-based Chinese Encodings
11595
11596 =over 4
11597
11598 =item SYNOPSIS
11599
11600 =item DESCRIPTION
11601
11602 =item NOTES
11603
11604 =item BUGS
11605
11606 =item SEE ALSO
11607
11608 =back
11609
11610 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11611
11612 =over 4
11613
11614 =item SYNOPSIS
11615
11616 =item ABSTRACT
11617
11618 L<http://www.unicode.org/glossary/> says:, Quick Reference
11619
11620 =item Size, Endianness, and BOM
11621
11622 =over 4
11623
11624 =item by size
11625
11626 =item by endianness
11627
11628 BOM as integer when fetched in network byte order
11629
11630 =back
11631
11632 =item Surrogate Pairs
11633
11634 =item SEE ALSO
11635
11636 =back
11637
11638 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11639 encodings
11640
11641 =over 4
11642
11643 =item SYNOPSIS
11644
11645 =item DESCRIPTION
11646
11647 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11648 reference, e.g.:
11649
11650 =over 4
11651
11652 =item Alias overloading
11653
11654 =back
11655
11656 =item SEE ALSO
11657
11658 =back
11659
11660 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11661 Internally used by Encode::??::ISO_2022_*
11662
11663 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11664 Encode::CN
11665
11666 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11667 Encode
11668
11669 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11670 Implementation Base Class
11671
11672 =over 4
11673
11674 =item SYNOPSIS
11675
11676 =item DESCRIPTION
11677
11678 =over 4
11679
11680 =item Methods you should implement
11681
11682 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11683
11684 =item Other methods defined in Encode::Encodings
11685
11686 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11687
11688 =item Example: Encode::ROT13
11689
11690 =back
11691
11692 =item Why the heck Encode API is different?
11693
11694 =over 4
11695
11696 =item Compiled Encodings
11697
11698 =back
11699
11700 =item SEE ALSO
11701
11702 Scheme 1, Scheme 2, Other Schemes
11703
11704 =back
11705
11706 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11707 data
11708
11709 =over 4
11710
11711 =item SYNOPSIS
11712
11713 =item ABSTRACT
11714
11715 =item DESCRIPTION
11716
11717 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11718 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11719 guess_encoding($data, [, I<list of suspects>])
11720
11721 =item CAVEATS
11722
11723 =item TO DO
11724
11725 =item SEE ALSO
11726
11727 =back
11728
11729 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11730 Encode::JP::2022_JP*
11731
11732 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11733 by Encode::JP
11734
11735 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11736 used by Encode::KR
11737
11738 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11739 and 'Q' header encoding
11740
11741 =over 4
11742
11743 =item SYNOPSIS
11744
11745 =item ABSTRACT
11746
11747 =item DESCRIPTION
11748
11749 =item BUGS
11750
11751 =item SEE ALSO
11752
11753 =back
11754
11755 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11756 on Encode and PerlIO
11757
11758 =over 4
11759
11760 =item Overview
11761
11762 =item How does it work?
11763
11764 =item BUGS
11765
11766 =over 4
11767
11768 =item Workaround
11769
11770 =item How can I tell whether my encoding fully supports PerlIO ?
11771
11772 =back
11773
11774 =item SEE ALSO
11775
11776 =back
11777
11778 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11779 supported by Encode
11780
11781 =over 4
11782
11783 =item DESCRIPTION
11784
11785 =over 4
11786
11787 =item Encoding Names
11788
11789 =back
11790
11791 =item Supported Encodings
11792
11793 =over 4
11794
11795 =item Built-in Encodings
11796
11797 =item Encode::Unicode -- other Unicode encodings
11798
11799 =item Encode::Byte -- Extended ASCII
11800
11801 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11802 the Cyrillic world, gsm0338 - Hentai Latin 1
11803
11804 =item CJK: Chinese, Japanese, Korean (Multibyte)
11805
11806 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11807 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11808 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11809
11810 =item Miscellaneous encodings
11811
11812 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11813
11814 =back
11815
11816 =item Unsupported encodings
11817
11818   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11819 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11820 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11821 Various Mac encodings, (Mac) Indic encodings
11822
11823 =item Encoding vs. Charset -- terminology
11824
11825 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11826
11827 =over 4
11828
11829 =item Microsoft-related naming mess
11830
11831 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11832
11833 =back
11834
11835 =item Glossary
11836
11837 character repertoire, coded character set (CCS), character encoding scheme
11838 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11839 UTF-16
11840
11841 =item See Also
11842
11843 =item References
11844
11845 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11846 RFC, UC, Unicode Glossary
11847
11848 =over 4
11849
11850 =item Other Notable Sites
11851
11852 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11853 "Introduction to i18n"
11854
11855 =item Offline sources
11856
11857 C<CJKV Information Processing> by Ken Lunde
11858
11859 =back
11860
11861 =back
11862
11863 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11864
11865 =over 4
11866
11867 =item SYNOPSIS
11868
11869   use Encode::Encoder;
11870   # Encode::encode("ISO-8859-1", $data);
11871   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11872   # shortcut
11873   use Encode::Encoder qw(encoder);
11874   encoder($data)->iso_8859_1;
11875   # you can stack them!
11876   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11877   # you can use it as a decoder as well
11878   encoder($base64)->bytes('base64')->latin1;
11879   # stringified
11880   print encoder($data)->utf8->latin1;  # prints the string in latin1
11881   # numified
11882   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11883
11884 =item ABSTRACT
11885
11886 =item Description
11887
11888 =over 4
11889
11890 =item Predefined Methods
11891
11892 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11893 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11894 $e-E<gt>bytes([$encoding])
11895
11896 =item Example: base64 transcoder
11897
11898 =item Operator Overloading
11899
11900 =back
11901
11902 =item SEE ALSO
11903
11904 =back
11905
11906 =head2 Encodencoding, encoding - allows you to write your script in
11907 non-ascii or non-utf8
11908
11909 =over 4
11910
11911 =item SYNOPSIS
11912
11913 =item ABSTRACT
11914
11915 =item USAGE
11916
11917 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11918 I<ENCNAME_IN> ...] ;, no encoding;
11919
11920 =item CAVEATS
11921
11922 =over 4
11923
11924 =item NOT SCOPED
11925
11926 =item DO NOT MIX MULTIPLE ENCODINGS
11927
11928 =back
11929
11930 =item Non-ASCII Identifiers and Filter option
11931
11932 use encoding I<ENCNAME> Filter=E<gt>1;
11933
11934 =item EXAMPLE - Greekperl
11935
11936 =item KNOWN PROBLEMS
11937
11938 =item SEE ALSO
11939
11940 =back
11941
11942 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
11943
11944 =over 4
11945
11946 =item SYNOPSIS
11947
11948   use Encode::Encoder;
11949   # Encode::encode("ISO-8859-1", $data);
11950   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11951   # shortcut
11952   use Encode::Encoder qw(encoder);
11953   encoder($data)->iso_8859_1;
11954   # you can stack them!
11955   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11956   # you can use it as a decoder as well
11957   encoder($base64)->bytes('base64')->latin1;
11958   # stringified
11959   print encoder($data)->utf8->latin1;  # prints the string in latin1
11960   # numified
11961   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11962
11963 =item ABSTRACT
11964
11965 =item Description
11966
11967 =over 4
11968
11969 =item Predefined Methods
11970
11971 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11972 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11973 $e-E<gt>bytes([$encoding])
11974
11975 =item Example: base64 transcoder
11976
11977 =item Operator Overloading
11978
11979 =back
11980
11981 =item SEE ALSO
11982
11983 =back
11984
11985 =head2 English - use nice English (or awk) names for ugly punctuation
11986 variables
11987
11988 =over 4
11989
11990 =item SYNOPSIS
11991
11992 =item DESCRIPTION
11993
11994 =item PERFORMANCE
11995
11996 =back
11997
11998 =head2 Env - perl module that imports environment variables as scalars or
11999 arrays
12000
12001 =over 4
12002
12003 =item SYNOPSIS
12004
12005 =item DESCRIPTION
12006
12007 =item LIMITATIONS
12008
12009 =item AUTHOR
12010
12011 =back
12012
12013 =head2 Errno - System errno constants
12014
12015 =over 4
12016
12017 =item SYNOPSIS
12018
12019 =item DESCRIPTION
12020
12021 =item CAVEATS
12022
12023 =item AUTHOR
12024
12025 =item COPYRIGHT
12026
12027 =back
12028
12029 =head2 Exporter - Implements default import method for modules
12030
12031 =over 4
12032
12033 =item SYNOPSIS
12034
12035 =item DESCRIPTION
12036
12037 =over 4
12038
12039 =item How to Export
12040
12041 =item Selecting What To Export
12042
12043 =item How to Import
12044
12045 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12046
12047 =back
12048
12049 =item Advanced features
12050
12051 =over 4
12052
12053 =item Specialised Import Lists
12054
12055 =item Exporting without using Exporter's import method
12056
12057 =item Module Version Checking
12058
12059 =item Managing Unknown Symbols
12060
12061 =item Tag Handling Utility Functions
12062
12063 =item Generating combined tags
12064
12065 =item C<AUTOLOAD>ed Constants
12066
12067 =back
12068
12069 =back
12070
12071 =head2 Exporter::Heavy - Exporter guts
12072
12073 =over 4
12074
12075 =item SYNOPSIS
12076
12077 =item DESCRIPTION
12078
12079 =back
12080
12081 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12082 Makefiles etc.
12083
12084 =over 4
12085
12086 =item SYNOPSIS
12087
12088 =item DESCRIPTION
12089
12090 =back
12091
12092 cat
12093
12094 eqtime src dst
12095
12096 rm_rf files...
12097
12098 rm_f files...
12099
12100 touch files ..
12101
12102 mv source... destination
12103
12104 cp source... destination
12105
12106 chmod mode files..
12107
12108 mkpath directory..
12109
12110 test_f file
12111
12112 =over 4
12113
12114 =item BUGS
12115
12116 =item SEE ALSO
12117
12118 =item AUTHOR
12119
12120 =back
12121
12122 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12123
12124 =over 4
12125
12126 =item SYNOPSIS
12127
12128 =item DESCRIPTION
12129
12130 B<test_harness>
12131
12132 =back
12133
12134 =head2 ExtUtils::Constant - generate XS code to import C header constants
12135
12136 =over 4
12137
12138 =item SYNOPSIS
12139
12140 =item DESCRIPTION
12141
12142 =item USAGE
12143
12144 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12145
12146 =item FUNCTIONS
12147
12148 =back
12149
12150 C_stringify NAME
12151
12152 perl_stringify NAME
12153
12154 constant_types
12155
12156 memEQ_clause NAME, CHECKED_AT, INDENT
12157
12158 assign INDENT, TYPE, PRE, POST, VALUE..
12159
12160 return_clause
12161
12162 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12163
12164 params WHAT
12165
12166 dump_names
12167
12168 dogfood
12169
12170 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12171 def_post, utf8
12172
12173 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12174
12175 autoload PACKAGE, VERSION, AUTOLOADER
12176
12177 WriteMakefileSnippet
12178
12179 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12180 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12181
12182 =over 4
12183
12184 =item AUTHOR
12185
12186 =back
12187
12188 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12189
12190 =over 4
12191
12192 =item SYNOPSIS
12193
12194 =item DESCRIPTION
12195
12196 =item @EXPORT
12197
12198 =item FUNCTIONS
12199
12200 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12201 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12202
12203 =item EXAMPLES
12204
12205 =item SEE ALSO
12206
12207 =item AUTHOR
12208
12209 =back
12210
12211 =head2 ExtUtils::Install - install files from here to there
12212
12213 =over 4
12214
12215 =item SYNOPSIS
12216
12217 =item DESCRIPTION
12218
12219 =back
12220
12221 =head2 ExtUtils::Installed - Inventory management of installed modules
12222
12223 =over 4
12224
12225 =item SYNOPSIS
12226
12227 =item DESCRIPTION
12228
12229 =item USAGE
12230
12231 =item FUNCTIONS
12232
12233 new(), modules(), files(), directories(), directory_tree(), validate(),
12234 packlist(), version()
12235
12236 =item EXAMPLE
12237
12238 =item AUTHOR
12239
12240 =back
12241
12242 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12243
12244 =over 4
12245
12246 =item SYNOPSIS
12247
12248 =item DESCRIPTION
12249
12250 For static extensions, For dynamic extensions at build/link time, For
12251 dynamic extensions at load time
12252
12253 =over 4
12254
12255 =item EXTRALIBS
12256
12257 =item LDLOADLIBS and LD_RUN_PATH
12258
12259 =item BSLOADLIBS
12260
12261 =back
12262
12263 =item PORTABILITY
12264
12265 =over 4
12266
12267 =item VMS implementation
12268
12269 =item Win32 implementation
12270
12271 =back
12272
12273 =item SEE ALSO
12274
12275 =back
12276
12277 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12278
12279 =over 4
12280
12281 =item SYNOPSIS
12282
12283 =item DESCRIPTION
12284
12285 =back
12286
12287 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12288
12289 =over 4
12290
12291 =item SYNOPSIS
12292
12293 =item DESCRIPTION
12294
12295 =item Inherently Cross-Platform Methods
12296
12297 =over 4
12298
12299 =item File::Spec wrappers  B<DEPRECATED>
12300
12301 canonpath
12302
12303 =back
12304
12305 =back
12306
12307 catdir
12308
12309 catfile
12310
12311 curdir
12312
12313 file_name_is_absolute
12314
12315 path
12316
12317 rootdir
12318
12319 updir
12320
12321 =over 4
12322
12323 =item Thought To Be Cross-Platform Methods
12324
12325 test_via_harness
12326
12327 =back
12328
12329 test_via_script
12330
12331 =over 4
12332
12333 =item AUTHOR
12334
12335 =back
12336
12337 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12338 ExtUtils::MakeMaker
12339
12340 =over 4
12341
12342 =item SYNOPSIS
12343
12344 =item DESCRIPTION
12345
12346 =back
12347
12348 perl_archive
12349
12350 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12351 ExtUtils::MakeMaker
12352
12353 =over 4
12354
12355 =item SYNOPSIS
12356
12357 =item DESCRIPTION
12358
12359 canonpath, cflags, manifypods, perl_archive
12360
12361 =back
12362
12363 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12364
12365 =over 4
12366
12367 =item SYNOPSIS
12368
12369 =item DESCRIPTION
12370
12371 =over 4
12372
12373 =item Overridden methods
12374
12375 B<replace_manpage_separator>
12376
12377 =back
12378
12379 =back
12380
12381 =over 4
12382
12383 =item AUTHOR
12384
12385 =item SEE ALSO
12386
12387 =back
12388
12389 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12390 ExtUtils::MakeMaker
12391
12392 =over 4
12393
12394 =item SYNOPSIS
12395
12396 =item DESCRIPTION
12397
12398 =back
12399
12400 maybe_command
12401
12402 guess_name
12403
12404 macify
12405
12406 patternify
12407
12408 init_main
12409
12410 init_others
12411
12412 init_dirscan
12413
12414 libscan (o)
12415
12416 constants (o)
12417
12418 static (o)
12419
12420 dlsyms (o)
12421
12422 dynamic (o)
12423
12424 clean (o)
12425
12426 realclean (o)
12427
12428 rulez (o)
12429
12430 processPL (o)
12431
12432 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12433 ExtUtils::MakeMaker
12434
12435 =over 4
12436
12437 =item SYNOPSIS
12438
12439 =item DESCRIPTION
12440
12441 =back
12442
12443 constants (o)
12444
12445 static_lib (o)
12446
12447 dynamic_lib (o)
12448
12449 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12450 ExtUtils::MakeMaker
12451
12452 =over 4
12453
12454 =item SYNOPSIS
12455
12456 =item DESCRIPTION
12457
12458 =item METHODS
12459
12460 =back
12461
12462 perl_archive_after
12463
12464 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12465
12466 =over 4
12467
12468 =item SYNOPSIS
12469
12470 =item DESCRIPTION
12471
12472 =over 4
12473
12474 =item Overridden methods
12475
12476 B<replace_manpage_separator>
12477
12478 =back
12479
12480 =back
12481
12482 =over 4
12483
12484 =item AUTHOR
12485
12486 =item SEE ALSO
12487
12488 =back
12489
12490 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12491
12492 =over 4
12493
12494 =item SYNOPSIS
12495
12496 =item DESCRIPTION
12497
12498 =item METHODS
12499
12500 =back
12501
12502 =over 4
12503
12504 =item SelfLoaded methods
12505
12506 c_o (o)
12507
12508 =back
12509
12510 cflags (o)
12511
12512 clean (o)
12513
12514 const_cccmd (o)
12515
12516 const_config (o)
12517
12518 const_loadlibs (o)
12519
12520 constants (o)
12521
12522 depend (o)
12523
12524 dir_target (o)
12525
12526 dist (o)
12527
12528 dist_basics (o)
12529
12530 dist_ci (o)
12531
12532 dist_core (o)
12533
12534 dist_dir
12535
12536 dist_test
12537
12538 dlsyms (o)
12539
12540 dynamic (o)
12541
12542 dynamic_bs (o)
12543
12544 dynamic_lib (o)
12545
12546 exescan
12547
12548 extliblist
12549
12550 find_perl
12551
12552 find_tests
12553
12554 =over 4
12555
12556 =item Methods to actually produce chunks of text for the Makefile
12557
12558 fixin
12559
12560 =back
12561
12562 force (o)
12563
12564 guess_name
12565
12566 has_link_code
12567
12568 init_dirscan
12569
12570 init_main
12571
12572 init_others
12573
12574 init_INST
12575
12576 init_INSTALL
12577
12578 init_lib2arch
12579
12580 init_PERL
12581
12582 init_PERM
12583
12584 install (o)
12585
12586 installbin (o)
12587
12588 libscan (o)
12589
12590 linkext (o)
12591
12592 lsdir
12593
12594 macro (o)
12595
12596 makeaperl (o)
12597
12598 makefile (o)
12599
12600 manifypods (o)
12601
12602 maybe_command
12603
12604 maybe_command_in_dirs
12605
12606 needs_linking (o)
12607
12608 nicetext
12609
12610 parse_abstract
12611
12612 parse_version
12613
12614 pasthru (o)
12615
12616 perl_script
12617
12618 perldepend (o)
12619
12620 perm_rw (o)
12621
12622 perm_rwx (o)
12623
12624 pm_to_blib
12625
12626 post_constants (o)
12627
12628 post_initialize (o)
12629
12630 postamble (o)
12631
12632 ppd
12633
12634 prefixify
12635
12636 processPL (o)
12637
12638 quote_paren
12639
12640 realclean (o)
12641
12642 replace_manpage_separator
12643
12644 static (o)
12645
12646 static_lib (o)
12647
12648 staticmake (o)
12649
12650 subdir_x (o)
12651
12652 subdirs (o)
12653
12654 test (o)
12655
12656 test_via_harness (override)
12657
12658 test_via_script (override)
12659
12660 tool_autosplit (o)
12661
12662 tools_other (o)
12663
12664 tool_xsubpp (o)
12665
12666 top_targets (o)
12667
12668 writedoc
12669
12670 xs_c (o)
12671
12672 xs_cpp (o)
12673
12674 xs_o (o)
12675
12676 perl_archive
12677
12678 perl_archive_after
12679
12680 export_list
12681
12682 =over 4
12683
12684 =item SEE ALSO
12685
12686 =back
12687
12688 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12689 ExtUtils::MakeMaker
12690
12691 =over 4
12692
12693 =item SYNOPSIS
12694
12695 =item DESCRIPTION
12696
12697 =over 4
12698
12699 =item Methods always loaded
12700
12701 wraplist
12702
12703 =back
12704
12705 =back
12706
12707 =over 4
12708
12709 =item Methods
12710
12711 guess_name (override)
12712
12713 =back
12714
12715 find_perl (override)
12716
12717 maybe_command (override)
12718
12719 maybe_command_in_dirs (override)
12720
12721 perl_script (override)
12722
12723 replace_manpage_separator
12724
12725 init_main (override)
12726
12727 init_others (override)
12728
12729 constants (override)
12730
12731 cflags (override)
12732
12733 const_cccmd (override)
12734
12735 pm_to_blib (override)
12736
12737 tool_autosplit (override)
12738
12739 tool_sxubpp (override)
12740
12741 xsubpp_version (override)
12742
12743 tools_other (override)
12744
12745 dist (override)
12746
12747 c_o (override)
12748
12749 xs_c (override)
12750
12751 xs_o (override)
12752
12753 top_targets (override)
12754
12755 dlsyms (override)
12756
12757 dynamic_lib (override)
12758
12759 dynamic_bs (override)
12760
12761 static_lib (override)
12762
12763 manifypods (override)
12764
12765 processPL (override)
12766
12767 installbin (override)
12768
12769 subdir_x (override)
12770
12771 clean (override)
12772
12773 realclean (override)
12774
12775 dist_core (override)
12776
12777 dist_test (override)
12778
12779 install (override)
12780
12781 perldepend (override)
12782
12783 makefile (override)
12784
12785 find_tests (override)
12786
12787 test (override)
12788
12789 makeaperl (override)
12790
12791 nicetext (override)
12792
12793 prefixify (override)
12794
12795 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12796 ExtUtils::MakeMaker
12797
12798 =over 4
12799
12800 =item SYNOPSIS
12801
12802 =item DESCRIPTION
12803
12804 =back
12805
12806 constants (o)
12807
12808 static_lib (o)
12809
12810 dynamic_bs (o)
12811
12812 dynamic_lib (o)
12813
12814 perl_script
12815
12816 pm_to_blib
12817
12818 tool_autosplit (override)
12819
12820 tools_other (o)
12821
12822 xs_o (o)
12823
12824 top_targets (o)
12825
12826 manifypods (o)
12827
12828 dist_ci (o)
12829
12830 dist_core (o)
12831
12832 pasthru (o)
12833
12834 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12835
12836 =over 4
12837
12838 =item SYNOPSIS
12839
12840 =item DESCRIPTION
12841
12842 =back
12843
12844 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12845
12846 =over 4
12847
12848 =item SYNOPSIS
12849
12850 =item DESCRIPTION
12851
12852 =back
12853
12854 =head2 ExtUtils::MakeMaker - create an extension Makefile
12855
12856 =over 4
12857
12858 =item SYNOPSIS
12859
12860 =item DESCRIPTION
12861
12862 =over 4
12863
12864 =item How To Write A Makefile.PL
12865
12866 =item Default Makefile Behaviour
12867
12868 =item make test
12869
12870 =item make testdb
12871
12872 =item make install
12873
12874 =item PREFIX and LIB attribute
12875
12876 =item AFS users
12877
12878 =item Static Linking of a new Perl Binary
12879
12880 =item Determination of Perl Library and Installation Locations
12881
12882 =item Which architecture dependent directory?
12883
12884 =item Using Attributes and Parameters
12885
12886 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12887 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12888 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12889 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12890 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12891 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12892 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12893 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12894 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
12895 LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
12896 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
12897 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
12898 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
12899 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
12900 PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
12901 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
12902 XSPROTOARG, XS_VERSION
12903
12904 =item Additional lowercase attributes
12905
12906 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12907 tool_autosplit
12908
12909 =item Overriding MakeMaker Methods
12910
12911 =item Hintsfile support
12912
12913 =item Distribution Support
12914
12915    make distcheck,    make skipcheck,    make distclean,    make manifest,
12916   make distdir,   make disttest,    make tardist,    make dist,    make
12917 uutardist,    make shdist,    make zipdist,    make ci
12918
12919 =item Disabling an extension
12920
12921 =back
12922
12923 =item ENVIRONMENT
12924
12925 PERL_MM_OPT, PERL_MM_USE_DEFAULT
12926
12927 =item SEE ALSO
12928
12929 =item AUTHORS
12930
12931 =back
12932
12933 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
12934
12935 =over 4
12936
12937 =item SYNOPSIS
12938
12939 =item DESCRIPTION
12940
12941 =item MANIFEST.SKIP
12942
12943 =item EXPORT_OK
12944
12945 =item GLOBAL VARIABLES
12946
12947 =item DIAGNOSTICS
12948
12949 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
12950 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
12951
12952 =item ENVIRONMENT
12953
12954 B<PERL_MM_MANIFEST_DEBUG>
12955
12956 =item SEE ALSO
12957
12958 =item AUTHOR
12959
12960 =back
12961
12962 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
12963
12964 =over 4
12965
12966 =item SYNOPSIS
12967
12968 =item DESCRIPTION
12969
12970 =item SEE ALSO
12971
12972 =back
12973
12974 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
12975
12976 =over 4
12977
12978 =item SYNOPSIS
12979
12980 =item DESCRIPTION
12981
12982 =back
12983
12984 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
12985 extension
12986
12987 =over 4
12988
12989 =item SYNOPSIS
12990
12991 =item DESCRIPTION
12992
12993 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
12994
12995 =item AUTHOR
12996
12997 =item REVISION
12998
12999 =back
13000
13001 =head2 ExtUtils::Packlist - manage .packlist files
13002
13003 =over 4
13004
13005 =item SYNOPSIS
13006
13007 =item DESCRIPTION
13008
13009 =item USAGE
13010
13011 =item FUNCTIONS
13012
13013 new(), read(), write(), validate(), packlist_file()
13014
13015 =item EXAMPLE
13016
13017 =item AUTHOR
13018
13019 =back
13020
13021 =head2 ExtUtils::testlib - add blib/* directories to @INC
13022
13023 =over 4
13024
13025 =item SYNOPSIS
13026
13027 =item DESCRIPTION
13028
13029 =back
13030
13031 =head2 Fatal - replace functions with equivalents which succeed or die
13032
13033 =over 4
13034
13035 =item SYNOPSIS
13036
13037 =item DESCRIPTION
13038
13039 =item AUTHOR
13040
13041 =back
13042
13043 =head2 Fcntl - load the C Fcntl.h defines
13044
13045 =over 4
13046
13047 =item SYNOPSIS
13048
13049 =item DESCRIPTION
13050
13051 =item NOTE
13052
13053 =item EXPORTED SYMBOLS
13054
13055 =back
13056
13057 =head2 File::Basename, fileparse - split a pathname into pieces
13058
13059 =over 4
13060
13061 =item SYNOPSIS
13062
13063 =item DESCRIPTION
13064
13065 fileparse_set_fstype, fileparse
13066
13067 =item EXAMPLES
13068
13069 C<basename>, C<dirname>
13070
13071 =back
13072
13073 =head2 File::CheckTree, validate - run many filetest checks on a tree
13074
13075 =over 4
13076
13077 =item SYNOPSIS
13078
13079 =item DESCRIPTION
13080
13081 =item AUTHOR
13082
13083 =item HISTORY
13084
13085 =back
13086
13087 =head2 File::Compare - Compare files or filehandles
13088
13089 =over 4
13090
13091 =item SYNOPSIS
13092
13093 =item DESCRIPTION
13094
13095 =item RETURN
13096
13097 =item AUTHOR
13098
13099 =back
13100
13101 =head2 File::Copy - Copy files or filehandles
13102
13103 =over 4
13104
13105 =item SYNOPSIS
13106
13107 =item DESCRIPTION
13108
13109 =over 4
13110
13111 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13112
13113 rmscopy($from,$to[,$date_flag])
13114
13115 =back
13116
13117 =item RETURN
13118
13119 =item NOTES
13120
13121 =item AUTHOR
13122
13123 =back
13124
13125 =head2 File::DosGlob - DOS like globbing and then some
13126
13127 =over 4
13128
13129 =item SYNOPSIS
13130
13131 =item DESCRIPTION
13132
13133 =item NOTES
13134
13135 =item EXPORTS (by request only)
13136
13137 =item BUGS
13138
13139 =item AUTHOR
13140
13141 =item HISTORY
13142
13143 =item SEE ALSO
13144
13145 =back
13146
13147 =head2 File::Find - Traverse a directory tree.
13148
13149 =over 4
13150
13151 =item SYNOPSIS
13152
13153 =item DESCRIPTION
13154
13155 B<find>, B<finddepth>
13156
13157 =over 4
13158
13159 =item %options
13160
13161 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13162 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13163 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13164
13165 =item The wanted function
13166
13167 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13168 filename within that directory, C<$File::Find::name> is the complete
13169 pathname to the file
13170
13171 =back
13172
13173 =item WARNINGS
13174
13175 =item CAVEAT
13176
13177 $dont_use_nlink, symlinks
13178
13179 =item NOTES
13180
13181 =item HISTORY
13182
13183 =back
13184
13185 =head2 File::Glob - Perl extension for BSD glob routine
13186
13187 =over 4
13188
13189 =item SYNOPSIS
13190
13191 =item DESCRIPTION
13192
13193 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13194 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13195 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13196
13197 =item DIAGNOSTICS
13198
13199 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13200
13201 =item NOTES
13202
13203 =item AUTHOR
13204
13205 =back
13206
13207 =head2 File::Path - create or remove directory trees
13208
13209 =over 4
13210
13211 =item SYNOPSIS
13212
13213 =item DESCRIPTION
13214
13215 =item AUTHORS
13216
13217 =back
13218
13219 =head2 File::Spec - portably perform operations on file names
13220
13221 =over 4
13222
13223 =item SYNOPSIS
13224
13225 =item DESCRIPTION
13226
13227 =item METHODS
13228
13229 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13230 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13231 splitdir, catpath(), abs2rel, rel2abs()
13232
13233 =item SEE ALSO
13234
13235 =item AUTHORS
13236
13237 =back
13238
13239 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13240
13241 =over 4
13242
13243 =item SYNOPSIS
13244
13245 =item DESCRIPTION
13246
13247 =back
13248
13249 =head2 File::Spec::Epoc - methods for Epoc file specs
13250
13251 =over 4
13252
13253 =item SYNOPSIS
13254
13255 =item DESCRIPTION
13256
13257 canonpath()
13258
13259 =back
13260
13261 =over 4
13262
13263 =item SEE ALSO
13264
13265 =back
13266
13267 =head2 File::Spec::Functions - portably perform operations on file names
13268
13269 =over 4
13270
13271 =item SYNOPSIS
13272
13273 =item DESCRIPTION
13274
13275 =over 4
13276
13277 =item Exports
13278
13279 =back
13280
13281 =item SEE ALSO
13282
13283 =back
13284
13285 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13286
13287 =over 4
13288
13289 =item SYNOPSIS
13290
13291 =item DESCRIPTION
13292
13293 =item METHODS
13294
13295 canonpath
13296
13297 =back
13298
13299 catdir()
13300
13301 catfile
13302
13303 curdir
13304
13305 devnull
13306
13307 rootdir
13308
13309 tmpdir
13310
13311 updir
13312
13313 file_name_is_absolute
13314
13315 path
13316
13317 splitpath
13318
13319 splitdir
13320
13321 catpath
13322
13323 abs2rel
13324
13325 rel2abs
13326
13327 =over 4
13328
13329 =item AUTHORS
13330
13331 =item SEE ALSO
13332
13333 =back
13334
13335 canonpath
13336
13337 splitpath
13338
13339 splitdir
13340
13341 catpath
13342
13343 =head2 File::Spec::OS2 - methods for OS/2 file specs
13344
13345 =over 4
13346
13347 =item SYNOPSIS
13348
13349 =item DESCRIPTION
13350
13351 =back
13352
13353 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13354 modules
13355
13356 =over 4
13357
13358 =item SYNOPSIS
13359
13360 =item DESCRIPTION
13361
13362 =item METHODS
13363
13364 canonpath()
13365
13366 =back
13367
13368 catdir()
13369
13370 catfile
13371
13372 curdir
13373
13374 devnull
13375
13376 rootdir
13377
13378 tmpdir
13379
13380 updir
13381
13382 no_upwards
13383
13384 case_tolerant
13385
13386 file_name_is_absolute
13387
13388 path
13389
13390 join
13391
13392 splitpath
13393
13394 splitdir
13395
13396 catpath()
13397
13398 abs2rel
13399
13400 rel2abs()
13401
13402 =over 4
13403
13404 =item SEE ALSO
13405
13406 =back
13407
13408 =head2 File::Spec::VMS - methods for VMS file specs
13409
13410 =over 4
13411
13412 =item SYNOPSIS
13413
13414 =item DESCRIPTION
13415
13416 eliminate_macros
13417
13418 =back
13419
13420 fixpath
13421
13422 =over 4
13423
13424 =item Methods always loaded
13425
13426 canonpath (override)
13427
13428 =back
13429
13430 catdir
13431
13432 catfile
13433
13434 curdir (override)
13435
13436 devnull (override)
13437
13438 rootdir (override)
13439
13440 tmpdir (override)
13441
13442 updir (override)
13443
13444 case_tolerant (override)
13445
13446 path (override)
13447
13448 file_name_is_absolute (override)
13449
13450 splitpath (override)
13451
13452 splitdir (override)
13453
13454 catpath (override)
13455
13456 abs2rel (override)
13457
13458 rel2abs (override)
13459
13460 =over 4
13461
13462 =item SEE ALSO
13463
13464 =back
13465
13466 =head2 File::Spec::Win32 - methods for Win32 file specs
13467
13468 =over 4
13469
13470 =item SYNOPSIS
13471
13472 =item DESCRIPTION
13473
13474 devnull
13475
13476 =back
13477
13478 tmpdir
13479
13480 catfile
13481
13482 canonpath
13483
13484 splitpath
13485
13486 splitdir
13487
13488 catpath
13489
13490 =over 4
13491
13492 =item SEE ALSO
13493
13494 =back
13495
13496 =head2 File::Temp - return name and handle of a temporary file safely
13497
13498 =over 4
13499
13500 =item PORTABILITY
13501
13502 =item SYNOPSIS
13503
13504 =item DESCRIPTION
13505
13506 =back
13507
13508 =over 4
13509
13510 =item FUNCTIONS
13511
13512 B<tempfile>
13513
13514 =back
13515
13516 B<tempdir>
13517
13518 =over 4
13519
13520 =item MKTEMP FUNCTIONS
13521
13522 B<mkstemp>
13523
13524 =back
13525
13526 B<mkstemps>
13527
13528 B<mkdtemp>
13529
13530 B<mktemp>
13531
13532 =over 4
13533
13534 =item POSIX FUNCTIONS
13535
13536 B<tmpnam>
13537
13538 =back
13539
13540 B<tmpfile>
13541
13542 =over 4
13543
13544 =item ADDITIONAL FUNCTIONS
13545
13546 B<tempnam>
13547
13548 =back
13549
13550 =over 4
13551
13552 =item UTILITY FUNCTIONS
13553
13554 B<unlink0>
13555
13556 =back
13557
13558 =over 4
13559
13560 =item PACKAGE VARIABLES
13561
13562 B<safe_level>, STANDARD, MEDIUM, HIGH
13563
13564 =back
13565
13566 TopSystemUID
13567
13568 =over 4
13569
13570 =item WARNING
13571
13572 =over 4
13573
13574 =item Temporary files and NFS
13575
13576 =back
13577
13578 =item HISTORY
13579
13580 =item SEE ALSO
13581
13582 =item AUTHOR
13583
13584 =back
13585
13586 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13587
13588 =over 4
13589
13590 =item SYNOPSIS
13591
13592 =item DESCRIPTION
13593
13594 =item NOTE
13595
13596 =item AUTHOR
13597
13598 =back
13599
13600 =head2 FileCache - keep more files open than the system permits
13601
13602 =over 4
13603
13604 =item SYNOPSIS
13605
13606 =item DESCRIPTION
13607
13608 cacheout EXPR, cacheout MODE, EXPR
13609
13610 =item CAVEATS
13611
13612 =item BUGS
13613
13614 =back
13615
13616 =head2 FileHandle - supply object methods for filehandles
13617
13618 =over 4
13619
13620 =item SYNOPSIS
13621
13622 =item DESCRIPTION
13623
13624 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13625
13626 =item SEE ALSO
13627
13628 =back
13629
13630 =head2 Filter::Simple - Simplified source filtering
13631
13632 =over 4
13633
13634 =item SYNOPSIS
13635
13636 =item DESCRIPTION
13637
13638 =over 4
13639
13640 =item The Problem
13641
13642 =item A Solution
13643
13644 =item Disabling or changing <no> behaviour
13645
13646 =item All-in-one interface
13647
13648 =item Filtering only specific components of source code
13649
13650 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13651 C<"all">
13652
13653 =item Filtering only the code parts of source code
13654
13655 Most source code ceases to be grammatically correct when it is broken up
13656 into the pieces between string literals and regexes. So the C<'code'>
13657 component filter behaves slightly differently from the other partial
13658 filters
13659 described in the previous section.
13660
13661 =item Using Filter::Simple with an explicit C<import> subroutine
13662
13663 =item Using Filter::Simple and Exporter together
13664
13665 =item How it works
13666
13667 =back
13668
13669 =item AUTHOR
13670
13671 =item COPYRIGHT
13672
13673 =back
13674
13675 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13676
13677 =over 4
13678
13679 =item SYNOPSIS
13680
13681 =item DESCRIPTION
13682
13683 =over 4
13684
13685 =item B<use Filter::Util::Call>
13686
13687 =item B<import()>
13688
13689 =item B<filter() and anonymous sub>
13690
13691 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13692
13693 =back
13694
13695 =item EXAMPLES
13696
13697 =over 4
13698
13699 =item Example 1: A simple filter.
13700
13701 =item Example 2: Using the context
13702
13703 =item Example 3: Using the context within the filter
13704
13705 =item Example 4: Using filter_del
13706
13707 =back
13708
13709 =item Filter::Simple
13710
13711 =item AUTHOR
13712
13713 =item DATE
13714
13715 =back
13716
13717 =head2 FindBin - Locate directory of original perl script
13718
13719 =over 4
13720
13721 =item SYNOPSIS
13722
13723 =item DESCRIPTION
13724
13725 =item EXPORTABLE VARIABLES
13726
13727 =item KNOWN ISSUES
13728
13729 =item KNOWN BUGS
13730
13731 =item AUTHORS
13732
13733 =item COPYRIGHT
13734
13735 =back
13736
13737 =head2 GDBM_File - Perl5 access to the gdbm library.
13738
13739 =over 4
13740
13741 =item SYNOPSIS
13742
13743 =item DESCRIPTION
13744
13745 =item AVAILABILITY
13746
13747 =item BUGS
13748
13749 =item SEE ALSO
13750
13751 =back
13752
13753 =head2 Getopt::Long - Extended processing of command line options
13754
13755 =over 4
13756
13757 =item SYNOPSIS
13758
13759 =item DESCRIPTION
13760
13761 =item Command Line Options, an Introduction
13762
13763 =item Getting Started with Getopt::Long
13764
13765 =over 4
13766
13767 =item Simple options
13768
13769 =item A little bit less simple options
13770
13771 =item Mixing command line option with other arguments
13772
13773 =item Options with values
13774
13775 =item Options with multiple values
13776
13777 =item Options with hash values
13778
13779 =item User-defined subroutines to handle options
13780
13781 =item Options with multiple names
13782
13783 =item Case and abbreviations
13784
13785 =item Summary of Option Specifications
13786
13787 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13788 + [ I<desttype> ]
13789
13790 =back
13791
13792 =item Advanced Possibilities
13793
13794 =over 4
13795
13796 =item Object oriented interface
13797
13798 =item Documentation and help texts
13799
13800 =item Storing options in a hash
13801
13802 =item Bundling
13803
13804 =item The lonesome dash
13805
13806 =item Argument callback
13807
13808 =back
13809
13810 =item Configuring Getopt::Long
13811
13812 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13813 require_order, permute, bundling (default: disabled), bundling_override
13814 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13815 (default: disabled), pass_through (default: disabled), prefix,
13816 prefix_pattern, debug (default: disabled)
13817
13818 =item Return values and Errors
13819
13820 =item Legacy
13821
13822 =over 4
13823
13824 =item Default destinations
13825
13826 =item Alternative option starters
13827
13828 =item Configuration variables
13829
13830 =back
13831
13832 =item Trouble Shooting
13833
13834 =over 4
13835
13836 =item Warning: Ignoring '!' modifier for short option
13837
13838 =item GetOptions does not return a false result when an option is not
13839 supplied
13840
13841 =item GetOptions does not split the command line correctly
13842
13843 =item How do I put a "-?" option into a Getopt::Long?
13844
13845 =back
13846
13847 =item AUTHOR
13848
13849 =item COPYRIGHT AND DISCLAIMER
13850
13851 =back
13852
13853 =head2 Getopt::Std, getopt - Process single-character switches with switch
13854 clustering
13855
13856 =over 4
13857
13858 =item SYNOPSIS
13859
13860 =item DESCRIPTION
13861
13862 =back
13863
13864 =head2 Hash::Util - A selection of general-utility hash subroutines
13865
13866 =over 4
13867
13868 =item SYNOPSIS
13869
13870 =item DESCRIPTION
13871
13872 =over 4
13873
13874 =item Restricted hashes
13875
13876 lock_keys, unlock_keys
13877
13878 =back
13879
13880 =back
13881
13882 lock_value, unlock_value
13883
13884 B<lock_hash>, B<unlock_hash>
13885
13886 =over 4
13887
13888 =item AUTHOR
13889
13890 =item SEE ALSO
13891
13892 =back
13893
13894 =head2 I18N::Collate - compare 8-bit scalar data according to the current
13895 locale
13896
13897 =over 4
13898
13899 =item SYNOPSIS
13900
13901 =item DESCRIPTION
13902
13903 =back
13904
13905 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
13906 tags
13907
13908 =over 4
13909
13910 =item SYNOPSIS
13911
13912 =item DESCRIPTION
13913
13914 =back
13915
13916 the function is_language_tag($lang1)
13917
13918 the function extract_language_tags($whatever)
13919
13920 the function same_language_tag($lang1, $lang2)
13921
13922 the function similarity_language_tag($lang1, $lang2)
13923
13924 the function is_dialect_of($lang1, $lang2)
13925
13926 the function super_languages($lang1)
13927
13928 the function locale2language_tag($locale_identifier)
13929
13930 the function encode_language_tag($lang1)
13931
13932 the function alternate_language_tags($lang1)
13933
13934 the function @langs = panic_languages(@accept_languages)
13935
13936 =over 4
13937
13938 =item ABOUT LOWERCASING
13939
13940 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
13941
13942 =item SEE ALSO
13943
13944 =item COPYRIGHT
13945
13946 =item AUTHOR
13947
13948 =back
13949
13950 =head2 I18N::LangTags::List -- tags and names for human languages
13951
13952 =over 4
13953
13954 =item SYNOPSIS
13955
13956 =item DESCRIPTION
13957
13958 =item ABOUT LANGUAGE TAGS
13959
13960 =item LIST OF LANGUAGES
13961
13962 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
13963 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
13964 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
13965 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
13966 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
13967 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
13968 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
13969 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
13970 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
13971 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
13972 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
13973 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
13974 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
13975 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
13976 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
13977 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
13978 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
13979 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
13980 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
13981 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
13982 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
13983 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
13984 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
13985 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
13986 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
13987 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
13988 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
13989 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
13990 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
13991 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
13992 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
13993 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
13994 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
13995 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
13996 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
13997 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
13998 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
13999 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14000 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14001 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14002 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14003 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14004 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14005 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14006 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14007 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14008 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14009 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14010 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14011 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14012 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14013 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14014 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14015 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14016 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14017 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14018 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14019 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14020 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14021 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14022 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14023 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14024 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14025 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14026 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14027 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14028 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14029 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14030 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14031 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14032 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14033 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14034 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14035 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14036 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14037 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14038 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14039 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14040 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14041 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14042 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14043 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14044 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14045 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14046 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14047 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14048 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14049 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14050 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14051 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14052 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14053 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14054 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14055 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14056 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14057 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14058 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14059 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14060 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14061 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14062 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14063 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14064 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14065 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14066 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14067 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14068 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14069 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14070 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14071 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14072 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14073 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14074 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14075 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14076 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14077 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14078 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14079 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14080 Zhuang, {zu} : Zulu, {zun} : Zuni
14081
14082 =item SEE ALSO
14083
14084 =item COPYRIGHT AND DISCLAIMER
14085
14086 =item AUTHOR
14087
14088 =back
14089
14090 =head2 I18N::Langinfo - query locale information
14091
14092 =over 4
14093
14094 =item SYNOPSIS
14095
14096 =item DESCRIPTION
14097
14098 =over 4
14099
14100 =item EXPORT
14101
14102 =back
14103
14104 =item SEE ALSO
14105
14106 =item AUTHOR
14107
14108 =item COPYRIGHT AND LICENSE
14109
14110 =back
14111
14112 =head2 IO - load various IO modules
14113
14114 =over 4
14115
14116 =item SYNOPSIS
14117
14118 =item DESCRIPTION
14119
14120 =back
14121
14122 =head2 IO::Dir - supply object methods for directory handles
14123
14124 =over 4
14125
14126 =item SYNOPSIS
14127
14128 =item DESCRIPTION
14129
14130 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14131 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14132
14133 =item SEE ALSO
14134
14135 =item AUTHOR
14136
14137 =item COPYRIGHT
14138
14139 =back
14140
14141 =head2 IO::File - supply object methods for filehandles
14142
14143 =over 4
14144
14145 =item SYNOPSIS
14146
14147 =item DESCRIPTION
14148
14149 =item CONSTRUCTOR
14150
14151 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14152
14153 =item METHODS
14154
14155 open( FILENAME [,MODE [,PERMS]] )
14156
14157 =item SEE ALSO
14158
14159 =item HISTORY
14160
14161 =back
14162
14163 =head2 IO::Handle - supply object methods for I/O handles
14164
14165 =over 4
14166
14167 =item SYNOPSIS
14168
14169 =item DESCRIPTION
14170
14171 =item CONSTRUCTOR
14172
14173 new (), new_from_fd ( FD, MODE )
14174
14175 =item METHODS
14176
14177 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14178 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14179 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14180 $io->blocking ( [ BOOL ] ), $io->untaint
14181
14182 =item NOTE
14183
14184 =item SEE ALSO
14185
14186 =item BUGS
14187
14188 =item HISTORY
14189
14190 =back
14191
14192 =head2 IO::Pipe - supply object methods for pipes
14193
14194 =over 4
14195
14196 =item SYNOPSIS
14197
14198 =item DESCRIPTION
14199
14200 =item CONSTRUCTOR
14201
14202 new ( [READER, WRITER] )
14203
14204 =item METHODS
14205
14206 reader ([ARGS]), writer ([ARGS]), handles ()
14207
14208 =item SEE ALSO
14209
14210 =item AUTHOR
14211
14212 =item COPYRIGHT
14213
14214 =back
14215
14216 =head2 IO::Poll - Object interface to system poll call
14217
14218 =over 4
14219
14220 =item SYNOPSIS
14221
14222 =item DESCRIPTION
14223
14224 =item METHODS
14225
14226 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14227 IO ), handles( [ EVENT_MASK ] )
14228
14229 =item SEE ALSO
14230
14231 =item AUTHOR
14232
14233 =item COPYRIGHT
14234
14235 =back
14236
14237 =head2 IO::Seekable - supply seek based methods for I/O objects
14238
14239 =over 4
14240
14241 =item SYNOPSIS
14242
14243 =item DESCRIPTION
14244
14245 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14246 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14247 $io->tell
14248
14249 =item SEE ALSO
14250
14251 =item HISTORY
14252
14253 =back
14254
14255 =head2 IO::Select - OO interface to the select system call
14256
14257 =over 4
14258
14259 =item SYNOPSIS
14260
14261 =item DESCRIPTION
14262
14263 =item CONSTRUCTOR
14264
14265 new ( [ HANDLES ] )
14266
14267 =item METHODS
14268
14269 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14270 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14271 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14272
14273 =item EXAMPLE
14274
14275 =item AUTHOR
14276
14277 =item COPYRIGHT
14278
14279 =back
14280
14281 =head2 IO::Socket - Object interface to socket communications
14282
14283 =over 4
14284
14285 =item SYNOPSIS
14286
14287 =item DESCRIPTION
14288
14289 =item CONSTRUCTOR
14290
14291 new ( [ARGS] )
14292
14293 =item METHODS
14294
14295 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14296 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14297
14298 =item SEE ALSO
14299
14300 =item AUTHOR
14301
14302 =item COPYRIGHT
14303
14304 =back
14305
14306 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14307
14308 =over 4
14309
14310 =item SYNOPSIS
14311
14312 =item DESCRIPTION
14313
14314 =item CONSTRUCTOR
14315
14316 new ( [ARGS] )
14317
14318 =over 4
14319
14320 =item METHODS
14321
14322 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14323 ()
14324
14325 =back
14326
14327 =item SEE ALSO
14328
14329 =item AUTHOR
14330
14331 =item COPYRIGHT
14332
14333 =back
14334
14335 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14336
14337 =over 4
14338
14339 =item SYNOPSIS
14340
14341 =item DESCRIPTION
14342
14343 =item CONSTRUCTOR
14344
14345 new ( [ARGS] )
14346
14347 =item METHODS
14348
14349 hostpath(), peerpath()
14350
14351 =item SEE ALSO
14352
14353 =item AUTHOR
14354
14355 =item COPYRIGHT
14356
14357 =back
14358
14359 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14360 handles
14361
14362 =over 4
14363
14364 =item SYNOPSIS
14365
14366 =item DESCRIPTION
14367
14368 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14369 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14370
14371 =item SEE ALSO
14372
14373 =item AUTHOR
14374
14375 =item COPYRIGHT
14376
14377 =back
14378
14379 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14380
14381 =over 4
14382
14383 =item SYNOPSIS
14384
14385 =item DESCRIPTION
14386
14387 =item CONSTRUCTOR
14388
14389 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14390
14391 =item METHODS
14392
14393 open( FILENAME [,MODE [,PERMS]] )
14394
14395 =item SEE ALSO
14396
14397 =item HISTORY
14398
14399 =back
14400
14401 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14402 handles
14403
14404 =over 4
14405
14406 =item SYNOPSIS
14407
14408 =item DESCRIPTION
14409
14410 =item CONSTRUCTOR
14411
14412 new (), new_from_fd ( FD, MODE )
14413
14414 =item METHODS
14415
14416 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14417 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14418 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14419 $io->blocking ( [ BOOL ] ), $io->untaint
14420
14421 =item NOTE
14422
14423 =item SEE ALSO
14424
14425 =item BUGS
14426
14427 =item HISTORY
14428
14429 =back
14430
14431 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14432
14433 =over 4
14434
14435 =item SYNOPSIS
14436
14437 =item DESCRIPTION
14438
14439 =item CONSTRUCTOR
14440
14441 new ( [READER, WRITER] )
14442
14443 =item METHODS
14444
14445 reader ([ARGS]), writer ([ARGS]), handles ()
14446
14447 =item SEE ALSO
14448
14449 =item AUTHOR
14450
14451 =item COPYRIGHT
14452
14453 =back
14454
14455 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14456
14457 =over 4
14458
14459 =item SYNOPSIS
14460
14461 =item DESCRIPTION
14462
14463 =item METHODS
14464
14465 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14466 IO ), handles( [ EVENT_MASK ] )
14467
14468 =item SEE ALSO
14469
14470 =item AUTHOR
14471
14472 =item COPYRIGHT
14473
14474 =back
14475
14476 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14477 I/O objects
14478
14479 =over 4
14480
14481 =item SYNOPSIS
14482
14483 =item DESCRIPTION
14484
14485 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14486 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14487 $io->tell
14488
14489 =item SEE ALSO
14490
14491 =item HISTORY
14492
14493 =back
14494
14495 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14496 call
14497
14498 =over 4
14499
14500 =item SYNOPSIS
14501
14502 =item DESCRIPTION
14503
14504 =item CONSTRUCTOR
14505
14506 new ( [ HANDLES ] )
14507
14508 =item METHODS
14509
14510 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14511 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14512 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14513
14514 =item EXAMPLE
14515
14516 =item AUTHOR
14517
14518 =item COPYRIGHT
14519
14520 =back
14521
14522 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14523 communications
14524
14525 =over 4
14526
14527 =item SYNOPSIS
14528
14529 =item DESCRIPTION
14530
14531 =item CONSTRUCTOR
14532
14533 new ( [ARGS] )
14534
14535 =item METHODS
14536
14537 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14538 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14539
14540 =item SEE ALSO
14541
14542 =item AUTHOR
14543
14544 =item COPYRIGHT
14545
14546 =back
14547
14548 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14549 AF_INET domain sockets
14550
14551 =over 4
14552
14553 =item SYNOPSIS
14554
14555 =item DESCRIPTION
14556
14557 =item CONSTRUCTOR
14558
14559 new ( [ARGS] )
14560
14561 =over 4
14562
14563 =item METHODS
14564
14565 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14566 ()
14567
14568 =back
14569
14570 =item SEE ALSO
14571
14572 =item AUTHOR
14573
14574 =item COPYRIGHT
14575
14576 =back
14577
14578 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14579 AF_UNIX domain sockets
14580
14581 =over 4
14582
14583 =item SYNOPSIS
14584
14585 =item DESCRIPTION
14586
14587 =item CONSTRUCTOR
14588
14589 new ( [ARGS] )
14590
14591 =item METHODS
14592
14593 hostpath(), peerpath()
14594
14595 =item SEE ALSO
14596
14597 =item AUTHOR
14598
14599 =item COPYRIGHT
14600
14601 =back
14602
14603 =head2 IPC::Msg - SysV Msg IPC object class
14604
14605 =over 4
14606
14607 =item SYNOPSIS
14608
14609 =item DESCRIPTION
14610
14611 =item METHODS
14612
14613 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14614 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14615 FLAGS ] ), stat
14616
14617 =item SEE ALSO
14618
14619 =item AUTHOR
14620
14621 =item COPYRIGHT
14622
14623 =back
14624
14625 =head2 IPC::Open2, open2 - open a process for both reading and writing
14626
14627 =over 4
14628
14629 =item SYNOPSIS
14630
14631 =item DESCRIPTION
14632
14633 =item WARNING
14634
14635 =item SEE ALSO
14636
14637 =back
14638
14639 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14640 handling
14641
14642 =over 4
14643
14644 =item SYNOPSIS
14645
14646 =item DESCRIPTION
14647
14648 =item WARNING
14649
14650 =back
14651
14652 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14653
14654 =over 4
14655
14656 =item SYNOPSIS
14657
14658 =item DESCRIPTION
14659
14660 =item METHODS
14661
14662 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14663 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14664 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14665 , VALUE ), stat
14666
14667 =item SEE ALSO
14668
14669 =item AUTHOR
14670
14671 =item COPYRIGHT
14672
14673 =back
14674
14675 =head2 IPC::SysV - SysV IPC constants
14676
14677 =over 4
14678
14679 =item SYNOPSIS
14680
14681 =item DESCRIPTION
14682
14683 ftok( PATH, ID )
14684
14685 =item SEE ALSO
14686
14687 =item AUTHORS
14688
14689 =item COPYRIGHT
14690
14691 =back
14692
14693 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14694
14695 =over 4
14696
14697 =item SYNOPSIS
14698
14699 =item DESCRIPTION
14700
14701 =item METHODS
14702
14703 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14704 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14705 FLAGS ] ), stat
14706
14707 =item SEE ALSO
14708
14709 =item AUTHOR
14710
14711 =item COPYRIGHT
14712
14713 =back
14714
14715 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14716 class
14717
14718 =over 4
14719
14720 =item SYNOPSIS
14721
14722 =item DESCRIPTION
14723
14724 =item METHODS
14725
14726 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14727 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14728 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14729 , VALUE ), stat
14730
14731 =item SEE ALSO
14732
14733 =item AUTHOR
14734
14735 =item COPYRIGHT
14736
14737 =back
14738
14739 =head2 List::Util - A selection of general-utility list subroutines
14740
14741 =over 4
14742
14743 =item SYNOPSIS
14744
14745 =item DESCRIPTION
14746
14747 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14748 BLOCK LIST, shuffle LIST, sum LIST
14749
14750 =item KNOWN BUGS
14751
14752 =item SUGGESTED ADDITIONS
14753
14754 =item COPYRIGHT
14755
14756 =back
14757
14758 =head2 List::Utilib::List::Util, List::Util - A selection of
14759 general-utility list subroutines
14760
14761 =over 4
14762
14763 =item SYNOPSIS
14764
14765 =item DESCRIPTION
14766
14767 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14768 BLOCK LIST, shuffle LIST, sum LIST
14769
14770 =item KNOWN BUGS
14771
14772 =item SUGGESTED ADDITIONS
14773
14774 =item COPYRIGHT
14775
14776 =back
14777
14778 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14779 general-utility scalar subroutines
14780
14781 =over 4
14782
14783 =item SYNOPSIS
14784
14785 =item DESCRIPTION
14786
14787 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14788 EXPR, tainted EXPR, weaken REF
14789
14790 =item KNOWN BUGS
14791
14792 =item COPYRIGHT
14793
14794 =item BLATANT PLUG
14795
14796 =back
14797
14798 =head2 Locale::Constants - constants for Locale codes
14799
14800 =over 4
14801
14802 =item SYNOPSIS
14803
14804 =item DESCRIPTION
14805
14806 =item KNOWN BUGS AND LIMITATIONS
14807
14808 =item SEE ALSO
14809
14810 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14811
14812 =item AUTHOR
14813
14814 =item COPYRIGHT
14815
14816 =back
14817
14818 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14819
14820 =over 4
14821
14822 =item SYNOPSIS
14823
14824 =item DESCRIPTION
14825
14826 B<alpha-2>, B<alpha-3>, B<numeric>
14827
14828 =item CONVERSION ROUTINES
14829
14830 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14831 country_code2code( CODE, CODESET, CODESET )
14832
14833 =item QUERY ROUTINES
14834
14835 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14836
14837 =item SEMI-PRIVATE ROUTINES
14838
14839 =over 4
14840
14841 =item alias_code
14842
14843 =item rename_country
14844
14845 =back
14846
14847 =item EXAMPLES
14848
14849 =item DOMAIN NAMES
14850
14851 =item KNOWN BUGS AND LIMITATIONS
14852
14853 =item SEE ALSO
14854
14855 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14856 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14857 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14858 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14859
14860 =item AUTHOR
14861
14862 =item COPYRIGHT
14863
14864 =back
14865
14866 =head2 Locale::Currency - ISO three letter codes for currency
14867 identification (ISO 4217)
14868
14869 =over 4
14870
14871 =item SYNOPSIS
14872
14873 =item DESCRIPTION
14874
14875 XTS, XXX
14876
14877 =item CONVERSION ROUTINES
14878
14879 code2currency(), currency2code()
14880
14881 =item QUERY ROUTINES
14882
14883 C<all_currency_codes()>, C<all_currency_names()>
14884
14885 =item EXAMPLES
14886
14887 =item KNOWN BUGS AND LIMITATIONS
14888
14889 =item SEE ALSO
14890
14891 Locale::Country, Locale::Script, ISO 4217:1995,
14892 http://www.bsi-global.com/iso4217currency
14893
14894 =item AUTHOR
14895
14896 =item COPYRIGHT
14897
14898 =back
14899
14900 =head2 Locale::Language - ISO two letter codes for language identification
14901 (ISO 639)
14902
14903 =over 4
14904
14905 =item SYNOPSIS
14906
14907 =item DESCRIPTION
14908
14909 =item CONVERSION ROUTINES
14910
14911 code2language(), language2code()
14912
14913 =item QUERY ROUTINES
14914
14915 C<all_language_codes()>, C<all_language_names()>
14916
14917 =item EXAMPLES
14918
14919 =item KNOWN BUGS AND LIMITATIONS
14920
14921 =item SEE ALSO
14922
14923 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
14924 http://lcweb.loc.gov/standards/iso639-2/langhome.html
14925
14926 =item AUTHOR
14927
14928 =item COPYRIGHT
14929
14930 =back
14931
14932 =head2 Locale::Maketext -- framework for localization
14933
14934 =over 4
14935
14936 =item SYNOPSIS
14937
14938 =item DESCRIPTION
14939
14940 =item QUICK OVERVIEW
14941
14942 =item METHODS
14943
14944 =over 4
14945
14946 =item Construction Methods
14947
14948 =item The "maketext" Method
14949
14950 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
14951
14952 =item Utility Methods
14953
14954 $language->quant($number, $singular), $language->quant($number, $singular,
14955 $plural), $language->quant($number, $singular, $plural, $negative),
14956 $language->numf($number), $language->sprintf($format, @items),
14957 $language->language_tag(), $language->encoding()
14958
14959 =item Language Handle Attributes and Internals
14960
14961 =back
14962
14963 =item LANGUAGE CLASS HIERARCHIES
14964
14965 =item ENTRIES IN EACH LEXICON
14966
14967 =item BRACKET NOTATION
14968
14969 =item AUTO LEXICONS
14970
14971 =item CONTROLLING LOOKUP FAILURE
14972
14973 =item HOW TO USE MAKETEXT
14974
14975 =item SEE ALSO
14976
14977 =item COPYRIGHT AND DISCLAIMER
14978
14979 =item AUTHOR
14980
14981 =back
14982
14983 =head2 Locale::Maketext::TPJ13 -- article about software localization
14984
14985 =over 4
14986
14987 =item SYNOPSIS
14988
14989 =item DESCRIPTION
14990
14991 =item Localization and Perl: gettext breaks, Maketext fixes
14992
14993 =over 4
14994
14995 =item A Localization Horror Story: It Could Happen To You
14996
14997 =item The Linguistic View
14998
14999 =item Breaking gettext
15000
15001 =item Replacing gettext
15002
15003 =item Buzzwords: Abstraction and Encapsulation
15004
15005 =item Buzzword: Isomorphism
15006
15007 =item Buzzword: Inheritance
15008
15009 =item Buzzword: Concision
15010
15011 =item The Devil in the Details
15012
15013 =item The Proof in the Pudding: Localizing Web Sites
15014
15015 =item References
15016
15017 =back
15018
15019 =back
15020
15021 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15022
15023 =over 4
15024
15025 =item SYNOPSIS
15026
15027 =item DESCRIPTION
15028
15029 B<alpha-2>, B<alpha-3>, B<numeric>
15030
15031 =over 4
15032
15033 =item SPECIAL CODES
15034
15035 =back
15036
15037 =item CONVERSION ROUTINES
15038
15039 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15040 script_code2code( CODE, CODESET, CODESET )
15041
15042 =item QUERY ROUTINES
15043
15044 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15045
15046 =item EXAMPLES
15047
15048 =item KNOWN BUGS AND LIMITATIONS
15049
15050 =item SEE ALSO
15051
15052 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15053 http://www.evertype.com/standards/iso15924/
15054
15055 =item AUTHOR
15056
15057 =item COPYRIGHT
15058
15059 =back
15060
15061 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15062
15063 =over 4
15064
15065 =item SYNOPSIS
15066
15067 =item DESCRIPTION
15068
15069 encode_base64($str, [$eol]), decode_base64($str)
15070
15071 =item DIAGNOSTICS
15072
15073 Premature end of base64 data, Premature padding of base64 data
15074
15075 =item EXAMPLES
15076
15077 =item COPYRIGHT
15078
15079 =back
15080
15081 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15082 of quoted-printable strings
15083
15084 =over 4
15085
15086 =item SYNOPSIS
15087
15088 =item DESCRIPTION
15089
15090 encode_qp($str), decode_qp($str);
15091
15092 =item COPYRIGHT
15093
15094 =back
15095
15096 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15097 strings
15098
15099 =over 4
15100
15101 =item SYNOPSIS
15102
15103 =item DESCRIPTION
15104
15105 encode_qp($str), decode_qp($str);
15106
15107 =item COPYRIGHT
15108
15109 =back
15110
15111 =head2 Math::BigFloat - Arbitrary size floating point math package
15112
15113 =over 4
15114
15115 =item SYNOPSIS
15116
15117 =item DESCRIPTION
15118
15119 =over 4
15120
15121 =item Canonical notation
15122
15123 =item Output
15124
15125 =item C<mantissa()>, C<exponent()> and C<parts()>
15126
15127 =item Accuracy vs. Precision
15128
15129 =item Rounding
15130
15131 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15132 ), fround  ( -$scale ) and fround ( 0 )
15133
15134 =back
15135
15136 =item EXAMPLES
15137
15138   # not ready yet
15139
15140 =item Autocreating constants
15141
15142 =over 4
15143
15144 =item Math library
15145
15146 =item Using Math::BigInt::Lite
15147
15148 =back
15149
15150 =item BUGS
15151
15152 =item CAVEAT
15153
15154 stringify, bstr(), bdiv, Modifying and =, bpow
15155
15156 =item LICENSE
15157
15158 =item AUTHORS
15159
15160 =back
15161
15162 =head2 Math::BigInt - Arbitrary size integer math package
15163
15164 =over 4
15165
15166 =item SYNOPSIS
15167
15168 =item DESCRIPTION
15169
15170 Canonical notation, Input, Output
15171
15172 =item METHODS
15173
15174 =over 4
15175
15176 =item config
15177
15178 =item accuracy
15179
15180 =item brsft
15181
15182 =item new
15183
15184 =item bnan
15185
15186 =item bzero
15187
15188 =item binf
15189
15190 =item bone
15191
15192 =item is_one()/is_zero()/is_nan()/is_inf()
15193
15194 =item is_positive()/is_negative()
15195
15196         $x->is_positive();              # true if >= 0
15197         $x->is_negative();              # true if <  0
15198
15199 =item is_odd()/is_even()/is_int()
15200
15201 =item bcmp
15202
15203 =item bacmp
15204
15205 =item sign
15206
15207 =item bcmp
15208
15209 =item bneg
15210
15211 =item babs
15212
15213 =item bnorm
15214
15215 =item bnot
15216
15217 =item binc
15218
15219 =item bdec
15220
15221 =item badd
15222
15223 =item bsub
15224
15225 =item bmul
15226
15227 =item bdiv
15228
15229 =item bmod
15230
15231 =item bmodinv
15232
15233 =item bmodpow
15234
15235 =item bpow
15236
15237 =item blsft
15238
15239 =item brsft
15240
15241 =item band
15242
15243 =item bior
15244
15245 =item bxor
15246
15247 =item bnot
15248
15249 =item bsqrt
15250
15251 =item bfac
15252
15253 =item round
15254
15255 =item bround
15256
15257 =item bfround
15258
15259 =item bfloor
15260
15261 =item bceil
15262
15263 =item bgcd
15264
15265 =item blcm
15266
15267 =item exponent
15268
15269 =item mantissa
15270
15271 =item parts
15272
15273 =item copy
15274
15275 =item as_number
15276
15277 =item bsstr
15278
15279 =item as_hex
15280
15281 =item as_bin
15282
15283 =back
15284
15285 =item ACCURACY and PRECISION
15286
15287 =over 4
15288
15289 =item Precision P
15290
15291 =item Accuracy A
15292
15293 =item Fallback F
15294
15295 =item Rounding mode R
15296
15297 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15298 (significant digits), Setting/Accessing, Creating numbers, Usage,
15299 Precedence, Overriding globals, Local settings, Rounding, Default values,
15300 Remarks
15301
15302 =back
15303
15304 =item INTERNALS
15305
15306 =over 4
15307
15308 =item MATH LIBRARY
15309
15310 =item SIGN
15311
15312 =item mantissa(), exponent() and parts()
15313
15314 =back
15315
15316 =item EXAMPLES
15317
15318   use Math::BigInt;
15319
15320 =item Autocreating constants
15321
15322 =item PERFORMANCE
15323
15324 =over 4
15325
15326 =item Alternative math libraries
15327
15328 =item SUBCLASSING
15329
15330 =back
15331
15332 =item Subclassing Math::BigInt
15333
15334 =item UPGRADING
15335
15336 =over 4
15337
15338 =item Auto-upgrade
15339
15340 bsqrt(), div(), blog()
15341
15342 =back
15343
15344 =item BUGS
15345
15346 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15347
15348 =item CAVEATS
15349
15350 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15351 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15352 types, bsqrt(), brsft()
15353
15354 =item LICENSE
15355
15356 =item SEE ALSO
15357
15358 =item AUTHORS
15359
15360 =back
15361
15362 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15363
15364 =over 4
15365
15366 =item SYNOPSIS
15367
15368 =item DESCRIPTION
15369
15370 =item EXPORT
15371
15372 =item WRAP YOUR OWN
15373
15374 =item LICENSE
15375
15376 This program is free software; you may redistribute it and/or modify it
15377 under
15378 the same terms as Perl itself.
15379
15380 =item AUTHORS
15381
15382 =item SEE ALSO
15383
15384 =back
15385
15386 =head2 Math::BigRat - arbitrarily big rationals
15387
15388 =over 4
15389
15390 =item SYNOPSIS
15391
15392 =item DESCRIPTION
15393
15394 =over 4
15395
15396 =item MATH LIBRARY
15397
15398 =back
15399
15400 =item METHODS
15401
15402 =over 4
15403
15404 =item new()
15405
15406 =item numerator()
15407
15408 =item denominator()
15409
15410         $d = $x->denominator();
15411
15412 =item parts()
15413
15414 =item as_number()
15415
15416 =item bfac()/blog()
15417
15418 =item bround()/round()/bfround()
15419
15420 =back
15421
15422 =item BUGS
15423
15424 perl -Mbigrat -le 'print 1 + 2/3'
15425
15426 =item LICENSE
15427
15428 =item SEE ALSO
15429
15430 =item AUTHORS
15431
15432 =back
15433
15434 =head2 Math::Complex - complex numbers and associated mathematical
15435 functions
15436
15437 =over 4
15438
15439 =item SYNOPSIS
15440
15441 =item DESCRIPTION
15442
15443 =item OPERATIONS
15444
15445 =item CREATION
15446
15447 =item STRINGIFICATION
15448
15449 =over 4
15450
15451 =item CHANGED IN PERL 5.6
15452
15453 =back
15454
15455 =item USAGE
15456
15457 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15458
15459 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15460
15461 =item BUGS
15462
15463 =item AUTHORS
15464
15465 =back
15466
15467 =head2 Math::Trig - trigonometric functions
15468
15469 =over 4
15470
15471 =item SYNOPSIS
15472
15473 =item DESCRIPTION
15474
15475 =item TRIGONOMETRIC FUNCTIONS
15476
15477 B<tan>
15478
15479 =over 4
15480
15481 =item ERRORS DUE TO DIVISION BY ZERO
15482
15483 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15484
15485 =back
15486
15487 =item PLANE ANGLE CONVERSIONS
15488
15489 =item RADIAL COORDINATE CONVERSIONS
15490
15491 =over 4
15492
15493 =item COORDINATE SYSTEMS
15494
15495 =item 3-D ANGLE CONVERSIONS
15496
15497 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15498 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15499
15500 =back
15501
15502 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15503
15504 =item EXAMPLES
15505
15506 =over 4
15507
15508 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15509
15510 =back
15511
15512 =item BUGS
15513
15514 =item AUTHORS
15515
15516 =back
15517
15518 =head2 Memoize - Make functions faster by trading space for time
15519
15520 =over 4
15521
15522 =item SYNOPSIS
15523
15524 =item DESCRIPTION
15525
15526 =item DETAILS
15527
15528 =item OPTIONS
15529
15530 =over 4
15531
15532 =item INSTALL
15533
15534 =item NORMALIZER
15535
15536 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15537
15538 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15539
15540 =back
15541
15542 =item OTHER FACILITIES
15543
15544 =over 4
15545
15546 =item C<unmemoize>
15547
15548 =item C<flush_cache>
15549
15550 =back
15551
15552 =item CAVEATS
15553
15554 =item PERSISTENT CACHE SUPPORT
15555
15556 =item EXPIRATION SUPPORT
15557
15558 =item BUGS
15559
15560 =item MAILING LIST
15561
15562 =item AUTHOR
15563
15564 =item COPYRIGHT AND LICENSE
15565
15566 =item THANK YOU
15567
15568 =back
15569
15570 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15571 Storable use
15572
15573 =over 4
15574
15575 =item DESCRIPTION
15576
15577 =back
15578
15579 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15580 memoized values
15581
15582 =over 4
15583
15584 =item SYNOPSIS
15585
15586 =item DESCRIPTION
15587
15588 =item INTERFACE
15589
15590  TIEHASH,  EXISTS,  STORE
15591
15592 =item ALTERNATIVES
15593
15594 =item CAVEATS
15595
15596 =item AUTHOR
15597
15598 =item SEE ALSO
15599
15600 =back
15601
15602 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15603
15604 =over 4
15605
15606 =item DESCRIPTION
15607
15608 =back
15609
15610 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15611
15612 =over 4
15613
15614 =item DESCRIPTION
15615
15616 =back
15617
15618 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15619 Storable use
15620
15621 =over 4
15622
15623 =item DESCRIPTION
15624
15625 =back
15626
15627 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15628 Storable use
15629
15630 =over 4
15631
15632 =item DESCRIPTION
15633
15634 =back
15635
15636 =head2 Memoize::Storable - store Memoized data in Storable database
15637
15638 =over 4
15639
15640 =item DESCRIPTION
15641
15642 =back
15643
15644 =head2 NDBM_File - Tied access to ndbm files
15645
15646 =over 4
15647
15648 =item SYNOPSIS
15649
15650 =item DESCRIPTION
15651
15652 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15653
15654 =item DIAGNOSTICS
15655
15656 =over 4
15657
15658 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15659
15660 =back
15661
15662 =item BUGS AND WARNINGS
15663
15664 =back
15665
15666 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15667
15668 =over 4
15669
15670 =item SYNOPSIS
15671
15672 =item DESCRIPTION
15673
15674 =over 4
15675
15676 =item Enforcing redispatch
15677
15678 =item Avoiding repetitions
15679
15680 =back
15681
15682 =item AUTHOR
15683
15684 =item BUGS AND IRRITATIONS
15685
15686 =item COPYRIGHT
15687
15688 =back
15689
15690 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15691
15692 =over 4
15693
15694 =item SYNOPSIS
15695
15696 =item DESCRIPTION
15697
15698 =item USER METHODS
15699
15700 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15701 dataend ()
15702
15703 =item CLASS METHODS
15704
15705 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15706 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15707 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15708
15709 =item EXPORTS
15710
15711 =item AUTHOR
15712
15713 =item COPYRIGHT
15714
15715 =back
15716
15717 =head2 Net::Config - Local configuration data for libnet
15718
15719 =over 4
15720
15721 =item SYNOPSYS
15722
15723 =item DESCRIPTION
15724
15725 =item METHODS
15726
15727 requires_firewall HOST
15728
15729 =item NetConfig VALUES
15730
15731 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15732 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15733 ftp_int_pasive, local_netmask, test_hosts, test_exists
15734
15735 =back
15736
15737 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15738 and domain
15739
15740 =over 4
15741
15742 =item SYNOPSIS
15743
15744 =item DESCRIPTION
15745
15746 hostfqdn (), hostname (), hostdomain ()
15747
15748 =item AUTHOR
15749
15750 =item COPYRIGHT
15751
15752 =back
15753
15754 =head2 Net::FTP - FTP Client class
15755
15756 =over 4
15757
15758 =item SYNOPSIS
15759
15760 =item DESCRIPTION
15761
15762 =item OVERVIEW
15763
15764 =item CONSTRUCTOR
15765
15766 new (HOST [,OPTIONS])
15767
15768 =item METHODS
15769
15770 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15771 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15772 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15773 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15774 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15775 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15776 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15777 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15778 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15779 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15780 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15781 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15782 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15783
15784 =over 4
15785
15786 =item Methods for the adventurous
15787
15788 quot (CMD [,ARGS])
15789
15790 =back
15791
15792 =item THE dataconn CLASS
15793
15794 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15795 bytes_read (), abort (), close ()
15796
15797 =item UNIMPLEMENTED
15798
15799 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15800
15801 =item REPORTING BUGS
15802
15803 =item AUTHOR
15804
15805 =item SEE ALSO
15806
15807 =item USE EXAMPLES
15808
15809 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15810
15811 =item CREDITS
15812
15813 =item COPYRIGHT
15814
15815 =back
15816
15817 =head2 Net::NNTP - NNTP Client class
15818
15819 =over 4
15820
15821 =item SYNOPSIS
15822
15823 =item DESCRIPTION
15824
15825 =item CONSTRUCTOR
15826
15827 new ( [ HOST ] [, OPTIONS ])
15828
15829 =item METHODS
15830
15831 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15832 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15833 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15834 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15835 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15836 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15837 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15838
15839 =over 4
15840
15841 =item Extension methods
15842
15843 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15844 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15845 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15846 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15847 GROUP ] ), reader
15848
15849 =back
15850
15851 =item UNSUPPORTED
15852
15853 =item DEFINITIONS
15854
15855 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15856
15857 =item SEE ALSO
15858
15859 =item AUTHOR
15860
15861 =item COPYRIGHT
15862
15863 =back
15864
15865 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15866
15867 =over 4
15868
15869 =item SYNOPSIS
15870
15871 =item DESCRIPTION
15872
15873 =item EXAMPLES
15874
15875 =item CONSTRUCTOR
15876
15877 new ( [ HOST, ] [ OPTIONS ] )
15878
15879 =item METHODS
15880
15881 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15882 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15883 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15884 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15885
15886 =item NOTES
15887
15888 =item SEE ALSO
15889
15890 =item AUTHOR
15891
15892 =item COPYRIGHT
15893
15894 =back
15895
15896 =head2 Net::Ping - check a remote host for reachability
15897
15898 =over 4
15899
15900 =item SYNOPSIS
15901
15902 =item DESCRIPTION
15903
15904 =over 4
15905
15906 =item Functions
15907
15908 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->hires( { 0 | 1 }
15909 );, $p->bind($local_addr);, $p->ping($host [, $timeout]);,
15910 $p->open($host);, $p->close();, pingecho($host [, $timeout]);
15911
15912 =back
15913
15914 =item WARNING
15915
15916 =item NOTES
15917
15918 =item AUTHORS
15919
15920 =item COPYRIGHT
15921
15922 =back
15923
15924 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
15925
15926 =over 4
15927
15928 =item SYNOPSIS
15929
15930 =item DESCRIPTION
15931
15932 =item EXAMPLES
15933
15934 =item CONSTRUCTOR
15935
15936 new Net::SMTP [ HOST, ] [ OPTIONS ]
15937
15938 =item METHODS
15939
15940 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
15941 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
15942 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
15943 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
15944 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
15945 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
15946 quit ()
15947
15948 =item ADDRESSES
15949
15950 =item SEE ALSO
15951
15952 =item AUTHOR
15953
15954 =item COPYRIGHT
15955
15956 =back
15957
15958 =head2 Net::Time - time and daytime network client interface
15959
15960 =over 4
15961
15962 =item SYNOPSIS
15963
15964 =item DESCRIPTION
15965
15966 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
15967 PROTOCOL [, TIMEOUT]]])
15968
15969 =item AUTHOR
15970
15971 =item COPYRIGHT
15972
15973 =back
15974
15975 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
15976 functions
15977
15978 =over 4
15979
15980 =item SYNOPSIS
15981
15982 =item DESCRIPTION
15983
15984 =item EXAMPLES
15985
15986 =item NOTE
15987
15988 =item AUTHOR
15989
15990 =back
15991
15992 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
15993
15994 =over 4
15995
15996 =item DESCRIPTION
15997
15998 =over 4
15999
16000 =item Where to get this document
16001
16002 =item How to contribute to this document
16003
16004 =back
16005
16006 =item Author and Copyright Information
16007
16008 =over 4
16009
16010 =item Disclaimer
16011
16012 =back
16013
16014 =item Obtaining and installing libnet
16015
16016 =over 4
16017
16018 =item What is libnet ?
16019
16020 =item Which version of perl do I need ?
16021
16022 =item What other modules do I need ?
16023
16024 =item What machines support libnet ?
16025
16026 =item Where can I get the latest libnet release
16027
16028 =back
16029
16030 =item Using Net::FTP
16031
16032 =over 4
16033
16034 =item How do I download files from an FTP server ?
16035
16036 =item How do I transfer files in binary mode ?
16037
16038 =item How can I get the size of a file on a remote FTP server ?
16039
16040 =item How can I get the modification time of a file on a remote FTP server
16041 ?
16042
16043 =item How can I change the permissions of a file on a remote server ?
16044
16045 =item Can I do a reget operation like the ftp command ?
16046
16047 =item How do I get a directory listing from an FTP server ?
16048
16049 =item Changing directory to "" does not fail ?
16050
16051 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16052
16053 =item I am behind an FTP proxy firewall, but cannot access machines outside
16054 ?
16055
16056 =item My ftp proxy firewall does not listen on port 21
16057
16058 =item Is it possible to change the file permissions of a file on an FTP
16059 server ?
16060
16061 =item I have seen scripts call a method message, but cannot find it
16062 documented ?
16063
16064 =item Why does Net::FTP not implement mput and mget methods
16065
16066 =back
16067
16068 =item Using Net::SMTP
16069
16070 =over 4
16071
16072 =item Why can't the part of an Email address after the @ be used as the
16073 hostname ?
16074
16075 =item Why does Net::SMTP not do DNS MX lookups ?
16076
16077 =item The verify method always returns true ?
16078
16079 =back
16080
16081 =item Debugging scripts
16082
16083 =over 4
16084
16085 =item How can I debug my scripts that use Net::* modules ?
16086
16087 =back
16088
16089 =item AUTHOR AND COPYRIGHT
16090
16091 =back
16092
16093 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16094 functions
16095
16096 =over 4
16097
16098 =item SYNOPSIS
16099
16100 =item DESCRIPTION
16101
16102 =item EXAMPLES
16103
16104 =item NOTE
16105
16106 =item AUTHOR
16107
16108 =back
16109
16110 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16111 functions
16112
16113 =over 4
16114
16115 =item SYNOPSIS
16116
16117 =item DESCRIPTION
16118
16119 =item NOTE
16120
16121 =item AUTHOR
16122
16123 =back
16124
16125 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16126 functions
16127
16128 =over 4
16129
16130 =item SYNOPSIS
16131
16132 =item DESCRIPTION
16133
16134 =item EXAMPLES
16135
16136 =item NOTE
16137
16138 =item AUTHOR
16139
16140 =back
16141
16142 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16143
16144 =over 4
16145
16146 =item SYNOPSIS
16147
16148 =item DESCRIPTION
16149
16150 =item THE .netrc FILE
16151
16152 machine name, default, login name, password string, account string, macdef
16153 name
16154
16155 =item CONSTRUCTOR
16156
16157 lookup ( MACHINE [, LOGIN ])
16158
16159 =item METHODS
16160
16161 login (), password (), account (), lpa ()
16162
16163 =item AUTHOR
16164
16165 =item SEE ALSO
16166
16167 =item COPYRIGHT
16168
16169 =back
16170
16171 =head2 O - Generic interface to Perl Compiler backends
16172
16173 =over 4
16174
16175 =item SYNOPSIS
16176
16177 =item DESCRIPTION
16178
16179 =item CONVENTIONS
16180
16181 =item IMPLEMENTATION
16182
16183 =item BUGS
16184
16185 =item AUTHOR
16186
16187 =back
16188
16189 =head2 ODBM_File - Tied access to odbm files
16190
16191 =over 4
16192
16193 =item SYNOPSIS
16194
16195 =item DESCRIPTION
16196
16197 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16198
16199 =item DIAGNOSTICS
16200
16201 =over 4
16202
16203 =item C<odbm store returned -1, errno 22, key "..." at ...>
16204
16205 =back
16206
16207 =item BUGS AND WARNINGS
16208
16209 =back
16210
16211 =head2 Opcode - Disable named opcodes when compiling perl code
16212
16213 =over 4
16214
16215 =item SYNOPSIS
16216
16217 =item DESCRIPTION
16218
16219 =item NOTE
16220
16221 =item WARNING
16222
16223 =item Operator Names and Operator Lists
16224
16225 an operator name (opname), an operator tag name (optag), a negated opname
16226 or optag, an operator set (opset)
16227
16228 =item Opcode Functions
16229
16230 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16231 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16232 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16233 opdump (PAT)
16234
16235 =item Manipulating Opsets
16236
16237 =item TO DO (maybe)
16238
16239 =back
16240
16241 =over 4
16242
16243 =item Predefined Opcode Tags
16244
16245 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16246 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16247 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16248 :dangerous
16249
16250 =item SEE ALSO
16251
16252 =item AUTHORS
16253
16254 =back
16255
16256 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16257 compartments
16258
16259 =over 4
16260
16261 =item SYNOPSIS
16262
16263 =item DESCRIPTION
16264
16265 a new namespace, an operator mask
16266
16267 =item WARNING
16268
16269 =over 4
16270
16271 =item RECENT CHANGES
16272
16273 =item Methods in class Safe
16274
16275 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16276 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16277 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16278 root (NAMESPACE), mask (MASK)
16279
16280 =item Some Safety Issues
16281
16282 Memory, CPU, Snooping, Signals, State Changes
16283
16284 =item AUTHOR
16285
16286 =back
16287
16288 =back
16289
16290 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16291 compiling
16292
16293 =over 4
16294
16295 =item SYNOPSIS
16296
16297 =item DESCRIPTION
16298
16299 =item SEE ALSO
16300
16301 =back
16302
16303 =head2 POSIX - Perl interface to IEEE Std 1003.1
16304
16305 =over 4
16306
16307 =item SYNOPSIS
16308
16309 =item DESCRIPTION
16310
16311 =item NOTE
16312
16313 =item CAVEATS
16314
16315 =item FUNCTIONS
16316
16317 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16318 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16319 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16320 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16321 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16322 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16323 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16324 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16325 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16326 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16327 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16328 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16329 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16330 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16331 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16332 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16333 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16334 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16335 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16336 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16337 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16338 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16339 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16340 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16341 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16342 wctomb, write
16343
16344 =item CLASSES
16345
16346 =over 4
16347
16348 =item POSIX::SigAction
16349
16350 new
16351
16352 =item POSIX::SigSet
16353
16354 new, addset, delset, emptyset, fillset, ismember
16355
16356 =item POSIX::Termios
16357
16358 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16359 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16360 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16361 field values, c_cflag field values, c_iflag field values, c_lflag field
16362 values, c_oflag field values
16363
16364 =back
16365
16366 =item PATHNAME CONSTANTS
16367
16368 Constants
16369
16370 =item POSIX CONSTANTS
16371
16372 Constants
16373
16374 =item SYSTEM CONFIGURATION
16375
16376 Constants
16377
16378 =item ERRNO
16379
16380 Constants
16381
16382 =item FCNTL
16383
16384 Constants
16385
16386 =item FLOAT
16387
16388 Constants
16389
16390 =item LIMITS
16391
16392 Constants
16393
16394 =item LOCALE
16395
16396 Constants
16397
16398 =item MATH
16399
16400 Constants
16401
16402 =item SIGNAL
16403
16404 Constants
16405
16406 =item STAT
16407
16408 Constants, Macros
16409
16410 =item STDLIB
16411
16412 Constants
16413
16414 =item STDIO
16415
16416 Constants
16417
16418 =item TIME
16419
16420 Constants
16421
16422 =item UNISTD
16423
16424 Constants
16425
16426 =item WAIT
16427
16428 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16429 WTERMSIG, WIFSTOPPED, WSTOPSIG
16430
16431 =back
16432
16433 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16434 name space
16435
16436 =over 4
16437
16438 =item SYNOPSIS
16439
16440 =item DESCRIPTION
16441
16442 unix, stdio, perlio, crlf, utf8, bytes, raw
16443
16444 =over 4
16445
16446 =item Defaults and how to override them
16447
16448 =back
16449
16450 =item AUTHOR
16451
16452 =item SEE ALSO
16453
16454 =back
16455
16456 =head2 PerlIO::Scalar - support module for in-memory IO.
16457
16458 =over 4
16459
16460 =item SYNOPSIS
16461
16462 =item DESCRIPTION
16463
16464 =back
16465
16466 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
16467
16468 =over 4
16469
16470 =item SYNOPSIS
16471
16472 =item DESCRIPTION
16473
16474 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16475 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
16476 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
16477 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16478 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16479 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16480 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16481
16482 =over 4
16483
16484 =item Example - a Hexadecimal Handle
16485
16486 =back
16487
16488 =back
16489
16490 =head2 PerlIO::encoding - encoding layer
16491
16492 =over 4
16493
16494 =item SYNOPSIS
16495
16496 =item DESCRIPTION
16497
16498 =item SEE ALSO
16499
16500 =back
16501
16502 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16503
16504 =over 4
16505
16506 =item SYNOPSIS
16507
16508 =item OPTIONS/ARGUMENTS
16509
16510 =over 4
16511
16512 =item podchecker()
16513
16514 B<-warnings> =E<gt> I<val>
16515
16516 =back
16517
16518 =item DESCRIPTION
16519
16520 =item DIAGNOSTICS
16521
16522 =over 4
16523
16524 =item Errors
16525
16526 empty =headn, =over on line I<N> without closing =back, =item without
16527 previous =over, =back without previous =over, No argument for =begin, =end
16528 without =begin, Nested =begin's, =for without formatter specification,
16529 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16530 interior-sequence "I<SEQ>", nested commands
16531 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16532 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16533 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16534 after =back
16535
16536 =item Warnings
16537
16538 multiple occurence of link target I<name>, line containing nothing but
16539 whitespace in paragraph, file does not start with =head, previous =item has
16540 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16541 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16542 items in =over, No argument for =item, empty section in previous paragraph,
16543 Verbatim paragraph in NAME section
16544
16545 =item Hyperlinks
16546
16547 ignoring leading/trailing whitespace in link, (section) in '$page'
16548 deprecated, alternative text/node '%s' contains non-escaped | or /
16549
16550 =back
16551
16552 =item RETURN VALUE
16553
16554 =item EXAMPLES
16555
16556 =item INTERFACE
16557
16558 =back
16559
16560 C<Pod::Checker-E<gt>new( %options )>
16561
16562 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16563 @args )>
16564
16565 C<$checker-E<gt>num_errors()>
16566
16567 C<$checker-E<gt>name()>
16568
16569 C<$checker-E<gt>node()>
16570
16571 C<$checker-E<gt>idx()>
16572
16573 C<$checker-E<gt>hyperlink()>
16574
16575 =over 4
16576
16577 =item AUTHOR
16578
16579 =back
16580
16581 =head2 Pod::Find - find POD documents in directory trees
16582
16583 =over 4
16584
16585 =item SYNOPSIS
16586
16587 =item DESCRIPTION
16588
16589 =back
16590
16591 =over 4
16592
16593 =item C<pod_find( { %opts } , @directories )>
16594
16595 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16596 1>
16597
16598 =back
16599
16600 =over 4
16601
16602 =item C<simplify_name( $str )>
16603
16604 =back
16605
16606 =over 4
16607
16608 =item C<pod_where( { %opts }, $pod )>
16609
16610 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16611 1>
16612
16613 =back
16614
16615 =over 4
16616
16617 =item C<contains_pod( $file , $verbose )>
16618
16619 =back
16620
16621 =over 4
16622
16623 =item AUTHOR
16624
16625 =item SEE ALSO
16626
16627 =back
16628
16629 =head2 Pod::Html - module to convert pod files to HTML
16630
16631 =over 4
16632
16633 =item SYNOPSIS
16634
16635 =item DESCRIPTION
16636
16637 =item ARGUMENTS
16638
16639 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16640 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16641 title, verbose
16642
16643 =item EXAMPLE
16644
16645 =item ENVIRONMENT
16646
16647 =item AUTHOR
16648
16649 =item SEE ALSO
16650
16651 =item COPYRIGHT
16652
16653 =back
16654
16655 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16656 commands, etc.
16657
16658 =over 4
16659
16660 =item SYNOPSIS
16661
16662 =item REQUIRES
16663
16664 =item EXPORTS
16665
16666 =item DESCRIPTION
16667
16668 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16669 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16670
16671 =back
16672
16673 =over 4
16674
16675 =item B<Pod::InputSource>
16676
16677 =back
16678
16679 =over 4
16680
16681 =item B<new()>
16682
16683 =back
16684
16685 =over 4
16686
16687 =item B<name()>
16688
16689 =back
16690
16691 =over 4
16692
16693 =item B<handle()>
16694
16695 =back
16696
16697 =over 4
16698
16699 =item B<was_cutting()>
16700
16701 =back
16702
16703 =over 4
16704
16705 =item B<Pod::Paragraph>
16706
16707 =back
16708
16709 =over 4
16710
16711 =item Pod::Paragraph-E<gt>B<new()>
16712
16713 =back
16714
16715 =over 4
16716
16717 =item $pod_para-E<gt>B<cmd_name()>
16718
16719 =back
16720
16721 =over 4
16722
16723 =item $pod_para-E<gt>B<text()>
16724
16725 =back
16726
16727 =over 4
16728
16729 =item $pod_para-E<gt>B<raw_text()>
16730
16731 =back
16732
16733 =over 4
16734
16735 =item $pod_para-E<gt>B<cmd_prefix()>
16736
16737 =back
16738
16739 =over 4
16740
16741 =item $pod_para-E<gt>B<cmd_separator()>
16742
16743 =back
16744
16745 =over 4
16746
16747 =item $pod_para-E<gt>B<parse_tree()>
16748
16749 =back
16750
16751 =over 4
16752
16753 =item $pod_para-E<gt>B<file_line()>
16754
16755 =back
16756
16757 =over 4
16758
16759 =item B<Pod::InteriorSequence>
16760
16761 =back
16762
16763 =over 4
16764
16765 =item Pod::InteriorSequence-E<gt>B<new()>
16766
16767 =back
16768
16769 =over 4
16770
16771 =item $pod_seq-E<gt>B<cmd_name()>
16772
16773 =back
16774
16775 =over 4
16776
16777 =item $pod_seq-E<gt>B<prepend()>
16778
16779 =back
16780
16781 =over 4
16782
16783 =item $pod_seq-E<gt>B<append()>
16784
16785 =back
16786
16787 =over 4
16788
16789 =item $pod_seq-E<gt>B<nested()>
16790
16791 =back
16792
16793 =over 4
16794
16795 =item $pod_seq-E<gt>B<raw_text()>
16796
16797 =back
16798
16799 =over 4
16800
16801 =item $pod_seq-E<gt>B<left_delimiter()>
16802
16803 =back
16804
16805 =over 4
16806
16807 =item $pod_seq-E<gt>B<right_delimiter()>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item $pod_seq-E<gt>B<parse_tree()>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item $pod_seq-E<gt>B<file_line()>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item Pod::InteriorSequence::B<DESTROY()>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item B<Pod::ParseTree>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item Pod::ParseTree-E<gt>B<new()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item $ptree-E<gt>B<top()>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item $ptree-E<gt>B<children()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item $ptree-E<gt>B<prepend()>
16856
16857 =back
16858
16859 =over 4
16860
16861 =item $ptree-E<gt>B<append()>
16862
16863 =back
16864
16865 =over 4
16866
16867 =item $ptree-E<gt>B<raw_text()>
16868
16869 =back
16870
16871 =over 4
16872
16873 =item Pod::ParseTree::B<DESTROY()>
16874
16875 =back
16876
16877 =over 4
16878
16879 =item SEE ALSO
16880
16881 =item AUTHOR
16882
16883 =back
16884
16885 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
16886
16887 =over 4
16888
16889 =item SYNOPSIS
16890
16891 =item DESCRIPTION
16892
16893 =back
16894
16895 =over 4
16896
16897 =item OBJECT METHODS
16898
16899 C<initialize>
16900
16901 =back
16902
16903 =over 4
16904
16905 =item Data Accessors
16906
16907 B<AddPreamble>
16908
16909 =back
16910
16911 B<AddPostamble>
16912
16913 B<Head1Level>
16914
16915 B<Label>
16916
16917 B<LevelNoNum>
16918
16919 B<MakeIndex>
16920
16921 B<ReplaceNAMEwithSection>
16922
16923 B<StartWithNewPage>
16924
16925 B<TableOfContents>
16926
16927 B<UniqueLabels>
16928
16929 B<UserPreamble>
16930
16931 B<UserPostamble>
16932
16933 B<Lists>
16934
16935 =over 4
16936
16937 =item Subclassed methods
16938
16939 =back
16940
16941 B<begin_pod>
16942
16943 B<end_pod>
16944
16945 B<command>
16946
16947 B<verbatim>
16948
16949 B<textblock>
16950
16951 B<interior_sequence>
16952
16953 =over 4
16954
16955 =item List Methods
16956
16957 B<begin_list>
16958
16959 =back
16960
16961 B<end_list>
16962
16963 B<add_item>
16964
16965 =over 4
16966
16967 =item Methods for headings
16968
16969 B<head>
16970
16971 =back
16972
16973 =over 4
16974
16975 =item Internal methods
16976
16977 B<_output>
16978
16979 =back
16980
16981 B<_replace_special_chars>
16982
16983 B<_replace_special_chars_late>
16984
16985 B<_create_label>
16986
16987 B<_create_index>
16988
16989 B<_clean_latex_commands>
16990
16991 B<_split_delimited>
16992
16993 =over 4
16994
16995 =item NOTES
16996
16997 =item SEE ALSO
16998
16999 =item AUTHORS
17000
17001 =item COPYRIGHT
17002
17003 =item REVISION
17004
17005 =back
17006
17007 =head2 Pod::Man - Convert POD data to formatted *roff input
17008
17009 =over 4
17010
17011 =item SYNOPSIS
17012
17013 =item DESCRIPTION
17014
17015 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17016 release, section
17017
17018 =item DIAGNOSTICS
17019
17020 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17021 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17022 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17023 =back
17024
17025 =item BUGS
17026
17027 =item CAVEATS
17028
17029 =item SEE ALSO
17030
17031 =item AUTHOR
17032
17033 =item COPYRIGHT AND LICENSE
17034
17035 =back
17036
17037 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17038
17039 =over 4
17040
17041 =item SYNOPSIS
17042
17043 =item DESCRIPTION
17044
17045 =item AUTHOR
17046
17047 =item COPYRIGHT AND LICENSE
17048
17049 =back
17050
17051 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17052
17053 =over 4
17054
17055 =item SYNOPSIS
17056
17057 =item DESCRIPTION
17058
17059 =back
17060
17061 =over 4
17062
17063 =item Pod::List
17064
17065 Pod::List-E<gt>new()
17066
17067 =back
17068
17069 $list-E<gt>file()
17070
17071 $list-E<gt>start()
17072
17073 $list-E<gt>indent()
17074
17075 $list-E<gt>type()
17076
17077 $list-E<gt>rx()
17078
17079 $list-E<gt>item()
17080
17081 $list-E<gt>parent()
17082
17083 $list-E<gt>tag()
17084
17085 =over 4
17086
17087 =item Pod::Hyperlink
17088
17089 Pod::Hyperlink-E<gt>new()
17090
17091 =back
17092
17093 $link-E<gt>parse($string)
17094
17095 $link-E<gt>markup($string)
17096
17097 $link-E<gt>text()
17098
17099 $link-E<gt>warning()
17100
17101 $link-E<gt>file(), $link-E<gt>line()
17102
17103 $link-E<gt>page()
17104
17105 $link-E<gt>node()
17106
17107 $link-E<gt>alttext()
17108
17109 $link-E<gt>type()
17110
17111 $link-E<gt>link()
17112
17113 =over 4
17114
17115 =item Pod::Cache
17116
17117 Pod::Cache-E<gt>new()
17118
17119 =back
17120
17121 $cache-E<gt>item()
17122
17123 $cache-E<gt>find_page($name)
17124
17125 =over 4
17126
17127 =item Pod::Cache::Item
17128
17129 Pod::Cache::Item-E<gt>new()
17130
17131 =back
17132
17133 $cacheitem-E<gt>page()
17134
17135 $cacheitem-E<gt>description()
17136
17137 $cacheitem-E<gt>path()
17138
17139 $cacheitem-E<gt>file()
17140
17141 $cacheitem-E<gt>nodes()
17142
17143 $cacheitem-E<gt>find_node($name)
17144
17145 $cacheitem-E<gt>idx()
17146
17147 =over 4
17148
17149 =item AUTHOR
17150
17151 =item SEE ALSO
17152
17153 =back
17154
17155 =head2 Pod::Parser - base class for creating POD filters and translators
17156
17157 =over 4
17158
17159 =item SYNOPSIS
17160
17161 =item REQUIRES
17162
17163 =item EXPORTS
17164
17165 =item DESCRIPTION
17166
17167 =item QUICK OVERVIEW
17168
17169 =item PARSING OPTIONS
17170
17171 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17172 B<-warnings> (default: unset)
17173
17174 =back
17175
17176 =over 4
17177
17178 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17179
17180 =back
17181
17182 =over 4
17183
17184 =item B<command()>
17185
17186 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17187
17188 =back
17189
17190 =over 4
17191
17192 =item B<verbatim()>
17193
17194 C<$text>, C<$line_num>, C<$pod_para>
17195
17196 =back
17197
17198 =over 4
17199
17200 =item B<textblock()>
17201
17202 C<$text>, C<$line_num>, C<$pod_para>
17203
17204 =back
17205
17206 =over 4
17207
17208 =item B<interior_sequence()>
17209
17210 =back
17211
17212 =over 4
17213
17214 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17215
17216 =back
17217
17218 =over 4
17219
17220 =item B<new()>
17221
17222 =back
17223
17224 =over 4
17225
17226 =item B<initialize()>
17227
17228 =back
17229
17230 =over 4
17231
17232 =item B<begin_pod()>
17233
17234 =back
17235
17236 =over 4
17237
17238 =item B<begin_input()>
17239
17240 =back
17241
17242 =over 4
17243
17244 =item B<end_input()>
17245
17246 =back
17247
17248 =over 4
17249
17250 =item B<end_pod()>
17251
17252 =back
17253
17254 =over 4
17255
17256 =item B<preprocess_line()>
17257
17258 =back
17259
17260 =over 4
17261
17262 =item B<preprocess_paragraph()>
17263
17264 =back
17265
17266 =over 4
17267
17268 =item METHODS FOR PARSING AND PROCESSING
17269
17270 =back
17271
17272 =over 4
17273
17274 =item B<parse_text()>
17275
17276 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17277 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17278 I<code-ref>|I<method-name>
17279
17280 =back
17281
17282 =over 4
17283
17284 =item B<interpolate()>
17285
17286 =back
17287
17288 =over 4
17289
17290 =item B<parse_paragraph()>
17291
17292 =back
17293
17294 =over 4
17295
17296 =item B<parse_from_filehandle()>
17297
17298 =back
17299
17300 =over 4
17301
17302 =item B<parse_from_file()>
17303
17304 =back
17305
17306 =over 4
17307
17308 =item ACCESSOR METHODS
17309
17310 =back
17311
17312 =over 4
17313
17314 =item B<errorsub()>
17315
17316 =back
17317
17318 =over 4
17319
17320 =item B<cutting()>
17321
17322 =back
17323
17324 =over 4
17325
17326 =item B<parseopts()>
17327
17328 =back
17329
17330 =over 4
17331
17332 =item B<output_file()>
17333
17334 =back
17335
17336 =over 4
17337
17338 =item B<output_handle()>
17339
17340 =back
17341
17342 =over 4
17343
17344 =item B<input_file()>
17345
17346 =back
17347
17348 =over 4
17349
17350 =item B<input_handle()>
17351
17352 =back
17353
17354 =over 4
17355
17356 =item B<input_streams()>
17357
17358 =back
17359
17360 =over 4
17361
17362 =item B<top_stream()>
17363
17364 =back
17365
17366 =over 4
17367
17368 =item PRIVATE METHODS AND DATA
17369
17370 =back
17371
17372 =over 4
17373
17374 =item B<_push_input_stream()>
17375
17376 =back
17377
17378 =over 4
17379
17380 =item B<_pop_input_stream()>
17381
17382 =back
17383
17384 =over 4
17385
17386 =item TREE-BASED PARSING
17387
17388 =item SEE ALSO
17389
17390 =item AUTHOR
17391
17392 =back
17393
17394 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17395
17396 =over 4
17397
17398 =item SYNOPSIS
17399
17400 =item DESCRIPTION
17401
17402 =over 4
17403
17404 =item EXPORT
17405
17406 =back
17407
17408 =item AUTHOR
17409
17410 =item SEE ALSO
17411
17412 =back
17413
17414 =head2 Pod::Select, podselect() - extract selected sections of POD from
17415 input
17416
17417 =over 4
17418
17419 =item SYNOPSIS
17420
17421 =item REQUIRES
17422
17423 =item EXPORTS
17424
17425 =item DESCRIPTION
17426
17427 =item SECTION SPECIFICATIONS
17428
17429 =item RANGE SPECIFICATIONS
17430
17431 =back
17432
17433 =over 4
17434
17435 =item OBJECT METHODS
17436
17437 =back
17438
17439 =over 4
17440
17441 =item B<curr_headings()>
17442
17443 =back
17444
17445 =over 4
17446
17447 =item B<select()>
17448
17449 =back
17450
17451 =over 4
17452
17453 =item B<add_selection()>
17454
17455 =back
17456
17457 =over 4
17458
17459 =item B<clear_selections()>
17460
17461 =back
17462
17463 =over 4
17464
17465 =item B<match_section()>
17466
17467 =back
17468
17469 =over 4
17470
17471 =item B<is_selected()>
17472
17473 =back
17474
17475 =over 4
17476
17477 =item EXPORTED FUNCTIONS
17478
17479 =back
17480
17481 =over 4
17482
17483 =item B<podselect()>
17484
17485 B<-output>, B<-sections>, B<-ranges>
17486
17487 =back
17488
17489 =over 4
17490
17491 =item PRIVATE METHODS AND DATA
17492
17493 =back
17494
17495 =over 4
17496
17497 =item B<_compile_section_spec()>
17498
17499 =back
17500
17501 =over 4
17502
17503 =item $self->{_SECTION_HEADINGS}
17504
17505 =back
17506
17507 =over 4
17508
17509 =item $self->{_SELECTED_SECTIONS}
17510
17511 =back
17512
17513 =over 4
17514
17515 =item SEE ALSO
17516
17517 =item AUTHOR
17518
17519 =back
17520
17521 =head2 Pod::Text - Convert POD data to formatted ASCII text
17522
17523 =over 4
17524
17525 =item SYNOPSIS
17526
17527 =item DESCRIPTION
17528
17529 alt, code, indent, loose, quotes, sentence, width
17530
17531 =item DIAGNOSTICS
17532
17533 Bizarre space in item, Item called without tag, Can't open %s for reading:
17534 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17535 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17536 Unmatched =back
17537
17538 =item RESTRICTIONS
17539
17540 =item NOTES
17541
17542 =item SEE ALSO
17543
17544 =item AUTHOR
17545
17546 =item COPYRIGHT AND LICENSE
17547
17548 =back
17549
17550 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17551
17552 =over 4
17553
17554 =item SYNOPSIS
17555
17556 =item DESCRIPTION
17557
17558 =item BUGS
17559
17560 =item SEE ALSO
17561
17562 =item AUTHOR
17563
17564 =item COPYRIGHT AND LICENSE
17565
17566 =back
17567
17568 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17569 text
17570
17571 =over 4
17572
17573 =item SYNOPSIS
17574
17575 =item DESCRIPTION
17576
17577 =item BUGS
17578
17579 =item SEE ALSO
17580
17581 =item AUTHOR
17582
17583 =item COPYRIGHT AND LICENSE
17584
17585 =back
17586
17587 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17588 text with format escapes
17589
17590 =over 4
17591
17592 =item SYNOPSIS
17593
17594 =item DESCRIPTION
17595
17596 =item NOTES
17597
17598 =item SEE ALSO
17599
17600 =item AUTHOR
17601
17602 =item COPYRIGHT AND LICENSE
17603
17604 =back
17605
17606 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17607 documentation
17608
17609 =over 4
17610
17611 =item SYNOPSIS
17612
17613 =item ARGUMENTS
17614
17615 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17616 C<-pathlist>
17617
17618 =item DESCRIPTION
17619
17620 =item EXAMPLES
17621
17622 =over 4
17623
17624 =item Recommended Use
17625
17626 =back
17627
17628 =item CAVEATS
17629
17630 =item AUTHOR
17631
17632 =item ACKNOWLEDGEMENTS
17633
17634 =back
17635
17636 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17637 translators.
17638
17639 =over 4
17640
17641 =item HEADINGS
17642
17643 =item This C<is> a "level 1" heading
17644
17645 =over 4
17646
17647 =item ``Level'' "2 I<heading>
17648
17649 =back
17650
17651 =item This C<is> a "level 1" heading
17652
17653 =over 4
17654
17655 =item ``Level'' 2 I<heading>
17656
17657 =back
17658
17659 =item LINKS
17660
17661 =item OVER AND ITEMS
17662
17663 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17664 text
17665
17666 =item FORMATTING CODES
17667
17668 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17669
17670 =item VERBATIM
17671
17672 =item CONCLUSION
17673
17674 =back
17675
17676 =head2 Pod::t::htmlescp, Escape Sequences Test
17677
17678 =over 4
17679
17680 =item DESCRIPTION
17681
17682 =back
17683
17684 =head2 Pod::t::htmlview, Test HTML Rendering
17685
17686 =over 4
17687
17688 =item SYNOPSIS
17689
17690 =item DESCRIPTION
17691
17692 =item METHODS =E<gt> OTHER STUFF
17693
17694 =over 4
17695
17696 =item new()
17697
17698 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17699 Sat, 3 Mat
17700
17701 =item old()
17702
17703 =back
17704
17705 =item TESTING FOR AND BEGIN
17706
17707 =item TESTING URLs hyperlinking
17708
17709 =item SEE ALSO
17710
17711 =back
17712
17713 =head2 SDBM_File - Tied access to sdbm files
17714
17715 =over 4
17716
17717 =item SYNOPSIS
17718
17719 =item DESCRIPTION
17720
17721 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17722
17723 =item DIAGNOSTICS
17724
17725 =over 4
17726
17727 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17728
17729 =back
17730
17731 =item BUGS AND WARNINGS
17732
17733 =back
17734
17735 =head2 Safe - Compile and execute code in restricted compartments
17736
17737 =over 4
17738
17739 =item SYNOPSIS
17740
17741 =item DESCRIPTION
17742
17743 a new namespace, an operator mask
17744
17745 =item WARNING
17746
17747 =over 4
17748
17749 =item RECENT CHANGES
17750
17751 =item Methods in class Safe
17752
17753 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17754 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17755 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17756 root (NAMESPACE), mask (MASK)
17757
17758 =item Some Safety Issues
17759
17760 Memory, CPU, Snooping, Signals, State Changes
17761
17762 =item AUTHOR
17763
17764 =back
17765
17766 =back
17767
17768 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17769
17770 =over 4
17771
17772 =item SYNOPSIS
17773
17774 =item DESCRIPTION
17775
17776 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17777 EXPR, tainted EXPR, weaken REF
17778
17779 =item KNOWN BUGS
17780
17781 =item COPYRIGHT
17782
17783 =item BLATANT PLUG
17784
17785 =back
17786
17787 =head2 Search::Dict, look - search for key in dictionary file
17788
17789 =over 4
17790
17791 =item SYNOPSIS
17792
17793 =item DESCRIPTION
17794
17795 =back
17796
17797 =head2 SelectSaver - save and restore selected file handle
17798
17799 =over 4
17800
17801 =item SYNOPSIS
17802
17803 =item DESCRIPTION
17804
17805 =back
17806
17807 =head2 SelfLoader - load functions only on demand
17808
17809 =over 4
17810
17811 =item SYNOPSIS
17812
17813 =item DESCRIPTION
17814
17815 =over 4
17816
17817 =item The __DATA__ token
17818
17819 =item SelfLoader autoloading
17820
17821 =item Autoloading and package lexicals
17822
17823 =item SelfLoader and AutoLoader
17824
17825 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17826
17827 =item Classes and inherited methods.
17828
17829 =back
17830
17831 =item Multiple packages and fully qualified subroutine names
17832
17833 =back
17834
17835 =head2 Shell - run shell commands transparently within perl
17836
17837 =over 4
17838
17839 =item SYNOPSIS
17840
17841 =item DESCRIPTION
17842
17843 =over 4
17844
17845 =item OBJECT ORIENTED SYNTAX
17846
17847 =back
17848
17849 =item AUTHOR
17850
17851 =back
17852
17853 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17854 socket.h defines and structure manipulators
17855
17856 =over 4
17857
17858 =item SYNOPSIS
17859
17860 =item DESCRIPTION
17861
17862 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17863 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17864 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17865 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17866 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17867
17868 =back
17869
17870 =head2 Storable - persistence for Perl data structures
17871
17872 =over 4
17873
17874 =item SYNOPSIS
17875
17876 =item DESCRIPTION
17877
17878 =item MEMORY STORE
17879
17880 =item ADVISORY LOCKING
17881
17882 =item SPEED
17883
17884 =item CANONICAL REPRESENTATION
17885
17886 =item FORWARD COMPATIBILITY
17887
17888 utf8 data, restricted hashes, files from future versions of Storable
17889
17890 =item ERROR REPORTING
17891
17892 =item WIZARDS ONLY
17893
17894 =over 4
17895
17896 =item Hooks
17897
17898 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
17899 I<serialized>, ..
17900
17901 =item Predicates
17902
17903 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
17904 C<Storable::is_retrieving>
17905
17906 =item Recursion
17907
17908 =item Deep Cloning
17909
17910 =back
17911
17912 =item Storable magic
17913
17914 =item EXAMPLES
17915
17916 =item WARNING
17917
17918 =item BUGS
17919
17920 =over 4
17921
17922 =item 64 bit data in perl 5.6.0 and 5.6.1
17923
17924 =back
17925
17926 =item CREDITS
17927
17928 =item AUTHOR
17929
17930 =item SEE ALSO
17931
17932 =back
17933
17934 =head2 Switch - A switch statement for Perl
17935
17936 =over 4
17937
17938 =item VERSION
17939
17940 =item SYNOPSIS
17941
17942 =item BACKGROUND
17943
17944 =item DESCRIPTION
17945
17946 =over 4
17947
17948 =item Allowing fall-through
17949
17950 =item Automating fall-through
17951
17952 =item Alternative syntax
17953
17954 =item Higher-order Operations
17955
17956 =back
17957
17958 =item DEPENDENCIES
17959
17960 =item AUTHOR
17961
17962 =item BUGS
17963
17964 =item LIMITATION
17965
17966 =item COPYRIGHT
17967
17968 =back
17969
17970 =head2 Symbol - manipulate Perl symbols and their names
17971
17972 =over 4
17973
17974 =item SYNOPSIS
17975
17976 =item DESCRIPTION
17977
17978 =back
17979
17980 =head2 Sys::Hostname - Try every conceivable way to get hostname
17981
17982 =over 4
17983
17984 =item SYNOPSIS
17985
17986 =item DESCRIPTION
17987
17988 =item AUTHOR
17989
17990 =back
17991
17992 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
17993 interface to the UNIX syslog(3) calls
17994
17995 =over 4
17996
17997 =item SYNOPSIS
17998
17999 =item DESCRIPTION
18000
18001 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18002 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18003 in 5.004_02), closelog
18004
18005 =item EXAMPLES
18006
18007 =item SEE ALSO
18008
18009 =item AUTHOR
18010
18011 =back
18012
18013 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18014 Perl interface to the UNIX syslog(3) calls
18015
18016 =over 4
18017
18018 =item SYNOPSIS
18019
18020 =item DESCRIPTION
18021
18022 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18023 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18024 in 5.004_02), closelog
18025
18026 =item EXAMPLES
18027
18028 =item SEE ALSO
18029
18030 =item AUTHOR
18031
18032 =back
18033
18034 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18035
18036 =over 4
18037
18038 =item SYNOPSIS
18039
18040 =item DESCRIPTION
18041
18042 =item DIAGNOSTICS
18043
18044 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18045 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18046 comma allowed after filehandle, No name for escape sequence %s
18047
18048 =item ENVIRONMENT
18049
18050 ANSI_COLORS_DISABLED
18051
18052 =item RESTRICTIONS
18053
18054 =item NOTES
18055
18056 =item SEE ALSO
18057
18058 =item AUTHORS
18059
18060 =item LICENSE
18061
18062 =back
18063
18064 =head2 Term::Cap - Perl termcap interface
18065
18066 =over 4
18067
18068 =item SYNOPSIS
18069
18070 =item DESCRIPTION
18071
18072 =over 4
18073
18074 =item METHODS
18075
18076 =back
18077
18078 =back
18079
18080 B<Tgetent>, OSPEED, TERM
18081
18082 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18083
18084 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18085
18086 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18087
18088 B<Trequire>
18089
18090 =over 4
18091
18092 =item EXAMPLES
18093
18094 =item COPYRIGHT AND LICENSE
18095
18096 =item AUTHOR
18097
18098 =item SEE ALSO
18099
18100 =back
18101
18102 =head2 Term::Complete - Perl word completion module
18103
18104 =over 4
18105
18106 =item SYNOPSIS
18107
18108 =item DESCRIPTION
18109
18110 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18111
18112 =item DIAGNOSTICS
18113
18114 =item BUGS
18115
18116 =item AUTHOR
18117
18118 =back
18119
18120 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18121 no real package is found, substitutes stubs instead of basic functions.
18122
18123 =over 4
18124
18125 =item SYNOPSIS
18126
18127 =item DESCRIPTION
18128
18129 =item Minimal set of supported functions
18130
18131 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18132 C<MinLine>, C<findConsole>, Attribs, C<Features>
18133
18134 =item Additional supported functions
18135
18136 C<tkRunning>, C<ornaments>, C<newTTY>
18137
18138 =item EXPORTS
18139
18140 =item ENVIRONMENT
18141
18142 =item CAVEATS
18143
18144 =back
18145
18146 =head2 Test - provides a simple framework for writing test scripts
18147
18148 =over 4
18149
18150 =item SYNOPSIS
18151
18152 =item DESCRIPTION
18153
18154 =over 4
18155
18156 =item Functions
18157
18158 B<plan>
18159
18160 =back
18161
18162 =back
18163
18164 B<_to_value>
18165
18166 B<ok>
18167
18168 =over 4
18169
18170 =item TEST TYPES
18171
18172 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18173
18174 =item ONFAIL
18175
18176 =item BUGS and CAVEATS
18177
18178 =item NOTE
18179
18180 =item SEE ALSO
18181
18182 =item AUTHOR
18183
18184 =back
18185
18186 =head2 Test::Builder - Backend for building test libraries
18187
18188 =over 4
18189
18190 =item SYNOPSIS
18191
18192 =item DESCRIPTION
18193
18194 =over 4
18195
18196 =item Construction
18197
18198 B<new>
18199
18200 =back
18201
18202 =back
18203
18204 =over 4
18205
18206 =item Setting up tests
18207
18208 B<exported_to>
18209
18210 =back
18211
18212 B<plan>
18213
18214 B<expected_tests>
18215
18216 B<no_plan>
18217
18218 B<skip_all>
18219
18220 =over 4
18221
18222 =item Running tests
18223
18224 B<ok>
18225
18226 =back
18227
18228 B<is_eq>, B<is_num>
18229
18230 B<isnt_eq>, B<isnt_num>
18231
18232 B<like>, B<unlike>
18233
18234 B<maybe_regex>
18235
18236 B<cmp_ok>
18237
18238 B<BAILOUT>
18239
18240 B<skip>
18241
18242 B<todo_skip>
18243
18244 B<skip_rest>
18245
18246 =over 4
18247
18248 =item Test style
18249
18250 B<level>
18251
18252 =back
18253
18254 B<use_numbers>
18255
18256 B<no_header>, B<no_ending>
18257
18258 =over 4
18259
18260 =item Output
18261
18262 B<diag>
18263
18264 =back
18265
18266 B<_print>
18267
18268 B<output>, B<failure_output>, B<todo_output>
18269
18270 =over 4
18271
18272 =item Test Status and Info
18273
18274 B<current_test>
18275
18276 =back
18277
18278 B<summary>
18279
18280 B<details>  I<UNIMPLEMENTED>, B<todo>
18281
18282 B<caller>
18283
18284 B<_sanity_check>
18285
18286 B<_whoa>
18287
18288 B<_my_exit>
18289
18290 =over 4
18291
18292 =item EXAMPLES
18293
18294 =item SEE ALSO
18295
18296 =item AUTHORS
18297
18298 =item COPYRIGHT
18299
18300 =back
18301
18302 =head2 Test::Harness - run perl standard test scripts with statistics
18303
18304 =over 4
18305
18306 =item SYNOPSIS
18307
18308 =item DESCRIPTION
18309
18310 =over 4
18311
18312 =item The test script output
18313
18314 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18315 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18316 else>
18317
18318 =item Taint mode
18319
18320 =item Configuration variables.
18321
18322 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18323
18324 =item Failure
18325
18326 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18327 Failed>
18328
18329 =item Functions
18330
18331 B<runtests>
18332
18333 =back
18334
18335 =back
18336
18337 B<_all_ok>
18338
18339 B<_globdir>
18340
18341 B<_run_all_tests>
18342
18343 B<_mk_leader>
18344
18345 B<_leader_width>
18346
18347 =over 4
18348
18349 =item EXPORT
18350
18351 =item DIAGNOSTICS
18352
18353 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18354 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18355 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18356 %s>, C<FAILED--Further testing stopped: %s>
18357
18358 =item ENVIRONMENT
18359
18360 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18361 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18362 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18363
18364 =item EXAMPLE
18365
18366 =item SEE ALSO
18367
18368 =item AUTHORS
18369
18370 =item TODO
18371
18372 =item BUGS
18373
18374 =back
18375
18376 =head2 Test::Harness::Assert - simple assert
18377
18378 =over 4
18379
18380 =item SYNOPSIS
18381
18382 =item DESCRIPTION
18383
18384 =over 4
18385
18386 =item Functions
18387
18388 B<assert>
18389
18390 =back
18391
18392 =back
18393
18394 =over 4
18395
18396 =item AUTHOR
18397
18398 =item SEE ALSO
18399
18400 =back
18401
18402 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18403
18404 =over 4
18405
18406 =item SYNOPSIS
18407
18408 =item DESCRIPTION
18409
18410 =back
18411
18412 =head2 Test::Harness::Straps - detailed analysis of test results
18413
18414 =over 4
18415
18416 =item SYNOPSIS
18417
18418 =item DESCRIPTION
18419
18420 =over 4
18421
18422 =item Construction
18423
18424 B<new>
18425
18426 =back
18427
18428 =back
18429
18430 B<_init>
18431
18432 =over 4
18433
18434 =item Analysis
18435
18436 B<analyze>
18437
18438 =back
18439
18440 B<analyze_fh>
18441
18442 B<analyze_file>
18443
18444 B<_switches>
18445
18446 B<_INC2PERL5LIB>
18447
18448 B<_filtered_INC>
18449
18450 B<_restore_PERL5LIB>
18451
18452 =over 4
18453
18454 =item Parsing
18455
18456 B<_is_comment>
18457
18458 =back
18459
18460 B<_is_header>
18461
18462 B<_is_test>
18463
18464 B<_is_bail_out>
18465
18466 B<_reset_file_state>
18467
18468 =over 4
18469
18470 =item Results
18471
18472 B<_detailize>
18473
18474 =back
18475
18476 =over 4
18477
18478 =item EXAMPLES
18479
18480 =item AUTHOR
18481
18482 =item SEE ALSO
18483
18484 =back
18485
18486 =head2 Test::More - yet another framework for writing test scripts
18487
18488 =over 4
18489
18490 =item SYNOPSIS
18491
18492 =item DESCRIPTION
18493
18494 =over 4
18495
18496 =item I love it when a plan comes together
18497
18498 =back
18499
18500 =back
18501
18502 =over 4
18503
18504 =item Test names
18505
18506 =item I'm ok, you're not ok.
18507
18508 B<ok>
18509
18510 =back
18511
18512 B<is>, B<isnt>
18513
18514 B<like>
18515
18516 B<unlike>
18517
18518 B<cmp_ok>
18519
18520 B<can_ok>
18521
18522 B<isa_ok>
18523
18524 B<pass>, B<fail>
18525
18526 =over 4
18527
18528 =item Diagnostics
18529
18530 B<diag>
18531
18532 =back
18533
18534 =over 4
18535
18536 =item Module tests
18537
18538 B<use_ok>
18539
18540 =back
18541
18542 B<require_ok>
18543
18544 =over 4
18545
18546 =item Conditional tests
18547
18548 B<SKIP: BLOCK>
18549
18550 =back
18551
18552 B<TODO: BLOCK>, B<todo_skip>
18553
18554 =over 4
18555
18556 =item Comparison functions
18557
18558 B<is_deeply>
18559
18560 =back
18561
18562 B<eq_array>
18563
18564 B<eq_hash>
18565
18566 B<eq_set>
18567
18568 =over 4
18569
18570 =item Extending and Embedding Test::More
18571
18572 B<builder>
18573
18574 =back
18575
18576 =over 4
18577
18578 =item NOTES
18579
18580 =item BUGS and CAVEATS
18581
18582 Making your own ok(), The eq_* family has some caveats, Test::Harness
18583 upgrades
18584
18585 =item HISTORY
18586
18587 =item SEE ALSO
18588
18589 =item AUTHORS
18590
18591 =item COPYRIGHT
18592
18593 =back
18594
18595 =head2 Test::Simple - Basic utilities for writing tests.
18596
18597 =over 4
18598
18599 =item SYNOPSIS
18600
18601 =item DESCRIPTION
18602
18603 B<ok>
18604
18605 =back
18606
18607 =over 4
18608
18609 =item EXAMPLE
18610
18611 =item CAVEATS
18612
18613 =item NOTES
18614
18615 =item HISTORY
18616
18617 =item SEE ALSO
18618
18619 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18620 L<Test::Harness>
18621
18622 =item AUTHORS
18623
18624 =item COPYRIGHT
18625
18626 =back
18627
18628 =head2 Test::Tutorial - A tutorial about writing really basic tests
18629
18630 =over 4
18631
18632 =item DESCRIPTION
18633
18634 =over 4
18635
18636 =item Nuts and bolts of testing.
18637
18638 =item Where to start?
18639
18640 =item Names
18641
18642 =item Test the manual
18643
18644 =item Sometimes the tests are wrong
18645
18646 =item Testing lots of values
18647
18648 =item Informative names
18649
18650 =item Skipping tests
18651
18652 =item Todo tests
18653
18654 =item Testing with taint mode.
18655
18656 =back
18657
18658 =item FOOTNOTES
18659
18660 =item AUTHORS
18661
18662 =item COPYRIGHT
18663
18664 =back
18665
18666 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18667
18668 =over 4
18669
18670 =item SYNOPSIS
18671
18672 =item DESCRIPTION
18673
18674 =item EXAMPLE
18675
18676 =back
18677
18678 =head2 Text::Balanced - Extract delimited text sequences from strings.
18679
18680 =over 4
18681
18682 =item SYNOPSIS
18683
18684 =item DESCRIPTION
18685
18686 =over 4
18687
18688 =item General behaviour in list contexts
18689
18690 [0], [1], [2]
18691
18692 =item General behaviour in scalar and void contexts
18693
18694 =item A note about prefixes
18695
18696 =item C<extract_delimited>
18697
18698 =item C<extract_bracketed>
18699
18700 =item C<extract_tagged>
18701
18702 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18703 [0], [1], [2], [3], [4], [5]
18704
18705 =item C<gen_extract_tagged>
18706
18707 =item C<extract_quotelike>
18708
18709 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18710
18711 =item C<extract_quotelike> and "here documents"
18712
18713 [0], [1], [2], [3], [4], [5], [6], [7..10]
18714
18715 =item C<extract_codeblock>
18716
18717 =item C<extract_multiple>
18718
18719 =item C<gen_delimited_pat>
18720
18721 =back
18722
18723 =item DIAGNOSTICS
18724
18725  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
18726 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18727 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
18728 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18729 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18730 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18731 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18732 after dereferencer>, C<Did not find expected opening bracket at %s>,
18733 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18734 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18735 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18736 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18737 tag>
18738
18739 =item AUTHOR
18740
18741 =item BUGS AND IRRITATIONS
18742
18743 =item COPYRIGHT
18744
18745 =back
18746
18747 =head2 Text::ParseWords - parse text into an array of tokens or array of
18748 arrays
18749
18750 =over 4
18751
18752 =item SYNOPSIS
18753
18754 =item DESCRIPTION
18755
18756 =item EXAMPLES
18757
18758 =item AUTHORS
18759
18760 =back
18761
18762 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18763 by Knuth
18764
18765 =over 4
18766
18767 =item SYNOPSIS
18768
18769 =item DESCRIPTION
18770
18771 =item EXAMPLES
18772
18773 =item LIMITATIONS
18774
18775 =item AUTHOR
18776
18777 =back
18778
18779 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18780 unexpand(1)
18781
18782 =over 4
18783
18784 =item SYNOPSIS
18785
18786 =item DESCRIPTION
18787
18788 =item BUGS
18789
18790 =item AUTHOR
18791
18792 =back
18793
18794 =head2 Text::Wrap - line wrapping to form simple paragraphs
18795
18796 =over 4
18797
18798 =item SYNOPSIS
18799
18800 =item DESCRIPTION
18801
18802 =item OVERRIDES
18803
18804 =item EXAMPLE
18805
18806 =item AUTHOR
18807
18808 =back
18809
18810 =head2 Thread - manipulate threads in Perl
18811
18812 =over 4
18813
18814 =item CAVEAT
18815
18816 =item SYNOPSIS
18817
18818 =item DESCRIPTION
18819
18820 =item FUNCTIONS
18821
18822 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18823 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18824 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18825
18826 =item METHODS
18827
18828 join, eval, detach, equal, tid, flags, done
18829
18830 =item LIMITATIONS
18831
18832 =item SEE ALSO
18833
18834 =back
18835
18836 =head2 Thread::Queue - thread-safe queues
18837
18838 =over 4
18839
18840 =item SYNOPSIS
18841
18842 =item DESCRIPTION
18843
18844 =item FUNCTIONS AND METHODS
18845
18846 new, enqueue LIST, dequeue, dequeue_nb, pending
18847
18848 =item SEE ALSO
18849
18850 =back
18851
18852 =head2 Thread::Semaphore - thread-safe semaphores
18853
18854 =over 4
18855
18856 =item SYNOPSIS
18857
18858 =item DESCRIPTION
18859
18860 =item FUNCTIONS AND METHODS
18861
18862 new, new NUMBER, down, down NUMBER, up, up NUMBER
18863
18864 =back
18865
18866 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18867
18868 =over 4
18869
18870 =item SYNOPSIS
18871
18872 =item DESCRIPTION
18873
18874 =item BUGS
18875
18876 =back
18877
18878 =head2 Thread::Specific - thread-specific keys
18879
18880 =over 4
18881
18882 =item SYNOPSIS
18883
18884 =item DESCRIPTION
18885
18886 =back
18887
18888 =head2 Tie::Array - base class for tied arrays
18889
18890 =over 4
18891
18892 =item SYNOPSIS
18893
18894 =item DESCRIPTION
18895
18896 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
18897 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
18898 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
18899 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
18900
18901 =item CAVEATS
18902
18903 =item AUTHOR
18904
18905 =back
18906
18907 =head2 Tie::File - Access the lines of a disk file via a Perl array
18908
18909 =over 4
18910
18911 =item SYNOPSIS
18912
18913 =item DESCRIPTION
18914
18915 =over 4
18916
18917 =item C<recsep>
18918
18919 =item C<autochomp>
18920
18921 =item C<mode>
18922
18923 =item C<memory>
18924
18925 =item C<dw_size>
18926
18927 =item Option Format
18928
18929 =back
18930
18931 =item Public Methods
18932
18933 =over 4
18934
18935 =item C<flock>
18936
18937 =item C<autochomp>
18938
18939 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
18940
18941 =back
18942
18943 =item Tying to an already-opened filehandle
18944
18945 =item Deferred Writing
18946
18947 =over 4
18948
18949 =item Autodeferring
18950
18951 =back
18952
18953 =item CAVEATS
18954
18955 =item SUBCLASSING
18956
18957 =item WHAT ABOUT C<DB_File>?
18958
18959 =item AUTHOR
18960
18961 =item LICENSE
18962
18963 =item WARRANTY
18964
18965 =item THANKS
18966
18967 =item TODO
18968
18969 =back
18970
18971 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
18972 handles
18973
18974 =over 4
18975
18976 =item SYNOPSIS
18977
18978 =item DESCRIPTION
18979
18980 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
18981 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
18982 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
18983 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
18984
18985 =item MORE INFORMATION
18986
18987 =item COMPATIBILITY
18988
18989 =back
18990
18991 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
18992 tied hashes
18993
18994 =over 4
18995
18996 =item SYNOPSIS
18997
18998 =item DESCRIPTION
18999
19000 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19001 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19002
19003 =item Inheriting from B<Tie::StdHash>
19004
19005 =item Inheriting from B<Tie::ExtraHash>
19006
19007 =item C<UNTIE> and C<DESTROY>
19008
19009 =item MORE INFORMATION
19010
19011 =back
19012
19013 =head2 Tie::Memoize - add data to hash when needed
19014
19015 =over 4
19016
19017 =item SYNOPSIS
19018
19019 =item DESCRIPTION
19020
19021 =item Inheriting from B<Tie::Memoize>
19022
19023 =item EXAMPLE
19024
19025 =item BUGS
19026
19027 =item AUTHOR
19028
19029 =back
19030
19031 =head2 Tie::RefHash - use references as hash keys
19032
19033 =over 4
19034
19035 =item SYNOPSIS
19036
19037 =item DESCRIPTION
19038
19039 =item EXAMPLE
19040
19041 =item AUTHOR
19042
19043 =item VERSION
19044
19045 =item SEE ALSO
19046
19047 =back
19048
19049 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19050 scalars
19051
19052 =over 4
19053
19054 =item SYNOPSIS
19055
19056 =item DESCRIPTION
19057
19058 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19059
19060 =item MORE INFORMATION
19061
19062 =back
19063
19064 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19065
19066 =over 4
19067
19068 =item SYNOPSIS
19069
19070 =item DESCRIPTION
19071
19072 =item CAVEATS
19073
19074 =back
19075
19076 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19077 timers
19078
19079 =over 4
19080
19081 =item SYNOPSIS
19082
19083 =item DESCRIPTION
19084
19085 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19086 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19087 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19088 getitimer ( $which )
19089
19090 =item EXAMPLES
19091
19092 =item C API
19093
19094 =item CAVEATS
19095
19096 =item AUTHORS
19097
19098 =item REVISION
19099
19100 =item COPYRIGHT
19101
19102 =back
19103
19104 =head2 Time::Local - efficiently compute time from local and GMT time
19105
19106 =over 4
19107
19108 =item SYNOPSIS
19109
19110 =item DESCRIPTION
19111
19112 =item IMPLEMENTATION
19113
19114 =item BUGS
19115
19116 =back
19117
19118 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19119 function
19120
19121 =over 4
19122
19123 =item SYNOPSIS
19124
19125 =item DESCRIPTION
19126
19127 =item NOTE
19128
19129 =item AUTHOR
19130
19131 =back
19132
19133 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19134 function
19135
19136 =over 4
19137
19138 =item SYNOPSIS
19139
19140 =item DESCRIPTION
19141
19142 =item NOTE
19143
19144 =item AUTHOR
19145
19146 =back
19147
19148 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19149
19150 =over 4
19151
19152 =item SYNOPSIS
19153
19154 =item DESCRIPTION
19155
19156 =item AUTHOR
19157
19158 =back
19159
19160 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19161
19162 =over 4
19163
19164 =item SYNOPSIS
19165
19166 =item DESCRIPTION
19167
19168 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19169 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19170
19171 =back
19172
19173 =head2 Unicode::Collate - Unicode Collation Algorithm
19174
19175 =over 4
19176
19177 =item SYNOPSIS
19178
19179 =item DESCRIPTION
19180
19181 =over 4
19182
19183 =item Constructor and Tailoring
19184
19185 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19186 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19187 undefChar, katakana_before_hiragana, upper_before_lower
19188
19189 =item Methods for Collation
19190
19191 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19192 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19193 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19194 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19195 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19196 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19197 $Collator-E<gt>viewSortKey($string)>, C<$position =
19198 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19199 $Collator-E<gt>index($string, $substring)>
19200
19201 =item Other Methods
19202
19203 UCA_Version, Base_Unicode_Version
19204
19205 =item EXPORT
19206
19207 =item TODO
19208
19209 =item CAVEAT
19210
19211 =item BUGS
19212
19213 =back
19214
19215 =item AUTHOR
19216
19217 =item SEE ALSO
19218
19219 http://www.unicode.org/unicode/reports/tr10/,
19220 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19221 http://www.unicode.org/unicode/reports/tr15/,
19222 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19223
19224 =back
19225
19226 =head2 Unicode::Normalize - Unicode Normalization Forms
19227
19228 =over 4
19229
19230 =item SYNOPSIS
19231
19232 =item DESCRIPTION
19233
19234 =over 4
19235
19236 =item Normalization Forms
19237
19238 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19239 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19240 C<$normalized_string = normalize($form_name, $string)>
19241
19242 =item Decomposition and Composition
19243
19244 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19245 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19246 reorder($string)>, C<$composed_string   = compose($string)>
19247
19248 =item Quick Check
19249
19250 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19251 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19252 check($form_name, $string)>
19253
19254 =item Character Data
19255
19256 C<$canonical_decomposed = getCanon($codepoint)>,
19257 C<$compatibility_decomposed = getCompat($codepoint)>,
19258 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19259 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19260 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19261 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19262 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19263
19264 =item EXPORT
19265
19266 =back
19267
19268 =item AUTHOR
19269
19270 =item SEE ALSO
19271
19272 http://www.unicode.org/unicode/reports/tr15/,
19273 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19274
19275 =back
19276
19277 =head2 Unicode::UCD - Unicode character database
19278
19279 =over 4
19280
19281 =item SYNOPSIS
19282
19283 =item DESCRIPTION
19284
19285 =back
19286
19287 =over 4
19288
19289 =item charinfo
19290
19291 =back
19292
19293 =over 4
19294
19295 =item charblock
19296
19297 =back
19298
19299 =over 4
19300
19301 =item charscript
19302
19303 =back
19304
19305 =over 4
19306
19307 =item charblocks
19308
19309 =back
19310
19311 =over 4
19312
19313 =item charscripts
19314
19315 =back
19316
19317 =over 4
19318
19319 =item Blocks versus Scripts
19320
19321 =item Matching Scripts and Blocks
19322
19323 =item Code Point Arguments
19324
19325 =item charinrange
19326
19327 =back
19328
19329 =over 4
19330
19331 =item compexcl
19332
19333 =back
19334
19335 =over 4
19336
19337 =item casefold
19338
19339 =back
19340
19341 =over 4
19342
19343 =item casespec
19344
19345 =back
19346
19347 =over 4
19348
19349 =item Unicode::UCD::UnicodeVersion
19350
19351 =back
19352
19353 =over 4
19354
19355 =item Implementation Note
19356
19357 =back
19358
19359 =over 4
19360
19361 =item BUGS
19362
19363 =item AUTHOR
19364
19365 =back
19366
19367 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19368 functions
19369
19370 =over 4
19371
19372 =item SYNOPSIS
19373
19374 =item DESCRIPTION
19375
19376 =item NOTE
19377
19378 =item AUTHOR
19379
19380 =back
19381
19382 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19383 functions
19384
19385 =over 4
19386
19387 =item SYNOPSIS
19388
19389 =item DESCRIPTION
19390
19391 =over 4
19392
19393 =item System Specifics
19394
19395 =back
19396
19397 =item NOTE
19398
19399 =item AUTHOR
19400
19401 =item HISTORY
19402
19403 March 18th, 2000
19404
19405 =back
19406
19407 =head2 Win32 - Interfaces to some Win32 API Functions
19408
19409 =over 4
19410
19411 =item DESCRIPTION
19412
19413 =over 4
19414
19415 =item Alphabetical Listing of Win32 Functions
19416
19417 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19418 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19419 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19420 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19421 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19422 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19423 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
19424 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19425 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19426 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19427 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19428 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19429 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19430 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19431 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19432 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19433 Win32::UnregisterServer(LIBRARYNAME)
19434
19435 =back
19436
19437 =back
19438
19439 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
19440
19441 =over 4
19442
19443 =item SYNOPSIS
19444
19445 =item DESCRIPTION
19446
19447 =back
19448
19449 =over 4
19450
19451 =item NOTES
19452
19453 =item AUTHOR
19454
19455 =back
19456
19457 =head2 XSLoader - Dynamically load C libraries into Perl code
19458
19459 =over 4
19460
19461 =item SYNOPSIS
19462
19463 =item DESCRIPTION
19464
19465 =item AUTHOR
19466
19467 =back
19468
19469 =head1 AUXILIARY DOCUMENTATION
19470
19471 Here should be listed all the extra programs' documentation, but they
19472 don't all have manual pages yet:
19473
19474 =over 4
19475
19476 =item a2p
19477
19478 =item s2p
19479
19480 =item find2perl
19481
19482 =item h2ph
19483
19484 =item c2ph
19485
19486 =item h2xs
19487
19488 =item xsubpp
19489
19490 =item pod2man
19491
19492 =item wrapsuid
19493
19494 =back
19495
19496 =head1 AUTHOR
19497
19498 Larry Wall <F<larry@wall.org>>, with the help of oodles
19499 of other folks.
19500