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 =item Named Pipes
1721
1722 =over 4
1723
1724 =item Deferred Signals
1725
1726 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1727 triggered by operating system state
1728
1729 =back
1730
1731 =item Using open() for IPC
1732
1733 =over 4
1734
1735 =item Filehandles
1736
1737 =item Background Processes
1738
1739 =item Complete Dissociation of Child from Parent
1740
1741 =item Safe Pipe Opens
1742
1743 =item Bidirectional Communication with Another Process
1744
1745 =item Bidirectional Communication with Yourself
1746
1747 =back
1748
1749 =item Sockets: Client/Server Communication
1750
1751 =over 4
1752
1753 =item Internet Line Terminators
1754
1755 =item Internet TCP Clients and Servers
1756
1757 =item Unix-Domain TCP Clients and Servers
1758
1759 =back
1760
1761 =item TCP Clients with IO::Socket
1762
1763 =over 4
1764
1765 =item A Simple Client
1766
1767 C<Proto>, C<PeerAddr>, C<PeerPort>
1768
1769 =item A Webget Client
1770
1771 =item Interactive Client with IO::Socket
1772
1773 =back
1774
1775 =item TCP Servers with IO::Socket
1776
1777 Proto, LocalPort, Listen, Reuse
1778
1779 =item UDP: Message Passing
1780
1781 =item SysV IPC
1782
1783 =item NOTES
1784
1785 =item BUGS
1786
1787 =item AUTHOR
1788
1789 =item SEE ALSO
1790
1791 =back
1792
1793 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
1794
1795 =over 4
1796
1797 =item SYNOPSIS
1798
1799 =item DESCRIPTION
1800
1801 =over 4
1802
1803 =item Behavior of other Perl features in forked pseudo-processes
1804
1805 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1806 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1807 files, directories and network sockets
1808
1809 =item Resource limits
1810
1811 =item Killing the parent process
1812
1813 =item Lifetime of the parent process and pseudo-processes
1814
1815 =item CAVEATS AND LIMITATIONS
1816
1817 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1818 Global state maintained by XSUBs, Interpreter embedded in larger
1819 application, Thread-safety of extensions
1820
1821 =back
1822
1823 =item BUGS
1824
1825 =item AUTHOR
1826
1827 =item SEE ALSO
1828
1829 =back
1830
1831 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1832
1833 =over 4
1834
1835 =item SYNOPSIS
1836
1837 =item DESCRIPTION
1838
1839 =item Storing numbers
1840
1841 =item Numeric operators and numeric conversions
1842
1843 =item Flavors of Perl numeric operations
1844
1845 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1846 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1847 integer>, Operators which expect an integer, Operators which expect a
1848 string
1849
1850 =item AUTHOR
1851
1852 =item SEE ALSO
1853
1854 =back
1855
1856 =head2 perlthrtut - tutorial on threads in Perl
1857
1858 =over 4
1859
1860 =item DESCRIPTION
1861
1862 =item Status
1863
1864 =item What Is A Thread Anyway?
1865
1866 =item Threaded Program Models
1867
1868 =over 4
1869
1870 =item Boss/Worker
1871
1872 =item Work Crew
1873
1874 =item Pipeline
1875
1876 =back
1877
1878 =item Native threads
1879
1880 =item What kind of threads are Perl threads?
1881
1882 =item Threadsafe Modules
1883
1884 =item Thread Basics
1885
1886 =over 4
1887
1888 =item Basic Thread Support
1889
1890 =item Creating Threads
1891
1892 =item Giving up control
1893
1894 =item Waiting For A Thread To Exit
1895
1896 =item Ignoring A Thread
1897
1898 =back
1899
1900 =item Threads And Data
1901
1902 =over 4
1903
1904 =item Shared And Unshared Data
1905
1906 =item Thread Pitfalls: Races
1907
1908 =back
1909
1910 =item Synchronization and control
1911
1912 =over 4
1913
1914 =item Controlling access: lock()
1915
1916 =item A Thread Pitfall: Deadlocks
1917
1918 =item Queues: Passing Data Around
1919
1920 =item Semaphores: Synchronizing Data Access
1921
1922 =item Basic semaphores
1923
1924 =item Advanced Semaphores
1925
1926 =item cond_wait() and cond_signal()
1927
1928 =back
1929
1930 =item General Thread Utility Routines
1931
1932 =over 4
1933
1934 =item What Thread Am I In?
1935
1936 =item Thread IDs
1937
1938 =item Are These Threads The Same?
1939
1940 =item What Threads Are Running?
1941
1942 =back
1943
1944 =item A Complete Example
1945
1946 =item Performance considerations
1947
1948 =item Threadsafety of System Libraries
1949
1950 =item Conclusion
1951
1952 =item Bibliography
1953
1954 =over 4
1955
1956 =item Introductory Texts
1957
1958 =item OS-Related References
1959
1960 =item Other References
1961
1962 =back
1963
1964 =item Acknowledgements
1965
1966 =item AUTHOR
1967
1968 =item Copyrights
1969
1970 =back
1971
1972 =head2 perlothrtut - old tutorial on threads in Perl
1973
1974 =over 4
1975
1976 =item DESCRIPTION
1977
1978 =item What Is A Thread Anyway?
1979
1980 =item Threaded Program Models
1981
1982 =over 4
1983
1984 =item Boss/Worker
1985
1986 =item Work Crew
1987
1988 =item Pipeline
1989
1990 =back
1991
1992 =item Native threads
1993
1994 =item What kind of threads are perl threads?
1995
1996 =item Threadsafe Modules
1997
1998 =item Thread Basics
1999
2000 =over 4
2001
2002 =item Basic Thread Support
2003
2004 =item Creating Threads
2005
2006 =item Giving up control
2007
2008 =item Waiting For A Thread To Exit
2009
2010 =item Errors In Threads
2011
2012 =item Ignoring A Thread
2013
2014 =back
2015
2016 =item Threads And Data
2017
2018 =over 4
2019
2020 =item Shared And Unshared Data
2021
2022 =item Thread Pitfall: Races
2023
2024 =item Controlling access: lock()
2025
2026 =item Thread Pitfall: Deadlocks
2027
2028 =item Queues: Passing Data Around
2029
2030 =back
2031
2032 =item Threads And Code
2033
2034 =over 4
2035
2036 =item Semaphores: Synchronizing Data Access
2037
2038 Basic semaphores, Advanced Semaphores
2039
2040 =item Attributes: Restricting Access To Subroutines
2041
2042 =item Subroutine Locks
2043
2044 =item Methods
2045
2046 =item Locking A Subroutine
2047
2048 =back
2049
2050 =item General Thread Utility Routines
2051
2052 =over 4
2053
2054 =item What Thread Am I In?
2055
2056 =item Thread IDs
2057
2058 =item Are These Threads The Same?
2059
2060 =item What Threads Are Running?
2061
2062 =back
2063
2064 =item A Complete Example
2065
2066 =item Conclusion
2067
2068 =item Bibliography
2069
2070 =over 4
2071
2072 =item Introductory Texts
2073
2074 =item OS-Related References
2075
2076 =item Other References
2077
2078 =back
2079
2080 =item Acknowledgements
2081
2082 =item AUTHOR
2083
2084 =item Copyrights
2085
2086 =back
2087
2088 =head2 perlport - Writing portable Perl
2089
2090 =over 4
2091
2092 =item DESCRIPTION
2093
2094 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2095 portable
2096
2097 =item ISSUES
2098
2099 =over 4
2100
2101 =item Newlines
2102
2103 =item Numbers endianness and Width
2104
2105 =item Files and Filesystems
2106
2107 =item System Interaction
2108
2109 =item Interprocess Communication (IPC)
2110
2111 =item External Subroutines (XS)
2112
2113 =item Standard Modules
2114
2115 =item Time and Date
2116
2117 =item Character sets and character encoding
2118
2119 =item Internationalisation
2120
2121 =item System Resources
2122
2123 =item Security
2124
2125 =item Style
2126
2127 =back
2128
2129 =item CPAN Testers
2130
2131 Mailing list: cpan-testers@perl.org, Testing results:
2132 http://testers.cpan.org/
2133
2134 =item PLATFORMS
2135
2136 =over 4
2137
2138 =item Unix
2139
2140 =item DOS and Derivatives
2141
2142 =item S<Mac OS>
2143
2144 =item VMS
2145
2146 =item VOS
2147
2148 =item EBCDIC Platforms
2149
2150 =item Acorn RISC OS
2151
2152 =item Other perls
2153
2154 =back
2155
2156 =item FUNCTION IMPLEMENTATIONS
2157
2158 =over 4
2159
2160 =item Alphabetical Listing of Perl Functions
2161
2162 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2163 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2164 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2165 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2166 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2167 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2168 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2169 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2170 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2171 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2172 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2173 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2174 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2175 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2176 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2177 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2178 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2179 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2180 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2181 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2182 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2183 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2184 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2185 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2186 wait, waitpid PID,FLAGS
2187
2188 =back
2189
2190 =item CHANGES
2191
2192 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2193 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2194 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2195 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2196 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2197 v1.30, 03 August 1998, v1.23, 10 July 1998
2198
2199 =item Supported Platforms
2200
2201 =item SEE ALSO
2202
2203 =item AUTHORS / CONTRIBUTORS
2204
2205 =back
2206
2207 =head2 perllocale - Perl locale handling (internationalization and
2208 localization)
2209
2210 =over 4
2211
2212 =item DESCRIPTION
2213
2214 =item PREPARING TO USE LOCALES
2215
2216 =item USING LOCALES
2217
2218 =over 4
2219
2220 =item The use locale pragma
2221
2222 =item The setlocale function
2223
2224 =item Finding locales
2225
2226 =item LOCALE PROBLEMS
2227
2228 =item Temporarily fixing locale problems
2229
2230 =item Permanently fixing locale problems
2231
2232 =item Permanently fixing your system's locale configuration
2233
2234 =item Fixing system locale configuration
2235
2236 =item The localeconv function
2237
2238 =item I18N::Langinfo
2239
2240 =back
2241
2242 =item LOCALE CATEGORIES
2243
2244 =over 4
2245
2246 =item Category LC_COLLATE: Collation
2247
2248 =item Category LC_CTYPE: Character Types
2249
2250 =item Category LC_NUMERIC: Numeric Formatting
2251
2252 =item Category LC_MONETARY: Formatting of monetary amounts
2253
2254 =item LC_TIME
2255
2256 =item Other categories
2257
2258 =back
2259
2260 =item SECURITY
2261
2262 =item ENVIRONMENT
2263
2264 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2265 LC_NUMERIC, LC_TIME, LANG
2266
2267 =item NOTES
2268
2269 =over 4
2270
2271 =item Backward compatibility
2272
2273 =item I18N:Collate obsolete
2274
2275 =item Sort speed and memory use impacts
2276
2277 =item write() and LC_NUMERIC
2278
2279 =item Freely available locale definitions
2280
2281 =item I18n and l10n
2282
2283 =item An imperfect standard
2284
2285 =back
2286
2287 =item Unicode and UTF-8
2288
2289 =item BUGS
2290
2291 =over 4
2292
2293 =item Broken systems
2294
2295 =back
2296
2297 =item SEE ALSO
2298
2299 =item HISTORY
2300
2301 =back
2302
2303 =head2 perluniintro - Perl Unicode introduction
2304
2305 =over 4
2306
2307 =item DESCRIPTION
2308
2309 =over 4
2310
2311 =item Unicode
2312
2313 =item Perl's Unicode Support
2314
2315 =item Perl's Unicode Model
2316
2317 =item Unicode and EBCDIC
2318
2319 =item Creating Unicode
2320
2321 =item Handling Unicode
2322
2323 =item Legacy Encodings
2324
2325 =item Unicode I/O
2326
2327 =item Displaying Unicode As Text
2328
2329 =item Special Cases
2330
2331 =item Advanced Topics
2332
2333 =item Miscellaneous
2334
2335 =item Questions With Answers
2336
2337 , , , , , ,
2338
2339 =item Hexadecimal Notation
2340
2341 =item Further Resources
2342
2343 =back
2344
2345 =item UNICODE IN OLDER PERLS
2346
2347 =item SEE ALSO
2348
2349 =item ACKNOWLEDGMENTS
2350
2351 =item AUTHOR, COPYRIGHT, AND LICENSE
2352
2353 =back
2354
2355 =head2 perlunicode - Unicode support in Perl
2356
2357 =over 4
2358
2359 =item DESCRIPTION
2360
2361 =over 4
2362
2363 =item Important Caveats
2364
2365 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2366 to enable UTF-8/UTF-EBCDIC in scripts
2367
2368 =item Byte and Character Semantics
2369
2370 =item Effects of Character Semantics
2371
2372 =item Scripts
2373
2374 =item Blocks
2375
2376 =item User-Defined Character Properties
2377
2378 =item Character Encodings for Input and Output
2379
2380 =item Unicode Regular Expression Support Level
2381
2382 =item Unicode Encodings
2383
2384 =item Security Implications of Unicode
2385
2386 =item Unicode in Perl on EBCDIC
2387
2388 =item Locales
2389
2390 =item Using Unicode in XS
2391
2392 =back
2393
2394 =item BUGS
2395
2396 =over 4
2397
2398 =item Interaction with Locales
2399
2400 =item Interaction with Extensions
2401
2402 =item Speed
2403
2404 =back
2405
2406 =item SEE ALSO
2407
2408 =back
2409
2410 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2411
2412 =over 4
2413
2414 =item DESCRIPTION
2415
2416 =item COMMON CHARACTER CODE SETS
2417
2418 =over 4
2419
2420 =item ASCII
2421
2422 =item ISO 8859
2423
2424 =item Latin 1 (ISO 8859-1)
2425
2426 =item EBCDIC
2427
2428 =item 13 variant characters
2429
2430 =item 0037
2431
2432 =item 1047
2433
2434 =item POSIX-BC
2435
2436 =item Unicode code points versus EBCDIC code points
2437
2438 =item Remaining Perl Unicode problems in EBCDIC
2439
2440 =item Unicode and UTF
2441
2442 =item Using Encode
2443
2444 =back
2445
2446 =item SINGLE OCTET TABLES
2447
2448 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2449
2450 =item IDENTIFYING CHARACTER CODE SETS
2451
2452 =item CONVERSIONS
2453
2454 =over 4
2455
2456 =item tr///
2457
2458 =item iconv
2459
2460 =item C RTL
2461
2462 =back
2463
2464 =item OPERATOR DIFFERENCES
2465
2466 =item FUNCTION DIFFERENCES
2467
2468 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2469
2470 =item REGULAR EXPRESSION DIFFERENCES
2471
2472 =item SOCKETS
2473
2474 =item SORTING
2475
2476 =over 4
2477
2478 =item Ignore ASCII vs. EBCDIC sort differences.
2479
2480 =item MONO CASE then sort data.
2481
2482 =item Convert, sort data, then re convert.
2483
2484 =item Perform sorting on one type of machine only.
2485
2486 =back
2487
2488 =item TRANSFORMATION FORMATS
2489
2490 =over 4
2491
2492 =item URL decoding and encoding
2493
2494 =item uu encoding and decoding
2495
2496 =item Quoted-Printable encoding and decoding
2497
2498 =item Caesarian ciphers
2499
2500 =back
2501
2502 =item Hashing order and checksums
2503
2504 =item I18N AND L10N
2505
2506 =item MULTI OCTET CHARACTER SETS
2507
2508 =item OS ISSUES
2509
2510 =over 4
2511
2512 =item OS/400
2513
2514 IFS access
2515
2516 =item OS/390, z/OS
2517
2518 chcp, dataset access, OS/390, z/OS iconv, locales
2519
2520 =item VM/ESA?
2521
2522 =item POSIX-BC?
2523
2524 =back
2525
2526 =item BUGS
2527
2528 =item SEE ALSO
2529
2530 =item REFERENCES
2531
2532 =item HISTORY
2533
2534 =item AUTHOR
2535
2536 =back
2537
2538 =head2 perlsec - Perl security
2539
2540 =over 4
2541
2542 =item DESCRIPTION
2543
2544 =over 4
2545
2546 =item Laundering and Detecting Tainted Data
2547
2548 =item Switches On the "#!" Line
2549
2550 =item Cleaning Up Your Path
2551
2552 =item Security Bugs
2553
2554 =item Protecting Your Programs
2555
2556 =item Unicode
2557
2558 =back
2559
2560 =item SEE ALSO
2561
2562 =back
2563
2564 =head2 perlmod - Perl modules (packages and symbol tables)
2565
2566 =over 4
2567
2568 =item DESCRIPTION
2569
2570 =over 4
2571
2572 =item Packages
2573
2574 =item Symbol Tables
2575
2576 =item Package Constructors and Destructors
2577
2578 =item Perl Classes
2579
2580 =item Perl Modules
2581
2582 =item Making your module threadsafe
2583
2584 =back
2585
2586 =item SEE ALSO
2587
2588 =back
2589
2590 =head2 perlmodinstall - Installing CPAN Modules
2591
2592 =over 4
2593
2594 =item DESCRIPTION
2595
2596 =over 4
2597
2598 =item PREAMBLE
2599
2600 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2601 module (sometimes unnecessary), B<INSTALL> the module
2602
2603 =back
2604
2605 =item PORTABILITY
2606
2607 =item HEY
2608
2609 =item AUTHOR
2610
2611 =item COPYRIGHT
2612
2613 =back
2614
2615 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2616
2617 =over 4
2618
2619 =item DESCRIPTION
2620
2621 =item THE PERL MODULE LIBRARY
2622
2623 =over 4
2624
2625 =item Pragmatic Modules
2626
2627 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2628 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2629 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2630 threads, utf8, vars, vmsish, warnings, warnings::register
2631
2632 =item Standard Modules
2633
2634 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2635 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2636 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2637 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2638 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2639 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2640 Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
2641 Dumpvalue, Encode, English, Env, Exporter, Exporter::Heavy,
2642 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
2643 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2644 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
2645 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
2646 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2647 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2648 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2649 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2650 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2651 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2652 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2653 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2654 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2655 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2656 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2657 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2658 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2659 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2660 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2661 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2662 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2663 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2664 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2665 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2666 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2667 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2668 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, Pod::t::basic,
2669 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
2670 Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete,
2671 Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert,
2672 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2673 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2674 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2675 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2676 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2677 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2678 Unicode::UCD, User::grent, User::pwent, Win32
2679
2680 =item Extension Modules
2681
2682 =back
2683
2684 =item CPAN
2685
2686 =over 4
2687
2688 =item Africa
2689
2690 =item Asia
2691
2692 =item Central America
2693
2694 =item Europe
2695
2696 =item North America
2697
2698 =item Oceania
2699
2700 =item South America
2701
2702 =back
2703
2704 =item Modules: Creation, Use, and Abuse
2705
2706 =over 4
2707
2708 =item Guidelines for Module Creation
2709
2710 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2711
2712 =item Guidelines for Reusing Application Code
2713
2714 =back
2715
2716 =item NOTE
2717
2718 =back
2719
2720 =head2 perlmodstyle - Perl module style guide
2721
2722 =over 4
2723
2724 =item INTRODUCTION
2725
2726 =item QUICK CHECKLIST
2727
2728 =over 4
2729
2730 =item Before you start
2731
2732 =item The API
2733
2734 =item Stability
2735
2736 =item Documentation
2737
2738 =item Release considerations
2739
2740 =back
2741
2742 =item BEFORE YOU START WRITING A MODULE
2743
2744 =over 4
2745
2746 =item Has it been done before?
2747
2748 =item Do one thing and do it well
2749
2750 =item What's in a name?
2751
2752 =back
2753
2754 =item DESIGNING AND WRITING YOUR MODULE
2755
2756 =over 4
2757
2758 =item To OO or not to OO?
2759
2760 =item Designing your API
2761
2762 Write simple routines to do simple things, Separate functionality from
2763 output, Provide sensible shortcuts and defaults, Naming conventions,
2764 Parameter passing
2765
2766 =item Strictness and warnings
2767
2768 =item Backwards compatibility
2769
2770 =item Error handling and messages
2771
2772 =back
2773
2774 =item DOCUMENTING YOUR MODULE
2775
2776 =over 4
2777
2778 =item POD
2779
2780 =item README, INSTALL, release notes, changelogs
2781
2782 =back
2783
2784 =item RELEASE CONSIDERATIONS
2785
2786 =over 4
2787
2788 =item Version numbering
2789
2790 =item Pre-requisites
2791
2792 =item Testing
2793
2794 =item Packaging
2795
2796 =item Licensing
2797
2798 =back
2799
2800 =item COMMON PITFALLS
2801
2802 =over 4
2803
2804 =item Reinventing the wheel
2805
2806 =item Trying to do too much
2807
2808 =item Inappropriate documentation
2809
2810 =back
2811
2812 =item SEE ALSO
2813
2814 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2815 http://pause.perl.org/, Any good book on software engineering
2816
2817 =item AUTHOR
2818
2819 =back
2820
2821 =head2 perlnewmod - preparing a new module for distribution
2822
2823 =over 4
2824
2825 =item DESCRIPTION
2826
2827 =over 4
2828
2829 =item Warning
2830
2831 =item What should I make into a module?
2832
2833 =item Step-by-step: Preparing the ground
2834
2835 Look around, Check it's new, Discuss the need, Choose a name, Check again
2836
2837 =item Step-by-step: Making the module
2838
2839 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2840 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2841 documentation|perlpod>, Write tests, Write the README
2842
2843 =item Step-by-step: Distributing your module
2844
2845 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2846 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2847
2848 =back
2849
2850 =item AUTHOR
2851
2852 =item SEE ALSO
2853
2854 =back
2855
2856 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2857 2002/04/07 18:46:13 $)
2858
2859 =over 4
2860
2861 =item DESCRIPTION
2862
2863 =over 4
2864
2865 =item What is Perl?
2866
2867 =item Who supports Perl?  Who develops it?  Why is it free?
2868
2869 =item Which version of Perl should I use?
2870
2871 =item What are perl4 and perl5?
2872
2873 =item What is perl6?
2874
2875 =item How stable is Perl?
2876
2877 =item Is Perl difficult to learn?
2878
2879 =item How does Perl compare with other languages like Java, Python, REXX,
2880 Scheme, or Tcl?
2881
2882 =item Can I do [task] in Perl?
2883
2884 =item When shouldn't I program in Perl?
2885
2886 =item What's the difference between "perl" and "Perl"?
2887
2888 =item Is it a Perl program or a Perl script?
2889
2890 =item What is a JAPH?
2891
2892 =item Where can I get a list of Larry Wall witticisms?
2893
2894 =item How can I convince my sysadmin/supervisor/employees to use version
2895 5/5.6.1/Perl instead of some other language?
2896
2897 =back
2898
2899 =item AUTHOR AND COPYRIGHT
2900
2901 =back
2902
2903 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2904 $Date: 2002/04/26 16:56:35 $)
2905
2906 =over 4
2907
2908 =item DESCRIPTION
2909
2910 =over 4
2911
2912 =item What machines support Perl?  Where do I get it?
2913
2914 =item How can I get a binary version of Perl?
2915
2916 =item I don't have a C compiler on my system.  How can I compile perl?
2917
2918 =item I copied the Perl binary from one machine to another, but scripts
2919 don't work.
2920
2921 =item I grabbed the sources and tried to compile but gdbm/dynamic
2922 loading/malloc/linking/... failed.  How do I make it work?
2923
2924 =item What modules and extensions are available for Perl?  What is CPAN?
2925 What does CPAN/src/... mean?
2926
2927 =item Is there an ISO or ANSI certified version of Perl?
2928
2929 =item Where can I get information on Perl?
2930
2931 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2932
2933 =item Where should I post source code?
2934
2935 =item Perl Books
2936
2937 References, Tutorials, Task-Oriented, Special Topics
2938
2939 =item Perl in Magazines
2940
2941 =item Perl on the Net: FTP and WWW Access
2942
2943 =item What mailing lists are there for Perl?
2944
2945 =item Archives of comp.lang.perl.misc
2946
2947 =item Where can I buy a commercial version of Perl?
2948
2949 =item Where do I send bug reports?
2950
2951 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2952
2953 =back
2954
2955 =item AUTHOR AND COPYRIGHT
2956
2957 =back
2958
2959 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
2960 13:11:13 $)
2961
2962 =over 4
2963
2964 =item DESCRIPTION
2965
2966 =over 4
2967
2968 =item How do I do (anything)?
2969
2970 =item How can I use Perl interactively?
2971
2972 =item Is there a Perl shell?
2973
2974 =item How do I debug my Perl programs?
2975
2976 =item How do I profile my Perl programs?
2977
2978 =item How do I cross-reference my Perl programs?
2979
2980 =item Is there a pretty-printer (formatter) for Perl?
2981
2982 =item Is there a ctags for Perl?
2983
2984 =item Is there an IDE or Windows Perl Editor?
2985
2986 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
2987 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2988 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2989
2990 =item Where can I get Perl macros for vi?
2991
2992 =item Where can I get perl-mode for emacs?
2993
2994 =item How can I use curses with Perl?
2995
2996 =item How can I use X or Tk with Perl?
2997
2998 =item How can I generate simple menus without using CGI or Tk?
2999
3000 =item How can I make my Perl program run faster?
3001
3002 =item How can I make my Perl program take less memory?
3003
3004 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3005 stringification, Pass by reference, Tie large variables to disk
3006
3007 =item Is it unsafe to return a pointer to local data?
3008
3009 =item How can I free an array or hash so my program shrinks?
3010
3011 =item How can I make my CGI script more efficient?
3012
3013 =item How can I hide the source for my Perl program?
3014
3015 =item How can I compile my Perl program into byte code or C?
3016
3017 =item How can I compile Perl into Java?
3018
3019 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3020
3021 =item Can I write useful Perl programs on the command line?
3022
3023 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3024
3025 =item Where can I learn about CGI or Web programming in Perl?
3026
3027 =item Where can I learn about object-oriented Perl programming?
3028
3029 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3030
3031 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3032 my C program; what am I doing wrong?
3033
3034 =item When I tried to run my script, I got this message. What does it mean?
3035
3036 =item What's MakeMaker?
3037
3038 =back
3039
3040 =item AUTHOR AND COPYRIGHT
3041
3042 =back
3043
3044 =head2 perlfaq4 - Data Manipulation ($Revision: 1.24 $, $Date: 2002/05/20
3045 16:50:08 $)
3046
3047 =over 4
3048
3049 =item DESCRIPTION
3050
3051 =item Data: Numbers
3052
3053 =over 4
3054
3055 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3056 numbers I should be getting (eg, 19.95)?
3057
3058 =item Why isn't my octal data interpreted correctly?
3059
3060 =item Does Perl have a round() function?  What about ceil() and floor()?
3061 Trig functions?
3062
3063 =item How do I convert between numeric representations?
3064
3065 B<How do I convert hexadecimal into decimal:>, B<How do I convert from
3066 decimal to hexadecimal:>, B<How do I convert from octal to decimal:>, B<How
3067 do I convert from decimal to octal:>, B<How do I convert from binary to
3068 decimal:>, B<How do I convert from decimal to binary:>
3069
3070 =item Why doesn't & work the way I want it to?
3071
3072 =item How do I multiply matrices?
3073
3074 =item How do I perform an operation on a series of integers?
3075
3076 =item How can I output Roman numerals?
3077
3078 =item Why aren't my random numbers random?
3079
3080 =item How do I get a random number between X and Y?
3081
3082 =back
3083
3084 =item Data: Dates
3085
3086 =over 4
3087
3088 =item How do I find the week-of-the-year/day-of-the-year?
3089
3090 =item How do I find the current century or millennium?
3091
3092 =item How can I compare two dates and find the difference?
3093
3094 =item How can I take a string and turn it into epoch seconds?
3095
3096 =item How can I find the Julian Day?
3097
3098 =item How do I find yesterday's date?
3099
3100 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3101
3102 =back
3103
3104 =item Data: Strings
3105
3106 =over 4
3107
3108 =item How do I validate input?
3109
3110 =item How do I unescape a string?
3111
3112 =item How do I remove consecutive pairs of characters?
3113
3114 =item How do I expand function calls in a string?
3115
3116 =item How do I find matching/nesting anything?
3117
3118 =item How do I reverse a string?
3119
3120 =item How do I expand tabs in a string?
3121
3122 =item How do I reformat a paragraph?
3123
3124 =item How can I access/change the first N letters of a string?
3125
3126 =item How do I change the Nth occurrence of something?
3127
3128 =item How can I count the number of occurrences of a substring within a
3129 string?
3130
3131 =item How do I capitalize all the words on one line?
3132
3133 =item How can I split a [character] delimited string except when inside
3134 [character]? (Comma-separated files)
3135
3136 =item How do I strip blank space from the beginning/end of a string?
3137
3138 =item How do I pad a string with blanks or pad a number with zeroes?
3139
3140 =item How do I extract selected columns from a string?
3141
3142 =item How do I find the soundex value of a string?
3143
3144 =item How can I expand variables in text strings?
3145
3146 =item What's wrong with always quoting "$vars"?
3147
3148 =item Why don't my <<HERE documents work?
3149
3150 1. There must be no space after the << part, 2. There (probably) should be
3151 a semicolon at the end, 3. You can't (easily) have any space in front of
3152 the tag
3153
3154 =back
3155
3156 =item Data: Arrays
3157
3158 =over 4
3159
3160 =item What is the difference between a list and an array?
3161
3162 =item What is the difference between $array[1] and @array[1]?
3163
3164 =item How can I remove duplicate elements from a list or array?
3165
3166 a), b), c), d), e)
3167
3168 =item How can I tell whether a certain element is contained in a list or
3169 array?
3170
3171 =item How do I compute the difference of two arrays?  How do I compute the
3172 intersection of two arrays?
3173
3174 =item How do I test whether two arrays or hashes are equal?
3175
3176 =item How do I find the first array element for which a condition is true?
3177
3178 =item How do I handle linked lists?
3179
3180 =item How do I handle circular lists?
3181
3182 =item How do I shuffle an array randomly?
3183
3184 =item How do I process/modify each element of an array?
3185
3186 =item How do I permute N elements of a list?
3187
3188 =item How do I sort an array by (anything)?
3189
3190 =item How do I manipulate arrays of bits?
3191
3192 =item Why does defined() return true on empty arrays and hashes?
3193
3194 =back
3195
3196 =item Data: Hashes (Associative Arrays)
3197
3198 =over 4
3199
3200 =item How do I process an entire hash?
3201
3202 =item What happens if I add or remove keys from a hash while iterating over
3203 it?
3204
3205 =item How do I look up a hash element by value?
3206
3207 =item How can I know how many entries are in a hash?
3208
3209 =item How do I sort a hash (optionally by value instead of key)?
3210
3211 =item How can I always keep my hash sorted?
3212
3213 =item What's the difference between "delete" and "undef" with hashes?
3214
3215 =item Why don't my tied hashes make the defined/exists distinction?
3216
3217 =item How do I reset an each() operation part-way through?
3218
3219 =item How can I get the unique keys from two hashes?
3220
3221 =item How can I store a multidimensional array in a DBM file?
3222
3223 =item How can I make my hash remember the order I put elements into it?
3224
3225 =item Why does passing a subroutine an undefined element in a hash create
3226 it?
3227
3228 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3229 array of hashes or arrays?
3230
3231 =item How can I use a reference as a hash key?
3232
3233 =back
3234
3235 =item Data: Misc
3236
3237 =over 4
3238
3239 =item How do I handle binary data correctly?
3240
3241 =item How do I determine whether a scalar is a number/whole/integer/float?
3242
3243 =item How do I keep persistent data across program calls?
3244
3245 =item How do I print out or copy a recursive data structure?
3246
3247 =item How do I define methods for every class/object?
3248
3249 =item How do I verify a credit card checksum?
3250
3251 =item How do I pack arrays of doubles or floats for XS code?
3252
3253 =back
3254
3255 =item AUTHOR AND COPYRIGHT
3256
3257 =back
3258
3259 =head2 perlfaq5 - Files and Formats ($Revision: 1.17 $, $Date: 2002/05/23
3260 19:33:50 $)
3261
3262 =over 4
3263
3264 =item DESCRIPTION
3265
3266 =over 4
3267
3268 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3269
3270 =item How do I change one line in a file/delete a line in a file/insert a
3271 line in the middle of a file/append to the beginning of a file?
3272
3273 =item How do I count the number of lines in a file?
3274
3275 =item How do I make a temporary file name?
3276
3277 =item How can I manipulate fixed-record-length files?
3278
3279 =item How can I make a filehandle local to a subroutine?  How do I pass
3280 filehandles between subroutines?  How do I make an array of filehandles?
3281
3282 =item How can I use a filehandle indirectly?
3283
3284 =item How can I set up a footer format to be used with write()?
3285
3286 =item How can I write() into a string?
3287
3288 =item How can I output my numbers with commas added?
3289
3290 =item How can I translate tildes (~) in a filename?
3291
3292 =item How come when I open a file read-write it wipes it out?
3293
3294 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3295
3296 =item Is there a leak/bug in glob()?
3297
3298 =item How can I open a file with a leading ">" or trailing blanks?
3299
3300 =item How can I reliably rename a file?
3301
3302 =item How can I lock a file?
3303
3304 =item Why can't I just open(FH, ">file.lock")?
3305
3306 =item I still don't get locking.  I just want to increment the number in
3307 the file.  How can I do this?
3308
3309 =item All I want to do is append a small amount of text to the end of a
3310 file.  Do I still have to use locking?
3311
3312 =item How do I randomly update a binary file?
3313
3314 =item How do I get a file's timestamp in perl?
3315
3316 =item How do I set a file's timestamp in perl?
3317
3318 =item How do I print to more than one file at once?
3319
3320 =item How can I read in an entire file all at once?
3321
3322 =item How can I read in a file by paragraphs?
3323
3324 =item How can I read a single character from a file?  From the keyboard?
3325
3326 =item How can I tell whether there's a character waiting on a filehandle?
3327
3328 =item How do I do a C<tail -f> in perl?
3329
3330 =item How do I dup() a filehandle in Perl?
3331
3332 =item How do I close a file descriptor by number?
3333
3334 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3335 `C:\temp\foo.exe` work?
3336
3337 =item Why doesn't glob("*.*") get all the files?
3338
3339 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3340 protected files?  Isn't this a bug in Perl?
3341
3342 =item How do I select a random line from a file?
3343
3344 =item Why do I get weird spaces when I print an array of lines?
3345
3346 =back
3347
3348 =item AUTHOR AND COPYRIGHT
3349
3350 =back
3351
3352 =head2 perlfaq6 - Regular Expressions ($Revision: 1.11 $, $Date: 2002/05/23
3353 15:47:37 $)
3354
3355 =over 4
3356
3357 =item DESCRIPTION
3358
3359 =over 4
3360
3361 =item How can I hope to use regular expressions without creating illegible
3362 and unmaintainable code?
3363
3364 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3365
3366 =item I'm having trouble matching over more than one line.  What's wrong?
3367
3368 =item How can I pull out lines between two patterns that are themselves on
3369 different lines?
3370
3371 =item I put a regular expression into $/ but it didn't work. What's wrong?
3372
3373 =item How do I substitute case insensitively on the LHS while preserving
3374 case on the RHS?
3375
3376 =item How can I make C<\w> match national character sets?
3377
3378 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3379
3380 =item How can I quote a variable to use in a regex?
3381
3382 =item What is C</o> really for?
3383
3384 =item How do I use a regular expression to strip C style comments from a
3385 file?
3386
3387 =item Can I use Perl regular expressions to match balanced text?
3388
3389 =item What does it mean that regexes are greedy?  How can I get around it?
3390
3391 =item How do I process each word on each line?
3392
3393 =item How can I print out a word-frequency or line-frequency summary?
3394
3395 =item How can I do approximate matching?
3396
3397 =item How do I efficiently match many regular expressions at once?
3398
3399 =item Why don't word-boundary searches with C<\b> work for me?
3400
3401 =item Why does using $&, $`, or $' slow my program down?
3402
3403 =item What good is C<\G> in a regular expression?
3404
3405 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3406
3407 =item What's wrong with using grep or map in a void context?
3408
3409 =item How can I match strings with multibyte characters?
3410
3411 =item How do I match a pattern that is supplied by the user?
3412
3413 =back
3414
3415 =item AUTHOR AND COPYRIGHT
3416
3417 =back
3418
3419 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3420 2002/03/26 15:48:32 $)
3421
3422 =over 4
3423
3424 =item DESCRIPTION
3425
3426 =over 4
3427
3428 =item Can I get a BNF/yacc/RE for the Perl language?
3429
3430 =item What are all these $@%&* punctuation signs, and how do I know when to
3431 use them?
3432
3433 =item Do I always/never have to quote my strings or use semicolons and
3434 commas?
3435
3436 =item How do I skip some return values?
3437
3438 =item How do I temporarily block warnings?
3439
3440 =item What's an extension?
3441
3442 =item Why do Perl operators have different precedence than C operators?
3443
3444 =item How do I declare/create a structure?
3445
3446 =item How do I create a module?
3447
3448 =item How do I create a class?
3449
3450 =item How can I tell if a variable is tainted?
3451
3452 =item What's a closure?
3453
3454 =item What is variable suicide and how can I prevent it?
3455
3456 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3457 Regex}?
3458
3459 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3460 Passing Methods
3461
3462 =item How do I create a static variable?
3463
3464 =item What's the difference between dynamic and lexical (static) scoping?
3465 Between local() and my()?
3466
3467 =item How can I access a dynamic variable while a similarly named lexical
3468 is in scope?
3469
3470 =item What's the difference between deep and shallow binding?
3471
3472 =item Why doesn't "my($foo) = <FILE>;" work right?
3473
3474 =item How do I redefine a builtin function, operator, or method?
3475
3476 =item What's the difference between calling a function as &foo and foo()?
3477
3478 =item How do I create a switch or case statement?
3479
3480 =item How can I catch accesses to undefined variables/functions/methods?
3481
3482 =item Why can't a method included in this same file be found?
3483
3484 =item How can I find out my current package?
3485
3486 =item How can I comment out a large block of perl code?
3487
3488 =item How do I clear a package?
3489
3490 =item How can I use a variable as a variable name?
3491
3492 =back
3493
3494 =item AUTHOR AND COPYRIGHT
3495
3496 =back
3497
3498 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3499 12:41:42 $)
3500
3501 =over 4
3502
3503 =item DESCRIPTION
3504
3505 =over 4
3506
3507 =item How do I find out which operating system I'm running under?
3508
3509 =item How come exec() doesn't return?
3510
3511 =item How do I do fancy stuff with the keyboard/screen/mouse?
3512
3513 Keyboard, Screen, Mouse
3514
3515 =item How do I print something out in color?
3516
3517 =item How do I read just one key without waiting for a return key?
3518
3519 =item How do I check whether input is ready on the keyboard?
3520
3521 =item How do I clear the screen?
3522
3523 =item How do I get the screen size?
3524
3525 =item How do I ask the user for a password?
3526
3527 =item How do I read and write the serial port?
3528
3529 lockfiles, open mode, end of line, flushing output, non-blocking input
3530
3531 =item How do I decode encrypted password files?
3532
3533 =item How do I start a process in the background?
3534
3535 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3536
3537 =item How do I trap control characters/signals?
3538
3539 =item How do I modify the shadow password file on a Unix system?
3540
3541 =item How do I set the time and date?
3542
3543 =item How can I sleep() or alarm() for under a second?
3544
3545 =item How can I measure time under a second?
3546
3547 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3548
3549 =item Why doesn't my sockets program work under System V (Solaris)?  What
3550 does the error message "Protocol not supported" mean?
3551
3552 =item How can I call my system's unique C functions from Perl?
3553
3554 =item Where do I get the include files to do ioctl() or syscall()?
3555
3556 =item Why do setuid perl scripts complain about kernel problems?
3557
3558 =item How can I open a pipe both to and from a command?
3559
3560 =item Why can't I get the output of a command with system()?
3561
3562 =item How can I capture STDERR from an external command?
3563
3564 =item Why doesn't open() return an error when a pipe open fails?
3565
3566 =item What's wrong with using backticks in a void context?
3567
3568 =item How can I call backticks without shell processing?
3569
3570 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3571 ^Z on MS-DOS)?
3572
3573 =item How can I convert my shell script to perl?
3574
3575 =item Can I use perl to run a telnet or ftp session?
3576
3577 =item How can I write expect in Perl?
3578
3579 =item Is there a way to hide perl's command line from programs such as
3580 "ps"?
3581
3582 =item I {changed directory, modified my environment} in a perl script.  How
3583 come the change disappeared when I exited the script?  How do I get my
3584 changes to be visible?
3585
3586 Unix
3587
3588 =item How do I close a process's filehandle without waiting for it to
3589 complete?
3590
3591 =item How do I fork a daemon process?
3592
3593 =item How do I find out if I'm running interactively or not?
3594
3595 =item How do I timeout a slow event?
3596
3597 =item How do I set CPU limits?
3598
3599 =item How do I avoid zombies on a Unix system?
3600
3601 =item How do I use an SQL database?
3602
3603 =item How do I make a system() exit on control-C?
3604
3605 =item How do I open a file without blocking?
3606
3607 =item How do I install a module from CPAN?
3608
3609 =item What's the difference between require and use?
3610
3611 =item How do I keep my own module/library directory?
3612
3613 =item How do I add the directory my program lives in to the module/library
3614 search path?
3615
3616 =item How do I add a directory to my include path at runtime?
3617
3618 =item What is socket.ph and where do I get it?
3619
3620 =back
3621
3622 =item AUTHOR AND COPYRIGHT
3623
3624 =back
3625
3626 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3627 $)
3628
3629 =over 4
3630
3631 =item DESCRIPTION
3632
3633 =over 4
3634
3635 =item What is the correct form of response from a CGI script?
3636
3637 =item My CGI script runs from the command line but not the browser.  (500
3638 Server Error)
3639
3640 =item How can I get better error messages from a CGI program?
3641
3642 =item How do I remove HTML from a string?
3643
3644 =item How do I extract URLs?
3645
3646 =item How do I download a file from the user's machine?  How do I open a
3647 file on another machine?
3648
3649 =item How do I make a pop-up menu in HTML?
3650
3651 =item How do I fetch an HTML file?
3652
3653 =item How do I automate an HTML form submission?
3654
3655 =item How do I decode or create those %-encodings on the web?
3656
3657 =item How do I redirect to another page?
3658
3659 =item How do I put a password on my web pages?
3660
3661 =item How do I edit my .htpasswd and .htgroup files with Perl?
3662
3663 =item How do I make sure users can't enter values into a form that cause my
3664 CGI script to do bad things?
3665
3666 =item How do I parse a mail header?
3667
3668 =item How do I decode a CGI form?
3669
3670 =item How do I check a valid mail address?
3671
3672 =item How do I decode a MIME/BASE64 string?
3673
3674 =item How do I return the user's mail address?
3675
3676 =item How do I send mail?
3677
3678 =item How do I use MIME to make an attachment to a mail message?
3679
3680 =item How do I read mail?
3681
3682 =item How do I find out my hostname/domainname/IP address?
3683
3684 =item How do I fetch a news article or the active newsgroups?
3685
3686 =item How do I fetch/put an FTP file?
3687
3688 =item How can I do RPC in Perl?
3689
3690 =back
3691
3692 =item AUTHOR AND COPYRIGHT
3693
3694 =back
3695
3696 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3697
3698 =over 4
3699
3700 =item DESCRIPTION
3701
3702 =over 4
3703
3704 =item Layout
3705
3706 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3707
3708 =back
3709
3710 =item Using The Back Ends
3711
3712 =over 4
3713
3714 =item The Cross Referencing Back End
3715
3716 i, &, s, r
3717
3718 =item The Decompiling Back End
3719
3720 =item The Lint Back End
3721
3722 =item The Simple C Back End
3723
3724 =item The Bytecode Back End
3725
3726 =item The Optimized C Back End
3727
3728 =back
3729
3730 =item Module List for the Compiler Suite
3731
3732 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3733 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3734 B::Stackobj, B::Stash, B::Terse, B::Xref
3735
3736 =item KNOWN PROBLEMS
3737
3738 =item AUTHOR
3739
3740 =back
3741
3742 =head2 perlembed - how to embed perl in your C program
3743
3744 =over 4
3745
3746 =item DESCRIPTION
3747
3748 =over 4
3749
3750 =item PREAMBLE
3751
3752 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3753 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3754
3755 =item ROADMAP
3756
3757 =item Compiling your C program
3758
3759 =item Adding a Perl interpreter to your C program
3760
3761 =item Calling a Perl subroutine from your C program
3762
3763 =item Evaluating a Perl statement from your C program
3764
3765 =item Performing Perl pattern matches and substitutions from your C program
3766
3767 =item Fiddling with the Perl stack from your C program
3768
3769 =item Maintaining a persistent interpreter
3770
3771 =item Execution of END blocks
3772
3773 =item Maintaining multiple interpreter instances
3774
3775 =item Using Perl modules, which themselves use C libraries, from your C
3776 program
3777
3778 =back
3779
3780 =item Embedding Perl under Win32
3781
3782 =item MORAL
3783
3784 =item AUTHOR
3785
3786 =item COPYRIGHT
3787
3788 =back
3789
3790 =head2 perldebguts - Guts of Perl debugging
3791
3792 =over 4
3793
3794 =item DESCRIPTION
3795
3796 =item Debugger Internals
3797
3798 =over 4
3799
3800 =item Writing Your Own Debugger
3801
3802 =back
3803
3804 =item Frame Listing Output Examples
3805
3806 =item Debugging regular expressions
3807
3808 =over 4
3809
3810 =item Compile-time output
3811
3812 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3813 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3814 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3815 C<anchored(TYPE)>
3816
3817 =item Types of nodes
3818
3819 =item Run-time output
3820
3821 =back
3822
3823 =item Debugging Perl memory usage
3824
3825 =over 4
3826
3827 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3828
3829 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3830 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3831 6144>
3832
3833 =item Example of using B<-DL> switch
3834
3835 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3836
3837 =item B<-DL> details
3838
3839 C<!!!>, C<!!>, C<!>
3840
3841 =item Limitations of B<-DL> statistics
3842
3843 =back
3844
3845 =item SEE ALSO
3846
3847 =back
3848
3849 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3850
3851 =over 4
3852
3853 =item DESCRIPTION
3854
3855 =item SPECIAL NOTES
3856
3857 =over 4
3858
3859 =item make
3860
3861 =item Version caveat
3862
3863 =item Dynamic Loading versus Static Loading
3864
3865 =back
3866
3867 =item TUTORIAL
3868
3869 =over 4
3870
3871 =item EXAMPLE 1
3872
3873 =item EXAMPLE 2
3874
3875 =item What has gone on?
3876
3877 =item Writing good test scripts
3878
3879 =item EXAMPLE 3
3880
3881 =item What's new here?
3882
3883 =item Input and Output Parameters
3884
3885 =item The XSUBPP Program
3886
3887 =item The TYPEMAP file
3888
3889 =item Warning about Output Arguments
3890
3891 =item EXAMPLE 4
3892
3893 =item What has happened here?
3894
3895 =item Anatomy of .xs file
3896
3897 =item Getting the fat out of XSUBs
3898
3899 =item More about XSUB arguments
3900
3901 =item The Argument Stack
3902
3903 =item Extending your Extension
3904
3905 =item Documenting your Extension
3906
3907 =item Installing your Extension
3908
3909 =item EXAMPLE 5
3910
3911 =item New Things in this Example
3912
3913 =item EXAMPLE 6
3914
3915 =item New Things in this Example
3916
3917 =item EXAMPLE 7 (Coming Soon)
3918
3919 =item EXAMPLE 8 (Coming Soon)
3920
3921 =item EXAMPLE 9 Passing open files to XSes
3922
3923 =item Troubleshooting these Examples
3924
3925 =back
3926
3927 =item See also
3928
3929 =item Author
3930
3931 =over 4
3932
3933 =item Last Changed
3934
3935 =back
3936
3937 =back
3938
3939 =head2 perlxs - XS language reference manual
3940
3941 =over 4
3942
3943 =item DESCRIPTION
3944
3945 =over 4
3946
3947 =item Introduction
3948
3949 =item On The Road
3950
3951 =item The Anatomy of an XSUB
3952
3953 =item The Argument Stack
3954
3955 =item The RETVAL Variable
3956
3957 =item The MODULE Keyword
3958
3959 =item The PACKAGE Keyword
3960
3961 =item The PREFIX Keyword
3962
3963 =item The OUTPUT: Keyword
3964
3965 =item The NO_OUTPUT Keyword
3966
3967 =item The CODE: Keyword
3968
3969 =item The INIT: Keyword
3970
3971 =item The NO_INIT Keyword
3972
3973 =item Initializing Function Parameters
3974
3975 =item Default Parameter Values
3976
3977 =item The PREINIT: Keyword
3978
3979 =item The SCOPE: Keyword
3980
3981 =item The INPUT: Keyword
3982
3983 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3984
3985 =item The C<length(NAME)> Keyword
3986
3987 =item Variable-length Parameter Lists
3988
3989 =item The C_ARGS: Keyword
3990
3991 =item The PPCODE: Keyword
3992
3993 =item Returning Undef And Empty Lists
3994
3995 =item The REQUIRE: Keyword
3996
3997 =item The CLEANUP: Keyword
3998
3999 =item The POSTCALL: Keyword
4000
4001 =item The BOOT: Keyword
4002
4003 =item The VERSIONCHECK: Keyword
4004
4005 =item The PROTOTYPES: Keyword
4006
4007 =item The PROTOTYPE: Keyword
4008
4009 =item The ALIAS: Keyword
4010
4011 =item The OVERLOAD: Keyword
4012
4013 =item The INTERFACE: Keyword
4014
4015 =item The INTERFACE_MACRO: Keyword
4016
4017 =item The INCLUDE: Keyword
4018
4019 =item The CASE: Keyword
4020
4021 =item The & Unary Operator
4022
4023 =item Inserting POD, Comments and C Preprocessor Directives
4024
4025 =item Using XS With C++
4026
4027 =item Interface Strategy
4028
4029 =item Perl Objects And C Structures
4030
4031 =item The Typemap
4032
4033 =item Safely Storing Static Data in XS
4034
4035 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4036
4037 =back
4038
4039 =item EXAMPLES
4040
4041 =item XS VERSION
4042
4043 =item AUTHOR
4044
4045 =back
4046
4047 =head2 perlclib - Internal replacements for standard C library functions
4048
4049 =over 4
4050
4051 =item DESCRIPTION
4052
4053 =over 4
4054
4055 =item Conventions
4056
4057 C<t>, C<p>, C<n>, C<s>
4058
4059 =item File Operations
4060
4061 =item File Input and Output
4062
4063 =item File Positioning
4064
4065 =item Memory Management and String Handling
4066
4067 =item Character Class Tests
4068
4069 =item F<stdlib.h> functions
4070
4071 =item Miscellaneous functions
4072
4073 =back
4074
4075 =item SEE ALSO
4076
4077 =back
4078
4079 =head2 perlguts - Introduction to the Perl API
4080
4081 =over 4
4082
4083 =item DESCRIPTION
4084
4085 =item Variables
4086
4087 =over 4
4088
4089 =item Datatypes
4090
4091 =item What is an "IV"?
4092
4093 =item Working with SVs
4094
4095 =item Offsets
4096
4097 =item What's Really Stored in an SV?
4098
4099 =item Working with AVs
4100
4101 =item Working with HVs
4102
4103 =item Hash API Extensions
4104
4105 =item References
4106
4107 =item Blessed References and Class Objects
4108
4109 =item Creating New Variables
4110
4111 GV_ADDMULTI, GV_ADDWARN
4112
4113 =item Reference Counts and Mortality
4114
4115 =item Stashes and Globs
4116
4117 =item Double-Typed SVs
4118
4119 =item Magic Variables
4120
4121 =item Assigning Magic
4122
4123 =item Magic Virtual Tables
4124
4125 =item Finding Magic
4126
4127 =item Understanding the Magic of Tied Hashes and Arrays
4128
4129 =item Localizing changes
4130
4131 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4132 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4133 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4134 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4135 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4136 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4137 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4138 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4139 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4140 save_hptr(HV **hptr)>
4141
4142 =back
4143
4144 =item Subroutines
4145
4146 =over 4
4147
4148 =item XSUBs and the Argument Stack
4149
4150 =item Calling Perl Routines from within C Programs
4151
4152 =item Memory Allocation
4153
4154 =item PerlIO
4155
4156 =item Putting a C value on Perl stack
4157
4158 =item Scratchpads
4159
4160 =item Scratchpads and recursion
4161
4162 =back
4163
4164 =item Compiled code
4165
4166 =over 4
4167
4168 =item Code tree
4169
4170 =item Examining the tree
4171
4172 =item Compile pass 1: check routines
4173
4174 =item Compile pass 1a: constant folding
4175
4176 =item Compile pass 2: context propagation
4177
4178 =item Compile pass 3: peephole optimization
4179
4180 =item Pluggable runops
4181
4182 =back
4183
4184 =item Examining internal data structures with the C<dump> functions
4185
4186 =item How multiple interpreters and concurrency are supported
4187
4188 =over 4
4189
4190 =item Background and PERL_IMPLICIT_CONTEXT
4191
4192 =item So what happened to dTHR?
4193
4194 =item How do I use all this in extensions?
4195
4196 =item Should I do anything special if I call perl from multiple threads?
4197
4198 =item Future Plans and PERL_IMPLICIT_SYS
4199
4200 =back
4201
4202 =item Internal Functions
4203
4204 A, p, d, s, n, r, f, M, o, j, x
4205
4206 =over 4
4207
4208 =item Formatted Printing of IVs, UVs, and NVs
4209
4210 =item Pointer-To-Integer and Integer-To-Pointer
4211
4212 =item Source Documentation
4213
4214 =back
4215
4216 =item Unicode Support
4217
4218 =over 4
4219
4220 =item What B<is> Unicode, anyway?
4221
4222 =item How can I recognise a UTF8 string?
4223
4224 =item How does UTF8 represent Unicode characters?
4225
4226 =item How does Perl store UTF8 strings?
4227
4228 =item How do I convert a string to UTF8?
4229
4230 =item Is there anything else I need to know?
4231
4232 =back
4233
4234 =item Custom Operators
4235
4236 =item AUTHORS
4237
4238 =item SEE ALSO
4239
4240 =back
4241
4242 =head2 perlcall - Perl calling conventions from C
4243
4244 =over 4
4245
4246 =item DESCRIPTION
4247
4248 An Error Handler, An Event Driven Program
4249
4250 =item THE CALL_ FUNCTIONS
4251
4252 call_sv, call_pv, call_method, call_argv
4253
4254 =item FLAG VALUES
4255
4256 =over 4
4257
4258 =item  G_VOID
4259
4260 =item  G_SCALAR
4261
4262 =item G_ARRAY
4263
4264 =item G_DISCARD
4265
4266 =item G_NOARGS
4267
4268 =item G_EVAL
4269
4270 =item G_KEEPERR
4271
4272 =item Determining the Context
4273
4274 =back
4275
4276 =item KNOWN PROBLEMS
4277
4278 =item EXAMPLES
4279
4280 =over 4
4281
4282 =item No Parameters, Nothing returned
4283
4284 =item Passing Parameters
4285
4286 =item Returning a Scalar
4287
4288 =item Returning a list of values
4289
4290 =item Returning a list in a scalar context
4291
4292 =item Returning Data from Perl via the parameter list
4293
4294 =item Using G_EVAL
4295
4296 =item Using G_KEEPERR
4297
4298 =item Using call_sv
4299
4300 =item Using call_argv
4301
4302 =item Using call_method
4303
4304 =item Using GIMME_V
4305
4306 =item Using Perl to dispose of temporaries
4307
4308 =item Strategies for storing Callback Context Information
4309
4310 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4311 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4312 callback
4313
4314 =item Alternate Stack Manipulation
4315
4316 =item Creating and calling an anonymous subroutine in C
4317
4318 =back
4319
4320 =item SEE ALSO
4321
4322 =item AUTHOR
4323
4324 =item DATE
4325
4326 =back
4327
4328 =head2 perlutil - utilities packaged with the Perl distribution
4329
4330 =over 4
4331
4332 =item DESCRIPTION
4333
4334 =over 4
4335
4336 =item DOCUMENTATION
4337
4338 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4339 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4340 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4341 L<roffitall|roffitall>
4342
4343 =item CONVERTORS
4344
4345 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4346
4347 =item Administration
4348
4349 L<libnetcfg|libnetcfg>
4350
4351 =item Development
4352
4353 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4354 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4355
4356 =item SEE ALSO
4357
4358 =back
4359
4360 =back
4361
4362 =head2 perlfilter - Source Filters
4363
4364 =over 4
4365
4366 =item DESCRIPTION
4367
4368 =item CONCEPTS
4369
4370 =item USING FILTERS
4371
4372 =item WRITING A SOURCE FILTER
4373
4374 =item WRITING A SOURCE FILTER IN C
4375
4376 B<Decryption Filters>
4377
4378 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4379
4380 =item WRITING A SOURCE FILTER IN PERL
4381
4382 =item USING CONTEXT: THE DEBUG FILTER
4383
4384 =item CONCLUSION
4385
4386 =item REQUIREMENTS
4387
4388 =item AUTHOR
4389
4390 =item Copyrights
4391
4392 =back
4393
4394 =head2 perldbmfilter - Perl DBM Filters
4395
4396 =over 4
4397
4398 =item SYNOPSIS
4399
4400 =item DESCRIPTION
4401
4402 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4403 B<filter_fetch_value>
4404
4405 =over 4
4406
4407 =item The Filter
4408
4409 =item An Example -- the NULL termination problem.
4410
4411 =item Another Example -- Key is a C int.
4412
4413 =back
4414
4415 =item SEE ALSO
4416
4417 =item AUTHOR
4418
4419 =back
4420
4421 =head2 perlapi - autogenerated documentation for the perl public API
4422
4423 =over 4
4424
4425 =item DESCRIPTION
4426
4427 =item "Gimme" Values
4428
4429 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4430
4431 =item Array Manipulation Functions
4432
4433 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4434 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4435 get_av, newAV, Nullav, sortsv
4436
4437 =item Callback Functions
4438
4439 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4440 FREETMPS, LEAVE, SAVETMPS
4441
4442 =item Character classes
4443
4444 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4445
4446 =item Cloning an interpreter
4447
4448 perl_clone
4449
4450 =item CV Manipulation Functions
4451
4452 CvSTASH, get_cv, Nullcv
4453
4454 =item Embedding Functions
4455
4456 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4457 perl_free, perl_parse, perl_run, require_pv
4458
4459 =item Functions in file pp_pack.c
4460
4461 pack_cat, unpack_str
4462
4463 =item Global Variables
4464
4465 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4466
4467 =item GV Functions
4468
4469 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4470 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4471
4472 =item Handy Values
4473
4474 HEf_SVKEY, Nullch, Nullsv
4475
4476 =item Hash Manipulation Functions
4477
4478 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4479 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4480 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4481 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4482 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4483
4484 =item Magical Functions
4485
4486 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4487 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4488 SvSetSV, SvSetSV_nosteal, SvSHARE
4489
4490 =item Memory Management
4491
4492 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4493 savepv, savepvn, savesharedpv, StructCopy, Zero
4494
4495 =item Miscellaneous Functions
4496
4497 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4498 strNE, strnEQ, strnNE
4499
4500 =item Numeric functions
4501
4502 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4503 scan_hex, scan_oct
4504
4505 =item Optree Manipulation Functions
4506
4507 cv_const_sv, newCONSTSUB, newXS
4508
4509 =item Stack Manipulation Macros
4510
4511 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4512 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4513 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4514 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4515 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4516
4517 =item SV Flags
4518
4519 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4520
4521 =item SV Manipulation Functions
4522
4523 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4524 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4525 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4526 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4527 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4528 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4529 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4530 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4531 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4532 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4533 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4534 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4535 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4536 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4537 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4538 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4539 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4540 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4541 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4542 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4543 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4544 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4545 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4546 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4547 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4548 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4549 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4550 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4551 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4552 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4553 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4554 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4555 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4556
4557 =item Unicode Support
4558
4559 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4560 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4561 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4562 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4563 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4564
4565 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4566
4567 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4568 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4569
4570 =item Warning and Dieing
4571
4572 croak, warn
4573
4574 =item AUTHORS
4575
4576 =item SEE ALSO
4577
4578 =back
4579
4580 =head2 perlintern - autogenerated documentation of purely B<internal>
4581                  Perl functions
4582
4583 =over 4
4584
4585 =item DESCRIPTION
4586
4587 =item Global Variables
4588
4589 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4590 PL_rs
4591
4592 =item GV Functions
4593
4594 is_gv_magical
4595
4596 =item IO Functions
4597
4598 start_glob
4599
4600 =item Pad Data Structures
4601
4602 CvPADLIST
4603
4604 =item Stack Manipulation Macros
4605
4606 djSP, LVRET
4607
4608 =item SV Manipulation Functions
4609
4610 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4611
4612 =item AUTHORS
4613
4614 =item SEE ALSO
4615
4616 =back
4617
4618 =head2 perliol - C API for Perl's implementation of IO in Layers.
4619
4620 =over 4
4621
4622 =item SYNOPSIS
4623
4624 =item DESCRIPTION
4625
4626 =over 4
4627
4628 =item History and Background
4629
4630 =item Layers vs Disciplines
4631
4632 =item Data Structures
4633
4634 =item Functions and Attributes
4635
4636 =item Per-instance Data
4637
4638 =item Layers in action.
4639
4640 =item Per-instance flag bits
4641
4642 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4643 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4644 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4645 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4646
4647 =item Methods in Detail
4648
4649 name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
4650 PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
4651 Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
4652 Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
4653
4654 =item Core Layers
4655
4656 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4657
4658 =item Extension Layers
4659
4660 ":encoding", ":Scalar", ":Via"
4661
4662 =back
4663
4664 =item TODO
4665
4666 =back
4667
4668 =head2 perlapio - perl's IO abstraction interface.
4669
4670 =over 4
4671
4672 =item SYNOPSIS
4673
4674 =item DESCRIPTION
4675
4676 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4677 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4678 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4679 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4680 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4681 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4682 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4683 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4684 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4685 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4686 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4687
4688 =over 4
4689
4690 =item Co-existence with stdio
4691
4692 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4693 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4694
4695 =item "Fast gets" Functions
4696
4697 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4698 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4699 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4700 B<PerlIO_get_bufsiz(f)>
4701
4702 =item Other Functions
4703
4704 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4705 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4706
4707 =back
4708
4709 =back
4710
4711 =head2 perltodo - Perl TO-DO List
4712
4713 =over 4
4714
4715 =item DESCRIPTION
4716
4717 =item To do during 5.6.x
4718
4719 =over 4
4720
4721 =item Support for I/O disciplines
4722
4723 =item Autoload bytes.pm
4724
4725 =item Make "\u{XXXX}" et al work
4726
4727 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4728
4729 =item Overloadable regex assertions
4730
4731 =item Unicode
4732
4733 =item Work out exit/die semantics for threads
4734
4735 =item Better support for nonpreemptive threading systems like GNU pth
4736
4737 =item Typed lexicals for compiler
4738
4739 =item Compiler workarounds for Win32
4740
4741 =item AUTOLOADing in the compiler
4742
4743 =item Fixing comppadlist when compiling
4744
4745 =item Cleaning up exported namespace
4746
4747 =item Complete signal handling
4748
4749 =item Out-of-source builds
4750
4751 =item POSIX realtime support
4752
4753 =item UNIX98 support
4754
4755 =item IPv6 Support
4756
4757 =item Long double conversion
4758
4759 =item Locales
4760
4761 =item Arithmetic on non-Arabic numerals
4762
4763 =item POSIX Unicode character classes
4764
4765 =item Factoring out common suffices/prefices in regexps (trie optimization)
4766
4767 =item Security audit shipped utilities
4768
4769 =item Sort out the uid-setting mess
4770
4771 =item Custom opcodes
4772
4773 =item DLL Versioning
4774
4775 =item Introduce @( and @)
4776
4777 =item Floating point handling
4778
4779 =item IV/UV preservation
4780
4781 =item Replace pod2html with something using Pod::Parser
4782
4783 =item Automate module testing on CPAN
4784
4785 =item sendmsg and recvmsg
4786
4787 =item Rewrite perlre documentation
4788
4789 =item Convert example code to IO::Handle filehandles
4790
4791 =item Document Win32 choices
4792
4793 =item Check new modules
4794
4795 =item Make roffitall find pods and libs itself
4796
4797 =back
4798
4799 =item To do at some point
4800
4801 =over 4
4802
4803 =item Remove regular expression recursion
4804
4805 =item Memory leaks after failed eval
4806
4807 =item bitfields in pack
4808
4809 =item Cross compilation
4810
4811 =item Perl preprocessor / macros
4812
4813 =item Perl lexer in Perl
4814
4815 =item Using POSIX calls internally
4816
4817 =item -i rename file when changed
4818
4819 =item All ARGV input should act like E<lt>E<gt>
4820
4821 =item Support for rerunning debugger
4822
4823 =item Test Suite for the Debugger
4824
4825 =item my sub foo { }
4826
4827 =item One-pass global destruction
4828
4829 =item Rewrite regexp parser
4830
4831 =item Cache recently used regexps
4832
4833 =item Cross-compilation support
4834
4835 =item Bit-shifting bitvectors
4836
4837 =item debugger pragma
4838
4839 =item use less pragma
4840
4841 =item switch structures
4842
4843 =item Cache eval tree
4844
4845 =item rcatmaybe
4846
4847 =item Shrink opcode tables
4848
4849 =item Optimize away @_
4850
4851 =item Prototypes versus indirect objects
4852
4853 =item Install HTML
4854
4855 =item Prototype method calls
4856
4857 =item Return context prototype declarations
4858
4859 =item magic_setisa
4860
4861 =item Garbage collection
4862
4863 =item IO tutorial
4864
4865 =item Rewrite perldoc
4866
4867 =item Install .3p manpages
4868
4869 =item Unicode tutorial
4870
4871 =item Update POSIX.pm for 1003.1-2
4872
4873 =item Retargetable installation
4874
4875 =item POSIX emulation on non-POSIX systems
4876
4877 =item Rename Win32 headers
4878
4879 =item Finish off lvalue functions
4880
4881 =item Update sprintf documentation
4882
4883 =item Use fchown/fchmod internally
4884
4885 =item Make v-strings overloaded objects
4886
4887 =item Allow restricted hash assignment
4888
4889 =item Should overload be inheritable?
4890
4891 =item Taint rethink
4892
4893 =back
4894
4895 =item Vague ideas
4896
4897 =over 4
4898
4899 =item ref() in list context
4900
4901 =item Make tr/// return histogram of characters in list context
4902
4903 =item Compile to real threaded code
4904
4905 =item Structured types
4906
4907 =item Modifiable $1 et al.
4908
4909 =item Procedural interfaces for IO::*, etc.
4910
4911 =item RPC modules
4912
4913 =item Attach/detach debugger from running program
4914
4915 =item GUI::Native
4916
4917 =item foreach(reverse ...)
4918
4919 =item Constant function cache
4920
4921 =item Approximate regular expression matching
4922
4923 =back
4924
4925 =item Ongoing
4926
4927 =over 4
4928
4929 =item Update guts documentation
4930
4931 =item Add more tests
4932
4933 =item Update auxiliary tools
4934
4935 =item Create debugging macros
4936
4937 =item truncate to the people
4938
4939 =item Unicode in Filenames
4940
4941 =back
4942
4943 =item Recently done things
4944
4945 =over 4
4946
4947 =item Alternative RE syntax module
4948
4949 =item Safe signal handling
4950
4951 =item Tie Modules
4952
4953 =item gettimeofday
4954
4955 =item setitimer and getimiter
4956
4957 =item Testing __DIE__ hook
4958
4959 =item CPP equivalent in Perl
4960
4961 =item Explicit switch statements
4962
4963 =item autocroak
4964
4965 =item UTF/EBCDIC
4966
4967 =item UTF Regexes
4968
4969 =item perlcc to produce executable
4970
4971 =item END blocks saved in compiled output
4972
4973 =item Secure temporary file module
4974
4975 =item Integrate Time::HiRes
4976
4977 =item Turn Cwd into XS
4978
4979 =item Mmap for input
4980
4981 =item Byte to/from UTF8 and UTF8 to/from local conversion
4982
4983 =item Add sockatmark support
4984
4985 =item Mailing list archives
4986
4987 =item Bug tracking
4988
4989 =item Integrate MacPerl
4990
4991 =item Web "nerve center" for Perl
4992
4993 =item Regular expression tutorial
4994
4995 =item Debugging Tutorial
4996
4997 =item Integrate new modules
4998
4999 =item Integrate profiler
5000
5001 =item Y2K error detection
5002
5003 =item Regular expression debugger
5004
5005 =item POD checker
5006
5007 =item "Dynamic" lexicals
5008
5009 =item Cache precompiled modules
5010
5011 =back
5012
5013 =item Deprecated Wishes
5014
5015 =over 4
5016
5017 =item Loop control on do{}
5018
5019 =item Lexically scoped typeglobs
5020
5021 =item format BOTTOM
5022
5023 =item report HANDLE
5024
5025 =item Generalised want()/caller())
5026
5027 =item Named prototypes
5028
5029 =item Built-in globbing
5030
5031 =item Regression tests for suidperl
5032
5033 =item Cached hash values
5034
5035 =item Add compression modules
5036
5037 =item Reorganise documentation into tutorials/references
5038
5039 =item Remove distinction between functions and operators
5040
5041 =item Make XS easier to use
5042
5043 =item Make embedding easier to use
5044
5045 =item man for perl
5046
5047 =item my $Package::variable
5048
5049 =item "or" tests defined, not truth
5050
5051 =item "class"-based lexicals
5052
5053 =item byteperl
5054
5055 =item Lazy evaluation / tail recursion removal
5056
5057 =item Make "use utf8" the default
5058
5059 =item Unicode collation and normalization
5060
5061 =item pack/unpack tutorial
5062
5063 =back
5064
5065 =back
5066
5067 =head2 perlhack - How to hack at the Perl internals
5068
5069 =over 4
5070
5071 =item DESCRIPTION
5072
5073 Does concept match the general goals of Perl?, Where is the
5074 implementation?, Backwards compatibility, Could it be a module instead?, Is
5075 the feature generic enough?, Does it potentially introduce new bugs?, Does
5076 it preclude other desirable features?, Is the implementation robust?, Is
5077 the implementation generic enough to be portable?, Is the implementation
5078 tested?, Is there enough documentation?, Is there another way to do it?,
5079 Does it create too much work?, Patches speak louder than words
5080
5081 =over 4
5082
5083 =item Keeping in sync
5084
5085 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5086 NFS, rsync'ing the patches
5087
5088 =item Why rsync the source tree
5089
5090 It's easier to rsync the source tree, It's more recent, It's more reliable
5091
5092 =item Why rsync the patches
5093
5094 It's easier to rsync the patches, It's a good reference, Finding a start
5095 point, Finding how to fix a bug, Finding the source of misbehaviour
5096
5097 =item Perlbug remote interface
5098
5099 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5100 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5101
5102 =item Submitting patches
5103
5104 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5105 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5106
5107 =item Finding Your Way Around
5108
5109 Core modules, Tests, Documentation, Configure, Interpreter
5110
5111 =item Elements of the interpreter
5112
5113 Startup, Parsing, Optimization, Running
5114
5115 =item Internal Variable Types
5116
5117 =item Op Trees
5118
5119 =item Stacks
5120
5121 Argument stack, Mark stack, Save stack
5122
5123 =item Millions of Macros
5124
5125 =item Poking at Perl
5126
5127 =item Using a source-level debugger
5128
5129 run [args], break function_name, break source.c:xxx, step, next, continue,
5130 finish, 'enter', print
5131
5132 =item Dumping Perl Data Structures
5133
5134 =item Patching
5135
5136 =item Patching a core module
5137
5138 =item Adding a new function to the core
5139
5140 =item Writing a test
5141
5142 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5143 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5144
5145 =item Special Make Test Targets
5146
5147 coretest, test.deparse, minitest, test.third check.third utest.third
5148 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5149
5150 =back
5151
5152 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5153
5154 =over 4
5155
5156 =item Rational Software's Purify
5157
5158 =item Purify on Unix
5159
5160 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5161
5162 =item Purify on NT
5163
5164 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5165
5166 =item Compaq's/Digital's/HP's Third Degree
5167
5168 =item PERL_DESTRUCT_LEVEL
5169
5170 =item Profiling
5171
5172 =item Gprof Profiling
5173
5174 -a, -b, -e routine, -f routine, -s, -z
5175
5176 =item GCC gcov Profiling
5177
5178 =item Pixie Profiling
5179
5180 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5181 -z[ero]
5182
5183 =item Miscellaneous tricks
5184
5185 =item CONCLUSION
5186
5187 I<The Road goes ever on and on, down from the door where it began.>
5188
5189 =back
5190
5191 =item AUTHOR
5192
5193 =back
5194
5195 =head2 perlhist - the Perl history records
5196
5197 =over 4
5198
5199 =item DESCRIPTION
5200
5201 =item INTRODUCTION
5202
5203 =item THE KEEPERS OF THE PUMPKIN
5204
5205 =over 4
5206
5207 =item PUMPKIN?
5208
5209 =back
5210
5211 =item THE RECORDS
5212
5213 =over 4
5214
5215 =item SELECTED RELEASE SIZES
5216
5217 =item SELECTED PATCH SIZES
5218
5219 =back
5220
5221 =item THE KEEPERS OF THE RECORDS
5222
5223 =back
5224
5225 =over 4
5226
5227 =item DESCRIPTION
5228
5229 =item Highlights In 5.8.0
5230
5231 =item Incompatible Changes
5232
5233 =over 4
5234
5235 =item Binary Incompatibility
5236
5237 =item 64-bit platforms and malloc
5238
5239 =item AIX Dynaloading
5240
5241 =item Attributes for C<my> variables now handled at run-time.
5242
5243 =item Socket Extension Dynamic in VMS
5244
5245 =item IEEE-format Floating Point Default on OpenVMS Alpha
5246
5247 =item New Unicode Properties
5248
5249 =item REF(...) Instead Of SCALAR(...)
5250
5251 =item pack/unpack D/F recycled
5252
5253 =item Deprecations
5254
5255 =back
5256
5257 =item Core Enhancements
5258
5259 =over 4
5260
5261 =item PerlIO is Now The Default
5262
5263 =item Restricted Hashes
5264
5265 =item Safe Signals
5266
5267 =item Unicode Overhaul
5268
5269 =item Understanding of Numbers
5270
5271 =item Miscellaneous Changes
5272
5273 =back
5274
5275 =item Modules and Pragmata
5276
5277 =over 4
5278
5279 =item New Modules and Pragmata
5280
5281 =item Updated And Improved Modules and Pragmata
5282
5283 =back
5284
5285 =item Utility Changes
5286
5287 =item New Documentation
5288
5289 =item Performance Enhancements
5290
5291 =item Installation and Configuration Improvements
5292
5293 =over 4
5294
5295 =item Generic Improvements
5296
5297 =item New Or Improved Platforms
5298
5299 =back
5300
5301 =item Selected Bug Fixes
5302
5303 =over 4
5304
5305 =item Platform Specific Changes and Fixes
5306
5307 =back
5308
5309 =item New or Changed Diagnostics
5310
5311 =item Changed Internals
5312
5313 =item Security Vulnerability Closed
5314
5315 =item New Tests
5316
5317 =item Known Problems
5318
5319 =over 4
5320
5321 =item AIX
5322
5323 =item BeOS
5324
5325 =item ext/threads/t/libc
5326
5327 =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
5328
5329 =item Modifying $_ Inside for(..)
5330
5331 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5332
5333 =item lib/ftmp-security tests warn 'system possibly insecure'
5334
5335 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5336
5337 =item Linux With Sfio Fails op/misc Test 48
5338
5339 =item Mac OS X
5340
5341 =item op/sprintf tests 91, 129, and 130
5342
5343 =item Solaris 2.5
5344
5345 =item Stratus VOS
5346
5347 =item Term::ReadKey not working on Win32
5348
5349 =item Failure of Thread (5.005-style) tests
5350
5351 =item UNICOS
5352
5353 =item UNICOS/mk
5354
5355 =item UTS
5356
5357 =item VMS
5358
5359 =item Win32
5360
5361 =item XML::Parser not working
5362
5363 =item z/OS (OS/390)
5364
5365 =item Localising Tied Arrays and Hashes Is Broken
5366
5367 =item Self-tying of Arrays and Hashes Is Forbidden
5368
5369 =item Building Extensions Can Fail Because Of Largefiles
5370
5371 =item Unicode Support on EBCDIC Still Spotty
5372
5373 =item The Compiler Suite Is Still Very Experimental
5374
5375 =item The Long Double Support Is Still Experimental
5376
5377 =item Seen In Perl 5.7 But Gone Now
5378
5379 =back
5380
5381 =item Reporting Bugs
5382
5383 =item SEE ALSO
5384
5385 =item HISTORY
5386
5387 =back
5388
5389 =head2 perl572delta - what's new for perl v5.7.2
5390
5391 =over 4
5392
5393 =item DESCRIPTION
5394
5395 =item Security Vulnerability Closed
5396
5397 =item Incompatible Changes
5398
5399 =over 4
5400
5401 =item 64-bit platforms and malloc
5402
5403 =item AIX Dynaloading
5404
5405 =item Socket Extension Dynamic in VMS
5406
5407 =item Different Definition of the Unicode Character Classes \p{In...}
5408
5409 =item Deprecations
5410
5411 =back
5412
5413 =item Core Enhancements
5414
5415 =item Modules and Pragmata
5416
5417 =over 4
5418
5419 =item New Modules and Distributions
5420
5421 =item Updated And Improved Modules and Pragmata
5422
5423 =back
5424
5425 =item Utility Changes
5426
5427 =item New Documentation
5428
5429 =item Installation and Configuration Improvements
5430
5431 =over 4
5432
5433 =item New Or Improved Platforms
5434
5435 =item Generic Improvements
5436
5437 =back
5438
5439 =item Selected Bug Fixes
5440
5441 =over 4
5442
5443 =item Platform Specific Changes and Fixes
5444
5445 =back
5446
5447 =item New or Changed Diagnostics
5448
5449 =item Source Code Enhancements
5450
5451 =over 4
5452
5453 =item MAGIC constants
5454
5455 =item Better commented code
5456
5457 =item Regex pre-/post-compilation items matched up
5458
5459 =item gcc -Wall
5460
5461 =back
5462
5463 =item New Tests
5464
5465 =item Known Problems
5466
5467 =over 4
5468
5469 =item AIX
5470
5471 =item Amiga Perl Invoking Mystery
5472
5473 =item lib/ftmp-security tests warn 'system possibly insecure'
5474
5475 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5476
5477 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5478
5479 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5480
5481 =item Linux With Sfio Fails op/misc Test 48
5482
5483 =item OS/390
5484
5485 =item op/sprintf tests 129 and 130
5486
5487 =item  Failure of Thread tests
5488
5489 =item UNICOS
5490
5491 =item UTS
5492
5493 =item VMS
5494
5495 =item Win32
5496
5497 =item Localising a Tied Variable Leaks Memory
5498
5499 =item Self-tying of Arrays and Hashes Is Forbidden
5500
5501 =item Variable Attributes are not Currently Usable for Tieing
5502
5503 =item Building Extensions Can Fail Because Of Largefiles
5504
5505 =item The Compiler Suite Is Still Experimental
5506
5507 =item The Long Double Support is Still Experimental
5508
5509 =back
5510
5511 =item Reporting Bugs
5512
5513 =item SEE ALSO
5514
5515 =item HISTORY
5516
5517 =back
5518
5519 =head2 perl571delta - what's new for perl v5.7.1
5520
5521 =over 4
5522
5523 =item DESCRIPTION
5524
5525 =item Security Vulnerability Closed
5526
5527 =item Incompatible Changes
5528
5529 =item Core Enhancements
5530
5531 =over 4
5532
5533 =item AUTOLOAD Is Now Lvaluable
5534
5535 =item PerlIO is Now The Default
5536
5537 =item Signals Are Now Safe
5538
5539 =back
5540
5541 =item Modules and Pragmata
5542
5543 =over 4
5544
5545 =item New Modules
5546
5547 =item Updated And Improved Modules and Pragmata
5548
5549 =back
5550
5551 =item Performance Enhancements
5552
5553 =item Utility Changes
5554
5555 =item New Documentation
5556
5557 =over 4
5558
5559 =item perlclib
5560
5561 =item perliol
5562
5563 =item README.aix
5564
5565 =item README.bs2000
5566
5567 =item README.macos
5568
5569 =item README.mpeix
5570
5571 =item README.solaris
5572
5573 =item README.vos
5574
5575 =item Porting/repository.pod
5576
5577 =back
5578
5579 =item Installation and Configuration Improvements
5580
5581 =over 4
5582
5583 =item New Or Improved Platforms
5584
5585 =item Generic Improvements
5586
5587 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5588 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5589 d_strtoq, d_u32align, d_ualarm, d_usleep
5590
5591 =back
5592
5593 =item Selected Bug Fixes
5594
5595 =over 4
5596
5597 =item Platform Specific Changes and Fixes
5598
5599 =back
5600
5601 =item New or Changed Diagnostics
5602
5603 =item Changed Internals
5604
5605 =item New Tests
5606
5607 =item Known Problems
5608
5609 =over 4
5610
5611 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5612
5613 =item lib/ftmp-security tests warn 'system possibly insecure'
5614
5615 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5616
5617 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5618
5619 =item lib/b test 19
5620
5621 =item Linux With Sfio Fails op/misc Test 48
5622
5623 =item sigaction test 13 in VMS
5624
5625 =item sprintf tests 129 and 130
5626
5627 =item  Failure of Thread tests
5628
5629 =item Localising a Tied Variable Leaks Memory
5630
5631 =item Self-tying of Arrays and Hashes Is Forbidden
5632
5633 =item Building Extensions Can Fail Because Of Largefiles
5634
5635 =item The Compiler Suite Is Still Experimental
5636
5637 =back
5638
5639 =item Reporting Bugs
5640
5641 =item SEE ALSO
5642
5643 =item HISTORY
5644
5645 =back
5646
5647 =head2 perl570delta - what's new for perl v5.7.0
5648
5649 =over 4
5650
5651 =item DESCRIPTION
5652
5653 =item Security Vulnerability Closed
5654
5655 =item Incompatible Changes
5656
5657 =item Core Enhancements
5658
5659 =item Modules and Pragmata
5660
5661 =over 4
5662
5663 =item New Modules
5664
5665 =item Updated And Improved Modules and Pragmata
5666
5667 =back
5668
5669 =item Utility Changes
5670
5671 =item New Documentation
5672
5673 =item Performance Enhancements
5674
5675 =item Installation and Configuration Improvements
5676
5677 =over 4
5678
5679 =item Generic Improvements
5680
5681 =back
5682
5683 =item Selected Bug Fixes
5684
5685 =over 4
5686
5687 =item Platform Specific Changes and Fixes
5688
5689 =back
5690
5691 =item New or Changed Diagnostics
5692
5693 =item Changed Internals
5694
5695 =item Known Problems
5696
5697 =over 4
5698
5699 =item Unicode Support Still Far From Perfect
5700
5701 =item EBCDIC Still A Lost Platform
5702
5703 =item Building Extensions Can Fail Because Of Largefiles
5704
5705 =item ftmp-security tests warn 'system possibly insecure'
5706
5707 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5708
5709 =item Long Doubles Still Don't Work In Solaris
5710
5711 =item Linux With Sfio Fails op/misc Test 48
5712
5713 =item Storable tests fail in some platforms
5714
5715 =item Threads Are Still Experimental
5716
5717 =item The Compiler Suite Is Still Experimental
5718
5719 =back
5720
5721 =item Reporting Bugs
5722
5723 =item SEE ALSO
5724
5725 =item HISTORY
5726
5727 =back
5728
5729 =head2 perl561delta - what's new for perl v5.6.x
5730
5731 =over 4
5732
5733 =item DESCRIPTION
5734
5735 =item Summary of changes between 5.6.0 and 5.6.1
5736
5737 =over 4
5738
5739 =item Security Issues
5740
5741 =item Core bug fixes
5742
5743 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5744 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5745 references to special variables, Lexical warnings, Spurious warnings and
5746 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5747 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5748 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5749 Module;>, Tests
5750
5751 =item Core features
5752
5753 =item Configuration issues
5754
5755 =item Documentation
5756
5757 =item Bundled modules
5758
5759 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5760 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5761 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5762 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5763
5764 =item Platform-specific improvements
5765
5766 NCR MP-RAS, NonStop-UX
5767
5768 =back
5769
5770 =item Core Enhancements
5771
5772 =over 4
5773
5774 =item Interpreter cloning, threads, and concurrency
5775
5776 =item Lexically scoped warning categories
5777
5778 =item Unicode and UTF-8 support
5779
5780 =item Support for interpolating named characters
5781
5782 =item "our" declarations
5783
5784 =item Support for strings represented as a vector of ordinals
5785
5786 =item Improved Perl version numbering system
5787
5788 =item New syntax for declaring subroutine attributes
5789
5790 =item File and directory handles can be autovivified
5791
5792 =item open() with more than two arguments
5793
5794 =item 64-bit support
5795
5796 =item Large file support
5797
5798 =item Long doubles
5799
5800 =item "more bits"
5801
5802 =item Enhanced support for sort() subroutines
5803
5804 =item C<sort $coderef @foo> allowed
5805
5806 =item File globbing implemented internally
5807
5808 =item Support for CHECK blocks
5809
5810 =item POSIX character class syntax [: :] supported
5811
5812 =item Better pseudo-random number generator
5813
5814 =item Improved C<qw//> operator
5815
5816 =item Better worst-case behavior of hashes
5817
5818 =item pack() format 'Z' supported
5819
5820 =item pack() format modifier '!' supported
5821
5822 =item pack() and unpack() support counted strings
5823
5824 =item Comments in pack() templates
5825
5826 =item Weak references
5827
5828 =item Binary numbers supported
5829
5830 =item Lvalue subroutines
5831
5832 =item Some arrows may be omitted in calls through references
5833
5834 =item Boolean assignment operators are legal lvalues
5835
5836 =item exists() is supported on subroutine names
5837
5838 =item exists() and delete() are supported on array elements
5839
5840 =item Pseudo-hashes work better
5841
5842 =item Automatic flushing of output buffers
5843
5844 =item Better diagnostics on meaningless filehandle operations
5845
5846 =item Where possible, buffered data discarded from duped input filehandle
5847
5848 =item eof() has the same old magic as <>
5849
5850 =item binmode() can be used to set :crlf and :raw modes
5851
5852 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5853
5854 =item system(), backticks and pipe open now reflect exec() failure
5855
5856 =item Improved diagnostics
5857
5858 =item Diagnostics follow STDERR
5859
5860 =item More consistent close-on-exec behavior
5861
5862 =item syswrite() ease-of-use
5863
5864 =item Better syntax checks on parenthesized unary operators
5865
5866 =item Bit operators support full native integer width
5867
5868 =item Improved security features
5869
5870 =item More functional bareword prototype (*)
5871
5872 =item C<require> and C<do> may be overridden
5873
5874 =item $^X variables may now have names longer than one character
5875
5876 =item New variable $^C reflects C<-c> switch
5877
5878 =item New variable $^V contains Perl version as a string
5879
5880 =item Optional Y2K warnings
5881
5882 =item Arrays now always interpolate into double-quoted strings
5883
5884 =back
5885
5886 =item Modules and Pragmata
5887
5888 =over 4
5889
5890 =item Modules
5891
5892 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5893 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5894 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5895 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5896 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5897 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5898 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5899 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5900
5901 =item Pragmata
5902
5903 =back
5904
5905 =item Utility Changes
5906
5907 =over 4
5908
5909 =item dprofpp
5910
5911 =item find2perl
5912
5913 =item h2xs
5914
5915 =item perlcc
5916
5917 =item perldoc
5918
5919 =item The Perl Debugger
5920
5921 =back
5922
5923 =item Improved Documentation
5924
5925 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5926 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5927 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5928 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5929
5930 =item Performance enhancements
5931
5932 =over 4
5933
5934 =item Simple sort() using { $a <=> $b } and the like are optimized
5935
5936 =item Optimized assignments to lexical variables
5937
5938 =item Faster subroutine calls
5939
5940 =item delete(), each(), values() and hash iteration are faster
5941
5942 =back
5943
5944 =item Installation and Configuration Improvements
5945
5946 =over 4
5947
5948 =item -Dusethreads means something different
5949
5950 =item New Configure flags
5951
5952 =item Threadedness and 64-bitness now more daring
5953
5954 =item Long Doubles
5955
5956 =item -Dusemorebits
5957
5958 =item -Duselargefiles
5959
5960 =item installusrbinperl
5961
5962 =item SOCKS support
5963
5964 =item C<-A> flag
5965
5966 =item Enhanced Installation Directories
5967
5968 =item gcc automatically tried if 'cc' does not seem to be working
5969
5970 =back
5971
5972 =item Platform specific changes
5973
5974 =over 4
5975
5976 =item Supported platforms
5977
5978 =item DOS
5979
5980 =item OS390 (OpenEdition MVS)
5981
5982 =item VMS
5983
5984 =item Win32
5985
5986 =back
5987
5988 =item Significant bug fixes
5989
5990 =over 4
5991
5992 =item <HANDLE> on empty files
5993
5994 =item C<eval '...'> improvements
5995
5996 =item All compilation errors are true errors
5997
5998 =item Implicitly closed filehandles are safer
5999
6000 =item Behavior of list slices is more consistent
6001
6002 =item C<(\$)> prototype and C<$foo{a}>
6003
6004 =item C<goto &sub> and AUTOLOAD
6005
6006 =item C<-bareword> allowed under C<use integer>
6007
6008 =item Failures in DESTROY()
6009
6010 =item Locale bugs fixed
6011
6012 =item Memory leaks
6013
6014 =item Spurious subroutine stubs after failed subroutine calls
6015
6016 =item Taint failures under C<-U>
6017
6018 =item END blocks and the C<-c> switch
6019
6020 =item Potential to leak DATA filehandles
6021
6022 =back
6023
6024 =item New or Changed Diagnostics
6025
6026 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6027 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6028 / cannot take a count, / must be followed by a, A or Z, / must be followed
6029 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6030 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6031 passed through, /%s/ should probably be written as "%s", %s() called too
6032 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6033 argument is not a HASH or ARRAY element or slice, %s argument is not a
6034 subroutine name, %s package attribute may clash with future reserved word:
6035 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6036 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6037 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6038 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6039 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6040 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6041 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6042 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6043 weaken a nonreference, Character class [:%s:] unknown, Character class
6044 syntax [%s] belongs inside character classes, Constant is not %s reference,
6045 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6046 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6047 "local" instead of "our"?), Document contains no data, entering effective
6048 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6049 output, flock() on closed filehandle %s, Global symbol "%s" requires
6050 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6051 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6052 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6053 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6054 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6055 separator character %s in attribute list, Invalid separator character %s in
6056 subroutine attribute list, leaving effective %s failed, Lvalue subs
6057 returning %s not implemented yet, Method %s not permitted, Missing
6058 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6059 No %s specified for -%c, No package name allowed for variable %s in "our",
6060 No space allowed after -%c, no UTC offset information; assuming local time
6061 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6062 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6063 around "%s" list, Possible unintended interpolation of %s in string,
6064 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6065 instead, Premature end of script headers, Repeat count in pack overflows,
6066 Repeat count in unpack overflows, realloc() of freed memory ignored,
6067 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6068 zero-length expression, switching effective %s is not implemented, This
6069 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6070 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6071 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6072 escape \\%c passed through, Unterminated attribute parameter in attribute
6073 list, Unterminated attribute list, Unterminated attribute parameter in
6074 subroutine attribute list, Unterminated subroutine attribute list, Value of
6075 CLI symbol "%s" too long, Version number must be a constant number
6076
6077 =item New tests
6078
6079 =item Incompatible Changes
6080
6081 =over 4
6082
6083 =item Perl Source Incompatibilities
6084
6085 CHECK is a new keyword, Treatment of list slices of undef has changed,
6086 Format of $English::PERL_VERSION is different, Literals of the form
6087 C<1.2.3> parse differently, Possibly changed pseudo-random number
6088 generator, Hashing function for hash keys has changed, C<undef> fails on
6089 read only values, Close-on-exec bit may be set on pipe and socket handles,
6090 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6091 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6092 Text of some diagnostic output has changed, C<%@> has been removed,
6093 Parenthesized not() behaves like a list operator, Semantics of bareword
6094 prototype C<(*)> have changed, Semantics of bit operators may have changed
6095 on 64-bit platforms, More builtins taint their results
6096
6097 =item C Source Incompatibilities
6098
6099 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6100
6101 =item Compatible C Source API Changes
6102
6103 C<PATCHLEVEL> is now C<PERL_VERSION>
6104
6105 =item Binary Incompatibilities
6106
6107 =back
6108
6109 =item Known Problems
6110
6111 =over 4
6112
6113 =item Localizing a tied hash element may leak memory
6114
6115 =item Known test failures
6116
6117 , ,
6118
6119 =item EBCDIC platforms not fully supported
6120
6121 =item UNICOS/mk CC failures during Configure run
6122
6123 =item Arrow operator and arrays
6124
6125 =item Experimental features
6126
6127 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6128 pseudo-hash data type, The Compiler suite, Internal implementation of file
6129 globbing, The DB module, The regular expression code constructs:
6130
6131 =back
6132
6133 =item Obsolete Diagnostics
6134
6135 Character class syntax [: :] is reserved for future extensions, Ill-formed
6136 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6137 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6138 to mean "${$}<digit>" is deprecated
6139
6140 =item Reporting Bugs
6141
6142 =item SEE ALSO
6143
6144 =item HISTORY
6145
6146 =back
6147
6148 =head2 perl56delta - what's new for perl v5.6.0
6149
6150 =over 4
6151
6152 =item DESCRIPTION
6153
6154 =item Core Enhancements
6155
6156 =over 4
6157
6158 =item Interpreter cloning, threads, and concurrency
6159
6160 =item Lexically scoped warning categories
6161
6162 =item Unicode and UTF-8 support
6163
6164 =item Support for interpolating named characters
6165
6166 =item "our" declarations
6167
6168 =item Support for strings represented as a vector of ordinals
6169
6170 =item Improved Perl version numbering system
6171
6172 =item New syntax for declaring subroutine attributes
6173
6174 =item File and directory handles can be autovivified
6175
6176 =item open() with more than two arguments
6177
6178 =item 64-bit support
6179
6180 =item Large file support
6181
6182 =item Long doubles
6183
6184 =item "more bits"
6185
6186 =item Enhanced support for sort() subroutines
6187
6188 =item C<sort $coderef @foo> allowed
6189
6190 =item File globbing implemented internally
6191
6192 =item Support for CHECK blocks
6193
6194 =item POSIX character class syntax [: :] supported
6195
6196 =item Better pseudo-random number generator
6197
6198 =item Improved C<qw//> operator
6199
6200 =item Better worst-case behavior of hashes
6201
6202 =item pack() format 'Z' supported
6203
6204 =item pack() format modifier '!' supported
6205
6206 =item pack() and unpack() support counted strings
6207
6208 =item Comments in pack() templates
6209
6210 =item Weak references
6211
6212 =item Binary numbers supported
6213
6214 =item Lvalue subroutines
6215
6216 =item Some arrows may be omitted in calls through references
6217
6218 =item Boolean assignment operators are legal lvalues
6219
6220 =item exists() is supported on subroutine names
6221
6222 =item exists() and delete() are supported on array elements
6223
6224 =item Pseudo-hashes work better
6225
6226 =item Automatic flushing of output buffers
6227
6228 =item Better diagnostics on meaningless filehandle operations
6229
6230 =item Where possible, buffered data discarded from duped input filehandle
6231
6232 =item eof() has the same old magic as <>
6233
6234 =item binmode() can be used to set :crlf and :raw modes
6235
6236 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6237
6238 =item system(), backticks and pipe open now reflect exec() failure
6239
6240 =item Improved diagnostics
6241
6242 =item Diagnostics follow STDERR
6243
6244 =item More consistent close-on-exec behavior
6245
6246 =item syswrite() ease-of-use
6247
6248 =item Better syntax checks on parenthesized unary operators
6249
6250 =item Bit operators support full native integer width
6251
6252 =item Improved security features
6253
6254 =item More functional bareword prototype (*)
6255
6256 =item C<require> and C<do> may be overridden
6257
6258 =item $^X variables may now have names longer than one character
6259
6260 =item New variable $^C reflects C<-c> switch
6261
6262 =item New variable $^V contains Perl version as a string
6263
6264 =item Optional Y2K warnings
6265
6266 =item Arrays now always interpolate into double-quoted strings
6267
6268 =back
6269
6270 =item Modules and Pragmata
6271
6272 =over 4
6273
6274 =item Modules
6275
6276 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6277 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6278 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6279 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6280 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6281 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6282 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6283 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6284
6285 =item Pragmata
6286
6287 =back
6288
6289 =item Utility Changes
6290
6291 =over 4
6292
6293 =item dprofpp
6294
6295 =item find2perl
6296
6297 =item h2xs
6298
6299 =item perlcc
6300
6301 =item perldoc
6302
6303 =item The Perl Debugger
6304
6305 =back
6306
6307 =item Improved Documentation
6308
6309 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6310 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6311 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6312 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6313
6314 =item Performance enhancements
6315
6316 =over 4
6317
6318 =item Simple sort() using { $a <=> $b } and the like are optimized
6319
6320 =item Optimized assignments to lexical variables
6321
6322 =item Faster subroutine calls
6323
6324 =item delete(), each(), values() and hash iteration are faster
6325
6326 =back
6327
6328 =item Installation and Configuration Improvements
6329
6330 =over 4
6331
6332 =item -Dusethreads means something different
6333
6334 =item New Configure flags
6335
6336 =item Threadedness and 64-bitness now more daring
6337
6338 =item Long Doubles
6339
6340 =item -Dusemorebits
6341
6342 =item -Duselargefiles
6343
6344 =item installusrbinperl
6345
6346 =item SOCKS support
6347
6348 =item C<-A> flag
6349
6350 =item Enhanced Installation Directories
6351
6352 =back
6353
6354 =item Platform specific changes
6355
6356 =over 4
6357
6358 =item Supported platforms
6359
6360 =item DOS
6361
6362 =item OS390 (OpenEdition MVS)
6363
6364 =item VMS
6365
6366 =item Win32
6367
6368 =back
6369
6370 =item Significant bug fixes
6371
6372 =over 4
6373
6374 =item <HANDLE> on empty files
6375
6376 =item C<eval '...'> improvements
6377
6378 =item All compilation errors are true errors
6379
6380 =item Implicitly closed filehandles are safer
6381
6382 =item Behavior of list slices is more consistent
6383
6384 =item C<(\$)> prototype and C<$foo{a}>
6385
6386 =item C<goto &sub> and AUTOLOAD
6387
6388 =item C<-bareword> allowed under C<use integer>
6389
6390 =item Failures in DESTROY()
6391
6392 =item Locale bugs fixed
6393
6394 =item Memory leaks
6395
6396 =item Spurious subroutine stubs after failed subroutine calls
6397
6398 =item Taint failures under C<-U>
6399
6400 =item END blocks and the C<-c> switch
6401
6402 =item Potential to leak DATA filehandles
6403
6404 =back
6405
6406 =item New or Changed Diagnostics
6407
6408 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6409 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6410 / cannot take a count, / must be followed by a, A or Z, / must be followed
6411 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6412 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6413 passed through, /%s/ should probably be written as "%s", %s() called too
6414 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6415 argument is not a HASH or ARRAY element or slice, %s argument is not a
6416 subroutine name, %s package attribute may clash with future reserved word:
6417 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6418 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6419 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6420 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6421 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6422 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6423 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6424 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6425 weaken a nonreference, Character class [:%s:] unknown, Character class
6426 syntax [%s] belongs inside character classes, Constant is not %s reference,
6427 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6428 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6429 "local" instead of "our"?), Document contains no data, entering effective
6430 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6431 output, flock() on closed filehandle %s, Global symbol "%s" requires
6432 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6433 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6434 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6435 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6436 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6437 separator character %s in attribute list, Invalid separator character %s in
6438 subroutine attribute list, leaving effective %s failed, Lvalue subs
6439 returning %s not implemented yet, Method %s not permitted, Missing
6440 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6441 No %s specified for -%c, No package name allowed for variable %s in "our",
6442 No space allowed after -%c, no UTC offset information; assuming local time
6443 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6444 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6445 around "%s" list, Possible unintended interpolation of %s in string,
6446 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6447 instead, Premature end of script headers, Repeat count in pack overflows,
6448 Repeat count in unpack overflows, realloc() of freed memory ignored,
6449 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6450 zero-length expression, switching effective %s is not implemented, This
6451 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6452 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6453 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6454 escape \\%c passed through, Unterminated attribute parameter in attribute
6455 list, Unterminated attribute list, Unterminated attribute parameter in
6456 subroutine attribute list, Unterminated subroutine attribute list, Value of
6457 CLI symbol "%s" too long, Version number must be a constant number
6458
6459 =item New tests
6460
6461 =item Incompatible Changes
6462
6463 =over 4
6464
6465 =item Perl Source Incompatibilities
6466
6467 CHECK is a new keyword, Treatment of list slices of undef has changed,
6468 Format of $English::PERL_VERSION is different, Literals of the form
6469 C<1.2.3> parse differently, Possibly changed pseudo-random number
6470 generator, Hashing function for hash keys has changed, C<undef> fails on
6471 read only values, Close-on-exec bit may be set on pipe and socket handles,
6472 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6473 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6474 Text of some diagnostic output has changed, C<%@> has been removed,
6475 Parenthesized not() behaves like a list operator, Semantics of bareword
6476 prototype C<(*)> have changed, Semantics of bit operators may have changed
6477 on 64-bit platforms, More builtins taint their results
6478
6479 =item C Source Incompatibilities
6480
6481 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6482
6483 =item Compatible C Source API Changes
6484
6485 C<PATCHLEVEL> is now C<PERL_VERSION>
6486
6487 =item Binary Incompatibilities
6488
6489 =back
6490
6491 =item Known Problems
6492
6493 =over 4
6494
6495 =item Thread test failures
6496
6497 =item EBCDIC platforms not supported
6498
6499 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6500
6501 =item NEXTSTEP 3.3 POSIX test failure
6502
6503 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6504 gcc
6505
6506 =item UNICOS/mk CC failures during Configure run
6507
6508 =item Arrow operator and arrays
6509
6510 =item Experimental features
6511
6512 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6513 pseudo-hash data type, The Compiler suite, Internal implementation of file
6514 globbing, The DB module, The regular expression code constructs:
6515
6516 =back
6517
6518 =item Obsolete Diagnostics
6519
6520 Character class syntax [: :] is reserved for future extensions, Ill-formed
6521 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6522 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6523 to mean "${$}<digit>" is deprecated
6524
6525 =item Reporting Bugs
6526
6527 =item SEE ALSO
6528
6529 =item HISTORY
6530
6531 =back
6532
6533 =head2 perl5005delta - what's new for perl5.005
6534
6535 =over 4
6536
6537 =item DESCRIPTION
6538
6539 =item About the new versioning system
6540
6541 =item Incompatible Changes
6542
6543 =over 4
6544
6545 =item WARNING:  This version is not binary compatible with Perl 5.004.
6546
6547 =item Default installation structure has changed
6548
6549 =item Perl Source Compatibility
6550
6551 =item C Source Compatibility
6552
6553 =item Binary Compatibility
6554
6555 =item Security fixes may affect compatibility
6556
6557 =item Relaxed new mandatory warnings introduced in 5.004
6558
6559 =item Licensing
6560
6561 =back
6562
6563 =item Core Changes
6564
6565 =over 4
6566
6567 =item Threads
6568
6569 =item Compiler
6570
6571 =item Regular Expressions
6572
6573 Many new and improved optimizations, Many bug fixes, New regular expression
6574 constructs, New operator for precompiled regular expressions, Other
6575 improvements, Incompatible changes
6576
6577 =item   Improved malloc()
6578
6579 =item Quicksort is internally implemented
6580
6581 =item Reliable signals
6582
6583 =item Reliable stack pointers
6584
6585 =item More generous treatment of carriage returns
6586
6587 =item Memory leaks
6588
6589 =item Better support for multiple interpreters
6590
6591 =item Behavior of local() on array and hash elements is now well-defined
6592
6593 =item C<%!> is transparently tied to the L<Errno> module
6594
6595 =item Pseudo-hashes are supported
6596
6597 =item C<EXPR foreach EXPR> is supported
6598
6599 =item Keywords can be globally overridden
6600
6601 =item C<$^E> is meaningful on Win32
6602
6603 =item C<foreach (1..1000000)> optimized
6604
6605 =item C<Foo::> can be used as implicitly quoted package name
6606
6607 =item C<exists $Foo::{Bar::}> tests existence of a package
6608
6609 =item Better locale support
6610
6611 =item Experimental support for 64-bit platforms
6612
6613 =item prototype() returns useful results on builtins
6614
6615 =item Extended support for exception handling
6616
6617 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6618
6619 =item All C<printf> format conversions are handled internally
6620
6621 =item New C<INIT> keyword
6622
6623 =item New C<lock> keyword
6624
6625 =item New C<qr//> operator
6626
6627 =item C<our> is now a reserved word
6628
6629 =item Tied arrays are now fully supported
6630
6631 =item Tied handles support is better
6632
6633 =item 4th argument to substr
6634
6635 =item Negative LENGTH argument to splice
6636
6637 =item Magic lvalues are now more magical
6638
6639 =item <> now reads in records
6640
6641 =back
6642
6643 =item Supported Platforms
6644
6645 =over 4
6646
6647 =item New Platforms
6648
6649 =item Changes in existing support
6650
6651 =back
6652
6653 =item Modules and Pragmata
6654
6655 =over 4
6656
6657 =item New Modules
6658
6659 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6660 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6661 Thread, attrs, fields, re
6662
6663 =item Changes in existing modules
6664
6665 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6666 MakeMaker, CPAN, Cwd
6667
6668 =back
6669
6670 =item Utility Changes
6671
6672 =item Documentation Changes
6673
6674 =item New Diagnostics
6675
6676 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6677 while coercing array into hash, Bareword "%s" refers to nonexistent
6678 package, Can't call method "%s" on an undefined value, Can't check
6679 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6680 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6681 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6682 for "%s", Character class syntax [. .] is reserved for future extensions,
6683 Character class syntax [: :] is reserved for future extensions, Character
6684 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6685 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6686 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6687 package main), Illegal hex digit ignored, No such array field, No such
6688 field "%s" in variable %s of type %s, Out of memory during ridiculously
6689 large request, Range iterator outside integer range, Recursive inheritance
6690 detected while looking for method '%s' %s, Reference found where even-sized
6691 list expected, Undefined value assigned to typeglob, Use of reserved word
6692 "%s" is deprecated, perl: warning: Setting locale failed
6693
6694 =item Obsolete Diagnostics
6695
6696 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6697 temporary file, regexp too big
6698
6699 =item Configuration Changes
6700
6701 =item BUGS
6702
6703 =item SEE ALSO
6704
6705 =item HISTORY
6706
6707 =back
6708
6709 =head2 perl5004delta - what's new for perl5.004
6710
6711 =over 4
6712
6713 =item DESCRIPTION
6714
6715 =item Supported Environments
6716
6717 =item Core Changes
6718
6719 =over 4
6720
6721 =item List assignment to %ENV works
6722
6723 =item Change to "Can't locate Foo.pm in @INC" error
6724
6725 =item Compilation option: Binary compatibility with 5.003
6726
6727 =item $PERL5OPT environment variable
6728
6729 =item Limitations on B<-M>, B<-m>, and B<-T> options
6730
6731 =item More precise warnings
6732
6733 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6734
6735 =item Previously deprecated %OVERLOAD is no longer usable
6736
6737 =item Subroutine arguments created only when they're modified
6738
6739 =item Group vector changeable with C<$)>
6740
6741 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6742
6743 =item Fixed localization of $<digit>, $&, etc.
6744
6745 =item No resetting of $. on implicit close
6746
6747 =item C<wantarray> may return undef
6748
6749 =item C<eval EXPR> determines value of EXPR in scalar context
6750
6751 =item Changes to tainting checks
6752
6753 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6754 spawning if tainted $TERM doesn't look like a terminal name
6755
6756 =item New Opcode module and revised Safe module
6757
6758 =item Embedding improvements
6759
6760 =item Internal change: FileHandle class based on IO::* classes
6761
6762 =item Internal change: PerlIO abstraction interface
6763
6764 =item New and changed syntax
6765
6766 $coderef->(PARAMS)
6767
6768 =item New and changed builtin constants
6769
6770 __PACKAGE__
6771
6772 =item New and changed builtin variables
6773
6774 $^E, $^H, $^M
6775
6776 =item New and changed builtin functions
6777
6778 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6779 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6780 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6781 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6782 nested C<sub{}> closures work now, formats work right on changing lexicals
6783
6784 =item New builtin methods
6785
6786 isa(CLASS), can(METHOD), VERSION( [NEED] )
6787
6788 =item TIEHANDLE now supported
6789
6790 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6791 LIST, READLINE this, GETC this, DESTROY this
6792
6793 =item Malloc enhancements
6794
6795 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6796
6797 =item Miscellaneous efficiency enhancements
6798
6799 =back
6800
6801 =item Support for More Operating Systems
6802
6803 =over 4
6804
6805 =item Win32
6806
6807 =item Plan 9
6808
6809 =item QNX
6810
6811 =item AmigaOS
6812
6813 =back
6814
6815 =item Pragmata
6816
6817 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6818 constant NAME => VALUE, use locale, use ops, use vmsish
6819
6820 =item Modules
6821
6822 =over 4
6823
6824 =item Required Updates
6825
6826 =item Installation directories
6827
6828 =item Module information summary
6829
6830 =item Fcntl
6831
6832 =item IO
6833
6834 =item Math::Complex
6835
6836 =item Math::Trig
6837
6838 =item DB_File
6839
6840 =item Net::Ping
6841
6842 =item Object-oriented overrides for builtin operators
6843
6844 =back
6845
6846 =item Utility Changes
6847
6848 =over 4
6849
6850 =item pod2html
6851
6852 Sends converted HTML to standard output
6853
6854 =item xsubpp
6855
6856 C<void> XSUBs now default to returning nothing
6857
6858 =back
6859
6860 =item C Language API Changes
6861
6862 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6863 manipulating hashes
6864
6865 =item Documentation Changes
6866
6867 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6868 L<perlmodlib>, L<perldebug>, L<perlsec>
6869
6870 =item New Diagnostics
6871
6872 "my" variable %s masks earlier declaration in same scope, %s argument is
6873 not a HASH element or slice, Allocation too large: %lx, Allocation too
6874 large, Applying %s to %s will act on scalar(%s), Attempt to free
6875 nonexistent shared string, Attempt to use reference as lvalue in substr,
6876 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6877 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6878 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6879 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6880 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6881 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6882 %s, Integer overflow in hex number, Integer overflow in octal number,
6883 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6884 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6885 possible typo, Null picture in formline, Offset outside string, Out of
6886 memory!, Out of memory during request for %s, panic: frexp, Possible
6887 attempt to put comments in qw() list, Possible attempt to separate words
6888 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6889 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6890 option, untie attempted while %d inner references still exist, Unrecognized
6891 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6892 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6893 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6894 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6895 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6896 long, Process terminated by SIG%s
6897
6898 =item BUGS
6899
6900 =item SEE ALSO
6901
6902 =item HISTORY
6903
6904 =back
6905
6906 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6907
6908 =over 4
6909
6910 =item DESCRIPTION
6911
6912 =over 4
6913
6914 =item Compiling Perl 5 on AIX
6915
6916 =item OS level
6917
6918 =item Building Dynamic Extensions on AIX
6919
6920 =item The IBM ANSI C Compiler
6921
6922 =item Using GNU's gcc for building perl
6923
6924 =item Using Large Files with Perl
6925
6926 =item Threaded Perl
6927
6928 =item 64-bit Perl
6929
6930 =item AIX 4.2 and extensions using C++ with statics
6931
6932 =back
6933
6934 =item AUTHOR
6935
6936 =item DATE
6937
6938 =back
6939
6940 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6941
6942 =over 4
6943
6944 =item DESCRIPTION
6945
6946 =item AUTHOR
6947
6948 =back
6949
6950 =head2 perlamiga - Perl under Amiga OS
6951
6952 =over 4
6953
6954 =item SYNOPSIS
6955
6956 =back
6957
6958 =over 4
6959
6960 =item DESCRIPTION
6961
6962 =over 4
6963
6964 =item Prerequisites for Compiling Perl on AmigaOS
6965
6966 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
6967
6968 =item Starting Perl programs under AmigaOS
6969
6970 =item Shortcomings of Perl under AmigaOS
6971
6972 =back
6973
6974 =item INSTALLATION
6975
6976 =item Accessing documentation
6977
6978 =over 4
6979
6980 =item Manpages for Perl on AmigaOS
6981
6982 =item Perl HTML Documentation on AmigaOS
6983
6984 =item Perl GNU Info Files on AmigaOS
6985
6986 =item Perl LaTeX Documentation on AmigaOS
6987
6988 =back
6989
6990 =item BUILDING PERL ON AMIGAOS
6991
6992 =over 4
6993
6994 =item Build Prerequisites for Perl on AmigaOS
6995
6996 =item Getting the Perl Source for AmigaOS
6997
6998 =item Making Perl on AmigaOS
6999
7000 =item Testing Perl on AmigaOS
7001
7002 =item Installing the built Perl on AmigaOS
7003
7004 =back
7005
7006 =item AUTHORS
7007
7008 =item SEE ALSO
7009
7010 =back
7011
7012 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7013
7014 =over 4
7015
7016 =item DESCRIPTION
7017
7018 =over 4
7019
7020 =item General Issues with Perl on BeOS
7021
7022 =item BeOS Release-specific Notes
7023
7024 R4 x86, R4 PPC
7025
7026 =item Contact Information
7027
7028 =item Update 2002-05-25
7029
7030 =back
7031
7032 =back
7033
7034 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7035
7036 =over 4
7037
7038 =item SYNOPSIS
7039
7040 =item DESCRIPTION
7041
7042 =over 4
7043
7044 =item gzip on BS2000
7045
7046 =item bison on BS2000
7047
7048 =item Unpacking Perl Distribution on BS2000
7049
7050 =item Compiling Perl on BS2000
7051
7052 =item Testing Perl on BS2000
7053
7054 =item Installing Perl on BS2000
7055
7056 =item Using Perl in the Posix-Shell of BS2000
7057
7058 =item Using Perl in "native" BS2000
7059
7060 =item Floating point anomalies on BS2000
7061
7062 =back
7063
7064 =item AUTHORS
7065
7066 =item SEE ALSO
7067
7068 =over 4
7069
7070 =item Mailing list
7071
7072 =back
7073
7074 =item HISTORY
7075
7076 =back
7077
7078 =over 4
7079
7080 =item Name
7081
7082 =item Description
7083
7084 =item Build
7085
7086 =over 4
7087
7088 =item Tools & SDK
7089
7090 =item Make
7091
7092 =back
7093
7094 =item Acknowledgements
7095
7096 =item Author
7097
7098 =back
7099
7100 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7101
7102 =over 4
7103
7104 =item SYNOPSIS
7105
7106 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7107
7108 =over 4
7109
7110 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7111
7112 =item Cygwin Configuration
7113
7114 C<PATH>, I<nroff>, Permissions
7115
7116 =back
7117
7118 =item CONFIGURE PERL ON CYGWIN
7119
7120 =over 4
7121
7122 =item Stripping Perl Binaries on Cygwin
7123
7124 =item Optional Libraries for Perl on Cygwin
7125
7126 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7127 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7128
7129 =item Configure-time Options for Perl on Cygwin
7130
7131 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7132 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7133 C<-Dmksymlinks>
7134
7135 =item Suspicious Warnings on Cygwin
7136
7137 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7138
7139 =back
7140
7141 =item MAKE ON CYGWIN
7142
7143 =over 4
7144
7145 =item Warnings on Cygwin
7146
7147 =item ld2 on Cygwin
7148
7149 =back
7150
7151 =item TEST ON CYGWIN
7152
7153 =over 4
7154
7155 =item File Permissions on Cygwin
7156
7157 =item Script Portability on Cygwin
7158
7159 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7160
7161 =back
7162
7163 =item INSTALL PERL ON CYGWIN
7164
7165 =item MANIFEST ON CYGWIN
7166
7167 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7168 Source, Compiled Module Source, Perl Modules/Scripts
7169
7170 =item BUGS ON CYGWIN
7171
7172 =item AUTHORS
7173
7174 =item HISTORY
7175
7176 =back
7177
7178 =head2 perldgux - Perl under DG/UX.
7179
7180 =over 4
7181
7182 =item SYNOPSIS
7183
7184 =back
7185
7186 =over 4
7187
7188 =item DESCRIPTION
7189
7190 =item BUILDING PERL ON DG/UX
7191
7192 =over 4
7193
7194 =item Non-threaded Perl on DG/UX
7195
7196 =item Threaded Perl on DG/UX
7197
7198 =item Testing Perl on DG/UX
7199
7200 =item Installing the built perl on DG/UX
7201
7202 =back
7203
7204 =item AUTHOR
7205
7206 =item SEE ALSO
7207
7208 =back
7209
7210 =head2 perldos - Perl under DOS, W31, W95.
7211
7212 =over 4
7213
7214 =item SYNOPSIS
7215
7216 =item DESCRIPTION
7217
7218 =over 4
7219
7220 =item Prerequisites for Compiling Perl on DOS
7221
7222 DJGPP, Pthreads
7223
7224 =item Shortcomings of Perl under DOS
7225
7226 =item Building Perl on DOS
7227
7228 =item Testing Perl on DOS
7229
7230 =item Installation of Perl on DOS
7231
7232 =back
7233
7234 =item BUILDING AND INSTALLING MODULES ON DOS
7235
7236 =over 4
7237
7238 =item Building Prerequisites for Perl on DOS
7239
7240 =item Unpacking CPAN Modules on DOS
7241
7242 =item Building Non-XS Modules on DOS
7243
7244 =item Building XS Modules on DOS
7245
7246 =back
7247
7248 =item AUTHOR
7249
7250 =item SEE ALSO
7251
7252 =back
7253
7254 =head2 perlepoc, README.epoc - Perl for EPOC
7255
7256 =over 4
7257
7258 =item SYNOPSIS
7259
7260 =item INTRODUCTION
7261
7262 =item INSTALLING PERL ON EPOC
7263
7264 =item STARTING PERL ON EPOC
7265
7266 =over 4
7267
7268 =item Editors on Epoc
7269
7270 =item Features of Perl on Epoc
7271
7272 =item Restrictions of Perl on Epoc
7273
7274 =item Compiling Perl 5 on the EPOC cross compiling environment
7275
7276 =back
7277
7278 =item SUPPORT STATUS OF PERL ON EPOC
7279
7280 =item AUTHOR
7281
7282 =item LAST UPDATE
7283
7284 =back
7285
7286 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7287 (HP-UX) systems
7288
7289 =over 4
7290
7291 =item DESCRIPTION
7292
7293 =over 4
7294
7295 =item Using perl as shipped with HP-UX
7296
7297 =item Compiling Perl 5 on HP-UX
7298
7299 =item PA-RISC
7300
7301 =item PA-RISC 1.0
7302
7303 =item PA-RISC 1.1
7304
7305 =item PA-RISC 2.0
7306
7307 =item Itanium
7308
7309 =item Portability Between PA-RISC Versions
7310
7311 =item Itanium Processor Family and HP-UX
7312
7313 =item Building Dynamic Extensions on HP-UX
7314
7315 =item The HP ANSI C Compiler
7316
7317 =item The GNU C Compiler
7318
7319 =item Using Large Files with Perl on HP-UX
7320
7321 =item Threaded Perl on HP-UX
7322
7323 =item 64-bit Perl on HP-UX
7324
7325 =item GDBM and Threads on HP-UX
7326
7327 =item NFS filesystems and utime(2) on HP-UX
7328
7329 =item perl -P and // and HP-UX
7330
7331 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7332
7333 =back
7334
7335 =item nss_delete core dump from op/pwent or op/grent
7336
7337 =item AUTHOR
7338
7339 =item DATE
7340
7341 =back
7342
7343 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7344
7345 =over 4
7346
7347 =item DESCRIPTION
7348
7349 =over 4
7350
7351 =item Known Problems with Perl on Hurd
7352
7353 =back
7354
7355 =item AUTHOR
7356
7357 =back
7358
7359 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7360 systems
7361
7362 =over 4
7363
7364 =item DESCRIPTION
7365
7366 =over 4
7367
7368 =item Compiling Perl 5 on MachTen
7369
7370 =item Failures during C<make test> on MachTen
7371
7372 op/lexassign.t, pragma/warnings.t
7373
7374 =item Building external modules on MachTen
7375
7376 =back
7377
7378 =item AUTHOR
7379
7380 =item DATE
7381
7382 =back
7383
7384 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7385
7386 =over 4
7387
7388 =item SYNOPSIS
7389
7390 =item DESCRIPTION
7391
7392 =item AUTHOR
7393
7394 =item DATE
7395
7396 =back
7397
7398 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7399
7400 =over 4
7401
7402 =item DESCRIPTION
7403
7404 =item Known problems with Perl on MiNT
7405
7406 =item AUTHOR
7407
7408 =back
7409
7410 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7411
7412 =over 4
7413
7414 =item SYNOPSIS
7415
7416 =item NOTE
7417
7418 =item Binary distribution from HP
7419
7420 =item What's New in Perl for MPE/iX
7421
7422 =item Welcome to Perl/iX
7423
7424 =item System Requirements for Perl/iX
7425
7426 =item How to Obtain Perl/iX
7427
7428 =item Perl/iX Distribution Contents Highlights
7429
7430 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7431 public_html/feedback.cgi, src/perl-5.6.0-mpe
7432
7433 =item How to Compile Perl/iX
7434
7435  4,  6
7436
7437 =item Getting Started with Perl/iX
7438
7439 =item MPE/iX Implementation Considerations
7440
7441 =item Known Perl/iX Bugs Under Investigation
7442
7443 =item Perl/iX To-Do List
7444
7445 =item Perl/iX Change History
7446
7447 =item AUTHOR
7448
7449 =item Name
7450
7451 =item Description
7452
7453 =item Build
7454
7455 =over 4
7456
7457 =item Tools & SDK
7458
7459 =item Setup
7460
7461 SetNWDef.bat, Custom Build Environment, Buildtype.bat, SetNWBld.bat
7462
7463 =item Make
7464
7465 =item Interpreter
7466
7467 =item Extensions
7468
7469 =back
7470
7471 =item Install
7472
7473 =item Build new extensions
7474
7475 =item Acknowledgements
7476
7477 =item Authors
7478
7479 =item Date
7480
7481 =back
7482
7483 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7484
7485 =over 4
7486
7487 =item SYNOPSIS
7488
7489 =back
7490
7491 =over 4
7492
7493 =item DESCRIPTION
7494
7495 =over 4
7496
7497 =item Target
7498
7499 =item Other OSes
7500
7501 =item Prerequisites
7502
7503 EMX, RSX, HPFS, pdksh
7504
7505 =item Starting Perl programs under OS/2 (and DOS and...)
7506
7507 =item Starting OS/2 (and DOS) programs under Perl
7508
7509 =back
7510
7511 =item Frequently asked questions
7512
7513 =over 4
7514
7515 =item "It does not work"
7516
7517 =item I cannot run external programs
7518
7519 =item I cannot embed perl into my program, or use F<perl.dll> from my
7520 program.
7521
7522 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7523 L<ExtUtils::Embed>?
7524
7525 =item C<``> and pipe-C<open> do not work under DOS.
7526
7527 =item Cannot start C<find.exe "pattern" file>
7528
7529 =back
7530
7531 =item INSTALLATION
7532
7533 =over 4
7534
7535 =item Automatic binary installation
7536
7537 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7538
7539 =item Manual binary installation
7540
7541 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7542 (statically linked), Executables for Perl utilities, Main Perl library,
7543 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7544 and utilities, Manpages for Perl modules, Source for Perl documentation,
7545 Perl manual in F<.INF> format, Pdksh
7546
7547 =item B<Warning>
7548
7549 =back
7550
7551 =item Accessing documentation
7552
7553 =over 4
7554
7555 =item OS/2 F<.INF> file
7556
7557 =item Plain text
7558
7559 =item Manpages
7560
7561 =item HTML
7562
7563 =item GNU C<info> files
7564
7565 =item F<PDF> files
7566
7567 =item C<LaTeX> docs
7568
7569 =back
7570
7571 =item BUILD
7572
7573 =over 4
7574
7575 =item The short story
7576
7577 =item Prerequisites
7578
7579 =item Getting perl source
7580
7581 =item Application of the patches
7582
7583 =item Hand-editing
7584
7585 =item Making
7586
7587 =item Testing
7588
7589 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7590 F<op/stat.t>
7591
7592 =item Installing the built perl
7593
7594 =item C<a.out>-style build
7595
7596 =back
7597
7598 =item Build FAQ
7599
7600 =over 4
7601
7602 =item Some C</> became C<\> in pdksh.
7603
7604 =item C<'errno'> - unresolved external
7605
7606 =item Problems with tr or sed
7607
7608 =item Some problem (forget which ;-)
7609
7610 =item Library ... not found
7611
7612 =item Segfault in make
7613
7614 =item op/sprintf test failure
7615
7616 =back
7617
7618 =item Specific (mis)features of OS/2 port
7619
7620 =over 4
7621
7622 =item C<setpriority>, C<getpriority>
7623
7624 =item C<system()>
7625
7626 =item C<extproc> on the first line
7627
7628 =item Additional modules:
7629
7630 =item Prebuilt methods:
7631
7632 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7633  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
7634 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
7635 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
7636 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
7637 C<Cwd::extLibpath_set( path [, type ] )>,
7638 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7639 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7640 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7641 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7642 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7643
7644 =item Prebuilt variables:
7645
7646 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7647
7648 =item Misfeatures
7649
7650 =item Modifications
7651
7652 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7653 C<flock>
7654
7655 =item Identifying DLLs
7656
7657 =item Centralized management of resources
7658
7659 C<HAB>, C<HMQ>
7660
7661 =back
7662
7663 =item Perl flavors
7664
7665 =over 4
7666
7667 =item F<perl.exe>
7668
7669 =item F<perl_.exe>
7670
7671 =item F<perl__.exe>
7672
7673 =item F<perl___.exe>
7674
7675 =item Why strange names?
7676
7677 =item Why dynamic linking?
7678
7679 =item Why chimera build?
7680
7681 =back
7682
7683 =item ENVIRONMENT
7684
7685 =over 4
7686
7687 =item C<PERLLIB_PREFIX>
7688
7689 =item C<PERL_BADLANG>
7690
7691 =item C<PERL_BADFREE>
7692
7693 =item C<PERL_SH_DIR>
7694
7695 =item C<USE_PERL_FLOCK>
7696
7697 =item C<TMP> or C<TEMP>
7698
7699 =back
7700
7701 =item Evolution
7702
7703 =over 4
7704
7705 =item Priorities
7706
7707 =item DLL name mangling: pre 5.6.2
7708
7709 =item DLL name mangling: 5.6.2 and beyond
7710
7711 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7712 C<LIBPATH>
7713
7714 =item DLL forwarder generation
7715
7716 =item Threading
7717
7718 =item Calls to external programs
7719
7720 =item Memory allocation
7721
7722 =item Threads
7723
7724 C<COND_WAIT>, F<os2.c>
7725
7726 =back
7727
7728 =item BUGS
7729
7730 =back
7731
7732 =over 4
7733
7734 =item AUTHOR
7735
7736 =item SEE ALSO
7737
7738 =back
7739
7740 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7741 and z/OS
7742
7743 =over 4
7744
7745 =item SYNOPSIS
7746
7747 =item DESCRIPTION
7748
7749 =over 4
7750
7751 =item Tools
7752
7753 =item Unpacking Perl distribution on OS/390
7754
7755 =item Setup and utilities for Perl on OS/390
7756
7757 =item Configure Perl on OS/390
7758
7759 =item Build, Test, Install Perl on OS/390
7760
7761 =item Build Anomalies with Perl on OS/390
7762
7763 =item Testing Anomalies with Perl on OS/390
7764
7765 =item Installation Anomalies with Perl on OS/390
7766
7767 =item Usage Hints for Perl on OS/390
7768
7769 =item Floating Point Anomalies with Perl on OS/390
7770
7771 =item Modules and Extensions for Perl on OS/390
7772
7773 =back
7774
7775 =item AUTHORS
7776
7777 =item SEE ALSO
7778
7779 =over 4
7780
7781 =item Mailing list for Perl on OS/390
7782
7783 =back
7784
7785 =item HISTORY
7786
7787 =back
7788
7789 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7790
7791 =over 4
7792
7793 =item DESCRIPTION
7794
7795 =over 4
7796
7797 =item Required Software for Compiling Perl on QNX4
7798
7799 /bin/sh, ar, nm, cpp, make
7800
7801 =item Outstanding Issues with Perl on QNX4
7802
7803 =item QNX auxiliary files
7804
7805 qnx/ar, qnx/cpp
7806
7807 =item Outstanding issues with perl under QNX6
7808
7809 =back
7810
7811 =item AUTHOR
7812
7813 =back
7814
7815 =head2 perlplan9 - Plan 9-specific documentation for Perl
7816
7817 =over 4
7818
7819 =item DESCRIPTION
7820
7821 =over 4
7822
7823 =item Invoking Perl
7824
7825 =item What's in Plan 9 Perl
7826
7827 =item What's not in Plan 9 Perl
7828
7829 =item Perl5 Functions not currently supported in Plan 9 Perl
7830
7831 =item Signals in Plan 9 Perl
7832
7833 =back
7834
7835 =item COMPILING AND INSTALLING PERL ON PLAN 9
7836
7837 =over 4
7838
7839 =item Installing Perl Documentation on Plan 9
7840
7841 =back
7842
7843 =item BUGS
7844
7845 =item Revision date
7846
7847 =item AUTHOR
7848
7849 =back
7850
7851 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7852
7853 =over 4
7854
7855 =item DESCRIPTION
7856
7857 =over 4
7858
7859 =item Solaris Version Numbers.
7860
7861 =back
7862
7863 =item RESOURCES
7864
7865 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7866
7867 =item SETTING UP
7868
7869 =over 4
7870
7871 =item File Extraction Problems on Solaris.
7872
7873 =item Compiler and Related Tools on Solaris.
7874
7875 =item Environment for Compiling Perl on Solaris
7876
7877 =back
7878
7879 =item RUN CONFIGURE.
7880
7881 =over 4
7882
7883 =item 64-bit Issues with Perl on Solaris.
7884
7885 =item Threads in Perl on Solaris.
7886
7887 =item Malloc Issues with Perl on Solaris.
7888
7889 =back
7890
7891 =item MAKE PROBLEMS.
7892
7893 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
7894 relocation error:, dlopen: stub interception failed, #error "No
7895 DATAMODEL_NATIVE specified", sh: ar: not found
7896
7897 =item MAKE TEST
7898
7899 =over 4
7900
7901 =item op/stat.t test 4 in Solaris
7902
7903 =item nss_delete core dump from op/pwent or op/grent
7904
7905 =back
7906
7907 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
7908
7909 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
7910
7911 =over 4
7912
7913 =item Limits on Numbers of Open Files on Solaris.
7914
7915 =back
7916
7917 =item SOLARIS-SPECIFIC MODULES.
7918
7919 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
7920
7921 =over 4
7922
7923 =item Proc::ProcessTable on Solaris
7924
7925 =item BSD::Resource on Solaris
7926
7927 =item Net::SSLeay on Solaris
7928
7929 =back
7930
7931 =item AUTHOR
7932
7933 =item LAST MODIFIED
7934
7935 =back
7936
7937 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
7938 Digital UNIX formerly known as DEC OSF/1) systems
7939
7940 =over 4
7941
7942 =item DESCRIPTION
7943
7944 =over 4
7945
7946 =item Compiling Perl 5 on Tru64
7947
7948 =item Using Large Files with Perl on Tru64
7949
7950 =item Threaded Perl on Tru64
7951
7952 =item Long Doubles on Tru64
7953
7954 =item 64-bit Perl on Tru64
7955
7956 =item Warnings about floating-point overflow when compiling Perl on Tru64
7957
7958 =back
7959
7960 =item Testing Perl on Tru64
7961
7962 =item ext/ODBM_File/odbm Test Failing With Static Builds
7963
7964 =item Perl Fails Because Of Unresolved Symbol sockatmark
7965
7966 =item AUTHOR
7967
7968 =back
7969
7970 =head2 perluts - Perl under UTS
7971
7972 =over 4
7973
7974 =item SYNOPSIS
7975
7976 =item DESCRIPTION
7977
7978 =item BUILDING PERL ON UTS
7979
7980 =item Installing the built perl on UTS
7981
7982 =item AUTHOR
7983
7984 =back
7985
7986 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
7987
7988 =over 4
7989
7990 =item SYNOPSIS
7991
7992 =item DESCRIPTION
7993
7994 =over 4
7995
7996 =item Unpacking Perl Distribution on VM/ESA
7997
7998 =item Setup Perl and utilities on VM/ESA
7999
8000 =item Configure Perl on VM/ESA
8001
8002 =item Testing Anomalies of Perl on VM/ESA
8003
8004 =item Usage Hints for Perl on VM/ESA
8005
8006 =back
8007
8008 =item AUTHORS
8009
8010 =item SEE ALSO
8011
8012 =over 4
8013
8014 =item Mailing list for Perl on VM/ESA
8015
8016 =back
8017
8018 =back
8019
8020 =head2 perlvms - VMS-specific documentation for Perl
8021
8022 =over 4
8023
8024 =item DESCRIPTION
8025
8026 =item Installation
8027
8028 =item Organization of Perl Images
8029
8030 =over 4
8031
8032 =item Core Images
8033
8034 =item Perl Extensions
8035
8036 =item Installing static extensions
8037
8038 =item Installing dynamic extensions
8039
8040 =back
8041
8042 =item File specifications
8043
8044 =over 4
8045
8046 =item Syntax
8047
8048 =item Wildcard expansion
8049
8050 =item Pipes
8051
8052 =back
8053
8054 =item PERL5LIB and PERLLIB
8055
8056 =item Command line
8057
8058 =over 4
8059
8060 =item I/O redirection and backgrounding
8061
8062 =item Command line switches
8063
8064 -i, -S, -u
8065
8066 =back
8067
8068 =item Perl functions
8069
8070 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8071 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8072 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8073 LIST, waitpid PID,FLAGS
8074
8075 =item Perl variables
8076
8077 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8078
8079 =item Standard modules with VMS-specific differences
8080
8081 =over 4
8082
8083 =item SDBM_File
8084
8085 =back
8086
8087 =item Revision date
8088
8089 =item AUTHOR
8090
8091 =back
8092
8093 =head2 perlvos, README.vos - Perl for Stratus VOS
8094
8095 =over 4
8096
8097 =item SYNOPSIS
8098
8099 =over 4
8100
8101 =item Multiple methods to build perl for VOS
8102
8103 =item Stratus POSIX Support
8104
8105 =back
8106
8107 =item INSTALLING PERL IN VOS
8108
8109 =over 4
8110
8111 =item Compiling Perl 5 on VOS
8112
8113 =item Installing Perl 5 on VOS
8114
8115 =back
8116
8117 =item USING PERL IN VOS
8118
8119 =over 4
8120
8121 =item Unimplemented Features of Perl on VOS
8122
8123 =item Restrictions of Perl on VOS
8124
8125 =item Handling of underflow and overflow
8126
8127 =back
8128
8129 =item TEST STATUS
8130
8131 =item SUPPORT STATUS
8132
8133 =item AUTHOR
8134
8135 =item LAST UPDATE
8136
8137 =back
8138
8139 =head2 perlwin32 - Perl under Windows
8140
8141 =over 4
8142
8143 =item SYNOPSIS
8144
8145 =item DESCRIPTION
8146
8147 =over 4
8148
8149 =item Setting Up Perl on Win32
8150
8151 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8152 SDK 64-bit Compiler, Mingw32 with GCC
8153
8154 =item Building
8155
8156 =item Testing Perl on Win32
8157
8158 =item Installation of Perl on Win32
8159
8160 =item Usage Hints for Perl on Win32
8161
8162 Environment Variables, File Globbing, Using perl from the command line,
8163 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8164 Extensions, Notes on 64-bit Windows, Running Perl Scripts, Miscellaneous
8165 Things
8166
8167 =back
8168
8169 =item BUGS AND CAVEATS
8170
8171 =item AUTHORS
8172
8173 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8174 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8175 E<lt>nick@ing-simmons.netE<gt>
8176
8177 =item SEE ALSO
8178
8179 =item HISTORY
8180
8181 =back
8182
8183 =head1 PRAGMA DOCUMENTATION
8184
8185 =head2 attrs - set/get attributes of a subroutine (deprecated)
8186
8187 =over 4
8188
8189 =item SYNOPSIS
8190
8191 =item DESCRIPTION
8192
8193 method, locked
8194
8195 =back
8196
8197 =head2 re - Perl pragma to alter regular expression behaviour
8198
8199 =over 4
8200
8201 =item SYNOPSIS
8202
8203 =item DESCRIPTION
8204
8205 =back
8206
8207 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8208
8209 =over 4
8210
8211 =item SYNOPSIS
8212
8213 =item DESCRIPTION
8214
8215 =item FUNCTIONS AND METHODS
8216
8217 new, enqueue LIST, dequeue, dequeue_nb, pending
8218
8219 =item SEE ALSO
8220
8221 =back
8222
8223 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8224 semaphores
8225
8226 =over 4
8227
8228 =item SYNOPSIS
8229
8230 =item DESCRIPTION
8231
8232 =item FUNCTIONS AND METHODS
8233
8234 new, new NUMBER, down, down NUMBER, up, up NUMBER
8235
8236 =back
8237
8238 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8239 data structures between threads
8240
8241 =over 4
8242
8243 =item SYNOPSIS
8244
8245 =item DESCRIPTION
8246
8247 =item EXPORT
8248
8249 =item FUNCTIONS
8250
8251 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8252 cond_broadcast VARIABLE
8253
8254 =item NOTES
8255
8256 =item BUGS
8257
8258 =item AUTHOR
8259
8260 =item SEE ALSO
8261
8262 =back
8263
8264 =head2 threads - Perl extension allowing use of interpreter based threads
8265 from perl
8266
8267 =over 4
8268
8269 =item SYNOPSIS
8270
8271 =item DESCRIPTION
8272
8273 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8274 threads->self, $thread->tid, threads->yield();, threads->list();, async
8275 BLOCK;
8276
8277 =item WARNINGS
8278
8279 A thread exited while %d other threads were still running
8280
8281 =item BUGS / TODO
8282
8283 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8284 not threadsafe, will not be
8285
8286 =item AUTHOR and COPYRIGHT
8287
8288 =item SEE ALSO
8289
8290 =back
8291
8292 =head2 attributes - get/set subroutine or variable attributes
8293
8294 =over 4
8295
8296 =item SYNOPSIS
8297
8298 =item DESCRIPTION
8299
8300 =over 4
8301
8302 =item Built-in Attributes
8303
8304 locked, method, lvalue
8305
8306 =item Available Subroutines
8307
8308 get, reftype
8309
8310 =item Package-specific Attribute Handling
8311
8312 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8313
8314 =item Syntax of Attribute Lists
8315
8316 =back
8317
8318 =item EXPORTS
8319
8320 =over 4
8321
8322 =item Default exports
8323
8324 =item Available exports
8325
8326 =item Export tags defined
8327
8328 =back
8329
8330 =item EXAMPLES
8331
8332 =item SEE ALSO
8333
8334 =back
8335
8336 =head2 attrs - set/get attributes of a subroutine (deprecated)
8337
8338 =over 4
8339
8340 =item SYNOPSIS
8341
8342 =item DESCRIPTION
8343
8344 method, locked
8345
8346 =back
8347
8348 =head2 autouse - postpone load of modules until a function is used
8349
8350 =over 4
8351
8352 =item SYNOPSIS
8353
8354 =item DESCRIPTION
8355
8356 =item WARNING
8357
8358 =item AUTHOR
8359
8360 =item SEE ALSO
8361
8362 =back
8363
8364 =head2 base - Establish IS-A relationship with base class at compile time
8365
8366 =over 4
8367
8368 =item SYNOPSIS
8369
8370 =item DESCRIPTION
8371
8372 =item HISTORY
8373
8374 =item SEE ALSO
8375
8376 =back
8377
8378 =head2 bigint - Transparent big integer support for Perl
8379
8380 =over 4
8381
8382 =item SYNOPSIS
8383
8384 =item DESCRIPTION
8385
8386 =over 4
8387
8388 =item OPTIONS
8389
8390 a or accuracy, p or precision, t or trace, l or lib, v or version
8391
8392 =item MATH LIBRARY
8393
8394 =item INTERNAL FORMAT
8395
8396 =item SIGN
8397
8398 =item METHODS
8399
8400 =back
8401
8402 =item MODULES USED
8403
8404 =item EXAMPLES
8405
8406 =item LICENSE
8407
8408 =item SEE ALSO
8409
8410 =item AUTHORS
8411
8412 =back
8413
8414 =head2 bignum - Transparent BigNumber support for Perl
8415
8416 =over 4
8417
8418 =item SYNOPSIS
8419
8420 =item DESCRIPTION
8421
8422 =over 4
8423
8424 =item OPTIONS
8425
8426 a or accuracy, p or precision, t or trace, l or lib, v or version
8427
8428 =item MATH LIBRARY
8429
8430 =item INTERNAL FORMAT
8431
8432 =item SIGN
8433
8434 =item METHODS
8435
8436 =back
8437
8438 =item MODULES USED
8439
8440 =item EXAMPLES
8441
8442 =item LICENSE
8443
8444 =item SEE ALSO
8445
8446 =item AUTHORS
8447
8448 =back
8449
8450 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8451
8452 =over 4
8453
8454 =item SYNOPSIS
8455
8456 =item DESCRIPTION
8457
8458 =over 4
8459
8460 =item MODULES USED
8461
8462 =item MATH LIBRARY
8463
8464 =item SIGN
8465
8466 =item METHODS
8467
8468 =back
8469
8470 =item EXAMPLES
8471
8472         perl -Mbigrat -le 'print sqrt(33)'
8473         perl -Mbigrat -le 'print 2*255'
8474         perl -Mbigrat -le 'print 4.5+2*255'
8475         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8476         perl -Mbigrat -le 'print 12->is_odd()';
8477
8478 =item LICENSE
8479
8480 =item SEE ALSO
8481
8482 =item AUTHORS
8483
8484 =back
8485
8486 =head2 blib - Use MakeMaker's uninstalled version of a package
8487
8488 =over 4
8489
8490 =item SYNOPSIS
8491
8492 =item DESCRIPTION
8493
8494 =item BUGS
8495
8496 =item AUTHOR
8497
8498 =back
8499
8500 =head2 bytes - Perl pragma to force byte semantics rather than character
8501 semantics
8502
8503 =over 4
8504
8505 =item SYNOPSIS
8506
8507 =item DESCRIPTION
8508
8509 =item SEE ALSO
8510
8511 =back
8512
8513 =head2 charnames - define character names for C<\N{named}> string literal
8514 escapes
8515
8516 =over 4
8517
8518 =item SYNOPSIS
8519
8520 =item DESCRIPTION
8521
8522 =item CUSTOM TRANSLATORS
8523
8524 =item charnames::viacode(code)
8525
8526 =item charnames::vianame(name)
8527
8528 =item ALIASES
8529
8530 =item ILLEGAL CHARACTERS
8531
8532 =item BUGS
8533
8534 =back
8535
8536 =head2 constant - Perl pragma to declare constants
8537
8538 =over 4
8539
8540 =item SYNOPSIS
8541
8542 =item DESCRIPTION
8543
8544 =item NOTES
8545
8546 =over 4
8547
8548 =item List constants
8549
8550 =item Defining multiple constants at once
8551
8552 =item Magic constants
8553
8554 =back
8555
8556 =item TECHNICAL NOTES
8557
8558 =item BUGS
8559
8560 =item AUTHOR
8561
8562 =item COPYRIGHT
8563
8564 =back
8565
8566 =head2 diagnostics - Perl compiler pragma to force verbose warning
8567 diagnostics
8568
8569 =over 4
8570
8571 =item SYNOPSIS
8572
8573 =item DESCRIPTION
8574
8575 =over 4
8576
8577 =item The C<diagnostics> Pragma
8578
8579 =item The I<splain> Program
8580
8581 =back
8582
8583 =item EXAMPLES
8584
8585 =item INTERNALS
8586
8587 =item BUGS
8588
8589 =item AUTHOR
8590
8591 =back
8592
8593 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8594
8595 =over 4
8596
8597 =item SYNOPSIS
8598
8599 =item ABSTRACT
8600
8601 =item USAGE
8602
8603 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8604 I<ENCNAME_IN> ...] ;, no encoding;
8605
8606 =item CAVEATS
8607
8608 =over 4
8609
8610 =item NOT SCOPED
8611
8612 =item DO NOT MIX MULTIPLE ENCODINGS
8613
8614 =back
8615
8616 =item Non-ASCII Identifiers and Filter option
8617
8618 use encoding I<ENCNAME> Filter=E<gt>1;
8619
8620 =item EXAMPLE - Greekperl
8621
8622 =item KNOWN PROBLEMS
8623
8624 =item SEE ALSO
8625
8626 =back
8627
8628 =head2 fields - compile-time class fields
8629
8630 =over 4
8631
8632 =item SYNOPSIS
8633
8634 =item DESCRIPTION
8635
8636 new, phash
8637
8638 =item SEE ALSO
8639
8640 =back
8641
8642 =head2 filetest - Perl pragma to control the filetest permission operators
8643
8644 =over 4
8645
8646 =item SYNOPSIS
8647
8648 =item DESCRIPTION
8649
8650 =over 4
8651
8652 =item subpragma access
8653
8654 =back
8655
8656 =back
8657
8658 =head2 if - C<use> a Perl module if a condition holds
8659
8660 =over 4
8661
8662 =item SYNOPSIS
8663
8664 =item DESCRIPTION
8665
8666 =item BUGS
8667
8668 =item AUTHOR
8669
8670 =back
8671
8672 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8673 point
8674
8675 =over 4
8676
8677 =item SYNOPSIS
8678
8679 =item DESCRIPTION
8680
8681 =back
8682
8683 =head2 less - perl pragma to request less of something from the compiler
8684
8685 =over 4
8686
8687 =item SYNOPSIS
8688
8689 =item DESCRIPTION
8690
8691 =back
8692
8693 =head2 lib - manipulate @INC at compile time
8694
8695 =over 4
8696
8697 =item SYNOPSIS
8698
8699 =item DESCRIPTION
8700
8701 =over 4
8702
8703 =item Adding directories to @INC
8704
8705 =item Deleting directories from @INC
8706
8707 =item Restoring original @INC
8708
8709 =back
8710
8711 =item CAVEATS
8712
8713 =item SEE ALSO
8714
8715 =item AUTHOR
8716
8717 =back
8718
8719 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8720 operations
8721
8722 =over 4
8723
8724 =item SYNOPSIS
8725
8726 =item DESCRIPTION
8727
8728 =back
8729
8730 =head2 open - perl pragma to set default disciplines for input and output
8731
8732 =over 4
8733
8734 =item SYNOPSIS
8735
8736 =item DESCRIPTION
8737
8738 =item NONPERLIO FUNCTIONALITY
8739
8740 =item IMPLEMENTATION DETAILS
8741
8742 =item SEE ALSO
8743
8744 =back
8745
8746 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8747
8748 =over 4
8749
8750 =item SYNOPSIS
8751
8752 =item DESCRIPTION
8753
8754 =item SEE ALSO
8755
8756 =back
8757
8758 =head2 overload - Package for overloading perl operations
8759
8760 =over 4
8761
8762 =item SYNOPSIS
8763
8764 =item DESCRIPTION
8765
8766 =over 4
8767
8768 =item Declaration of overloaded functions
8769
8770 =item Calling Conventions for Binary Operations
8771
8772 FALSE, TRUE, C<undef>
8773
8774 =item Calling Conventions for Unary Operations
8775
8776 =item Calling Conventions for Mutators
8777
8778 C<++> and C<-->, C<x=> and other assignment versions
8779
8780 =item Overloadable Operations
8781
8782 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8783 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8784 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8785
8786 =item Inheritance and overloading
8787
8788 Strings as values of C<use overload> directive, Overloading of an operation
8789 is inherited by derived classes
8790
8791 =back
8792
8793 =item SPECIAL SYMBOLS FOR C<use overload>
8794
8795 =over 4
8796
8797 =item Last Resort
8798
8799 =item Fallback
8800
8801 C<undef>, TRUE, defined, but FALSE
8802
8803 =item Copy Constructor
8804
8805 B<Example>
8806
8807 =back
8808
8809 =item MAGIC AUTOGENERATION
8810
8811 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8812 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8813 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8814 I<Copy operator>
8815
8816 =item Losing overloading
8817
8818 =item Run-time Overloading
8819
8820 =item Public functions
8821
8822 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8823
8824 =item Overloading constants
8825
8826 integer, float, binary, q, qr
8827
8828 =item IMPLEMENTATION
8829
8830 =item Metaphor clash
8831
8832 =item Cookbook
8833
8834 =over 4
8835
8836 =item Two-face scalars
8837
8838 =item Two-face references
8839
8840 =item Symbolic calculator
8841
8842 =item I<Really> symbolic calculator
8843
8844 =back
8845
8846 =item AUTHOR
8847
8848 =item DIAGNOSTICS
8849
8850 Odd number of arguments for overload::constant, `%s' is not an overloadable
8851 type, `%s' is not a code reference
8852
8853 =item BUGS
8854
8855 =back
8856
8857 =head2 re - Perl pragma to alter regular expression behaviour
8858
8859 =over 4
8860
8861 =item SYNOPSIS
8862
8863 =item DESCRIPTION
8864
8865 =back
8866
8867 =head2 sigtrap - Perl pragma to enable simple signal handling
8868
8869 =over 4
8870
8871 =item SYNOPSIS
8872
8873 =item DESCRIPTION
8874
8875 =item OPTIONS
8876
8877 =over 4
8878
8879 =item SIGNAL HANDLERS
8880
8881 B<stack-trace>, B<die>, B<handler> I<your-handler>
8882
8883 =item SIGNAL LISTS
8884
8885 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8886
8887 =item OTHER
8888
8889 B<untrapped>, B<any>, I<signal>, I<number>
8890
8891 =back
8892
8893 =item EXAMPLES
8894
8895 =back
8896
8897 =head2 sort - perl pragma to control sort() behaviour
8898
8899 =over 4
8900
8901 =item SYNOPSIS
8902
8903 =item DESCRIPTION
8904
8905 =item CAVEATS
8906
8907 =back
8908
8909 =head2 strict - Perl pragma to restrict unsafe constructs
8910
8911 =over 4
8912
8913 =item SYNOPSIS
8914
8915 =item DESCRIPTION
8916
8917 C<strict refs>, C<strict vars>, C<strict subs>
8918
8919 =back
8920
8921 =head2 subs - Perl pragma to predeclare sub names
8922
8923 =over 4
8924
8925 =item SYNOPSIS
8926
8927 =item DESCRIPTION
8928
8929 =back
8930
8931 =head2 threads - Perl extension allowing use of interpreter based threads
8932 from perl
8933
8934 =over 4
8935
8936 =item SYNOPSIS
8937
8938 =item DESCRIPTION
8939
8940 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8941 threads->self, $thread->tid, threads->yield();, threads->list();, async
8942 BLOCK;
8943
8944 =item WARNINGS
8945
8946 A thread exited while %d other threads were still running
8947
8948 =item BUGS / TODO
8949
8950 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8951 not threadsafe, will not be
8952
8953 =item AUTHOR and COPYRIGHT
8954
8955 =item SEE ALSO
8956
8957 =back
8958
8959 =head2 threadshared, threads::shared - Perl extension for sharing data
8960 structures between threads
8961
8962 =over 4
8963
8964 =item SYNOPSIS
8965
8966 =item DESCRIPTION
8967
8968 =item EXPORT
8969
8970 =item FUNCTIONS
8971
8972 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8973 cond_broadcast VARIABLE
8974
8975 =item NOTES
8976
8977 =item BUGS
8978
8979 =item AUTHOR
8980
8981 =item SEE ALSO
8982
8983 =back
8984
8985 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8986
8987 =over 4
8988
8989 =item SYNOPSIS
8990
8991 =item DESCRIPTION
8992
8993 =item FUNCTIONS AND METHODS
8994
8995 new, enqueue LIST, dequeue, dequeue_nb, pending
8996
8997 =item SEE ALSO
8998
8999 =back
9000
9001 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
9002 semaphores
9003
9004 =over 4
9005
9006 =item SYNOPSIS
9007
9008 =item DESCRIPTION
9009
9010 =item FUNCTIONS AND METHODS
9011
9012 new, new NUMBER, down, down NUMBER, up, up NUMBER
9013
9014 =back
9015
9016 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9017 code
9018
9019 =over 4
9020
9021 =item SYNOPSIS
9022
9023 =item DESCRIPTION
9024
9025 =over 4
9026
9027 =item Utility functions
9028
9029 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9030 utf8::encode($string), $flag = utf8::decode($string), $flag =
9031 utf8::valid(STRING)
9032
9033 =back
9034
9035 =item SEE ALSO
9036
9037 =back
9038
9039 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9040
9041 =over 4
9042
9043 =item SYNOPSIS
9044
9045 =item DESCRIPTION
9046
9047 =back
9048
9049 =head2 vmsish - Perl pragma to control VMS-specific language features
9050
9051 =over 4
9052
9053 =item SYNOPSIS
9054
9055 =item DESCRIPTION
9056
9057 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9058
9059 =back
9060
9061 =head2 warnings - Perl pragma to control optional warnings
9062
9063 =over 4
9064
9065 =item SYNOPSIS
9066
9067 =item DESCRIPTION
9068
9069 use warnings::register, warnings::enabled(), warnings::enabled($category),
9070 warnings::enabled($object), warnings::warn($message),
9071 warnings::warn($category, $message), warnings::warn($object, $message),
9072 warnings::warnif($message), warnings::warnif($category, $message),
9073 warnings::warnif($object, $message)
9074
9075 =back
9076
9077 =head2 warnings::register - warnings import function
9078
9079 =over 4
9080
9081 =item SYNOPSIS
9082
9083 =item DESCRIPTION
9084
9085 =back
9086
9087 =head1 MODULE DOCUMENTATION
9088
9089 =head2 AnyDBM_File - provide framework for multiple DBMs
9090
9091 =over 4
9092
9093 =item SYNOPSIS
9094
9095 =item DESCRIPTION
9096
9097 =over 4
9098
9099 =item DBM Comparisons
9100
9101 [0], [1], [2], [3]
9102
9103 =back
9104
9105 =item SEE ALSO
9106
9107 =back
9108
9109 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9110
9111 =over 4
9112
9113 =item VERSION
9114
9115 =item SYNOPSIS
9116
9117 =item DESCRIPTION
9118
9119 [0], [1], [2], [3], [4], [5]
9120
9121 =over 4
9122
9123 =item Typed lexicals
9124
9125 =item Type-specific attribute handlers
9126
9127 =item Non-interpretive attribute handlers
9128
9129 =item Phase-specific attribute handlers
9130
9131 =item Attributes as C<tie> interfaces
9132
9133 =back
9134
9135 =item EXAMPLES
9136
9137 =item DIAGNOSTICS
9138
9139 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9140 attributes>, C<Declaration of %s attribute in package %s may clash with
9141 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9142 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9143 be able to apply END handler>
9144
9145 =item AUTHOR
9146
9147 =item BUGS
9148
9149 =item COPYRIGHT
9150
9151 =back
9152
9153 =head2 AutoLoader - load subroutines only on demand
9154
9155 =over 4
9156
9157 =item SYNOPSIS
9158
9159 =item DESCRIPTION
9160
9161 =over 4
9162
9163 =item Subroutine Stubs
9164
9165 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9166
9167 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9168
9169 =item Package Lexicals
9170
9171 =item Not Using AutoLoader
9172
9173 =item B<AutoLoader> vs. B<SelfLoader>
9174
9175 =back
9176
9177 =item CAVEATS
9178
9179 =item SEE ALSO
9180
9181 =back
9182
9183 =head2 AutoSplit - split a package for autoloading
9184
9185 =over 4
9186
9187 =item SYNOPSIS
9188
9189 =item DESCRIPTION
9190
9191 $keep, $check, $modtime
9192
9193 =over 4
9194
9195 =item Multiple packages
9196
9197 =back
9198
9199 =item DIAGNOSTICS
9200
9201 =back
9202
9203 =head2 B - The Perl Compiler
9204
9205 =over 4
9206
9207 =item SYNOPSIS
9208
9209 =item DESCRIPTION
9210
9211 =item OVERVIEW OF CLASSES
9212
9213 =over 4
9214
9215 =item SV-RELATED CLASSES
9216
9217 =item B::SV METHODS
9218
9219 REFCNT, FLAGS
9220
9221 =item B::IV METHODS
9222
9223 IV, IVX, UVX, int_value, needs64bits, packiv
9224
9225 =item B::NV METHODS
9226
9227 NV, NVX
9228
9229 =item B::RV METHODS
9230
9231 RV
9232
9233 =item B::PV METHODS
9234
9235 PV, RV, PVX
9236
9237 =item B::PVMG METHODS
9238
9239 MAGIC, SvSTASH
9240
9241 =item B::MAGIC METHODS
9242
9243 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9244
9245 =item B::PVLV METHODS
9246
9247 TARGOFF, TARGLEN, TYPE, TARG
9248
9249 =item B::BM METHODS
9250
9251 USEFUL, PREVIOUS, RARE, TABLE
9252
9253 =item B::GV METHODS
9254
9255 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9256 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9257
9258 =item B::IO METHODS
9259
9260 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9261 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9262
9263 =item B::AV METHODS
9264
9265 FILL, MAX, OFF, ARRAY, AvFLAGS
9266
9267 =item B::CV METHODS
9268
9269 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9270 CvFLAGS, const_sv
9271
9272 =item B::HV METHODS
9273
9274 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9275
9276 =item OP-RELATED CLASSES
9277
9278 =item B::OP METHODS
9279
9280 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9281
9282 =item B::UNOP METHOD
9283
9284 first
9285
9286 =item B::BINOP METHOD
9287
9288 last
9289
9290 =item B::LOGOP METHOD
9291
9292 other
9293
9294 =item B::LISTOP METHOD
9295
9296 children
9297
9298 =item B::PMOP METHODS
9299
9300 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9301 pmpermflags, precomp, pmoffet
9302
9303 =item B::SVOP METHOD
9304
9305 sv, gv
9306
9307 =item B::PADOP METHOD
9308
9309 padix
9310
9311 =item B::PVOP METHOD
9312
9313 pv
9314
9315 =item B::LOOP METHODS
9316
9317 redoop, nextop, lastop
9318
9319 =item B::COP METHODS
9320
9321 label, stash, file, cop_seq, arybase, line
9322
9323 =back
9324
9325 =item FUNCTIONS EXPORTED BY C<B>
9326
9327 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9328 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9329 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9330 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9331 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9332
9333 =item AUTHOR
9334
9335 =back
9336
9337 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9338 bytecode
9339
9340 =over 4
9341
9342 =item SYNOPSIS
9343
9344 =item DESCRIPTION
9345
9346 %insn_data, @insn_name, @optype, @specialsv_name
9347
9348 =item AUTHOR
9349
9350 =back
9351
9352 =head2 B::Assembler - Assemble Perl bytecode
9353
9354 =over 4
9355
9356 =item SYNOPSIS
9357
9358 =item DESCRIPTION
9359
9360 =item AUTHORS
9361
9362 =back
9363
9364 =head2 B::Bblock - Walk basic blocks
9365
9366 =over 4
9367
9368 =item SYNOPSIS
9369
9370 =item DESCRIPTION
9371
9372 =over 4
9373
9374 =item Functions
9375
9376 B<find_leaders>
9377
9378 =back
9379
9380 =item AUTHOR
9381
9382 =back
9383
9384 =head2 B::Bytecode - Perl compiler's bytecode backend
9385
9386 =over 4
9387
9388 =item SYNOPSIS
9389
9390 =item DESCRIPTION
9391
9392 =item OPTIONS
9393
9394 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9395 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9396 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9397
9398 =item EXAMPLES
9399
9400 =item BUGS
9401
9402 =item AUTHORS
9403
9404 =back
9405
9406 =head2 B::C - Perl compiler's C backend
9407
9408 =over 4
9409
9410 =item SYNOPSIS
9411
9412 =item DESCRIPTION
9413
9414 =item OPTIONS
9415
9416 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9417 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9418 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9419 B<-llimit>
9420
9421 =item EXAMPLES
9422
9423 =item BUGS
9424
9425 =item AUTHOR
9426
9427 =back
9428
9429 =head2 B::CC - Perl compiler's optimized C translation backend
9430
9431 =over 4
9432
9433 =item SYNOPSIS
9434
9435 =item DESCRIPTION
9436
9437 =item OPTIONS
9438
9439 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9440 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9441 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9442
9443 =item EXAMPLES
9444
9445 =item BUGS
9446
9447 =item DIFFERENCES
9448
9449 =over 4
9450
9451 =item Loops
9452
9453 =item Context of ".."
9454
9455 =item Arithmetic
9456
9457 =item Deprecated features
9458
9459 =back
9460
9461 =item AUTHOR
9462
9463 =back
9464
9465 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9466
9467 =over 4
9468
9469 =item SYNOPSIS
9470
9471 =item DESCRIPTION
9472
9473 =item EXAMPLE
9474
9475 =item OPTIONS
9476
9477 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9478 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9479 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9480
9481 =item FORMATTING SPECIFICATIONS
9482
9483 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9484 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9485 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9486 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9487 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9488 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9489 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9490 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9491
9492 =item ABBREVIATIONS
9493
9494 =over 4
9495
9496 =item OP flags abbreviations
9497
9498 =item OP class abbreviations
9499
9500 =back
9501
9502 =item Using B::Concise outside of the O framework
9503
9504 =item AUTHOR
9505
9506 =back
9507
9508 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9509
9510 =over 4
9511
9512 =item SYNOPSIS
9513
9514 =item DESCRIPTION
9515
9516 =item AUTHOR
9517
9518 =back
9519
9520 =head2 B::Deparse - Perl compiler backend to produce perl code
9521
9522 =over 4
9523
9524 =item SYNOPSIS
9525
9526 =item DESCRIPTION
9527
9528 =item OPTIONS
9529
9530 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9531 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9532
9533 =item USING B::Deparse AS A MODULE
9534
9535 =over 4
9536
9537 =item Synopsis
9538
9539 =item Description
9540
9541 =item new
9542
9543 =item ambient_pragmas
9544
9545 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9546
9547 =item coderef2text
9548
9549 =back
9550
9551 =item BUGS
9552
9553 =item AUTHOR
9554
9555 =back
9556
9557 =head2 B::Disassembler - Disassemble Perl bytecode
9558
9559 =over 4
9560
9561 =item SYNOPSIS
9562
9563 =item DESCRIPTION
9564
9565 =item AUTHOR
9566
9567 =back
9568
9569 =head2 B::Lint - Perl lint
9570
9571 =over 4
9572
9573 =item SYNOPSIS
9574
9575 =item DESCRIPTION
9576
9577 =item OPTIONS AND LINT CHECKS
9578
9579 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9580 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9581
9582 =item NON LINT-CHECK OPTIONS
9583
9584 B<-u Package>
9585
9586 =item BUGS
9587
9588 =item AUTHOR
9589
9590 =back
9591
9592 =head2 B::O, O - Generic interface to Perl Compiler backends
9593
9594 =over 4
9595
9596 =item SYNOPSIS
9597
9598 =item DESCRIPTION
9599
9600 =item CONVENTIONS
9601
9602 =item IMPLEMENTATION
9603
9604 =item BUGS
9605
9606 =item AUTHOR
9607
9608 =back
9609
9610 =head2 B::Showlex - Show lexical variables used in functions or files
9611
9612 =over 4
9613
9614 =item SYNOPSIS
9615
9616 =item DESCRIPTION
9617
9618 =item AUTHOR
9619
9620 =back
9621
9622 =head2 B::Stackobj - Helper module for CC backend
9623
9624 =over 4
9625
9626 =item SYNOPSIS
9627
9628 =item DESCRIPTION
9629
9630 =item AUTHOR
9631
9632 =back
9633
9634 =head2 B::Stash - show what stashes are loaded
9635
9636 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9637
9638 =over 4
9639
9640 =item SYNOPSIS
9641
9642 =item DESCRIPTION
9643
9644 =item AUTHOR
9645
9646 =back
9647
9648 =head2 B::Xref - Generates cross reference reports for Perl programs
9649
9650 =over 4
9651
9652 =item SYNOPSIS
9653
9654 =item DESCRIPTION
9655
9656 =item OPTIONS
9657
9658 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9659
9660 =item BUGS
9661
9662 =item AUTHOR
9663
9664 =back
9665
9666 =head2 Bblock, B::Bblock - Walk basic blocks
9667
9668 =over 4
9669
9670 =item SYNOPSIS
9671
9672 =item DESCRIPTION
9673
9674 =over 4
9675
9676 =item Functions
9677
9678 B<find_leaders>
9679
9680 =back
9681
9682 =item AUTHOR
9683
9684 =back
9685
9686 =head2 Benchmark - benchmark running times of Perl code
9687
9688 =over 4
9689
9690 =item SYNOPSIS
9691
9692 =item DESCRIPTION
9693
9694 =over 4
9695
9696 =item Methods
9697
9698 new, debug, iters
9699
9700 =item Standard Exports
9701
9702 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9703 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9704 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9705
9706 =item Optional Exports
9707
9708 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9709 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9710 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9711
9712 =back
9713
9714 =item NOTES
9715
9716 =item EXAMPLES
9717
9718 =item INHERITANCE
9719
9720 =item CAVEATS
9721
9722 =item SEE ALSO
9723
9724 =item AUTHORS
9725
9726 =item MODIFICATION HISTORY
9727
9728 =back
9729
9730 =head2 ByteLoader - load byte compiled perl code
9731
9732 =over 4
9733
9734 =item SYNOPSIS
9735
9736 =item DESCRIPTION
9737
9738 =item AUTHOR
9739
9740 =item SEE ALSO
9741
9742 =back
9743
9744 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9745
9746 =over 4
9747
9748 =item SYNOPSIS
9749
9750 =item DESCRIPTION
9751
9752 =item OPTIONS
9753
9754 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9755 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9756 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9757
9758 =item EXAMPLES
9759
9760 =item BUGS
9761
9762 =item AUTHORS
9763
9764 =back
9765
9766 =head2 CGI - Simple Common Gateway Interface Class
9767
9768 =over 4
9769
9770 =item SYNOPSIS
9771
9772 =item ABSTRACT
9773
9774 =item DESCRIPTION
9775
9776 =over 4
9777
9778 =item PROGRAMMING STYLE
9779
9780 =item CALLING CGI.PM ROUTINES
9781
9782 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9783
9784 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9785
9786 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9787
9788 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9789
9790 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9791
9792 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9793
9794 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9795
9796 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9797
9798 =item DELETING A PARAMETER COMPLETELY:
9799
9800 =item DELETING ALL PARAMETERS:
9801
9802 =item DIRECT ACCESS TO THE PARAMETER LIST:
9803
9804 =item FETCHING THE PARAMETER LIST AS A HASH:
9805
9806 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9807
9808 =item RETRIEVING CGI ERRORS
9809
9810 =item USING THE FUNCTION-ORIENTED INTERFACE
9811
9812 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9813 B<:standard>, B<:all>
9814
9815 =item PRAGMAS
9816
9817 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9818 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9819 -private_tempfiles
9820
9821 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9822
9823 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9824 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9825 a </ul> tag)
9826
9827 =back
9828
9829 =item GENERATING DYNAMIC DOCUMENTS
9830
9831 =over 4
9832
9833 =item CREATING A STANDARD HTTP HEADER:
9834
9835 =item GENERATING A REDIRECTION HEADER
9836
9837 =item CREATING THE HTML DOCUMENT HEADER
9838
9839 B<Parameters:>, 4, 5, 6..
9840
9841 =item ENDING THE HTML DOCUMENT:
9842
9843 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9844
9845 =item OBTAINING THE SCRIPT'S URL
9846
9847 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9848 (B<-query_string>), B<-base>
9849
9850 =item MIXING POST AND URL PARAMETERS
9851
9852 =back
9853
9854 =item CREATING STANDARD HTML ELEMENTS:
9855
9856 =over 4
9857
9858 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9859
9860 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9861
9862 =item HTML SHORTCUTS AND LIST INTERPOLATION
9863
9864 =item NON-STANDARD HTML SHORTCUTS
9865
9866 =item AUTOESCAPING HTML
9867
9868 $escaped_string = escapeHTML("unescaped string");, $charset =
9869 charset([$charset]);, $flag = autoEscape([$flag]);
9870
9871 =item PRETTY-PRINTING HTML
9872
9873 =back
9874
9875 =item CREATING FILL-OUT FORMS:
9876
9877 =over 4
9878
9879 =item CREATING AN ISINDEX TAG
9880
9881 =item STARTING AND ENDING A FORM
9882
9883 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9884
9885 =item CREATING A TEXT FIELD
9886
9887 B<Parameters>
9888
9889 =item CREATING A BIG TEXT FIELD
9890
9891 =item CREATING A PASSWORD FIELD
9892
9893 =item CREATING A FILE UPLOAD FIELD
9894
9895 B<Parameters>
9896
9897 =item CREATING A POPUP MENU
9898
9899 =item CREATING A SCROLLING LIST
9900
9901 B<Parameters:>
9902
9903 =item CREATING A GROUP OF RELATED CHECKBOXES
9904
9905 B<Parameters:>
9906
9907 =item CREATING A STANDALONE CHECKBOX
9908
9909 B<Parameters:>
9910
9911 =item CREATING A RADIO BUTTON GROUP
9912
9913 B<Parameters:>
9914
9915 =item CREATING A SUBMIT BUTTON
9916
9917 B<Parameters:>
9918
9919 =item CREATING A RESET BUTTON
9920
9921 =item CREATING A DEFAULT BUTTON
9922
9923 =item CREATING A HIDDEN FIELD
9924
9925 B<Parameters:>
9926
9927 =item CREATING A CLICKABLE IMAGE BUTTON
9928
9929 B<Parameters:>
9930
9931 =item CREATING A JAVASCRIPT ACTION BUTTON
9932
9933 =back
9934
9935 =item HTTP COOKIES
9936
9937 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
9938 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
9939
9940 =item WORKING WITH FRAMES
9941
9942 1. Create a <Frameset> document, 2. Specify the destination for the
9943 document in the HTTP header, 3. Specify the destination for the document in
9944 the <form> tag
9945
9946 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
9947
9948 =item DEBUGGING
9949
9950 =over 4
9951
9952 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
9953
9954 =back
9955
9956 =item FETCHING ENVIRONMENT VARIABLES
9957
9958 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
9959 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
9960 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
9961 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
9962 B<request_method()>, B<content_type()>, B<http()>, B<https()>
9963
9964 =item USING NPH SCRIPTS
9965
9966 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
9967 parameters
9968
9969 =item Server Push
9970
9971 multipart_init(), multipart_start(), multipart_end(), multipart_final()
9972
9973 =item Avoiding Denial of Service Attacks
9974
9975 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
9976 basis>, B<2. Globally for all scripts>
9977
9978 =item COMPATIBILITY WITH CGI-LIB.PL
9979
9980 =item AUTHOR INFORMATION
9981
9982 =item CREDITS
9983
9984 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
9985 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
9986 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
9987 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
9988 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
9989 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
9990 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
9991 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
9992 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
9993 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
9994 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
9995 ...and many many more..
9996
9997 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
9998
9999 =item BUGS
10000
10001 =item SEE ALSO
10002
10003 =back
10004
10005 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10006
10007 =over 4
10008
10009 =item SYNOPSIS
10010
10011 =item ABSTRACT
10012
10013 =item DESCRIPTION
10014
10015 =item AUTHOR INFORMATION
10016
10017 =item BUGS
10018
10019 =item SEE ALSO
10020
10021 =back
10022
10023 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10024 other) error log
10025
10026 =over 4
10027
10028 =item SYNOPSIS
10029
10030 =item DESCRIPTION
10031
10032 =item REDIRECTING ERROR MESSAGES
10033
10034 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10035
10036 =over 4
10037
10038 =item Changing the default message
10039
10040 =back
10041
10042 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10043
10044 =item CHANGE LOG
10045
10046 =item AUTHORS
10047
10048 =item SEE ALSO
10049
10050 =back
10051
10052 =head2 CGI::Cookie - Interface to Netscape Cookies
10053
10054 =over 4
10055
10056 =item SYNOPSIS
10057
10058 =item DESCRIPTION
10059
10060 =item USING CGI::Cookie
10061
10062 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10063
10064 =over 4
10065
10066 =item Creating New Cookies
10067
10068 =item Sending the Cookie to the Browser
10069
10070 =item Recovering Previous Cookies
10071
10072 =item Manipulating Cookies
10073
10074 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10075
10076 =back
10077
10078 =item AUTHOR INFORMATION
10079
10080 =item BUGS
10081
10082 =item SEE ALSO
10083
10084 =back
10085
10086 =head2 CGI::Fast - CGI Interface for Fast CGI
10087
10088 =over 4
10089
10090 =item SYNOPSIS
10091
10092 =item DESCRIPTION
10093
10094 =item OTHER PIECES OF THE PUZZLE
10095
10096 =item WRITING FASTCGI PERL SCRIPTS
10097
10098 =item INSTALLING FASTCGI SCRIPTS
10099
10100 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10101
10102 =item EXTERNAL FASTCGI SERVER INVOCATION
10103
10104 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10105
10106 =item CAVEATS
10107
10108 =item AUTHOR INFORMATION
10109
10110 =item BUGS
10111
10112 =item SEE ALSO
10113
10114 =back
10115
10116 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10117
10118 =over 4
10119
10120 =item SYNOPSIS
10121
10122 =item DESCRIPTION
10123
10124 =over 4
10125
10126 =item Tags that won't be formatted
10127
10128 =item Customizing the Indenting
10129
10130 =back
10131
10132 =item BUGS
10133
10134 =item AUTHOR
10135
10136 =item SEE ALSO
10137
10138 =back
10139
10140 =head2 CGI::Push - Simple Interface to Server Push
10141
10142 =over 4
10143
10144 =item SYNOPSIS
10145
10146 =item DESCRIPTION
10147
10148 =item USING CGI::Push
10149
10150 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10151
10152 =over 4
10153
10154 =item Heterogeneous Pages
10155
10156 =item Changing the Page Delay on the Fly
10157
10158 =back
10159
10160 =item INSTALLING CGI::Push SCRIPTS
10161
10162 =item AUTHOR INFORMATION
10163
10164 =item BUGS
10165
10166 =item SEE ALSO
10167
10168 =back
10169
10170 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10171
10172 =over 4
10173
10174 =item SYNOPSIS
10175
10176 =item ABSTRACT
10177
10178 =item DESCRIPTION
10179
10180 =item AUTHOR INFORMATION
10181
10182 =item BUGS
10183
10184 =item SEE ALSO
10185
10186 =back
10187
10188 =head2 CGI::Util - Internal utilities used by CGI module
10189
10190 =over 4
10191
10192 =item SYNOPSIS
10193
10194 =item DESCRIPTION
10195
10196 =item AUTHOR INFORMATION
10197
10198 =item SEE ALSO
10199
10200 =back
10201
10202 =head2 CPAN - query, download and build perl modules from CPAN sites
10203
10204 =over 4
10205
10206 =item SYNOPSIS
10207
10208 =item DESCRIPTION
10209
10210 =over 4
10211
10212 =item Interactive Mode
10213
10214 Searching for authors, bundles, distribution files and modules, make, test,
10215 install, clean  modules or distributions, get, readme, look module or
10216 distribution, ls author, Signals
10217
10218 =item CPAN::Shell
10219
10220 =item autobundle
10221
10222 =item recompile
10223
10224 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10225
10226 =item Programmer's interface
10227
10228 expand($type,@things), expandany(@things), Programming Examples
10229
10230 =item Methods in the other Classes
10231
10232 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10233 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10234 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10235 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10236 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10237 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10238 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10239 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10240 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10241 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10242 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10243 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10244 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10245 CPAN::Distribution::look(), CPAN::Distribution::make(),
10246 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10247 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10248 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10249 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10250 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10251 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10252 CPAN::Module::description(), CPAN::Module::force($method,@args),
10253 CPAN::Module::get(), CPAN::Module::inst_file(),
10254 CPAN::Module::inst_version(), CPAN::Module::install(),
10255 CPAN::Module::look(), CPAN::Module::make(),
10256 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10257 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10258
10259 =item Cache Manager
10260
10261 =item Bundles
10262
10263 =item Prerequisites
10264
10265 =item Finding packages and VERSION
10266
10267 =item Debugging
10268
10269 =item Floppy, Zip, Offline Mode
10270
10271 =back
10272
10273 =item CONFIGURATION
10274
10275 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10276 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10277 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10278 [unshift|push|splice] E<lt>listE<gt>>
10279
10280 =over 4
10281
10282 =item Note on urllist parameter's format
10283
10284 =item urllist parameter has CD-ROM support
10285
10286 =back
10287
10288 =item SECURITY
10289
10290 =item EXPORT
10291
10292 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10293
10294 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10295
10296 =over 4
10297
10298 =item Three basic types of firewalls
10299
10300 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10301
10302 =item Configuring lynx or ncftp for going through a firewall
10303
10304 =back
10305
10306 =item FAQ
10307
10308 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10309
10310 =item BUGS
10311
10312 =item AUTHOR
10313
10314 =item TRANSLATIONS
10315
10316 =item SEE ALSO
10317
10318 =back
10319
10320 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10321
10322 =over 4
10323
10324 =item SYNOPSIS
10325
10326 =item DESCRIPTION
10327
10328 =back
10329
10330 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10331 module
10332
10333 =over 4
10334
10335 =item SYNOPSIS
10336
10337 =item DESCRIPTION
10338
10339 =item  SEE ALSO
10340
10341 =back
10342
10343 =head2 Carp, carp    - warn of errors (from perspective of caller)
10344
10345 =over 4
10346
10347 =item SYNOPSIS
10348
10349 =item DESCRIPTION
10350
10351 =over 4
10352
10353 =item Forcing a Stack Trace
10354
10355 =back
10356
10357 =item BUGS
10358
10359 =back
10360
10361 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10362
10363 =head2 Class::ISA -- report the search path for a class's ISA tree
10364
10365 =over 4
10366
10367 =item SYNOPSIS
10368
10369 =item DESCRIPTION
10370
10371 =item FUNCTIONS
10372
10373 the function Class::ISA::super_path($CLASS), the function
10374 Class::ISA::self_and_super_path($CLASS), the function
10375 Class::ISA::self_and_super_versions($CLASS)
10376
10377 =item CAUTIONARY NOTES
10378
10379 =item COPYRIGHT
10380
10381 =item AUTHOR
10382
10383 =back
10384
10385 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10386
10387 =over 4
10388
10389 =item SYNOPSIS
10390
10391 =item DESCRIPTION
10392
10393 =over 4
10394
10395 =item The C<struct()> function
10396
10397 =item Class Creation at Compile Time
10398
10399 =item Element Types and Accessor Methods
10400
10401 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10402 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10403
10404 =item Initializing with C<new>
10405
10406 =back
10407
10408 =item EXAMPLES
10409
10410 Example 1, Example 2, Example 3
10411
10412 =item Author and Modification History
10413
10414 =back
10415
10416 =head2 Config - access Perl configuration information
10417
10418 =over 4
10419
10420 =item SYNOPSIS
10421
10422 =item DESCRIPTION
10423
10424 myconfig(), config_sh(), config_vars(@names)
10425
10426 =item EXAMPLE
10427
10428 =item WARNING
10429
10430 =item GLOSSARY
10431
10432 =over 4
10433
10434 =item _
10435
10436 C<_a>, C<_exe>, C<_o>
10437
10438 =item a
10439
10440 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10441 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10442 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10443 C<asctime_r_proto>, C<awk>
10444
10445 =item b
10446
10447 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10448
10449 =item c
10450
10451 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10452 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10453 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10454 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10455 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10456 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10457 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10458
10459 =item d
10460
10461 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10462 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10463 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10464 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10465 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10466 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10467 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10468 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10469 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10470 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10471 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10472 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10473 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10474 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10475 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10476 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10477 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10478 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10479 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10480 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10481 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10482 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10483 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10484 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10485 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10486 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10487 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10488 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10489 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10490 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10491 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10492 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10493 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10494 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10495 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10496 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10497 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10498 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10499 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10500 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10501 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10502 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10503 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10504 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10505 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10506 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10507 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10508 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10509 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10510 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10511 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10512 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10513 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10514 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10515 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10516 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10517 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10518 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10519 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10520 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10521 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10522 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10523 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10524 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10525 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10526 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10527 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10528 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10529 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10530 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10531 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10532 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10533 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10534 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10535 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10536 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10537 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10538 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10539 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10540 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10541 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10542 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10543 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10544 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10545 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10546 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10547 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10548 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10549 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10550 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10551
10552 =item e
10553
10554 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10555 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10556 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10557 C<expr>, C<extensions>, C<extras>
10558
10559 =item f
10560
10561 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10562 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10563 C<full_sed>
10564
10565 =item g
10566
10567 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10568 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10569 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10570 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10571 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10572 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10573 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10574 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10575 C<gmtime_r_proto>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
10576
10577 =item h
10578
10579 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10580
10581 =item i
10582
10583 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10584 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10585 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10586 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10587 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10588 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10589 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10590 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10591 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10592 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10593 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10594 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10595 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10596 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10597 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10598 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10599 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10600 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10601 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10602 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10603 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10604 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10605 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10606 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10607
10608 =item k
10609
10610 C<known_extensions>, C<ksh>
10611
10612 =item l
10613
10614 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10615 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10616 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10617 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10618 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10619 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10620 C<lseektype>
10621
10622 =item m
10623
10624 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10625 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10626 C<man3direxp>, C<man3ext>
10627
10628 =item M
10629
10630 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10631 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10632
10633 =item n
10634
10635 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10636 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10637 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10638 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10639 C<nvsize>, C<nvtype>
10640
10641 =item o
10642
10643 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10644 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10645
10646 =item p
10647
10648 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10649 C<perl>, C<perl_patchlevel>
10650
10651 =item P
10652
10653 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10654 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10655 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10656 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10657
10658 =item q
10659
10660 C<quadkind>, C<quadtype>
10661
10662 =item r
10663
10664 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10665 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10666 C<rmail>, C<run>, C<runnm>
10667
10668 =item s
10669
10670 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10671 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10672 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10673 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10674 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10675 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10676 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10677 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10678 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10679 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10680 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10681 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10682 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10683 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10684 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10685 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10686 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10687
10688 =item t
10689
10690 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10691 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10692 C<ttyname_r_proto>
10693
10694 =item u
10695
10696 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10697 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10698 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10699 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10700 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10701 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10702 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10703 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10704 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10705
10706 =item v
10707
10708 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10709 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10710 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10711 C<versiononly>, C<vi>, C<voidflags>
10712
10713 =item x
10714
10715 C<xlibpth>, C<xs_apiversion>
10716
10717 =item y
10718
10719 C<yacc>, C<yaccflags>
10720
10721 =item z
10722
10723 C<zcat>, C<zip>
10724
10725 =back
10726
10727 =item NOTE
10728
10729 =back
10730
10731 =head2 Cwd - get pathname of current working directory
10732
10733 =over 4
10734
10735 =item SYNOPSIS
10736
10737 =item DESCRIPTION
10738
10739 =over 4
10740
10741 =item getcwd and friends
10742
10743 getcwd, cwd, fastcwd, fastgetcwd
10744
10745 =item abs_path and friends
10746
10747 abs_path, realpath, fast_abs_path
10748
10749 =item $ENV{PWD}
10750
10751 =back
10752
10753 =item NOTES
10754
10755 =item SEE ALSO
10756
10757 =back
10758
10759 =head2 DB - programmatic interface to the Perl debugging API (draft,
10760 subject to
10761 change)
10762
10763 =over 4
10764
10765 =item SYNOPSIS
10766
10767 =item DESCRIPTION
10768
10769 =over 4
10770
10771 =item Global Variables
10772
10773  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
10774 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
10775 $DB::lineno
10776
10777 =item API Methods
10778
10779 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10780 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10781
10782 =item Client Callback Methods
10783
10784 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10785 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10786 CLIENT->output(LIST)
10787
10788 =back
10789
10790 =item BUGS
10791
10792 =item AUTHOR
10793
10794 =back
10795
10796 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10797
10798 =over 4
10799
10800 =item SYNOPSIS
10801
10802 =item DESCRIPTION
10803
10804 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10805
10806 =over 4
10807
10808 =item Using DB_File with Berkeley DB version 2 or greater
10809
10810 =item Interface to Berkeley DB
10811
10812 =item Opening a Berkeley DB Database File
10813
10814 =item Default Parameters
10815
10816 =item In Memory Databases
10817
10818 =back
10819
10820 =item DB_HASH
10821
10822 =over 4
10823
10824 =item A Simple Example
10825
10826 =back
10827
10828 =item DB_BTREE
10829
10830 =over 4
10831
10832 =item Changing the BTREE sort order
10833
10834 =item Handling Duplicate Keys
10835
10836 =item The get_dup() Method
10837
10838 =item The find_dup() Method
10839
10840 =item The del_dup() Method
10841
10842 =item Matching Partial Keys
10843
10844 =back
10845
10846 =item DB_RECNO
10847
10848 =over 4
10849
10850 =item The 'bval' Option
10851
10852 =item A Simple Example
10853
10854 =item Extra RECNO Methods
10855
10856 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10857 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10858 length, elements);>
10859
10860 =item Another Example
10861
10862 =back
10863
10864 =item THE API INTERFACE
10865
10866 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10867 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10868 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10869 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10870
10871 =item DBM FILTERS
10872
10873 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10874 B<filter_fetch_value>
10875
10876 =over 4
10877
10878 =item The Filter
10879
10880 =item An Example -- the NULL termination problem.
10881
10882 =item Another Example -- Key is a C int.
10883
10884 =back
10885
10886 =item HINTS AND TIPS
10887
10888 =over 4
10889
10890 =item Locking: The Trouble with fd
10891
10892 =item Safe ways to lock a database
10893
10894 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10895
10896 =item Sharing Databases With C Applications
10897
10898 =item The untie() Gotcha
10899
10900 =back
10901
10902 =item COMMON QUESTIONS
10903
10904 =over 4
10905
10906 =item Why is there Perl source in my database?
10907
10908 =item How do I store complex data structures with DB_File?
10909
10910 =item What does "Invalid Argument" mean?
10911
10912 =item What does "Bareword 'DB_File' not allowed" mean?
10913
10914 =back
10915
10916 =item REFERENCES
10917
10918 =item HISTORY
10919
10920 =item BUGS
10921
10922 =item AVAILABILITY
10923
10924 =item COPYRIGHT
10925
10926 =item SEE ALSO
10927
10928 =item AUTHOR
10929
10930 =back
10931
10932 =head2 Data::Dumper - stringified perl data structures, suitable for both
10933 printing and C<eval>
10934
10935 =over 4
10936
10937 =item SYNOPSIS
10938
10939 =item DESCRIPTION
10940
10941 =over 4
10942
10943 =item Methods
10944
10945 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
10946 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
10947 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
10948 I<$OBJ>->Reset
10949
10950 =item Functions
10951
10952 Dumper(I<LIST>)
10953
10954 =item Configuration Variables or Methods
10955
10956 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
10957 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
10958 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
10959 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
10960 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
10961 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
10962 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
10963 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
10964 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
10965 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
10966 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
10967 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
10968 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
10969 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
10970 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
10971
10972 =item Exports
10973
10974 Dumper
10975
10976 =back
10977
10978 =item EXAMPLES
10979
10980 =item BUGS
10981
10982 =item AUTHOR
10983
10984 =item VERSION
10985
10986 =item SEE ALSO
10987
10988 =back
10989
10990 =head2 Devel::DProf - a Perl code profiler
10991
10992 =over 4
10993
10994 =item SYNOPSIS
10995
10996 =item DESCRIPTION
10997
10998 =item PROFILE FORMAT
10999
11000 =item AUTOLOAD
11001
11002 =item ENVIRONMENT
11003
11004 =item BUGS
11005
11006 =item SEE ALSO
11007
11008 =back
11009
11010 =head2 Devel::PPPort, Perl/Pollution/Portability
11011
11012 =over 4
11013
11014 =item SYNOPSIS
11015
11016 =item DESCRIPTION
11017
11018 =over 4
11019
11020 =item WriteFile
11021
11022 =back
11023
11024 =item ppport.h
11025
11026 =item AUTHOR
11027
11028 =item SEE ALSO
11029
11030 =back
11031
11032 =head2 Devel::Peek - A data debugging tool for the XS programmer
11033
11034 =over 4
11035
11036 =item SYNOPSIS
11037
11038 =item DESCRIPTION
11039
11040 =over 4
11041
11042 =item Runtime debugging
11043
11044 =item Memory footprint debugging
11045
11046 =back
11047
11048 =item EXAMPLES
11049
11050 =over 4
11051
11052 =item A simple scalar string
11053
11054 =item A simple scalar number
11055
11056 =item A simple scalar with an extra reference
11057
11058 =item A reference to a simple scalar
11059
11060 =item A reference to an array
11061
11062 =item A reference to a hash
11063
11064 =item Dumping a large array or hash
11065
11066 =item A reference to an SV which holds a C pointer
11067
11068 =item A reference to a subroutine
11069
11070 =back
11071
11072 =item EXPORTS
11073
11074 =item BUGS
11075
11076 =item AUTHOR
11077
11078 =item SEE ALSO
11079
11080 =back
11081
11082 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11083
11084 =over 4
11085
11086 =item SYNOPSIS
11087
11088 =item DESCRIPTION
11089
11090 =back
11091
11092 =head2 Digest:: - Modules that calculate message digests
11093
11094 =over 4
11095
11096 =item SYNOPSIS
11097
11098 =item DESCRIPTION
11099
11100 I<binary>, I<hex>, I<base64>
11101
11102 =item OO INTERFACE
11103
11104 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11105 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11106 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11107
11108 =item SEE ALSO
11109
11110 =item AUTHOR
11111
11112 =back
11113
11114 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11115
11116 =over 4
11117
11118 =item SYNOPSIS
11119
11120 =item DESCRIPTION
11121
11122 =item FUNCTIONS
11123
11124 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11125
11126 =item METHODS
11127
11128 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11129 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11130
11131 =item EXAMPLES
11132
11133 =item SEE ALSO
11134
11135 =item COPYRIGHT
11136
11137 =item AUTHORS
11138
11139 =back
11140
11141 =head2 DirHandle - supply object methods for directory handles
11142
11143 =over 4
11144
11145 =item SYNOPSIS
11146
11147 =item DESCRIPTION
11148
11149 =item NOTES
11150
11151 =back
11152
11153 =head2 Dumpvalue - provides screen dump of Perl data.
11154
11155 =over 4
11156
11157 =item SYNOPSIS
11158
11159 =item DESCRIPTION
11160
11161 =over 4
11162
11163 =item Creation
11164
11165 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11166 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11167 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11168 stopDbSignal
11169
11170 =item Methods
11171
11172 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11173 compactDump, veryCompact, set, get
11174
11175 =back
11176
11177 =back
11178
11179 =head2 DynaLoader - Dynamically load C libraries into Perl code
11180
11181 =over 4
11182
11183 =item SYNOPSIS
11184
11185 =item DESCRIPTION
11186
11187 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11188 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11189 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11190 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11191 bootstrap()
11192
11193 =item AUTHOR
11194
11195 =back
11196
11197 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11198 Perl code
11199
11200 =over 4
11201
11202 =item SYNOPSIS
11203
11204 =item DESCRIPTION
11205
11206 =item AUTHOR
11207
11208 =back
11209
11210 =head2 Encode - character encodings
11211
11212 =over 4
11213
11214 =item SYNOPSIS
11215
11216 =over 4
11217
11218 =item Table of Contents
11219
11220 =back
11221
11222 =item DESCRIPTION
11223
11224 =over 4
11225
11226 =item TERMINOLOGY
11227
11228 =back
11229
11230 =item PERL ENCODING API
11231
11232 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11233 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11234 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11235 CHECK]);
11236
11237 =over 4
11238
11239 =item Listing available encodings
11240
11241 =item Defining Aliases
11242
11243 =back
11244
11245 =item Encoding via PerlIO
11246
11247 =item Handling Malformed Data
11248
11249 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11250 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11251 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11252 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11253 bitmask
11254
11255 =over 4
11256
11257 =item Unimplemented fallback schemes
11258
11259 =back
11260
11261 =item Defining Encodings
11262
11263 =item The UTF-8 flag
11264
11265 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11266
11267 =over 4
11268
11269 =item Messing with Perl's Internals
11270
11271 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11272
11273 =back
11274
11275 =item SEE ALSO
11276
11277 =item MAINTAINER
11278
11279 =back
11280
11281 =head2 Encode::Alias - alias definitions to encodings
11282
11283 =over 4
11284
11285 =item SYNOPSIS
11286
11287 =item DESCRIPTION
11288
11289 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11290 reference, e.g.:
11291
11292 =over 4
11293
11294 =item Alias overloading
11295
11296 =back
11297
11298 =item SEE ALSO
11299
11300 =back
11301
11302 =head2 Encode::Byte - Single Byte Encodings
11303
11304 =over 4
11305
11306 =item SYNOPSIS
11307
11308 =item ABSTRACT
11309
11310 =item DESCRIPTION
11311
11312 =item SEE ALSO
11313
11314 =back
11315
11316 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11317
11318 =head2 Encode::CN - China-based Chinese Encodings
11319
11320 =over 4
11321
11322 =item SYNOPSIS
11323
11324 =item DESCRIPTION
11325
11326 =item NOTES
11327
11328 =item BUGS
11329
11330 =item SEE ALSO
11331
11332 =back
11333
11334 =head2 Encode::CN::HZ -- internally used by Encode::CN
11335
11336 =head2 Encode::Config -- internally used by Encode
11337
11338 =head2 Encode::EBCDIC - EBCDIC Encodings
11339
11340 =over 4
11341
11342 =item SYNOPSIS
11343
11344 =item ABSTRACT
11345
11346 =item DESCRIPTION
11347
11348 =item SEE ALSO
11349
11350 =back
11351
11352 =head2 Encode::Encoding - Encode Implementation Base Class
11353
11354 =over 4
11355
11356 =item SYNOPSIS
11357
11358 =item DESCRIPTION
11359
11360 =over 4
11361
11362 =item Methods you should implement
11363
11364 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11365
11366 =item Other methods defined in Encode::Encodings
11367
11368 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11369
11370 =item Example: Encode::ROT13
11371
11372 =back
11373
11374 =item Why the heck Encode API is different?
11375
11376 =over 4
11377
11378 =item Compiled Encodings
11379
11380 =back
11381
11382 =item SEE ALSO
11383
11384 Scheme 1, Scheme 2, Other Schemes
11385
11386 =back
11387
11388 =head2 Encode::Guess -- Guesses encoding from data
11389
11390 =over 4
11391
11392 =item SYNOPSIS
11393
11394 =item ABSTRACT
11395
11396 =item DESCRIPTION
11397
11398 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11399 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11400 guess_encoding($data, [, I<list of suspects>])
11401
11402 =item CAVEATS
11403
11404 =item TO DO
11405
11406 =item SEE ALSO
11407
11408 =back
11409
11410 =head2 Encode::JP - Japanese Encodings
11411
11412 =over 4
11413
11414 =item SYNOPSIS
11415
11416 =item ABSTRACT
11417
11418 =item DESCRIPTION
11419
11420 =item Note on ISO-2022-JP(-1)?
11421
11422 =item BUGS
11423
11424 =item SEE ALSO
11425
11426 =back
11427
11428 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11429
11430 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11431
11432 =head2 Encode::KR - Korean Encodings
11433
11434 =over 4
11435
11436 =item SYNOPSIS
11437
11438 =item DESCRIPTION
11439
11440 =item BUGS
11441
11442 =item SEE ALSO
11443
11444 =back
11445
11446 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11447
11448 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11449
11450 =over 4
11451
11452 =item SYNOPSIS
11453
11454 =item ABSTRACT
11455
11456 =item DESCRIPTION
11457
11458 =item BUGS
11459
11460 =item SEE ALSO
11461
11462 =back
11463
11464 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11465
11466 =over 4
11467
11468 =item Overview
11469
11470 =item How does it work?
11471
11472 =item BUGS
11473
11474 =over 4
11475
11476 =item Workaround
11477
11478 =item How can I tell whether my encoding fully supports PerlIO ?
11479
11480 =back
11481
11482 =item SEE ALSO
11483
11484 =back
11485
11486 =head2 Encode::Supported -- Encodings supported by Encode
11487
11488 =over 4
11489
11490 =item DESCRIPTION
11491
11492 =over 4
11493
11494 =item Encoding Names
11495
11496 =back
11497
11498 =item Supported Encodings
11499
11500 =over 4
11501
11502 =item Built-in Encodings
11503
11504 =item Encode::Unicode -- other Unicode encodings
11505
11506 =item Encode::Byte -- Extended ASCII
11507
11508 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11509 the Cyrillic world, gsm0338 - Hentai Latin 1
11510
11511 =item CJK: Chinese, Japanese, Korean (Multibyte)
11512
11513 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11514 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11515 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11516
11517 =item Miscellaneous encodings
11518
11519 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11520
11521 =back
11522
11523 =item Unsupported encodings
11524
11525   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11526 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11527 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11528 Various Mac encodings, (Mac) Indic encodings
11529
11530 =item Encoding vs. Charset -- terminology
11531
11532 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11533
11534 =over 4
11535
11536 =item Microsoft-related naming mess
11537
11538 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11539
11540 =back
11541
11542 =item Glossary
11543
11544 character repertoire, coded character set (CCS), character encoding scheme
11545 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11546 UTF-16
11547
11548 =item See Also
11549
11550 =item References
11551
11552 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11553 RFC, UC, Unicode Glossary
11554
11555 =over 4
11556
11557 =item Other Notable Sites
11558
11559 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11560 "Introduction to i18n"
11561
11562 =item Offline sources
11563
11564 C<CJKV Information Processing> by Ken Lunde
11565
11566 =back
11567
11568 =back
11569
11570 =head2 Encode::Symbol - Symbol Encodings
11571
11572 =over 4
11573
11574 =item SYNOPSIS
11575
11576 =item ABSTRACT
11577
11578 =item DESCRIPTION
11579
11580 =item SEE ALSO
11581
11582 =back
11583
11584 =head2 Encode::TW - Taiwan-based Chinese Encodings
11585
11586 =over 4
11587
11588 =item SYNOPSIS
11589
11590 =item DESCRIPTION
11591
11592 =item NOTES
11593
11594 =item BUGS
11595
11596 =item SEE ALSO
11597
11598 =back
11599
11600 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11601
11602 =over 4
11603
11604 =item SYNOPSIS
11605
11606 =item ABSTRACT
11607
11608 L<http://www.unicode.org/glossary/> says:, Quick Reference
11609
11610 =item Size, Endianness, and BOM
11611
11612 =over 4
11613
11614 =item by size
11615
11616 =item by endianness
11617
11618 BOM as integer when fetched in network byte order
11619
11620 =back
11621
11622 =item Surrogate Pairs
11623
11624 =item SEE ALSO
11625
11626 =back
11627
11628 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11629 encodings
11630
11631 =over 4
11632
11633 =item SYNOPSIS
11634
11635 =item DESCRIPTION
11636
11637 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11638 reference, e.g.:
11639
11640 =over 4
11641
11642 =item Alias overloading
11643
11644 =back
11645
11646 =item SEE ALSO
11647
11648 =back
11649
11650 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11651 Internally used by Encode::??::ISO_2022_*
11652
11653 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11654 Encode::CN
11655
11656 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11657 Encode
11658
11659 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11660 Implementation Base Class
11661
11662 =over 4
11663
11664 =item SYNOPSIS
11665
11666 =item DESCRIPTION
11667
11668 =over 4
11669
11670 =item Methods you should implement
11671
11672 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11673
11674 =item Other methods defined in Encode::Encodings
11675
11676 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11677
11678 =item Example: Encode::ROT13
11679
11680 =back
11681
11682 =item Why the heck Encode API is different?
11683
11684 =over 4
11685
11686 =item Compiled Encodings
11687
11688 =back
11689
11690 =item SEE ALSO
11691
11692 Scheme 1, Scheme 2, Other Schemes
11693
11694 =back
11695
11696 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11697 data
11698
11699 =over 4
11700
11701 =item SYNOPSIS
11702
11703 =item ABSTRACT
11704
11705 =item DESCRIPTION
11706
11707 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11708 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11709 guess_encoding($data, [, I<list of suspects>])
11710
11711 =item CAVEATS
11712
11713 =item TO DO
11714
11715 =item SEE ALSO
11716
11717 =back
11718
11719 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11720 Encode::JP::2022_JP*
11721
11722 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11723 by Encode::JP
11724
11725 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11726 used by Encode::KR
11727
11728 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11729 and 'Q' header encoding
11730
11731 =over 4
11732
11733 =item SYNOPSIS
11734
11735 =item ABSTRACT
11736
11737 =item DESCRIPTION
11738
11739 =item BUGS
11740
11741 =item SEE ALSO
11742
11743 =back
11744
11745 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11746 on Encode and PerlIO
11747
11748 =over 4
11749
11750 =item Overview
11751
11752 =item How does it work?
11753
11754 =item BUGS
11755
11756 =over 4
11757
11758 =item Workaround
11759
11760 =item How can I tell whether my encoding fully supports PerlIO ?
11761
11762 =back
11763
11764 =item SEE ALSO
11765
11766 =back
11767
11768 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11769 supported by Encode
11770
11771 =over 4
11772
11773 =item DESCRIPTION
11774
11775 =over 4
11776
11777 =item Encoding Names
11778
11779 =back
11780
11781 =item Supported Encodings
11782
11783 =over 4
11784
11785 =item Built-in Encodings
11786
11787 =item Encode::Unicode -- other Unicode encodings
11788
11789 =item Encode::Byte -- Extended ASCII
11790
11791 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11792 the Cyrillic world, gsm0338 - Hentai Latin 1
11793
11794 =item CJK: Chinese, Japanese, Korean (Multibyte)
11795
11796 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11797 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11798 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11799
11800 =item Miscellaneous encodings
11801
11802 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11803
11804 =back
11805
11806 =item Unsupported encodings
11807
11808   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11809 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11810 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11811 Various Mac encodings, (Mac) Indic encodings
11812
11813 =item Encoding vs. Charset -- terminology
11814
11815 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11816
11817 =over 4
11818
11819 =item Microsoft-related naming mess
11820
11821 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11822
11823 =back
11824
11825 =item Glossary
11826
11827 character repertoire, coded character set (CCS), character encoding scheme
11828 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11829 UTF-16
11830
11831 =item See Also
11832
11833 =item References
11834
11835 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11836 RFC, UC, Unicode Glossary
11837
11838 =over 4
11839
11840 =item Other Notable Sites
11841
11842 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11843 "Introduction to i18n"
11844
11845 =item Offline sources
11846
11847 C<CJKV Information Processing> by Ken Lunde
11848
11849 =back
11850
11851 =back
11852
11853 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11854
11855 =over 4
11856
11857 =item SYNOPSIS
11858
11859   use Encode::Encoder;
11860   # Encode::encode("ISO-8859-1", $data);
11861   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11862   # shortcut
11863   use Encode::Encoder qw(encoder);
11864   encoder($data)->iso_8859_1;
11865   # you can stack them!
11866   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11867   # you can use it as a decoder as well
11868   encoder($base64)->bytes('base64')->latin1;
11869   # stringified
11870   print encoder($data)->utf8->latin1;  # prints the string in latin1
11871   # numified
11872   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11873
11874 =item ABSTRACT
11875
11876 =item Description
11877
11878 =over 4
11879
11880 =item Predefined Methods
11881
11882 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11883 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11884 $e-E<gt>bytes([$encoding])
11885
11886 =item Example: base64 transcoder
11887
11888 =item Operator Overloading
11889
11890 =back
11891
11892 =item SEE ALSO
11893
11894 =back
11895
11896 =head2 Encodencoding, encoding - allows you to write your script in
11897 non-ascii or non-utf8
11898
11899 =over 4
11900
11901 =item SYNOPSIS
11902
11903 =item ABSTRACT
11904
11905 =item USAGE
11906
11907 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11908 I<ENCNAME_IN> ...] ;, no encoding;
11909
11910 =item CAVEATS
11911
11912 =over 4
11913
11914 =item NOT SCOPED
11915
11916 =item DO NOT MIX MULTIPLE ENCODINGS
11917
11918 =back
11919
11920 =item Non-ASCII Identifiers and Filter option
11921
11922 use encoding I<ENCNAME> Filter=E<gt>1;
11923
11924 =item EXAMPLE - Greekperl
11925
11926 =item KNOWN PROBLEMS
11927
11928 =item SEE ALSO
11929
11930 =back
11931
11932 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
11933
11934 =over 4
11935
11936 =item SYNOPSIS
11937
11938   use Encode::Encoder;
11939   # Encode::encode("ISO-8859-1", $data);
11940   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11941   # shortcut
11942   use Encode::Encoder qw(encoder);
11943   encoder($data)->iso_8859_1;
11944   # you can stack them!
11945   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11946   # you can use it as a decoder as well
11947   encoder($base64)->bytes('base64')->latin1;
11948   # stringified
11949   print encoder($data)->utf8->latin1;  # prints the string in latin1
11950   # numified
11951   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11952
11953 =item ABSTRACT
11954
11955 =item Description
11956
11957 =over 4
11958
11959 =item Predefined Methods
11960
11961 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11962 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11963 $e-E<gt>bytes([$encoding])
11964
11965 =item Example: base64 transcoder
11966
11967 =item Operator Overloading
11968
11969 =back
11970
11971 =item SEE ALSO
11972
11973 =back
11974
11975 =head2 English - use nice English (or awk) names for ugly punctuation
11976 variables
11977
11978 =over 4
11979
11980 =item SYNOPSIS
11981
11982 =item DESCRIPTION
11983
11984 =item PERFORMANCE
11985
11986 =back
11987
11988 =head2 Env - perl module that imports environment variables as scalars or
11989 arrays
11990
11991 =over 4
11992
11993 =item SYNOPSIS
11994
11995 =item DESCRIPTION
11996
11997 =item LIMITATIONS
11998
11999 =item AUTHOR
12000
12001 =back
12002
12003 =head2 Errno - System errno constants
12004
12005 =over 4
12006
12007 =item SYNOPSIS
12008
12009 =item DESCRIPTION
12010
12011 =item CAVEATS
12012
12013 =item AUTHOR
12014
12015 =item COPYRIGHT
12016
12017 =back
12018
12019 =head2 Exporter - Implements default import method for modules
12020
12021 =over 4
12022
12023 =item SYNOPSIS
12024
12025 =item DESCRIPTION
12026
12027 =over 4
12028
12029 =item How to Export
12030
12031 =item Selecting What To Export
12032
12033 =item How to Import
12034
12035 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12036
12037 =back
12038
12039 =item Advanced features
12040
12041 =over 4
12042
12043 =item Specialised Import Lists
12044
12045 =item Exporting without using Exporter's import method
12046
12047 =item Module Version Checking
12048
12049 =item Managing Unknown Symbols
12050
12051 =item Tag Handling Utility Functions
12052
12053 =item Generating combined tags
12054
12055 =item C<AUTOLOAD>ed Constants
12056
12057 =back
12058
12059 =back
12060
12061 =head2 Exporter::Heavy - Exporter guts
12062
12063 =over 4
12064
12065 =item SYNOPSIS
12066
12067 =item DESCRIPTION
12068
12069 =back
12070
12071 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12072 Makefiles etc.
12073
12074 =over 4
12075
12076 =item SYNOPSIS
12077
12078 =item DESCRIPTION
12079
12080 =back
12081
12082 cat
12083
12084 eqtime src dst
12085
12086 rm_rf files...
12087
12088 rm_f files...
12089
12090 touch files ..
12091
12092 mv source... destination
12093
12094 cp source... destination
12095
12096 chmod mode files..
12097
12098 mkpath directory..
12099
12100 test_f file
12101
12102 =over 4
12103
12104 =item BUGS
12105
12106 =item SEE ALSO
12107
12108 =item AUTHOR
12109
12110 =back
12111
12112 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12113
12114 =over 4
12115
12116 =item SYNOPSIS
12117
12118 =item DESCRIPTION
12119
12120 B<test_harness>
12121
12122 =back
12123
12124 =head2 ExtUtils::Constant - generate XS code to import C header constants
12125
12126 =over 4
12127
12128 =item SYNOPSIS
12129
12130 =item DESCRIPTION
12131
12132 =item USAGE
12133
12134 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12135
12136 =item FUNCTIONS
12137
12138 =back
12139
12140 C_stringify NAME
12141
12142 perl_stringify NAME
12143
12144 constant_types
12145
12146 memEQ_clause NAME, CHECKED_AT, INDENT
12147
12148 assign INDENT, TYPE, PRE, POST, VALUE..
12149
12150 return_clause
12151
12152 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12153
12154 params WHAT
12155
12156 dump_names
12157
12158 dogfood
12159
12160 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12161 def_post, utf8
12162
12163 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12164
12165 autoload PACKAGE, VERSION, AUTOLOADER
12166
12167 WriteMakefileSnippet
12168
12169 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12170 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12171
12172 =over 4
12173
12174 =item AUTHOR
12175
12176 =back
12177
12178 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12179
12180 =over 4
12181
12182 =item SYNOPSIS
12183
12184 =item DESCRIPTION
12185
12186 =item @EXPORT
12187
12188 =item FUNCTIONS
12189
12190 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12191 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12192
12193 =item EXAMPLES
12194
12195 =item SEE ALSO
12196
12197 =item AUTHOR
12198
12199 =back
12200
12201 =head2 ExtUtils::Install - install files from here to there
12202
12203 =over 4
12204
12205 =item SYNOPSIS
12206
12207 =item DESCRIPTION
12208
12209 =back
12210
12211 =head2 ExtUtils::Installed - Inventory management of installed modules
12212
12213 =over 4
12214
12215 =item SYNOPSIS
12216
12217 =item DESCRIPTION
12218
12219 =item USAGE
12220
12221 =item FUNCTIONS
12222
12223 new(), modules(), files(), directories(), directory_tree(), validate(),
12224 packlist(), version()
12225
12226 =item EXAMPLE
12227
12228 =item AUTHOR
12229
12230 =back
12231
12232 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12233
12234 =over 4
12235
12236 =item SYNOPSIS
12237
12238 =item DESCRIPTION
12239
12240 For static extensions, For dynamic extensions at build/link time, For
12241 dynamic extensions at load time
12242
12243 =over 4
12244
12245 =item EXTRALIBS
12246
12247 =item LDLOADLIBS and LD_RUN_PATH
12248
12249 =item BSLOADLIBS
12250
12251 =back
12252
12253 =item PORTABILITY
12254
12255 =over 4
12256
12257 =item VMS implementation
12258
12259 =item Win32 implementation
12260
12261 =back
12262
12263 =item SEE ALSO
12264
12265 =back
12266
12267 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12268
12269 =over 4
12270
12271 =item SYNOPSIS
12272
12273 =item DESCRIPTION
12274
12275 =back
12276
12277 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12278
12279 =over 4
12280
12281 =item SYNOPSIS
12282
12283 =item DESCRIPTION
12284
12285 =item Inherently Cross-Platform Methods
12286
12287 =over 4
12288
12289 =item File::Spec wrappers  B<DEPRECATED>
12290
12291 canonpath
12292
12293 =back
12294
12295 =back
12296
12297 catdir
12298
12299 catfile
12300
12301 curdir
12302
12303 file_name_is_absolute
12304
12305 path
12306
12307 rootdir
12308
12309 updir
12310
12311 =over 4
12312
12313 =item Thought To Be Cross-Platform Methods
12314
12315 test_via_harness
12316
12317 =back
12318
12319 test_via_script
12320
12321 =over 4
12322
12323 =item AUTHOR
12324
12325 =back
12326
12327 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12328 ExtUtils::MakeMaker
12329
12330 =over 4
12331
12332 =item SYNOPSIS
12333
12334 =item DESCRIPTION
12335
12336 =back
12337
12338 perl_archive
12339
12340 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12341 ExtUtils::MakeMaker
12342
12343 =over 4
12344
12345 =item SYNOPSIS
12346
12347 =item DESCRIPTION
12348
12349 canonpath, cflags, manifypods, perl_archive
12350
12351 =back
12352
12353 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12354
12355 =over 4
12356
12357 =item SYNOPSIS
12358
12359 =item DESCRIPTION
12360
12361 =over 4
12362
12363 =item Overridden methods
12364
12365 B<replace_manpage_separator>
12366
12367 =back
12368
12369 =back
12370
12371 =over 4
12372
12373 =item AUTHOR
12374
12375 =item SEE ALSO
12376
12377 =back
12378
12379 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12380 ExtUtils::MakeMaker
12381
12382 =over 4
12383
12384 =item SYNOPSIS
12385
12386 =item DESCRIPTION
12387
12388 =back
12389
12390 maybe_command
12391
12392 guess_name
12393
12394 macify
12395
12396 patternify
12397
12398 init_main
12399
12400 init_others
12401
12402 init_dirscan
12403
12404 libscan (o)
12405
12406 constants (o)
12407
12408 static (o)
12409
12410 dlsyms (o)
12411
12412 dynamic (o)
12413
12414 clean (o)
12415
12416 realclean (o)
12417
12418 rulez (o)
12419
12420 processPL (o)
12421
12422 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12423 ExtUtils::MakeMaker
12424
12425 =over 4
12426
12427 =item SYNOPSIS
12428
12429 =item DESCRIPTION
12430
12431 =back
12432
12433 constants (o)
12434
12435 static_lib (o)
12436
12437 dynamic_lib (o)
12438
12439 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12440 ExtUtils::MakeMaker
12441
12442 =over 4
12443
12444 =item SYNOPSIS
12445
12446 =item DESCRIPTION
12447
12448 =item METHODS
12449
12450 =back
12451
12452 perl_archive_after
12453
12454 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12455
12456 =over 4
12457
12458 =item SYNOPSIS
12459
12460 =item DESCRIPTION
12461
12462 =over 4
12463
12464 =item Overridden methods
12465
12466 B<replace_manpage_separator>
12467
12468 =back
12469
12470 =back
12471
12472 =over 4
12473
12474 =item AUTHOR
12475
12476 =item SEE ALSO
12477
12478 =back
12479
12480 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12481
12482 =over 4
12483
12484 =item SYNOPSIS
12485
12486 =item DESCRIPTION
12487
12488 =item METHODS
12489
12490 =back
12491
12492 =over 4
12493
12494 =item SelfLoaded methods
12495
12496 c_o (o)
12497
12498 =back
12499
12500 cflags (o)
12501
12502 clean (o)
12503
12504 const_cccmd (o)
12505
12506 const_config (o)
12507
12508 const_loadlibs (o)
12509
12510 constants (o)
12511
12512 depend (o)
12513
12514 dir_target (o)
12515
12516 dist (o)
12517
12518 dist_basics (o)
12519
12520 dist_ci (o)
12521
12522 dist_core (o)
12523
12524 dist_dir
12525
12526 dist_test
12527
12528 dlsyms (o)
12529
12530 dynamic (o)
12531
12532 dynamic_bs (o)
12533
12534 dynamic_lib (o)
12535
12536 exescan
12537
12538 extliblist
12539
12540 find_perl
12541
12542 find_tests
12543
12544 =over 4
12545
12546 =item Methods to actually produce chunks of text for the Makefile
12547
12548 fixin
12549
12550 =back
12551
12552 force (o)
12553
12554 guess_name
12555
12556 has_link_code
12557
12558 init_dirscan
12559
12560 init_main
12561
12562 init_others
12563
12564 init_INST
12565
12566 init_INSTALL
12567
12568 init_lib2arch
12569
12570 init_PERL
12571
12572 init_PERM
12573
12574 install (o)
12575
12576 installbin (o)
12577
12578 libscan (o)
12579
12580 linkext (o)
12581
12582 lsdir
12583
12584 macro (o)
12585
12586 makeaperl (o)
12587
12588 makefile (o)
12589
12590 manifypods (o)
12591
12592 maybe_command
12593
12594 maybe_command_in_dirs
12595
12596 needs_linking (o)
12597
12598 nicetext
12599
12600 parse_abstract
12601
12602 parse_version
12603
12604 pasthru (o)
12605
12606 perl_script
12607
12608 perldepend (o)
12609
12610 perm_rw (o)
12611
12612 perm_rwx (o)
12613
12614 pm_to_blib
12615
12616 post_constants (o)
12617
12618 post_initialize (o)
12619
12620 postamble (o)
12621
12622 ppd
12623
12624 prefixify
12625
12626 processPL (o)
12627
12628 quote_paren
12629
12630 realclean (o)
12631
12632 replace_manpage_separator
12633
12634 static (o)
12635
12636 static_lib (o)
12637
12638 staticmake (o)
12639
12640 subdir_x (o)
12641
12642 subdirs (o)
12643
12644 test (o)
12645
12646 test_via_harness (override)
12647
12648 test_via_script (override)
12649
12650 tool_autosplit (o)
12651
12652 tools_other (o)
12653
12654 tool_xsubpp (o)
12655
12656 top_targets (o)
12657
12658 writedoc
12659
12660 xs_c (o)
12661
12662 xs_cpp (o)
12663
12664 xs_o (o)
12665
12666 perl_archive
12667
12668 perl_archive_after
12669
12670 export_list
12671
12672 =over 4
12673
12674 =item SEE ALSO
12675
12676 =back
12677
12678 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12679 ExtUtils::MakeMaker
12680
12681 =over 4
12682
12683 =item SYNOPSIS
12684
12685 =item DESCRIPTION
12686
12687 =over 4
12688
12689 =item Methods always loaded
12690
12691 wraplist
12692
12693 =back
12694
12695 =back
12696
12697 =over 4
12698
12699 =item Methods
12700
12701 guess_name (override)
12702
12703 =back
12704
12705 find_perl (override)
12706
12707 maybe_command (override)
12708
12709 maybe_command_in_dirs (override)
12710
12711 perl_script (override)
12712
12713 replace_manpage_separator
12714
12715 init_main (override)
12716
12717 init_others (override)
12718
12719 constants (override)
12720
12721 cflags (override)
12722
12723 const_cccmd (override)
12724
12725 pm_to_blib (override)
12726
12727 tool_autosplit (override)
12728
12729 tool_sxubpp (override)
12730
12731 xsubpp_version (override)
12732
12733 tools_other (override)
12734
12735 dist (override)
12736
12737 c_o (override)
12738
12739 xs_c (override)
12740
12741 xs_o (override)
12742
12743 top_targets (override)
12744
12745 dlsyms (override)
12746
12747 dynamic_lib (override)
12748
12749 dynamic_bs (override)
12750
12751 static_lib (override)
12752
12753 manifypods (override)
12754
12755 processPL (override)
12756
12757 installbin (override)
12758
12759 subdir_x (override)
12760
12761 clean (override)
12762
12763 realclean (override)
12764
12765 dist_core (override)
12766
12767 dist_test (override)
12768
12769 install (override)
12770
12771 perldepend (override)
12772
12773 makefile (override)
12774
12775 find_tests (override)
12776
12777 test (override)
12778
12779 makeaperl (override)
12780
12781 nicetext (override)
12782
12783 prefixify (override)
12784
12785 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12786 ExtUtils::MakeMaker
12787
12788 =over 4
12789
12790 =item SYNOPSIS
12791
12792 =item DESCRIPTION
12793
12794 =back
12795
12796 constants (o)
12797
12798 static_lib (o)
12799
12800 dynamic_bs (o)
12801
12802 dynamic_lib (o)
12803
12804 perl_script
12805
12806 pm_to_blib
12807
12808 tool_autosplit (override)
12809
12810 tools_other (o)
12811
12812 xs_o (o)
12813
12814 top_targets (o)
12815
12816 manifypods (o)
12817
12818 dist_ci (o)
12819
12820 dist_core (o)
12821
12822 pasthru (o)
12823
12824 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12825
12826 =over 4
12827
12828 =item SYNOPSIS
12829
12830 =item DESCRIPTION
12831
12832 =back
12833
12834 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12835
12836 =over 4
12837
12838 =item SYNOPSIS
12839
12840 =item DESCRIPTION
12841
12842 =back
12843
12844 =head2 ExtUtils::MakeMaker - create an extension Makefile
12845
12846 =over 4
12847
12848 =item SYNOPSIS
12849
12850 =item DESCRIPTION
12851
12852 =over 4
12853
12854 =item How To Write A Makefile.PL
12855
12856 =item Default Makefile Behaviour
12857
12858 =item make test
12859
12860 =item make testdb
12861
12862 =item make install
12863
12864 =item PREFIX and LIB attribute
12865
12866 =item AFS users
12867
12868 =item Static Linking of a new Perl Binary
12869
12870 =item Determination of Perl Library and Installation Locations
12871
12872 =item Which architecture dependent directory?
12873
12874 =item Using Attributes and Parameters
12875
12876 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12877 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12878 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12879 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12880 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12881 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12882 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12883 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12884 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
12885 LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
12886 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
12887 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
12888 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
12889 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
12890 PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
12891 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
12892 XSPROTOARG, XS_VERSION
12893
12894 =item Additional lowercase attributes
12895
12896 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12897 tool_autosplit
12898
12899 =item Overriding MakeMaker Methods
12900
12901 =item Hintsfile support
12902
12903 =item Distribution Support
12904
12905    make distcheck,    make skipcheck,    make distclean,    make manifest,
12906   make distdir,   make disttest,    make tardist,    make dist,    make
12907 uutardist,    make shdist,    make zipdist,    make ci
12908
12909 =item Disabling an extension
12910
12911 =back
12912
12913 =item ENVIRONMENT
12914
12915 PERL_MM_OPT, PERL_MM_USE_DEFAULT
12916
12917 =item SEE ALSO
12918
12919 =item AUTHORS
12920
12921 =back
12922
12923 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
12924
12925 =over 4
12926
12927 =item SYNOPSIS
12928
12929 =item DESCRIPTION
12930
12931 =item MANIFEST.SKIP
12932
12933 =item EXPORT_OK
12934
12935 =item GLOBAL VARIABLES
12936
12937 =item DIAGNOSTICS
12938
12939 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
12940 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
12941
12942 =item ENVIRONMENT
12943
12944 B<PERL_MM_MANIFEST_DEBUG>
12945
12946 =item SEE ALSO
12947
12948 =item AUTHOR
12949
12950 =back
12951
12952 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
12953
12954 =over 4
12955
12956 =item SYNOPSIS
12957
12958 =item DESCRIPTION
12959
12960 =item SEE ALSO
12961
12962 =back
12963
12964 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
12965
12966 =over 4
12967
12968 =item SYNOPSIS
12969
12970 =item DESCRIPTION
12971
12972 =back
12973
12974 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
12975 extension
12976
12977 =over 4
12978
12979 =item SYNOPSIS
12980
12981 =item DESCRIPTION
12982
12983 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
12984
12985 =item AUTHOR
12986
12987 =item REVISION
12988
12989 =back
12990
12991 =head2 ExtUtils::Packlist - manage .packlist files
12992
12993 =over 4
12994
12995 =item SYNOPSIS
12996
12997 =item DESCRIPTION
12998
12999 =item USAGE
13000
13001 =item FUNCTIONS
13002
13003 new(), read(), write(), validate(), packlist_file()
13004
13005 =item EXAMPLE
13006
13007 =item AUTHOR
13008
13009 =back
13010
13011 =head2 ExtUtils::testlib - add blib/* directories to @INC
13012
13013 =over 4
13014
13015 =item SYNOPSIS
13016
13017 =item DESCRIPTION
13018
13019 =back
13020
13021 =head2 Fatal - replace functions with equivalents which succeed or die
13022
13023 =over 4
13024
13025 =item SYNOPSIS
13026
13027 =item DESCRIPTION
13028
13029 =item AUTHOR
13030
13031 =back
13032
13033 =head2 Fcntl - load the C Fcntl.h defines
13034
13035 =over 4
13036
13037 =item SYNOPSIS
13038
13039 =item DESCRIPTION
13040
13041 =item NOTE
13042
13043 =item EXPORTED SYMBOLS
13044
13045 =back
13046
13047 =head2 File::Basename, fileparse - split a pathname into pieces
13048
13049 =over 4
13050
13051 =item SYNOPSIS
13052
13053 =item DESCRIPTION
13054
13055 fileparse_set_fstype, fileparse
13056
13057 =item EXAMPLES
13058
13059 C<basename>, C<dirname>
13060
13061 =back
13062
13063 =head2 File::CheckTree, validate - run many filetest checks on a tree
13064
13065 =over 4
13066
13067 =item SYNOPSIS
13068
13069 =item DESCRIPTION
13070
13071 =item AUTHOR
13072
13073 =item HISTORY
13074
13075 =back
13076
13077 =head2 File::Compare - Compare files or filehandles
13078
13079 =over 4
13080
13081 =item SYNOPSIS
13082
13083 =item DESCRIPTION
13084
13085 =item RETURN
13086
13087 =item AUTHOR
13088
13089 =back
13090
13091 =head2 File::Copy - Copy files or filehandles
13092
13093 =over 4
13094
13095 =item SYNOPSIS
13096
13097 =item DESCRIPTION
13098
13099 =over 4
13100
13101 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13102
13103 rmscopy($from,$to[,$date_flag])
13104
13105 =back
13106
13107 =item RETURN
13108
13109 =item NOTES
13110
13111 =item AUTHOR
13112
13113 =back
13114
13115 =head2 File::DosGlob - DOS like globbing and then some
13116
13117 =over 4
13118
13119 =item SYNOPSIS
13120
13121 =item DESCRIPTION
13122
13123 =item NOTES
13124
13125 =item EXPORTS (by request only)
13126
13127 =item BUGS
13128
13129 =item AUTHOR
13130
13131 =item HISTORY
13132
13133 =item SEE ALSO
13134
13135 =back
13136
13137 =head2 File::Find - Traverse a directory tree.
13138
13139 =over 4
13140
13141 =item SYNOPSIS
13142
13143 =item DESCRIPTION
13144
13145 B<find>, B<finddepth>
13146
13147 =over 4
13148
13149 =item %options
13150
13151 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13152 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13153 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13154
13155 =item The wanted function
13156
13157 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13158 filename within that directory, C<$File::Find::name> is the complete
13159 pathname to the file
13160
13161 =back
13162
13163 =item WARNINGS
13164
13165 =item CAVEAT
13166
13167 $dont_use_nlink, symlinks
13168
13169 =item NOTES
13170
13171 =item HISTORY
13172
13173 =back
13174
13175 =head2 File::Glob - Perl extension for BSD glob routine
13176
13177 =over 4
13178
13179 =item SYNOPSIS
13180
13181 =item DESCRIPTION
13182
13183 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13184 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13185 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13186
13187 =item DIAGNOSTICS
13188
13189 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13190
13191 =item NOTES
13192
13193 =item AUTHOR
13194
13195 =back
13196
13197 =head2 File::Path - create or remove directory trees
13198
13199 =over 4
13200
13201 =item SYNOPSIS
13202
13203 =item DESCRIPTION
13204
13205 =item AUTHORS
13206
13207 =back
13208
13209 =head2 File::Spec - portably perform operations on file names
13210
13211 =over 4
13212
13213 =item SYNOPSIS
13214
13215 =item DESCRIPTION
13216
13217 =item METHODS
13218
13219 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13220 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13221 splitdir, catpath(), abs2rel, rel2abs()
13222
13223 =item SEE ALSO
13224
13225 =item AUTHORS
13226
13227 =back
13228
13229 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13230
13231 =over 4
13232
13233 =item SYNOPSIS
13234
13235 =item DESCRIPTION
13236
13237 =back
13238
13239 =head2 File::Spec::Epoc - methods for Epoc file specs
13240
13241 =over 4
13242
13243 =item SYNOPSIS
13244
13245 =item DESCRIPTION
13246
13247 canonpath()
13248
13249 =back
13250
13251 =over 4
13252
13253 =item SEE ALSO
13254
13255 =back
13256
13257 =head2 File::Spec::Functions - portably perform operations on file names
13258
13259 =over 4
13260
13261 =item SYNOPSIS
13262
13263 =item DESCRIPTION
13264
13265 =over 4
13266
13267 =item Exports
13268
13269 =back
13270
13271 =item SEE ALSO
13272
13273 =back
13274
13275 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13276
13277 =over 4
13278
13279 =item SYNOPSIS
13280
13281 =item DESCRIPTION
13282
13283 =item METHODS
13284
13285 canonpath
13286
13287 =back
13288
13289 catdir()
13290
13291 catfile
13292
13293 curdir
13294
13295 devnull
13296
13297 rootdir
13298
13299 tmpdir
13300
13301 updir
13302
13303 file_name_is_absolute
13304
13305 path
13306
13307 splitpath
13308
13309 splitdir
13310
13311 catpath
13312
13313 abs2rel
13314
13315 rel2abs
13316
13317 =over 4
13318
13319 =item AUTHORS
13320
13321 =item SEE ALSO
13322
13323 =back
13324
13325 canonpath
13326
13327 splitpath
13328
13329 splitdir
13330
13331 catpath
13332
13333 =head2 File::Spec::OS2 - methods for OS/2 file specs
13334
13335 =over 4
13336
13337 =item SYNOPSIS
13338
13339 =item DESCRIPTION
13340
13341 =back
13342
13343 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13344 modules
13345
13346 =over 4
13347
13348 =item SYNOPSIS
13349
13350 =item DESCRIPTION
13351
13352 =item METHODS
13353
13354 canonpath()
13355
13356 =back
13357
13358 catdir()
13359
13360 catfile
13361
13362 curdir
13363
13364 devnull
13365
13366 rootdir
13367
13368 tmpdir
13369
13370 updir
13371
13372 no_upwards
13373
13374 case_tolerant
13375
13376 file_name_is_absolute
13377
13378 path
13379
13380 join
13381
13382 splitpath
13383
13384 splitdir
13385
13386 catpath()
13387
13388 abs2rel
13389
13390 rel2abs()
13391
13392 =over 4
13393
13394 =item SEE ALSO
13395
13396 =back
13397
13398 =head2 File::Spec::VMS - methods for VMS file specs
13399
13400 =over 4
13401
13402 =item SYNOPSIS
13403
13404 =item DESCRIPTION
13405
13406 eliminate_macros
13407
13408 =back
13409
13410 fixpath
13411
13412 =over 4
13413
13414 =item Methods always loaded
13415
13416 canonpath (override)
13417
13418 =back
13419
13420 catdir
13421
13422 catfile
13423
13424 curdir (override)
13425
13426 devnull (override)
13427
13428 rootdir (override)
13429
13430 tmpdir (override)
13431
13432 updir (override)
13433
13434 case_tolerant (override)
13435
13436 path (override)
13437
13438 file_name_is_absolute (override)
13439
13440 splitpath (override)
13441
13442 splitdir (override)
13443
13444 catpath (override)
13445
13446 abs2rel (override)
13447
13448 rel2abs (override)
13449
13450 =over 4
13451
13452 =item SEE ALSO
13453
13454 =back
13455
13456 =head2 File::Spec::Win32 - methods for Win32 file specs
13457
13458 =over 4
13459
13460 =item SYNOPSIS
13461
13462 =item DESCRIPTION
13463
13464 devnull
13465
13466 =back
13467
13468 tmpdir
13469
13470 catfile
13471
13472 canonpath
13473
13474 splitpath
13475
13476 splitdir
13477
13478 catpath
13479
13480 =over 4
13481
13482 =item SEE ALSO
13483
13484 =back
13485
13486 =head2 File::Temp - return name and handle of a temporary file safely
13487
13488 =over 4
13489
13490 =item PORTABILITY
13491
13492 =item SYNOPSIS
13493
13494 =item DESCRIPTION
13495
13496 =back
13497
13498 =over 4
13499
13500 =item FUNCTIONS
13501
13502 B<tempfile>
13503
13504 =back
13505
13506 B<tempdir>
13507
13508 =over 4
13509
13510 =item MKTEMP FUNCTIONS
13511
13512 B<mkstemp>
13513
13514 =back
13515
13516 B<mkstemps>
13517
13518 B<mkdtemp>
13519
13520 B<mktemp>
13521
13522 =over 4
13523
13524 =item POSIX FUNCTIONS
13525
13526 B<tmpnam>
13527
13528 =back
13529
13530 B<tmpfile>
13531
13532 =over 4
13533
13534 =item ADDITIONAL FUNCTIONS
13535
13536 B<tempnam>
13537
13538 =back
13539
13540 =over 4
13541
13542 =item UTILITY FUNCTIONS
13543
13544 B<unlink0>
13545
13546 =back
13547
13548 =over 4
13549
13550 =item PACKAGE VARIABLES
13551
13552 B<safe_level>, STANDARD, MEDIUM, HIGH
13553
13554 =back
13555
13556 TopSystemUID
13557
13558 =over 4
13559
13560 =item WARNING
13561
13562 =over 4
13563
13564 =item Temporary files and NFS
13565
13566 =back
13567
13568 =item HISTORY
13569
13570 =item SEE ALSO
13571
13572 =item AUTHOR
13573
13574 =back
13575
13576 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13577
13578 =over 4
13579
13580 =item SYNOPSIS
13581
13582 =item DESCRIPTION
13583
13584 =item NOTE
13585
13586 =item AUTHOR
13587
13588 =back
13589
13590 =head2 FileCache - keep more files open than the system permits
13591
13592 =over 4
13593
13594 =item SYNOPSIS
13595
13596 =item DESCRIPTION
13597
13598 cacheout EXPR, cacheout MODE, EXPR
13599
13600 =item CAVEATS
13601
13602 =item BUGS
13603
13604 =back
13605
13606 =head2 FileHandle - supply object methods for filehandles
13607
13608 =over 4
13609
13610 =item SYNOPSIS
13611
13612 =item DESCRIPTION
13613
13614 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13615
13616 =item SEE ALSO
13617
13618 =back
13619
13620 =head2 Filter::Simple - Simplified source filtering
13621
13622 =over 4
13623
13624 =item SYNOPSIS
13625
13626 =item DESCRIPTION
13627
13628 =over 4
13629
13630 =item The Problem
13631
13632 =item A Solution
13633
13634 =item Disabling or changing <no> behaviour
13635
13636 =item All-in-one interface
13637
13638 =item Filtering only specific components of source code
13639
13640 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13641 C<"all">
13642
13643 =item Filtering only the code parts of source code
13644
13645 Most source code ceases to be grammatically correct when it is broken up
13646 into the pieces between string literals and regexes. So the C<'code'>
13647 component filter behaves slightly differently from the other partial
13648 filters
13649 described in the previous section.
13650
13651 =item Using Filter::Simple with an explicit C<import> subroutine
13652
13653 =item Using Filter::Simple and Exporter together
13654
13655 =item How it works
13656
13657 =back
13658
13659 =item AUTHOR
13660
13661 =item COPYRIGHT
13662
13663 =back
13664
13665 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13666
13667 =over 4
13668
13669 =item SYNOPSIS
13670
13671 =item DESCRIPTION
13672
13673 =over 4
13674
13675 =item B<use Filter::Util::Call>
13676
13677 =item B<import()>
13678
13679 =item B<filter() and anonymous sub>
13680
13681 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13682
13683 =back
13684
13685 =item EXAMPLES
13686
13687 =over 4
13688
13689 =item Example 1: A simple filter.
13690
13691 =item Example 2: Using the context
13692
13693 =item Example 3: Using the context within the filter
13694
13695 =item Example 4: Using filter_del
13696
13697 =back
13698
13699 =item Filter::Simple
13700
13701 =item AUTHOR
13702
13703 =item DATE
13704
13705 =back
13706
13707 =head2 FindBin - Locate directory of original perl script
13708
13709 =over 4
13710
13711 =item SYNOPSIS
13712
13713 =item DESCRIPTION
13714
13715 =item EXPORTABLE VARIABLES
13716
13717 =item KNOWN ISSUES
13718
13719 =item KNOWN BUGS
13720
13721 =item AUTHORS
13722
13723 =item COPYRIGHT
13724
13725 =back
13726
13727 =head2 GDBM_File - Perl5 access to the gdbm library.
13728
13729 =over 4
13730
13731 =item SYNOPSIS
13732
13733 =item DESCRIPTION
13734
13735 =item AVAILABILITY
13736
13737 =item BUGS
13738
13739 =item SEE ALSO
13740
13741 =back
13742
13743 =head2 Getopt::Long - Extended processing of command line options
13744
13745 =over 4
13746
13747 =item SYNOPSIS
13748
13749 =item DESCRIPTION
13750
13751 =item Command Line Options, an Introduction
13752
13753 =item Getting Started with Getopt::Long
13754
13755 =over 4
13756
13757 =item Simple options
13758
13759 =item A little bit less simple options
13760
13761 =item Mixing command line option with other arguments
13762
13763 =item Options with values
13764
13765 =item Options with multiple values
13766
13767 =item Options with hash values
13768
13769 =item User-defined subroutines to handle options
13770
13771 =item Options with multiple names
13772
13773 =item Case and abbreviations
13774
13775 =item Summary of Option Specifications
13776
13777 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13778 + [ I<desttype> ]
13779
13780 =back
13781
13782 =item Advanced Possibilities
13783
13784 =over 4
13785
13786 =item Object oriented interface
13787
13788 =item Documentation and help texts
13789
13790 =item Storing options in a hash
13791
13792 =item Bundling
13793
13794 =item The lonesome dash
13795
13796 =item Argument callback
13797
13798 =back
13799
13800 =item Configuring Getopt::Long
13801
13802 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13803 require_order, permute, bundling (default: disabled), bundling_override
13804 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13805 (default: disabled), pass_through (default: disabled), prefix,
13806 prefix_pattern, debug (default: disabled)
13807
13808 =item Return values and Errors
13809
13810 =item Legacy
13811
13812 =over 4
13813
13814 =item Default destinations
13815
13816 =item Alternative option starters
13817
13818 =item Configuration variables
13819
13820 =back
13821
13822 =item Trouble Shooting
13823
13824 =over 4
13825
13826 =item Warning: Ignoring '!' modifier for short option
13827
13828 =item GetOptions does not return a false result when an option is not
13829 supplied
13830
13831 =item GetOptions does not split the command line correctly
13832
13833 =item How do I put a "-?" option into a Getopt::Long?
13834
13835 =back
13836
13837 =item AUTHOR
13838
13839 =item COPYRIGHT AND DISCLAIMER
13840
13841 =back
13842
13843 =head2 Getopt::Std, getopt - Process single-character switches with switch
13844 clustering
13845
13846 =over 4
13847
13848 =item SYNOPSIS
13849
13850 =item DESCRIPTION
13851
13852 =back
13853
13854 =head2 Hash::Util - A selection of general-utility hash subroutines
13855
13856 =over 4
13857
13858 =item SYNOPSIS
13859
13860 =item DESCRIPTION
13861
13862 =over 4
13863
13864 =item Restricted hashes
13865
13866 lock_keys, unlock_keys
13867
13868 =back
13869
13870 =back
13871
13872 lock_value, unlock_value
13873
13874 B<lock_hash>, B<unlock_hash>
13875
13876 =over 4
13877
13878 =item AUTHOR
13879
13880 =item SEE ALSO
13881
13882 =back
13883
13884 =head2 I18N::Collate - compare 8-bit scalar data according to the current
13885 locale
13886
13887 =over 4
13888
13889 =item SYNOPSIS
13890
13891 =item DESCRIPTION
13892
13893 =back
13894
13895 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
13896 tags
13897
13898 =over 4
13899
13900 =item SYNOPSIS
13901
13902 =item DESCRIPTION
13903
13904 =back
13905
13906 the function is_language_tag($lang1)
13907
13908 the function extract_language_tags($whatever)
13909
13910 the function same_language_tag($lang1, $lang2)
13911
13912 the function similarity_language_tag($lang1, $lang2)
13913
13914 the function is_dialect_of($lang1, $lang2)
13915
13916 the function super_languages($lang1)
13917
13918 the function locale2language_tag($locale_identifier)
13919
13920 the function encode_language_tag($lang1)
13921
13922 the function alternate_language_tags($lang1)
13923
13924 the function @langs = panic_languages(@accept_languages)
13925
13926 =over 4
13927
13928 =item ABOUT LOWERCASING
13929
13930 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
13931
13932 =item SEE ALSO
13933
13934 =item COPYRIGHT
13935
13936 =item AUTHOR
13937
13938 =back
13939
13940 =head2 I18N::LangTags::List -- tags and names for human languages
13941
13942 =over 4
13943
13944 =item SYNOPSIS
13945
13946 =item DESCRIPTION
13947
13948 =item ABOUT LANGUAGE TAGS
13949
13950 =item LIST OF LANGUAGES
13951
13952 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
13953 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
13954 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
13955 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
13956 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
13957 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
13958 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
13959 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
13960 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
13961 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
13962 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
13963 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
13964 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
13965 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
13966 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
13967 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
13968 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
13969 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
13970 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
13971 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
13972 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
13973 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
13974 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
13975 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
13976 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
13977 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
13978 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
13979 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
13980 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
13981 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
13982 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
13983 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
13984 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
13985 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
13986 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
13987 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
13988 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
13989 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
13990 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
13991 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
13992 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
13993 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
13994 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
13995 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
13996 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
13997 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
13998 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
13999 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14000 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14001 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14002 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14003 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14004 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14005 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14006 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14007 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14008 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14009 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14010 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14011 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14012 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14013 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14014 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14015 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14016 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14017 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14018 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14019 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14020 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14021 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14022 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14023 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14024 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14025 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14026 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14027 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14028 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14029 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14030 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14031 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14032 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14033 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14034 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14035 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14036 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14037 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14038 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14039 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14040 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14041 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14042 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14043 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14044 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14045 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14046 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14047 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14048 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14049 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14050 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14051 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14052 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14053 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14054 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14055 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14056 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14057 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14058 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14059 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14060 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14061 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14062 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14063 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14064 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14065 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14066 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14067 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14068 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14069 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14070 Zhuang, {zu} : Zulu, {zun} : Zuni
14071
14072 =item SEE ALSO
14073
14074 =item COPYRIGHT AND DISCLAIMER
14075
14076 =item AUTHOR
14077
14078 =back
14079
14080 =head2 I18N::Langinfo - query locale information
14081
14082 =over 4
14083
14084 =item SYNOPSIS
14085
14086 =item DESCRIPTION
14087
14088 =over 4
14089
14090 =item EXPORT
14091
14092 =back
14093
14094 =item SEE ALSO
14095
14096 =item AUTHOR
14097
14098 =item COPYRIGHT AND LICENSE
14099
14100 =back
14101
14102 =head2 IO - load various IO modules
14103
14104 =over 4
14105
14106 =item SYNOPSIS
14107
14108 =item DESCRIPTION
14109
14110 =back
14111
14112 =head2 IO::Dir - supply object methods for directory handles
14113
14114 =over 4
14115
14116 =item SYNOPSIS
14117
14118 =item DESCRIPTION
14119
14120 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14121 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14122
14123 =item SEE ALSO
14124
14125 =item AUTHOR
14126
14127 =item COPYRIGHT
14128
14129 =back
14130
14131 =head2 IO::File - supply object methods for filehandles
14132
14133 =over 4
14134
14135 =item SYNOPSIS
14136
14137 =item DESCRIPTION
14138
14139 =item CONSTRUCTOR
14140
14141 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14142
14143 =item METHODS
14144
14145 open( FILENAME [,MODE [,PERMS]] )
14146
14147 =item SEE ALSO
14148
14149 =item HISTORY
14150
14151 =back
14152
14153 =head2 IO::Handle - supply object methods for I/O handles
14154
14155 =over 4
14156
14157 =item SYNOPSIS
14158
14159 =item DESCRIPTION
14160
14161 =item CONSTRUCTOR
14162
14163 new (), new_from_fd ( FD, MODE )
14164
14165 =item METHODS
14166
14167 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14168 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14169 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14170 $io->blocking ( [ BOOL ] ), $io->untaint
14171
14172 =item NOTE
14173
14174 =item SEE ALSO
14175
14176 =item BUGS
14177
14178 =item HISTORY
14179
14180 =back
14181
14182 =head2 IO::Pipe - supply object methods for pipes
14183
14184 =over 4
14185
14186 =item SYNOPSIS
14187
14188 =item DESCRIPTION
14189
14190 =item CONSTRUCTOR
14191
14192 new ( [READER, WRITER] )
14193
14194 =item METHODS
14195
14196 reader ([ARGS]), writer ([ARGS]), handles ()
14197
14198 =item SEE ALSO
14199
14200 =item AUTHOR
14201
14202 =item COPYRIGHT
14203
14204 =back
14205
14206 =head2 IO::Poll - Object interface to system poll call
14207
14208 =over 4
14209
14210 =item SYNOPSIS
14211
14212 =item DESCRIPTION
14213
14214 =item METHODS
14215
14216 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14217 IO ), handles( [ EVENT_MASK ] )
14218
14219 =item SEE ALSO
14220
14221 =item AUTHOR
14222
14223 =item COPYRIGHT
14224
14225 =back
14226
14227 =head2 IO::Seekable - supply seek based methods for I/O objects
14228
14229 =over 4
14230
14231 =item SYNOPSIS
14232
14233 =item DESCRIPTION
14234
14235 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14236 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14237 $io->tell
14238
14239 =item SEE ALSO
14240
14241 =item HISTORY
14242
14243 =back
14244
14245 =head2 IO::Select - OO interface to the select system call
14246
14247 =over 4
14248
14249 =item SYNOPSIS
14250
14251 =item DESCRIPTION
14252
14253 =item CONSTRUCTOR
14254
14255 new ( [ HANDLES ] )
14256
14257 =item METHODS
14258
14259 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14260 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14261 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14262
14263 =item EXAMPLE
14264
14265 =item AUTHOR
14266
14267 =item COPYRIGHT
14268
14269 =back
14270
14271 =head2 IO::Socket - Object interface to socket communications
14272
14273 =over 4
14274
14275 =item SYNOPSIS
14276
14277 =item DESCRIPTION
14278
14279 =item CONSTRUCTOR
14280
14281 new ( [ARGS] )
14282
14283 =item METHODS
14284
14285 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14286 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14287
14288 =item SEE ALSO
14289
14290 =item AUTHOR
14291
14292 =item COPYRIGHT
14293
14294 =back
14295
14296 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14297
14298 =over 4
14299
14300 =item SYNOPSIS
14301
14302 =item DESCRIPTION
14303
14304 =item CONSTRUCTOR
14305
14306 new ( [ARGS] )
14307
14308 =over 4
14309
14310 =item METHODS
14311
14312 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14313 ()
14314
14315 =back
14316
14317 =item SEE ALSO
14318
14319 =item AUTHOR
14320
14321 =item COPYRIGHT
14322
14323 =back
14324
14325 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14326
14327 =over 4
14328
14329 =item SYNOPSIS
14330
14331 =item DESCRIPTION
14332
14333 =item CONSTRUCTOR
14334
14335 new ( [ARGS] )
14336
14337 =item METHODS
14338
14339 hostpath(), peerpath()
14340
14341 =item SEE ALSO
14342
14343 =item AUTHOR
14344
14345 =item COPYRIGHT
14346
14347 =back
14348
14349 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14350 handles
14351
14352 =over 4
14353
14354 =item SYNOPSIS
14355
14356 =item DESCRIPTION
14357
14358 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14359 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14360
14361 =item SEE ALSO
14362
14363 =item AUTHOR
14364
14365 =item COPYRIGHT
14366
14367 =back
14368
14369 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14370
14371 =over 4
14372
14373 =item SYNOPSIS
14374
14375 =item DESCRIPTION
14376
14377 =item CONSTRUCTOR
14378
14379 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14380
14381 =item METHODS
14382
14383 open( FILENAME [,MODE [,PERMS]] )
14384
14385 =item SEE ALSO
14386
14387 =item HISTORY
14388
14389 =back
14390
14391 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14392 handles
14393
14394 =over 4
14395
14396 =item SYNOPSIS
14397
14398 =item DESCRIPTION
14399
14400 =item CONSTRUCTOR
14401
14402 new (), new_from_fd ( FD, MODE )
14403
14404 =item METHODS
14405
14406 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14407 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14408 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14409 $io->blocking ( [ BOOL ] ), $io->untaint
14410
14411 =item NOTE
14412
14413 =item SEE ALSO
14414
14415 =item BUGS
14416
14417 =item HISTORY
14418
14419 =back
14420
14421 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14422
14423 =over 4
14424
14425 =item SYNOPSIS
14426
14427 =item DESCRIPTION
14428
14429 =item CONSTRUCTOR
14430
14431 new ( [READER, WRITER] )
14432
14433 =item METHODS
14434
14435 reader ([ARGS]), writer ([ARGS]), handles ()
14436
14437 =item SEE ALSO
14438
14439 =item AUTHOR
14440
14441 =item COPYRIGHT
14442
14443 =back
14444
14445 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14446
14447 =over 4
14448
14449 =item SYNOPSIS
14450
14451 =item DESCRIPTION
14452
14453 =item METHODS
14454
14455 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14456 IO ), handles( [ EVENT_MASK ] )
14457
14458 =item SEE ALSO
14459
14460 =item AUTHOR
14461
14462 =item COPYRIGHT
14463
14464 =back
14465
14466 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14467 I/O objects
14468
14469 =over 4
14470
14471 =item SYNOPSIS
14472
14473 =item DESCRIPTION
14474
14475 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14476 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14477 $io->tell
14478
14479 =item SEE ALSO
14480
14481 =item HISTORY
14482
14483 =back
14484
14485 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14486 call
14487
14488 =over 4
14489
14490 =item SYNOPSIS
14491
14492 =item DESCRIPTION
14493
14494 =item CONSTRUCTOR
14495
14496 new ( [ HANDLES ] )
14497
14498 =item METHODS
14499
14500 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14501 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14502 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14503
14504 =item EXAMPLE
14505
14506 =item AUTHOR
14507
14508 =item COPYRIGHT
14509
14510 =back
14511
14512 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14513 communications
14514
14515 =over 4
14516
14517 =item SYNOPSIS
14518
14519 =item DESCRIPTION
14520
14521 =item CONSTRUCTOR
14522
14523 new ( [ARGS] )
14524
14525 =item METHODS
14526
14527 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14528 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14529
14530 =item SEE ALSO
14531
14532 =item AUTHOR
14533
14534 =item COPYRIGHT
14535
14536 =back
14537
14538 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14539 AF_INET domain sockets
14540
14541 =over 4
14542
14543 =item SYNOPSIS
14544
14545 =item DESCRIPTION
14546
14547 =item CONSTRUCTOR
14548
14549 new ( [ARGS] )
14550
14551 =over 4
14552
14553 =item METHODS
14554
14555 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14556 ()
14557
14558 =back
14559
14560 =item SEE ALSO
14561
14562 =item AUTHOR
14563
14564 =item COPYRIGHT
14565
14566 =back
14567
14568 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14569 AF_UNIX domain sockets
14570
14571 =over 4
14572
14573 =item SYNOPSIS
14574
14575 =item DESCRIPTION
14576
14577 =item CONSTRUCTOR
14578
14579 new ( [ARGS] )
14580
14581 =item METHODS
14582
14583 hostpath(), peerpath()
14584
14585 =item SEE ALSO
14586
14587 =item AUTHOR
14588
14589 =item COPYRIGHT
14590
14591 =back
14592
14593 =head2 IPC::Msg - SysV Msg IPC object class
14594
14595 =over 4
14596
14597 =item SYNOPSIS
14598
14599 =item DESCRIPTION
14600
14601 =item METHODS
14602
14603 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14604 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14605 FLAGS ] ), stat
14606
14607 =item SEE ALSO
14608
14609 =item AUTHOR
14610
14611 =item COPYRIGHT
14612
14613 =back
14614
14615 =head2 IPC::Open2, open2 - open a process for both reading and writing
14616
14617 =over 4
14618
14619 =item SYNOPSIS
14620
14621 =item DESCRIPTION
14622
14623 =item WARNING
14624
14625 =item SEE ALSO
14626
14627 =back
14628
14629 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14630 handling
14631
14632 =over 4
14633
14634 =item SYNOPSIS
14635
14636 =item DESCRIPTION
14637
14638 =item WARNING
14639
14640 =back
14641
14642 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14643
14644 =over 4
14645
14646 =item SYNOPSIS
14647
14648 =item DESCRIPTION
14649
14650 =item METHODS
14651
14652 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14653 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14654 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14655 , VALUE ), stat
14656
14657 =item SEE ALSO
14658
14659 =item AUTHOR
14660
14661 =item COPYRIGHT
14662
14663 =back
14664
14665 =head2 IPC::SysV - SysV IPC constants
14666
14667 =over 4
14668
14669 =item SYNOPSIS
14670
14671 =item DESCRIPTION
14672
14673 ftok( PATH, ID )
14674
14675 =item SEE ALSO
14676
14677 =item AUTHORS
14678
14679 =item COPYRIGHT
14680
14681 =back
14682
14683 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14684
14685 =over 4
14686
14687 =item SYNOPSIS
14688
14689 =item DESCRIPTION
14690
14691 =item METHODS
14692
14693 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14694 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14695 FLAGS ] ), stat
14696
14697 =item SEE ALSO
14698
14699 =item AUTHOR
14700
14701 =item COPYRIGHT
14702
14703 =back
14704
14705 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14706 class
14707
14708 =over 4
14709
14710 =item SYNOPSIS
14711
14712 =item DESCRIPTION
14713
14714 =item METHODS
14715
14716 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14717 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14718 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14719 , VALUE ), stat
14720
14721 =item SEE ALSO
14722
14723 =item AUTHOR
14724
14725 =item COPYRIGHT
14726
14727 =back
14728
14729 =head2 List::Util - A selection of general-utility list subroutines
14730
14731 =over 4
14732
14733 =item SYNOPSIS
14734
14735 =item DESCRIPTION
14736
14737 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14738 BLOCK LIST, shuffle LIST, sum LIST
14739
14740 =item KNOWN BUGS
14741
14742 =item SUGGESTED ADDITIONS
14743
14744 =item COPYRIGHT
14745
14746 =back
14747
14748 =head2 List::Utilib::List::Util, List::Util - A selection of
14749 general-utility list subroutines
14750
14751 =over 4
14752
14753 =item SYNOPSIS
14754
14755 =item DESCRIPTION
14756
14757 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14758 BLOCK LIST, shuffle LIST, sum LIST
14759
14760 =item KNOWN BUGS
14761
14762 =item SUGGESTED ADDITIONS
14763
14764 =item COPYRIGHT
14765
14766 =back
14767
14768 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14769 general-utility scalar subroutines
14770
14771 =over 4
14772
14773 =item SYNOPSIS
14774
14775 =item DESCRIPTION
14776
14777 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14778 EXPR, tainted EXPR, weaken REF
14779
14780 =item KNOWN BUGS
14781
14782 =item COPYRIGHT
14783
14784 =item BLATANT PLUG
14785
14786 =back
14787
14788 =head2 Locale::Constants - constants for Locale codes
14789
14790 =over 4
14791
14792 =item SYNOPSIS
14793
14794 =item DESCRIPTION
14795
14796 =item KNOWN BUGS AND LIMITATIONS
14797
14798 =item SEE ALSO
14799
14800 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14801
14802 =item AUTHOR
14803
14804 =item COPYRIGHT
14805
14806 =back
14807
14808 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14809
14810 =over 4
14811
14812 =item SYNOPSIS
14813
14814 =item DESCRIPTION
14815
14816 B<alpha-2>, B<alpha-3>, B<numeric>
14817
14818 =item CONVERSION ROUTINES
14819
14820 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14821 country_code2code( CODE, CODESET, CODESET )
14822
14823 =item QUERY ROUTINES
14824
14825 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14826
14827 =item SEMI-PRIVATE ROUTINES
14828
14829 =over 4
14830
14831 =item alias_code
14832
14833 =item rename_country
14834
14835 =back
14836
14837 =item EXAMPLES
14838
14839 =item DOMAIN NAMES
14840
14841 =item KNOWN BUGS AND LIMITATIONS
14842
14843 =item SEE ALSO
14844
14845 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14846 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14847 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14848 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14849
14850 =item AUTHOR
14851
14852 =item COPYRIGHT
14853
14854 =back
14855
14856 =head2 Locale::Currency - ISO three letter codes for currency
14857 identification (ISO 4217)
14858
14859 =over 4
14860
14861 =item SYNOPSIS
14862
14863 =item DESCRIPTION
14864
14865 XTS, XXX
14866
14867 =item CONVERSION ROUTINES
14868
14869 code2currency(), currency2code()
14870
14871 =item QUERY ROUTINES
14872
14873 C<all_currency_codes()>, C<all_currency_names()>
14874
14875 =item EXAMPLES
14876
14877 =item KNOWN BUGS AND LIMITATIONS
14878
14879 =item SEE ALSO
14880
14881 Locale::Country, Locale::Script, ISO 4217:1995,
14882 http://www.bsi-global.com/iso4217currency
14883
14884 =item AUTHOR
14885
14886 =item COPYRIGHT
14887
14888 =back
14889
14890 =head2 Locale::Language - ISO two letter codes for language identification
14891 (ISO 639)
14892
14893 =over 4
14894
14895 =item SYNOPSIS
14896
14897 =item DESCRIPTION
14898
14899 =item CONVERSION ROUTINES
14900
14901 code2language(), language2code()
14902
14903 =item QUERY ROUTINES
14904
14905 C<all_language_codes()>, C<all_language_names()>
14906
14907 =item EXAMPLES
14908
14909 =item KNOWN BUGS AND LIMITATIONS
14910
14911 =item SEE ALSO
14912
14913 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
14914 http://lcweb.loc.gov/standards/iso639-2/langhome.html
14915
14916 =item AUTHOR
14917
14918 =item COPYRIGHT
14919
14920 =back
14921
14922 =head2 Locale::Maketext -- framework for localization
14923
14924 =over 4
14925
14926 =item SYNOPSIS
14927
14928 =item DESCRIPTION
14929
14930 =item QUICK OVERVIEW
14931
14932 =item METHODS
14933
14934 =over 4
14935
14936 =item Construction Methods
14937
14938 =item The "maketext" Method
14939
14940 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
14941
14942 =item Utility Methods
14943
14944 $language->quant($number, $singular), $language->quant($number, $singular,
14945 $plural), $language->quant($number, $singular, $plural, $negative),
14946 $language->numf($number), $language->sprintf($format, @items),
14947 $language->language_tag(), $language->encoding()
14948
14949 =item Language Handle Attributes and Internals
14950
14951 =back
14952
14953 =item LANGUAGE CLASS HIERARCHIES
14954
14955 =item ENTRIES IN EACH LEXICON
14956
14957 =item BRACKET NOTATION
14958
14959 =item AUTO LEXICONS
14960
14961 =item CONTROLLING LOOKUP FAILURE
14962
14963 =item HOW TO USE MAKETEXT
14964
14965 =item SEE ALSO
14966
14967 =item COPYRIGHT AND DISCLAIMER
14968
14969 =item AUTHOR
14970
14971 =back
14972
14973 =head2 Locale::Maketext::TPJ13 -- article about software localization
14974
14975 =over 4
14976
14977 =item SYNOPSIS
14978
14979 =item DESCRIPTION
14980
14981 =item Localization and Perl: gettext breaks, Maketext fixes
14982
14983 =over 4
14984
14985 =item A Localization Horror Story: It Could Happen To You
14986
14987 =item The Linguistic View
14988
14989 =item Breaking gettext
14990
14991 =item Replacing gettext
14992
14993 =item Buzzwords: Abstraction and Encapsulation
14994
14995 =item Buzzword: Isomorphism
14996
14997 =item Buzzword: Inheritance
14998
14999 =item Buzzword: Concision
15000
15001 =item The Devil in the Details
15002
15003 =item The Proof in the Pudding: Localizing Web Sites
15004
15005 =item References
15006
15007 =back
15008
15009 =back
15010
15011 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15012
15013 =over 4
15014
15015 =item SYNOPSIS
15016
15017 =item DESCRIPTION
15018
15019 B<alpha-2>, B<alpha-3>, B<numeric>
15020
15021 =over 4
15022
15023 =item SPECIAL CODES
15024
15025 =back
15026
15027 =item CONVERSION ROUTINES
15028
15029 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15030 script_code2code( CODE, CODESET, CODESET )
15031
15032 =item QUERY ROUTINES
15033
15034 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15035
15036 =item EXAMPLES
15037
15038 =item KNOWN BUGS AND LIMITATIONS
15039
15040 =item SEE ALSO
15041
15042 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15043 http://www.evertype.com/standards/iso15924/
15044
15045 =item AUTHOR
15046
15047 =item COPYRIGHT
15048
15049 =back
15050
15051 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15052
15053 =over 4
15054
15055 =item SYNOPSIS
15056
15057 =item DESCRIPTION
15058
15059 encode_base64($str, [$eol]), decode_base64($str)
15060
15061 =item DIAGNOSTICS
15062
15063 Premature end of base64 data, Premature padding of base64 data
15064
15065 =item EXAMPLES
15066
15067 =item COPYRIGHT
15068
15069 =back
15070
15071 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15072 of quoted-printable strings
15073
15074 =over 4
15075
15076 =item SYNOPSIS
15077
15078 =item DESCRIPTION
15079
15080 encode_qp($str), decode_qp($str);
15081
15082 =item COPYRIGHT
15083
15084 =back
15085
15086 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15087 strings
15088
15089 =over 4
15090
15091 =item SYNOPSIS
15092
15093 =item DESCRIPTION
15094
15095 encode_qp($str), decode_qp($str);
15096
15097 =item COPYRIGHT
15098
15099 =back
15100
15101 =head2 Math::BigFloat - Arbitrary size floating point math package
15102
15103 =over 4
15104
15105 =item SYNOPSIS
15106
15107 =item DESCRIPTION
15108
15109 =over 4
15110
15111 =item Canonical notation
15112
15113 =item Output
15114
15115 =item C<mantissa()>, C<exponent()> and C<parts()>
15116
15117 =item Accuracy vs. Precision
15118
15119 =item Rounding
15120
15121 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15122 ), fround  ( -$scale ) and fround ( 0 )
15123
15124 =back
15125
15126 =item EXAMPLES
15127
15128   # not ready yet
15129
15130 =item Autocreating constants
15131
15132 =over 4
15133
15134 =item Math library
15135
15136 =item Using Math::BigInt::Lite
15137
15138 =back
15139
15140 =item BUGS
15141
15142 =item CAVEAT
15143
15144 stringify, bstr(), bdiv, Modifying and =, bpow
15145
15146 =item LICENSE
15147
15148 =item AUTHORS
15149
15150 =back
15151
15152 =head2 Math::BigInt - Arbitrary size integer math package
15153
15154 =over 4
15155
15156 =item SYNOPSIS
15157
15158 =item DESCRIPTION
15159
15160 Canonical notation, Input, Output
15161
15162 =item METHODS
15163
15164 =over 4
15165
15166 =item config
15167
15168 =item accuracy
15169
15170 =item brsft
15171
15172 =item new
15173
15174 =item bnan
15175
15176 =item bzero
15177
15178 =item binf
15179
15180 =item bone
15181
15182 =item is_one()/is_zero()/is_nan()/is_inf()
15183
15184 =item is_positive()/is_negative()
15185
15186         $x->is_positive();              # true if >= 0
15187         $x->is_negative();              # true if <  0
15188
15189 =item is_odd()/is_even()/is_int()
15190
15191 =item bcmp
15192
15193 =item bacmp
15194
15195 =item sign
15196
15197 =item bcmp
15198
15199 =item bneg
15200
15201 =item babs
15202
15203 =item bnorm
15204
15205 =item bnot
15206
15207 =item binc
15208
15209 =item bdec
15210
15211 =item badd
15212
15213 =item bsub
15214
15215 =item bmul
15216
15217 =item bdiv
15218
15219 =item bmod
15220
15221 =item bpow
15222
15223 =item blsft
15224
15225 =item brsft
15226
15227 =item band
15228
15229 =item bior
15230
15231 =item bxor
15232
15233 =item bnot
15234
15235 =item bsqrt
15236
15237 =item bfac
15238
15239 =item round
15240
15241 =item bround
15242
15243 =item bfround
15244
15245 =item bfloor
15246
15247 =item bceil
15248
15249 =item bgcd
15250
15251 =item blcm
15252
15253 =item exponent
15254
15255 =item mantissa
15256
15257 =item parts
15258
15259 =item copy
15260
15261 =item as_number
15262
15263 =item bsstr
15264
15265 =item as_hex
15266
15267 =item as_bin
15268
15269 =back
15270
15271 =item ACCURACY and PRECISION
15272
15273 =over 4
15274
15275 =item Precision P
15276
15277 =item Accuracy A
15278
15279 =item Fallback F
15280
15281 =item Rounding mode R
15282
15283 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15284 (significant digits), Setting/Accessing, Creating numbers, Usage,
15285 Precedence, Overriding globals, Local settings, Rounding, Default values,
15286 Remarks
15287
15288 =back
15289
15290 =item INTERNALS
15291
15292 =over 4
15293
15294 =item MATH LIBRARY
15295
15296 =item SIGN
15297
15298 =item mantissa(), exponent() and parts()
15299
15300 =back
15301
15302 =item EXAMPLES
15303
15304   use Math::BigInt;
15305
15306 =item Autocreating constants
15307
15308 =item PERFORMANCE
15309
15310 =over 4
15311
15312 =item Alternative math libraries
15313
15314 =item SUBCLASSING
15315
15316 =back
15317
15318 =item Subclassing Math::BigInt
15319
15320 =item UPGRADING
15321
15322 =over 4
15323
15324 =item Auto-upgrade
15325
15326 bsqrt(), div(), blog()
15327
15328 =back
15329
15330 =item BUGS
15331
15332 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15333
15334 =item CAVEATS
15335
15336 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15337 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15338 types, bsqrt(), brsft()
15339
15340 =item LICENSE
15341
15342 =item SEE ALSO
15343
15344 =item AUTHORS
15345
15346 =back
15347
15348 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15349
15350 =over 4
15351
15352 =item SYNOPSIS
15353
15354 =item DESCRIPTION
15355
15356 =item EXPORT
15357
15358 =item WRAP YOUR OWN
15359
15360 =item LICENSE
15361
15362 This program is free software; you may redistribute it and/or modify it
15363 under
15364 the same terms as Perl itself.
15365
15366 =item AUTHORS
15367
15368 =item SEE ALSO
15369
15370 =back
15371
15372 =head2 Math::BigRat - arbitrarily big rationals
15373
15374 =over 4
15375
15376 =item SYNOPSIS
15377
15378 =item DESCRIPTION
15379
15380 =over 4
15381
15382 =item MATH LIBRARY
15383
15384 =back
15385
15386 =item METHODS
15387
15388 =over 4
15389
15390 =item new
15391
15392 =item numerator
15393
15394 =item denominator
15395
15396         $d = $x->denominator();
15397
15398 =item parts
15399
15400 =back
15401
15402 =item BUGS
15403
15404 =item LICENSE
15405
15406 =item SEE ALSO
15407
15408 =item AUTHORS
15409
15410 =back
15411
15412 =head2 Math::Complex - complex numbers and associated mathematical
15413 functions
15414
15415 =over 4
15416
15417 =item SYNOPSIS
15418
15419 =item DESCRIPTION
15420
15421 =item OPERATIONS
15422
15423 =item CREATION
15424
15425 =item STRINGIFICATION
15426
15427 =over 4
15428
15429 =item CHANGED IN PERL 5.6
15430
15431 =back
15432
15433 =item USAGE
15434
15435 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15436
15437 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15438
15439 =item BUGS
15440
15441 =item AUTHORS
15442
15443 =back
15444
15445 =head2 Math::Trig - trigonometric functions
15446
15447 =over 4
15448
15449 =item SYNOPSIS
15450
15451 =item DESCRIPTION
15452
15453 =item TRIGONOMETRIC FUNCTIONS
15454
15455 B<tan>
15456
15457 =over 4
15458
15459 =item ERRORS DUE TO DIVISION BY ZERO
15460
15461 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15462
15463 =back
15464
15465 =item PLANE ANGLE CONVERSIONS
15466
15467 =item RADIAL COORDINATE CONVERSIONS
15468
15469 =over 4
15470
15471 =item COORDINATE SYSTEMS
15472
15473 =item 3-D ANGLE CONVERSIONS
15474
15475 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15476 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15477
15478 =back
15479
15480 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15481
15482 =item EXAMPLES
15483
15484 =over 4
15485
15486 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15487
15488 =back
15489
15490 =item BUGS
15491
15492 =item AUTHORS
15493
15494 =back
15495
15496 =head2 Memoize - Make functions faster by trading space for time
15497
15498 =over 4
15499
15500 =item SYNOPSIS
15501
15502 =item DESCRIPTION
15503
15504 =item DETAILS
15505
15506 =item OPTIONS
15507
15508 =over 4
15509
15510 =item INSTALL
15511
15512 =item NORMALIZER
15513
15514 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15515
15516 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15517
15518 =back
15519
15520 =item OTHER FACILITIES
15521
15522 =over 4
15523
15524 =item C<unmemoize>
15525
15526 =item C<flush_cache>
15527
15528 =back
15529
15530 =item CAVEATS
15531
15532 =item PERSISTENT CACHE SUPPORT
15533
15534 =item EXPIRATION SUPPORT
15535
15536 =item BUGS
15537
15538 =item MAILING LIST
15539
15540 =item AUTHOR
15541
15542 =item COPYRIGHT AND LICENSE
15543
15544 =item THANK YOU
15545
15546 =back
15547
15548 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15549 Storable use
15550
15551 =over 4
15552
15553 =item DESCRIPTION
15554
15555 =back
15556
15557 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15558 memoized values
15559
15560 =over 4
15561
15562 =item SYNOPSIS
15563
15564 =item DESCRIPTION
15565
15566 =item INTERFACE
15567
15568  TIEHASH,  EXISTS,  STORE
15569
15570 =item ALTERNATIVES
15571
15572 =item CAVEATS
15573
15574 =item AUTHOR
15575
15576 =item SEE ALSO
15577
15578 =back
15579
15580 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15581
15582 =over 4
15583
15584 =item DESCRIPTION
15585
15586 =back
15587
15588 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15589
15590 =over 4
15591
15592 =item DESCRIPTION
15593
15594 =back
15595
15596 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15597 Storable use
15598
15599 =over 4
15600
15601 =item DESCRIPTION
15602
15603 =back
15604
15605 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15606 Storable use
15607
15608 =over 4
15609
15610 =item DESCRIPTION
15611
15612 =back
15613
15614 =head2 Memoize::Storable - store Memoized data in Storable database
15615
15616 =over 4
15617
15618 =item DESCRIPTION
15619
15620 =back
15621
15622 =head2 NDBM_File - Tied access to ndbm files
15623
15624 =over 4
15625
15626 =item SYNOPSIS
15627
15628 =item DESCRIPTION
15629
15630 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15631
15632 =item DIAGNOSTICS
15633
15634 =over 4
15635
15636 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15637
15638 =back
15639
15640 =item BUGS AND WARNINGS
15641
15642 =back
15643
15644 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15645
15646 =over 4
15647
15648 =item SYNOPSIS
15649
15650 =item DESCRIPTION
15651
15652 =over 4
15653
15654 =item Enforcing redispatch
15655
15656 =item Avoiding repetitions
15657
15658 =back
15659
15660 =item AUTHOR
15661
15662 =item BUGS AND IRRITATIONS
15663
15664 =item COPYRIGHT
15665
15666 =back
15667
15668 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15669
15670 =over 4
15671
15672 =item SYNOPSIS
15673
15674 =item DESCRIPTION
15675
15676 =item USER METHODS
15677
15678 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15679 dataend ()
15680
15681 =item CLASS METHODS
15682
15683 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15684 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15685 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15686
15687 =item EXPORTS
15688
15689 =item AUTHOR
15690
15691 =item COPYRIGHT
15692
15693 =back
15694
15695 =head2 Net::Config - Local configuration data for libnet
15696
15697 =over 4
15698
15699 =item SYNOPSYS
15700
15701 =item DESCRIPTION
15702
15703 =item METHODS
15704
15705 requires_firewall HOST
15706
15707 =item NetConfig VALUES
15708
15709 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15710 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15711 ftp_int_pasive, local_netmask, test_hosts, test_exists
15712
15713 =back
15714
15715 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15716 and domain
15717
15718 =over 4
15719
15720 =item SYNOPSIS
15721
15722 =item DESCRIPTION
15723
15724 hostfqdn (), hostname (), hostdomain ()
15725
15726 =item AUTHOR
15727
15728 =item COPYRIGHT
15729
15730 =back
15731
15732 =head2 Net::FTP - FTP Client class
15733
15734 =over 4
15735
15736 =item SYNOPSIS
15737
15738 =item DESCRIPTION
15739
15740 =item OVERVIEW
15741
15742 =item CONSTRUCTOR
15743
15744 new (HOST [,OPTIONS])
15745
15746 =item METHODS
15747
15748 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15749 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15750 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15751 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15752 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15753 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15754 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15755 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15756 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15757 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15758 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15759 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15760 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15761
15762 =over 4
15763
15764 =item Methods for the adventurous
15765
15766 quot (CMD [,ARGS])
15767
15768 =back
15769
15770 =item THE dataconn CLASS
15771
15772 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15773 bytes_read (), abort (), close ()
15774
15775 =item UNIMPLEMENTED
15776
15777 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15778
15779 =item REPORTING BUGS
15780
15781 =item AUTHOR
15782
15783 =item SEE ALSO
15784
15785 =item USE EXAMPLES
15786
15787 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15788
15789 =item CREDITS
15790
15791 =item COPYRIGHT
15792
15793 =back
15794
15795 =head2 Net::NNTP - NNTP Client class
15796
15797 =over 4
15798
15799 =item SYNOPSIS
15800
15801 =item DESCRIPTION
15802
15803 =item CONSTRUCTOR
15804
15805 new ( [ HOST ] [, OPTIONS ])
15806
15807 =item METHODS
15808
15809 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15810 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15811 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15812 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15813 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15814 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15815 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15816
15817 =over 4
15818
15819 =item Extension methods
15820
15821 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15822 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15823 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15824 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15825 GROUP ] ), reader
15826
15827 =back
15828
15829 =item UNSUPPORTED
15830
15831 =item DEFINITIONS
15832
15833 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15834
15835 =item SEE ALSO
15836
15837 =item AUTHOR
15838
15839 =item COPYRIGHT
15840
15841 =back
15842
15843 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15844
15845 =over 4
15846
15847 =item SYNOPSIS
15848
15849 =item DESCRIPTION
15850
15851 =item EXAMPLES
15852
15853 =item CONSTRUCTOR
15854
15855 new ( [ HOST, ] [ OPTIONS ] )
15856
15857 =item METHODS
15858
15859 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15860 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15861 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15862 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15863
15864 =item NOTES
15865
15866 =item SEE ALSO
15867
15868 =item AUTHOR
15869
15870 =item COPYRIGHT
15871
15872 =back
15873
15874 =head2 Net::Ping - check a remote host for reachability
15875
15876 =over 4
15877
15878 =item SYNOPSIS
15879
15880 =item DESCRIPTION
15881
15882 =over 4
15883
15884 =item Functions
15885
15886 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->hires( { 0 | 1 }
15887 );, $p->bind($local_addr);, $p->ping($host [, $timeout]);,
15888 $p->open($host);, $p->close();, pingecho($host [, $timeout]);
15889
15890 =back
15891
15892 =item WARNING
15893
15894 =item NOTES
15895
15896 =item AUTHORS
15897
15898 =item COPYRIGHT
15899
15900 =back
15901
15902 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
15903
15904 =over 4
15905
15906 =item SYNOPSIS
15907
15908 =item DESCRIPTION
15909
15910 =item EXAMPLES
15911
15912 =item CONSTRUCTOR
15913
15914 new Net::SMTP [ HOST, ] [ OPTIONS ]
15915
15916 =item METHODS
15917
15918 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
15919 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
15920 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
15921 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
15922 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
15923 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
15924 quit ()
15925
15926 =item SEE ALSO
15927
15928 =item AUTHOR
15929
15930 =item COPYRIGHT
15931
15932 =back
15933
15934 =head2 Net::Time - time and daytime network client interface
15935
15936 =over 4
15937
15938 =item SYNOPSIS
15939
15940 =item DESCRIPTION
15941
15942 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
15943 PROTOCOL [, TIMEOUT]]])
15944
15945 =item AUTHOR
15946
15947 =item COPYRIGHT
15948
15949 =back
15950
15951 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
15952 functions
15953
15954 =over 4
15955
15956 =item SYNOPSIS
15957
15958 =item DESCRIPTION
15959
15960 =item EXAMPLES
15961
15962 =item NOTE
15963
15964 =item AUTHOR
15965
15966 =back
15967
15968 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
15969
15970 =over 4
15971
15972 =item DESCRIPTION
15973
15974 =over 4
15975
15976 =item Where to get this document
15977
15978 =item How to contribute to this document
15979
15980 =back
15981
15982 =item Author and Copyright Information
15983
15984 =over 4
15985
15986 =item Disclaimer
15987
15988 =back
15989
15990 =item Obtaining and installing libnet
15991
15992 =over 4
15993
15994 =item What is libnet ?
15995
15996 =item Which version of perl do I need ?
15997
15998 =item What other modules do I need ?
15999
16000 =item What machines support libnet ?
16001
16002 =item Where can I get the latest libnet release
16003
16004 =back
16005
16006 =item Using Net::FTP
16007
16008 =over 4
16009
16010 =item How do I download files from an FTP server ?
16011
16012 =item How do I transfer files in binary mode ?
16013
16014 =item How can I get the size of a file on a remote FTP server ?
16015
16016 =item How can I get the modification time of a file on a remote FTP server
16017 ?
16018
16019 =item How can I change the permissions of a file on a remote server ?
16020
16021 =item Can I do a reget operation like the ftp command ?
16022
16023 =item How do I get a directory listing from an FTP server ?
16024
16025 =item Changing directory to "" does not fail ?
16026
16027 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16028
16029 =item I am behind an FTP proxy firewall, but cannot access machines outside
16030 ?
16031
16032 =item My ftp proxy firewall does not listen on port 21
16033
16034 =item Is it possible to change the file permissions of a file on an FTP
16035 server ?
16036
16037 =item I have seen scripts call a method message, but cannot find it
16038 documented ?
16039
16040 =item Why does Net::FTP not implement mput and mget methods
16041
16042 =back
16043
16044 =item Using Net::SMTP
16045
16046 =over 4
16047
16048 =item Why can't the part of an Email address after the @ be used as the
16049 hostname ?
16050
16051 =item Why does Net::SMTP not do DNS MX lookups ?
16052
16053 =item The verify method always returns true ?
16054
16055 =back
16056
16057 =item Debugging scripts
16058
16059 =over 4
16060
16061 =item How can I debug my scripts that use Net::* modules ?
16062
16063 =back
16064
16065 =item AUTHOR AND COPYRIGHT
16066
16067 =back
16068
16069 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16070 functions
16071
16072 =over 4
16073
16074 =item SYNOPSIS
16075
16076 =item DESCRIPTION
16077
16078 =item EXAMPLES
16079
16080 =item NOTE
16081
16082 =item AUTHOR
16083
16084 =back
16085
16086 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16087 functions
16088
16089 =over 4
16090
16091 =item SYNOPSIS
16092
16093 =item DESCRIPTION
16094
16095 =item NOTE
16096
16097 =item AUTHOR
16098
16099 =back
16100
16101 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16102 functions
16103
16104 =over 4
16105
16106 =item SYNOPSIS
16107
16108 =item DESCRIPTION
16109
16110 =item EXAMPLES
16111
16112 =item NOTE
16113
16114 =item AUTHOR
16115
16116 =back
16117
16118 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16119
16120 =over 4
16121
16122 =item SYNOPSIS
16123
16124 =item DESCRIPTION
16125
16126 =item THE .netrc FILE
16127
16128 machine name, default, login name, password string, account string, macdef
16129 name
16130
16131 =item CONSTRUCTOR
16132
16133 lookup ( MACHINE [, LOGIN ])
16134
16135 =item METHODS
16136
16137 login (), password (), account (), lpa ()
16138
16139 =item AUTHOR
16140
16141 =item SEE ALSO
16142
16143 =item COPYRIGHT
16144
16145 =back
16146
16147 =head2 O - Generic interface to Perl Compiler backends
16148
16149 =over 4
16150
16151 =item SYNOPSIS
16152
16153 =item DESCRIPTION
16154
16155 =item CONVENTIONS
16156
16157 =item IMPLEMENTATION
16158
16159 =item BUGS
16160
16161 =item AUTHOR
16162
16163 =back
16164
16165 =head2 ODBM_File - Tied access to odbm files
16166
16167 =over 4
16168
16169 =item SYNOPSIS
16170
16171 =item DESCRIPTION
16172
16173 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16174
16175 =item DIAGNOSTICS
16176
16177 =over 4
16178
16179 =item C<odbm store returned -1, errno 22, key "..." at ...>
16180
16181 =back
16182
16183 =item BUGS AND WARNINGS
16184
16185 =back
16186
16187 =head2 Opcode - Disable named opcodes when compiling perl code
16188
16189 =over 4
16190
16191 =item SYNOPSIS
16192
16193 =item DESCRIPTION
16194
16195 =item NOTE
16196
16197 =item WARNING
16198
16199 =item Operator Names and Operator Lists
16200
16201 an operator name (opname), an operator tag name (optag), a negated opname
16202 or optag, an operator set (opset)
16203
16204 =item Opcode Functions
16205
16206 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16207 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16208 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16209 opdump (PAT)
16210
16211 =item Manipulating Opsets
16212
16213 =item TO DO (maybe)
16214
16215 =back
16216
16217 =over 4
16218
16219 =item Predefined Opcode Tags
16220
16221 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16222 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16223 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16224 :dangerous
16225
16226 =item SEE ALSO
16227
16228 =item AUTHORS
16229
16230 =back
16231
16232 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16233 compartments
16234
16235 =over 4
16236
16237 =item SYNOPSIS
16238
16239 =item DESCRIPTION
16240
16241 a new namespace, an operator mask
16242
16243 =item WARNING
16244
16245 =over 4
16246
16247 =item RECENT CHANGES
16248
16249 =item Methods in class Safe
16250
16251 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16252 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16253 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16254 root (NAMESPACE), mask (MASK)
16255
16256 =item Some Safety Issues
16257
16258 Memory, CPU, Snooping, Signals, State Changes
16259
16260 =item AUTHOR
16261
16262 =back
16263
16264 =back
16265
16266 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16267 compiling
16268
16269 =over 4
16270
16271 =item SYNOPSIS
16272
16273 =item DESCRIPTION
16274
16275 =item SEE ALSO
16276
16277 =back
16278
16279 =head2 POSIX - Perl interface to IEEE Std 1003.1
16280
16281 =over 4
16282
16283 =item SYNOPSIS
16284
16285 =item DESCRIPTION
16286
16287 =item NOTE
16288
16289 =item CAVEATS
16290
16291 =item FUNCTIONS
16292
16293 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16294 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16295 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16296 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16297 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16298 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16299 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16300 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16301 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16302 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16303 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16304 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16305 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16306 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16307 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16308 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16309 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16310 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16311 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16312 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16313 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16314 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16315 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16316 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16317 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16318 wctomb, write
16319
16320 =item CLASSES
16321
16322 =over 4
16323
16324 =item POSIX::SigAction
16325
16326 new
16327
16328 =item POSIX::SigSet
16329
16330 new, addset, delset, emptyset, fillset, ismember
16331
16332 =item POSIX::Termios
16333
16334 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16335 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16336 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16337 field values, c_cflag field values, c_iflag field values, c_lflag field
16338 values, c_oflag field values
16339
16340 =back
16341
16342 =item PATHNAME CONSTANTS
16343
16344 Constants
16345
16346 =item POSIX CONSTANTS
16347
16348 Constants
16349
16350 =item SYSTEM CONFIGURATION
16351
16352 Constants
16353
16354 =item ERRNO
16355
16356 Constants
16357
16358 =item FCNTL
16359
16360 Constants
16361
16362 =item FLOAT
16363
16364 Constants
16365
16366 =item LIMITS
16367
16368 Constants
16369
16370 =item LOCALE
16371
16372 Constants
16373
16374 =item MATH
16375
16376 Constants
16377
16378 =item SIGNAL
16379
16380 Constants
16381
16382 =item STAT
16383
16384 Constants, Macros
16385
16386 =item STDLIB
16387
16388 Constants
16389
16390 =item STDIO
16391
16392 Constants
16393
16394 =item TIME
16395
16396 Constants
16397
16398 =item UNISTD
16399
16400 Constants
16401
16402 =item WAIT
16403
16404 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16405 WTERMSIG, WIFSTOPPED, WSTOPSIG
16406
16407 =back
16408
16409 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16410 name space
16411
16412 =over 4
16413
16414 =item SYNOPSIS
16415
16416 =item DESCRIPTION
16417
16418 unix, stdio, perlio, crlf, utf8, bytes, raw
16419
16420 =over 4
16421
16422 =item Defaults and how to override them
16423
16424 =back
16425
16426 =item AUTHOR
16427
16428 =item SEE ALSO
16429
16430 =back
16431
16432 =head2 PerlIO::Scalar - support module for in-memory IO.
16433
16434 =over 4
16435
16436 =item SYNOPSIS
16437
16438 =item DESCRIPTION
16439
16440 =back
16441
16442 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
16443
16444 =over 4
16445
16446 =item SYNOPSIS
16447
16448 =item DESCRIPTION
16449
16450 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16451 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
16452 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
16453 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16454 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16455 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16456 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16457
16458 =over 4
16459
16460 =item Example - a Hexadecimal Handle
16461
16462 =back
16463
16464 =back
16465
16466 =head2 PerlIO::encoding - encoding layer
16467
16468 =over 4
16469
16470 =item SYNOPSIS
16471
16472 =item DESCRIPTION
16473
16474 =item SEE ALSO
16475
16476 =back
16477
16478 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16479
16480 =over 4
16481
16482 =item SYNOPSIS
16483
16484 =item OPTIONS/ARGUMENTS
16485
16486 =over 4
16487
16488 =item podchecker()
16489
16490 B<-warnings> =E<gt> I<val>
16491
16492 =back
16493
16494 =item DESCRIPTION
16495
16496 =item DIAGNOSTICS
16497
16498 =over 4
16499
16500 =item Errors
16501
16502 empty =headn, =over on line I<N> without closing =back, =item without
16503 previous =over, =back without previous =over, No argument for =begin, =end
16504 without =begin, Nested =begin's, =for without formatter specification,
16505 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16506 interior-sequence "I<SEQ>", nested commands
16507 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16508 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16509 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16510 after =back
16511
16512 =item Warnings
16513
16514 multiple occurence of link target I<name>, line containing nothing but
16515 whitespace in paragraph, file does not start with =head, previous =item has
16516 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16517 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16518 items in =over, No argument for =item, empty section in previous paragraph,
16519 Verbatim paragraph in NAME section
16520
16521 =item Hyperlinks
16522
16523 ignoring leading/trailing whitespace in link, (section) in '$page'
16524 deprecated, alternative text/node '%s' contains non-escaped | or /
16525
16526 =back
16527
16528 =item RETURN VALUE
16529
16530 =item EXAMPLES
16531
16532 =item INTERFACE
16533
16534 =back
16535
16536 C<Pod::Checker-E<gt>new( %options )>
16537
16538 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16539 @args )>
16540
16541 C<$checker-E<gt>num_errors()>
16542
16543 C<$checker-E<gt>name()>
16544
16545 C<$checker-E<gt>node()>
16546
16547 C<$checker-E<gt>idx()>
16548
16549 C<$checker-E<gt>hyperlink()>
16550
16551 =over 4
16552
16553 =item AUTHOR
16554
16555 =back
16556
16557 =head2 Pod::Find - find POD documents in directory trees
16558
16559 =over 4
16560
16561 =item SYNOPSIS
16562
16563 =item DESCRIPTION
16564
16565 =back
16566
16567 =over 4
16568
16569 =item C<pod_find( { %opts } , @directories )>
16570
16571 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16572 1>
16573
16574 =back
16575
16576 =over 4
16577
16578 =item C<simplify_name( $str )>
16579
16580 =back
16581
16582 =over 4
16583
16584 =item C<pod_where( { %opts }, $pod )>
16585
16586 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16587 1>
16588
16589 =back
16590
16591 =over 4
16592
16593 =item C<contains_pod( $file , $verbose )>
16594
16595 =back
16596
16597 =over 4
16598
16599 =item AUTHOR
16600
16601 =item SEE ALSO
16602
16603 =back
16604
16605 =head2 Pod::Html - module to convert pod files to HTML
16606
16607 =over 4
16608
16609 =item SYNOPSIS
16610
16611 =item DESCRIPTION
16612
16613 =item ARGUMENTS
16614
16615 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16616 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16617 title, verbose
16618
16619 =item EXAMPLE
16620
16621 =item ENVIRONMENT
16622
16623 =item AUTHOR
16624
16625 =item SEE ALSO
16626
16627 =item COPYRIGHT
16628
16629 =back
16630
16631 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16632 commands, etc.
16633
16634 =over 4
16635
16636 =item SYNOPSIS
16637
16638 =item REQUIRES
16639
16640 =item EXPORTS
16641
16642 =item DESCRIPTION
16643
16644 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16645 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16646
16647 =back
16648
16649 =over 4
16650
16651 =item B<Pod::InputSource>
16652
16653 =back
16654
16655 =over 4
16656
16657 =item B<new()>
16658
16659 =back
16660
16661 =over 4
16662
16663 =item B<name()>
16664
16665 =back
16666
16667 =over 4
16668
16669 =item B<handle()>
16670
16671 =back
16672
16673 =over 4
16674
16675 =item B<was_cutting()>
16676
16677 =back
16678
16679 =over 4
16680
16681 =item B<Pod::Paragraph>
16682
16683 =back
16684
16685 =over 4
16686
16687 =item Pod::Paragraph-E<gt>B<new()>
16688
16689 =back
16690
16691 =over 4
16692
16693 =item $pod_para-E<gt>B<cmd_name()>
16694
16695 =back
16696
16697 =over 4
16698
16699 =item $pod_para-E<gt>B<text()>
16700
16701 =back
16702
16703 =over 4
16704
16705 =item $pod_para-E<gt>B<raw_text()>
16706
16707 =back
16708
16709 =over 4
16710
16711 =item $pod_para-E<gt>B<cmd_prefix()>
16712
16713 =back
16714
16715 =over 4
16716
16717 =item $pod_para-E<gt>B<cmd_separator()>
16718
16719 =back
16720
16721 =over 4
16722
16723 =item $pod_para-E<gt>B<parse_tree()>
16724
16725 =back
16726
16727 =over 4
16728
16729 =item $pod_para-E<gt>B<file_line()>
16730
16731 =back
16732
16733 =over 4
16734
16735 =item B<Pod::InteriorSequence>
16736
16737 =back
16738
16739 =over 4
16740
16741 =item Pod::InteriorSequence-E<gt>B<new()>
16742
16743 =back
16744
16745 =over 4
16746
16747 =item $pod_seq-E<gt>B<cmd_name()>
16748
16749 =back
16750
16751 =over 4
16752
16753 =item $pod_seq-E<gt>B<prepend()>
16754
16755 =back
16756
16757 =over 4
16758
16759 =item $pod_seq-E<gt>B<append()>
16760
16761 =back
16762
16763 =over 4
16764
16765 =item $pod_seq-E<gt>B<nested()>
16766
16767 =back
16768
16769 =over 4
16770
16771 =item $pod_seq-E<gt>B<raw_text()>
16772
16773 =back
16774
16775 =over 4
16776
16777 =item $pod_seq-E<gt>B<left_delimiter()>
16778
16779 =back
16780
16781 =over 4
16782
16783 =item $pod_seq-E<gt>B<right_delimiter()>
16784
16785 =back
16786
16787 =over 4
16788
16789 =item $pod_seq-E<gt>B<parse_tree()>
16790
16791 =back
16792
16793 =over 4
16794
16795 =item $pod_seq-E<gt>B<file_line()>
16796
16797 =back
16798
16799 =over 4
16800
16801 =item Pod::InteriorSequence::B<DESTROY()>
16802
16803 =back
16804
16805 =over 4
16806
16807 =item B<Pod::ParseTree>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item Pod::ParseTree-E<gt>B<new()>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item $ptree-E<gt>B<top()>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item $ptree-E<gt>B<children()>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item $ptree-E<gt>B<prepend()>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item $ptree-E<gt>B<append()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item $ptree-E<gt>B<raw_text()>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item Pod::ParseTree::B<DESTROY()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item SEE ALSO
16856
16857 =item AUTHOR
16858
16859 =back
16860
16861 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
16862
16863 =over 4
16864
16865 =item SYNOPSIS
16866
16867 =item DESCRIPTION
16868
16869 =back
16870
16871 =over 4
16872
16873 =item OBJECT METHODS
16874
16875 C<initialize>
16876
16877 =back
16878
16879 =over 4
16880
16881 =item Data Accessors
16882
16883 B<AddPreamble>
16884
16885 =back
16886
16887 B<AddPostamble>
16888
16889 B<Head1Level>
16890
16891 B<Label>
16892
16893 B<LevelNoNum>
16894
16895 B<MakeIndex>
16896
16897 B<ReplaceNAMEwithSection>
16898
16899 B<StartWithNewPage>
16900
16901 B<TableOfContents>
16902
16903 B<UniqueLabels>
16904
16905 B<UserPreamble>
16906
16907 B<UserPostamble>
16908
16909 B<Lists>
16910
16911 =over 4
16912
16913 =item Subclassed methods
16914
16915 =back
16916
16917 B<begin_pod>
16918
16919 B<end_pod>
16920
16921 B<command>
16922
16923 B<verbatim>
16924
16925 B<textblock>
16926
16927 B<interior_sequence>
16928
16929 =over 4
16930
16931 =item List Methods
16932
16933 B<begin_list>
16934
16935 =back
16936
16937 B<end_list>
16938
16939 B<add_item>
16940
16941 =over 4
16942
16943 =item Methods for headings
16944
16945 B<head>
16946
16947 =back
16948
16949 =over 4
16950
16951 =item Internal methods
16952
16953 B<_output>
16954
16955 =back
16956
16957 B<_replace_special_chars>
16958
16959 B<_replace_special_chars_late>
16960
16961 B<_create_label>
16962
16963 B<_create_index>
16964
16965 B<_clean_latex_commands>
16966
16967 B<_split_delimited>
16968
16969 =over 4
16970
16971 =item NOTES
16972
16973 =item SEE ALSO
16974
16975 =item AUTHORS
16976
16977 =item COPYRIGHT
16978
16979 =item REVISION
16980
16981 =back
16982
16983 =head2 Pod::Man - Convert POD data to formatted *roff input
16984
16985 =over 4
16986
16987 =item SYNOPSIS
16988
16989 =item DESCRIPTION
16990
16991 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
16992 release, section
16993
16994 =item DIAGNOSTICS
16995
16996 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
16997 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
16998 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
16999 =back
17000
17001 =item BUGS
17002
17003 =item CAVEATS
17004
17005 =item SEE ALSO
17006
17007 =item AUTHOR
17008
17009 =item COPYRIGHT AND LICENSE
17010
17011 =back
17012
17013 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17014
17015 =over 4
17016
17017 =item SYNOPSIS
17018
17019 =item DESCRIPTION
17020
17021 =item AUTHOR
17022
17023 =item COPYRIGHT AND LICENSE
17024
17025 =back
17026
17027 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17028
17029 =over 4
17030
17031 =item SYNOPSIS
17032
17033 =item DESCRIPTION
17034
17035 =back
17036
17037 =over 4
17038
17039 =item Pod::List
17040
17041 Pod::List-E<gt>new()
17042
17043 =back
17044
17045 $list-E<gt>file()
17046
17047 $list-E<gt>start()
17048
17049 $list-E<gt>indent()
17050
17051 $list-E<gt>type()
17052
17053 $list-E<gt>rx()
17054
17055 $list-E<gt>item()
17056
17057 $list-E<gt>parent()
17058
17059 $list-E<gt>tag()
17060
17061 =over 4
17062
17063 =item Pod::Hyperlink
17064
17065 Pod::Hyperlink-E<gt>new()
17066
17067 =back
17068
17069 $link-E<gt>parse($string)
17070
17071 $link-E<gt>markup($string)
17072
17073 $link-E<gt>text()
17074
17075 $link-E<gt>warning()
17076
17077 $link-E<gt>file(), $link-E<gt>line()
17078
17079 $link-E<gt>page()
17080
17081 $link-E<gt>node()
17082
17083 $link-E<gt>alttext()
17084
17085 $link-E<gt>type()
17086
17087 $link-E<gt>link()
17088
17089 =over 4
17090
17091 =item Pod::Cache
17092
17093 Pod::Cache-E<gt>new()
17094
17095 =back
17096
17097 $cache-E<gt>item()
17098
17099 $cache-E<gt>find_page($name)
17100
17101 =over 4
17102
17103 =item Pod::Cache::Item
17104
17105 Pod::Cache::Item-E<gt>new()
17106
17107 =back
17108
17109 $cacheitem-E<gt>page()
17110
17111 $cacheitem-E<gt>description()
17112
17113 $cacheitem-E<gt>path()
17114
17115 $cacheitem-E<gt>file()
17116
17117 $cacheitem-E<gt>nodes()
17118
17119 $cacheitem-E<gt>find_node($name)
17120
17121 $cacheitem-E<gt>idx()
17122
17123 =over 4
17124
17125 =item AUTHOR
17126
17127 =item SEE ALSO
17128
17129 =back
17130
17131 =head2 Pod::Parser - base class for creating POD filters and translators
17132
17133 =over 4
17134
17135 =item SYNOPSIS
17136
17137 =item REQUIRES
17138
17139 =item EXPORTS
17140
17141 =item DESCRIPTION
17142
17143 =item QUICK OVERVIEW
17144
17145 =item PARSING OPTIONS
17146
17147 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17148 B<-warnings> (default: unset)
17149
17150 =back
17151
17152 =over 4
17153
17154 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17155
17156 =back
17157
17158 =over 4
17159
17160 =item B<command()>
17161
17162 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17163
17164 =back
17165
17166 =over 4
17167
17168 =item B<verbatim()>
17169
17170 C<$text>, C<$line_num>, C<$pod_para>
17171
17172 =back
17173
17174 =over 4
17175
17176 =item B<textblock()>
17177
17178 C<$text>, C<$line_num>, C<$pod_para>
17179
17180 =back
17181
17182 =over 4
17183
17184 =item B<interior_sequence()>
17185
17186 =back
17187
17188 =over 4
17189
17190 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17191
17192 =back
17193
17194 =over 4
17195
17196 =item B<new()>
17197
17198 =back
17199
17200 =over 4
17201
17202 =item B<initialize()>
17203
17204 =back
17205
17206 =over 4
17207
17208 =item B<begin_pod()>
17209
17210 =back
17211
17212 =over 4
17213
17214 =item B<begin_input()>
17215
17216 =back
17217
17218 =over 4
17219
17220 =item B<end_input()>
17221
17222 =back
17223
17224 =over 4
17225
17226 =item B<end_pod()>
17227
17228 =back
17229
17230 =over 4
17231
17232 =item B<preprocess_line()>
17233
17234 =back
17235
17236 =over 4
17237
17238 =item B<preprocess_paragraph()>
17239
17240 =back
17241
17242 =over 4
17243
17244 =item METHODS FOR PARSING AND PROCESSING
17245
17246 =back
17247
17248 =over 4
17249
17250 =item B<parse_text()>
17251
17252 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17253 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17254 I<code-ref>|I<method-name>
17255
17256 =back
17257
17258 =over 4
17259
17260 =item B<interpolate()>
17261
17262 =back
17263
17264 =over 4
17265
17266 =item B<parse_paragraph()>
17267
17268 =back
17269
17270 =over 4
17271
17272 =item B<parse_from_filehandle()>
17273
17274 =back
17275
17276 =over 4
17277
17278 =item B<parse_from_file()>
17279
17280 =back
17281
17282 =over 4
17283
17284 =item ACCESSOR METHODS
17285
17286 =back
17287
17288 =over 4
17289
17290 =item B<errorsub()>
17291
17292 =back
17293
17294 =over 4
17295
17296 =item B<cutting()>
17297
17298 =back
17299
17300 =over 4
17301
17302 =item B<parseopts()>
17303
17304 =back
17305
17306 =over 4
17307
17308 =item B<output_file()>
17309
17310 =back
17311
17312 =over 4
17313
17314 =item B<output_handle()>
17315
17316 =back
17317
17318 =over 4
17319
17320 =item B<input_file()>
17321
17322 =back
17323
17324 =over 4
17325
17326 =item B<input_handle()>
17327
17328 =back
17329
17330 =over 4
17331
17332 =item B<input_streams()>
17333
17334 =back
17335
17336 =over 4
17337
17338 =item B<top_stream()>
17339
17340 =back
17341
17342 =over 4
17343
17344 =item PRIVATE METHODS AND DATA
17345
17346 =back
17347
17348 =over 4
17349
17350 =item B<_push_input_stream()>
17351
17352 =back
17353
17354 =over 4
17355
17356 =item B<_pop_input_stream()>
17357
17358 =back
17359
17360 =over 4
17361
17362 =item TREE-BASED PARSING
17363
17364 =item SEE ALSO
17365
17366 =item AUTHOR
17367
17368 =back
17369
17370 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17371
17372 =over 4
17373
17374 =item SYNOPSIS
17375
17376 =item DESCRIPTION
17377
17378 =over 4
17379
17380 =item EXPORT
17381
17382 =back
17383
17384 =item AUTHOR
17385
17386 =item SEE ALSO
17387
17388 =back
17389
17390 =head2 Pod::Select, podselect() - extract selected sections of POD from
17391 input
17392
17393 =over 4
17394
17395 =item SYNOPSIS
17396
17397 =item REQUIRES
17398
17399 =item EXPORTS
17400
17401 =item DESCRIPTION
17402
17403 =item SECTION SPECIFICATIONS
17404
17405 =item RANGE SPECIFICATIONS
17406
17407 =back
17408
17409 =over 4
17410
17411 =item OBJECT METHODS
17412
17413 =back
17414
17415 =over 4
17416
17417 =item B<curr_headings()>
17418
17419 =back
17420
17421 =over 4
17422
17423 =item B<select()>
17424
17425 =back
17426
17427 =over 4
17428
17429 =item B<add_selection()>
17430
17431 =back
17432
17433 =over 4
17434
17435 =item B<clear_selections()>
17436
17437 =back
17438
17439 =over 4
17440
17441 =item B<match_section()>
17442
17443 =back
17444
17445 =over 4
17446
17447 =item B<is_selected()>
17448
17449 =back
17450
17451 =over 4
17452
17453 =item EXPORTED FUNCTIONS
17454
17455 =back
17456
17457 =over 4
17458
17459 =item B<podselect()>
17460
17461 B<-output>, B<-sections>, B<-ranges>
17462
17463 =back
17464
17465 =over 4
17466
17467 =item PRIVATE METHODS AND DATA
17468
17469 =back
17470
17471 =over 4
17472
17473 =item B<_compile_section_spec()>
17474
17475 =back
17476
17477 =over 4
17478
17479 =item $self->{_SECTION_HEADINGS}
17480
17481 =back
17482
17483 =over 4
17484
17485 =item $self->{_SELECTED_SECTIONS}
17486
17487 =back
17488
17489 =over 4
17490
17491 =item SEE ALSO
17492
17493 =item AUTHOR
17494
17495 =back
17496
17497 =head2 Pod::Text - Convert POD data to formatted ASCII text
17498
17499 =over 4
17500
17501 =item SYNOPSIS
17502
17503 =item DESCRIPTION
17504
17505 alt, code, indent, loose, quotes, sentence, width
17506
17507 =item DIAGNOSTICS
17508
17509 Bizarre space in item, Item called without tag, Can't open %s for reading:
17510 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17511 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17512 Unmatched =back
17513
17514 =item RESTRICTIONS
17515
17516 =item NOTES
17517
17518 =item SEE ALSO
17519
17520 =item AUTHOR
17521
17522 =item COPYRIGHT AND LICENSE
17523
17524 =back
17525
17526 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17527
17528 =over 4
17529
17530 =item SYNOPSIS
17531
17532 =item DESCRIPTION
17533
17534 =item BUGS
17535
17536 =item SEE ALSO
17537
17538 =item AUTHOR
17539
17540 =item COPYRIGHT AND LICENSE
17541
17542 =back
17543
17544 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17545 text
17546
17547 =over 4
17548
17549 =item SYNOPSIS
17550
17551 =item DESCRIPTION
17552
17553 =item BUGS
17554
17555 =item SEE ALSO
17556
17557 =item AUTHOR
17558
17559 =item COPYRIGHT AND LICENSE
17560
17561 =back
17562
17563 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17564 text with format escapes
17565
17566 =over 4
17567
17568 =item SYNOPSIS
17569
17570 =item DESCRIPTION
17571
17572 =item NOTES
17573
17574 =item SEE ALSO
17575
17576 =item AUTHOR
17577
17578 =item COPYRIGHT AND LICENSE
17579
17580 =back
17581
17582 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17583 documentation
17584
17585 =over 4
17586
17587 =item SYNOPSIS
17588
17589 =item ARGUMENTS
17590
17591 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17592 C<-pathlist>
17593
17594 =item DESCRIPTION
17595
17596 =item EXAMPLES
17597
17598 =over 4
17599
17600 =item Recommended Use
17601
17602 =back
17603
17604 =item CAVEATS
17605
17606 =item AUTHOR
17607
17608 =item ACKNOWLEDGEMENTS
17609
17610 =back
17611
17612 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17613 translators.
17614
17615 =over 4
17616
17617 =item HEADINGS
17618
17619 =item This C<is> a "level 1" heading
17620
17621 =over 4
17622
17623 =item ``Level'' "2 I<heading>
17624
17625 =back
17626
17627 =item This C<is> a "level 1" heading
17628
17629 =over 4
17630
17631 =item ``Level'' 2 I<heading>
17632
17633 =back
17634
17635 =item LINKS
17636
17637 =item OVER AND ITEMS
17638
17639 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17640 text
17641
17642 =item FORMATTING CODES
17643
17644 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17645
17646 =item VERBATIM
17647
17648 =item CONCLUSION
17649
17650 =back
17651
17652 =head2 Pod::t::htmlescp, Escape Sequences Test
17653
17654 =over 4
17655
17656 =item DESCRIPTION
17657
17658 =back
17659
17660 =head2 Pod::t::htmlview, Test HTML Rendering
17661
17662 =over 4
17663
17664 =item SYNOPSIS
17665
17666 =item DESCRIPTION
17667
17668 =item METHODS =E<gt> OTHER STUFF
17669
17670 =over 4
17671
17672 =item new()
17673
17674 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17675 Sat, 3 Mat
17676
17677 =item old()
17678
17679 =back
17680
17681 =item TESTING FOR AND BEGIN
17682
17683 =item TESTING URLs hyperlinking
17684
17685 =item SEE ALSO
17686
17687 =back
17688
17689 =head2 SDBM_File - Tied access to sdbm files
17690
17691 =over 4
17692
17693 =item SYNOPSIS
17694
17695 =item DESCRIPTION
17696
17697 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17698
17699 =item DIAGNOSTICS
17700
17701 =over 4
17702
17703 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17704
17705 =back
17706
17707 =item BUGS AND WARNINGS
17708
17709 =back
17710
17711 =head2 Safe - Compile and execute code in restricted compartments
17712
17713 =over 4
17714
17715 =item SYNOPSIS
17716
17717 =item DESCRIPTION
17718
17719 a new namespace, an operator mask
17720
17721 =item WARNING
17722
17723 =over 4
17724
17725 =item RECENT CHANGES
17726
17727 =item Methods in class Safe
17728
17729 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17730 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17731 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17732 root (NAMESPACE), mask (MASK)
17733
17734 =item Some Safety Issues
17735
17736 Memory, CPU, Snooping, Signals, State Changes
17737
17738 =item AUTHOR
17739
17740 =back
17741
17742 =back
17743
17744 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17745
17746 =over 4
17747
17748 =item SYNOPSIS
17749
17750 =item DESCRIPTION
17751
17752 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17753 EXPR, tainted EXPR, weaken REF
17754
17755 =item KNOWN BUGS
17756
17757 =item COPYRIGHT
17758
17759 =item BLATANT PLUG
17760
17761 =back
17762
17763 =head2 Search::Dict, look - search for key in dictionary file
17764
17765 =over 4
17766
17767 =item SYNOPSIS
17768
17769 =item DESCRIPTION
17770
17771 =back
17772
17773 =head2 SelectSaver - save and restore selected file handle
17774
17775 =over 4
17776
17777 =item SYNOPSIS
17778
17779 =item DESCRIPTION
17780
17781 =back
17782
17783 =head2 SelfLoader - load functions only on demand
17784
17785 =over 4
17786
17787 =item SYNOPSIS
17788
17789 =item DESCRIPTION
17790
17791 =over 4
17792
17793 =item The __DATA__ token
17794
17795 =item SelfLoader autoloading
17796
17797 =item Autoloading and package lexicals
17798
17799 =item SelfLoader and AutoLoader
17800
17801 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17802
17803 =item Classes and inherited methods.
17804
17805 =back
17806
17807 =item Multiple packages and fully qualified subroutine names
17808
17809 =back
17810
17811 =head2 Shell - run shell commands transparently within perl
17812
17813 =over 4
17814
17815 =item SYNOPSIS
17816
17817 =item DESCRIPTION
17818
17819 =over 4
17820
17821 =item OBJECT ORIENTED SYNTAX
17822
17823 =back
17824
17825 =item AUTHOR
17826
17827 =back
17828
17829 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17830 socket.h defines and structure manipulators
17831
17832 =over 4
17833
17834 =item SYNOPSIS
17835
17836 =item DESCRIPTION
17837
17838 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17839 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17840 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17841 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17842 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17843
17844 =back
17845
17846 =head2 Storable - persistence for Perl data structures
17847
17848 =over 4
17849
17850 =item SYNOPSIS
17851
17852 =item DESCRIPTION
17853
17854 =item MEMORY STORE
17855
17856 =item ADVISORY LOCKING
17857
17858 =item SPEED
17859
17860 =item CANONICAL REPRESENTATION
17861
17862 =item FORWARD COMPATIBILITY
17863
17864 utf8 data, restricted hashes, files from future versions of Storable
17865
17866 =item ERROR REPORTING
17867
17868 =item WIZARDS ONLY
17869
17870 =over 4
17871
17872 =item Hooks
17873
17874 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
17875 I<serialized>, ..
17876
17877 =item Predicates
17878
17879 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
17880 C<Storable::is_retrieving>
17881
17882 =item Recursion
17883
17884 =item Deep Cloning
17885
17886 =back
17887
17888 =item Storable magic
17889
17890 =item EXAMPLES
17891
17892 =item WARNING
17893
17894 =item BUGS
17895
17896 =item CREDITS
17897
17898 =item AUTHOR
17899
17900 =item SEE ALSO
17901
17902 =back
17903
17904 =head2 Switch - A switch statement for Perl
17905
17906 =over 4
17907
17908 =item VERSION
17909
17910 =item SYNOPSIS
17911
17912 =item BACKGROUND
17913
17914 =item DESCRIPTION
17915
17916 =over 4
17917
17918 =item Allowing fall-through
17919
17920 =item Automating fall-through
17921
17922 =item Alternative syntax
17923
17924 =item Higher-order Operations
17925
17926 =back
17927
17928 =item DEPENDENCIES
17929
17930 =item AUTHOR
17931
17932 =item BUGS
17933
17934 =item LIMITATION
17935
17936 =item COPYRIGHT
17937
17938 =back
17939
17940 =head2 Symbol - manipulate Perl symbols and their names
17941
17942 =over 4
17943
17944 =item SYNOPSIS
17945
17946 =item DESCRIPTION
17947
17948 =back
17949
17950 =head2 Sys::Hostname - Try every conceivable way to get hostname
17951
17952 =over 4
17953
17954 =item SYNOPSIS
17955
17956 =item DESCRIPTION
17957
17958 =item AUTHOR
17959
17960 =back
17961
17962 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
17963 interface to the UNIX syslog(3) calls
17964
17965 =over 4
17966
17967 =item SYNOPSIS
17968
17969 =item DESCRIPTION
17970
17971 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
17972 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
17973 in 5.004_02), closelog
17974
17975 =item EXAMPLES
17976
17977 =item SEE ALSO
17978
17979 =item AUTHOR
17980
17981 =back
17982
17983 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
17984 Perl interface to the UNIX syslog(3) calls
17985
17986 =over 4
17987
17988 =item SYNOPSIS
17989
17990 =item DESCRIPTION
17991
17992 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
17993 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
17994 in 5.004_02), closelog
17995
17996 =item EXAMPLES
17997
17998 =item SEE ALSO
17999
18000 =item AUTHOR
18001
18002 =back
18003
18004 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18005
18006 =over 4
18007
18008 =item SYNOPSIS
18009
18010 =item DESCRIPTION
18011
18012 =item DIAGNOSTICS
18013
18014 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18015 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18016 comma allowed after filehandle, No name for escape sequence %s
18017
18018 =item ENVIRONMENT
18019
18020 ANSI_COLORS_DISABLED
18021
18022 =item RESTRICTIONS
18023
18024 =item NOTES
18025
18026 =item SEE ALSO
18027
18028 =item AUTHORS
18029
18030 =item LICENSE
18031
18032 =back
18033
18034 =head2 Term::Cap - Perl termcap interface
18035
18036 =over 4
18037
18038 =item SYNOPSIS
18039
18040 =item DESCRIPTION
18041
18042 =over 4
18043
18044 =item METHODS
18045
18046 =back
18047
18048 =back
18049
18050 B<Tgetent>, OSPEED, TERM
18051
18052 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18053
18054 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18055
18056 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18057
18058 B<Trequire>
18059
18060 =over 4
18061
18062 =item EXAMPLES
18063
18064 =item COPYRIGHT AND LICENSE
18065
18066 =item AUTHOR
18067
18068 =item SEE ALSO
18069
18070 =back
18071
18072 =head2 Term::Complete - Perl word completion module
18073
18074 =over 4
18075
18076 =item SYNOPSIS
18077
18078 =item DESCRIPTION
18079
18080 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18081
18082 =item DIAGNOSTICS
18083
18084 =item BUGS
18085
18086 =item AUTHOR
18087
18088 =back
18089
18090 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18091 no real package is found, substitutes stubs instead of basic functions.
18092
18093 =over 4
18094
18095 =item SYNOPSIS
18096
18097 =item DESCRIPTION
18098
18099 =item Minimal set of supported functions
18100
18101 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18102 C<MinLine>, C<findConsole>, Attribs, C<Features>
18103
18104 =item Additional supported functions
18105
18106 C<tkRunning>, C<ornaments>, C<newTTY>
18107
18108 =item EXPORTS
18109
18110 =item ENVIRONMENT
18111
18112 =item CAVEATS
18113
18114 =back
18115
18116 =head2 Test - provides a simple framework for writing test scripts
18117
18118 =over 4
18119
18120 =item SYNOPSIS
18121
18122 =item DESCRIPTION
18123
18124 =over 4
18125
18126 =item Functions
18127
18128 B<plan>
18129
18130 =back
18131
18132 =back
18133
18134 B<_to_value>
18135
18136 B<ok>
18137
18138 =over 4
18139
18140 =item TEST TYPES
18141
18142 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18143
18144 =item ONFAIL
18145
18146 =item BUGS and CAVEATS
18147
18148 =item NOTE
18149
18150 =item SEE ALSO
18151
18152 =item AUTHOR
18153
18154 =back
18155
18156 =head2 Test::Builder - Backend for building test libraries
18157
18158 =over 4
18159
18160 =item SYNOPSIS
18161
18162 =item DESCRIPTION
18163
18164 =over 4
18165
18166 =item Construction
18167
18168 B<new>
18169
18170 =back
18171
18172 =back
18173
18174 =over 4
18175
18176 =item Setting up tests
18177
18178 B<exported_to>
18179
18180 =back
18181
18182 B<plan>
18183
18184 B<expected_tests>
18185
18186 B<no_plan>
18187
18188 B<skip_all>
18189
18190 =over 4
18191
18192 =item Running tests
18193
18194 B<ok>
18195
18196 =back
18197
18198 B<is_eq>, B<is_num>
18199
18200 B<isnt_eq>, B<isnt_num>
18201
18202 B<like>, B<unlike>
18203
18204 B<maybe_regex>
18205
18206 B<cmp_ok>
18207
18208 B<BAILOUT>
18209
18210 B<skip>
18211
18212 B<todo_skip>
18213
18214 B<skip_rest>
18215
18216 =over 4
18217
18218 =item Test style
18219
18220 B<level>
18221
18222 =back
18223
18224 B<use_numbers>
18225
18226 B<no_header>, B<no_ending>
18227
18228 =over 4
18229
18230 =item Output
18231
18232 B<diag>
18233
18234 =back
18235
18236 B<_print>
18237
18238 B<output>, B<failure_output>, B<todo_output>
18239
18240 =over 4
18241
18242 =item Test Status and Info
18243
18244 B<current_test>
18245
18246 =back
18247
18248 B<summary>
18249
18250 B<details>  I<UNIMPLEMENTED>, B<todo>
18251
18252 B<caller>
18253
18254 B<_sanity_check>
18255
18256 B<_whoa>
18257
18258 B<_my_exit>
18259
18260 =over 4
18261
18262 =item EXAMPLES
18263
18264 =item SEE ALSO
18265
18266 =item AUTHORS
18267
18268 =item COPYRIGHT
18269
18270 =back
18271
18272 =head2 Test::Harness - run perl standard test scripts with statistics
18273
18274 =over 4
18275
18276 =item SYNOPSIS
18277
18278 =item DESCRIPTION
18279
18280 =over 4
18281
18282 =item The test script output
18283
18284 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18285 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18286 else>
18287
18288 =item Taint mode
18289
18290 =item Configuration variables.
18291
18292 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18293
18294 =item Failure
18295
18296 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18297 Failed>
18298
18299 =item Functions
18300
18301 B<runtests>
18302
18303 =back
18304
18305 =back
18306
18307 B<_all_ok>
18308
18309 B<_globdir>
18310
18311 B<_run_all_tests>
18312
18313 B<_mk_leader>
18314
18315 B<_leader_width>
18316
18317 =over 4
18318
18319 =item EXPORT
18320
18321 =item DIAGNOSTICS
18322
18323 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18324 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18325 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18326 %s>, C<FAILED--Further testing stopped: %s>
18327
18328 =item ENVIRONMENT
18329
18330 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18331 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18332 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18333
18334 =item EXAMPLE
18335
18336 =item SEE ALSO
18337
18338 =item AUTHORS
18339
18340 =item TODO
18341
18342 =item BUGS
18343
18344 =back
18345
18346 =head2 Test::Harness::Assert - simple assert
18347
18348 =over 4
18349
18350 =item SYNOPSIS
18351
18352 =item DESCRIPTION
18353
18354 =over 4
18355
18356 =item Functions
18357
18358 B<assert>
18359
18360 =back
18361
18362 =back
18363
18364 =over 4
18365
18366 =item AUTHOR
18367
18368 =item SEE ALSO
18369
18370 =back
18371
18372 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18373
18374 =over 4
18375
18376 =item SYNOPSIS
18377
18378 =item DESCRIPTION
18379
18380 =back
18381
18382 =head2 Test::Harness::Straps - detailed analysis of test results
18383
18384 =over 4
18385
18386 =item SYNOPSIS
18387
18388 =item DESCRIPTION
18389
18390 =over 4
18391
18392 =item Construction
18393
18394 B<new>
18395
18396 =back
18397
18398 =back
18399
18400 B<_init>
18401
18402 =over 4
18403
18404 =item Analysis
18405
18406 B<analyze>
18407
18408 =back
18409
18410 B<analyze_fh>
18411
18412 B<analyze_file>
18413
18414 B<_switches>
18415
18416 B<_INC2PERL5LIB>
18417
18418 B<_filtered_INC>
18419
18420 B<_restore_PERL5LIB>
18421
18422 =over 4
18423
18424 =item Parsing
18425
18426 B<_is_comment>
18427
18428 =back
18429
18430 B<_is_header>
18431
18432 B<_is_test>
18433
18434 B<_is_bail_out>
18435
18436 B<_reset_file_state>
18437
18438 =over 4
18439
18440 =item Results
18441
18442 B<_detailize>
18443
18444 =back
18445
18446 =over 4
18447
18448 =item EXAMPLES
18449
18450 =item AUTHOR
18451
18452 =item SEE ALSO
18453
18454 =back
18455
18456 =head2 Test::More - yet another framework for writing test scripts
18457
18458 =over 4
18459
18460 =item SYNOPSIS
18461
18462 =item DESCRIPTION
18463
18464 =over 4
18465
18466 =item I love it when a plan comes together
18467
18468 =back
18469
18470 =back
18471
18472 =over 4
18473
18474 =item Test names
18475
18476 =item I'm ok, you're not ok.
18477
18478 B<ok>
18479
18480 =back
18481
18482 B<is>, B<isnt>
18483
18484 B<like>
18485
18486 B<unlike>
18487
18488 B<cmp_ok>
18489
18490 B<can_ok>
18491
18492 B<isa_ok>
18493
18494 B<pass>, B<fail>
18495
18496 =over 4
18497
18498 =item Diagnostics
18499
18500 B<diag>
18501
18502 =back
18503
18504 =over 4
18505
18506 =item Module tests
18507
18508 B<use_ok>
18509
18510 =back
18511
18512 B<require_ok>
18513
18514 =over 4
18515
18516 =item Conditional tests
18517
18518 B<SKIP: BLOCK>
18519
18520 =back
18521
18522 B<TODO: BLOCK>, B<todo_skip>
18523
18524 =over 4
18525
18526 =item Comparison functions
18527
18528 B<is_deeply>
18529
18530 =back
18531
18532 B<eq_array>
18533
18534 B<eq_hash>
18535
18536 B<eq_set>
18537
18538 =over 4
18539
18540 =item Extending and Embedding Test::More
18541
18542 B<builder>
18543
18544 =back
18545
18546 =over 4
18547
18548 =item NOTES
18549
18550 =item BUGS and CAVEATS
18551
18552 Making your own ok(), The eq_* family has some caveats, Test::Harness
18553 upgrades
18554
18555 =item HISTORY
18556
18557 =item SEE ALSO
18558
18559 =item AUTHORS
18560
18561 =item COPYRIGHT
18562
18563 =back
18564
18565 =head2 Test::Simple - Basic utilities for writing tests.
18566
18567 =over 4
18568
18569 =item SYNOPSIS
18570
18571 =item DESCRIPTION
18572
18573 B<ok>
18574
18575 =back
18576
18577 =over 4
18578
18579 =item EXAMPLE
18580
18581 =item CAVEATS
18582
18583 =item NOTES
18584
18585 =item HISTORY
18586
18587 =item SEE ALSO
18588
18589 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18590 L<Test::Harness>
18591
18592 =item AUTHORS
18593
18594 =item COPYRIGHT
18595
18596 =back
18597
18598 =head2 Test::Tutorial - A tutorial about writing really basic tests
18599
18600 =over 4
18601
18602 =item DESCRIPTION
18603
18604 =over 4
18605
18606 =item Nuts and bolts of testing.
18607
18608 =item Where to start?
18609
18610 =item Names
18611
18612 =item Test the manual
18613
18614 =item Sometimes the tests are wrong
18615
18616 =item Testing lots of values
18617
18618 =item Informative names
18619
18620 =item Skipping tests
18621
18622 =item Todo tests
18623
18624 =item Testing with taint mode.
18625
18626 =back
18627
18628 =item FOOTNOTES
18629
18630 =item AUTHORS
18631
18632 =item COPYRIGHT
18633
18634 =back
18635
18636 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18637
18638 =over 4
18639
18640 =item SYNOPSIS
18641
18642 =item DESCRIPTION
18643
18644 =item EXAMPLE
18645
18646 =back
18647
18648 =head2 Text::Balanced - Extract delimited text sequences from strings.
18649
18650 =over 4
18651
18652 =item SYNOPSIS
18653
18654 =item DESCRIPTION
18655
18656 =over 4
18657
18658 =item General behaviour in list contexts
18659
18660 [0], [1], [2]
18661
18662 =item General behaviour in scalar and void contexts
18663
18664 =item A note about prefixes
18665
18666 =item C<extract_delimited>
18667
18668 =item C<extract_bracketed>
18669
18670 =item C<extract_tagged>
18671
18672 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18673 [0], [1], [2], [3], [4], [5]
18674
18675 =item C<gen_extract_tagged>
18676
18677 =item C<extract_quotelike>
18678
18679 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18680
18681 =item C<extract_quotelike> and "here documents"
18682
18683 [0], [1], [2], [3], [4], [5], [6], [7..10]
18684
18685 =item C<extract_codeblock>
18686
18687 =item C<extract_multiple>
18688
18689 =item C<gen_delimited_pat>
18690
18691 =back
18692
18693 =item DIAGNOSTICS
18694
18695  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
18696 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18697 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
18698 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18699 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18700 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18701 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18702 after dereferencer>, C<Did not find expected opening bracket at %s>,
18703 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18704 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18705 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18706 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18707 tag>
18708
18709 =item AUTHOR
18710
18711 =item BUGS AND IRRITATIONS
18712
18713 =item COPYRIGHT
18714
18715 =back
18716
18717 =head2 Text::ParseWords - parse text into an array of tokens or array of
18718 arrays
18719
18720 =over 4
18721
18722 =item SYNOPSIS
18723
18724 =item DESCRIPTION
18725
18726 =item EXAMPLES
18727
18728 =item AUTHORS
18729
18730 =back
18731
18732 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18733 by Knuth
18734
18735 =over 4
18736
18737 =item SYNOPSIS
18738
18739 =item DESCRIPTION
18740
18741 =item EXAMPLES
18742
18743 =item LIMITATIONS
18744
18745 =item AUTHOR
18746
18747 =back
18748
18749 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18750 unexpand(1)
18751
18752 =over 4
18753
18754 =item SYNOPSIS
18755
18756 =item DESCRIPTION
18757
18758 =item BUGS
18759
18760 =item AUTHOR
18761
18762 =back
18763
18764 =head2 Text::Wrap - line wrapping to form simple paragraphs
18765
18766 =over 4
18767
18768 =item SYNOPSIS
18769
18770 =item DESCRIPTION
18771
18772 =item OVERRIDES
18773
18774 =item EXAMPLE
18775
18776 =item AUTHOR
18777
18778 =back
18779
18780 =head2 Thread - manipulate threads in Perl
18781
18782 =over 4
18783
18784 =item CAVEAT
18785
18786 =item SYNOPSIS
18787
18788 =item DESCRIPTION
18789
18790 =item FUNCTIONS
18791
18792 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18793 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18794 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18795
18796 =item METHODS
18797
18798 join, eval, detach, equal, tid, flags, done
18799
18800 =item LIMITATIONS
18801
18802 =item SEE ALSO
18803
18804 =back
18805
18806 =head2 Thread::Queue - thread-safe queues
18807
18808 =over 4
18809
18810 =item SYNOPSIS
18811
18812 =item DESCRIPTION
18813
18814 =item FUNCTIONS AND METHODS
18815
18816 new, enqueue LIST, dequeue, dequeue_nb, pending
18817
18818 =item SEE ALSO
18819
18820 =back
18821
18822 =head2 Thread::Semaphore - thread-safe semaphores
18823
18824 =over 4
18825
18826 =item SYNOPSIS
18827
18828 =item DESCRIPTION
18829
18830 =item FUNCTIONS AND METHODS
18831
18832 new, new NUMBER, down, down NUMBER, up, up NUMBER
18833
18834 =back
18835
18836 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18837
18838 =over 4
18839
18840 =item SYNOPSIS
18841
18842 =item DESCRIPTION
18843
18844 =item BUGS
18845
18846 =back
18847
18848 =head2 Thread::Specific - thread-specific keys
18849
18850 =over 4
18851
18852 =item SYNOPSIS
18853
18854 =item DESCRIPTION
18855
18856 =back
18857
18858 =head2 Tie::Array - base class for tied arrays
18859
18860 =over 4
18861
18862 =item SYNOPSIS
18863
18864 =item DESCRIPTION
18865
18866 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
18867 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
18868 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
18869 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
18870
18871 =item CAVEATS
18872
18873 =item AUTHOR
18874
18875 =back
18876
18877 =head2 Tie::File - Access the lines of a disk file via a Perl array
18878
18879 =over 4
18880
18881 =item SYNOPSIS
18882
18883 =item DESCRIPTION
18884
18885 =over 4
18886
18887 =item C<recsep>
18888
18889 =item C<autochomp>
18890
18891 =item C<mode>
18892
18893 =item C<memory>
18894
18895 =item C<dw_size>
18896
18897 =item Option Format
18898
18899 =back
18900
18901 =item Public Methods
18902
18903 =over 4
18904
18905 =item C<flock>
18906
18907 =item C<autochomp>
18908
18909 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
18910
18911 =back
18912
18913 =item Tying to an already-opened filehandle
18914
18915 =item Deferred Writing
18916
18917 =over 4
18918
18919 =item Autodeferring
18920
18921 =back
18922
18923 =item CAVEATS
18924
18925 =item SUBCLASSING
18926
18927 =item WHAT ABOUT C<DB_File>?
18928
18929 =item AUTHOR
18930
18931 =item LICENSE
18932
18933 =item WARRANTY
18934
18935 =item THANKS
18936
18937 =item TODO
18938
18939 =back
18940
18941 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
18942 handles
18943
18944 =over 4
18945
18946 =item SYNOPSIS
18947
18948 =item DESCRIPTION
18949
18950 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
18951 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
18952 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
18953 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
18954
18955 =item MORE INFORMATION
18956
18957 =item COMPATIBILITY
18958
18959 =back
18960
18961 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
18962 tied hashes
18963
18964 =over 4
18965
18966 =item SYNOPSIS
18967
18968 =item DESCRIPTION
18969
18970 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
18971 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
18972
18973 =item Inheriting from B<Tie::StdHash>
18974
18975 =item Inheriting from B<Tie::ExtraHash>
18976
18977 =item C<UNTIE> and C<DESTROY>
18978
18979 =item MORE INFORMATION
18980
18981 =back
18982
18983 =head2 Tie::Memoize - add data to hash when needed
18984
18985 =over 4
18986
18987 =item SYNOPSIS
18988
18989 =item DESCRIPTION
18990
18991 =item Inheriting from B<Tie::Memoize>
18992
18993 =item EXAMPLE
18994
18995 =item BUGS
18996
18997 =item AUTHOR
18998
18999 =back
19000
19001 =head2 Tie::RefHash - use references as hash keys
19002
19003 =over 4
19004
19005 =item SYNOPSIS
19006
19007 =item DESCRIPTION
19008
19009 =item EXAMPLE
19010
19011 =item AUTHOR
19012
19013 =item VERSION
19014
19015 =item SEE ALSO
19016
19017 =back
19018
19019 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19020 scalars
19021
19022 =over 4
19023
19024 =item SYNOPSIS
19025
19026 =item DESCRIPTION
19027
19028 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19029
19030 =item MORE INFORMATION
19031
19032 =back
19033
19034 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19035
19036 =over 4
19037
19038 =item SYNOPSIS
19039
19040 =item DESCRIPTION
19041
19042 =item CAVEATS
19043
19044 =back
19045
19046 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19047 timers
19048
19049 =over 4
19050
19051 =item SYNOPSIS
19052
19053 =item DESCRIPTION
19054
19055 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19056 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19057 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19058 getitimer ( $which )
19059
19060 =item EXAMPLES
19061
19062 =item C API
19063
19064 =item CAVEATS
19065
19066 =item AUTHORS
19067
19068 =item REVISION
19069
19070 =item COPYRIGHT
19071
19072 =back
19073
19074 =head2 Time::Local - efficiently compute time from local and GMT time
19075
19076 =over 4
19077
19078 =item SYNOPSIS
19079
19080 =item DESCRIPTION
19081
19082 =item IMPLEMENTATION
19083
19084 =item BUGS
19085
19086 =back
19087
19088 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19089 function
19090
19091 =over 4
19092
19093 =item SYNOPSIS
19094
19095 =item DESCRIPTION
19096
19097 =item NOTE
19098
19099 =item AUTHOR
19100
19101 =back
19102
19103 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19104 function
19105
19106 =over 4
19107
19108 =item SYNOPSIS
19109
19110 =item DESCRIPTION
19111
19112 =item NOTE
19113
19114 =item AUTHOR
19115
19116 =back
19117
19118 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19119
19120 =over 4
19121
19122 =item SYNOPSIS
19123
19124 =item DESCRIPTION
19125
19126 =item AUTHOR
19127
19128 =back
19129
19130 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19131
19132 =over 4
19133
19134 =item SYNOPSIS
19135
19136 =item DESCRIPTION
19137
19138 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19139 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19140
19141 =back
19142
19143 =head2 Unicode::Collate - Unicode Collation Algorithm
19144
19145 =over 4
19146
19147 =item SYNOPSIS
19148
19149 =item DESCRIPTION
19150
19151 =over 4
19152
19153 =item Constructor and Tailoring
19154
19155 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19156 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19157 undefChar, katakana_before_hiragana, upper_before_lower
19158
19159 =item Methods for Collation
19160
19161 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19162 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19163 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19164 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19165 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19166 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19167 $Collator-E<gt>viewSortKey($string)>, C<$position =
19168 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19169 $Collator-E<gt>index($string, $substring)>
19170
19171 =item Other Methods
19172
19173 UCA_Version, Base_Unicode_Version
19174
19175 =item EXPORT
19176
19177 =item TODO
19178
19179 =item CAVEAT
19180
19181 =item BUGS
19182
19183 =back
19184
19185 =item AUTHOR
19186
19187 =item SEE ALSO
19188
19189 http://www.unicode.org/unicode/reports/tr10/,
19190 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19191 http://www.unicode.org/unicode/reports/tr15/,
19192 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19193
19194 =back
19195
19196 =head2 Unicode::Normalize - Unicode Normalization Forms
19197
19198 =over 4
19199
19200 =item SYNOPSIS
19201
19202 =item DESCRIPTION
19203
19204 =over 4
19205
19206 =item Normalization Forms
19207
19208 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19209 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19210 C<$normalized_string = normalize($form_name, $string)>
19211
19212 =item Decomposition and Composition
19213
19214 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19215 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19216 reorder($string)>, C<$composed_string   = compose($string)>
19217
19218 =item Quick Check
19219
19220 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19221 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19222 check($form_name, $string)>
19223
19224 =item Character Data
19225
19226 C<$canonical_decomposed = getCanon($codepoint)>,
19227 C<$compatibility_decomposed = getCompat($codepoint)>,
19228 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19229 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19230 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19231 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19232 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19233
19234 =item EXPORT
19235
19236 =back
19237
19238 =item AUTHOR
19239
19240 =item SEE ALSO
19241
19242 http://www.unicode.org/unicode/reports/tr15/,
19243 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19244
19245 =back
19246
19247 =head2 Unicode::UCD - Unicode character database
19248
19249 =over 4
19250
19251 =item SYNOPSIS
19252
19253 =item DESCRIPTION
19254
19255 =back
19256
19257 =over 4
19258
19259 =item charinfo
19260
19261 =back
19262
19263 =over 4
19264
19265 =item charblock
19266
19267 =back
19268
19269 =over 4
19270
19271 =item charscript
19272
19273 =back
19274
19275 =over 4
19276
19277 =item charblocks
19278
19279 =back
19280
19281 =over 4
19282
19283 =item charscripts
19284
19285 =back
19286
19287 =over 4
19288
19289 =item Blocks versus Scripts
19290
19291 =item Matching Scripts and Blocks
19292
19293 =item Code Point Arguments
19294
19295 =item charinrange
19296
19297 =back
19298
19299 =over 4
19300
19301 =item compexcl
19302
19303 =back
19304
19305 =over 4
19306
19307 =item casefold
19308
19309 =back
19310
19311 =over 4
19312
19313 =item casespec
19314
19315 =back
19316
19317 =over 4
19318
19319 =item Unicode::UCD::UnicodeVersion
19320
19321 =back
19322
19323 =over 4
19324
19325 =item Implementation Note
19326
19327 =back
19328
19329 =over 4
19330
19331 =item BUGS
19332
19333 =item AUTHOR
19334
19335 =back
19336
19337 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19338 functions
19339
19340 =over 4
19341
19342 =item SYNOPSIS
19343
19344 =item DESCRIPTION
19345
19346 =item NOTE
19347
19348 =item AUTHOR
19349
19350 =back
19351
19352 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19353 functions
19354
19355 =over 4
19356
19357 =item SYNOPSIS
19358
19359 =item DESCRIPTION
19360
19361 =over 4
19362
19363 =item System Specifics
19364
19365 =back
19366
19367 =item NOTE
19368
19369 =item AUTHOR
19370
19371 =item HISTORY
19372
19373 March 18th, 2000
19374
19375 =back
19376
19377 =head2 Win32 - Interfaces to some Win32 API Functions
19378
19379 =over 4
19380
19381 =item DESCRIPTION
19382
19383 =over 4
19384
19385 =item Alphabetical Listing of Win32 Functions
19386
19387 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19388 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19389 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19390 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19391 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19392 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19393 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
19394 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19395 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19396 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19397 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19398 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19399 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19400 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19401 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19402 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19403 Win32::UnregisterServer(LIBRARYNAME)
19404
19405 =back
19406
19407 =back
19408
19409 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
19410
19411 =over 4
19412
19413 =item SYNOPSIS
19414
19415 =item DESCRIPTION
19416
19417 =back
19418
19419 =over 4
19420
19421 =item NOTES
19422
19423 =item AUTHOR
19424
19425 =back
19426
19427 =head2 XSLoader - Dynamically load C libraries into Perl code
19428
19429 =over 4
19430
19431 =item SYNOPSIS
19432
19433 =item DESCRIPTION
19434
19435 =item AUTHOR
19436
19437 =back
19438
19439 =head1 AUXILIARY DOCUMENTATION
19440
19441 Here should be listed all the extra programs' documentation, but they
19442 don't all have manual pages yet:
19443
19444 =over 4
19445
19446 =item a2p
19447
19448 =item s2p
19449
19450 =item find2perl
19451
19452 =item h2ph
19453
19454 =item c2ph
19455
19456 =item h2xs
19457
19458 =item xsubpp
19459
19460 =item pod2man
19461
19462 =item wrapsuid
19463
19464 =back
19465
19466 =head1 AUTHOR
19467
19468 Larry Wall <F<larry@wall.org>>, with the help of oodles
19469 of other folks.
19470