pod/perltoc.pod

   1
   2 =head1 NAME
   3
   4 perltoc - perl documentation table of contents
   5
   6 =head1 DESCRIPTION
   7
   8 This page provides a brief table of contents for the rest of the Perl
   9 documentation set.  It is meant to be scanned quickly or grepped
  10 through to locate the proper section you're looking for.
  11
  12 =head1 BASIC DOCUMENTATION
  13
  14 =head2 perl - Practical Extraction and Report Language
  15
  16 =over 4
  17
  18 =item SYNOPSIS
  19
  20 =over 4
  21
  22 =item Overview
  23
  24 =item Tutorials
  25
  26 =item Reference Manual
  27
  28 =item Internals and C Language Interface
  29
  30 =item Miscellaneous
  31
  32 =item Language-Specific
  33
  34 =item Platform-Specific
  35
  36 =back
  37
  38 =item DESCRIPTION
  39
  40 =item AVAILABILITY
  41
  42 =item ENVIRONMENT
  43
  44 =item AUTHOR
  45
  46 =item FILES
  47
  48 =item SEE ALSO
  49
  50 =item DIAGNOSTICS
  51
  52 =item BUGS
  53
  54 =item NOTES
  55
  56 =back
  57
  58 =head2 perlintro -- a brief introduction and overview of Perl
  59
  60 =over 4
  61
  62 =item DESCRIPTION
  63
  64 =over 4
  65
  66 =item What is Perl?
  67
  68 =item Running Perl programs
  69
  70 =item Basic syntax overview
  71
  72 =item Perl variable types
  73
  74 Scalars, Arrays, Hashes
  75
  76 =item Variable scoping
  77
  78 =item Conditional and looping constructs
  79
  80 if, while, for, foreach
  81
  82 =item Builtin operators and functions
  83
  84 Arithmetic, Numeric comparison, String comparison, Boolean logic,
  85 Miscellaneous
  86
  87 =item Files and I/O
  88
  89 =item Regular expressions
  90
  91 Simple matching, Simple substitution, More complex regular expressions,
  92 Parentheses for capturing, Other regexp features
  93
  94 =item Writing subroutines
  95
  96 =item OO Perl
  97
  98 =item Using Perl modules
  99
 100 =back
 101
 102 =item AUTHOR
 103
 104 =back
 105
 106 =head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11
 107 21:32:23 $)
 108
 109 =over 4
 110
 111 =item DESCRIPTION
 112
 113 =over 4
 114
 115 =item perlfaq: Structural overview of the FAQ.
 116
 117 =item L<perlfaq1>: General Questions About Perl
 118
 119 =item L<perlfaq2>: Obtaining and Learning about Perl
 120
 121 =item L<perlfaq3>: Programming Tools
 122
 123 =item L<perlfaq4>: Data Manipulation
 124
 125 =item L<perlfaq5>: Files and Formats
 126
 127 =item L<perlfaq6>: Regular Expressions
 128
 129 =item L<perlfaq7>: General Perl Language Issues
 130
 131 =item L<perlfaq8>: System Interaction
 132
 133 =item L<perlfaq9>: Networking
 134
 135 =back
 136
 137 =item About the perlfaq documents
 138
 139 =over 4
 140
 141 =item Where to get the perlfaq
 142
 143 =item How to contribute to the perlfaq
 144
 145 =item What will happen if you mail your Perl programming problems to the
 146 authors
 147
 148 =back
 149
 150 =item Credits
 151
 152 =item Author and Copyright Information
 153
 154 =over 4
 155
 156 =item Bundled Distributions
 157
 158 =item Disclaimer
 159
 160 =back
 161
 162 =item Changes
 163
 164 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98,
 165 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
 166 Initial Release: 11/March/97
 167
 168 =back
 169
 170 =head2 perlbook - Perl book information
 171
 172 =over 4
 173
 174 =item DESCRIPTION
 175
 176 =back
 177
 178 =head2 perlsyn - Perl syntax
 179
 180 =over 4
 181
 182 =item DESCRIPTION
 183
 184 =over 4
 185
 186 =item Declarations
 187
 188 =item Simple statements
 189
 190 =item Compound statements
 191
 192 =item Loop Control
 193
 194 =item For Loops
 195
 196 =item Foreach Loops
 197
 198 =item Basic BLOCKs and Switch Statements
 199
 200 =item Goto
 201
 202 =item PODs: Embedded Documentation
 203
 204 =item Plain Old Comments (Not!)
 205
 206 =back
 207
 208 =back
 209
 210 =head2 perldata - Perl data types
 211
 212 =over 4
 213
 214 =item DESCRIPTION
 215
 216 =over 4
 217
 218 =item Variable names
 219
 220 =item Context
 221
 222 =item Scalar values
 223
 224 =item Scalar value constructors
 225
 226 =item List value constructors
 227
 228 =item Slices
 229
 230 =item Typeglobs and Filehandles
 231
 232 =back
 233
 234 =item SEE ALSO
 235
 236 =back
 237
 238 =head2 perlop - Perl operators and precedence
 239
 240 =over 4
 241
 242 =item SYNOPSIS
 243
 244 =item DESCRIPTION
 245
 246 =over 4
 247
 248 =item Terms and List Operators (Leftward)
 249
 250 =item The Arrow Operator
 251
 252 =item Auto-increment and Auto-decrement
 253
 254 =item Exponentiation
 255
 256 =item Symbolic Unary Operators
 257
 258 =item Binding Operators
 259
 260 =item Multiplicative Operators
 261
 262 =item Additive Operators
 263
 264 =item Shift Operators
 265
 266 =item Named Unary Operators
 267
 268 =item Relational Operators
 269
 270 =item Equality Operators
 271
 272 =item Bitwise And
 273
 274 =item Bitwise Or and Exclusive Or
 275
 276 =item C-style Logical And
 277
 278 =item C-style Logical Or
 279
 280 =item Range Operators
 281
 282 =item Conditional Operator
 283
 284 =item Assignment Operators
 285
 286 =item Comma Operator
 287
 288 =item List Operators (Rightward)
 289
 290 =item Logical Not
 291
 292 =item Logical And
 293
 294 =item Logical or and Exclusive Or
 295
 296 =item C Operators Missing From Perl
 297
 298 unary &, unary *, (TYPE)
 299
 300 =item Quote and Quote-like Operators
 301
 302 =item Regexp Quote-Like Operators
 303
 304 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 305 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 306 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 307 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 308
 309 =item Gory details of parsing quoted constructs
 310
 311 Finding the end, Removal of backslashes before delimiters, Interpolation,
 312 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 313 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 314 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 315 regular expressions
 316
 317 =item I/O Operators
 318
 319 =item Constant Folding
 320
 321 =item Bitwise String Operators
 322
 323 =item Integer Arithmetic
 324
 325 =item Floating-point Arithmetic
 326
 327 =item Bigger Numbers
 328
 329 =back
 330
 331 =back
 332
 333 =head2 perlsub - Perl subroutines
 334
 335 =over 4
 336
 337 =item SYNOPSIS
 338
 339 =item DESCRIPTION
 340
 341 =over 4
 342
 343 =item Private Variables via my()
 344
 345 =item Persistent Private Variables
 346
 347 =item Temporary Values via local()
 348
 349 =item Lvalue subroutines
 350
 351 Lvalue subroutines are EXPERIMENTAL
 352
 353 =item Passing Symbol Table Entries (typeglobs)
 354
 355 =item When to Still Use local()
 356
 357 =item Pass by Reference
 358
 359 =item Prototypes
 360
 361 =item Constant Functions
 362
 363 =item Overriding Built-in Functions
 364
 365 =item Autoloading
 366
 367 =item Subroutine Attributes
 368
 369 =back
 370
 371 =item SEE ALSO
 372
 373 =back
 374
 375 =head2 perlfunc - Perl builtin functions
 376
 377 =over 4
 378
 379 =item DESCRIPTION
 380
 381 =over 4
 382
 383 =item Perl Functions by Category
 384
 385 Functions for SCALARs or strings, Regular expressions and pattern matching,
 386 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 387 Functions for real %HASHes, Input and output functions, Functions for fixed
 388 length data or records, Functions for filehandles, files, or directories,
 389 Keywords related to the control flow of your perl program, Keywords related
 390 to scoping, Miscellaneous functions, Functions for processes and process
 391 groups, Keywords related to perl modules, Keywords related to classes and
 392 object-orientedness, Low-level socket functions, System V interprocess
 393 communication functions, Fetching user and group info, Fetching network
 394 info, Time-related functions, Functions new in perl5, Functions obsoleted
 395 in perl5
 396
 397 =item Portability
 398
 399 =item Alphabetical Listing of Perl Functions
 400
 401 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 402 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 403 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
 404 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
 405 chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr
 406 NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir
 407 DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt
 408 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR,
 409 defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR,
 410 dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval
 411 BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp,
 412 fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
 413 FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE,
 414 getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority
 415 WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname
 416 NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname
 417 NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE,
 418 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
 419 gethostent, getnetent, getprotoent, getservent, setpwent, setgrent,
 420 sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent
 421 STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent,
 422 endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR,
 423 glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep
 424 EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index
 425 STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join
 426 EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc,
 427 lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen
 428 SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock THING, log EXPR, log,
 429 lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK,
 430 mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv
 431 ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES,
 432 next LABEL, next, no Module VERSION LIST, no Module VERSION, no Module
 433 LIST, no Module, oct EXPR, oct, open FILEHANDLE,EXPR, open
 434 FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
 435 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
 436 EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package
 437 NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
 438 SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
 439 FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
 440 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
 441 quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 442 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 443 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 444 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
 445 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
 446 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
 447 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
 448 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
 449 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 450 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 451 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 452 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 453 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 454 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 455 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 456 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 457 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 458 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
 459 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
 460 study, sub BLOCK, sub NAME, sub NAME BLOCK, substr
 461 EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 462 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 463 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 464 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 465 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 466 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 467 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 468 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 469 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 470 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 471 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
 472 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
 473 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
 474 LIST, write FILEHANDLE, write EXPR, write, y///
 475
 476 =back
 477
 478 =back
 479
 480 =head2 perlreftut - Mark's very short tutorial about references
 481
 482 =over 4
 483
 484 =item DESCRIPTION
 485
 486 =item Who Needs Complicated Data Structures?
 487
 488 =item The Solution
 489
 490 =item Syntax
 491
 492 =over 4
 493
 494 =item Making References
 495
 496 =item Using References
 497
 498 =back
 499
 500 =item An Example
 501
 502 =item Arrow Rule
 503
 504 =item Solution
 505
 506 =item The Rest
 507
 508 =item Summary
 509
 510 =item Credits
 511
 512 =over 4
 513
 514 =item Distribution Conditions
 515
 516 =back
 517
 518 =back
 519
 520 =head2 perldsc - Perl Data Structures Cookbook
 521
 522 =over 4
 523
 524 =item DESCRIPTION
 525
 526 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 527 more elaborate constructs
 528
 529 =item REFERENCES
 530
 531 =item COMMON MISTAKES
 532
 533 =item CAVEAT ON PRECEDENCE
 534
 535 =item WHY YOU SHOULD ALWAYS C<use strict>
 536
 537 =item DEBUGGING
 538
 539 =item CODE EXAMPLES
 540
 541 =item ARRAYS OF ARRAYS
 542
 543 =over 4
 544
 545 =item Declaration of an ARRAY OF ARRAYS
 546
 547 =item Generation of an ARRAY OF ARRAYS
 548
 549 =item Access and Printing of an ARRAY OF ARRAYS
 550
 551 =back
 552
 553 =item HASHES OF ARRAYS
 554
 555 =over 4
 556
 557 =item Declaration of a HASH OF ARRAYS
 558
 559 =item Generation of a HASH OF ARRAYS
 560
 561 =item Access and Printing of a HASH OF ARRAYS
 562
 563 =back
 564
 565 =item ARRAYS OF HASHES
 566
 567 =over 4
 568
 569 =item Declaration of an ARRAY OF HASHES
 570
 571 =item Generation of an ARRAY OF HASHES
 572
 573 =item Access and Printing of an ARRAY OF HASHES
 574
 575 =back
 576
 577 =item HASHES OF HASHES
 578
 579 =over 4
 580
 581 =item Declaration of a HASH OF HASHES
 582
 583 =item Generation of a HASH OF HASHES
 584
 585 =item Access and Printing of a HASH OF HASHES
 586
 587 =back
 588
 589 =item MORE ELABORATE RECORDS
 590
 591 =over 4
 592
 593 =item Declaration of MORE ELABORATE RECORDS
 594
 595 =item Declaration of a HASH OF COMPLEX RECORDS
 596
 597 =item Generation of a HASH OF COMPLEX RECORDS
 598
 599 =back
 600
 601 =item Database Ties
 602
 603 =item SEE ALSO
 604
 605 =item AUTHOR
 606
 607 =back
 608
 609 =head2 perlrequick - Perl regular expressions quick start
 610
 611 =over 4
 612
 613 =item DESCRIPTION
 614
 615 =item The Guide
 616
 617 =over 4
 618
 619 =item Simple word matching
 620
 621 =item Using character classes
 622
 623 =item Matching this or that
 624
 625 =item Grouping things and hierarchical matching
 626
 627 =item Extracting matches
 628
 629 =item Matching repetitions
 630
 631 =item More matching
 632
 633 =item Search and replace
 634
 635 =item The split operator
 636
 637 =back
 638
 639 =item BUGS
 640
 641 =item SEE ALSO
 642
 643 =item AUTHOR AND COPYRIGHT
 644
 645 =over 4
 646
 647 =item Acknowledgments
 648
 649 =back
 650
 651 =back
 652
 653 =head2 perlpod - the Plain Old Documentation format
 654
 655 =over 4
 656
 657 =item DESCRIPTION
 658
 659 =over 4
 660
 661 =item Ordinary Paragraph
 662
 663 =item Verbatim Paragraph
 664
 665 =item Command Paragraph
 666
 667 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 668 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 669 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 670 I<formatname>>, C<=for I<formatname> I<text...>>
 671
 672 =item Formatting Codes
 673
 674 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 675 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 676 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 677 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 678 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 679 (zero-effect) formatting code
 680
 681 =item The Intent
 682
 683 =item Embedding Pods in Perl Modules
 684
 685 =item Hints for Writing Pod
 686
 687 =back
 688
 689 =item SEE ALSO
 690
 691 =item AUTHOR
 692
 693 =back
 694
 695 =head2 perlpodspec - Plain Old Documentation: format specification and
 696 notes
 697
 698 =over 4
 699
 700 =item DESCRIPTION
 701
 702 =item Pod Definitions
 703
 704 =item Pod Commands
 705
 706 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 707 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 708
 709 =item Pod Formatting Codes
 710
 711 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 712 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 713 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 714 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 715 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 716 contains non-breaking spaces
 717
 718 =item Notes on Implementing Pod Processors
 719
 720 =item About LE<lt>...E<gt> Codes
 721
 722 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 723
 724 =item About =over...=back Regions
 725
 726 =item About Data Paragraphs and "=begin/=end" Regions
 727
 728 =item SEE ALSO
 729
 730 =item AUTHOR
 731
 732 =back
 733
 734 =head2 perlstyle - Perl style guide
 735
 736 =over 4
 737
 738 =item DESCRIPTION
 739
 740 =back
 741
 742 =head2 perltrap - Perl traps for the unwary
 743
 744 =over 4
 745
 746 =item DESCRIPTION
 747
 748 =over 4
 749
 750 =item Awk Traps
 751
 752 =item C Traps
 753
 754 =item Sed Traps
 755
 756 =item Shell Traps
 757
 758 =item Perl Traps
 759
 760 =item Perl4 to Perl5 Traps
 761
 762 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 763 Traps, General data type traps, Context Traps - scalar, list contexts,
 764 Precedence Traps, General Regular Expression Traps using s///, etc,
 765 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 766
 767 =item Discontinuance, Deprecation, and BugFix traps
 768
 769 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 770 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 771 Discontinuance, Deprecation, Discontinuance, Discontinuance
 772
 773 =item Parsing Traps
 774
 775 Parsing, Parsing, Parsing, Parsing, Parsing
 776
 777 =item Numerical Traps
 778
 779 Numerical, Numerical, Numerical, Bitwise string ops
 780
 781 =item General data type traps
 782
 783 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 784 (Constants), (Scalars), (Variable Suicide)
 785
 786 =item Context Traps - scalar, list contexts
 787
 788 (list context), (scalar context), (scalar context), (list, builtin)
 789
 790 =item Precedence Traps
 791
 792 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 793 Precedence
 794
 795 =item General Regular Expression Traps using s///, etc.
 796
 797 Regular Expression, Regular Expression, Regular Expression, Regular
 798 Expression, Regular Expression, Regular Expression, Regular Expression,
 799 Regular Expression
 800
 801 =item Subroutine, Signal, Sorting Traps
 802
 803 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 804
 805 =item OS Traps
 806
 807 (SysV), (SysV)
 808
 809 =item Interpolation Traps
 810
 811 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 812 Interpolation, Interpolation, Interpolation, Interpolation
 813
 814 =item DBM Traps
 815
 816 DBM, DBM
 817
 818 =item Unclassified Traps
 819
 820 C<require>/C<do> trap using returned value, C<split> on empty string with
 821 LIMIT specified
 822
 823 =back
 824
 825 =back
 826
 827 =head2 perlrun - how to execute the Perl interpreter
 828
 829 =over 4
 830
 831 =item SYNOPSIS
 832
 833 =item DESCRIPTION
 834
 835 =over 4
 836
 837 =item #! and quoting on non-Unix systems
 838
 839 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 840
 841 =item Location of Perl
 842
 843 =item Command Switches
 844
 845 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 846 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 847 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 848 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 849 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 850 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 851 B<-X>, B<-x> I<directory>
 852
 853 =back
 854
 855 =item ENVIRONMENT
 856
 857 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 858 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 859 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 860 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
 861 SYS$LOGIN (specific to the VMS port)
 862
 863 =back
 864
 865 =head2 perldiag - various Perl diagnostics
 866
 867 =over 4
 868
 869 =item DESCRIPTION
 870
 871 =back
 872
 873 =head2 perllexwarn - Perl Lexical Warnings
 874
 875 =over 4
 876
 877 =item DESCRIPTION
 878
 879 =over 4
 880
 881 =item Default Warnings and Optional Warnings
 882
 883 =item What's wrong with B<-w> and C<$^W>
 884
 885 =item Controlling Warnings from the Command Line
 886
 887 B<-w>, B<-W>, B<-X>
 888
 889 =item Backward Compatibility
 890
 891 =item Category Hierarchy
 892
 893 =item Fatal Warnings
 894
 895 =item Reporting Warnings from a Module
 896
 897 =back
 898
 899 =item TODO
 900
 901 =item SEE ALSO
 902
 903 =item AUTHOR
 904
 905 =back
 906
 907 =head2 perldebtut - Perl debugging tutorial
 908
 909 =over 4
 910
 911 =item DESCRIPTION
 912
 913 =item use strict
 914
 915 =item Looking at data and -w and v
 916
 917 =item help
 918
 919 =item Stepping through code
 920
 921 =item Placeholder for a, w, t, T
 922
 923 =item REGULAR EXPRESSIONS
 924
 925 =item OUTPUT TIPS
 926
 927 =item CGI
 928
 929 =item GUIs
 930
 931 =item SUMMARY
 932
 933 =item SEE ALSO
 934
 935 =item AUTHOR
 936
 937 =item CONTRIBUTORS
 938
 939 =back
 940
 941 =head2 perldebug - Perl debugging
 942
 943 =over 4
 944
 945 =item DESCRIPTION
 946
 947 =item The Perl Debugger
 948
 949 =over 4
 950
 951 =item Debugger Commands
 952
 953 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 954 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 955 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 956 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 957 subname [condition], b postpone subname [condition], b load filename, b
 958 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 959 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 960 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
 961 command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or
 962 ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
 963
 964 =item Configurable Options
 965
 966 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 967 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 968 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 969 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
 970 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
 971 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
 972 C<NonStop>
 973
 974 =item Debugger input/output
 975
 976 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 977 listing
 978
 979 =item Debugging compile-time statements
 980
 981 =item Debugger Customization
 982
 983 =item Readline Support
 984
 985 =item Editor Support for Debugging
 986
 987 =item The Perl Profiler
 988
 989 =back
 990
 991 =item Debugging regular expressions
 992
 993 =item Debugging memory usage
 994
 995 =item SEE ALSO
 996
 997 =item BUGS
 998
 999 =back
1000
1001 =head2 perlvar - Perl predefined variables
1002
1003 =over 4
1004
1005 =item DESCRIPTION
1006
1007 =over 4
1008
1009 =item Predefined Names
1010
1011 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1012 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1013 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1014 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1015 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1016 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1017 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1018 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1019 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1020 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1021 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1022 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1023 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1024 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1025 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1026 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1027 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1028 IO::Handle->format_line_break_characters EXPR,
1029 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1030 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1031 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1032 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1033 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1034 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1035 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1036 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1037 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1038 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1039 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1040 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1041
1042 =item Error Indicators
1043
1044 =item Technical Note on the Syntax of Variable Names
1045
1046 =back
1047
1048 =item BUGS
1049
1050 =back
1051
1052 =head2 perllol - Manipulating Arrays of Arrays in Perl
1053
1054 =over 4
1055
1056 =item DESCRIPTION
1057
1058 =over 4
1059
1060 =item Declaration and Access of Arrays of Arrays
1061
1062 =item Growing Your Own
1063
1064 =item Access and Printing
1065
1066 =item Slices
1067
1068 =back
1069
1070 =item SEE ALSO
1071
1072 =item AUTHOR
1073
1074 =back
1075
1076 =head2 perlopentut - tutorial on opening things in Perl
1077
1078 =over 4
1079
1080 =item DESCRIPTION
1081
1082 =item Open E<agrave> la shell
1083
1084 =over 4
1085
1086 =item Simple Opens
1087
1088 =item Pipe Opens
1089
1090 =item The Minus File
1091
1092 =item Mixing Reads and Writes
1093
1094 =item Filters
1095
1096 =back
1097
1098 =item Open E<agrave> la C
1099
1100 =over 4
1101
1102 =item Permissions E<agrave> la mode
1103
1104 =back
1105
1106 =item Obscure Open Tricks
1107
1108 =over 4
1109
1110 =item Re-Opening Files (dups)
1111
1112 =item Dispelling the Dweomer
1113
1114 =item Paths as Opens
1115
1116 =item Single Argument Open
1117
1118 =item Playing with STDIN and STDOUT
1119
1120 =back
1121
1122 =item Other I/O Issues
1123
1124 =over 4
1125
1126 =item Opening Non-File Files
1127
1128 =item Binary Files
1129
1130 =item File Locking
1131
1132 =back
1133
1134 =item SEE ALSO
1135
1136 =item AUTHOR and COPYRIGHT
1137
1138 =item HISTORY
1139
1140 =back
1141
1142 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1143
1144 =over 4
1145
1146 =item DESCRIPTION
1147
1148 =item The Basic Principle
1149
1150 =item Packing Text
1151
1152 =item Packing Numbers
1153
1154 =over 4
1155
1156 =item Integers
1157
1158 =item Unpacking a Stack Frame
1159
1160 =item How to Eat an Egg on a Net
1161
1162 =item Floating point Numbers
1163
1164 =back
1165
1166 =item Exotic Templates
1167
1168 =over 4
1169
1170 =item Bit Strings
1171
1172 =item Uuencoding
1173
1174 =item Doing Sums
1175
1176 =item  Unicode
1177
1178 =item Another Portable Binary Encoding
1179
1180 =back
1181
1182 =item Lengths and Widths
1183
1184 =over 4
1185
1186 =item String Lengths
1187
1188 =item Dynamic Templates
1189
1190 =back
1191
1192 =item Packing and Unpacking C Structures
1193
1194 =over 4
1195
1196 =item The Alignment Pit
1197
1198 =item Alignment, Take 2
1199
1200 =item Alignment, Take 3
1201
1202 =item Pointers for How to Use Them
1203
1204 =back
1205
1206 =item Pack Recipes
1207
1208 =item Funnies Section
1209
1210 =item Authors
1211
1212 =back
1213
1214 =head2 perlretut - Perl regular expressions tutorial
1215
1216 =over 4
1217
1218 =item DESCRIPTION
1219
1220 =item Part 1: The basics
1221
1222 =over 4
1223
1224 =item Simple word matching
1225
1226 =item Using character classes
1227
1228 =item Matching this or that
1229
1230 =item Grouping things and hierarchical matching
1231
1232 =item Extracting matches
1233
1234 =item Matching repetitions
1235
1236 =item Building a regexp
1237
1238 =item Using regular expressions in Perl
1239
1240 =back
1241
1242 =item Part 2: Power tools
1243
1244 =over 4
1245
1246 =item More on characters, strings, and character classes
1247
1248 =item Compiling and saving regular expressions
1249
1250 =item Embedding comments and modifiers in a regular expression
1251
1252 =item Non-capturing groupings
1253
1254 =item Looking ahead and looking behind
1255
1256 =item Using independent subexpressions to prevent backtracking
1257
1258 =item Conditional expressions
1259
1260 =item A bit of magic: executing Perl code in a regular expression
1261
1262 =item Pragmas and debugging
1263
1264 =back
1265
1266 =item BUGS
1267
1268 =item SEE ALSO
1269
1270 =item AUTHOR AND COPYRIGHT
1271
1272 =over 4
1273
1274 =item Acknowledgments
1275
1276 =back
1277
1278 =back
1279
1280 =head2 perlre - Perl regular expressions
1281
1282 =over 4
1283
1284 =item DESCRIPTION
1285
1286 i, m, s, x
1287
1288 =over 4
1289
1290 =item Regular Expressions
1291
1292 [1], [2], [3], cntrl, graph, print, punct, xdigit
1293
1294 =item Extended Patterns
1295
1296 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1297 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1298 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1299 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1300
1301 =item Backtracking
1302
1303 =item Version 8 Regular Expressions
1304
1305 =item Warning on \1 vs $1
1306
1307 =item Repeated patterns matching zero-length substring
1308
1309 =item Combining pieces together
1310
1311 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1312 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1313 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1314 C<(?(condition)yes-pattern|no-pattern)>
1315
1316 =item Creating custom RE engines
1317
1318 =back
1319
1320 =item BUGS
1321
1322 =item SEE ALSO
1323
1324 =back
1325
1326 =head2 perlref - Perl references and nested data structures
1327
1328 =over 4
1329
1330 =item NOTE
1331
1332 =item DESCRIPTION
1333
1334 =over 4
1335
1336 =item Making References
1337
1338 =item Using References
1339
1340 =item Symbolic references
1341
1342 =item Not-so-symbolic references
1343
1344 =item Pseudo-hashes: Using an array as a hash
1345
1346 =item Function Templates
1347
1348 =back
1349
1350 =item WARNING
1351
1352 =item SEE ALSO
1353
1354 =back
1355
1356 =head2 perlform - Perl formats
1357
1358 =over 4
1359
1360 =item DESCRIPTION
1361
1362 =over 4
1363
1364 =item Format Variables
1365
1366 =back
1367
1368 =item NOTES
1369
1370 =over 4
1371
1372 =item Footers
1373
1374 =item Accessing Formatting Internals
1375
1376 =back
1377
1378 =item WARNINGS
1379
1380 =back
1381
1382 =head2 perlboot - Beginner's Object-Oriented Tutorial
1383
1384 =over 4
1385
1386 =item DESCRIPTION
1387
1388 =over 4
1389
1390 =item If we could talk to the animals...
1391
1392 =item Introducing the method invocation arrow
1393
1394 =item Invoking a barnyard
1395
1396 =item The extra parameter of method invocation
1397
1398 =item Calling a second method to simplify things
1399
1400 =item Inheriting the windpipes
1401
1402 =item A few notes about @ISA
1403
1404 =item Overriding the methods
1405
1406 =item Starting the search from a different place
1407
1408 =item The SUPER way of doing things
1409
1410 =item Where we're at so far...
1411
1412 =item A horse is a horse, of course of course -- or is it?
1413
1414 =item Invoking an instance method
1415
1416 =item Accessing the instance data
1417
1418 =item How to build a horse
1419
1420 =item Inheriting the constructor
1421
1422 =item Making a method work with either classes or instances
1423
1424 =item Adding parameters to a method
1425
1426 =item More interesting instances
1427
1428 =item A horse of a different color
1429
1430 =item Summary
1431
1432 =back
1433
1434 =item SEE ALSO
1435
1436 =item COPYRIGHT
1437
1438 =back
1439
1440 =head2 perltoot - Tom's object-oriented tutorial for perl
1441
1442 =over 4
1443
1444 =item DESCRIPTION
1445
1446 =item Creating a Class
1447
1448 =over 4
1449
1450 =item Object Representation
1451
1452 =item Class Interface
1453
1454 =item Constructors and Instance Methods
1455
1456 =item Planning for the Future: Better Constructors
1457
1458 =item Destructors
1459
1460 =item Other Object Methods
1461
1462 =back
1463
1464 =item Class Data
1465
1466 =over 4
1467
1468 =item Accessing Class Data
1469
1470 =item Debugging Methods
1471
1472 =item Class Destructors
1473
1474 =item Documenting the Interface
1475
1476 =back
1477
1478 =item Aggregation
1479
1480 =item Inheritance
1481
1482 =over 4
1483
1484 =item Overridden Methods
1485
1486 =item Multiple Inheritance
1487
1488 =item UNIVERSAL: The Root of All Objects
1489
1490 =back
1491
1492 =item Alternate Object Representations
1493
1494 =over 4
1495
1496 =item Arrays as Objects
1497
1498 =item Closures as Objects
1499
1500 =back
1501
1502 =item AUTOLOAD: Proxy Methods
1503
1504 =over 4
1505
1506 =item Autoloaded Data Methods
1507
1508 =item Inherited Autoloaded Data Methods
1509
1510 =back
1511
1512 =item Metaclassical Tools
1513
1514 =over 4
1515
1516 =item Class::Struct
1517
1518 =item Data Members as Variables
1519
1520 =back
1521
1522 =item NOTES
1523
1524 =over 4
1525
1526 =item Object Terminology
1527
1528 =back
1529
1530 =item SEE ALSO
1531
1532 =item AUTHOR AND COPYRIGHT
1533
1534 =item COPYRIGHT
1535
1536 =over 4
1537
1538 =item Acknowledgments
1539
1540 =back
1541
1542 =back
1543
1544 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1545
1546 =over 4
1547
1548 =item DESCRIPTION
1549
1550 =item Class Data in a Can
1551
1552 =item Class Data as Package Variables
1553
1554 =over 4
1555
1556 =item Putting All Your Eggs in One Basket
1557
1558 =item Inheritance Concerns
1559
1560 =item The Eponymous Meta-Object
1561
1562 =item Indirect References to Class Data
1563
1564 =item Monadic Classes
1565
1566 =item Translucent Attributes
1567
1568 =back
1569
1570 =item Class Data as Lexical Variables
1571
1572 =over 4
1573
1574 =item Privacy and Responsibility
1575
1576 =item File-Scoped Lexicals
1577
1578 =item More Inheritance Concerns
1579
1580 =item Locking the Door and Throwing Away the Key
1581
1582 =item Translucency Revisited
1583
1584 =back
1585
1586 =item NOTES
1587
1588 =item SEE ALSO
1589
1590 =item AUTHOR AND COPYRIGHT
1591
1592 =item ACKNOWLEDGEMENTS
1593
1594 =item HISTORY
1595
1596 =back
1597
1598 =head2 perlobj - Perl objects
1599
1600 =over 4
1601
1602 =item DESCRIPTION
1603
1604 =over 4
1605
1606 =item An Object is Simply a Reference
1607
1608 =item A Class is Simply a Package
1609
1610 =item A Method is Simply a Subroutine
1611
1612 =item Method Invocation
1613
1614 =item Indirect Object Syntax
1615
1616 =item Default UNIVERSAL methods
1617
1618 isa(CLASS), can(METHOD), VERSION( [NEED] )
1619
1620 =item Destructors
1621
1622 =item Summary
1623
1624 =item Two-Phased Garbage Collection
1625
1626 =back
1627
1628 =item SEE ALSO
1629
1630 =back
1631
1632 =head2 perlbot - Bag'o Object Tricks (the BOT)
1633
1634 =over 4
1635
1636 =item DESCRIPTION
1637
1638 =item OO SCALING TIPS
1639
1640 =item INSTANCE VARIABLES
1641
1642 =item SCALAR INSTANCE VARIABLES
1643
1644 =item INSTANCE VARIABLE INHERITANCE
1645
1646 =item OBJECT RELATIONSHIPS
1647
1648 =item OVERRIDING SUPERCLASS METHODS
1649
1650 =item USING RELATIONSHIP WITH SDBM
1651
1652 =item THINKING OF CODE REUSE
1653
1654 =item CLASS CONTEXT AND THE OBJECT
1655
1656 =item INHERITING A CONSTRUCTOR
1657
1658 =item DELEGATION
1659
1660 =back
1661
1662 =head2 perltie - how to hide an object class in a simple variable
1663
1664 =over 4
1665
1666 =item SYNOPSIS
1667
1668 =item DESCRIPTION
1669
1670 =over 4
1671
1672 =item Tying Scalars
1673
1674 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1675 DESTROY this
1676
1677 =item Tying Arrays
1678
1679 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1680 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1681 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1682 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1683 this
1684
1685 =item Tying Hashes
1686
1687 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1688 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1689 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1690
1691 =item Tying FileHandles
1692
1693 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1694 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1695 DESTROY this
1696
1697 =item UNTIE this
1698
1699 =item The C<untie> Gotcha
1700
1701 =back
1702
1703 =item SEE ALSO
1704
1705 =item BUGS
1706
1707 =item AUTHOR
1708
1709 =back
1710
1711 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1712 safe subprocesses, sockets, and semaphores)
1713
1714 =over 4
1715
1716 =item DESCRIPTION
1717
1718 =item Signals
1719
1720 =over 4
1721
1722 =item Handling the SIGHUP Signal in Daemons
1723
1724 =back
1725
1726 =item Named Pipes
1727
1728 =over 4
1729
1730 =item Deferred Signals
1731
1732 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1733 triggered by operating system state
1734
1735 =back
1736
1737 =item Using open() for IPC
1738
1739 =over 4
1740
1741 =item Filehandles
1742
1743 =item Background Processes
1744
1745 =item Complete Dissociation of Child from Parent
1746
1747 =item Safe Pipe Opens
1748
1749 =item Bidirectional Communication with Another Process
1750
1751 =item Bidirectional Communication with Yourself
1752
1753 =back
1754
1755 =item Sockets: Client/Server Communication
1756
1757 =over 4
1758
1759 =item Internet Line Terminators
1760
1761 =item Internet TCP Clients and Servers
1762
1763 =item Unix-Domain TCP Clients and Servers
1764
1765 =back
1766
1767 =item TCP Clients with IO::Socket
1768
1769 =over 4
1770
1771 =item A Simple Client
1772
1773 C<Proto>, C<PeerAddr>, C<PeerPort>
1774
1775 =item A Webget Client
1776
1777 =item Interactive Client with IO::Socket
1778
1779 =back
1780
1781 =item TCP Servers with IO::Socket
1782
1783 Proto, LocalPort, Listen, Reuse
1784
1785 =item UDP: Message Passing
1786
1787 =item SysV IPC
1788
1789 =item NOTES
1790
1791 =item BUGS
1792
1793 =item AUTHOR
1794
1795 =item SEE ALSO
1796
1797 =back
1798
1799 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
1800
1801 =over 4
1802
1803 =item SYNOPSIS
1804
1805 =item DESCRIPTION
1806
1807 =over 4
1808
1809 =item Behavior of other Perl features in forked pseudo-processes
1810
1811 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1812 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1813 files, directories and network sockets
1814
1815 =item Resource limits
1816
1817 =item Killing the parent process
1818
1819 =item Lifetime of the parent process and pseudo-processes
1820
1821 =item CAVEATS AND LIMITATIONS
1822
1823 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1824 Global state maintained by XSUBs, Interpreter embedded in larger
1825 application, Thread-safety of extensions
1826
1827 =back
1828
1829 =item BUGS
1830
1831 =item AUTHOR
1832
1833 =item SEE ALSO
1834
1835 =back
1836
1837 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1838
1839 =over 4
1840
1841 =item SYNOPSIS
1842
1843 =item DESCRIPTION
1844
1845 =item Storing numbers
1846
1847 =item Numeric operators and numeric conversions
1848
1849 =item Flavors of Perl numeric operations
1850
1851 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1852 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1853 integer>, Operators which expect an integer, Operators which expect a
1854 string
1855
1856 =item AUTHOR
1857
1858 =item SEE ALSO
1859
1860 =back
1861
1862 =head2 perlthrtut - tutorial on threads in Perl
1863
1864 =over 4
1865
1866 =item DESCRIPTION
1867
1868 =item Status
1869
1870 =item What Is A Thread Anyway?
1871
1872 =item Threaded Program Models
1873
1874 =over 4
1875
1876 =item Boss/Worker
1877
1878 =item Work Crew
1879
1880 =item Pipeline
1881
1882 =back
1883
1884 =item Native threads
1885
1886 =item What kind of threads are Perl threads?
1887
1888 =item Threadsafe Modules
1889
1890 =item Thread Basics
1891
1892 =over 4
1893
1894 =item Basic Thread Support
1895
1896 =item A Note about the Examples
1897
1898 =item Creating Threads
1899
1900 =item Giving up control
1901
1902 =item Waiting For A Thread To Exit
1903
1904 =item Ignoring A Thread
1905
1906 =back
1907
1908 =item Threads And Data
1909
1910 =over 4
1911
1912 =item Shared And Unshared Data
1913
1914 =item Thread Pitfalls: Races
1915
1916 =back
1917
1918 =item Synchronization and control
1919
1920 =over 4
1921
1922 =item Controlling access: lock()
1923
1924 =item A Thread Pitfall: Deadlocks
1925
1926 =item Queues: Passing Data Around
1927
1928 =item Semaphores: Synchronizing Data Access
1929
1930 =item Basic semaphores
1931
1932 =item Advanced Semaphores
1933
1934 =item cond_wait() and cond_signal()
1935
1936 =back
1937
1938 =item General Thread Utility Routines
1939
1940 =over 4
1941
1942 =item What Thread Am I In?
1943
1944 =item Thread IDs
1945
1946 =item Are These Threads The Same?
1947
1948 =item What Threads Are Running?
1949
1950 =back
1951
1952 =item A Complete Example
1953
1954 =item Performance considerations
1955
1956 =item Threadsafety of System Libraries
1957
1958 =item Conclusion
1959
1960 =item Bibliography
1961
1962 =over 4
1963
1964 =item Introductory Texts
1965
1966 =item OS-Related References
1967
1968 =item Other References
1969
1970 =back
1971
1972 =item Acknowledgements
1973
1974 =item AUTHOR
1975
1976 =item Copyrights
1977
1978 =back
1979
1980 =head2 perlothrtut - old tutorial on threads in Perl
1981
1982 =over 4
1983
1984 =item DESCRIPTION
1985
1986 =item What Is A Thread Anyway?
1987
1988 =item Threaded Program Models
1989
1990 =over 4
1991
1992 =item Boss/Worker
1993
1994 =item Work Crew
1995
1996 =item Pipeline
1997
1998 =back
1999
2000 =item Native threads
2001
2002 =item What kind of threads are perl threads?
2003
2004 =item Threadsafe Modules
2005
2006 =item Thread Basics
2007
2008 =over 4
2009
2010 =item Basic Thread Support
2011
2012 =item Creating Threads
2013
2014 =item Giving up control
2015
2016 =item Waiting For A Thread To Exit
2017
2018 =item Errors In Threads
2019
2020 =item Ignoring A Thread
2021
2022 =back
2023
2024 =item Threads And Data
2025
2026 =over 4
2027
2028 =item Shared And Unshared Data
2029
2030 =item Thread Pitfall: Races
2031
2032 =item Controlling access: lock()
2033
2034 =item Thread Pitfall: Deadlocks
2035
2036 =item Queues: Passing Data Around
2037
2038 =back
2039
2040 =item Threads And Code
2041
2042 =over 4
2043
2044 =item Semaphores: Synchronizing Data Access
2045
2046 Basic semaphores, Advanced Semaphores
2047
2048 =item Attributes: Restricting Access To Subroutines
2049
2050 =item Subroutine Locks
2051
2052 =item Methods
2053
2054 =item Locking A Subroutine
2055
2056 =back
2057
2058 =item General Thread Utility Routines
2059
2060 =over 4
2061
2062 =item What Thread Am I In?
2063
2064 =item Thread IDs
2065
2066 =item Are These Threads The Same?
2067
2068 =item What Threads Are Running?
2069
2070 =back
2071
2072 =item A Complete Example
2073
2074 =item Conclusion
2075
2076 =item Bibliography
2077
2078 =over 4
2079
2080 =item Introductory Texts
2081
2082 =item OS-Related References
2083
2084 =item Other References
2085
2086 =back
2087
2088 =item Acknowledgements
2089
2090 =item AUTHOR
2091
2092 =item Copyrights
2093
2094 =back
2095
2096 =head2 perlport - Writing portable Perl
2097
2098 =over 4
2099
2100 =item DESCRIPTION
2101
2102 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2103 portable
2104
2105 =item ISSUES
2106
2107 =over 4
2108
2109 =item Newlines
2110
2111 =item Numbers endianness and Width
2112
2113 =item Files and Filesystems
2114
2115 =item System Interaction
2116
2117 =item Command names versus file pathnames
2118
2119 =item Interprocess Communication (IPC)
2120
2121 =item External Subroutines (XS)
2122
2123 =item Standard Modules
2124
2125 =item Time and Date
2126
2127 =item Character sets and character encoding
2128
2129 =item Internationalisation
2130
2131 =item System Resources
2132
2133 =item Security
2134
2135 =item Style
2136
2137 =back
2138
2139 =item CPAN Testers
2140
2141 Mailing list: cpan-testers@perl.org, Testing results:
2142 http://testers.cpan.org/
2143
2144 =item PLATFORMS
2145
2146 =over 4
2147
2148 =item Unix
2149
2150 =item DOS and Derivatives
2151
2152 =item S<Mac OS>
2153
2154 =item VMS
2155
2156 =item VOS
2157
2158 =item EBCDIC Platforms
2159
2160 =item Acorn RISC OS
2161
2162 =item Other perls
2163
2164 =back
2165
2166 =item FUNCTION IMPLEMENTATIONS
2167
2168 =over 4
2169
2170 =item Alphabetical Listing of Perl Functions
2171
2172 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2173 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2174 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2175 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2176 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2177 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2178 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2179 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2180 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2181 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2182 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2183 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2184 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2185 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2186 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2187 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2188 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2189 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2190 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2191 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2192 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2193 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2194 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2195 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2196 wait, waitpid PID,FLAGS
2197
2198 =back
2199
2200 =item CHANGES
2201
2202 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2203 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2204 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2205 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2206 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2207 v1.30, 03 August 1998, v1.23, 10 July 1998
2208
2209 =item Supported Platforms
2210
2211 =item SEE ALSO
2212
2213 =item AUTHORS / CONTRIBUTORS
2214
2215 =back
2216
2217 =head2 perllocale - Perl locale handling (internationalization and
2218 localization)
2219
2220 =over 4
2221
2222 =item DESCRIPTION
2223
2224 =item PREPARING TO USE LOCALES
2225
2226 =item USING LOCALES
2227
2228 =over 4
2229
2230 =item The use locale pragma
2231
2232 =item The setlocale function
2233
2234 =item Finding locales
2235
2236 =item LOCALE PROBLEMS
2237
2238 =item Temporarily fixing locale problems
2239
2240 =item Permanently fixing locale problems
2241
2242 =item Permanently fixing your system's locale configuration
2243
2244 =item Fixing system locale configuration
2245
2246 =item The localeconv function
2247
2248 =item I18N::Langinfo
2249
2250 =back
2251
2252 =item LOCALE CATEGORIES
2253
2254 =over 4
2255
2256 =item Category LC_COLLATE: Collation
2257
2258 =item Category LC_CTYPE: Character Types
2259
2260 =item Category LC_NUMERIC: Numeric Formatting
2261
2262 =item Category LC_MONETARY: Formatting of monetary amounts
2263
2264 =item LC_TIME
2265
2266 =item Other categories
2267
2268 =back
2269
2270 =item SECURITY
2271
2272 =item ENVIRONMENT
2273
2274 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2275 LC_NUMERIC, LC_TIME, LANG
2276
2277 =item NOTES
2278
2279 =over 4
2280
2281 =item Backward compatibility
2282
2283 =item I18N:Collate obsolete
2284
2285 =item Sort speed and memory use impacts
2286
2287 =item write() and LC_NUMERIC
2288
2289 =item Freely available locale definitions
2290
2291 =item I18n and l10n
2292
2293 =item An imperfect standard
2294
2295 =back
2296
2297 =item Unicode and UTF-8
2298
2299 =item BUGS
2300
2301 =over 4
2302
2303 =item Broken systems
2304
2305 =back
2306
2307 =item SEE ALSO
2308
2309 =item HISTORY
2310
2311 =back
2312
2313 =head2 perluniintro - Perl Unicode introduction
2314
2315 =over 4
2316
2317 =item DESCRIPTION
2318
2319 =over 4
2320
2321 =item Unicode
2322
2323 =item Perl's Unicode Support
2324
2325 =item Perl's Unicode Model
2326
2327 =item Unicode and EBCDIC
2328
2329 =item Creating Unicode
2330
2331 =item Handling Unicode
2332
2333 =item Legacy Encodings
2334
2335 =item Unicode I/O
2336
2337 =item Displaying Unicode As Text
2338
2339 =item Special Cases
2340
2341 =item Advanced Topics
2342
2343 =item Miscellaneous
2344
2345 =item Questions With Answers
2346
2347 =item Hexadecimal Notation
2348
2349 =item Further Resources
2350
2351 =back
2352
2353 =item UNICODE IN OLDER PERLS
2354
2355 =item SEE ALSO
2356
2357 =item ACKNOWLEDGMENTS
2358
2359 =item AUTHOR, COPYRIGHT, AND LICENSE
2360
2361 =back
2362
2363 =head2 perlunicode - Unicode support in Perl
2364
2365 =over 4
2366
2367 =item DESCRIPTION
2368
2369 =over 4
2370
2371 =item Important Caveats
2372
2373 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2374 to enable UTF-8/UTF-EBCDIC in scripts
2375
2376 =item Byte and Character Semantics
2377
2378 =item Effects of Character Semantics
2379
2380 =item Scripts
2381
2382 =item Blocks
2383
2384 =item User-Defined Character Properties
2385
2386 =item Character Encodings for Input and Output
2387
2388 =item Unicode Regular Expression Support Level
2389
2390 =item Unicode Encodings
2391
2392 =item Security Implications of Unicode
2393
2394 =item Unicode in Perl on EBCDIC
2395
2396 =item Locales
2397
2398 =item Using Unicode in XS
2399
2400 =back
2401
2402 =item BUGS
2403
2404 =over 4
2405
2406 =item Interaction with Locales
2407
2408 =item Interaction with Extensions
2409
2410 =item Speed
2411
2412 =back
2413
2414 =item SEE ALSO
2415
2416 =back
2417
2418 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2419
2420 =over 4
2421
2422 =item DESCRIPTION
2423
2424 =item COMMON CHARACTER CODE SETS
2425
2426 =over 4
2427
2428 =item ASCII
2429
2430 =item ISO 8859
2431
2432 =item Latin 1 (ISO 8859-1)
2433
2434 =item EBCDIC
2435
2436 =item 13 variant characters
2437
2438 =item 0037
2439
2440 =item 1047
2441
2442 =item POSIX-BC
2443
2444 =item Unicode code points versus EBCDIC code points
2445
2446 =item Remaining Perl Unicode problems in EBCDIC
2447
2448 =item Unicode and UTF
2449
2450 =item Using Encode
2451
2452 =back
2453
2454 =item SINGLE OCTET TABLES
2455
2456 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2457
2458 =item IDENTIFYING CHARACTER CODE SETS
2459
2460 =item CONVERSIONS
2461
2462 =over 4
2463
2464 =item tr///
2465
2466 =item iconv
2467
2468 =item C RTL
2469
2470 =back
2471
2472 =item OPERATOR DIFFERENCES
2473
2474 =item FUNCTION DIFFERENCES
2475
2476 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2477
2478 =item REGULAR EXPRESSION DIFFERENCES
2479
2480 =item SOCKETS
2481
2482 =item SORTING
2483
2484 =over 4
2485
2486 =item Ignore ASCII vs. EBCDIC sort differences.
2487
2488 =item MONO CASE then sort data.
2489
2490 =item Convert, sort data, then re convert.
2491
2492 =item Perform sorting on one type of machine only.
2493
2494 =back
2495
2496 =item TRANSFORMATION FORMATS
2497
2498 =over 4
2499
2500 =item URL decoding and encoding
2501
2502 =item uu encoding and decoding
2503
2504 =item Quoted-Printable encoding and decoding
2505
2506 =item Caesarian ciphers
2507
2508 =back
2509
2510 =item Hashing order and checksums
2511
2512 =item I18N AND L10N
2513
2514 =item MULTI OCTET CHARACTER SETS
2515
2516 =item OS ISSUES
2517
2518 =over 4
2519
2520 =item OS/400
2521
2522 IFS access
2523
2524 =item OS/390, z/OS
2525
2526 chcp, dataset access, OS/390, z/OS iconv, locales
2527
2528 =item VM/ESA?
2529
2530 =item POSIX-BC?
2531
2532 =back
2533
2534 =item BUGS
2535
2536 =item SEE ALSO
2537
2538 =item REFERENCES
2539
2540 =item HISTORY
2541
2542 =item AUTHOR
2543
2544 =back
2545
2546 =head2 perlsec - Perl security
2547
2548 =over 4
2549
2550 =item DESCRIPTION
2551
2552 =over 4
2553
2554 =item Laundering and Detecting Tainted Data
2555
2556 =item Switches On the "#!" Line
2557
2558 =item Cleaning Up Your Path
2559
2560 =item Security Bugs
2561
2562 =item Protecting Your Programs
2563
2564 =item Unicode
2565
2566 =back
2567
2568 =item SEE ALSO
2569
2570 =back
2571
2572 =head2 perlmod - Perl modules (packages and symbol tables)
2573
2574 =over 4
2575
2576 =item DESCRIPTION
2577
2578 =over 4
2579
2580 =item Packages
2581
2582 =item Symbol Tables
2583
2584 =item Package Constructors and Destructors
2585
2586 =item Perl Classes
2587
2588 =item Perl Modules
2589
2590 =item Making your module threadsafe
2591
2592 =back
2593
2594 =item SEE ALSO
2595
2596 =back
2597
2598 =head2 perlmodinstall - Installing CPAN Modules
2599
2600 =over 4
2601
2602 =item DESCRIPTION
2603
2604 =over 4
2605
2606 =item PREAMBLE
2607
2608 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2609 module (sometimes unnecessary), B<INSTALL> the module
2610
2611 =back
2612
2613 =item PORTABILITY
2614
2615 =item HEY
2616
2617 =item AUTHOR
2618
2619 =item COPYRIGHT
2620
2621 =back
2622
2623 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2624
2625 =over 4
2626
2627 =item DESCRIPTION
2628
2629 =item THE PERL MODULE LIBRARY
2630
2631 =over 4
2632
2633 =item Pragmatic Modules
2634
2635 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2636 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2637 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2638 threads, utf8, vars, vmsish, warnings, warnings::register
2639
2640 =item Standard Modules
2641
2642 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2643 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2644 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2645 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2646 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2647 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2648 Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
2649 Dumpvalue, Encode, English, Env, Exporter, Exporter::Heavy,
2650 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
2651 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2652 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
2653 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
2654 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2655 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2656 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2657 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2658 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2659 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2660 File::Spec::Mac, File::Spec::NW5, File::Spec::OS2, File::Spec::Unix,
2661 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
2662 FileHandle, Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2663 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2664 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2665 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2666 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2667 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2668 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2669 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2670 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2671 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2672 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2673 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2674 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2675 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2676 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, Pod::t::basic,
2677 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
2678 Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete,
2679 Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert,
2680 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2681 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2682 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2683 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2684 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2685 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2686 Unicode::UCD, User::grent, User::pwent, Win32
2687
2688 =item Extension Modules
2689
2690 =back
2691
2692 =item CPAN
2693
2694 =over 4
2695
2696 =item Africa
2697
2698 =item Asia
2699
2700 =item Central America
2701
2702 =item Europe
2703
2704 =item North America
2705
2706 =item Oceania
2707
2708 =item South America
2709
2710 =back
2711
2712 =item Modules: Creation, Use, and Abuse
2713
2714 =over 4
2715
2716 =item Guidelines for Module Creation
2717
2718 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2719
2720 =item Guidelines for Reusing Application Code
2721
2722 =back
2723
2724 =item NOTE
2725
2726 =back
2727
2728 =head2 perlmodstyle - Perl module style guide
2729
2730 =over 4
2731
2732 =item INTRODUCTION
2733
2734 =item QUICK CHECKLIST
2735
2736 =over 4
2737
2738 =item Before you start
2739
2740 =item The API
2741
2742 =item Stability
2743
2744 =item Documentation
2745
2746 =item Release considerations
2747
2748 =back
2749
2750 =item BEFORE YOU START WRITING A MODULE
2751
2752 =over 4
2753
2754 =item Has it been done before?
2755
2756 =item Do one thing and do it well
2757
2758 =item What's in a name?
2759
2760 =back
2761
2762 =item DESIGNING AND WRITING YOUR MODULE
2763
2764 =over 4
2765
2766 =item To OO or not to OO?
2767
2768 =item Designing your API
2769
2770 Write simple routines to do simple things, Separate functionality from
2771 output, Provide sensible shortcuts and defaults, Naming conventions,
2772 Parameter passing
2773
2774 =item Strictness and warnings
2775
2776 =item Backwards compatibility
2777
2778 =item Error handling and messages
2779
2780 =back
2781
2782 =item DOCUMENTING YOUR MODULE
2783
2784 =over 4
2785
2786 =item POD
2787
2788 =item README, INSTALL, release notes, changelogs
2789
2790 =back
2791
2792 =item RELEASE CONSIDERATIONS
2793
2794 =over 4
2795
2796 =item Version numbering
2797
2798 =item Pre-requisites
2799
2800 =item Testing
2801
2802 =item Packaging
2803
2804 =item Licensing
2805
2806 =back
2807
2808 =item COMMON PITFALLS
2809
2810 =over 4
2811
2812 =item Reinventing the wheel
2813
2814 =item Trying to do too much
2815
2816 =item Inappropriate documentation
2817
2818 =back
2819
2820 =item SEE ALSO
2821
2822 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2823 http://pause.perl.org/, Any good book on software engineering
2824
2825 =item AUTHOR
2826
2827 =back
2828
2829 =head2 perlnewmod - preparing a new module for distribution
2830
2831 =over 4
2832
2833 =item DESCRIPTION
2834
2835 =over 4
2836
2837 =item Warning
2838
2839 =item What should I make into a module?
2840
2841 =item Step-by-step: Preparing the ground
2842
2843 Look around, Check it's new, Discuss the need, Choose a name, Check again
2844
2845 =item Step-by-step: Making the module
2846
2847 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2848 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2849 documentation|perlpod>, Write tests, Write the README
2850
2851 =item Step-by-step: Distributing your module
2852
2853 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2854 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2855
2856 =back
2857
2858 =item AUTHOR
2859
2860 =item SEE ALSO
2861
2862 =back
2863
2864 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2865 2002/04/07 18:46:13 $)
2866
2867 =over 4
2868
2869 =item DESCRIPTION
2870
2871 =over 4
2872
2873 =item What is Perl?
2874
2875 =item Who supports Perl?  Who develops it?  Why is it free?
2876
2877 =item Which version of Perl should I use?
2878
2879 =item What are perl4 and perl5?
2880
2881 =item What is perl6?
2882
2883 =item How stable is Perl?
2884
2885 =item Is Perl difficult to learn?
2886
2887 =item How does Perl compare with other languages like Java, Python, REXX,
2888 Scheme, or Tcl?
2889
2890 =item Can I do [task] in Perl?
2891
2892 =item When shouldn't I program in Perl?
2893
2894 =item What's the difference between "perl" and "Perl"?
2895
2896 =item Is it a Perl program or a Perl script?
2897
2898 =item What is a JAPH?
2899
2900 =item Where can I get a list of Larry Wall witticisms?
2901
2902 =item How can I convince my sysadmin/supervisor/employees to use version
2903 5/5.6.1/Perl instead of some other language?
2904
2905 =back
2906
2907 =item AUTHOR AND COPYRIGHT
2908
2909 =back
2910
2911 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2912 $Date: 2002/04/26 16:56:35 $)
2913
2914 =over 4
2915
2916 =item DESCRIPTION
2917
2918 =over 4
2919
2920 =item What machines support Perl?  Where do I get it?
2921
2922 =item How can I get a binary version of Perl?
2923
2924 =item I don't have a C compiler on my system.  How can I compile perl?
2925
2926 =item I copied the Perl binary from one machine to another, but scripts
2927 don't work.
2928
2929 =item I grabbed the sources and tried to compile but gdbm/dynamic
2930 loading/malloc/linking/... failed.  How do I make it work?
2931
2932 =item What modules and extensions are available for Perl?  What is CPAN?
2933 What does CPAN/src/... mean?
2934
2935 =item Is there an ISO or ANSI certified version of Perl?
2936
2937 =item Where can I get information on Perl?
2938
2939 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2940
2941 =item Where should I post source code?
2942
2943 =item Perl Books
2944
2945 References, Tutorials, Task-Oriented, Special Topics
2946
2947 =item Perl in Magazines
2948
2949 =item Perl on the Net: FTP and WWW Access
2950
2951 =item What mailing lists are there for Perl?
2952
2953 =item Archives of comp.lang.perl.misc
2954
2955 =item Where can I buy a commercial version of Perl?
2956
2957 =item Where do I send bug reports?
2958
2959 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2960
2961 =back
2962
2963 =item AUTHOR AND COPYRIGHT
2964
2965 =back
2966
2967 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
2968 13:11:13 $)
2969
2970 =over 4
2971
2972 =item DESCRIPTION
2973
2974 =over 4
2975
2976 =item How do I do (anything)?
2977
2978 =item How can I use Perl interactively?
2979
2980 =item Is there a Perl shell?
2981
2982 =item How do I debug my Perl programs?
2983
2984 =item How do I profile my Perl programs?
2985
2986 =item How do I cross-reference my Perl programs?
2987
2988 =item Is there a pretty-printer (formatter) for Perl?
2989
2990 =item Is there a ctags for Perl?
2991
2992 =item Is there an IDE or Windows Perl Editor?
2993
2994 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
2995 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2996 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2997
2998 =item Where can I get Perl macros for vi?
2999
3000 =item Where can I get perl-mode for emacs?
3001
3002 =item How can I use curses with Perl?
3003
3004 =item How can I use X or Tk with Perl?
3005
3006 =item How can I generate simple menus without using CGI or Tk?
3007
3008 =item How can I make my Perl program run faster?
3009
3010 =item How can I make my Perl program take less memory?
3011
3012 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3013 stringification, Pass by reference, Tie large variables to disk
3014
3015 =item Is it unsafe to return a pointer to local data?
3016
3017 =item How can I free an array or hash so my program shrinks?
3018
3019 =item How can I make my CGI script more efficient?
3020
3021 =item How can I hide the source for my Perl program?
3022
3023 =item How can I compile my Perl program into byte code or C?
3024
3025 =item How can I compile Perl into Java?
3026
3027 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3028
3029 =item Can I write useful Perl programs on the command line?
3030
3031 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3032
3033 =item Where can I learn about CGI or Web programming in Perl?
3034
3035 =item Where can I learn about object-oriented Perl programming?
3036
3037 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3038
3039 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3040 my C program; what am I doing wrong?
3041
3042 =item When I tried to run my script, I got this message. What does it mean?
3043
3044 =item What's MakeMaker?
3045
3046 =back
3047
3048 =item AUTHOR AND COPYRIGHT
3049
3050 =back
3051
3052 =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
3053 07:04:25 $)
3054
3055 =over 4
3056
3057 =item DESCRIPTION
3058
3059 =item Data: Numbers
3060
3061 =over 4
3062
3063 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3064 numbers I should be getting (eg, 19.95)?
3065
3066 =item Why isn't my octal data interpreted correctly?
3067
3068 =item Does Perl have a round() function?  What about ceil() and floor()?
3069 Trig functions?
3070
3071 =item How do I convert between numeric representations?
3072
3073 How do I convert hexadecimal into decimal, How do I convert from decimal to
3074 hexadecimal, How do I convert from octal to decimal, How do I convert from
3075 decimal to octal, How do I convert from binary to decimal, How do I convert
3076 from decimal to binary
3077
3078 =item Why doesn't & work the way I want it to?
3079
3080 =item How do I multiply matrices?
3081
3082 =item How do I perform an operation on a series of integers?
3083
3084 =item How can I output Roman numerals?
3085
3086 =item Why aren't my random numbers random?
3087
3088 =item How do I get a random number between X and Y?
3089
3090 =back
3091
3092 =item Data: Dates
3093
3094 =over 4
3095
3096 =item How do I find the week-of-the-year/day-of-the-year?
3097
3098 =item How do I find the current century or millennium?
3099
3100 =item How can I compare two dates and find the difference?
3101
3102 =item How can I take a string and turn it into epoch seconds?
3103
3104 =item How can I find the Julian Day?
3105
3106 =item How do I find yesterday's date?
3107
3108 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3109
3110 =back
3111
3112 =item Data: Strings
3113
3114 =over 4
3115
3116 =item How do I validate input?
3117
3118 =item How do I unescape a string?
3119
3120 =item How do I remove consecutive pairs of characters?
3121
3122 =item How do I expand function calls in a string?
3123
3124 =item How do I find matching/nesting anything?
3125
3126 =item How do I reverse a string?
3127
3128 =item How do I expand tabs in a string?
3129
3130 =item How do I reformat a paragraph?
3131
3132 =item How can I access/change the first N letters of a string?
3133
3134 =item How do I change the Nth occurrence of something?
3135
3136 =item How can I count the number of occurrences of a substring within a
3137 string?
3138
3139 =item How do I capitalize all the words on one line?
3140
3141 =item How can I split a [character] delimited string except when inside
3142 [character]? (Comma-separated files)
3143
3144 =item How do I strip blank space from the beginning/end of a string?
3145
3146 =item How do I pad a string with blanks or pad a number with zeroes?
3147
3148 =item How do I extract selected columns from a string?
3149
3150 =item How do I find the soundex value of a string?
3151
3152 =item How can I expand variables in text strings?
3153
3154 =item What's wrong with always quoting "$vars"?
3155
3156 =item Why don't my <<HERE documents work?
3157
3158 1. There must be no space after the << part, 2. There (probably) should be
3159 a semicolon at the end, 3. You can't (easily) have any space in front of
3160 the tag
3161
3162 =back
3163
3164 =item Data: Arrays
3165
3166 =over 4
3167
3168 =item What is the difference between a list and an array?
3169
3170 =item What is the difference between $array[1] and @array[1]?
3171
3172 =item How can I remove duplicate elements from a list or array?
3173
3174 a), b), c), d), e)
3175
3176 =item How can I tell whether a certain element is contained in a list or
3177 array?
3178
3179 =item How do I compute the difference of two arrays?  How do I compute the
3180 intersection of two arrays?
3181
3182 =item How do I test whether two arrays or hashes are equal?
3183
3184 =item How do I find the first array element for which a condition is true?
3185
3186 =item How do I handle linked lists?
3187
3188 =item How do I handle circular lists?
3189
3190 =item How do I shuffle an array randomly?
3191
3192 =item How do I process/modify each element of an array?
3193
3194 =item How do I select a random element from an array?
3195
3196 =item How do I permute N elements of a list?
3197
3198 =item How do I sort an array by (anything)?
3199
3200 =item How do I manipulate arrays of bits?
3201
3202 =item Why does defined() return true on empty arrays and hashes?
3203
3204 =back
3205
3206 =item Data: Hashes (Associative Arrays)
3207
3208 =over 4
3209
3210 =item How do I process an entire hash?
3211
3212 =item What happens if I add or remove keys from a hash while iterating over
3213 it?
3214
3215 =item How do I look up a hash element by value?
3216
3217 =item How can I know how many entries are in a hash?
3218
3219 =item How do I sort a hash (optionally by value instead of key)?
3220
3221 =item How can I always keep my hash sorted?
3222
3223 =item What's the difference between "delete" and "undef" with hashes?
3224
3225 =item Why don't my tied hashes make the defined/exists distinction?
3226
3227 =item How do I reset an each() operation part-way through?
3228
3229 =item How can I get the unique keys from two hashes?
3230
3231 =item How can I store a multidimensional array in a DBM file?
3232
3233 =item How can I make my hash remember the order I put elements into it?
3234
3235 =item Why does passing a subroutine an undefined element in a hash create
3236 it?
3237
3238 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3239 array of hashes or arrays?
3240
3241 =item How can I use a reference as a hash key?
3242
3243 =back
3244
3245 =item Data: Misc
3246
3247 =over 4
3248
3249 =item How do I handle binary data correctly?
3250
3251 =item How do I determine whether a scalar is a number/whole/integer/float?
3252
3253 =item How do I keep persistent data across program calls?
3254
3255 =item How do I print out or copy a recursive data structure?
3256
3257 =item How do I define methods for every class/object?
3258
3259 =item How do I verify a credit card checksum?
3260
3261 =item How do I pack arrays of doubles or floats for XS code?
3262
3263 =back
3264
3265 =item AUTHOR AND COPYRIGHT
3266
3267 =back
3268
3269 =head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
3270 07:04:25 $)
3271
3272 =over 4
3273
3274 =item DESCRIPTION
3275
3276 =over 4
3277
3278 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3279
3280 =item How do I change one line in a file/delete a line in a file/insert a
3281 line in the middle of a file/append to the beginning of a file?
3282
3283 =item How do I count the number of lines in a file?
3284
3285 =item How do I make a temporary file name?
3286
3287 =item How can I manipulate fixed-record-length files?
3288
3289 =item How can I make a filehandle local to a subroutine?  How do I pass
3290 filehandles between subroutines?  How do I make an array of filehandles?
3291
3292 =item How can I use a filehandle indirectly?
3293
3294 =item How can I set up a footer format to be used with write()?
3295
3296 =item How can I write() into a string?
3297
3298 =item How can I output my numbers with commas added?
3299
3300 =item How can I translate tildes (~) in a filename?
3301
3302 =item How come when I open a file read-write it wipes it out?
3303
3304 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3305
3306 =item Is there a leak/bug in glob()?
3307
3308 =item How can I open a file with a leading ">" or trailing blanks?
3309
3310 =item How can I reliably rename a file?
3311
3312 =item How can I lock a file?
3313
3314 =item Why can't I just open(FH, ">file.lock")?
3315
3316 =item I still don't get locking.  I just want to increment the number in
3317 the file.  How can I do this?
3318
3319 =item All I want to do is append a small amount of text to the end of a
3320 file.  Do I still have to use locking?
3321
3322 =item How do I randomly update a binary file?
3323
3324 =item How do I get a file's timestamp in perl?
3325
3326 =item How do I set a file's timestamp in perl?
3327
3328 =item How do I print to more than one file at once?
3329
3330 =item How can I read in an entire file all at once?
3331
3332 =item How can I read in a file by paragraphs?
3333
3334 =item How can I read a single character from a file?  From the keyboard?
3335
3336 =item How can I tell whether there's a character waiting on a filehandle?
3337
3338 =item How do I do a C<tail -f> in perl?
3339
3340 =item How do I dup() a filehandle in Perl?
3341
3342 =item How do I close a file descriptor by number?
3343
3344 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3345 `C:\temp\foo.exe` work?
3346
3347 =item Why doesn't glob("*.*") get all the files?
3348
3349 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3350 protected files?  Isn't this a bug in Perl?
3351
3352 =item How do I select a random line from a file?
3353
3354 =item Why do I get weird spaces when I print an array of lines?
3355
3356 =back
3357
3358 =item AUTHOR AND COPYRIGHT
3359
3360 =back
3361
3362 =head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
3363 22:31:09 $)
3364
3365 =over 4
3366
3367 =item DESCRIPTION
3368
3369 =over 4
3370
3371 =item How can I hope to use regular expressions without creating illegible
3372 and unmaintainable code?
3373
3374 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3375
3376 =item I'm having trouble matching over more than one line.  What's wrong?
3377
3378 =item How can I pull out lines between two patterns that are themselves on
3379 different lines?
3380
3381 =item I put a regular expression into $/ but it didn't work. What's wrong?
3382
3383 =item How do I substitute case insensitively on the LHS while preserving
3384 case on the RHS?
3385
3386 =item How can I make C<\w> match national character sets?
3387
3388 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3389
3390 =item How can I quote a variable to use in a regex?
3391
3392 =item What is C</o> really for?
3393
3394 =item How do I use a regular expression to strip C style comments from a
3395 file?
3396
3397 =item Can I use Perl regular expressions to match balanced text?
3398
3399 =item What does it mean that regexes are greedy?  How can I get around it?
3400
3401 =item How do I process each word on each line?
3402
3403 =item How can I print out a word-frequency or line-frequency summary?
3404
3405 =item How can I do approximate matching?
3406
3407 =item How do I efficiently match many regular expressions at once?
3408
3409 =item Why don't word-boundary searches with C<\b> work for me?
3410
3411 =item Why does using $&, $`, or $' slow my program down?
3412
3413 =item What good is C<\G> in a regular expression?
3414
3415 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3416
3417 =item What's wrong with using grep or map in a void context?
3418
3419 =item How can I match strings with multibyte characters?
3420
3421 =item How do I match a pattern that is supplied by the user?
3422
3423 =back
3424
3425 =item AUTHOR AND COPYRIGHT
3426
3427 =back
3428
3429 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3430 2002/03/26 15:48:32 $)
3431
3432 =over 4
3433
3434 =item DESCRIPTION
3435
3436 =over 4
3437
3438 =item Can I get a BNF/yacc/RE for the Perl language?
3439
3440 =item What are all these $@%&* punctuation signs, and how do I know when to
3441 use them?
3442
3443 =item Do I always/never have to quote my strings or use semicolons and
3444 commas?
3445
3446 =item How do I skip some return values?
3447
3448 =item How do I temporarily block warnings?
3449
3450 =item What's an extension?
3451
3452 =item Why do Perl operators have different precedence than C operators?
3453
3454 =item How do I declare/create a structure?
3455
3456 =item How do I create a module?
3457
3458 =item How do I create a class?
3459
3460 =item How can I tell if a variable is tainted?
3461
3462 =item What's a closure?
3463
3464 =item What is variable suicide and how can I prevent it?
3465
3466 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3467 Regex}?
3468
3469 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3470 Passing Methods
3471
3472 =item How do I create a static variable?
3473
3474 =item What's the difference between dynamic and lexical (static) scoping?
3475 Between local() and my()?
3476
3477 =item How can I access a dynamic variable while a similarly named lexical
3478 is in scope?
3479
3480 =item What's the difference between deep and shallow binding?
3481
3482 =item Why doesn't "my($foo) = <FILE>;" work right?
3483
3484 =item How do I redefine a builtin function, operator, or method?
3485
3486 =item What's the difference between calling a function as &foo and foo()?
3487
3488 =item How do I create a switch or case statement?
3489
3490 =item How can I catch accesses to undefined variables/functions/methods?
3491
3492 =item Why can't a method included in this same file be found?
3493
3494 =item How can I find out my current package?
3495
3496 =item How can I comment out a large block of perl code?
3497
3498 =item How do I clear a package?
3499
3500 =item How can I use a variable as a variable name?
3501
3502 =back
3503
3504 =item AUTHOR AND COPYRIGHT
3505
3506 =back
3507
3508 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3509 12:41:42 $)
3510
3511 =over 4
3512
3513 =item DESCRIPTION
3514
3515 =over 4
3516
3517 =item How do I find out which operating system I'm running under?
3518
3519 =item How come exec() doesn't return?
3520
3521 =item How do I do fancy stuff with the keyboard/screen/mouse?
3522
3523 Keyboard, Screen, Mouse
3524
3525 =item How do I print something out in color?
3526
3527 =item How do I read just one key without waiting for a return key?
3528
3529 =item How do I check whether input is ready on the keyboard?
3530
3531 =item How do I clear the screen?
3532
3533 =item How do I get the screen size?
3534
3535 =item How do I ask the user for a password?
3536
3537 =item How do I read and write the serial port?
3538
3539 lockfiles, open mode, end of line, flushing output, non-blocking input
3540
3541 =item How do I decode encrypted password files?
3542
3543 =item How do I start a process in the background?
3544
3545 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3546
3547 =item How do I trap control characters/signals?
3548
3549 =item How do I modify the shadow password file on a Unix system?
3550
3551 =item How do I set the time and date?
3552
3553 =item How can I sleep() or alarm() for under a second?
3554
3555 =item How can I measure time under a second?
3556
3557 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3558
3559 =item Why doesn't my sockets program work under System V (Solaris)?  What
3560 does the error message "Protocol not supported" mean?
3561
3562 =item How can I call my system's unique C functions from Perl?
3563
3564 =item Where do I get the include files to do ioctl() or syscall()?
3565
3566 =item Why do setuid perl scripts complain about kernel problems?
3567
3568 =item How can I open a pipe both to and from a command?
3569
3570 =item Why can't I get the output of a command with system()?
3571
3572 =item How can I capture STDERR from an external command?
3573
3574 =item Why doesn't open() return an error when a pipe open fails?
3575
3576 =item What's wrong with using backticks in a void context?
3577
3578 =item How can I call backticks without shell processing?
3579
3580 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3581 ^Z on MS-DOS)?
3582
3583 =item How can I convert my shell script to perl?
3584
3585 =item Can I use perl to run a telnet or ftp session?
3586
3587 =item How can I write expect in Perl?
3588
3589 =item Is there a way to hide perl's command line from programs such as
3590 "ps"?
3591
3592 =item I {changed directory, modified my environment} in a perl script.  How
3593 come the change disappeared when I exited the script?  How do I get my
3594 changes to be visible?
3595
3596 Unix
3597
3598 =item How do I close a process's filehandle without waiting for it to
3599 complete?
3600
3601 =item How do I fork a daemon process?
3602
3603 =item How do I find out if I'm running interactively or not?
3604
3605 =item How do I timeout a slow event?
3606
3607 =item How do I set CPU limits?
3608
3609 =item How do I avoid zombies on a Unix system?
3610
3611 =item How do I use an SQL database?
3612
3613 =item How do I make a system() exit on control-C?
3614
3615 =item How do I open a file without blocking?
3616
3617 =item How do I install a module from CPAN?
3618
3619 =item What's the difference between require and use?
3620
3621 =item How do I keep my own module/library directory?
3622
3623 =item How do I add the directory my program lives in to the module/library
3624 search path?
3625
3626 =item How do I add a directory to my include path at runtime?
3627
3628 =item What is socket.ph and where do I get it?
3629
3630 =back
3631
3632 =item AUTHOR AND COPYRIGHT
3633
3634 =back
3635
3636 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3637 $)
3638
3639 =over 4
3640
3641 =item DESCRIPTION
3642
3643 =over 4
3644
3645 =item What is the correct form of response from a CGI script?
3646
3647 =item My CGI script runs from the command line but not the browser.  (500
3648 Server Error)
3649
3650 =item How can I get better error messages from a CGI program?
3651
3652 =item How do I remove HTML from a string?
3653
3654 =item How do I extract URLs?
3655
3656 =item How do I download a file from the user's machine?  How do I open a
3657 file on another machine?
3658
3659 =item How do I make a pop-up menu in HTML?
3660
3661 =item How do I fetch an HTML file?
3662
3663 =item How do I automate an HTML form submission?
3664
3665 =item How do I decode or create those %-encodings on the web?
3666
3667 =item How do I redirect to another page?
3668
3669 =item How do I put a password on my web pages?
3670
3671 =item How do I edit my .htpasswd and .htgroup files with Perl?
3672
3673 =item How do I make sure users can't enter values into a form that cause my
3674 CGI script to do bad things?
3675
3676 =item How do I parse a mail header?
3677
3678 =item How do I decode a CGI form?
3679
3680 =item How do I check a valid mail address?
3681
3682 =item How do I decode a MIME/BASE64 string?
3683
3684 =item How do I return the user's mail address?
3685
3686 =item How do I send mail?
3687
3688 =item How do I use MIME to make an attachment to a mail message?
3689
3690 =item How do I read mail?
3691
3692 =item How do I find out my hostname/domainname/IP address?
3693
3694 =item How do I fetch a news article or the active newsgroups?
3695
3696 =item How do I fetch/put an FTP file?
3697
3698 =item How can I do RPC in Perl?
3699
3700 =back
3701
3702 =item AUTHOR AND COPYRIGHT
3703
3704 =back
3705
3706 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3707
3708 =over 4
3709
3710 =item DESCRIPTION
3711
3712 =over 4
3713
3714 =item Layout
3715
3716 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3717
3718 =back
3719
3720 =item Using The Back Ends
3721
3722 =over 4
3723
3724 =item The Cross Referencing Back End
3725
3726 i, &, s, r
3727
3728 =item The Decompiling Back End
3729
3730 =item The Lint Back End
3731
3732 =item The Simple C Back End
3733
3734 =item The Bytecode Back End
3735
3736 =item The Optimized C Back End
3737
3738 =back
3739
3740 =item Module List for the Compiler Suite
3741
3742 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3743 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3744 B::Stackobj, B::Stash, B::Terse, B::Xref
3745
3746 =item KNOWN PROBLEMS
3747
3748 =item AUTHOR
3749
3750 =back
3751
3752 =head2 perlembed - how to embed perl in your C program
3753
3754 =over 4
3755
3756 =item DESCRIPTION
3757
3758 =over 4
3759
3760 =item PREAMBLE
3761
3762 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3763 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3764
3765 =item ROADMAP
3766
3767 =item Compiling your C program
3768
3769 =item Adding a Perl interpreter to your C program
3770
3771 =item Calling a Perl subroutine from your C program
3772
3773 =item Evaluating a Perl statement from your C program
3774
3775 =item Performing Perl pattern matches and substitutions from your C program
3776
3777 =item Fiddling with the Perl stack from your C program
3778
3779 =item Maintaining a persistent interpreter
3780
3781 =item Execution of END blocks
3782
3783 =item Maintaining multiple interpreter instances
3784
3785 =item Using Perl modules, which themselves use C libraries, from your C
3786 program
3787
3788 =back
3789
3790 =item Embedding Perl under Win32
3791
3792 =item MORAL
3793
3794 =item AUTHOR
3795
3796 =item COPYRIGHT
3797
3798 =back
3799
3800 =head2 perldebguts - Guts of Perl debugging
3801
3802 =over 4
3803
3804 =item DESCRIPTION
3805
3806 =item Debugger Internals
3807
3808 =over 4
3809
3810 =item Writing Your Own Debugger
3811
3812 =back
3813
3814 =item Frame Listing Output Examples
3815
3816 =item Debugging regular expressions
3817
3818 =over 4
3819
3820 =item Compile-time output
3821
3822 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3823 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3824 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3825 C<anchored(TYPE)>
3826
3827 =item Types of nodes
3828
3829 =item Run-time output
3830
3831 =back
3832
3833 =item Debugging Perl memory usage
3834
3835 =over 4
3836
3837 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3838
3839 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3840 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3841 6144>
3842
3843 =item Example of using B<-DL> switch
3844
3845 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3846
3847 =item B<-DL> details
3848
3849 C<!!!>, C<!!>, C<!>
3850
3851 =item Limitations of B<-DL> statistics
3852
3853 =back
3854
3855 =item SEE ALSO
3856
3857 =back
3858
3859 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3860
3861 =over 4
3862
3863 =item DESCRIPTION
3864
3865 =item SPECIAL NOTES
3866
3867 =over 4
3868
3869 =item make
3870
3871 =item Version caveat
3872
3873 =item Dynamic Loading versus Static Loading
3874
3875 =back
3876
3877 =item TUTORIAL
3878
3879 =over 4
3880
3881 =item EXAMPLE 1
3882
3883 =item EXAMPLE 2
3884
3885 =item What has gone on?
3886
3887 =item Writing good test scripts
3888
3889 =item EXAMPLE 3
3890
3891 =item What's new here?
3892
3893 =item Input and Output Parameters
3894
3895 =item The XSUBPP Program
3896
3897 =item The TYPEMAP file
3898
3899 =item Warning about Output Arguments
3900
3901 =item EXAMPLE 4
3902
3903 =item What has happened here?
3904
3905 =item Anatomy of .xs file
3906
3907 =item Getting the fat out of XSUBs
3908
3909 =item More about XSUB arguments
3910
3911 =item The Argument Stack
3912
3913 =item Extending your Extension
3914
3915 =item Documenting your Extension
3916
3917 =item Installing your Extension
3918
3919 =item EXAMPLE 5
3920
3921 =item New Things in this Example
3922
3923 =item EXAMPLE 6
3924
3925 =item New Things in this Example
3926
3927 =item EXAMPLE 7 (Coming Soon)
3928
3929 =item EXAMPLE 8 (Coming Soon)
3930
3931 =item EXAMPLE 9 Passing open files to XSes
3932
3933 =item Troubleshooting these Examples
3934
3935 =back
3936
3937 =item See also
3938
3939 =item Author
3940
3941 =over 4
3942
3943 =item Last Changed
3944
3945 =back
3946
3947 =back
3948
3949 =head2 perlxs - XS language reference manual
3950
3951 =over 4
3952
3953 =item DESCRIPTION
3954
3955 =over 4
3956
3957 =item Introduction
3958
3959 =item On The Road
3960
3961 =item The Anatomy of an XSUB
3962
3963 =item The Argument Stack
3964
3965 =item The RETVAL Variable
3966
3967 =item The MODULE Keyword
3968
3969 =item The PACKAGE Keyword
3970
3971 =item The PREFIX Keyword
3972
3973 =item The OUTPUT: Keyword
3974
3975 =item The NO_OUTPUT Keyword
3976
3977 =item The CODE: Keyword
3978
3979 =item The INIT: Keyword
3980
3981 =item The NO_INIT Keyword
3982
3983 =item Initializing Function Parameters
3984
3985 =item Default Parameter Values
3986
3987 =item The PREINIT: Keyword
3988
3989 =item The SCOPE: Keyword
3990
3991 =item The INPUT: Keyword
3992
3993 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3994
3995 =item The C<length(NAME)> Keyword
3996
3997 =item Variable-length Parameter Lists
3998
3999 =item The C_ARGS: Keyword
4000
4001 =item The PPCODE: Keyword
4002
4003 =item Returning Undef And Empty Lists
4004
4005 =item The REQUIRE: Keyword
4006
4007 =item The CLEANUP: Keyword
4008
4009 =item The POSTCALL: Keyword
4010
4011 =item The BOOT: Keyword
4012
4013 =item The VERSIONCHECK: Keyword
4014
4015 =item The PROTOTYPES: Keyword
4016
4017 =item The PROTOTYPE: Keyword
4018
4019 =item The ALIAS: Keyword
4020
4021 =item The OVERLOAD: Keyword
4022
4023 =item The INTERFACE: Keyword
4024
4025 =item The INTERFACE_MACRO: Keyword
4026
4027 =item The INCLUDE: Keyword
4028
4029 =item The CASE: Keyword
4030
4031 =item The & Unary Operator
4032
4033 =item Inserting POD, Comments and C Preprocessor Directives
4034
4035 =item Using XS With C++
4036
4037 =item Interface Strategy
4038
4039 =item Perl Objects And C Structures
4040
4041 =item The Typemap
4042
4043 =item Safely Storing Static Data in XS
4044
4045 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4046
4047 =back
4048
4049 =item EXAMPLES
4050
4051 =item XS VERSION
4052
4053 =item AUTHOR
4054
4055 =back
4056
4057 =head2 perlclib - Internal replacements for standard C library functions
4058
4059 =over 4
4060
4061 =item DESCRIPTION
4062
4063 =over 4
4064
4065 =item Conventions
4066
4067 C<t>, C<p>, C<n>, C<s>
4068
4069 =item File Operations
4070
4071 =item File Input and Output
4072
4073 =item File Positioning
4074
4075 =item Memory Management and String Handling
4076
4077 =item Character Class Tests
4078
4079 =item F<stdlib.h> functions
4080
4081 =item Miscellaneous functions
4082
4083 =back
4084
4085 =item SEE ALSO
4086
4087 =back
4088
4089 =head2 perlguts - Introduction to the Perl API
4090
4091 =over 4
4092
4093 =item DESCRIPTION
4094
4095 =item Variables
4096
4097 =over 4
4098
4099 =item Datatypes
4100
4101 =item What is an "IV"?
4102
4103 =item Working with SVs
4104
4105 =item Offsets
4106
4107 =item What's Really Stored in an SV?
4108
4109 =item Working with AVs
4110
4111 =item Working with HVs
4112
4113 =item Hash API Extensions
4114
4115 =item References
4116
4117 =item Blessed References and Class Objects
4118
4119 =item Creating New Variables
4120
4121 GV_ADDMULTI, GV_ADDWARN
4122
4123 =item Reference Counts and Mortality
4124
4125 =item Stashes and Globs
4126
4127 =item Double-Typed SVs
4128
4129 =item Magic Variables
4130
4131 =item Assigning Magic
4132
4133 =item Magic Virtual Tables
4134
4135 =item Finding Magic
4136
4137 =item Understanding the Magic of Tied Hashes and Arrays
4138
4139 =item Localizing changes
4140
4141 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4142 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4143 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4144 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4145 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4146 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4147 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4148 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4149 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4150 save_hptr(HV **hptr)>
4151
4152 =back
4153
4154 =item Subroutines
4155
4156 =over 4
4157
4158 =item XSUBs and the Argument Stack
4159
4160 =item Calling Perl Routines from within C Programs
4161
4162 =item Memory Allocation
4163
4164 =item PerlIO
4165
4166 =item Putting a C value on Perl stack
4167
4168 =item Scratchpads
4169
4170 =item Scratchpads and recursion
4171
4172 =back
4173
4174 =item Compiled code
4175
4176 =over 4
4177
4178 =item Code tree
4179
4180 =item Examining the tree
4181
4182 =item Compile pass 1: check routines
4183
4184 =item Compile pass 1a: constant folding
4185
4186 =item Compile pass 2: context propagation
4187
4188 =item Compile pass 3: peephole optimization
4189
4190 =item Pluggable runops
4191
4192 =back
4193
4194 =item Examining internal data structures with the C<dump> functions
4195
4196 =item How multiple interpreters and concurrency are supported
4197
4198 =over 4
4199
4200 =item Background and PERL_IMPLICIT_CONTEXT
4201
4202 =item So what happened to dTHR?
4203
4204 =item How do I use all this in extensions?
4205
4206 =item Should I do anything special if I call perl from multiple threads?
4207
4208 =item Future Plans and PERL_IMPLICIT_SYS
4209
4210 =back
4211
4212 =item Internal Functions
4213
4214 A, p, d, s, n, r, f, M, o, j, x
4215
4216 =over 4
4217
4218 =item Formatted Printing of IVs, UVs, and NVs
4219
4220 =item Pointer-To-Integer and Integer-To-Pointer
4221
4222 =item Source Documentation
4223
4224 =back
4225
4226 =item Unicode Support
4227
4228 =over 4
4229
4230 =item What B<is> Unicode, anyway?
4231
4232 =item How can I recognise a UTF8 string?
4233
4234 =item How does UTF8 represent Unicode characters?
4235
4236 =item How does Perl store UTF8 strings?
4237
4238 =item How do I convert a string to UTF8?
4239
4240 =item Is there anything else I need to know?
4241
4242 =back
4243
4244 =item Custom Operators
4245
4246 =item AUTHORS
4247
4248 =item SEE ALSO
4249
4250 =back
4251
4252 =head2 perlcall - Perl calling conventions from C
4253
4254 =over 4
4255
4256 =item DESCRIPTION
4257
4258 An Error Handler, An Event Driven Program
4259
4260 =item THE CALL_ FUNCTIONS
4261
4262 call_sv, call_pv, call_method, call_argv
4263
4264 =item FLAG VALUES
4265
4266 =over 4
4267
4268 =item  G_VOID
4269
4270 =item  G_SCALAR
4271
4272 =item G_ARRAY
4273
4274 =item G_DISCARD
4275
4276 =item G_NOARGS
4277
4278 =item G_EVAL
4279
4280 =item G_KEEPERR
4281
4282 =item Determining the Context
4283
4284 =back
4285
4286 =item KNOWN PROBLEMS
4287
4288 =item EXAMPLES
4289
4290 =over 4
4291
4292 =item No Parameters, Nothing returned
4293
4294 =item Passing Parameters
4295
4296 =item Returning a Scalar
4297
4298 =item Returning a list of values
4299
4300 =item Returning a list in a scalar context
4301
4302 =item Returning Data from Perl via the parameter list
4303
4304 =item Using G_EVAL
4305
4306 =item Using G_KEEPERR
4307
4308 =item Using call_sv
4309
4310 =item Using call_argv
4311
4312 =item Using call_method
4313
4314 =item Using GIMME_V
4315
4316 =item Using Perl to dispose of temporaries
4317
4318 =item Strategies for storing Callback Context Information
4319
4320 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4321 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4322 callback
4323
4324 =item Alternate Stack Manipulation
4325
4326 =item Creating and calling an anonymous subroutine in C
4327
4328 =back
4329
4330 =item SEE ALSO
4331
4332 =item AUTHOR
4333
4334 =item DATE
4335
4336 =back
4337
4338 =head2 perlutil - utilities packaged with the Perl distribution
4339
4340 =over 4
4341
4342 =item DESCRIPTION
4343
4344 =over 4
4345
4346 =item DOCUMENTATION
4347
4348 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4349 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4350 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4351 L<roffitall|roffitall>
4352
4353 =item CONVERTORS
4354
4355 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4356
4357 =item Administration
4358
4359 L<libnetcfg|libnetcfg>
4360
4361 =item Development
4362
4363 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4364 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4365
4366 =item SEE ALSO
4367
4368 =back
4369
4370 =back
4371
4372 =head2 perlfilter - Source Filters
4373
4374 =over 4
4375
4376 =item DESCRIPTION
4377
4378 =item CONCEPTS
4379
4380 =item USING FILTERS
4381
4382 =item WRITING A SOURCE FILTER
4383
4384 =item WRITING A SOURCE FILTER IN C
4385
4386 B<Decryption Filters>
4387
4388 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4389
4390 =item WRITING A SOURCE FILTER IN PERL
4391
4392 =item USING CONTEXT: THE DEBUG FILTER
4393
4394 =item CONCLUSION
4395
4396 =item REQUIREMENTS
4397
4398 =item AUTHOR
4399
4400 =item Copyrights
4401
4402 =back
4403
4404 =head2 perldbmfilter - Perl DBM Filters
4405
4406 =over 4
4407
4408 =item SYNOPSIS
4409
4410 =item DESCRIPTION
4411
4412 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4413 B<filter_fetch_value>
4414
4415 =over 4
4416
4417 =item The Filter
4418
4419 =item An Example -- the NULL termination problem.
4420
4421 =item Another Example -- Key is a C int.
4422
4423 =back
4424
4425 =item SEE ALSO
4426
4427 =item AUTHOR
4428
4429 =back
4430
4431 =head2 perlapi - autogenerated documentation for the perl public API
4432
4433 =over 4
4434
4435 =item DESCRIPTION
4436
4437 =item "Gimme" Values
4438
4439 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4440
4441 =item Array Manipulation Functions
4442
4443 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4444 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4445 get_av, newAV, Nullav, sortsv
4446
4447 =item Callback Functions
4448
4449 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4450 FREETMPS, LEAVE, SAVETMPS
4451
4452 =item Character classes
4453
4454 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4455
4456 =item Cloning an interpreter
4457
4458 perl_clone
4459
4460 =item CV Manipulation Functions
4461
4462 CvSTASH, get_cv, Nullcv
4463
4464 =item Embedding Functions
4465
4466 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4467 perl_free, perl_parse, perl_run, require_pv
4468
4469 =item Functions in file pp_pack.c
4470
4471 pack_cat, unpack_str
4472
4473 =item Global Variables
4474
4475 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4476
4477 =item GV Functions
4478
4479 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4480 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4481
4482 =item Handy Values
4483
4484 HEf_SVKEY, Nullch, Nullsv
4485
4486 =item Hash Manipulation Functions
4487
4488 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4489 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4490 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4491 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4492 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4493
4494 =item Magical Functions
4495
4496 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4497 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4498 SvSetSV, SvSetSV_nosteal, SvSHARE
4499
4500 =item Memory Management
4501
4502 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4503 savepv, savepvn, savesharedpv, StructCopy, Zero
4504
4505 =item Miscellaneous Functions
4506
4507 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4508 strNE, strnEQ, strnNE
4509
4510 =item Numeric functions
4511
4512 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4513 scan_hex, scan_oct
4514
4515 =item Optree Manipulation Functions
4516
4517 cv_const_sv, newCONSTSUB, newXS
4518
4519 =item Stack Manipulation Macros
4520
4521 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4522 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4523 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4524 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4525 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4526
4527 =item SV Flags
4528
4529 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4530
4531 =item SV Manipulation Functions
4532
4533 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4534 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4535 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4536 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4537 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4538 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4539 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4540 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4541 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4542 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4543 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4544 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4545 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4546 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4547 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4548 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4549 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4550 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4551 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4552 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4553 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4554 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4555 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4556 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4557 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4558 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4559 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4560 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4561 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4562 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4563 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4564 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4565 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4566
4567 =item Unicode Support
4568
4569 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4570 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4571 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4572 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4573 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4574
4575 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4576
4577 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4578 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4579
4580 =item Warning and Dieing
4581
4582 croak, warn
4583
4584 =item AUTHORS
4585
4586 =item SEE ALSO
4587
4588 =back
4589
4590 =head2 perlintern - autogenerated documentation of purely B<internal>
4591                  Perl functions
4592
4593 =over 4
4594
4595 =item DESCRIPTION
4596
4597 =item Global Variables
4598
4599 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4600 PL_rs
4601
4602 =item GV Functions
4603
4604 is_gv_magical
4605
4606 =item IO Functions
4607
4608 start_glob
4609
4610 =item Pad Data Structures
4611
4612 CvPADLIST
4613
4614 =item Stack Manipulation Macros
4615
4616 djSP, LVRET
4617
4618 =item SV Manipulation Functions
4619
4620 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4621
4622 =item AUTHORS
4623
4624 =item SEE ALSO
4625
4626 =back
4627
4628 =head2 perliol - C API for Perl's implementation of IO in Layers.
4629
4630 =over 4
4631
4632 =item SYNOPSIS
4633
4634 =item DESCRIPTION
4635
4636 =over 4
4637
4638 =item History and Background
4639
4640 =item Layers vs Disciplines
4641
4642 =item Data Structures
4643
4644 =item Functions and Attributes
4645
4646 =item Per-instance Data
4647
4648 =item Layers in action.
4649
4650 =item Per-instance flag bits
4651
4652 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4653 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4654 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4655 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4656
4657 =item Methods in Detail
4658
4659 name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
4660 PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
4661 Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
4662 Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
4663
4664 =item Core Layers
4665
4666 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4667
4668 =item Extension Layers
4669
4670 ":encoding", ":Scalar", ":Via"
4671
4672 =back
4673
4674 =item TODO
4675
4676 =back
4677
4678 =head2 perlapio - perl's IO abstraction interface.
4679
4680 =over 4
4681
4682 =item SYNOPSIS
4683
4684 =item DESCRIPTION
4685
4686 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4687 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4688 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4689 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4690 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4691 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4692 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4693 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4694 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4695 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4696 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4697
4698 =over 4
4699
4700 =item Co-existence with stdio
4701
4702 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4703 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4704
4705 =item "Fast gets" Functions
4706
4707 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4708 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4709 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4710 B<PerlIO_get_bufsiz(f)>
4711
4712 =item Other Functions
4713
4714 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4715 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4716
4717 =back
4718
4719 =back
4720
4721 =head2 perltodo - Perl TO-DO List
4722
4723 =over 4
4724
4725 =item DESCRIPTION
4726
4727 =item To do during 5.6.x
4728
4729 =over 4
4730
4731 =item Support for I/O disciplines
4732
4733 =item Autoload bytes.pm
4734
4735 =item Make "\u{XXXX}" et al work
4736
4737 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4738
4739 =item Overloadable regex assertions
4740
4741 =item Unicode
4742
4743 =item Work out exit/die semantics for threads
4744
4745 =item Better support for nonpreemptive threading systems like GNU pth
4746
4747 =item Typed lexicals for compiler
4748
4749 =item Compiler workarounds for Win32
4750
4751 =item AUTOLOADing in the compiler
4752
4753 =item Fixing comppadlist when compiling
4754
4755 =item Cleaning up exported namespace
4756
4757 =item Complete signal handling
4758
4759 =item Out-of-source builds
4760
4761 =item POSIX realtime support
4762
4763 =item UNIX98 support
4764
4765 =item IPv6 Support
4766
4767 =item Long double conversion
4768
4769 =item Locales
4770
4771 =item Arithmetic on non-Arabic numerals
4772
4773 =item POSIX Unicode character classes
4774
4775 =item Factoring out common suffices/prefices in regexps (trie optimization)
4776
4777 =item Security audit shipped utilities
4778
4779 =item Sort out the uid-setting mess
4780
4781 =item Custom opcodes
4782
4783 =item DLL Versioning
4784
4785 =item Introduce @( and @)
4786
4787 =item Floating point handling
4788
4789 =item IV/UV preservation
4790
4791 =item Replace pod2html with something using Pod::Parser
4792
4793 =item Automate module testing on CPAN
4794
4795 =item sendmsg and recvmsg
4796
4797 =item Rewrite perlre documentation
4798
4799 =item Convert example code to IO::Handle filehandles
4800
4801 =item Document Win32 choices
4802
4803 =item Check new modules
4804
4805 =item Make roffitall find pods and libs itself
4806
4807 =back
4808
4809 =item To do at some point
4810
4811 =over 4
4812
4813 =item Remove regular expression recursion
4814
4815 =item Memory leaks after failed eval
4816
4817 =item bitfields in pack
4818
4819 =item Cross compilation
4820
4821 =item Perl preprocessor / macros
4822
4823 =item Perl lexer in Perl
4824
4825 =item Using POSIX calls internally
4826
4827 =item -i rename file when changed
4828
4829 =item All ARGV input should act like E<lt>E<gt>
4830
4831 =item Support for rerunning debugger
4832
4833 =item Test Suite for the Debugger
4834
4835 =item my sub foo { }
4836
4837 =item One-pass global destruction
4838
4839 =item Rewrite regexp parser
4840
4841 =item Cache recently used regexps
4842
4843 =item Cross-compilation support
4844
4845 =item Bit-shifting bitvectors
4846
4847 =item debugger pragma
4848
4849 =item use less pragma
4850
4851 =item switch structures
4852
4853 =item Cache eval tree
4854
4855 =item rcatmaybe
4856
4857 =item Shrink opcode tables
4858
4859 =item Optimize away @_
4860
4861 =item Prototypes versus indirect objects
4862
4863 =item Install HTML
4864
4865 =item Prototype method calls
4866
4867 =item Return context prototype declarations
4868
4869 =item magic_setisa
4870
4871 =item Garbage collection
4872
4873 =item IO tutorial
4874
4875 =item Rewrite perldoc
4876
4877 =item Install .3p manpages
4878
4879 =item Unicode tutorial
4880
4881 =item Update POSIX.pm for 1003.1-2
4882
4883 =item Retargetable installation
4884
4885 =item POSIX emulation on non-POSIX systems
4886
4887 =item Rename Win32 headers
4888
4889 =item Finish off lvalue functions
4890
4891 =item Update sprintf documentation
4892
4893 =item Use fchown/fchmod internally
4894
4895 =item Make v-strings overloaded objects
4896
4897 =item Allow restricted hash assignment
4898
4899 =item Should overload be inheritable?
4900
4901 =item Taint rethink
4902
4903 =back
4904
4905 =item Vague ideas
4906
4907 =over 4
4908
4909 =item ref() in list context
4910
4911 =item Make tr/// return histogram of characters in list context
4912
4913 =item Compile to real threaded code
4914
4915 =item Structured types
4916
4917 =item Modifiable $1 et al.
4918
4919 =item Procedural interfaces for IO::*, etc.
4920
4921 =item RPC modules
4922
4923 =item Attach/detach debugger from running program
4924
4925 =item GUI::Native
4926
4927 =item foreach(reverse ...)
4928
4929 =item Constant function cache
4930
4931 =item Approximate regular expression matching
4932
4933 =back
4934
4935 =item Ongoing
4936
4937 =over 4
4938
4939 =item Update guts documentation
4940
4941 =item Add more tests
4942
4943 =item Update auxiliary tools
4944
4945 =item Create debugging macros
4946
4947 =item truncate to the people
4948
4949 =item Unicode in Filenames
4950
4951 =back
4952
4953 =item Recently done things
4954
4955 =over 4
4956
4957 =item Alternative RE syntax module
4958
4959 =item Safe signal handling
4960
4961 =item Tie Modules
4962
4963 =item gettimeofday
4964
4965 =item setitimer and getimiter
4966
4967 =item Testing __DIE__ hook
4968
4969 =item CPP equivalent in Perl
4970
4971 =item Explicit switch statements
4972
4973 =item autocroak
4974
4975 =item UTF/EBCDIC
4976
4977 =item UTF Regexes
4978
4979 =item perlcc to produce executable
4980
4981 =item END blocks saved in compiled output
4982
4983 =item Secure temporary file module
4984
4985 =item Integrate Time::HiRes
4986
4987 =item Turn Cwd into XS
4988
4989 =item Mmap for input
4990
4991 =item Byte to/from UTF8 and UTF8 to/from local conversion
4992
4993 =item Add sockatmark support
4994
4995 =item Mailing list archives
4996
4997 =item Bug tracking
4998
4999 =item Integrate MacPerl
5000
5001 =item Web "nerve center" for Perl
5002
5003 =item Regular expression tutorial
5004
5005 =item Debugging Tutorial
5006
5007 =item Integrate new modules
5008
5009 =item Integrate profiler
5010
5011 =item Y2K error detection
5012
5013 =item Regular expression debugger
5014
5015 =item POD checker
5016
5017 =item "Dynamic" lexicals
5018
5019 =item Cache precompiled modules
5020
5021 =back
5022
5023 =item Deprecated Wishes
5024
5025 =over 4
5026
5027 =item Loop control on do{}
5028
5029 =item Lexically scoped typeglobs
5030
5031 =item format BOTTOM
5032
5033 =item report HANDLE
5034
5035 =item Generalised want()/caller())
5036
5037 =item Named prototypes
5038
5039 =item Built-in globbing
5040
5041 =item Regression tests for suidperl
5042
5043 =item Cached hash values
5044
5045 =item Add compression modules
5046
5047 =item Reorganise documentation into tutorials/references
5048
5049 =item Remove distinction between functions and operators
5050
5051 =item Make XS easier to use
5052
5053 =item Make embedding easier to use
5054
5055 =item man for perl
5056
5057 =item my $Package::variable
5058
5059 =item "or" tests defined, not truth
5060
5061 =item "class"-based lexicals
5062
5063 =item byteperl
5064
5065 =item Lazy evaluation / tail recursion removal
5066
5067 =item Make "use utf8" the default
5068
5069 =item Unicode collation and normalization
5070
5071 =item pack/unpack tutorial
5072
5073 =back
5074
5075 =back
5076
5077 =head2 perlhack - How to hack at the Perl internals
5078
5079 =over 4
5080
5081 =item DESCRIPTION
5082
5083 Does concept match the general goals of Perl?, Where is the
5084 implementation?, Backwards compatibility, Could it be a module instead?, Is
5085 the feature generic enough?, Does it potentially introduce new bugs?, Does
5086 it preclude other desirable features?, Is the implementation robust?, Is
5087 the implementation generic enough to be portable?, Is the implementation
5088 tested?, Is there enough documentation?, Is there another way to do it?,
5089 Does it create too much work?, Patches speak louder than words
5090
5091 =over 4
5092
5093 =item Keeping in sync
5094
5095 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5096 NFS, rsync'ing the patches
5097
5098 =item Why rsync the source tree
5099
5100 It's easier to rsync the source tree, It's more recent, It's more reliable
5101
5102 =item Why rsync the patches
5103
5104 It's easier to rsync the patches, It's a good reference, Finding a start
5105 point, Finding how to fix a bug, Finding the source of misbehaviour
5106
5107 =item Perlbug remote interface
5108
5109 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5110 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5111
5112 =item Submitting patches
5113
5114 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5115 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5116
5117 =item Finding Your Way Around
5118
5119 Core modules, Tests, Documentation, Configure, Interpreter
5120
5121 =item Elements of the interpreter
5122
5123 Startup, Parsing, Optimization, Running
5124
5125 =item Internal Variable Types
5126
5127 =item Op Trees
5128
5129 =item Stacks
5130
5131 Argument stack, Mark stack, Save stack
5132
5133 =item Millions of Macros
5134
5135 =item Poking at Perl
5136
5137 =item Using a source-level debugger
5138
5139 run [args], break function_name, break source.c:xxx, step, next, continue,
5140 finish, 'enter', print
5141
5142 =item Dumping Perl Data Structures
5143
5144 =item Patching
5145
5146 =item Patching a core module
5147
5148 =item Adding a new function to the core
5149
5150 =item Writing a test
5151
5152 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5153 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5154
5155 =item Special Make Test Targets
5156
5157 coretest, test.deparse, minitest, test.third check.third utest.third
5158 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5159
5160 =back
5161
5162 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5163
5164 =over 4
5165
5166 =item Rational Software's Purify
5167
5168 =item Purify on Unix
5169
5170 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5171
5172 =item Purify on NT
5173
5174 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5175
5176 =item Compaq's/Digital's/HP's Third Degree
5177
5178 =item PERL_DESTRUCT_LEVEL
5179
5180 =item Profiling
5181
5182 =item Gprof Profiling
5183
5184 -a, -b, -e routine, -f routine, -s, -z
5185
5186 =item GCC gcov Profiling
5187
5188 =item Pixie Profiling
5189
5190 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5191 -z[ero]
5192
5193 =item Miscellaneous tricks
5194
5195 =item CONCLUSION
5196
5197 I<The Road goes ever on and on, down from the door where it began.>
5198
5199 =back
5200
5201 =item AUTHOR
5202
5203 =back
5204
5205 =head2 perlhist - the Perl history records
5206
5207 =over 4
5208
5209 =item DESCRIPTION
5210
5211 =item INTRODUCTION
5212
5213 =item THE KEEPERS OF THE PUMPKIN
5214
5215 =over 4
5216
5217 =item PUMPKIN?
5218
5219 =back
5220
5221 =item THE RECORDS
5222
5223 =over 4
5224
5225 =item SELECTED RELEASE SIZES
5226
5227 =item SELECTED PATCH SIZES
5228
5229 =back
5230
5231 =item THE KEEPERS OF THE RECORDS
5232
5233 =back
5234
5235 =head2 perldelta - what is new for perl v5.8.0
5236
5237 =over 4
5238
5239 =item DESCRIPTION
5240
5241 =item Highlights In 5.8.0
5242
5243 =item Incompatible Changes
5244
5245 =over 4
5246
5247 =item Binary Incompatibility
5248
5249 =item 64-bit platforms and malloc
5250
5251 =item AIX Dynaloading
5252
5253 =item Attributes for C<my> variables now handled at run-time.
5254
5255 =item Socket Extension Dynamic in VMS
5256
5257 =item IEEE-format Floating Point Default on OpenVMS Alpha
5258
5259 =item New Unicode Properties
5260
5261 =item REF(...) Instead Of SCALAR(...)
5262
5263 =item pack/unpack D/F recycled
5264
5265 =item Deprecations
5266
5267 =back
5268
5269 =item Core Enhancements
5270
5271 =over 4
5272
5273 =item PerlIO is Now The Default
5274
5275 =item Restricted Hashes
5276
5277 =item Safe Signals
5278
5279 =item Unicode Overhaul
5280
5281 =item Understanding of Numbers
5282
5283 =item Arrays now always interpolate into double-quoted strings [561]
5284
5285 =item Miscellaneous Changes
5286
5287 =back
5288
5289 =item Modules and Pragmata
5290
5291 =over 4
5292
5293 =item New Modules and Pragmata
5294
5295 =item Updated And Improved Modules and Pragmata
5296
5297 =back
5298
5299 =item Utility Changes
5300
5301 =item New Documentation
5302
5303 =item Performance Enhancements
5304
5305 =item Installation and Configuration Improvements
5306
5307 =over 4
5308
5309 =item Generic Improvements
5310
5311 =item New Or Improved Platforms
5312
5313 =back
5314
5315 =item Selected Bug Fixes
5316
5317 =over 4
5318
5319 =item Platform Specific Changes and Fixes
5320
5321 =back
5322
5323 =item New or Changed Diagnostics
5324
5325 =item Changed Internals
5326
5327 =item Security Vulnerability Closed [561]
5328
5329 =item New Tests
5330
5331 =item Known Problems
5332
5333 =over 4
5334
5335 =item AIX
5336
5337 =item Alpha systems with old gccs fail several tests
5338
5339 =item AmigaOS
5340
5341 =item BeOS
5342
5343 =item Cygwin "unable to remap"
5344
5345 =item ext/threads/t/libc
5346
5347 =item FreeBSD built with ithreads coredumps reading large directories
5348
5349 =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
5350
5351 =item IRIX fails ext/List/Util/t/shuffle.t
5352
5353 =item Modifying $_ Inside for(..)
5354
5355 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5356
5357 =item lib/ftmp-security tests warn 'system possibly insecure'
5358
5359 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5360
5361 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5362
5363 =item Linux With Sfio Fails op/misc Test 48
5364
5365 =item libwww-perl (LWP) fails base/date #51
5366
5367 =item Mac OS X
5368
5369 =item op/sprintf tests 91, 129, and 130
5370
5371 =item Solaris 2.5
5372
5373 =item SUPER-UX (NEC SX)
5374
5375 =item Term::ReadKey not working on Win32
5376
5377 =item Failure of Thread (5.005-style) tests
5378
5379 =item Timing problems
5380
5381 =item UNICOS
5382
5383 =item UNICOS/mk
5384
5385 =item UTS
5386
5387 =item VOS (Stratus)
5388
5389 =item VMS
5390
5391 =item Win32
5392
5393 =item XML::Parser not working
5394
5395 =item z/OS (OS/390)
5396
5397 =item Localising Tied Arrays and Hashes Is Broken
5398
5399 =item Self-tying Problems
5400
5401 =item Building Extensions Can Fail Because Of Largefiles
5402
5403 =item Unicode Support on EBCDIC Still Spotty
5404
5405 =item The Compiler Suite Is Still Very Experimental
5406
5407 =item The Long Double Support Is Still Experimental
5408
5409 =item Seen In Perl 5.7 But Gone Now
5410
5411 =back
5412
5413 =item Reporting Bugs
5414
5415 =item SEE ALSO
5416
5417 =item HISTORY
5418
5419 =back
5420
5421 =head2 perl572delta - what's new for perl v5.7.2
5422
5423 =over 4
5424
5425 =item DESCRIPTION
5426
5427 =item Security Vulnerability Closed
5428
5429 =item Incompatible Changes
5430
5431 =over 4
5432
5433 =item 64-bit platforms and malloc
5434
5435 =item AIX Dynaloading
5436
5437 =item Socket Extension Dynamic in VMS
5438
5439 =item Different Definition of the Unicode Character Classes \p{In...}
5440
5441 =item Deprecations
5442
5443 =back
5444
5445 =item Core Enhancements
5446
5447 =item Modules and Pragmata
5448
5449 =over 4
5450
5451 =item New Modules and Distributions
5452
5453 =item Updated And Improved Modules and Pragmata
5454
5455 =back
5456
5457 =item Utility Changes
5458
5459 =item New Documentation
5460
5461 =item Installation and Configuration Improvements
5462
5463 =over 4
5464
5465 =item New Or Improved Platforms
5466
5467 =item Generic Improvements
5468
5469 =back
5470
5471 =item Selected Bug Fixes
5472
5473 =over 4
5474
5475 =item Platform Specific Changes and Fixes
5476
5477 =back
5478
5479 =item New or Changed Diagnostics
5480
5481 =item Source Code Enhancements
5482
5483 =over 4
5484
5485 =item MAGIC constants
5486
5487 =item Better commented code
5488
5489 =item Regex pre-/post-compilation items matched up
5490
5491 =item gcc -Wall
5492
5493 =back
5494
5495 =item New Tests
5496
5497 =item Known Problems
5498
5499 =over 4
5500
5501 =item AIX
5502
5503 =item Amiga Perl Invoking Mystery
5504
5505 =item lib/ftmp-security tests warn 'system possibly insecure'
5506
5507 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5508
5509 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5510
5511 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5512
5513 =item Linux With Sfio Fails op/misc Test 48
5514
5515 =item OS/390
5516
5517 =item op/sprintf tests 129 and 130
5518
5519 =item  Failure of Thread tests
5520
5521 =item UNICOS
5522
5523 =item UTS
5524
5525 =item VMS
5526
5527 =item Win32
5528
5529 =item Localising a Tied Variable Leaks Memory
5530
5531 =item Self-tying of Arrays and Hashes Is Forbidden
5532
5533 =item Variable Attributes are not Currently Usable for Tieing
5534
5535 =item Building Extensions Can Fail Because Of Largefiles
5536
5537 =item The Compiler Suite Is Still Experimental
5538
5539 =item The Long Double Support is Still Experimental
5540
5541 =back
5542
5543 =item Reporting Bugs
5544
5545 =item SEE ALSO
5546
5547 =item HISTORY
5548
5549 =back
5550
5551 =head2 perl571delta - what's new for perl v5.7.1
5552
5553 =over 4
5554
5555 =item DESCRIPTION
5556
5557 =item Security Vulnerability Closed
5558
5559 =item Incompatible Changes
5560
5561 =item Core Enhancements
5562
5563 =over 4
5564
5565 =item AUTOLOAD Is Now Lvaluable
5566
5567 =item PerlIO is Now The Default
5568
5569 =item Signals Are Now Safe
5570
5571 =back
5572
5573 =item Modules and Pragmata
5574
5575 =over 4
5576
5577 =item New Modules
5578
5579 =item Updated And Improved Modules and Pragmata
5580
5581 =back
5582
5583 =item Performance Enhancements
5584
5585 =item Utility Changes
5586
5587 =item New Documentation
5588
5589 =over 4
5590
5591 =item perlclib
5592
5593 =item perliol
5594
5595 =item README.aix
5596
5597 =item README.bs2000
5598
5599 =item README.macos
5600
5601 =item README.mpeix
5602
5603 =item README.solaris
5604
5605 =item README.vos
5606
5607 =item Porting/repository.pod
5608
5609 =back
5610
5611 =item Installation and Configuration Improvements
5612
5613 =over 4
5614
5615 =item New Or Improved Platforms
5616
5617 =item Generic Improvements
5618
5619 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5620 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5621 d_strtoq, d_u32align, d_ualarm, d_usleep
5622
5623 =back
5624
5625 =item Selected Bug Fixes
5626
5627 =over 4
5628
5629 =item Platform Specific Changes and Fixes
5630
5631 =back
5632
5633 =item New or Changed Diagnostics
5634
5635 =item Changed Internals
5636
5637 =item New Tests
5638
5639 =item Known Problems
5640
5641 =over 4
5642
5643 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5644
5645 =item lib/ftmp-security tests warn 'system possibly insecure'
5646
5647 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5648
5649 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5650
5651 =item lib/b test 19
5652
5653 =item Linux With Sfio Fails op/misc Test 48
5654
5655 =item sigaction test 13 in VMS
5656
5657 =item sprintf tests 129 and 130
5658
5659 =item  Failure of Thread tests
5660
5661 =item Localising a Tied Variable Leaks Memory
5662
5663 =item Self-tying of Arrays and Hashes Is Forbidden
5664
5665 =item Building Extensions Can Fail Because Of Largefiles
5666
5667 =item The Compiler Suite Is Still Experimental
5668
5669 =back
5670
5671 =item Reporting Bugs
5672
5673 =item SEE ALSO
5674
5675 =item HISTORY
5676
5677 =back
5678
5679 =head2 perl570delta - what's new for perl v5.7.0
5680
5681 =over 4
5682
5683 =item DESCRIPTION
5684
5685 =item Security Vulnerability Closed
5686
5687 =item Incompatible Changes
5688
5689 =item Core Enhancements
5690
5691 =item Modules and Pragmata
5692
5693 =over 4
5694
5695 =item New Modules
5696
5697 =item Updated And Improved Modules and Pragmata
5698
5699 =back
5700
5701 =item Utility Changes
5702
5703 =item New Documentation
5704
5705 =item Performance Enhancements
5706
5707 =item Installation and Configuration Improvements
5708
5709 =over 4
5710
5711 =item Generic Improvements
5712
5713 =back
5714
5715 =item Selected Bug Fixes
5716
5717 =over 4
5718
5719 =item Platform Specific Changes and Fixes
5720
5721 =back
5722
5723 =item New or Changed Diagnostics
5724
5725 =item Changed Internals
5726
5727 =item Known Problems
5728
5729 =over 4
5730
5731 =item Unicode Support Still Far From Perfect
5732
5733 =item EBCDIC Still A Lost Platform
5734
5735 =item Building Extensions Can Fail Because Of Largefiles
5736
5737 =item ftmp-security tests warn 'system possibly insecure'
5738
5739 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5740
5741 =item Long Doubles Still Don't Work In Solaris
5742
5743 =item Linux With Sfio Fails op/misc Test 48
5744
5745 =item Storable tests fail in some platforms
5746
5747 =item Threads Are Still Experimental
5748
5749 =item The Compiler Suite Is Still Experimental
5750
5751 =back
5752
5753 =item Reporting Bugs
5754
5755 =item SEE ALSO
5756
5757 =item HISTORY
5758
5759 =back
5760
5761 =head2 perl561delta - what's new for perl v5.6.x
5762
5763 =over 4
5764
5765 =item DESCRIPTION
5766
5767 =item Summary of changes between 5.6.0 and 5.6.1
5768
5769 =over 4
5770
5771 =item Security Issues
5772
5773 =item Core bug fixes
5774
5775 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5776 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5777 references to special variables, Lexical warnings, Spurious warnings and
5778 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5779 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5780 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5781 Module;>, Tests
5782
5783 =item Core features
5784
5785 =item Configuration issues
5786
5787 =item Documentation
5788
5789 =item Bundled modules
5790
5791 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5792 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5793 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5794 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5795
5796 =item Platform-specific improvements
5797
5798 NCR MP-RAS, NonStop-UX
5799
5800 =back
5801
5802 =item Core Enhancements
5803
5804 =over 4
5805
5806 =item Interpreter cloning, threads, and concurrency
5807
5808 =item Lexically scoped warning categories
5809
5810 =item Unicode and UTF-8 support
5811
5812 =item Support for interpolating named characters
5813
5814 =item "our" declarations
5815
5816 =item Support for strings represented as a vector of ordinals
5817
5818 =item Improved Perl version numbering system
5819
5820 =item New syntax for declaring subroutine attributes
5821
5822 =item File and directory handles can be autovivified
5823
5824 =item open() with more than two arguments
5825
5826 =item 64-bit support
5827
5828 =item Large file support
5829
5830 =item Long doubles
5831
5832 =item "more bits"
5833
5834 =item Enhanced support for sort() subroutines
5835
5836 =item C<sort $coderef @foo> allowed
5837
5838 =item File globbing implemented internally
5839
5840 =item Support for CHECK blocks
5841
5842 =item POSIX character class syntax [: :] supported
5843
5844 =item Better pseudo-random number generator
5845
5846 =item Improved C<qw//> operator
5847
5848 =item Better worst-case behavior of hashes
5849
5850 =item pack() format 'Z' supported
5851
5852 =item pack() format modifier '!' supported
5853
5854 =item pack() and unpack() support counted strings
5855
5856 =item Comments in pack() templates
5857
5858 =item Weak references
5859
5860 =item Binary numbers supported
5861
5862 =item Lvalue subroutines
5863
5864 =item Some arrows may be omitted in calls through references
5865
5866 =item Boolean assignment operators are legal lvalues
5867
5868 =item exists() is supported on subroutine names
5869
5870 =item exists() and delete() are supported on array elements
5871
5872 =item Pseudo-hashes work better
5873
5874 =item Automatic flushing of output buffers
5875
5876 =item Better diagnostics on meaningless filehandle operations
5877
5878 =item Where possible, buffered data discarded from duped input filehandle
5879
5880 =item eof() has the same old magic as <>
5881
5882 =item binmode() can be used to set :crlf and :raw modes
5883
5884 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5885
5886 =item system(), backticks and pipe open now reflect exec() failure
5887
5888 =item Improved diagnostics
5889
5890 =item Diagnostics follow STDERR
5891
5892 =item More consistent close-on-exec behavior
5893
5894 =item syswrite() ease-of-use
5895
5896 =item Better syntax checks on parenthesized unary operators
5897
5898 =item Bit operators support full native integer width
5899
5900 =item Improved security features
5901
5902 =item More functional bareword prototype (*)
5903
5904 =item C<require> and C<do> may be overridden
5905
5906 =item $^X variables may now have names longer than one character
5907
5908 =item New variable $^C reflects C<-c> switch
5909
5910 =item New variable $^V contains Perl version as a string
5911
5912 =item Optional Y2K warnings
5913
5914 =item Arrays now always interpolate into double-quoted strings
5915
5916 =back
5917
5918 =item Modules and Pragmata
5919
5920 =over 4
5921
5922 =item Modules
5923
5924 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5925 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5926 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5927 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5928 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5929 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5930 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5931 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5932
5933 =item Pragmata
5934
5935 =back
5936
5937 =item Utility Changes
5938
5939 =over 4
5940
5941 =item dprofpp
5942
5943 =item find2perl
5944
5945 =item h2xs
5946
5947 =item perlcc
5948
5949 =item perldoc
5950
5951 =item The Perl Debugger
5952
5953 =back
5954
5955 =item Improved Documentation
5956
5957 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5958 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5959 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5960 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5961
5962 =item Performance enhancements
5963
5964 =over 4
5965
5966 =item Simple sort() using { $a <=> $b } and the like are optimized
5967
5968 =item Optimized assignments to lexical variables
5969
5970 =item Faster subroutine calls
5971
5972 =item delete(), each(), values() and hash iteration are faster
5973
5974 =back
5975
5976 =item Installation and Configuration Improvements
5977
5978 =over 4
5979
5980 =item -Dusethreads means something different
5981
5982 =item New Configure flags
5983
5984 =item Threadedness and 64-bitness now more daring
5985
5986 =item Long Doubles
5987
5988 =item -Dusemorebits
5989
5990 =item -Duselargefiles
5991
5992 =item installusrbinperl
5993
5994 =item SOCKS support
5995
5996 =item C<-A> flag
5997
5998 =item Enhanced Installation Directories
5999
6000 =item gcc automatically tried if 'cc' does not seem to be working
6001
6002 =back
6003
6004 =item Platform specific changes
6005
6006 =over 4
6007
6008 =item Supported platforms
6009
6010 =item DOS
6011
6012 =item OS390 (OpenEdition MVS)
6013
6014 =item VMS
6015
6016 =item Win32
6017
6018 =back
6019
6020 =item Significant bug fixes
6021
6022 =over 4
6023
6024 =item <HANDLE> on empty files
6025
6026 =item C<eval '...'> improvements
6027
6028 =item All compilation errors are true errors
6029
6030 =item Implicitly closed filehandles are safer
6031
6032 =item Behavior of list slices is more consistent
6033
6034 =item C<(\$)> prototype and C<$foo{a}>
6035
6036 =item C<goto &sub> and AUTOLOAD
6037
6038 =item C<-bareword> allowed under C<use integer>
6039
6040 =item Failures in DESTROY()
6041
6042 =item Locale bugs fixed
6043
6044 =item Memory leaks
6045
6046 =item Spurious subroutine stubs after failed subroutine calls
6047
6048 =item Taint failures under C<-U>
6049
6050 =item END blocks and the C<-c> switch
6051
6052 =item Potential to leak DATA filehandles
6053
6054 =back
6055
6056 =item New or Changed Diagnostics
6057
6058 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6059 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6060 / cannot take a count, / must be followed by a, A or Z, / must be followed
6061 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6062 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6063 passed through, /%s/ should probably be written as "%s", %s() called too
6064 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6065 argument is not a HASH or ARRAY element or slice, %s argument is not a
6066 subroutine name, %s package attribute may clash with future reserved word:
6067 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6068 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6069 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6070 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6071 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6072 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6073 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6074 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6075 weaken a nonreference, Character class [:%s:] unknown, Character class
6076 syntax [%s] belongs inside character classes, Constant is not %s reference,
6077 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6078 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6079 "local" instead of "our"?), Document contains no data, entering effective
6080 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6081 output, flock() on closed filehandle %s, Global symbol "%s" requires
6082 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6083 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6084 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6085 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6086 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6087 separator character %s in attribute list, Invalid separator character %s in
6088 subroutine attribute list, leaving effective %s failed, Lvalue subs
6089 returning %s not implemented yet, Method %s not permitted, Missing
6090 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6091 No %s specified for -%c, No package name allowed for variable %s in "our",
6092 No space allowed after -%c, no UTC offset information; assuming local time
6093 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6094 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6095 around "%s" list, Possible unintended interpolation of %s in string,
6096 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6097 instead, Premature end of script headers, Repeat count in pack overflows,
6098 Repeat count in unpack overflows, realloc() of freed memory ignored,
6099 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6100 zero-length expression, switching effective %s is not implemented, This
6101 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6102 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6103 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6104 escape \\%c passed through, Unterminated attribute parameter in attribute
6105 list, Unterminated attribute list, Unterminated attribute parameter in
6106 subroutine attribute list, Unterminated subroutine attribute list, Value of
6107 CLI symbol "%s" too long, Version number must be a constant number
6108
6109 =item New tests
6110
6111 =item Incompatible Changes
6112
6113 =over 4
6114
6115 =item Perl Source Incompatibilities
6116
6117 CHECK is a new keyword, Treatment of list slices of undef has changed,
6118 Format of $English::PERL_VERSION is different, Literals of the form
6119 C<1.2.3> parse differently, Possibly changed pseudo-random number
6120 generator, Hashing function for hash keys has changed, C<undef> fails on
6121 read only values, Close-on-exec bit may be set on pipe and socket handles,
6122 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6123 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6124 Text of some diagnostic output has changed, C<%@> has been removed,
6125 Parenthesized not() behaves like a list operator, Semantics of bareword
6126 prototype C<(*)> have changed, Semantics of bit operators may have changed
6127 on 64-bit platforms, More builtins taint their results
6128
6129 =item C Source Incompatibilities
6130
6131 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6132
6133 =item Compatible C Source API Changes
6134
6135 C<PATCHLEVEL> is now C<PERL_VERSION>
6136
6137 =item Binary Incompatibilities
6138
6139 =back
6140
6141 =item Known Problems
6142
6143 =over 4
6144
6145 =item Localizing a tied hash element may leak memory
6146
6147 =item Known test failures
6148
6149 =item EBCDIC platforms not fully supported
6150
6151 =item UNICOS/mk CC failures during Configure run
6152
6153 =item Arrow operator and arrays
6154
6155 =item Experimental features
6156
6157 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6158 pseudo-hash data type, The Compiler suite, Internal implementation of file
6159 globbing, The DB module, The regular expression code constructs:
6160
6161 =back
6162
6163 =item Obsolete Diagnostics
6164
6165 Character class syntax [: :] is reserved for future extensions, Ill-formed
6166 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6167 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6168 to mean "${$}<digit>" is deprecated
6169
6170 =item Reporting Bugs
6171
6172 =item SEE ALSO
6173
6174 =item HISTORY
6175
6176 =back
6177
6178 =head2 perl56delta - what's new for perl v5.6.0
6179
6180 =over 4
6181
6182 =item DESCRIPTION
6183
6184 =item Core Enhancements
6185
6186 =over 4
6187
6188 =item Interpreter cloning, threads, and concurrency
6189
6190 =item Lexically scoped warning categories
6191
6192 =item Unicode and UTF-8 support
6193
6194 =item Support for interpolating named characters
6195
6196 =item "our" declarations
6197
6198 =item Support for strings represented as a vector of ordinals
6199
6200 =item Improved Perl version numbering system
6201
6202 =item New syntax for declaring subroutine attributes
6203
6204 =item File and directory handles can be autovivified
6205
6206 =item open() with more than two arguments
6207
6208 =item 64-bit support
6209
6210 =item Large file support
6211
6212 =item Long doubles
6213
6214 =item "more bits"
6215
6216 =item Enhanced support for sort() subroutines
6217
6218 =item C<sort $coderef @foo> allowed
6219
6220 =item File globbing implemented internally
6221
6222 =item Support for CHECK blocks
6223
6224 =item POSIX character class syntax [: :] supported
6225
6226 =item Better pseudo-random number generator
6227
6228 =item Improved C<qw//> operator
6229
6230 =item Better worst-case behavior of hashes
6231
6232 =item pack() format 'Z' supported
6233
6234 =item pack() format modifier '!' supported
6235
6236 =item pack() and unpack() support counted strings
6237
6238 =item Comments in pack() templates
6239
6240 =item Weak references
6241
6242 =item Binary numbers supported
6243
6244 =item Lvalue subroutines
6245
6246 =item Some arrows may be omitted in calls through references
6247
6248 =item Boolean assignment operators are legal lvalues
6249
6250 =item exists() is supported on subroutine names
6251
6252 =item exists() and delete() are supported on array elements
6253
6254 =item Pseudo-hashes work better
6255
6256 =item Automatic flushing of output buffers
6257
6258 =item Better diagnostics on meaningless filehandle operations
6259
6260 =item Where possible, buffered data discarded from duped input filehandle
6261
6262 =item eof() has the same old magic as <>
6263
6264 =item binmode() can be used to set :crlf and :raw modes
6265
6266 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6267
6268 =item system(), backticks and pipe open now reflect exec() failure
6269
6270 =item Improved diagnostics
6271
6272 =item Diagnostics follow STDERR
6273
6274 =item More consistent close-on-exec behavior
6275
6276 =item syswrite() ease-of-use
6277
6278 =item Better syntax checks on parenthesized unary operators
6279
6280 =item Bit operators support full native integer width
6281
6282 =item Improved security features
6283
6284 =item More functional bareword prototype (*)
6285
6286 =item C<require> and C<do> may be overridden
6287
6288 =item $^X variables may now have names longer than one character
6289
6290 =item New variable $^C reflects C<-c> switch
6291
6292 =item New variable $^V contains Perl version as a string
6293
6294 =item Optional Y2K warnings
6295
6296 =item Arrays now always interpolate into double-quoted strings
6297
6298 =back
6299
6300 =item Modules and Pragmata
6301
6302 =over 4
6303
6304 =item Modules
6305
6306 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6307 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6308 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6309 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6310 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6311 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6312 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6313 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6314
6315 =item Pragmata
6316
6317 =back
6318
6319 =item Utility Changes
6320
6321 =over 4
6322
6323 =item dprofpp
6324
6325 =item find2perl
6326
6327 =item h2xs
6328
6329 =item perlcc
6330
6331 =item perldoc
6332
6333 =item The Perl Debugger
6334
6335 =back
6336
6337 =item Improved Documentation
6338
6339 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6340 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6341 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6342 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6343
6344 =item Performance enhancements
6345
6346 =over 4
6347
6348 =item Simple sort() using { $a <=> $b } and the like are optimized
6349
6350 =item Optimized assignments to lexical variables
6351
6352 =item Faster subroutine calls
6353
6354 =item delete(), each(), values() and hash iteration are faster
6355
6356 =back
6357
6358 =item Installation and Configuration Improvements
6359
6360 =over 4
6361
6362 =item -Dusethreads means something different
6363
6364 =item New Configure flags
6365
6366 =item Threadedness and 64-bitness now more daring
6367
6368 =item Long Doubles
6369
6370 =item -Dusemorebits
6371
6372 =item -Duselargefiles
6373
6374 =item installusrbinperl
6375
6376 =item SOCKS support
6377
6378 =item C<-A> flag
6379
6380 =item Enhanced Installation Directories
6381
6382 =back
6383
6384 =item Platform specific changes
6385
6386 =over 4
6387
6388 =item Supported platforms
6389
6390 =item DOS
6391
6392 =item OS390 (OpenEdition MVS)
6393
6394 =item VMS
6395
6396 =item Win32
6397
6398 =back
6399
6400 =item Significant bug fixes
6401
6402 =over 4
6403
6404 =item <HANDLE> on empty files
6405
6406 =item C<eval '...'> improvements
6407
6408 =item All compilation errors are true errors
6409
6410 =item Implicitly closed filehandles are safer
6411
6412 =item Behavior of list slices is more consistent
6413
6414 =item C<(\$)> prototype and C<$foo{a}>
6415
6416 =item C<goto &sub> and AUTOLOAD
6417
6418 =item C<-bareword> allowed under C<use integer>
6419
6420 =item Failures in DESTROY()
6421
6422 =item Locale bugs fixed
6423
6424 =item Memory leaks
6425
6426 =item Spurious subroutine stubs after failed subroutine calls
6427
6428 =item Taint failures under C<-U>
6429
6430 =item END blocks and the C<-c> switch
6431
6432 =item Potential to leak DATA filehandles
6433
6434 =back
6435
6436 =item New or Changed Diagnostics
6437
6438 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6439 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6440 / cannot take a count, / must be followed by a, A or Z, / must be followed
6441 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6442 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6443 passed through, /%s/ should probably be written as "%s", %s() called too
6444 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6445 argument is not a HASH or ARRAY element or slice, %s argument is not a
6446 subroutine name, %s package attribute may clash with future reserved word:
6447 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6448 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6449 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6450 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6451 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6452 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6453 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6454 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6455 weaken a nonreference, Character class [:%s:] unknown, Character class
6456 syntax [%s] belongs inside character classes, Constant is not %s reference,
6457 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6458 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6459 "local" instead of "our"?), Document contains no data, entering effective
6460 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6461 output, flock() on closed filehandle %s, Global symbol "%s" requires
6462 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6463 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6464 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6465 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6466 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6467 separator character %s in attribute list, Invalid separator character %s in
6468 subroutine attribute list, leaving effective %s failed, Lvalue subs
6469 returning %s not implemented yet, Method %s not permitted, Missing
6470 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6471 No %s specified for -%c, No package name allowed for variable %s in "our",
6472 No space allowed after -%c, no UTC offset information; assuming local time
6473 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6474 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6475 around "%s" list, Possible unintended interpolation of %s in string,
6476 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6477 instead, Premature end of script headers, Repeat count in pack overflows,
6478 Repeat count in unpack overflows, realloc() of freed memory ignored,
6479 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6480 zero-length expression, switching effective %s is not implemented, This
6481 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6482 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6483 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6484 escape \\%c passed through, Unterminated attribute parameter in attribute
6485 list, Unterminated attribute list, Unterminated attribute parameter in
6486 subroutine attribute list, Unterminated subroutine attribute list, Value of
6487 CLI symbol "%s" too long, Version number must be a constant number
6488
6489 =item New tests
6490
6491 =item Incompatible Changes
6492
6493 =over 4
6494
6495 =item Perl Source Incompatibilities
6496
6497 CHECK is a new keyword, Treatment of list slices of undef has changed,
6498 Format of $English::PERL_VERSION is different, Literals of the form
6499 C<1.2.3> parse differently, Possibly changed pseudo-random number
6500 generator, Hashing function for hash keys has changed, C<undef> fails on
6501 read only values, Close-on-exec bit may be set on pipe and socket handles,
6502 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6503 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6504 Text of some diagnostic output has changed, C<%@> has been removed,
6505 Parenthesized not() behaves like a list operator, Semantics of bareword
6506 prototype C<(*)> have changed, Semantics of bit operators may have changed
6507 on 64-bit platforms, More builtins taint their results
6508
6509 =item C Source Incompatibilities
6510
6511 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6512
6513 =item Compatible C Source API Changes
6514
6515 C<PATCHLEVEL> is now C<PERL_VERSION>
6516
6517 =item Binary Incompatibilities
6518
6519 =back
6520
6521 =item Known Problems
6522
6523 =over 4
6524
6525 =item Thread test failures
6526
6527 =item EBCDIC platforms not supported
6528
6529 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6530
6531 =item NEXTSTEP 3.3 POSIX test failure
6532
6533 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6534 gcc
6535
6536 =item UNICOS/mk CC failures during Configure run
6537
6538 =item Arrow operator and arrays
6539
6540 =item Experimental features
6541
6542 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6543 pseudo-hash data type, The Compiler suite, Internal implementation of file
6544 globbing, The DB module, The regular expression code constructs:
6545
6546 =back
6547
6548 =item Obsolete Diagnostics
6549
6550 Character class syntax [: :] is reserved for future extensions, Ill-formed
6551 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6552 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6553 to mean "${$}<digit>" is deprecated
6554
6555 =item Reporting Bugs
6556
6557 =item SEE ALSO
6558
6559 =item HISTORY
6560
6561 =back
6562
6563 =head2 perl5005delta - what's new for perl5.005
6564
6565 =over 4
6566
6567 =item DESCRIPTION
6568
6569 =item About the new versioning system
6570
6571 =item Incompatible Changes
6572
6573 =over 4
6574
6575 =item WARNING:  This version is not binary compatible with Perl 5.004.
6576
6577 =item Default installation structure has changed
6578
6579 =item Perl Source Compatibility
6580
6581 =item C Source Compatibility
6582
6583 =item Binary Compatibility
6584
6585 =item Security fixes may affect compatibility
6586
6587 =item Relaxed new mandatory warnings introduced in 5.004
6588
6589 =item Licensing
6590
6591 =back
6592
6593 =item Core Changes
6594
6595 =over 4
6596
6597 =item Threads
6598
6599 =item Compiler
6600
6601 =item Regular Expressions
6602
6603 Many new and improved optimizations, Many bug fixes, New regular expression
6604 constructs, New operator for precompiled regular expressions, Other
6605 improvements, Incompatible changes
6606
6607 =item   Improved malloc()
6608
6609 =item Quicksort is internally implemented
6610
6611 =item Reliable signals
6612
6613 =item Reliable stack pointers
6614
6615 =item More generous treatment of carriage returns
6616
6617 =item Memory leaks
6618
6619 =item Better support for multiple interpreters
6620
6621 =item Behavior of local() on array and hash elements is now well-defined
6622
6623 =item C<%!> is transparently tied to the L<Errno> module
6624
6625 =item Pseudo-hashes are supported
6626
6627 =item C<EXPR foreach EXPR> is supported
6628
6629 =item Keywords can be globally overridden
6630
6631 =item C<$^E> is meaningful on Win32
6632
6633 =item C<foreach (1..1000000)> optimized
6634
6635 =item C<Foo::> can be used as implicitly quoted package name
6636
6637 =item C<exists $Foo::{Bar::}> tests existence of a package
6638
6639 =item Better locale support
6640
6641 =item Experimental support for 64-bit platforms
6642
6643 =item prototype() returns useful results on builtins
6644
6645 =item Extended support for exception handling
6646
6647 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6648
6649 =item All C<printf> format conversions are handled internally
6650
6651 =item New C<INIT> keyword
6652
6653 =item New C<lock> keyword
6654
6655 =item New C<qr//> operator
6656
6657 =item C<our> is now a reserved word
6658
6659 =item Tied arrays are now fully supported
6660
6661 =item Tied handles support is better
6662
6663 =item 4th argument to substr
6664
6665 =item Negative LENGTH argument to splice
6666
6667 =item Magic lvalues are now more magical
6668
6669 =item <> now reads in records
6670
6671 =back
6672
6673 =item Supported Platforms
6674
6675 =over 4
6676
6677 =item New Platforms
6678
6679 =item Changes in existing support
6680
6681 =back
6682
6683 =item Modules and Pragmata
6684
6685 =over 4
6686
6687 =item New Modules
6688
6689 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6690 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6691 Thread, attrs, fields, re
6692
6693 =item Changes in existing modules
6694
6695 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6696 MakeMaker, CPAN, Cwd
6697
6698 =back
6699
6700 =item Utility Changes
6701
6702 =item Documentation Changes
6703
6704 =item New Diagnostics
6705
6706 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6707 while coercing array into hash, Bareword "%s" refers to nonexistent
6708 package, Can't call method "%s" on an undefined value, Can't check
6709 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6710 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6711 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6712 for "%s", Character class syntax [. .] is reserved for future extensions,
6713 Character class syntax [: :] is reserved for future extensions, Character
6714 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6715 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6716 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6717 package main), Illegal hex digit ignored, No such array field, No such
6718 field "%s" in variable %s of type %s, Out of memory during ridiculously
6719 large request, Range iterator outside integer range, Recursive inheritance
6720 detected while looking for method '%s' %s, Reference found where even-sized
6721 list expected, Undefined value assigned to typeglob, Use of reserved word
6722 "%s" is deprecated, perl: warning: Setting locale failed
6723
6724 =item Obsolete Diagnostics
6725
6726 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6727 temporary file, regexp too big
6728
6729 =item Configuration Changes
6730
6731 =item BUGS
6732
6733 =item SEE ALSO
6734
6735 =item HISTORY
6736
6737 =back
6738
6739 =head2 perl5004delta - what's new for perl5.004
6740
6741 =over 4
6742
6743 =item DESCRIPTION
6744
6745 =item Supported Environments
6746
6747 =item Core Changes
6748
6749 =over 4
6750
6751 =item List assignment to %ENV works
6752
6753 =item Change to "Can't locate Foo.pm in @INC" error
6754
6755 =item Compilation option: Binary compatibility with 5.003
6756
6757 =item $PERL5OPT environment variable
6758
6759 =item Limitations on B<-M>, B<-m>, and B<-T> options
6760
6761 =item More precise warnings
6762
6763 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6764
6765 =item Previously deprecated %OVERLOAD is no longer usable
6766
6767 =item Subroutine arguments created only when they're modified
6768
6769 =item Group vector changeable with C<$)>
6770
6771 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6772
6773 =item Fixed localization of $<digit>, $&, etc.
6774
6775 =item No resetting of $. on implicit close
6776
6777 =item C<wantarray> may return undef
6778
6779 =item C<eval EXPR> determines value of EXPR in scalar context
6780
6781 =item Changes to tainting checks
6782
6783 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6784 spawning if tainted $TERM doesn't look like a terminal name
6785
6786 =item New Opcode module and revised Safe module
6787
6788 =item Embedding improvements
6789
6790 =item Internal change: FileHandle class based on IO::* classes
6791
6792 =item Internal change: PerlIO abstraction interface
6793
6794 =item New and changed syntax
6795
6796 $coderef->(PARAMS)
6797
6798 =item New and changed builtin constants
6799
6800 __PACKAGE__
6801
6802 =item New and changed builtin variables
6803
6804 $^E, $^H, $^M
6805
6806 =item New and changed builtin functions
6807
6808 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6809 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6810 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6811 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6812 nested C<sub{}> closures work now, formats work right on changing lexicals
6813
6814 =item New builtin methods
6815
6816 isa(CLASS), can(METHOD), VERSION( [NEED] )
6817
6818 =item TIEHANDLE now supported
6819
6820 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6821 LIST, READLINE this, GETC this, DESTROY this
6822
6823 =item Malloc enhancements
6824
6825 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6826
6827 =item Miscellaneous efficiency enhancements
6828
6829 =back
6830
6831 =item Support for More Operating Systems
6832
6833 =over 4
6834
6835 =item Win32
6836
6837 =item Plan 9
6838
6839 =item QNX
6840
6841 =item AmigaOS
6842
6843 =back
6844
6845 =item Pragmata
6846
6847 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6848 constant NAME => VALUE, use locale, use ops, use vmsish
6849
6850 =item Modules
6851
6852 =over 4
6853
6854 =item Required Updates
6855
6856 =item Installation directories
6857
6858 =item Module information summary
6859
6860 =item Fcntl
6861
6862 =item IO
6863
6864 =item Math::Complex
6865
6866 =item Math::Trig
6867
6868 =item DB_File
6869
6870 =item Net::Ping
6871
6872 =item Object-oriented overrides for builtin operators
6873
6874 =back
6875
6876 =item Utility Changes
6877
6878 =over 4
6879
6880 =item pod2html
6881
6882 Sends converted HTML to standard output
6883
6884 =item xsubpp
6885
6886 C<void> XSUBs now default to returning nothing
6887
6888 =back
6889
6890 =item C Language API Changes
6891
6892 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6893 manipulating hashes
6894
6895 =item Documentation Changes
6896
6897 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6898 L<perlmodlib>, L<perldebug>, L<perlsec>
6899
6900 =item New Diagnostics
6901
6902 "my" variable %s masks earlier declaration in same scope, %s argument is
6903 not a HASH element or slice, Allocation too large: %lx, Allocation too
6904 large, Applying %s to %s will act on scalar(%s), Attempt to free
6905 nonexistent shared string, Attempt to use reference as lvalue in substr,
6906 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6907 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6908 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6909 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6910 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6911 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6912 %s, Integer overflow in hex number, Integer overflow in octal number,
6913 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6914 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6915 possible typo, Null picture in formline, Offset outside string, Out of
6916 memory!, Out of memory during request for %s, panic: frexp, Possible
6917 attempt to put comments in qw() list, Possible attempt to separate words
6918 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6919 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6920 option, untie attempted while %d inner references still exist, Unrecognized
6921 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6922 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6923 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6924 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6925 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6926 long, Process terminated by SIG%s
6927
6928 =item BUGS
6929
6930 =item SEE ALSO
6931
6932 =item HISTORY
6933
6934 =back
6935
6936 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6937
6938 =over 4
6939
6940 =item DESCRIPTION
6941
6942 =over 4
6943
6944 =item Compiling Perl 5 on AIX
6945
6946 =item OS level
6947
6948 =item Building Dynamic Extensions on AIX
6949
6950 =item The IBM ANSI C Compiler
6951
6952 =item Using GNU's gcc for building perl
6953
6954 =item Using Large Files with Perl
6955
6956 =item Threaded Perl
6957
6958 =item 64-bit Perl
6959
6960 =item AIX 4.2 and extensions using C++ with statics
6961
6962 =back
6963
6964 =item AUTHOR
6965
6966 =item DATE
6967
6968 =back
6969
6970 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6971
6972 =over 4
6973
6974 =item DESCRIPTION
6975
6976 =item AUTHOR
6977
6978 =back
6979
6980 =head2 perlamiga - Perl under Amiga OS
6981
6982 =over 4
6983
6984 =item SYNOPSIS
6985
6986 =back
6987
6988 =over 4
6989
6990 =item DESCRIPTION
6991
6992 =over 4
6993
6994 =item Prerequisites for Compiling Perl on AmigaOS
6995
6996 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
6997
6998 =item Starting Perl programs under AmigaOS
6999
7000 =item Shortcomings of Perl under AmigaOS
7001
7002 =back
7003
7004 =item INSTALLATION
7005
7006 =item Accessing documentation
7007
7008 =over 4
7009
7010 =item Manpages for Perl on AmigaOS
7011
7012 =item Perl HTML Documentation on AmigaOS
7013
7014 =item Perl GNU Info Files on AmigaOS
7015
7016 =item Perl LaTeX Documentation on AmigaOS
7017
7018 =back
7019
7020 =item BUILDING PERL ON AMIGAOS
7021
7022 =over 4
7023
7024 =item Build Prerequisites for Perl on AmigaOS
7025
7026 =item Getting the Perl Source for AmigaOS
7027
7028 =item Making Perl on AmigaOS
7029
7030 =item Testing Perl on AmigaOS
7031
7032 =item Installing the built Perl on AmigaOS
7033
7034 =back
7035
7036 =item AUTHORS
7037
7038 =item SEE ALSO
7039
7040 =back
7041
7042 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7043
7044 =over 4
7045
7046 =item DESCRIPTION
7047
7048 =over 4
7049
7050 =item General Issues with Perl on BeOS
7051
7052 =item BeOS Release-specific Notes
7053
7054 R4 x86, R4 PPC
7055
7056 =item Contact Information
7057
7058 =item Update 2002-05-30
7059
7060 =back
7061
7062 =back
7063
7064 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7065
7066 =over 4
7067
7068 =item SYNOPSIS
7069
7070 =item DESCRIPTION
7071
7072 =over 4
7073
7074 =item gzip on BS2000
7075
7076 =item bison on BS2000
7077
7078 =item Unpacking Perl Distribution on BS2000
7079
7080 =item Compiling Perl on BS2000
7081
7082 =item Testing Perl on BS2000
7083
7084 =item Installing Perl on BS2000
7085
7086 =item Using Perl in the Posix-Shell of BS2000
7087
7088 =item Using Perl in "native" BS2000
7089
7090 =item Floating point anomalies on BS2000
7091
7092 =back
7093
7094 =item AUTHORS
7095
7096 =item SEE ALSO
7097
7098 =over 4
7099
7100 =item Mailing list
7101
7102 =back
7103
7104 =item HISTORY
7105
7106 =back
7107
7108 =over 4
7109
7110 =item Name
7111
7112 =item Description
7113
7114 =item Build
7115
7116 =over 4
7117
7118 =item Tools & SDK
7119
7120 =item Make
7121
7122 =back
7123
7124 =item Acknowledgements
7125
7126 =item Author
7127
7128 =back
7129
7130 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7131
7132 =over 4
7133
7134 =item SYNOPSIS
7135
7136 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7137
7138 =over 4
7139
7140 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7141
7142 =item Cygwin Configuration
7143
7144 C<PATH>, I<nroff>, Permissions
7145
7146 =back
7147
7148 =item CONFIGURE PERL ON CYGWIN
7149
7150 =over 4
7151
7152 =item Stripping Perl Binaries on Cygwin
7153
7154 =item Optional Libraries for Perl on Cygwin
7155
7156 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7157 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7158
7159 =item Configure-time Options for Perl on Cygwin
7160
7161 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7162 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7163 C<-Dmksymlinks>
7164
7165 =item Suspicious Warnings on Cygwin
7166
7167 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7168
7169 =back
7170
7171 =item MAKE ON CYGWIN
7172
7173 =over 4
7174
7175 =item Warnings on Cygwin
7176
7177 =item ld2 on Cygwin
7178
7179 =back
7180
7181 =item TEST ON CYGWIN
7182
7183 =over 4
7184
7185 =item File Permissions on Cygwin
7186
7187 =item Script Portability on Cygwin
7188
7189 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7190
7191 =back
7192
7193 =item INSTALL PERL ON CYGWIN
7194
7195 =item MANIFEST ON CYGWIN
7196
7197 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7198 Source, Compiled Module Source, Perl Modules/Scripts
7199
7200 =item BUGS ON CYGWIN
7201
7202 =item AUTHORS
7203
7204 =item HISTORY
7205
7206 =back
7207
7208 =head2 perldgux - Perl under DG/UX.
7209
7210 =over 4
7211
7212 =item SYNOPSIS
7213
7214 =back
7215
7216 =over 4
7217
7218 =item DESCRIPTION
7219
7220 =item BUILDING PERL ON DG/UX
7221
7222 =over 4
7223
7224 =item Non-threaded Perl on DG/UX
7225
7226 =item Threaded Perl on DG/UX
7227
7228 =item Testing Perl on DG/UX
7229
7230 =item Installing the built perl on DG/UX
7231
7232 =back
7233
7234 =item AUTHOR
7235
7236 =item SEE ALSO
7237
7238 =back
7239
7240 =head2 perldos - Perl under DOS, W31, W95.
7241
7242 =over 4
7243
7244 =item SYNOPSIS
7245
7246 =item DESCRIPTION
7247
7248 =over 4
7249
7250 =item Prerequisites for Compiling Perl on DOS
7251
7252 DJGPP, Pthreads
7253
7254 =item Shortcomings of Perl under DOS
7255
7256 =item Building Perl on DOS
7257
7258 =item Testing Perl on DOS
7259
7260 =item Installation of Perl on DOS
7261
7262 =back
7263
7264 =item BUILDING AND INSTALLING MODULES ON DOS
7265
7266 =over 4
7267
7268 =item Building Prerequisites for Perl on DOS
7269
7270 =item Unpacking CPAN Modules on DOS
7271
7272 =item Building Non-XS Modules on DOS
7273
7274 =item Building XS Modules on DOS
7275
7276 =back
7277
7278 =item AUTHOR
7279
7280 =item SEE ALSO
7281
7282 =back
7283
7284 =head2 perlepoc, README.epoc - Perl for EPOC
7285
7286 =over 4
7287
7288 =item SYNOPSIS
7289
7290 =item INTRODUCTION
7291
7292 =item INSTALLING PERL ON EPOC
7293
7294 =item STARTING PERL ON EPOC
7295
7296 =over 4
7297
7298 =item Editors on Epoc
7299
7300 =item Features of Perl on Epoc
7301
7302 =item Restrictions of Perl on Epoc
7303
7304 =item Compiling Perl 5 on the EPOC cross compiling environment
7305
7306 =back
7307
7308 =item SUPPORT STATUS OF PERL ON EPOC
7309
7310 =item AUTHOR
7311
7312 =item LAST UPDATE
7313
7314 =back
7315
7316 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7317
7318 =over 4
7319
7320 =item DESCRIPTION
7321
7322 =over 4
7323
7324 =item FreeBSD core dumps from readdir_r with ithreads
7325
7326 =item $^X doesn't always contain a full path in FreeBSD
7327
7328 =item Perl will no more be part of "base FreeBSD"
7329
7330 =back
7331
7332 =item AUTHOR
7333
7334 =back
7335
7336 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7337 (HP-UX) systems
7338
7339 =over 4
7340
7341 =item DESCRIPTION
7342
7343 =over 4
7344
7345 =item Using perl as shipped with HP-UX
7346
7347 =item Compiling Perl 5 on HP-UX
7348
7349 =item PA-RISC
7350
7351 =item PA-RISC 1.0
7352
7353 =item PA-RISC 1.1
7354
7355 =item PA-RISC 2.0
7356
7357 =item Itanium
7358
7359 =item Portability Between PA-RISC Versions
7360
7361 =item Itanium Processor Family and HP-UX
7362
7363 =item Building Dynamic Extensions on HP-UX
7364
7365 =item The HP ANSI C Compiler
7366
7367 =item The GNU C Compiler
7368
7369 =item Using Large Files with Perl on HP-UX
7370
7371 =item Threaded Perl on HP-UX
7372
7373 =item 64-bit Perl on HP-UX
7374
7375 =item Oracle on HP-UX
7376
7377 =item GDBM and Threads on HP-UX
7378
7379 =item NFS filesystems and utime(2) on HP-UX
7380
7381 =item perl -P and // and HP-UX
7382
7383 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7384
7385 =back
7386
7387 =item nss_delete core dump from op/pwent or op/grent
7388
7389 =item AUTHOR
7390
7391 =item DATE
7392
7393 =back
7394
7395 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7396
7397 =over 4
7398
7399 =item DESCRIPTION
7400
7401 =over 4
7402
7403 =item Known Problems with Perl on Hurd
7404
7405 =back
7406
7407 =item AUTHOR
7408
7409 =back
7410
7411 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7412
7413 =over 4
7414
7415 =item DESCRIPTION
7416
7417 =over 4
7418
7419 =item Building 32-bit Perl in Irix
7420
7421 =item Building 64-bit Perl in Irix
7422
7423 =item About Compiler Versions of Irix
7424
7425 =item Linker Problems in Irix
7426
7427 =item Malloc in Irix
7428
7429 =item Building with threads
7430
7431 =back
7432
7433 =item AUTHOR
7434
7435 =back
7436
7437 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7438 systems
7439
7440 =over 4
7441
7442 =item DESCRIPTION
7443
7444 =over 4
7445
7446 =item Compiling Perl 5 on MachTen
7447
7448 =item Failures during C<make test> on MachTen
7449
7450 op/lexassign.t, pragma/warnings.t
7451
7452 =item Building external modules on MachTen
7453
7454 =back
7455
7456 =item AUTHOR
7457
7458 =item DATE
7459
7460 =back
7461
7462 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7463
7464 =over 4
7465
7466 =item SYNOPSIS
7467
7468 =item DESCRIPTION
7469
7470 =item AUTHOR
7471
7472 =item DATE
7473
7474 =back
7475
7476 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7477
7478 =over 4
7479
7480 =item DESCRIPTION
7481
7482 =item Known problems with Perl on MiNT
7483
7484 =item AUTHOR
7485
7486 =back
7487
7488 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7489
7490 =over 4
7491
7492 =item SYNOPSIS
7493
7494 =item NOTE
7495
7496 =item Binary distribution from HP
7497
7498 =item What's New in Perl for MPE/iX
7499
7500 =item Welcome to Perl/iX
7501
7502 =item System Requirements for Perl/iX
7503
7504 =item How to Obtain Perl/iX
7505
7506 =item Perl/iX Distribution Contents Highlights
7507
7508 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7509 public_html/feedback.cgi, src/perl-5.6.0-mpe
7510
7511 =item How to Compile Perl/iX
7512
7513  4,  6
7514
7515 =item Getting Started with Perl/iX
7516
7517 =item MPE/iX Implementation Considerations
7518
7519 =item Known Perl/iX Bugs Under Investigation
7520
7521 =item Perl/iX To-Do List
7522
7523 =item Perl/iX Change History
7524
7525 =item AUTHOR
7526
7527 =item Name
7528
7529 =item Description
7530
7531 =item Build
7532
7533 =over 4
7534
7535 =item Tools & SDK
7536
7537 =item Setup
7538
7539 SetNWBld.bat, Buildtype.bat
7540
7541 =item Make
7542
7543 =item Interpreter
7544
7545 =item Extensions
7546
7547 =back
7548
7549 =item Install
7550
7551 =item Acknowledgements
7552
7553 =item Authors
7554
7555 =item Date
7556
7557 =back
7558
7559 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7560
7561 =over 4
7562
7563 =item SYNOPSIS
7564
7565 =back
7566
7567 =over 4
7568
7569 =item DESCRIPTION
7570
7571 =over 4
7572
7573 =item Target
7574
7575 =item Other OSes
7576
7577 =item Prerequisites
7578
7579 EMX, RSX, HPFS, pdksh
7580
7581 =item Starting Perl programs under OS/2 (and DOS and...)
7582
7583 =item Starting OS/2 (and DOS) programs under Perl
7584
7585 =back
7586
7587 =item Frequently asked questions
7588
7589 =over 4
7590
7591 =item "It does not work"
7592
7593 =item I cannot run external programs
7594
7595 =item I cannot embed perl into my program, or use F<perl.dll> from my
7596 program.
7597
7598 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7599 L<ExtUtils::Embed>?
7600
7601 =item C<``> and pipe-C<open> do not work under DOS.
7602
7603 =item Cannot start C<find.exe "pattern" file>
7604
7605 =back
7606
7607 =item INSTALLATION
7608
7609 =over 4
7610
7611 =item Automatic binary installation
7612
7613 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7614
7615 =item Manual binary installation
7616
7617 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7618 (statically linked), Executables for Perl utilities, Main Perl library,
7619 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7620 and utilities, Manpages for Perl modules, Source for Perl documentation,
7621 Perl manual in F<.INF> format, Pdksh
7622
7623 =item B<Warning>
7624
7625 =back
7626
7627 =item Accessing documentation
7628
7629 =over 4
7630
7631 =item OS/2 F<.INF> file
7632
7633 =item Plain text
7634
7635 =item Manpages
7636
7637 =item HTML
7638
7639 =item GNU C<info> files
7640
7641 =item F<PDF> files
7642
7643 =item C<LaTeX> docs
7644
7645 =back
7646
7647 =item BUILD
7648
7649 =over 4
7650
7651 =item The short story
7652
7653 =item Prerequisites
7654
7655 =item Getting perl source
7656
7657 =item Application of the patches
7658
7659 =item Hand-editing
7660
7661 =item Making
7662
7663 =item Testing
7664
7665 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7666 F<op/stat.t>
7667
7668 =item Installing the built perl
7669
7670 =item C<a.out>-style build
7671
7672 =back
7673
7674 =item Build FAQ
7675
7676 =over 4
7677
7678 =item Some C</> became C<\> in pdksh.
7679
7680 =item C<'errno'> - unresolved external
7681
7682 =item Problems with tr or sed
7683
7684 =item Some problem (forget which ;-)
7685
7686 =item Library ... not found
7687
7688 =item Segfault in make
7689
7690 =item op/sprintf test failure
7691
7692 =back
7693
7694 =item Specific (mis)features of OS/2 port
7695
7696 =over 4
7697
7698 =item C<setpriority>, C<getpriority>
7699
7700 =item C<system()>
7701
7702 =item C<extproc> on the first line
7703
7704 =item Additional modules:
7705
7706 =item Prebuilt methods:
7707
7708 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7709  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
7710 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
7711 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
7712 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
7713 C<Cwd::extLibpath_set( path [, type ] )>,
7714 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7715 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7716 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7717 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7718 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7719
7720 =item Prebuilt variables:
7721
7722 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7723
7724 =item Misfeatures
7725
7726 =item Modifications
7727
7728 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7729 C<flock>
7730
7731 =item Identifying DLLs
7732
7733 =item Centralized management of resources
7734
7735 C<HAB>, C<HMQ>
7736
7737 =back
7738
7739 =item Perl flavors
7740
7741 =over 4
7742
7743 =item F<perl.exe>
7744
7745 =item F<perl_.exe>
7746
7747 =item F<perl__.exe>
7748
7749 =item F<perl___.exe>
7750
7751 =item Why strange names?
7752
7753 =item Why dynamic linking?
7754
7755 =item Why chimera build?
7756
7757 =back
7758
7759 =item ENVIRONMENT
7760
7761 =over 4
7762
7763 =item C<PERLLIB_PREFIX>
7764
7765 =item C<PERL_BADLANG>
7766
7767 =item C<PERL_BADFREE>
7768
7769 =item C<PERL_SH_DIR>
7770
7771 =item C<USE_PERL_FLOCK>
7772
7773 =item C<TMP> or C<TEMP>
7774
7775 =back
7776
7777 =item Evolution
7778
7779 =over 4
7780
7781 =item Priorities
7782
7783 =item DLL name mangling: pre 5.6.2
7784
7785 =item DLL name mangling: 5.6.2 and beyond
7786
7787 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7788 C<LIBPATH>
7789
7790 =item DLL forwarder generation
7791
7792 =item Threading
7793
7794 =item Calls to external programs
7795
7796 =item Memory allocation
7797
7798 =item Threads
7799
7800 C<COND_WAIT>, F<os2.c>
7801
7802 =back
7803
7804 =item BUGS
7805
7806 =back
7807
7808 =over 4
7809
7810 =item AUTHOR
7811
7812 =item SEE ALSO
7813
7814 =back
7815
7816 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7817 and z/OS
7818
7819 =over 4
7820
7821 =item SYNOPSIS
7822
7823 =item DESCRIPTION
7824
7825 =over 4
7826
7827 =item Tools
7828
7829 =item Unpacking Perl distribution on OS/390
7830
7831 =item Setup and utilities for Perl on OS/390
7832
7833 =item Configure Perl on OS/390
7834
7835 =item Build, Test, Install Perl on OS/390
7836
7837 =item Build Anomalies with Perl on OS/390
7838
7839 =item Testing Anomalies with Perl on OS/390
7840
7841 =item Installation Anomalies with Perl on OS/390
7842
7843 =item Usage Hints for Perl on OS/390
7844
7845 =item Floating Point Anomalies with Perl on OS/390
7846
7847 =item Modules and Extensions for Perl on OS/390
7848
7849 =back
7850
7851 =item AUTHORS
7852
7853 =item SEE ALSO
7854
7855 =over 4
7856
7857 =item Mailing list for Perl on OS/390
7858
7859 =back
7860
7861 =item HISTORY
7862
7863 =back
7864
7865 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7866
7867 =over 4
7868
7869 =item DESCRIPTION
7870
7871 =over 4
7872
7873 =item Required Software for Compiling Perl on QNX4
7874
7875 /bin/sh, ar, nm, cpp, make
7876
7877 =item Outstanding Issues with Perl on QNX4
7878
7879 =item QNX auxiliary files
7880
7881 qnx/ar, qnx/cpp
7882
7883 =item Outstanding issues with perl under QNX6
7884
7885 =back
7886
7887 =item AUTHOR
7888
7889 =back
7890
7891 =head2 perlplan9 - Plan 9-specific documentation for Perl
7892
7893 =over 4
7894
7895 =item DESCRIPTION
7896
7897 =over 4
7898
7899 =item Invoking Perl
7900
7901 =item What's in Plan 9 Perl
7902
7903 =item What's not in Plan 9 Perl
7904
7905 =item Perl5 Functions not currently supported in Plan 9 Perl
7906
7907 =item Signals in Plan 9 Perl
7908
7909 =back
7910
7911 =item COMPILING AND INSTALLING PERL ON PLAN 9
7912
7913 =over 4
7914
7915 =item Installing Perl Documentation on Plan 9
7916
7917 =back
7918
7919 =item BUGS
7920
7921 =item Revision date
7922
7923 =item AUTHOR
7924
7925 =back
7926
7927 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7928
7929 =over 4
7930
7931 =item DESCRIPTION
7932
7933 =over 4
7934
7935 =item Solaris Version Numbers.
7936
7937 =back
7938
7939 =item RESOURCES
7940
7941 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7942
7943 =item SETTING UP
7944
7945 =over 4
7946
7947 =item File Extraction Problems on Solaris.
7948
7949 =item Compiler and Related Tools on Solaris.
7950
7951 =item Environment for Compiling Perl on Solaris
7952
7953 =back
7954
7955 =item RUN CONFIGURE.
7956
7957 =over 4
7958
7959 =item 64-bit Issues with Perl on Solaris.
7960
7961 =item Threads in Perl on Solaris.
7962
7963 =item Malloc Issues with Perl on Solaris.
7964
7965 =back
7966
7967 =item MAKE PROBLEMS.
7968
7969 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
7970 relocation error:, dlopen: stub interception failed, #error "No
7971 DATAMODEL_NATIVE specified", sh: ar: not found
7972
7973 =item MAKE TEST
7974
7975 =over 4
7976
7977 =item op/stat.t test 4 in Solaris
7978
7979 =item nss_delete core dump from op/pwent or op/grent
7980
7981 =back
7982
7983 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
7984
7985 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
7986
7987 =over 4
7988
7989 =item Limits on Numbers of Open Files on Solaris.
7990
7991 =back
7992
7993 =item SOLARIS-SPECIFIC MODULES.
7994
7995 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
7996
7997 =over 4
7998
7999 =item Proc::ProcessTable on Solaris
8000
8001 =item BSD::Resource on Solaris
8002
8003 =item Net::SSLeay on Solaris
8004
8005 =back
8006
8007 =item AUTHOR
8008
8009 =item LAST MODIFIED
8010
8011 =back
8012
8013 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8014 Digital UNIX formerly known as DEC OSF/1) systems
8015
8016 =over 4
8017
8018 =item DESCRIPTION
8019
8020 =over 4
8021
8022 =item Compiling Perl 5 on Tru64
8023
8024 =item Using Large Files with Perl on Tru64
8025
8026 =item Threaded Perl on Tru64
8027
8028 =item Long Doubles on Tru64
8029
8030 =item 64-bit Perl on Tru64
8031
8032 =item Warnings about floating-point overflow when compiling Perl on Tru64
8033
8034 =back
8035
8036 =item Testing Perl on Tru64
8037
8038 =item ext/ODBM_File/odbm Test Failing With Static Builds
8039
8040 =item Perl Fails Because Of Unresolved Symbol sockatmark
8041
8042 =item AUTHOR
8043
8044 =back
8045
8046 =head2 perluts - Perl under UTS
8047
8048 =over 4
8049
8050 =item SYNOPSIS
8051
8052 =item DESCRIPTION
8053
8054 =item BUILDING PERL ON UTS
8055
8056 =item Installing the built perl on UTS
8057
8058 =item AUTHOR
8059
8060 =back
8061
8062 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8063
8064 =over 4
8065
8066 =item SYNOPSIS
8067
8068 =item DESCRIPTION
8069
8070 =over 4
8071
8072 =item Unpacking Perl Distribution on VM/ESA
8073
8074 =item Setup Perl and utilities on VM/ESA
8075
8076 =item Configure Perl on VM/ESA
8077
8078 =item Testing Anomalies of Perl on VM/ESA
8079
8080 =item Usage Hints for Perl on VM/ESA
8081
8082 =back
8083
8084 =item AUTHORS
8085
8086 =item SEE ALSO
8087
8088 =over 4
8089
8090 =item Mailing list for Perl on VM/ESA
8091
8092 =back
8093
8094 =back
8095
8096 =head2 perlvms - VMS-specific documentation for Perl
8097
8098 =over 4
8099
8100 =item DESCRIPTION
8101
8102 =item Installation
8103
8104 =item Organization of Perl Images
8105
8106 =over 4
8107
8108 =item Core Images
8109
8110 =item Perl Extensions
8111
8112 =item Installing static extensions
8113
8114 =item Installing dynamic extensions
8115
8116 =back
8117
8118 =item File specifications
8119
8120 =over 4
8121
8122 =item Syntax
8123
8124 =item Wildcard expansion
8125
8126 =item Pipes
8127
8128 =back
8129
8130 =item PERL5LIB and PERLLIB
8131
8132 =item Command line
8133
8134 =over 4
8135
8136 =item I/O redirection and backgrounding
8137
8138 =item Command line switches
8139
8140 -i, -S, -u
8141
8142 =back
8143
8144 =item Perl functions
8145
8146 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8147 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8148 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8149 LIST, waitpid PID,FLAGS
8150
8151 =item Perl variables
8152
8153 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8154
8155 =item Standard modules with VMS-specific differences
8156
8157 =over 4
8158
8159 =item SDBM_File
8160
8161 =back
8162
8163 =item Revision date
8164
8165 =item AUTHOR
8166
8167 =back
8168
8169 =head2 perlvos, README.vos - Perl for Stratus VOS
8170
8171 =over 4
8172
8173 =item SYNOPSIS
8174
8175 =over 4
8176
8177 =item Multiple methods to build perl for VOS
8178
8179 =item Stratus POSIX Support
8180
8181 =back
8182
8183 =item INSTALLING PERL IN VOS
8184
8185 =over 4
8186
8187 =item Compiling Perl 5 on VOS
8188
8189 =item Installing Perl 5 on VOS
8190
8191 =back
8192
8193 =item USING PERL IN VOS
8194
8195 =over 4
8196
8197 =item Unimplemented Features of Perl on VOS
8198
8199 =item Restrictions of Perl on VOS
8200
8201 =item Handling of underflow and overflow
8202
8203 =back
8204
8205 =item TEST STATUS
8206
8207 =item SUPPORT STATUS
8208
8209 =item AUTHOR
8210
8211 =item LAST UPDATE
8212
8213 =back
8214
8215 =head2 perlwin32 - Perl under Windows
8216
8217 =over 4
8218
8219 =item SYNOPSIS
8220
8221 =item DESCRIPTION
8222
8223 =over 4
8224
8225 =item Setting Up Perl on Win32
8226
8227 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8228 SDK 64-bit Compiler, Mingw32 with GCC
8229
8230 =item Building
8231
8232 =item Testing Perl on Win32
8233
8234 =item Installation of Perl on Win32
8235
8236 =item Usage Hints for Perl on Win32
8237
8238 Environment Variables, File Globbing, Using perl from the command line,
8239 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8240 Extensions, Notes on 64-bit Windows
8241
8242 =item Running Perl Scripts
8243
8244 Miscellaneous Things
8245
8246 =back
8247
8248 =item BUGS AND CAVEATS
8249
8250 =item AUTHORS
8251
8252 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8253 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8254 E<lt>nick@ing-simmons.netE<gt>
8255
8256 =item SEE ALSO
8257
8258 =item HISTORY
8259
8260 =back
8261
8262 =head1 PRAGMA DOCUMENTATION
8263
8264 =head2 attrs - set/get attributes of a subroutine (deprecated)
8265
8266 =over 4
8267
8268 =item SYNOPSIS
8269
8270 =item DESCRIPTION
8271
8272 method, locked
8273
8274 =back
8275
8276 =head2 re - Perl pragma to alter regular expression behaviour
8277
8278 =over 4
8279
8280 =item SYNOPSIS
8281
8282 =item DESCRIPTION
8283
8284 =back
8285
8286 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8287
8288 =over 4
8289
8290 =item SYNOPSIS
8291
8292 =item DESCRIPTION
8293
8294 =item FUNCTIONS AND METHODS
8295
8296 new, enqueue LIST, dequeue, dequeue_nb, pending
8297
8298 =item SEE ALSO
8299
8300 =back
8301
8302 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8303 semaphores
8304
8305 =over 4
8306
8307 =item SYNOPSIS
8308
8309 =item DESCRIPTION
8310
8311 =item FUNCTIONS AND METHODS
8312
8313 new, new NUMBER, down, down NUMBER, up, up NUMBER
8314
8315 =back
8316
8317 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8318 data structures between threads
8319
8320 =over 4
8321
8322 =item SYNOPSIS
8323
8324 =item DESCRIPTION
8325
8326 =item EXPORT
8327
8328 =item FUNCTIONS
8329
8330 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8331 cond_broadcast VARIABLE
8332
8333 =item NOTES
8334
8335 =item BUGS
8336
8337 =item AUTHOR
8338
8339 =item SEE ALSO
8340
8341 =back
8342
8343 =head2 threads - Perl extension allowing use of interpreter based threads
8344 from perl
8345
8346 =over 4
8347
8348 =item SYNOPSIS
8349
8350 =item DESCRIPTION
8351
8352 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8353 threads->self, $thread->tid, threads->yield();, threads->list();, async
8354 BLOCK;
8355
8356 =item WARNINGS
8357
8358 A thread exited while %d other threads were still running
8359
8360 =item BUGS / TODO
8361
8362 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8363 not threadsafe, will not be
8364
8365 =item AUTHOR and COPYRIGHT
8366
8367 =item SEE ALSO
8368
8369 =back
8370
8371 =head2 attributes - get/set subroutine or variable attributes
8372
8373 =over 4
8374
8375 =item SYNOPSIS
8376
8377 =item DESCRIPTION
8378
8379 =over 4
8380
8381 =item Built-in Attributes
8382
8383 locked, method, lvalue
8384
8385 =item Available Subroutines
8386
8387 get, reftype
8388
8389 =item Package-specific Attribute Handling
8390
8391 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8392
8393 =item Syntax of Attribute Lists
8394
8395 =back
8396
8397 =item EXPORTS
8398
8399 =over 4
8400
8401 =item Default exports
8402
8403 =item Available exports
8404
8405 =item Export tags defined
8406
8407 =back
8408
8409 =item EXAMPLES
8410
8411 =item SEE ALSO
8412
8413 =back
8414
8415 =head2 attrs - set/get attributes of a subroutine (deprecated)
8416
8417 =over 4
8418
8419 =item SYNOPSIS
8420
8421 =item DESCRIPTION
8422
8423 method, locked
8424
8425 =back
8426
8427 =head2 autouse - postpone load of modules until a function is used
8428
8429 =over 4
8430
8431 =item SYNOPSIS
8432
8433 =item DESCRIPTION
8434
8435 =item WARNING
8436
8437 =item AUTHOR
8438
8439 =item SEE ALSO
8440
8441 =back
8442
8443 =head2 base - Establish IS-A relationship with base class at compile time
8444
8445 =over 4
8446
8447 =item SYNOPSIS
8448
8449 =item DESCRIPTION
8450
8451 =item HISTORY
8452
8453 =item SEE ALSO
8454
8455 =back
8456
8457 =head2 bigint - Transparent big integer support for Perl
8458
8459 =over 4
8460
8461 =item SYNOPSIS
8462
8463 =item DESCRIPTION
8464
8465 =over 4
8466
8467 =item OPTIONS
8468
8469 a or accuracy, p or precision, t or trace, l or lib, v or version
8470
8471 =item MATH LIBRARY
8472
8473 =item INTERNAL FORMAT
8474
8475 =item SIGN
8476
8477 =item METHODS
8478
8479 =back
8480
8481 =item MODULES USED
8482
8483 =item EXAMPLES
8484
8485 =item LICENSE
8486
8487 =item SEE ALSO
8488
8489 =item AUTHORS
8490
8491 =back
8492
8493 =head2 bignum - Transparent BigNumber support for Perl
8494
8495 =over 4
8496
8497 =item SYNOPSIS
8498
8499 =item DESCRIPTION
8500
8501 =over 4
8502
8503 =item OPTIONS
8504
8505 a or accuracy, p or precision, t or trace, l or lib, v or version
8506
8507 =item MATH LIBRARY
8508
8509 =item INTERNAL FORMAT
8510
8511 =item SIGN
8512
8513 =item METHODS
8514
8515 =back
8516
8517 =item MODULES USED
8518
8519 =item EXAMPLES
8520
8521 =item LICENSE
8522
8523 =item SEE ALSO
8524
8525 =item AUTHORS
8526
8527 =back
8528
8529 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8530
8531 =over 4
8532
8533 =item SYNOPSIS
8534
8535 =item DESCRIPTION
8536
8537 =over 4
8538
8539 =item MODULES USED
8540
8541 =item MATH LIBRARY
8542
8543 =item SIGN
8544
8545 =item METHODS
8546
8547 =back
8548
8549 =item EXAMPLES
8550
8551         perl -Mbigrat -le 'print sqrt(33)'
8552         perl -Mbigrat -le 'print 2*255'
8553         perl -Mbigrat -le 'print 4.5+2*255'
8554         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8555         perl -Mbigrat -le 'print 12->is_odd()';
8556
8557 =item LICENSE
8558
8559 =item SEE ALSO
8560
8561 =item AUTHORS
8562
8563 =back
8564
8565 =head2 blib - Use MakeMaker's uninstalled version of a package
8566
8567 =over 4
8568
8569 =item SYNOPSIS
8570
8571 =item DESCRIPTION
8572
8573 =item BUGS
8574
8575 =item AUTHOR
8576
8577 =back
8578
8579 =head2 bytes - Perl pragma to force byte semantics rather than character
8580 semantics
8581
8582 =over 4
8583
8584 =item SYNOPSIS
8585
8586 =item DESCRIPTION
8587
8588 =item SEE ALSO
8589
8590 =back
8591
8592 =head2 charnames - define character names for C<\N{named}> string literal
8593 escapes
8594
8595 =over 4
8596
8597 =item SYNOPSIS
8598
8599 =item DESCRIPTION
8600
8601 =item CUSTOM TRANSLATORS
8602
8603 =item charnames::viacode(code)
8604
8605 =item charnames::vianame(name)
8606
8607 =item ALIASES
8608
8609 =item ILLEGAL CHARACTERS
8610
8611 =item BUGS
8612
8613 =back
8614
8615 =head2 constant - Perl pragma to declare constants
8616
8617 =over 4
8618
8619 =item SYNOPSIS
8620
8621 =item DESCRIPTION
8622
8623 =item NOTES
8624
8625 =over 4
8626
8627 =item List constants
8628
8629 =item Defining multiple constants at once
8630
8631 =item Magic constants
8632
8633 =back
8634
8635 =item TECHNICAL NOTES
8636
8637 =item BUGS
8638
8639 =item AUTHOR
8640
8641 =item COPYRIGHT
8642
8643 =back
8644
8645 =head2 diagnostics - Perl compiler pragma to force verbose warning
8646 diagnostics
8647
8648 =over 4
8649
8650 =item SYNOPSIS
8651
8652 =item DESCRIPTION
8653
8654 =over 4
8655
8656 =item The C<diagnostics> Pragma
8657
8658 =item The I<splain> Program
8659
8660 =back
8661
8662 =item EXAMPLES
8663
8664 =item INTERNALS
8665
8666 =item BUGS
8667
8668 =item AUTHOR
8669
8670 =back
8671
8672 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8673
8674 =over 4
8675
8676 =item SYNOPSIS
8677
8678 =item ABSTRACT
8679
8680 =item USAGE
8681
8682 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8683 I<ENCNAME_IN> ...] ;, no encoding;
8684
8685 =item CAVEATS
8686
8687 =over 4
8688
8689 =item NOT SCOPED
8690
8691 =item DO NOT MIX MULTIPLE ENCODINGS
8692
8693 =back
8694
8695 =item Non-ASCII Identifiers and Filter option
8696
8697 use encoding I<ENCNAME> Filter=E<gt>1;
8698
8699 =item EXAMPLE - Greekperl
8700
8701 =item KNOWN PROBLEMS
8702
8703 =item SEE ALSO
8704
8705 =back
8706
8707 =head2 fields - compile-time class fields
8708
8709 =over 4
8710
8711 =item SYNOPSIS
8712
8713 =item DESCRIPTION
8714
8715 new, phash
8716
8717 =item SEE ALSO
8718
8719 =back
8720
8721 =head2 filetest - Perl pragma to control the filetest permission operators
8722
8723 =over 4
8724
8725 =item SYNOPSIS
8726
8727 =item DESCRIPTION
8728
8729 =over 4
8730
8731 =item subpragma access
8732
8733 =back
8734
8735 =back
8736
8737 =head2 if - C<use> a Perl module if a condition holds
8738
8739 =over 4
8740
8741 =item SYNOPSIS
8742
8743 =item DESCRIPTION
8744
8745 =item BUGS
8746
8747 =item AUTHOR
8748
8749 =back
8750
8751 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8752 point
8753
8754 =over 4
8755
8756 =item SYNOPSIS
8757
8758 =item DESCRIPTION
8759
8760 =back
8761
8762 =head2 less - perl pragma to request less of something from the compiler
8763
8764 =over 4
8765
8766 =item SYNOPSIS
8767
8768 =item DESCRIPTION
8769
8770 =back
8771
8772 =head2 lib - manipulate @INC at compile time
8773
8774 =over 4
8775
8776 =item SYNOPSIS
8777
8778 =item DESCRIPTION
8779
8780 =over 4
8781
8782 =item Adding directories to @INC
8783
8784 =item Deleting directories from @INC
8785
8786 =item Restoring original @INC
8787
8788 =back
8789
8790 =item CAVEATS
8791
8792 =item NOTES
8793
8794 =item SEE ALSO
8795
8796 =item AUTHOR
8797
8798 =back
8799
8800 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8801 operations
8802
8803 =over 4
8804
8805 =item SYNOPSIS
8806
8807 =item DESCRIPTION
8808
8809 =back
8810
8811 =head2 open - perl pragma to set default disciplines for input and output
8812
8813 =over 4
8814
8815 =item SYNOPSIS
8816
8817 =item DESCRIPTION
8818
8819 =item NONPERLIO FUNCTIONALITY
8820
8821 =item IMPLEMENTATION DETAILS
8822
8823 =item SEE ALSO
8824
8825 =back
8826
8827 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8828
8829 =over 4
8830
8831 =item SYNOPSIS
8832
8833 =item DESCRIPTION
8834
8835 =item SEE ALSO
8836
8837 =back
8838
8839 =head2 overload - Package for overloading perl operations
8840
8841 =over 4
8842
8843 =item SYNOPSIS
8844
8845 =item DESCRIPTION
8846
8847 =over 4
8848
8849 =item Declaration of overloaded functions
8850
8851 =item Calling Conventions for Binary Operations
8852
8853 FALSE, TRUE, C<undef>
8854
8855 =item Calling Conventions for Unary Operations
8856
8857 =item Calling Conventions for Mutators
8858
8859 C<++> and C<-->, C<x=> and other assignment versions
8860
8861 =item Overloadable Operations
8862
8863 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8864 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8865 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8866
8867 =item Inheritance and overloading
8868
8869 Strings as values of C<use overload> directive, Overloading of an operation
8870 is inherited by derived classes
8871
8872 =back
8873
8874 =item SPECIAL SYMBOLS FOR C<use overload>
8875
8876 =over 4
8877
8878 =item Last Resort
8879
8880 =item Fallback
8881
8882 C<undef>, TRUE, defined, but FALSE
8883
8884 =item Copy Constructor
8885
8886 B<Example>
8887
8888 =back
8889
8890 =item MAGIC AUTOGENERATION
8891
8892 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8893 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8894 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8895 I<Copy operator>
8896
8897 =item Losing overloading
8898
8899 =item Run-time Overloading
8900
8901 =item Public functions
8902
8903 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8904
8905 =item Overloading constants
8906
8907 integer, float, binary, q, qr
8908
8909 =item IMPLEMENTATION
8910
8911 =item Metaphor clash
8912
8913 =item Cookbook
8914
8915 =over 4
8916
8917 =item Two-face scalars
8918
8919 =item Two-face references
8920
8921 =item Symbolic calculator
8922
8923 =item I<Really> symbolic calculator
8924
8925 =back
8926
8927 =item AUTHOR
8928
8929 =item DIAGNOSTICS
8930
8931 Odd number of arguments for overload::constant, `%s' is not an overloadable
8932 type, `%s' is not a code reference
8933
8934 =item BUGS
8935
8936 =back
8937
8938 =head2 re - Perl pragma to alter regular expression behaviour
8939
8940 =over 4
8941
8942 =item SYNOPSIS
8943
8944 =item DESCRIPTION
8945
8946 =back
8947
8948 =head2 sigtrap - Perl pragma to enable simple signal handling
8949
8950 =over 4
8951
8952 =item SYNOPSIS
8953
8954 =item DESCRIPTION
8955
8956 =item OPTIONS
8957
8958 =over 4
8959
8960 =item SIGNAL HANDLERS
8961
8962 B<stack-trace>, B<die>, B<handler> I<your-handler>
8963
8964 =item SIGNAL LISTS
8965
8966 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8967
8968 =item OTHER
8969
8970 B<untrapped>, B<any>, I<signal>, I<number>
8971
8972 =back
8973
8974 =item EXAMPLES
8975
8976 =back
8977
8978 =head2 sort - perl pragma to control sort() behaviour
8979
8980 =over 4
8981
8982 =item SYNOPSIS
8983
8984 =item DESCRIPTION
8985
8986 =item CAVEATS
8987
8988 =back
8989
8990 =head2 strict - Perl pragma to restrict unsafe constructs
8991
8992 =over 4
8993
8994 =item SYNOPSIS
8995
8996 =item DESCRIPTION
8997
8998 C<strict refs>, C<strict vars>, C<strict subs>
8999
9000 =back
9001
9002 =head2 subs - Perl pragma to predeclare sub names
9003
9004 =over 4
9005
9006 =item SYNOPSIS
9007
9008 =item DESCRIPTION
9009
9010 =back
9011
9012 =head2 threads - Perl extension allowing use of interpreter based threads
9013 from perl
9014
9015 =over 4
9016
9017 =item SYNOPSIS
9018
9019 =item DESCRIPTION
9020
9021 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9022 threads->self, $thread->tid, threads->yield();, threads->list();, async
9023 BLOCK;
9024
9025 =item WARNINGS
9026
9027 A thread exited while %d other threads were still running
9028
9029 =item BUGS / TODO
9030
9031 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
9032 not threadsafe, will not be
9033
9034 =item AUTHOR and COPYRIGHT
9035
9036 =item SEE ALSO
9037
9038 =back
9039
9040 =head2 threadshared, threads::shared - Perl extension for sharing data
9041 structures between threads
9042
9043 =over 4
9044
9045 =item SYNOPSIS
9046
9047 =item DESCRIPTION
9048
9049 =item EXPORT
9050
9051 =item FUNCTIONS
9052
9053 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9054 cond_broadcast VARIABLE
9055
9056 =item NOTES
9057
9058 =item BUGS
9059
9060 =item AUTHOR
9061
9062 =item SEE ALSO
9063
9064 =back
9065
9066 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
9067
9068 =over 4
9069
9070 =item SYNOPSIS
9071
9072 =item DESCRIPTION
9073
9074 =item FUNCTIONS AND METHODS
9075
9076 new, enqueue LIST, dequeue, dequeue_nb, pending
9077
9078 =item SEE ALSO
9079
9080 =back
9081
9082 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
9083 semaphores
9084
9085 =over 4
9086
9087 =item SYNOPSIS
9088
9089 =item DESCRIPTION
9090
9091 =item FUNCTIONS AND METHODS
9092
9093 new, new NUMBER, down, down NUMBER, up, up NUMBER
9094
9095 =back
9096
9097 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9098 code
9099
9100 =over 4
9101
9102 =item SYNOPSIS
9103
9104 =item DESCRIPTION
9105
9106 =over 4
9107
9108 =item Utility functions
9109
9110 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9111 utf8::encode($string), $flag = utf8::decode($string), $flag =
9112 utf8::valid(STRING)
9113
9114 =back
9115
9116 =item SEE ALSO
9117
9118 =back
9119
9120 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9121
9122 =over 4
9123
9124 =item SYNOPSIS
9125
9126 =item DESCRIPTION
9127
9128 =back
9129
9130 =head2 vmsish - Perl pragma to control VMS-specific language features
9131
9132 =over 4
9133
9134 =item SYNOPSIS
9135
9136 =item DESCRIPTION
9137
9138 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9139
9140 =back
9141
9142 =head2 warnings - Perl pragma to control optional warnings
9143
9144 =over 4
9145
9146 =item SYNOPSIS
9147
9148 =item DESCRIPTION
9149
9150 use warnings::register, warnings::enabled(), warnings::enabled($category),
9151 warnings::enabled($object), warnings::warn($message),
9152 warnings::warn($category, $message), warnings::warn($object, $message),
9153 warnings::warnif($message), warnings::warnif($category, $message),
9154 warnings::warnif($object, $message)
9155
9156 =back
9157
9158 =head2 warnings::register - warnings import function
9159
9160 =over 4
9161
9162 =item SYNOPSIS
9163
9164 =item DESCRIPTION
9165
9166 =back
9167
9168 =head1 MODULE DOCUMENTATION
9169
9170 =head2 AnyDBM_File - provide framework for multiple DBMs
9171
9172 =over 4
9173
9174 =item SYNOPSIS
9175
9176 =item DESCRIPTION
9177
9178 =over 4
9179
9180 =item DBM Comparisons
9181
9182 [0], [1], [2], [3]
9183
9184 =back
9185
9186 =item SEE ALSO
9187
9188 =back
9189
9190 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9191
9192 =over 4
9193
9194 =item VERSION
9195
9196 =item SYNOPSIS
9197
9198 =item DESCRIPTION
9199
9200 [0], [1], [2], [3], [4], [5]
9201
9202 =over 4
9203
9204 =item Typed lexicals
9205
9206 =item Type-specific attribute handlers
9207
9208 =item Non-interpretive attribute handlers
9209
9210 =item Phase-specific attribute handlers
9211
9212 =item Attributes as C<tie> interfaces
9213
9214 =back
9215
9216 =item EXAMPLES
9217
9218 =item DIAGNOSTICS
9219
9220 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9221 attributes>, C<Declaration of %s attribute in package %s may clash with
9222 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9223 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9224 be able to apply END handler>
9225
9226 =item AUTHOR
9227
9228 =item BUGS
9229
9230 =item COPYRIGHT
9231
9232 =back
9233
9234 =head2 AutoLoader - load subroutines only on demand
9235
9236 =over 4
9237
9238 =item SYNOPSIS
9239
9240 =item DESCRIPTION
9241
9242 =over 4
9243
9244 =item Subroutine Stubs
9245
9246 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9247
9248 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9249
9250 =item Package Lexicals
9251
9252 =item Not Using AutoLoader
9253
9254 =item B<AutoLoader> vs. B<SelfLoader>
9255
9256 =back
9257
9258 =item CAVEATS
9259
9260 =item SEE ALSO
9261
9262 =back
9263
9264 =head2 AutoSplit - split a package for autoloading
9265
9266 =over 4
9267
9268 =item SYNOPSIS
9269
9270 =item DESCRIPTION
9271
9272 $keep, $check, $modtime
9273
9274 =over 4
9275
9276 =item Multiple packages
9277
9278 =back
9279
9280 =item DIAGNOSTICS
9281
9282 =back
9283
9284 =head2 B - The Perl Compiler
9285
9286 =over 4
9287
9288 =item SYNOPSIS
9289
9290 =item DESCRIPTION
9291
9292 =item OVERVIEW OF CLASSES
9293
9294 =over 4
9295
9296 =item SV-RELATED CLASSES
9297
9298 =item B::SV METHODS
9299
9300 REFCNT, FLAGS
9301
9302 =item B::IV METHODS
9303
9304 IV, IVX, UVX, int_value, needs64bits, packiv
9305
9306 =item B::NV METHODS
9307
9308 NV, NVX
9309
9310 =item B::RV METHODS
9311
9312 RV
9313
9314 =item B::PV METHODS
9315
9316 PV, RV, PVX
9317
9318 =item B::PVMG METHODS
9319
9320 MAGIC, SvSTASH
9321
9322 =item B::MAGIC METHODS
9323
9324 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9325
9326 =item B::PVLV METHODS
9327
9328 TARGOFF, TARGLEN, TYPE, TARG
9329
9330 =item B::BM METHODS
9331
9332 USEFUL, PREVIOUS, RARE, TABLE
9333
9334 =item B::GV METHODS
9335
9336 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9337 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9338
9339 =item B::IO METHODS
9340
9341 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9342 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9343
9344 =item B::AV METHODS
9345
9346 FILL, MAX, OFF, ARRAY, AvFLAGS
9347
9348 =item B::CV METHODS
9349
9350 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9351 CvFLAGS, const_sv
9352
9353 =item B::HV METHODS
9354
9355 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9356
9357 =item OP-RELATED CLASSES
9358
9359 =item B::OP METHODS
9360
9361 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9362
9363 =item B::UNOP METHOD
9364
9365 first
9366
9367 =item B::BINOP METHOD
9368
9369 last
9370
9371 =item B::LOGOP METHOD
9372
9373 other
9374
9375 =item B::LISTOP METHOD
9376
9377 children
9378
9379 =item B::PMOP METHODS
9380
9381 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9382 pmpermflags, precomp, pmoffet
9383
9384 =item B::SVOP METHOD
9385
9386 sv, gv
9387
9388 =item B::PADOP METHOD
9389
9390 padix
9391
9392 =item B::PVOP METHOD
9393
9394 pv
9395
9396 =item B::LOOP METHODS
9397
9398 redoop, nextop, lastop
9399
9400 =item B::COP METHODS
9401
9402 label, stash, file, cop_seq, arybase, line
9403
9404 =back
9405
9406 =item FUNCTIONS EXPORTED BY C<B>
9407
9408 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9409 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9410 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9411 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9412 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9413
9414 =item AUTHOR
9415
9416 =back
9417
9418 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9419 bytecode
9420
9421 =over 4
9422
9423 =item SYNOPSIS
9424
9425 =item DESCRIPTION
9426
9427 %insn_data, @insn_name, @optype, @specialsv_name
9428
9429 =item AUTHOR
9430
9431 =back
9432
9433 =head2 B::Assembler - Assemble Perl bytecode
9434
9435 =over 4
9436
9437 =item SYNOPSIS
9438
9439 =item DESCRIPTION
9440
9441 =item AUTHORS
9442
9443 =back
9444
9445 =head2 B::Bblock - Walk basic blocks
9446
9447 =over 4
9448
9449 =item SYNOPSIS
9450
9451 =item DESCRIPTION
9452
9453 =over 4
9454
9455 =item Functions
9456
9457 B<find_leaders>
9458
9459 =back
9460
9461 =item AUTHOR
9462
9463 =back
9464
9465 =head2 B::Bytecode - Perl compiler's bytecode backend
9466
9467 =over 4
9468
9469 =item SYNOPSIS
9470
9471 =item DESCRIPTION
9472
9473 =item OPTIONS
9474
9475 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9476 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9477 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9478
9479 =item EXAMPLES
9480
9481 =item BUGS
9482
9483 =item AUTHORS
9484
9485 =back
9486
9487 =head2 B::C - Perl compiler's C backend
9488
9489 =over 4
9490
9491 =item SYNOPSIS
9492
9493 =item DESCRIPTION
9494
9495 =item OPTIONS
9496
9497 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9498 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9499 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9500 B<-llimit>
9501
9502 =item EXAMPLES
9503
9504 =item BUGS
9505
9506 =item AUTHOR
9507
9508 =back
9509
9510 =head2 B::CC - Perl compiler's optimized C translation backend
9511
9512 =over 4
9513
9514 =item SYNOPSIS
9515
9516 =item DESCRIPTION
9517
9518 =item OPTIONS
9519
9520 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9521 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9522 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9523
9524 =item EXAMPLES
9525
9526 =item BUGS
9527
9528 =item DIFFERENCES
9529
9530 =over 4
9531
9532 =item Loops
9533
9534 =item Context of ".."
9535
9536 =item Arithmetic
9537
9538 =item Deprecated features
9539
9540 =back
9541
9542 =item AUTHOR
9543
9544 =back
9545
9546 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9547
9548 =over 4
9549
9550 =item SYNOPSIS
9551
9552 =item DESCRIPTION
9553
9554 =item EXAMPLE
9555
9556 =item OPTIONS
9557
9558 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9559 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9560 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9561
9562 =item FORMATTING SPECIFICATIONS
9563
9564 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9565 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9566 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9567 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9568 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9569 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9570 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9571 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9572
9573 =item ABBREVIATIONS
9574
9575 =over 4
9576
9577 =item OP flags abbreviations
9578
9579 =item OP class abbreviations
9580
9581 =back
9582
9583 =item Using B::Concise outside of the O framework
9584
9585 =item AUTHOR
9586
9587 =back
9588
9589 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9590
9591 =over 4
9592
9593 =item SYNOPSIS
9594
9595 =item DESCRIPTION
9596
9597 =item AUTHOR
9598
9599 =back
9600
9601 =head2 B::Deparse - Perl compiler backend to produce perl code
9602
9603 =over 4
9604
9605 =item SYNOPSIS
9606
9607 =item DESCRIPTION
9608
9609 =item OPTIONS
9610
9611 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9612 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9613
9614 =item USING B::Deparse AS A MODULE
9615
9616 =over 4
9617
9618 =item Synopsis
9619
9620 =item Description
9621
9622 =item new
9623
9624 =item ambient_pragmas
9625
9626 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9627
9628 =item coderef2text
9629
9630 =back
9631
9632 =item BUGS
9633
9634 =item AUTHOR
9635
9636 =back
9637
9638 =head2 B::Disassembler - Disassemble Perl bytecode
9639
9640 =over 4
9641
9642 =item SYNOPSIS
9643
9644 =item DESCRIPTION
9645
9646 =item AUTHOR
9647
9648 =back
9649
9650 =head2 B::Lint - Perl lint
9651
9652 =over 4
9653
9654 =item SYNOPSIS
9655
9656 =item DESCRIPTION
9657
9658 =item OPTIONS AND LINT CHECKS
9659
9660 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9661 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9662
9663 =item NON LINT-CHECK OPTIONS
9664
9665 B<-u Package>
9666
9667 =item BUGS
9668
9669 =item AUTHOR
9670
9671 =back
9672
9673 =head2 B::O, O - Generic interface to Perl Compiler backends
9674
9675 =over 4
9676
9677 =item SYNOPSIS
9678
9679 =item DESCRIPTION
9680
9681 =item CONVENTIONS
9682
9683 =item IMPLEMENTATION
9684
9685 =item BUGS
9686
9687 =item AUTHOR
9688
9689 =back
9690
9691 =head2 B::Showlex - Show lexical variables used in functions or files
9692
9693 =over 4
9694
9695 =item SYNOPSIS
9696
9697 =item DESCRIPTION
9698
9699 =item AUTHOR
9700
9701 =back
9702
9703 =head2 B::Stackobj - Helper module for CC backend
9704
9705 =over 4
9706
9707 =item SYNOPSIS
9708
9709 =item DESCRIPTION
9710
9711 =item AUTHOR
9712
9713 =back
9714
9715 =head2 B::Stash - show what stashes are loaded
9716
9717 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9718
9719 =over 4
9720
9721 =item SYNOPSIS
9722
9723 =item DESCRIPTION
9724
9725 =item AUTHOR
9726
9727 =back
9728
9729 =head2 B::Xref - Generates cross reference reports for Perl programs
9730
9731 =over 4
9732
9733 =item SYNOPSIS
9734
9735 =item DESCRIPTION
9736
9737 =item OPTIONS
9738
9739 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9740
9741 =item BUGS
9742
9743 =item AUTHOR
9744
9745 =back
9746
9747 =head2 Bblock, B::Bblock - Walk basic blocks
9748
9749 =over 4
9750
9751 =item SYNOPSIS
9752
9753 =item DESCRIPTION
9754
9755 =over 4
9756
9757 =item Functions
9758
9759 B<find_leaders>
9760
9761 =back
9762
9763 =item AUTHOR
9764
9765 =back
9766
9767 =head2 Benchmark - benchmark running times of Perl code
9768
9769 =over 4
9770
9771 =item SYNOPSIS
9772
9773 =item DESCRIPTION
9774
9775 =over 4
9776
9777 =item Methods
9778
9779 new, debug, iters
9780
9781 =item Standard Exports
9782
9783 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9784 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9785 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9786
9787 =item Optional Exports
9788
9789 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9790 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9791 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9792
9793 =back
9794
9795 =item NOTES
9796
9797 =item EXAMPLES
9798
9799 =item INHERITANCE
9800
9801 =item CAVEATS
9802
9803 =item SEE ALSO
9804
9805 =item AUTHORS
9806
9807 =item MODIFICATION HISTORY
9808
9809 =back
9810
9811 =head2 ByteLoader - load byte compiled perl code
9812
9813 =over 4
9814
9815 =item SYNOPSIS
9816
9817 =item DESCRIPTION
9818
9819 =item AUTHOR
9820
9821 =item SEE ALSO
9822
9823 =back
9824
9825 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9826
9827 =over 4
9828
9829 =item SYNOPSIS
9830
9831 =item DESCRIPTION
9832
9833 =item OPTIONS
9834
9835 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9836 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9837 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9838
9839 =item EXAMPLES
9840
9841 =item BUGS
9842
9843 =item AUTHORS
9844
9845 =back
9846
9847 =head2 CGI - Simple Common Gateway Interface Class
9848
9849 =over 4
9850
9851 =item SYNOPSIS
9852
9853 =item ABSTRACT
9854
9855 =item DESCRIPTION
9856
9857 =over 4
9858
9859 =item PROGRAMMING STYLE
9860
9861 =item CALLING CGI.PM ROUTINES
9862
9863 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9864
9865 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9866
9867 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9868
9869 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9870
9871 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9872
9873 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9874
9875 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9876
9877 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9878
9879 =item DELETING A PARAMETER COMPLETELY:
9880
9881 =item DELETING ALL PARAMETERS:
9882
9883 =item DIRECT ACCESS TO THE PARAMETER LIST:
9884
9885 =item FETCHING THE PARAMETER LIST AS A HASH:
9886
9887 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9888
9889 =item RETRIEVING CGI ERRORS
9890
9891 =item USING THE FUNCTION-ORIENTED INTERFACE
9892
9893 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9894 B<:standard>, B<:all>
9895
9896 =item PRAGMAS
9897
9898 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9899 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9900 -private_tempfiles
9901
9902 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9903
9904 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9905 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9906 a </ul> tag)
9907
9908 =back
9909
9910 =item GENERATING DYNAMIC DOCUMENTS
9911
9912 =over 4
9913
9914 =item CREATING A STANDARD HTTP HEADER:
9915
9916 =item GENERATING A REDIRECTION HEADER
9917
9918 =item CREATING THE HTML DOCUMENT HEADER
9919
9920 B<Parameters:>, 4, 5, 6..
9921
9922 =item ENDING THE HTML DOCUMENT:
9923
9924 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9925
9926 =item OBTAINING THE SCRIPT'S URL
9927
9928 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9929 (B<-query_string>), B<-base>
9930
9931 =item MIXING POST AND URL PARAMETERS
9932
9933 =back
9934
9935 =item CREATING STANDARD HTML ELEMENTS:
9936
9937 =over 4
9938
9939 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9940
9941 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9942
9943 =item HTML SHORTCUTS AND LIST INTERPOLATION
9944
9945 =item NON-STANDARD HTML SHORTCUTS
9946
9947 =item AUTOESCAPING HTML
9948
9949 $escaped_string = escapeHTML("unescaped string");, $charset =
9950 charset([$charset]);, $flag = autoEscape([$flag]);
9951
9952 =item PRETTY-PRINTING HTML
9953
9954 =back
9955
9956 =item CREATING FILL-OUT FORMS:
9957
9958 =over 4
9959
9960 =item CREATING AN ISINDEX TAG
9961
9962 =item STARTING AND ENDING A FORM
9963
9964 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9965
9966 =item CREATING A TEXT FIELD
9967
9968 B<Parameters>
9969
9970 =item CREATING A BIG TEXT FIELD
9971
9972 =item CREATING A PASSWORD FIELD
9973
9974 =item CREATING A FILE UPLOAD FIELD
9975
9976 B<Parameters>
9977
9978 =item CREATING A POPUP MENU
9979
9980 =item CREATING A SCROLLING LIST
9981
9982 B<Parameters:>
9983
9984 =item CREATING A GROUP OF RELATED CHECKBOXES
9985
9986 B<Parameters:>
9987
9988 =item CREATING A STANDALONE CHECKBOX
9989
9990 B<Parameters:>
9991
9992 =item CREATING A RADIO BUTTON GROUP
9993
9994 B<Parameters:>
9995
9996 =item CREATING A SUBMIT BUTTON
9997
9998 B<Parameters:>
9999
10000 =item CREATING A RESET BUTTON
10001
10002 =item CREATING A DEFAULT BUTTON
10003
10004 =item CREATING A HIDDEN FIELD
10005
10006 B<Parameters:>
10007
10008 =item CREATING A CLICKABLE IMAGE BUTTON
10009
10010 B<Parameters:>
10011
10012 =item CREATING A JAVASCRIPT ACTION BUTTON
10013
10014 =back
10015
10016 =item HTTP COOKIES
10017
10018 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10019 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10020
10021 =item WORKING WITH FRAMES
10022
10023 1. Create a <Frameset> document, 2. Specify the destination for the
10024 document in the HTTP header, 3. Specify the destination for the document in
10025 the <form> tag
10026
10027 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10028
10029 =item DEBUGGING
10030
10031 =over 4
10032
10033 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10034
10035 =back
10036
10037 =item FETCHING ENVIRONMENT VARIABLES
10038
10039 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10040 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10041 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10042 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10043 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10044
10045 =item USING NPH SCRIPTS
10046
10047 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10048 parameters
10049
10050 =item Server Push
10051
10052 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10053
10054 =item Avoiding Denial of Service Attacks
10055
10056 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10057 basis>, B<2. Globally for all scripts>
10058
10059 =item COMPATIBILITY WITH CGI-LIB.PL
10060
10061 =item AUTHOR INFORMATION
10062
10063 =item CREDITS
10064
10065 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10066 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10067 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10068 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10069 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10070 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10071 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10072 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10073 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10074 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10075 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10076 ...and many many more..
10077
10078 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10079
10080 =item BUGS
10081
10082 =item SEE ALSO
10083
10084 =back
10085
10086 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10087
10088 =over 4
10089
10090 =item SYNOPSIS
10091
10092 =item ABSTRACT
10093
10094 =item DESCRIPTION
10095
10096 =item AUTHOR INFORMATION
10097
10098 =item BUGS
10099
10100 =item SEE ALSO
10101
10102 =back
10103
10104 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10105 other) error log
10106
10107 =over 4
10108
10109 =item SYNOPSIS
10110
10111 =item DESCRIPTION
10112
10113 =item REDIRECTING ERROR MESSAGES
10114
10115 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10116
10117 =over 4
10118
10119 =item Changing the default message
10120
10121 =back
10122
10123 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10124
10125 =item CHANGE LOG
10126
10127 =item AUTHORS
10128
10129 =item SEE ALSO
10130
10131 =back
10132
10133 =head2 CGI::Cookie - Interface to Netscape Cookies
10134
10135 =over 4
10136
10137 =item SYNOPSIS
10138
10139 =item DESCRIPTION
10140
10141 =item USING CGI::Cookie
10142
10143 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10144
10145 =over 4
10146
10147 =item Creating New Cookies
10148
10149 =item Sending the Cookie to the Browser
10150
10151 =item Recovering Previous Cookies
10152
10153 =item Manipulating Cookies
10154
10155 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10156
10157 =back
10158
10159 =item AUTHOR INFORMATION
10160
10161 =item BUGS
10162
10163 =item SEE ALSO
10164
10165 =back
10166
10167 =head2 CGI::Fast - CGI Interface for Fast CGI
10168
10169 =over 4
10170
10171 =item SYNOPSIS
10172
10173 =item DESCRIPTION
10174
10175 =item OTHER PIECES OF THE PUZZLE
10176
10177 =item WRITING FASTCGI PERL SCRIPTS
10178
10179 =item INSTALLING FASTCGI SCRIPTS
10180
10181 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10182
10183 =item EXTERNAL FASTCGI SERVER INVOCATION
10184
10185 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10186
10187 =item CAVEATS
10188
10189 =item AUTHOR INFORMATION
10190
10191 =item BUGS
10192
10193 =item SEE ALSO
10194
10195 =back
10196
10197 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10198
10199 =over 4
10200
10201 =item SYNOPSIS
10202
10203 =item DESCRIPTION
10204
10205 =over 4
10206
10207 =item Tags that won't be formatted
10208
10209 =item Customizing the Indenting
10210
10211 =back
10212
10213 =item BUGS
10214
10215 =item AUTHOR
10216
10217 =item SEE ALSO
10218
10219 =back
10220
10221 =head2 CGI::Push - Simple Interface to Server Push
10222
10223 =over 4
10224
10225 =item SYNOPSIS
10226
10227 =item DESCRIPTION
10228
10229 =item USING CGI::Push
10230
10231 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10232
10233 =over 4
10234
10235 =item Heterogeneous Pages
10236
10237 =item Changing the Page Delay on the Fly
10238
10239 =back
10240
10241 =item INSTALLING CGI::Push SCRIPTS
10242
10243 =item AUTHOR INFORMATION
10244
10245 =item BUGS
10246
10247 =item SEE ALSO
10248
10249 =back
10250
10251 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10252
10253 =over 4
10254
10255 =item SYNOPSIS
10256
10257 =item ABSTRACT
10258
10259 =item DESCRIPTION
10260
10261 =item AUTHOR INFORMATION
10262
10263 =item BUGS
10264
10265 =item SEE ALSO
10266
10267 =back
10268
10269 =head2 CGI::Util - Internal utilities used by CGI module
10270
10271 =over 4
10272
10273 =item SYNOPSIS
10274
10275 =item DESCRIPTION
10276
10277 =item AUTHOR INFORMATION
10278
10279 =item SEE ALSO
10280
10281 =back
10282
10283 =head2 CPAN - query, download and build perl modules from CPAN sites
10284
10285 =over 4
10286
10287 =item SYNOPSIS
10288
10289 =item DESCRIPTION
10290
10291 =over 4
10292
10293 =item Interactive Mode
10294
10295 Searching for authors, bundles, distribution files and modules, make, test,
10296 install, clean  modules or distributions, get, readme, look module or
10297 distribution, ls author, Signals
10298
10299 =item CPAN::Shell
10300
10301 =item autobundle
10302
10303 =item recompile
10304
10305 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10306
10307 =item Programmer's interface
10308
10309 expand($type,@things), expandany(@things), Programming Examples
10310
10311 =item Methods in the other Classes
10312
10313 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10314 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10315 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10316 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10317 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10318 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10319 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10320 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10321 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10322 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10323 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10324 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10325 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10326 CPAN::Distribution::look(), CPAN::Distribution::make(),
10327 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10328 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10329 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10330 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10331 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10332 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10333 CPAN::Module::description(), CPAN::Module::force($method,@args),
10334 CPAN::Module::get(), CPAN::Module::inst_file(),
10335 CPAN::Module::inst_version(), CPAN::Module::install(),
10336 CPAN::Module::look(), CPAN::Module::make(),
10337 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10338 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10339
10340 =item Cache Manager
10341
10342 =item Bundles
10343
10344 =item Prerequisites
10345
10346 =item Finding packages and VERSION
10347
10348 =item Debugging
10349
10350 =item Floppy, Zip, Offline Mode
10351
10352 =back
10353
10354 =item CONFIGURATION
10355
10356 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10357 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10358 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10359 [unshift|push|splice] E<lt>listE<gt>>
10360
10361 =over 4
10362
10363 =item Note on urllist parameter's format
10364
10365 =item urllist parameter has CD-ROM support
10366
10367 =back
10368
10369 =item SECURITY
10370
10371 =item EXPORT
10372
10373 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10374
10375 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10376
10377 =over 4
10378
10379 =item Three basic types of firewalls
10380
10381 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10382
10383 =item Configuring lynx or ncftp for going through a firewall
10384
10385 =back
10386
10387 =item FAQ
10388
10389 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10390
10391 =item BUGS
10392
10393 =item AUTHOR
10394
10395 =item TRANSLATIONS
10396
10397 =item SEE ALSO
10398
10399 =back
10400
10401 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10402
10403 =over 4
10404
10405 =item SYNOPSIS
10406
10407 =item DESCRIPTION
10408
10409 =back
10410
10411 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10412 module
10413
10414 =over 4
10415
10416 =item SYNOPSIS
10417
10418 =item DESCRIPTION
10419
10420 =item  SEE ALSO
10421
10422 =back
10423
10424 =head2 Carp, carp    - warn of errors (from perspective of caller)
10425
10426 =over 4
10427
10428 =item SYNOPSIS
10429
10430 =item DESCRIPTION
10431
10432 =over 4
10433
10434 =item Forcing a Stack Trace
10435
10436 =back
10437
10438 =item BUGS
10439
10440 =back
10441
10442 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10443
10444 =head2 Class::ISA -- report the search path for a class's ISA tree
10445
10446 =over 4
10447
10448 =item SYNOPSIS
10449
10450 =item DESCRIPTION
10451
10452 =item FUNCTIONS
10453
10454 the function Class::ISA::super_path($CLASS), the function
10455 Class::ISA::self_and_super_path($CLASS), the function
10456 Class::ISA::self_and_super_versions($CLASS)
10457
10458 =item CAUTIONARY NOTES
10459
10460 =item COPYRIGHT
10461
10462 =item AUTHOR
10463
10464 =back
10465
10466 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10467
10468 =over 4
10469
10470 =item SYNOPSIS
10471
10472 =item DESCRIPTION
10473
10474 =over 4
10475
10476 =item The C<struct()> function
10477
10478 =item Class Creation at Compile Time
10479
10480 =item Element Types and Accessor Methods
10481
10482 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10483 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10484
10485 =item Initializing with C<new>
10486
10487 =back
10488
10489 =item EXAMPLES
10490
10491 Example 1, Example 2, Example 3
10492
10493 =item Author and Modification History
10494
10495 =back
10496
10497 =head2 Config - access Perl configuration information
10498
10499 =over 4
10500
10501 =item SYNOPSIS
10502
10503 =item DESCRIPTION
10504
10505 myconfig(), config_sh(), config_vars(@names)
10506
10507 =item EXAMPLE
10508
10509 =item WARNING
10510
10511 =item GLOSSARY
10512
10513 =over 4
10514
10515 =item _
10516
10517 C<_a>, C<_exe>, C<_o>
10518
10519 =item a
10520
10521 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10522 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10523 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10524 C<asctime_r_proto>, C<awk>
10525
10526 =item b
10527
10528 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10529
10530 =item c
10531
10532 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10533 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10534 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10535 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10536 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10537 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10538 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10539
10540 =item d
10541
10542 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10543 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10544 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10545 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10546 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10547 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10548 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10549 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10550 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10551 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10552 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10553 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10554 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10555 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10556 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10557 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10558 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10559 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10560 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10561 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10562 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10563 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10564 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10565 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10566 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10567 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10568 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10569 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10570 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10571 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10572 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10573 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10574 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10575 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10576 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10577 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10578 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10579 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10580 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10581 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10582 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10583 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10584 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10585 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10586 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10587 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10588 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10589 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10590 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10591 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10592 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10593 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10594 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10595 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10596 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10597 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10598 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10599 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10600 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10601 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10602 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10603 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10604 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10605 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10606 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10607 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10608 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10609 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10610 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10611 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10612 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10613 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10614 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10615 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10616 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10617 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10618 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10619 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10620 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10621 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10622 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10623 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10624 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10625 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10626 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10627 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10628 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10629 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10630 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10631 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10632
10633 =item e
10634
10635 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10636 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10637 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10638 C<expr>, C<extensions>, C<extras>
10639
10640 =item f
10641
10642 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10643 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10644 C<full_sed>
10645
10646 =item g
10647
10648 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10649 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10650 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10651 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10652 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10653 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10654 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10655 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10656 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10657 C<gzip>
10658
10659 =item h
10660
10661 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10662
10663 =item i
10664
10665 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10666 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10667 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10668 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10669 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10670 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10671 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10672 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10673 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10674 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10675 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10676 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10677 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10678 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10679 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10680 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10681 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10682 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10683 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10684 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10685 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10686 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10687 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10688 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10689
10690 =item k
10691
10692 C<known_extensions>, C<ksh>
10693
10694 =item l
10695
10696 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10697 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10698 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10699 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10700 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10701 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10702 C<lseektype>
10703
10704 =item m
10705
10706 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10707 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10708 C<man3direxp>, C<man3ext>
10709
10710 =item M
10711
10712 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10713 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10714
10715 =item n
10716
10717 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10718 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10719 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10720 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10721 C<nvsize>, C<nvtype>
10722
10723 =item o
10724
10725 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10726 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10727
10728 =item p
10729
10730 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10731 C<perl5>, C<perl>, C<perl_patchlevel>
10732
10733 =item P
10734
10735 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10736 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10737 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10738 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10739
10740 =item q
10741
10742 C<quadkind>, C<quadtype>
10743
10744 =item r
10745
10746 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10747 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10748 C<rmail>, C<run>, C<runnm>
10749
10750 =item s
10751
10752 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10753 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10754 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10755 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10756 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10757 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10758 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10759 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10760 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10761 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10762 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10763 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10764 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10765 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10766 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10767 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10768 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10769
10770 =item t
10771
10772 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10773 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10774 C<ttyname_r_proto>
10775
10776 =item u
10777
10778 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10779 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10780 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10781 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10782 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10783 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10784 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10785 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10786 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10787
10788 =item v
10789
10790 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10791 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10792 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10793 C<versiononly>, C<vi>, C<voidflags>
10794
10795 =item x
10796
10797 C<xlibpth>, C<xs_apiversion>
10798
10799 =item y
10800
10801 C<yaccflags>
10802
10803 =item z
10804
10805 C<zcat>, C<zip>
10806
10807 =back
10808
10809 =item NOTE
10810
10811 =back
10812
10813 =head2 Cwd - get pathname of current working directory
10814
10815 =over 4
10816
10817 =item SYNOPSIS
10818
10819 =item DESCRIPTION
10820
10821 =over 4
10822
10823 =item getcwd and friends
10824
10825 getcwd, cwd, fastcwd, fastgetcwd
10826
10827 =item abs_path and friends
10828
10829 abs_path, realpath, fast_abs_path
10830
10831 =item $ENV{PWD}
10832
10833 =back
10834
10835 =item NOTES
10836
10837 =item SEE ALSO
10838
10839 =back
10840
10841 =head2 DB - programmatic interface to the Perl debugging API (draft,
10842 subject to
10843 change)
10844
10845 =over 4
10846
10847 =item SYNOPSIS
10848
10849 =item DESCRIPTION
10850
10851 =over 4
10852
10853 =item Global Variables
10854
10855  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
10856 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
10857 $DB::lineno
10858
10859 =item API Methods
10860
10861 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10862 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10863
10864 =item Client Callback Methods
10865
10866 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10867 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10868 CLIENT->output(LIST)
10869
10870 =back
10871
10872 =item BUGS
10873
10874 =item AUTHOR
10875
10876 =back
10877
10878 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10879
10880 =over 4
10881
10882 =item SYNOPSIS
10883
10884 =item DESCRIPTION
10885
10886 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10887
10888 =over 4
10889
10890 =item Using DB_File with Berkeley DB version 2 or greater
10891
10892 =item Interface to Berkeley DB
10893
10894 =item Opening a Berkeley DB Database File
10895
10896 =item Default Parameters
10897
10898 =item In Memory Databases
10899
10900 =back
10901
10902 =item DB_HASH
10903
10904 =over 4
10905
10906 =item A Simple Example
10907
10908 =back
10909
10910 =item DB_BTREE
10911
10912 =over 4
10913
10914 =item Changing the BTREE sort order
10915
10916 =item Handling Duplicate Keys
10917
10918 =item The get_dup() Method
10919
10920 =item The find_dup() Method
10921
10922 =item The del_dup() Method
10923
10924 =item Matching Partial Keys
10925
10926 =back
10927
10928 =item DB_RECNO
10929
10930 =over 4
10931
10932 =item The 'bval' Option
10933
10934 =item A Simple Example
10935
10936 =item Extra RECNO Methods
10937
10938 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10939 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10940 length, elements);>
10941
10942 =item Another Example
10943
10944 =back
10945
10946 =item THE API INTERFACE
10947
10948 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10949 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10950 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10951 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10952
10953 =item DBM FILTERS
10954
10955 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10956 B<filter_fetch_value>
10957
10958 =over 4
10959
10960 =item The Filter
10961
10962 =item An Example -- the NULL termination problem.
10963
10964 =item Another Example -- Key is a C int.
10965
10966 =back
10967
10968 =item HINTS AND TIPS
10969
10970 =over 4
10971
10972 =item Locking: The Trouble with fd
10973
10974 =item Safe ways to lock a database
10975
10976 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10977
10978 =item Sharing Databases With C Applications
10979
10980 =item The untie() Gotcha
10981
10982 =back
10983
10984 =item COMMON QUESTIONS
10985
10986 =over 4
10987
10988 =item Why is there Perl source in my database?
10989
10990 =item How do I store complex data structures with DB_File?
10991
10992 =item What does "Invalid Argument" mean?
10993
10994 =item What does "Bareword 'DB_File' not allowed" mean?
10995
10996 =back
10997
10998 =item REFERENCES
10999
11000 =item HISTORY
11001
11002 =item BUGS
11003
11004 =item AVAILABILITY
11005
11006 =item COPYRIGHT
11007
11008 =item SEE ALSO
11009
11010 =item AUTHOR
11011
11012 =back
11013
11014 =head2 Data::Dumper - stringified perl data structures, suitable for both
11015 printing and C<eval>
11016
11017 =over 4
11018
11019 =item SYNOPSIS
11020
11021 =item DESCRIPTION
11022
11023 =over 4
11024
11025 =item Methods
11026
11027 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11028 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11029 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11030 I<$OBJ>->Reset
11031
11032 =item Functions
11033
11034 Dumper(I<LIST>)
11035
11036 =item Configuration Variables or Methods
11037
11038 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11039 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11040 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11041 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11042 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11043 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11044 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11045 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11046 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11047 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11048 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11049 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11050 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11051 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11052 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11053
11054 =item Exports
11055
11056 Dumper
11057
11058 =back
11059
11060 =item EXAMPLES
11061
11062 =item BUGS
11063
11064 =item AUTHOR
11065
11066 =item VERSION
11067
11068 =item SEE ALSO
11069
11070 =back
11071
11072 =head2 Devel::DProf - a Perl code profiler
11073
11074 =over 4
11075
11076 =item SYNOPSIS
11077
11078 =item DESCRIPTION
11079
11080 =item PROFILE FORMAT
11081
11082 =item AUTOLOAD
11083
11084 =item ENVIRONMENT
11085
11086 =item BUGS
11087
11088 =item SEE ALSO
11089
11090 =back
11091
11092 =head2 Devel::PPPort, Perl/Pollution/Portability
11093
11094 =over 4
11095
11096 =item SYNOPSIS
11097
11098 =item DESCRIPTION
11099
11100 =over 4
11101
11102 =item WriteFile
11103
11104 =back
11105
11106 =item ppport.h
11107
11108 =item AUTHOR
11109
11110 =item SEE ALSO
11111
11112 =back
11113
11114 =head2 Devel::Peek - A data debugging tool for the XS programmer
11115
11116 =over 4
11117
11118 =item SYNOPSIS
11119
11120 =item DESCRIPTION
11121
11122 =over 4
11123
11124 =item Runtime debugging
11125
11126 =item Memory footprint debugging
11127
11128 =back
11129
11130 =item EXAMPLES
11131
11132 =over 4
11133
11134 =item A simple scalar string
11135
11136 =item A simple scalar number
11137
11138 =item A simple scalar with an extra reference
11139
11140 =item A reference to a simple scalar
11141
11142 =item A reference to an array
11143
11144 =item A reference to a hash
11145
11146 =item Dumping a large array or hash
11147
11148 =item A reference to an SV which holds a C pointer
11149
11150 =item A reference to a subroutine
11151
11152 =back
11153
11154 =item EXPORTS
11155
11156 =item BUGS
11157
11158 =item AUTHOR
11159
11160 =item SEE ALSO
11161
11162 =back
11163
11164 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11165
11166 =over 4
11167
11168 =item SYNOPSIS
11169
11170 =item DESCRIPTION
11171
11172 =back
11173
11174 =head2 Digest:: - Modules that calculate message digests
11175
11176 =over 4
11177
11178 =item SYNOPSIS
11179
11180 =item DESCRIPTION
11181
11182 I<binary>, I<hex>, I<base64>
11183
11184 =item OO INTERFACE
11185
11186 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11187 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11188 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11189
11190 =item SEE ALSO
11191
11192 =item AUTHOR
11193
11194 =back
11195
11196 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11197
11198 =over 4
11199
11200 =item SYNOPSIS
11201
11202 =item DESCRIPTION
11203
11204 =item FUNCTIONS
11205
11206 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11207
11208 =item METHODS
11209
11210 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11211 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11212
11213 =item EXAMPLES
11214
11215 =item SEE ALSO
11216
11217 =item COPYRIGHT
11218
11219 =item AUTHORS
11220
11221 =back
11222
11223 =head2 DirHandle - supply object methods for directory handles
11224
11225 =over 4
11226
11227 =item SYNOPSIS
11228
11229 =item DESCRIPTION
11230
11231 =item NOTES
11232
11233 =back
11234
11235 =head2 Dumpvalue - provides screen dump of Perl data.
11236
11237 =over 4
11238
11239 =item SYNOPSIS
11240
11241 =item DESCRIPTION
11242
11243 =over 4
11244
11245 =item Creation
11246
11247 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11248 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11249 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11250 stopDbSignal
11251
11252 =item Methods
11253
11254 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11255 compactDump, veryCompact, set, get
11256
11257 =back
11258
11259 =back
11260
11261 =head2 DynaLoader - Dynamically load C libraries into Perl code
11262
11263 =over 4
11264
11265 =item SYNOPSIS
11266
11267 =item DESCRIPTION
11268
11269 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11270 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11271 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11272 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11273 bootstrap()
11274
11275 =item AUTHOR
11276
11277 =back
11278
11279 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11280 Perl code
11281
11282 =over 4
11283
11284 =item SYNOPSIS
11285
11286 =item DESCRIPTION
11287
11288 =item AUTHOR
11289
11290 =back
11291
11292 =head2 Encode - character encodings
11293
11294 =over 4
11295
11296 =item SYNOPSIS
11297
11298 =over 4
11299
11300 =item Table of Contents
11301
11302 =back
11303
11304 =item DESCRIPTION
11305
11306 =over 4
11307
11308 =item TERMINOLOGY
11309
11310 =back
11311
11312 =item PERL ENCODING API
11313
11314 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11315 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11316 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11317 CHECK]);
11318
11319 =over 4
11320
11321 =item Listing available encodings
11322
11323 =item Defining Aliases
11324
11325 =back
11326
11327 =item Encoding via PerlIO
11328
11329 =item Handling Malformed Data
11330
11331 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11332 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11333 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11334 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11335 bitmask
11336
11337 =over 4
11338
11339 =item Unimplemented fallback schemes
11340
11341 =back
11342
11343 =item Defining Encodings
11344
11345 =item The UTF-8 flag
11346
11347 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11348
11349 =over 4
11350
11351 =item Messing with Perl's Internals
11352
11353 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11354
11355 =back
11356
11357 =item SEE ALSO
11358
11359 =item MAINTAINER
11360
11361 =back
11362
11363 =head2 Encode::Alias - alias definitions to encodings
11364
11365 =over 4
11366
11367 =item SYNOPSIS
11368
11369 =item DESCRIPTION
11370
11371 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11372 reference, e.g.:
11373
11374 =over 4
11375
11376 =item Alias overloading
11377
11378 =back
11379
11380 =item SEE ALSO
11381
11382 =back
11383
11384 =head2 Encode::Byte - Single Byte Encodings
11385
11386 =over 4
11387
11388 =item SYNOPSIS
11389
11390 =item ABSTRACT
11391
11392 =item DESCRIPTION
11393
11394 =item SEE ALSO
11395
11396 =back
11397
11398 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11399
11400 =head2 Encode::CN - China-based Chinese Encodings
11401
11402 =over 4
11403
11404 =item SYNOPSIS
11405
11406 =item DESCRIPTION
11407
11408 =item NOTES
11409
11410 =item BUGS
11411
11412 =item SEE ALSO
11413
11414 =back
11415
11416 =head2 Encode::CN::HZ -- internally used by Encode::CN
11417
11418 =head2 Encode::Config -- internally used by Encode
11419
11420 =head2 Encode::EBCDIC - EBCDIC Encodings
11421
11422 =over 4
11423
11424 =item SYNOPSIS
11425
11426 =item ABSTRACT
11427
11428 =item DESCRIPTION
11429
11430 =item SEE ALSO
11431
11432 =back
11433
11434 =head2 Encode::Encoding - Encode Implementation Base Class
11435
11436 =over 4
11437
11438 =item SYNOPSIS
11439
11440 =item DESCRIPTION
11441
11442 =over 4
11443
11444 =item Methods you should implement
11445
11446 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11447
11448 =item Other methods defined in Encode::Encodings
11449
11450 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11451
11452 =item Example: Encode::ROT13
11453
11454 =back
11455
11456 =item Why the heck Encode API is different?
11457
11458 =over 4
11459
11460 =item Compiled Encodings
11461
11462 =back
11463
11464 =item SEE ALSO
11465
11466 Scheme 1, Scheme 2, Other Schemes
11467
11468 =back
11469
11470 =head2 Encode::Guess -- Guesses encoding from data
11471
11472 =over 4
11473
11474 =item SYNOPSIS
11475
11476 =item ABSTRACT
11477
11478 =item DESCRIPTION
11479
11480 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11481 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11482 guess_encoding($data, [, I<list of suspects>])
11483
11484 =item CAVEATS
11485
11486 =item TO DO
11487
11488 =item SEE ALSO
11489
11490 =back
11491
11492 =head2 Encode::JP - Japanese Encodings
11493
11494 =over 4
11495
11496 =item SYNOPSIS
11497
11498 =item ABSTRACT
11499
11500 =item DESCRIPTION
11501
11502 =item Note on ISO-2022-JP(-1)?
11503
11504 =item BUGS
11505
11506 =item SEE ALSO
11507
11508 =back
11509
11510 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11511
11512 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11513
11514 =head2 Encode::KR - Korean Encodings
11515
11516 =over 4
11517
11518 =item SYNOPSIS
11519
11520 =item DESCRIPTION
11521
11522 =item BUGS
11523
11524 =item SEE ALSO
11525
11526 =back
11527
11528 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11529
11530 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11531
11532 =over 4
11533
11534 =item SYNOPSIS
11535
11536 =item ABSTRACT
11537
11538 =item DESCRIPTION
11539
11540 =item BUGS
11541
11542 =item SEE ALSO
11543
11544 =back
11545
11546 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11547
11548 =over 4
11549
11550 =item Overview
11551
11552 =item How does it work?
11553
11554 =item BUGS
11555
11556 =over 4
11557
11558 =item Workaround
11559
11560 =item How can I tell whether my encoding fully supports PerlIO ?
11561
11562 =back
11563
11564 =item SEE ALSO
11565
11566 =back
11567
11568 =head2 Encode::Supported -- Encodings supported by Encode
11569
11570 =over 4
11571
11572 =item DESCRIPTION
11573
11574 =over 4
11575
11576 =item Encoding Names
11577
11578 =back
11579
11580 =item Supported Encodings
11581
11582 =over 4
11583
11584 =item Built-in Encodings
11585
11586 =item Encode::Unicode -- other Unicode encodings
11587
11588 =item Encode::Byte -- Extended ASCII
11589
11590 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11591 the Cyrillic world, gsm0338 - Hentai Latin 1
11592
11593 =item CJK: Chinese, Japanese, Korean (Multibyte)
11594
11595 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11596 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11597 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11598
11599 =item Miscellaneous encodings
11600
11601 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11602
11603 =back
11604
11605 =item Unsupported encodings
11606
11607   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11608 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11609 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11610 Various Mac encodings, (Mac) Indic encodings
11611
11612 =item Encoding vs. Charset -- terminology
11613
11614 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11615
11616 =over 4
11617
11618 =item Microsoft-related naming mess
11619
11620 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11621
11622 =back
11623
11624 =item Glossary
11625
11626 character repertoire, coded character set (CCS), character encoding scheme
11627 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11628 UTF-16
11629
11630 =item See Also
11631
11632 =item References
11633
11634 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11635 RFC, UC, Unicode Glossary
11636
11637 =over 4
11638
11639 =item Other Notable Sites
11640
11641 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11642 "Introduction to i18n"
11643
11644 =item Offline sources
11645
11646 C<CJKV Information Processing> by Ken Lunde
11647
11648 =back
11649
11650 =back
11651
11652 =head2 Encode::Symbol - Symbol Encodings
11653
11654 =over 4
11655
11656 =item SYNOPSIS
11657
11658 =item ABSTRACT
11659
11660 =item DESCRIPTION
11661
11662 =item SEE ALSO
11663
11664 =back
11665
11666 =head2 Encode::TW - Taiwan-based Chinese Encodings
11667
11668 =over 4
11669
11670 =item SYNOPSIS
11671
11672 =item DESCRIPTION
11673
11674 =item NOTES
11675
11676 =item BUGS
11677
11678 =item SEE ALSO
11679
11680 =back
11681
11682 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11683
11684 =over 4
11685
11686 =item SYNOPSIS
11687
11688 =item ABSTRACT
11689
11690 L<http://www.unicode.org/glossary/> says:, Quick Reference
11691
11692 =item Size, Endianness, and BOM
11693
11694 =over 4
11695
11696 =item by size
11697
11698 =item by endianness
11699
11700 BOM as integer when fetched in network byte order
11701
11702 =back
11703
11704 =item Surrogate Pairs
11705
11706 =item SEE ALSO
11707
11708 =back
11709
11710 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11711 encodings
11712
11713 =over 4
11714
11715 =item SYNOPSIS
11716
11717 =item DESCRIPTION
11718
11719 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11720 reference, e.g.:
11721
11722 =over 4
11723
11724 =item Alias overloading
11725
11726 =back
11727
11728 =item SEE ALSO
11729
11730 =back
11731
11732 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11733 Internally used by Encode::??::ISO_2022_*
11734
11735 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11736 Encode::CN
11737
11738 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11739 Encode
11740
11741 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11742 Implementation Base Class
11743
11744 =over 4
11745
11746 =item SYNOPSIS
11747
11748 =item DESCRIPTION
11749
11750 =over 4
11751
11752 =item Methods you should implement
11753
11754 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11755
11756 =item Other methods defined in Encode::Encodings
11757
11758 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11759
11760 =item Example: Encode::ROT13
11761
11762 =back
11763
11764 =item Why the heck Encode API is different?
11765
11766 =over 4
11767
11768 =item Compiled Encodings
11769
11770 =back
11771
11772 =item SEE ALSO
11773
11774 Scheme 1, Scheme 2, Other Schemes
11775
11776 =back
11777
11778 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11779 data
11780
11781 =over 4
11782
11783 =item SYNOPSIS
11784
11785 =item ABSTRACT
11786
11787 =item DESCRIPTION
11788
11789 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11790 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11791 guess_encoding($data, [, I<list of suspects>])
11792
11793 =item CAVEATS
11794
11795 =item TO DO
11796
11797 =item SEE ALSO
11798
11799 =back
11800
11801 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11802 Encode::JP::2022_JP*
11803
11804 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11805 by Encode::JP
11806
11807 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11808 used by Encode::KR
11809
11810 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11811 and 'Q' header encoding
11812
11813 =over 4
11814
11815 =item SYNOPSIS
11816
11817 =item ABSTRACT
11818
11819 =item DESCRIPTION
11820
11821 =item BUGS
11822
11823 =item SEE ALSO
11824
11825 =back
11826
11827 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11828 on Encode and PerlIO
11829
11830 =over 4
11831
11832 =item Overview
11833
11834 =item How does it work?
11835
11836 =item BUGS
11837
11838 =over 4
11839
11840 =item Workaround
11841
11842 =item How can I tell whether my encoding fully supports PerlIO ?
11843
11844 =back
11845
11846 =item SEE ALSO
11847
11848 =back
11849
11850 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11851 supported by Encode
11852
11853 =over 4
11854
11855 =item DESCRIPTION
11856
11857 =over 4
11858
11859 =item Encoding Names
11860
11861 =back
11862
11863 =item Supported Encodings
11864
11865 =over 4
11866
11867 =item Built-in Encodings
11868
11869 =item Encode::Unicode -- other Unicode encodings
11870
11871 =item Encode::Byte -- Extended ASCII
11872
11873 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11874 the Cyrillic world, gsm0338 - Hentai Latin 1
11875
11876 =item CJK: Chinese, Japanese, Korean (Multibyte)
11877
11878 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11879 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11880 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11881
11882 =item Miscellaneous encodings
11883
11884 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11885
11886 =back
11887
11888 =item Unsupported encodings
11889
11890   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11891 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11892 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11893 Various Mac encodings, (Mac) Indic encodings
11894
11895 =item Encoding vs. Charset -- terminology
11896
11897 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11898
11899 =over 4
11900
11901 =item Microsoft-related naming mess
11902
11903 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11904
11905 =back
11906
11907 =item Glossary
11908
11909 character repertoire, coded character set (CCS), character encoding scheme
11910 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11911 UTF-16
11912
11913 =item See Also
11914
11915 =item References
11916
11917 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11918 RFC, UC, Unicode Glossary
11919
11920 =over 4
11921
11922 =item Other Notable Sites
11923
11924 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11925 "Introduction to i18n"
11926
11927 =item Offline sources
11928
11929 C<CJKV Information Processing> by Ken Lunde
11930
11931 =back
11932
11933 =back
11934
11935 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11936
11937 =over 4
11938
11939 =item SYNOPSIS
11940
11941   use Encode::Encoder;
11942   # Encode::encode("ISO-8859-1", $data);
11943   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11944   # shortcut
11945   use Encode::Encoder qw(encoder);
11946   encoder($data)->iso_8859_1;
11947   # you can stack them!
11948   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11949   # you can use it as a decoder as well
11950   encoder($base64)->bytes('base64')->latin1;
11951   # stringified
11952   print encoder($data)->utf8->latin1;  # prints the string in latin1
11953   # numified
11954   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11955
11956 =item ABSTRACT
11957
11958 =item Description
11959
11960 =over 4
11961
11962 =item Predefined Methods
11963
11964 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11965 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11966 $e-E<gt>bytes([$encoding])
11967
11968 =item Example: base64 transcoder
11969
11970 =item Operator Overloading
11971
11972 =back
11973
11974 =item SEE ALSO
11975
11976 =back
11977
11978 =head2 Encodencoding, encoding - allows you to write your script in
11979 non-ascii or non-utf8
11980
11981 =over 4
11982
11983 =item SYNOPSIS
11984
11985 =item ABSTRACT
11986
11987 =item USAGE
11988
11989 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11990 I<ENCNAME_IN> ...] ;, no encoding;
11991
11992 =item CAVEATS
11993
11994 =over 4
11995
11996 =item NOT SCOPED
11997
11998 =item DO NOT MIX MULTIPLE ENCODINGS
11999
12000 =back
12001
12002 =item Non-ASCII Identifiers and Filter option
12003
12004 use encoding I<ENCNAME> Filter=E<gt>1;
12005
12006 =item EXAMPLE - Greekperl
12007
12008 =item KNOWN PROBLEMS
12009
12010 =item SEE ALSO
12011
12012 =back
12013
12014 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12015
12016 =over 4
12017
12018 =item SYNOPSIS
12019
12020   use Encode::Encoder;
12021   # Encode::encode("ISO-8859-1", $data);
12022   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12023   # shortcut
12024   use Encode::Encoder qw(encoder);
12025   encoder($data)->iso_8859_1;
12026   # you can stack them!
12027   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12028   # you can use it as a decoder as well
12029   encoder($base64)->bytes('base64')->latin1;
12030   # stringified
12031   print encoder($data)->utf8->latin1;  # prints the string in latin1
12032   # numified
12033   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12034
12035 =item ABSTRACT
12036
12037 =item Description
12038
12039 =over 4
12040
12041 =item Predefined Methods
12042
12043 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12044 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12045 $e-E<gt>bytes([$encoding])
12046
12047 =item Example: base64 transcoder
12048
12049 =item Operator Overloading
12050
12051 =back
12052
12053 =item SEE ALSO
12054
12055 =back
12056
12057 =head2 English - use nice English (or awk) names for ugly punctuation
12058 variables
12059
12060 =over 4
12061
12062 =item SYNOPSIS
12063
12064 =item DESCRIPTION
12065
12066 =item PERFORMANCE
12067
12068 =back
12069
12070 =head2 Env - perl module that imports environment variables as scalars or
12071 arrays
12072
12073 =over 4
12074
12075 =item SYNOPSIS
12076
12077 =item DESCRIPTION
12078
12079 =item LIMITATIONS
12080
12081 =item AUTHOR
12082
12083 =back
12084
12085 =head2 Errno - System errno constants
12086
12087 =over 4
12088
12089 =item SYNOPSIS
12090
12091 =item DESCRIPTION
12092
12093 =item CAVEATS
12094
12095 =item AUTHOR
12096
12097 =item COPYRIGHT
12098
12099 =back
12100
12101 =head2 Exporter - Implements default import method for modules
12102
12103 =over 4
12104
12105 =item SYNOPSIS
12106
12107 =item DESCRIPTION
12108
12109 =over 4
12110
12111 =item How to Export
12112
12113 =item Selecting What To Export
12114
12115 =item How to Import
12116
12117 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12118
12119 =back
12120
12121 =item Advanced features
12122
12123 =over 4
12124
12125 =item Specialised Import Lists
12126
12127 =item Exporting without using Exporter's import method
12128
12129 =item Module Version Checking
12130
12131 =item Managing Unknown Symbols
12132
12133 =item Tag Handling Utility Functions
12134
12135 =item Generating combined tags
12136
12137 =item C<AUTOLOAD>ed Constants
12138
12139 =back
12140
12141 =back
12142
12143 =head2 Exporter::Heavy - Exporter guts
12144
12145 =over 4
12146
12147 =item SYNOPSIS
12148
12149 =item DESCRIPTION
12150
12151 =back
12152
12153 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12154 Makefiles etc.
12155
12156 =over 4
12157
12158 =item SYNOPSIS
12159
12160 =item DESCRIPTION
12161
12162 =back
12163
12164 cat
12165
12166 eqtime src dst
12167
12168 rm_rf files...
12169
12170 rm_f files...
12171
12172 touch files ..
12173
12174 mv source... destination
12175
12176 cp source... destination
12177
12178 chmod mode files..
12179
12180 mkpath directory..
12181
12182 test_f file
12183
12184 =over 4
12185
12186 =item BUGS
12187
12188 =item SEE ALSO
12189
12190 =item AUTHOR
12191
12192 =back
12193
12194 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12195
12196 =over 4
12197
12198 =item SYNOPSIS
12199
12200 =item DESCRIPTION
12201
12202 B<test_harness>
12203
12204 =back
12205
12206 =head2 ExtUtils::Constant - generate XS code to import C header constants
12207
12208 =over 4
12209
12210 =item SYNOPSIS
12211
12212 =item DESCRIPTION
12213
12214 =item USAGE
12215
12216 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12217
12218 =item FUNCTIONS
12219
12220 =back
12221
12222 C_stringify NAME
12223
12224 perl_stringify NAME
12225
12226 constant_types
12227
12228 memEQ_clause NAME, CHECKED_AT, INDENT
12229
12230 assign INDENT, TYPE, PRE, POST, VALUE..
12231
12232 return_clause
12233
12234 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12235
12236 params WHAT
12237
12238 dump_names
12239
12240 dogfood
12241
12242 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12243 def_post, utf8
12244
12245 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12246
12247 autoload PACKAGE, VERSION, AUTOLOADER
12248
12249 WriteMakefileSnippet
12250
12251 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12252 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12253
12254 =over 4
12255
12256 =item AUTHOR
12257
12258 =back
12259
12260 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12261
12262 =over 4
12263
12264 =item SYNOPSIS
12265
12266 =item DESCRIPTION
12267
12268 =item @EXPORT
12269
12270 =item FUNCTIONS
12271
12272 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12273 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12274
12275 =item EXAMPLES
12276
12277 =item SEE ALSO
12278
12279 =item AUTHOR
12280
12281 =back
12282
12283 =head2 ExtUtils::Install - install files from here to there
12284
12285 =over 4
12286
12287 =item SYNOPSIS
12288
12289 =item DESCRIPTION
12290
12291 =back
12292
12293 =head2 ExtUtils::Installed - Inventory management of installed modules
12294
12295 =over 4
12296
12297 =item SYNOPSIS
12298
12299 =item DESCRIPTION
12300
12301 =item USAGE
12302
12303 =item FUNCTIONS
12304
12305 new(), modules(), files(), directories(), directory_tree(), validate(),
12306 packlist(), version()
12307
12308 =item EXAMPLE
12309
12310 =item AUTHOR
12311
12312 =back
12313
12314 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12315
12316 =over 4
12317
12318 =item SYNOPSIS
12319
12320 =item DESCRIPTION
12321
12322 For static extensions, For dynamic extensions at build/link time, For
12323 dynamic extensions at load time
12324
12325 =over 4
12326
12327 =item EXTRALIBS
12328
12329 =item LDLOADLIBS and LD_RUN_PATH
12330
12331 =item BSLOADLIBS
12332
12333 =back
12334
12335 =item PORTABILITY
12336
12337 =over 4
12338
12339 =item VMS implementation
12340
12341 =item Win32 implementation
12342
12343 =back
12344
12345 =item SEE ALSO
12346
12347 =back
12348
12349 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12350
12351 =over 4
12352
12353 =item SYNOPSIS
12354
12355 =item DESCRIPTION
12356
12357 =back
12358
12359 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12360
12361 =over 4
12362
12363 =item SYNOPSIS
12364
12365 =item DESCRIPTION
12366
12367 =item Inherently Cross-Platform Methods
12368
12369 =over 4
12370
12371 =item File::Spec wrappers  B<DEPRECATED>
12372
12373 canonpath
12374
12375 =back
12376
12377 =back
12378
12379 catdir
12380
12381 catfile
12382
12383 curdir
12384
12385 file_name_is_absolute
12386
12387 path
12388
12389 rootdir
12390
12391 updir
12392
12393 =over 4
12394
12395 =item Thought To Be Cross-Platform Methods
12396
12397 test_via_harness
12398
12399 =back
12400
12401 test_via_script
12402
12403 =over 4
12404
12405 =item AUTHOR
12406
12407 =back
12408
12409 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12410 ExtUtils::MakeMaker
12411
12412 =over 4
12413
12414 =item SYNOPSIS
12415
12416 =item DESCRIPTION
12417
12418 =back
12419
12420 perl_archive
12421
12422 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12423 ExtUtils::MakeMaker
12424
12425 =over 4
12426
12427 =item SYNOPSIS
12428
12429 =item DESCRIPTION
12430
12431 canonpath, cflags, manifypods, perl_archive
12432
12433 =back
12434
12435 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12436
12437 =over 4
12438
12439 =item SYNOPSIS
12440
12441 =item DESCRIPTION
12442
12443 =over 4
12444
12445 =item Overridden methods
12446
12447 B<replace_manpage_separator>
12448
12449 =back
12450
12451 =back
12452
12453 =over 4
12454
12455 =item AUTHOR
12456
12457 =item SEE ALSO
12458
12459 =back
12460
12461 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12462 ExtUtils::MakeMaker
12463
12464 =over 4
12465
12466 =item SYNOPSIS
12467
12468 =item DESCRIPTION
12469
12470 =back
12471
12472 maybe_command
12473
12474 guess_name
12475
12476 macify
12477
12478 patternify
12479
12480 init_main
12481
12482 init_others
12483
12484 init_dirscan
12485
12486 libscan (o)
12487
12488 constants (o)
12489
12490 static (o)
12491
12492 dlsyms (o)
12493
12494 dynamic (o)
12495
12496 clean (o)
12497
12498 realclean (o)
12499
12500 rulez (o)
12501
12502 processPL (o)
12503
12504 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12505 ExtUtils::MakeMaker
12506
12507 =over 4
12508
12509 =item SYNOPSIS
12510
12511 =item DESCRIPTION
12512
12513 =back
12514
12515 constants (o)
12516
12517 static_lib (o)
12518
12519 dynamic_lib (o)
12520
12521 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12522 ExtUtils::MakeMaker
12523
12524 =over 4
12525
12526 =item SYNOPSIS
12527
12528 =item DESCRIPTION
12529
12530 =item METHODS
12531
12532 =back
12533
12534 perl_archive_after
12535
12536 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12537
12538 =over 4
12539
12540 =item SYNOPSIS
12541
12542 =item DESCRIPTION
12543
12544 =over 4
12545
12546 =item Overridden methods
12547
12548 B<replace_manpage_separator>
12549
12550 =back
12551
12552 =back
12553
12554 =over 4
12555
12556 =item AUTHOR
12557
12558 =item SEE ALSO
12559
12560 =back
12561
12562 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12563
12564 =over 4
12565
12566 =item SYNOPSIS
12567
12568 =item DESCRIPTION
12569
12570 =item METHODS
12571
12572 =back
12573
12574 =over 4
12575
12576 =item SelfLoaded methods
12577
12578 c_o (o)
12579
12580 =back
12581
12582 cflags (o)
12583
12584 clean (o)
12585
12586 const_cccmd (o)
12587
12588 const_config (o)
12589
12590 const_loadlibs (o)
12591
12592 constants (o)
12593
12594 depend (o)
12595
12596 dir_target (o)
12597
12598 dist (o)
12599
12600 dist_basics (o)
12601
12602 dist_ci (o)
12603
12604 dist_core (o)
12605
12606 dist_dir
12607
12608 dist_test
12609
12610 dlsyms (o)
12611
12612 dynamic (o)
12613
12614 dynamic_bs (o)
12615
12616 dynamic_lib (o)
12617
12618 exescan
12619
12620 extliblist
12621
12622 find_perl
12623
12624 find_tests
12625
12626 =over 4
12627
12628 =item Methods to actually produce chunks of text for the Makefile
12629
12630 fixin
12631
12632 =back
12633
12634 force (o)
12635
12636 guess_name
12637
12638 has_link_code
12639
12640 init_dirscan
12641
12642 init_main
12643
12644 init_others
12645
12646 init_INST
12647
12648 init_INSTALL
12649
12650 init_lib2arch
12651
12652 init_PERL
12653
12654 init_PERM
12655
12656 install (o)
12657
12658 installbin (o)
12659
12660 libscan (o)
12661
12662 linkext (o)
12663
12664 lsdir
12665
12666 macro (o)
12667
12668 makeaperl (o)
12669
12670 makefile (o)
12671
12672 manifypods (o)
12673
12674 maybe_command
12675
12676 maybe_command_in_dirs
12677
12678 needs_linking (o)
12679
12680 nicetext
12681
12682 parse_abstract
12683
12684 parse_version
12685
12686 pasthru (o)
12687
12688 perl_script
12689
12690 perldepend (o)
12691
12692 perm_rw (o)
12693
12694 perm_rwx (o)
12695
12696 pm_to_blib
12697
12698 post_constants (o)
12699
12700 post_initialize (o)
12701
12702 postamble (o)
12703
12704 ppd
12705
12706 prefixify
12707
12708 processPL (o)
12709
12710 quote_paren
12711
12712 realclean (o)
12713
12714 replace_manpage_separator
12715
12716 static (o)
12717
12718 static_lib (o)
12719
12720 staticmake (o)
12721
12722 subdir_x (o)
12723
12724 subdirs (o)
12725
12726 test (o)
12727
12728 test_via_harness (override)
12729
12730 test_via_script (override)
12731
12732 tool_autosplit (o)
12733
12734 tools_other (o)
12735
12736 tool_xsubpp (o)
12737
12738 top_targets (o)
12739
12740 writedoc
12741
12742 xs_c (o)
12743
12744 xs_cpp (o)
12745
12746 xs_o (o)
12747
12748 perl_archive
12749
12750 perl_archive_after
12751
12752 export_list
12753
12754 =over 4
12755
12756 =item SEE ALSO
12757
12758 =back
12759
12760 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12761 ExtUtils::MakeMaker
12762
12763 =over 4
12764
12765 =item SYNOPSIS
12766
12767 =item DESCRIPTION
12768
12769 =over 4
12770
12771 =item Methods always loaded
12772
12773 wraplist
12774
12775 =back
12776
12777 =back
12778
12779 =over 4
12780
12781 =item Methods
12782
12783 guess_name (override)
12784
12785 =back
12786
12787 find_perl (override)
12788
12789 maybe_command (override)
12790
12791 maybe_command_in_dirs (override)
12792
12793 perl_script (override)
12794
12795 replace_manpage_separator
12796
12797 init_main (override)
12798
12799 init_others (override)
12800
12801 constants (override)
12802
12803 cflags (override)
12804
12805 const_cccmd (override)
12806
12807 pm_to_blib (override)
12808
12809 tool_autosplit (override)
12810
12811 tool_sxubpp (override)
12812
12813 xsubpp_version (override)
12814
12815 tools_other (override)
12816
12817 dist (override)
12818
12819 c_o (override)
12820
12821 xs_c (override)
12822
12823 xs_o (override)
12824
12825 top_targets (override)
12826
12827 dlsyms (override)
12828
12829 dynamic_lib (override)
12830
12831 dynamic_bs (override)
12832
12833 static_lib (override)
12834
12835 manifypods (override)
12836
12837 processPL (override)
12838
12839 installbin (override)
12840
12841 subdir_x (override)
12842
12843 clean (override)
12844
12845 realclean (override)
12846
12847 dist_core (override)
12848
12849 dist_test (override)
12850
12851 install (override)
12852
12853 perldepend (override)
12854
12855 makefile (override)
12856
12857 find_tests (override)
12858
12859 test (override)
12860
12861 makeaperl (override)
12862
12863 nicetext (override)
12864
12865 prefixify (override)
12866
12867 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12868 ExtUtils::MakeMaker
12869
12870 =over 4
12871
12872 =item SYNOPSIS
12873
12874 =item DESCRIPTION
12875
12876 =back
12877
12878 constants (o)
12879
12880 static_lib (o)
12881
12882 dynamic_bs (o)
12883
12884 dynamic_lib (o)
12885
12886 perl_script
12887
12888 pm_to_blib
12889
12890 tool_autosplit (override)
12891
12892 tools_other (o)
12893
12894 xs_o (o)
12895
12896 top_targets (o)
12897
12898 manifypods (o)
12899
12900 dist_ci (o)
12901
12902 dist_core (o)
12903
12904 pasthru (o)
12905
12906 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12907
12908 =over 4
12909
12910 =item SYNOPSIS
12911
12912 =item DESCRIPTION
12913
12914 =back
12915
12916 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12917
12918 =over 4
12919
12920 =item SYNOPSIS
12921
12922 =item DESCRIPTION
12923
12924 =back
12925
12926 =head2 ExtUtils::MakeMaker - create an extension Makefile
12927
12928 =over 4
12929
12930 =item SYNOPSIS
12931
12932 =item DESCRIPTION
12933
12934 =over 4
12935
12936 =item How To Write A Makefile.PL
12937
12938 =item Default Makefile Behaviour
12939
12940 =item make test
12941
12942 =item make testdb
12943
12944 =item make install
12945
12946 =item PREFIX and LIB attribute
12947
12948 =item AFS users
12949
12950 =item Static Linking of a new Perl Binary
12951
12952 =item Determination of Perl Library and Installation Locations
12953
12954 =item Which architecture dependent directory?
12955
12956 =item Using Attributes and Parameters
12957
12958 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12959 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12960 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12961 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12962 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12963 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12964 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12965 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12966 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
12967 LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
12968 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
12969 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
12970 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
12971 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
12972 PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
12973 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
12974 XSPROTOARG, XS_VERSION
12975
12976 =item Additional lowercase attributes
12977
12978 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12979 tool_autosplit
12980
12981 =item Overriding MakeMaker Methods
12982
12983 =item Hintsfile support
12984
12985 =item Distribution Support
12986
12987    make distcheck,    make skipcheck,    make distclean,    make manifest,
12988   make distdir,   make disttest,    make tardist,    make dist,    make
12989 uutardist,    make shdist,    make zipdist,    make ci
12990
12991 =item Disabling an extension
12992
12993 =back
12994
12995 =item ENVIRONMENT
12996
12997 PERL_MM_OPT, PERL_MM_USE_DEFAULT
12998
12999 =item SEE ALSO
13000
13001 =item AUTHORS
13002
13003 =back
13004
13005 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13006
13007 =over 4
13008
13009 =item SYNOPSIS
13010
13011 =item DESCRIPTION
13012
13013 =item MANIFEST.SKIP
13014
13015 =item EXPORT_OK
13016
13017 =item GLOBAL VARIABLES
13018
13019 =item DIAGNOSTICS
13020
13021 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13022 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13023
13024 =item ENVIRONMENT
13025
13026 B<PERL_MM_MANIFEST_DEBUG>
13027
13028 =item SEE ALSO
13029
13030 =item AUTHOR
13031
13032 =back
13033
13034 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13035
13036 =over 4
13037
13038 =item SYNOPSIS
13039
13040 =item DESCRIPTION
13041
13042 =item SEE ALSO
13043
13044 =back
13045
13046 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13047
13048 =over 4
13049
13050 =item SYNOPSIS
13051
13052 =item DESCRIPTION
13053
13054 =back
13055
13056 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13057 extension
13058
13059 =over 4
13060
13061 =item SYNOPSIS
13062
13063 =item DESCRIPTION
13064
13065 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13066
13067 =item AUTHOR
13068
13069 =item REVISION
13070
13071 =back
13072
13073 =head2 ExtUtils::Packlist - manage .packlist files
13074
13075 =over 4
13076
13077 =item SYNOPSIS
13078
13079 =item DESCRIPTION
13080
13081 =item USAGE
13082
13083 =item FUNCTIONS
13084
13085 new(), read(), write(), validate(), packlist_file()
13086
13087 =item EXAMPLE
13088
13089 =item AUTHOR
13090
13091 =back
13092
13093 =head2 ExtUtils::testlib - add blib/* directories to @INC
13094
13095 =over 4
13096
13097 =item SYNOPSIS
13098
13099 =item DESCRIPTION
13100
13101 =back
13102
13103 =head2 Fatal - replace functions with equivalents which succeed or die
13104
13105 =over 4
13106
13107 =item SYNOPSIS
13108
13109 =item DESCRIPTION
13110
13111 =item AUTHOR
13112
13113 =back
13114
13115 =head2 Fcntl - load the C Fcntl.h defines
13116
13117 =over 4
13118
13119 =item SYNOPSIS
13120
13121 =item DESCRIPTION
13122
13123 =item NOTE
13124
13125 =item EXPORTED SYMBOLS
13126
13127 =back
13128
13129 =head2 File::Basename, fileparse - split a pathname into pieces
13130
13131 =over 4
13132
13133 =item SYNOPSIS
13134
13135 =item DESCRIPTION
13136
13137 fileparse_set_fstype, fileparse
13138
13139 =item EXAMPLES
13140
13141 C<basename>, C<dirname>
13142
13143 =back
13144
13145 =head2 File::CheckTree, validate - run many filetest checks on a tree
13146
13147 =over 4
13148
13149 =item SYNOPSIS
13150
13151 =item DESCRIPTION
13152
13153 =item AUTHOR
13154
13155 =item HISTORY
13156
13157 =back
13158
13159 =head2 File::Compare - Compare files or filehandles
13160
13161 =over 4
13162
13163 =item SYNOPSIS
13164
13165 =item DESCRIPTION
13166
13167 =item RETURN
13168
13169 =item AUTHOR
13170
13171 =back
13172
13173 =head2 File::Copy - Copy files or filehandles
13174
13175 =over 4
13176
13177 =item SYNOPSIS
13178
13179 =item DESCRIPTION
13180
13181 =over 4
13182
13183 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13184
13185 rmscopy($from,$to[,$date_flag])
13186
13187 =back
13188
13189 =item RETURN
13190
13191 =item NOTES
13192
13193 =item AUTHOR
13194
13195 =back
13196
13197 =head2 File::DosGlob - DOS like globbing and then some
13198
13199 =over 4
13200
13201 =item SYNOPSIS
13202
13203 =item DESCRIPTION
13204
13205 =item NOTES
13206
13207 =item EXPORTS (by request only)
13208
13209 =item BUGS
13210
13211 =item AUTHOR
13212
13213 =item HISTORY
13214
13215 =item SEE ALSO
13216
13217 =back
13218
13219 =head2 File::Find - Traverse a directory tree.
13220
13221 =over 4
13222
13223 =item SYNOPSIS
13224
13225 =item DESCRIPTION
13226
13227 B<find>, B<finddepth>
13228
13229 =over 4
13230
13231 =item %options
13232
13233 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13234 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13235 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13236
13237 =item The wanted function
13238
13239 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13240 filename within that directory, C<$File::Find::name> is the complete
13241 pathname to the file
13242
13243 =back
13244
13245 =item WARNINGS
13246
13247 =item CAVEAT
13248
13249 $dont_use_nlink, symlinks
13250
13251 =item NOTES
13252
13253 =item HISTORY
13254
13255 =back
13256
13257 =head2 File::Glob - Perl extension for BSD glob routine
13258
13259 =over 4
13260
13261 =item SYNOPSIS
13262
13263 =item DESCRIPTION
13264
13265 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13266 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13267 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13268
13269 =item DIAGNOSTICS
13270
13271 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13272
13273 =item NOTES
13274
13275 =item AUTHOR
13276
13277 =back
13278
13279 =head2 File::Path - create or remove directory trees
13280
13281 =over 4
13282
13283 =item SYNOPSIS
13284
13285 =item DESCRIPTION
13286
13287 =item AUTHORS
13288
13289 =back
13290
13291 =head2 File::Spec - portably perform operations on file names
13292
13293 =over 4
13294
13295 =item SYNOPSIS
13296
13297 =item DESCRIPTION
13298
13299 =item METHODS
13300
13301 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13302 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13303 splitdir, catpath(), abs2rel, rel2abs()
13304
13305 =item SEE ALSO
13306
13307 =item AUTHORS
13308
13309 =back
13310
13311 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13312
13313 =over 4
13314
13315 =item SYNOPSIS
13316
13317 =item DESCRIPTION
13318
13319 =back
13320
13321 =head2 File::Spec::Epoc - methods for Epoc file specs
13322
13323 =over 4
13324
13325 =item SYNOPSIS
13326
13327 =item DESCRIPTION
13328
13329 canonpath()
13330
13331 =back
13332
13333 =over 4
13334
13335 =item SEE ALSO
13336
13337 =back
13338
13339 =head2 File::Spec::Functions - portably perform operations on file names
13340
13341 =over 4
13342
13343 =item SYNOPSIS
13344
13345 =item DESCRIPTION
13346
13347 =over 4
13348
13349 =item Exports
13350
13351 =back
13352
13353 =item SEE ALSO
13354
13355 =back
13356
13357 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13358
13359 =over 4
13360
13361 =item SYNOPSIS
13362
13363 =item DESCRIPTION
13364
13365 =item METHODS
13366
13367 canonpath
13368
13369 =back
13370
13371 catdir()
13372
13373 catfile
13374
13375 curdir
13376
13377 devnull
13378
13379 rootdir
13380
13381 tmpdir
13382
13383 updir
13384
13385 file_name_is_absolute
13386
13387 path
13388
13389 splitpath
13390
13391 splitdir
13392
13393 catpath
13394
13395 abs2rel
13396
13397 rel2abs
13398
13399 =over 4
13400
13401 =item AUTHORS
13402
13403 =item SEE ALSO
13404
13405 =back
13406
13407 =head2 File::Spec::NW5 - methods for NW5 file specs
13408
13409 =over 4
13410
13411 =item SYNOPSIS
13412
13413 =item DESCRIPTION
13414
13415 devnull
13416
13417 =back
13418
13419 tmpdir
13420
13421 catfile
13422
13423 canonpath
13424
13425 splitpath
13426
13427 splitdir
13428
13429 catpath
13430
13431 =over 4
13432
13433 =item SEE ALSO
13434
13435 =back
13436
13437 canonpath
13438
13439 splitpath
13440
13441 splitdir
13442
13443 catpath
13444
13445 =head2 File::Spec::OS2 - methods for OS/2 file specs
13446
13447 =over 4
13448
13449 =item SYNOPSIS
13450
13451 =item DESCRIPTION
13452
13453 =back
13454
13455 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13456 modules
13457
13458 =over 4
13459
13460 =item SYNOPSIS
13461
13462 =item DESCRIPTION
13463
13464 =item METHODS
13465
13466 canonpath()
13467
13468 =back
13469
13470 catdir()
13471
13472 catfile
13473
13474 curdir
13475
13476 devnull
13477
13478 rootdir
13479
13480 tmpdir
13481
13482 updir
13483
13484 no_upwards
13485
13486 case_tolerant
13487
13488 file_name_is_absolute
13489
13490 path
13491
13492 join
13493
13494 splitpath
13495
13496 splitdir
13497
13498 catpath()
13499
13500 abs2rel
13501
13502 rel2abs()
13503
13504 =over 4
13505
13506 =item SEE ALSO
13507
13508 =back
13509
13510 =head2 File::Spec::VMS - methods for VMS file specs
13511
13512 =over 4
13513
13514 =item SYNOPSIS
13515
13516 =item DESCRIPTION
13517
13518 eliminate_macros
13519
13520 =back
13521
13522 fixpath
13523
13524 =over 4
13525
13526 =item Methods always loaded
13527
13528 canonpath (override)
13529
13530 =back
13531
13532 catdir
13533
13534 catfile
13535
13536 curdir (override)
13537
13538 devnull (override)
13539
13540 rootdir (override)
13541
13542 tmpdir (override)
13543
13544 updir (override)
13545
13546 case_tolerant (override)
13547
13548 path (override)
13549
13550 file_name_is_absolute (override)
13551
13552 splitpath (override)
13553
13554 splitdir (override)
13555
13556 catpath (override)
13557
13558 abs2rel (override)
13559
13560 rel2abs (override)
13561
13562 =over 4
13563
13564 =item SEE ALSO
13565
13566 =back
13567
13568 =head2 File::Spec::Win32 - methods for Win32 file specs
13569
13570 =over 4
13571
13572 =item SYNOPSIS
13573
13574 =item DESCRIPTION
13575
13576 devnull
13577
13578 =back
13579
13580 tmpdir
13581
13582 catfile
13583
13584 canonpath
13585
13586 splitpath
13587
13588 splitdir
13589
13590 catpath
13591
13592 =over 4
13593
13594 =item SEE ALSO
13595
13596 =back
13597
13598 =head2 File::Temp - return name and handle of a temporary file safely
13599
13600 =over 4
13601
13602 =item PORTABILITY
13603
13604 =item SYNOPSIS
13605
13606 =item DESCRIPTION
13607
13608 =back
13609
13610 =over 4
13611
13612 =item FUNCTIONS
13613
13614 B<tempfile>
13615
13616 =back
13617
13618 B<tempdir>
13619
13620 =over 4
13621
13622 =item MKTEMP FUNCTIONS
13623
13624 B<mkstemp>
13625
13626 =back
13627
13628 B<mkstemps>
13629
13630 B<mkdtemp>
13631
13632 B<mktemp>
13633
13634 =over 4
13635
13636 =item POSIX FUNCTIONS
13637
13638 B<tmpnam>
13639
13640 =back
13641
13642 B<tmpfile>
13643
13644 =over 4
13645
13646 =item ADDITIONAL FUNCTIONS
13647
13648 B<tempnam>
13649
13650 =back
13651
13652 =over 4
13653
13654 =item UTILITY FUNCTIONS
13655
13656 B<unlink0>
13657
13658 =back
13659
13660 =over 4
13661
13662 =item PACKAGE VARIABLES
13663
13664 B<safe_level>, STANDARD, MEDIUM, HIGH
13665
13666 =back
13667
13668 TopSystemUID
13669
13670 =over 4
13671
13672 =item WARNING
13673
13674 =over 4
13675
13676 =item Temporary files and NFS
13677
13678 =back
13679
13680 =item HISTORY
13681
13682 =item SEE ALSO
13683
13684 =item AUTHOR
13685
13686 =back
13687
13688 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13689
13690 =over 4
13691
13692 =item SYNOPSIS
13693
13694 =item DESCRIPTION
13695
13696 =item NOTE
13697
13698 =item AUTHOR
13699
13700 =back
13701
13702 =head2 FileCache - keep more files open than the system permits
13703
13704 =over 4
13705
13706 =item SYNOPSIS
13707
13708 =item DESCRIPTION
13709
13710 cacheout EXPR, cacheout MODE, EXPR
13711
13712 =item CAVEATS
13713
13714 =item BUGS
13715
13716 =back
13717
13718 =head2 FileHandle - supply object methods for filehandles
13719
13720 =over 4
13721
13722 =item SYNOPSIS
13723
13724 =item DESCRIPTION
13725
13726 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13727
13728 =item SEE ALSO
13729
13730 =back
13731
13732 =head2 Filter::Simple - Simplified source filtering
13733
13734 =over 4
13735
13736 =item SYNOPSIS
13737
13738 =item DESCRIPTION
13739
13740 =over 4
13741
13742 =item The Problem
13743
13744 =item A Solution
13745
13746 =item Disabling or changing <no> behaviour
13747
13748 =item All-in-one interface
13749
13750 =item Filtering only specific components of source code
13751
13752 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13753 C<"all">
13754
13755 =item Filtering only the code parts of source code
13756
13757 Most source code ceases to be grammatically correct when it is broken up
13758 into the pieces between string literals and regexes. So the C<'code'>
13759 component filter behaves slightly differently from the other partial
13760 filters
13761 described in the previous section.
13762
13763 =item Using Filter::Simple with an explicit C<import> subroutine
13764
13765 =item Using Filter::Simple and Exporter together
13766
13767 =item How it works
13768
13769 =back
13770
13771 =item AUTHOR
13772
13773 =item COPYRIGHT
13774
13775 =back
13776
13777 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13778
13779 =over 4
13780
13781 =item SYNOPSIS
13782
13783 =item DESCRIPTION
13784
13785 =over 4
13786
13787 =item B<use Filter::Util::Call>
13788
13789 =item B<import()>
13790
13791 =item B<filter() and anonymous sub>
13792
13793 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13794
13795 =back
13796
13797 =item EXAMPLES
13798
13799 =over 4
13800
13801 =item Example 1: A simple filter.
13802
13803 =item Example 2: Using the context
13804
13805 =item Example 3: Using the context within the filter
13806
13807 =item Example 4: Using filter_del
13808
13809 =back
13810
13811 =item Filter::Simple
13812
13813 =item AUTHOR
13814
13815 =item DATE
13816
13817 =back
13818
13819 =head2 FindBin - Locate directory of original perl script
13820
13821 =over 4
13822
13823 =item SYNOPSIS
13824
13825 =item DESCRIPTION
13826
13827 =item EXPORTABLE VARIABLES
13828
13829 =item KNOWN ISSUES
13830
13831 =item KNOWN BUGS
13832
13833 =item AUTHORS
13834
13835 =item COPYRIGHT
13836
13837 =back
13838
13839 =head2 GDBM_File - Perl5 access to the gdbm library.
13840
13841 =over 4
13842
13843 =item SYNOPSIS
13844
13845 =item DESCRIPTION
13846
13847 =item AVAILABILITY
13848
13849 =item BUGS
13850
13851 =item SEE ALSO
13852
13853 =back
13854
13855 =head2 Getopt::Long - Extended processing of command line options
13856
13857 =over 4
13858
13859 =item SYNOPSIS
13860
13861 =item DESCRIPTION
13862
13863 =item Command Line Options, an Introduction
13864
13865 =item Getting Started with Getopt::Long
13866
13867 =over 4
13868
13869 =item Simple options
13870
13871 =item A little bit less simple options
13872
13873 =item Mixing command line option with other arguments
13874
13875 =item Options with values
13876
13877 =item Options with multiple values
13878
13879 =item Options with hash values
13880
13881 =item User-defined subroutines to handle options
13882
13883 =item Options with multiple names
13884
13885 =item Case and abbreviations
13886
13887 =item Summary of Option Specifications
13888
13889 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13890 + [ I<desttype> ]
13891
13892 =back
13893
13894 =item Advanced Possibilities
13895
13896 =over 4
13897
13898 =item Object oriented interface
13899
13900 =item Documentation and help texts
13901
13902 =item Storing options in a hash
13903
13904 =item Bundling
13905
13906 =item The lonesome dash
13907
13908 =item Argument callback
13909
13910 =back
13911
13912 =item Configuring Getopt::Long
13913
13914 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13915 require_order, permute, bundling (default: disabled), bundling_override
13916 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13917 (default: disabled), pass_through (default: disabled), prefix,
13918 prefix_pattern, debug (default: disabled)
13919
13920 =item Return values and Errors
13921
13922 =item Legacy
13923
13924 =over 4
13925
13926 =item Default destinations
13927
13928 =item Alternative option starters
13929
13930 =item Configuration variables
13931
13932 =back
13933
13934 =item Trouble Shooting
13935
13936 =over 4
13937
13938 =item Warning: Ignoring '!' modifier for short option
13939
13940 =item GetOptions does not return a false result when an option is not
13941 supplied
13942
13943 =item GetOptions does not split the command line correctly
13944
13945 =item How do I put a "-?" option into a Getopt::Long?
13946
13947 =back
13948
13949 =item AUTHOR
13950
13951 =item COPYRIGHT AND DISCLAIMER
13952
13953 =back
13954
13955 =head2 Getopt::Std, getopt - Process single-character switches with switch
13956 clustering
13957
13958 =over 4
13959
13960 =item SYNOPSIS
13961
13962 =item DESCRIPTION
13963
13964 =back
13965
13966 =head2 Hash::Util - A selection of general-utility hash subroutines
13967
13968 =over 4
13969
13970 =item SYNOPSIS
13971
13972 =item DESCRIPTION
13973
13974 =over 4
13975
13976 =item Restricted hashes
13977
13978 lock_keys, unlock_keys
13979
13980 =back
13981
13982 =back
13983
13984 lock_value, unlock_value
13985
13986 B<lock_hash>, B<unlock_hash>
13987
13988 =over 4
13989
13990 =item AUTHOR
13991
13992 =item SEE ALSO
13993
13994 =back
13995
13996 =head2 I18N::Collate - compare 8-bit scalar data according to the current
13997 locale
13998
13999 =over 4
14000
14001 =item SYNOPSIS
14002
14003 =item DESCRIPTION
14004
14005 =back
14006
14007 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14008 tags
14009
14010 =over 4
14011
14012 =item SYNOPSIS
14013
14014 =item DESCRIPTION
14015
14016 =back
14017
14018 the function is_language_tag($lang1)
14019
14020 the function extract_language_tags($whatever)
14021
14022 the function same_language_tag($lang1, $lang2)
14023
14024 the function similarity_language_tag($lang1, $lang2)
14025
14026 the function is_dialect_of($lang1, $lang2)
14027
14028 the function super_languages($lang1)
14029
14030 the function locale2language_tag($locale_identifier)
14031
14032 the function encode_language_tag($lang1)
14033
14034 the function alternate_language_tags($lang1)
14035
14036 the function @langs = panic_languages(@accept_languages)
14037
14038 =over 4
14039
14040 =item ABOUT LOWERCASING
14041
14042 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14043
14044 =item SEE ALSO
14045
14046 =item COPYRIGHT
14047
14048 =item AUTHOR
14049
14050 =back
14051
14052 =head2 I18N::LangTags::List -- tags and names for human languages
14053
14054 =over 4
14055
14056 =item SYNOPSIS
14057
14058 =item DESCRIPTION
14059
14060 =item ABOUT LANGUAGE TAGS
14061
14062 =item LIST OF LANGUAGES
14063
14064 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14065 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14066 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14067 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14068 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14069 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14070 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14071 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14072 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14073 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14074 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14075 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14076 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14077 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14078 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14079 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14080 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14081 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14082 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14083 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14084 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14085 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14086 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14087 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14088 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14089 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14090 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14091 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14092 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14093 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14094 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14095 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14096 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14097 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14098 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14099 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14100 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14101 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14102 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14103 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14104 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14105 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14106 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14107 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14108 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14109 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14110 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14111 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14112 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14113 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14114 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14115 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14116 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14117 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14118 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14119 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14120 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14121 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14122 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14123 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14124 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14125 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14126 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14127 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14128 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14129 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14130 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14131 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14132 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14133 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14134 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14135 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14136 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14137 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14138 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14139 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14140 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14141 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14142 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14143 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14144 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14145 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14146 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14147 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14148 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14149 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14150 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14151 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14152 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14153 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14154 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14155 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14156 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14157 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14158 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14159 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14160 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14161 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14162 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14163 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14164 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14165 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14166 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14167 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14168 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14169 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14170 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14171 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14172 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14173 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14174 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14175 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14176 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14177 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14178 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14179 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14180 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14181 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14182 Zhuang, {zu} : Zulu, {zun} : Zuni
14183
14184 =item SEE ALSO
14185
14186 =item COPYRIGHT AND DISCLAIMER
14187
14188 =item AUTHOR
14189
14190 =back
14191
14192 =head2 I18N::Langinfo - query locale information
14193
14194 =over 4
14195
14196 =item SYNOPSIS
14197
14198 =item DESCRIPTION
14199
14200 =over 4
14201
14202 =item EXPORT
14203
14204 =back
14205
14206 =item SEE ALSO
14207
14208 =item AUTHOR
14209
14210 =item COPYRIGHT AND LICENSE
14211
14212 =back
14213
14214 =head2 IO - load various IO modules
14215
14216 =over 4
14217
14218 =item SYNOPSIS
14219
14220 =item DESCRIPTION
14221
14222 =back
14223
14224 =head2 IO::Dir - supply object methods for directory handles
14225
14226 =over 4
14227
14228 =item SYNOPSIS
14229
14230 =item DESCRIPTION
14231
14232 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14233 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14234
14235 =item SEE ALSO
14236
14237 =item AUTHOR
14238
14239 =item COPYRIGHT
14240
14241 =back
14242
14243 =head2 IO::File - supply object methods for filehandles
14244
14245 =over 4
14246
14247 =item SYNOPSIS
14248
14249 =item DESCRIPTION
14250
14251 =item CONSTRUCTOR
14252
14253 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14254
14255 =item METHODS
14256
14257 open( FILENAME [,MODE [,PERMS]] )
14258
14259 =item SEE ALSO
14260
14261 =item HISTORY
14262
14263 =back
14264
14265 =head2 IO::Handle - supply object methods for I/O handles
14266
14267 =over 4
14268
14269 =item SYNOPSIS
14270
14271 =item DESCRIPTION
14272
14273 =item CONSTRUCTOR
14274
14275 new (), new_from_fd ( FD, MODE )
14276
14277 =item METHODS
14278
14279 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14280 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14281 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14282 $io->blocking ( [ BOOL ] ), $io->untaint
14283
14284 =item NOTE
14285
14286 =item SEE ALSO
14287
14288 =item BUGS
14289
14290 =item HISTORY
14291
14292 =back
14293
14294 =head2 IO::Pipe - supply object methods for pipes
14295
14296 =over 4
14297
14298 =item SYNOPSIS
14299
14300 =item DESCRIPTION
14301
14302 =item CONSTRUCTOR
14303
14304 new ( [READER, WRITER] )
14305
14306 =item METHODS
14307
14308 reader ([ARGS]), writer ([ARGS]), handles ()
14309
14310 =item SEE ALSO
14311
14312 =item AUTHOR
14313
14314 =item COPYRIGHT
14315
14316 =back
14317
14318 =head2 IO::Poll - Object interface to system poll call
14319
14320 =over 4
14321
14322 =item SYNOPSIS
14323
14324 =item DESCRIPTION
14325
14326 =item METHODS
14327
14328 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14329 IO ), handles( [ EVENT_MASK ] )
14330
14331 =item SEE ALSO
14332
14333 =item AUTHOR
14334
14335 =item COPYRIGHT
14336
14337 =back
14338
14339 =head2 IO::Seekable - supply seek based methods for I/O objects
14340
14341 =over 4
14342
14343 =item SYNOPSIS
14344
14345 =item DESCRIPTION
14346
14347 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14348 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14349 $io->tell
14350
14351 =item SEE ALSO
14352
14353 =item HISTORY
14354
14355 =back
14356
14357 =head2 IO::Select - OO interface to the select system call
14358
14359 =over 4
14360
14361 =item SYNOPSIS
14362
14363 =item DESCRIPTION
14364
14365 =item CONSTRUCTOR
14366
14367 new ( [ HANDLES ] )
14368
14369 =item METHODS
14370
14371 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14372 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14373 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14374
14375 =item EXAMPLE
14376
14377 =item AUTHOR
14378
14379 =item COPYRIGHT
14380
14381 =back
14382
14383 =head2 IO::Socket - Object interface to socket communications
14384
14385 =over 4
14386
14387 =item SYNOPSIS
14388
14389 =item DESCRIPTION
14390
14391 =item CONSTRUCTOR
14392
14393 new ( [ARGS] )
14394
14395 =item METHODS
14396
14397 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14398 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14399
14400 =item SEE ALSO
14401
14402 =item AUTHOR
14403
14404 =item COPYRIGHT
14405
14406 =back
14407
14408 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14409
14410 =over 4
14411
14412 =item SYNOPSIS
14413
14414 =item DESCRIPTION
14415
14416 =item CONSTRUCTOR
14417
14418 new ( [ARGS] )
14419
14420 =over 4
14421
14422 =item METHODS
14423
14424 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14425 ()
14426
14427 =back
14428
14429 =item SEE ALSO
14430
14431 =item AUTHOR
14432
14433 =item COPYRIGHT
14434
14435 =back
14436
14437 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14438
14439 =over 4
14440
14441 =item SYNOPSIS
14442
14443 =item DESCRIPTION
14444
14445 =item CONSTRUCTOR
14446
14447 new ( [ARGS] )
14448
14449 =item METHODS
14450
14451 hostpath(), peerpath()
14452
14453 =item SEE ALSO
14454
14455 =item AUTHOR
14456
14457 =item COPYRIGHT
14458
14459 =back
14460
14461 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14462 handles
14463
14464 =over 4
14465
14466 =item SYNOPSIS
14467
14468 =item DESCRIPTION
14469
14470 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14471 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14472
14473 =item SEE ALSO
14474
14475 =item AUTHOR
14476
14477 =item COPYRIGHT
14478
14479 =back
14480
14481 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14482
14483 =over 4
14484
14485 =item SYNOPSIS
14486
14487 =item DESCRIPTION
14488
14489 =item CONSTRUCTOR
14490
14491 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14492
14493 =item METHODS
14494
14495 open( FILENAME [,MODE [,PERMS]] )
14496
14497 =item SEE ALSO
14498
14499 =item HISTORY
14500
14501 =back
14502
14503 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14504 handles
14505
14506 =over 4
14507
14508 =item SYNOPSIS
14509
14510 =item DESCRIPTION
14511
14512 =item CONSTRUCTOR
14513
14514 new (), new_from_fd ( FD, MODE )
14515
14516 =item METHODS
14517
14518 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14519 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14520 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14521 $io->blocking ( [ BOOL ] ), $io->untaint
14522
14523 =item NOTE
14524
14525 =item SEE ALSO
14526
14527 =item BUGS
14528
14529 =item HISTORY
14530
14531 =back
14532
14533 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14534
14535 =over 4
14536
14537 =item SYNOPSIS
14538
14539 =item DESCRIPTION
14540
14541 =item CONSTRUCTOR
14542
14543 new ( [READER, WRITER] )
14544
14545 =item METHODS
14546
14547 reader ([ARGS]), writer ([ARGS]), handles ()
14548
14549 =item SEE ALSO
14550
14551 =item AUTHOR
14552
14553 =item COPYRIGHT
14554
14555 =back
14556
14557 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14558
14559 =over 4
14560
14561 =item SYNOPSIS
14562
14563 =item DESCRIPTION
14564
14565 =item METHODS
14566
14567 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14568 IO ), handles( [ EVENT_MASK ] )
14569
14570 =item SEE ALSO
14571
14572 =item AUTHOR
14573
14574 =item COPYRIGHT
14575
14576 =back
14577
14578 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14579 I/O objects
14580
14581 =over 4
14582
14583 =item SYNOPSIS
14584
14585 =item DESCRIPTION
14586
14587 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14588 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14589 $io->tell
14590
14591 =item SEE ALSO
14592
14593 =item HISTORY
14594
14595 =back
14596
14597 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14598 call
14599
14600 =over 4
14601
14602 =item SYNOPSIS
14603
14604 =item DESCRIPTION
14605
14606 =item CONSTRUCTOR
14607
14608 new ( [ HANDLES ] )
14609
14610 =item METHODS
14611
14612 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14613 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14614 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14615
14616 =item EXAMPLE
14617
14618 =item AUTHOR
14619
14620 =item COPYRIGHT
14621
14622 =back
14623
14624 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14625 communications
14626
14627 =over 4
14628
14629 =item SYNOPSIS
14630
14631 =item DESCRIPTION
14632
14633 =item CONSTRUCTOR
14634
14635 new ( [ARGS] )
14636
14637 =item METHODS
14638
14639 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14640 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14641
14642 =item SEE ALSO
14643
14644 =item AUTHOR
14645
14646 =item COPYRIGHT
14647
14648 =back
14649
14650 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14651 AF_INET domain sockets
14652
14653 =over 4
14654
14655 =item SYNOPSIS
14656
14657 =item DESCRIPTION
14658
14659 =item CONSTRUCTOR
14660
14661 new ( [ARGS] )
14662
14663 =over 4
14664
14665 =item METHODS
14666
14667 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14668 ()
14669
14670 =back
14671
14672 =item SEE ALSO
14673
14674 =item AUTHOR
14675
14676 =item COPYRIGHT
14677
14678 =back
14679
14680 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14681 AF_UNIX domain sockets
14682
14683 =over 4
14684
14685 =item SYNOPSIS
14686
14687 =item DESCRIPTION
14688
14689 =item CONSTRUCTOR
14690
14691 new ( [ARGS] )
14692
14693 =item METHODS
14694
14695 hostpath(), peerpath()
14696
14697 =item SEE ALSO
14698
14699 =item AUTHOR
14700
14701 =item COPYRIGHT
14702
14703 =back
14704
14705 =head2 IPC::Msg - SysV Msg IPC object class
14706
14707 =over 4
14708
14709 =item SYNOPSIS
14710
14711 =item DESCRIPTION
14712
14713 =item METHODS
14714
14715 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14716 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14717 FLAGS ] ), stat
14718
14719 =item SEE ALSO
14720
14721 =item AUTHOR
14722
14723 =item COPYRIGHT
14724
14725 =back
14726
14727 =head2 IPC::Open2, open2 - open a process for both reading and writing
14728
14729 =over 4
14730
14731 =item SYNOPSIS
14732
14733 =item DESCRIPTION
14734
14735 =item WARNING
14736
14737 =item SEE ALSO
14738
14739 =back
14740
14741 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14742 handling
14743
14744 =over 4
14745
14746 =item SYNOPSIS
14747
14748 =item DESCRIPTION
14749
14750 =item WARNING
14751
14752 =back
14753
14754 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14755
14756 =over 4
14757
14758 =item SYNOPSIS
14759
14760 =item DESCRIPTION
14761
14762 =item METHODS
14763
14764 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14765 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14766 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14767 , VALUE ), stat
14768
14769 =item SEE ALSO
14770
14771 =item AUTHOR
14772
14773 =item COPYRIGHT
14774
14775 =back
14776
14777 =head2 IPC::SysV - SysV IPC constants
14778
14779 =over 4
14780
14781 =item SYNOPSIS
14782
14783 =item DESCRIPTION
14784
14785 ftok( PATH, ID )
14786
14787 =item SEE ALSO
14788
14789 =item AUTHORS
14790
14791 =item COPYRIGHT
14792
14793 =back
14794
14795 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14796
14797 =over 4
14798
14799 =item SYNOPSIS
14800
14801 =item DESCRIPTION
14802
14803 =item METHODS
14804
14805 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14806 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14807 FLAGS ] ), stat
14808
14809 =item SEE ALSO
14810
14811 =item AUTHOR
14812
14813 =item COPYRIGHT
14814
14815 =back
14816
14817 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14818 class
14819
14820 =over 4
14821
14822 =item SYNOPSIS
14823
14824 =item DESCRIPTION
14825
14826 =item METHODS
14827
14828 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14829 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14830 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14831 , VALUE ), stat
14832
14833 =item SEE ALSO
14834
14835 =item AUTHOR
14836
14837 =item COPYRIGHT
14838
14839 =back
14840
14841 =head2 List::Util - A selection of general-utility list subroutines
14842
14843 =over 4
14844
14845 =item SYNOPSIS
14846
14847 =item DESCRIPTION
14848
14849 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14850 BLOCK LIST, shuffle LIST, sum LIST
14851
14852 =item KNOWN BUGS
14853
14854 =item SUGGESTED ADDITIONS
14855
14856 =item COPYRIGHT
14857
14858 =back
14859
14860 =head2 List::Utilib::List::Util, List::Util - A selection of
14861 general-utility list subroutines
14862
14863 =over 4
14864
14865 =item SYNOPSIS
14866
14867 =item DESCRIPTION
14868
14869 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14870 BLOCK LIST, shuffle LIST, sum LIST
14871
14872 =item KNOWN BUGS
14873
14874 =item SUGGESTED ADDITIONS
14875
14876 =item COPYRIGHT
14877
14878 =back
14879
14880 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14881 general-utility scalar subroutines
14882
14883 =over 4
14884
14885 =item SYNOPSIS
14886
14887 =item DESCRIPTION
14888
14889 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14890 EXPR, tainted EXPR, weaken REF
14891
14892 =item KNOWN BUGS
14893
14894 =item COPYRIGHT
14895
14896 =item BLATANT PLUG
14897
14898 =back
14899
14900 =head2 Locale::Constants - constants for Locale codes
14901
14902 =over 4
14903
14904 =item SYNOPSIS
14905
14906 =item DESCRIPTION
14907
14908 =item KNOWN BUGS AND LIMITATIONS
14909
14910 =item SEE ALSO
14911
14912 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14913
14914 =item AUTHOR
14915
14916 =item COPYRIGHT
14917
14918 =back
14919
14920 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14921
14922 =over 4
14923
14924 =item SYNOPSIS
14925
14926 =item DESCRIPTION
14927
14928 B<alpha-2>, B<alpha-3>, B<numeric>
14929
14930 =item CONVERSION ROUTINES
14931
14932 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14933 country_code2code( CODE, CODESET, CODESET )
14934
14935 =item QUERY ROUTINES
14936
14937 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14938
14939 =item SEMI-PRIVATE ROUTINES
14940
14941 =over 4
14942
14943 =item alias_code
14944
14945 =item rename_country
14946
14947 =back
14948
14949 =item EXAMPLES
14950
14951 =item DOMAIN NAMES
14952
14953 =item KNOWN BUGS AND LIMITATIONS
14954
14955 =item SEE ALSO
14956
14957 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14958 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14959 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14960 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14961
14962 =item AUTHOR
14963
14964 =item COPYRIGHT
14965
14966 =back
14967
14968 =head2 Locale::Currency - ISO three letter codes for currency
14969 identification (ISO 4217)
14970
14971 =over 4
14972
14973 =item SYNOPSIS
14974
14975 =item DESCRIPTION
14976
14977 XTS, XXX
14978
14979 =item CONVERSION ROUTINES
14980
14981 code2currency(), currency2code()
14982
14983 =item QUERY ROUTINES
14984
14985 C<all_currency_codes()>, C<all_currency_names()>
14986
14987 =item EXAMPLES
14988
14989 =item KNOWN BUGS AND LIMITATIONS
14990
14991 =item SEE ALSO
14992
14993 Locale::Country, Locale::Script, ISO 4217:1995,
14994 http://www.bsi-global.com/iso4217currency
14995
14996 =item AUTHOR
14997
14998 =item COPYRIGHT
14999
15000 =back
15001
15002 =head2 Locale::Language - ISO two letter codes for language identification
15003 (ISO 639)
15004
15005 =over 4
15006
15007 =item SYNOPSIS
15008
15009 =item DESCRIPTION
15010
15011 =item CONVERSION ROUTINES
15012
15013 code2language(), language2code()
15014
15015 =item QUERY ROUTINES
15016
15017 C<all_language_codes()>, C<all_language_names()>
15018
15019 =item EXAMPLES
15020
15021 =item KNOWN BUGS AND LIMITATIONS
15022
15023 =item SEE ALSO
15024
15025 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15026 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15027
15028 =item AUTHOR
15029
15030 =item COPYRIGHT
15031
15032 =back
15033
15034 =head2 Locale::Maketext -- framework for localization
15035
15036 =over 4
15037
15038 =item SYNOPSIS
15039
15040 =item DESCRIPTION
15041
15042 =item QUICK OVERVIEW
15043
15044 =item METHODS
15045
15046 =over 4
15047
15048 =item Construction Methods
15049
15050 =item The "maketext" Method
15051
15052 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15053
15054 =item Utility Methods
15055
15056 $language->quant($number, $singular), $language->quant($number, $singular,
15057 $plural), $language->quant($number, $singular, $plural, $negative),
15058 $language->numf($number), $language->sprintf($format, @items),
15059 $language->language_tag(), $language->encoding()
15060
15061 =item Language Handle Attributes and Internals
15062
15063 =back
15064
15065 =item LANGUAGE CLASS HIERARCHIES
15066
15067 =item ENTRIES IN EACH LEXICON
15068
15069 =item BRACKET NOTATION
15070
15071 =item AUTO LEXICONS
15072
15073 =item CONTROLLING LOOKUP FAILURE
15074
15075 =item HOW TO USE MAKETEXT
15076
15077 =item SEE ALSO
15078
15079 =item COPYRIGHT AND DISCLAIMER
15080
15081 =item AUTHOR
15082
15083 =back
15084
15085 =head2 Locale::Maketext::TPJ13 -- article about software localization
15086
15087 =over 4
15088
15089 =item SYNOPSIS
15090
15091 =item DESCRIPTION
15092
15093 =item Localization and Perl: gettext breaks, Maketext fixes
15094
15095 =over 4
15096
15097 =item A Localization Horror Story: It Could Happen To You
15098
15099 =item The Linguistic View
15100
15101 =item Breaking gettext
15102
15103 =item Replacing gettext
15104
15105 =item Buzzwords: Abstraction and Encapsulation
15106
15107 =item Buzzword: Isomorphism
15108
15109 =item Buzzword: Inheritance
15110
15111 =item Buzzword: Concision
15112
15113 =item The Devil in the Details
15114
15115 =item The Proof in the Pudding: Localizing Web Sites
15116
15117 =item References
15118
15119 =back
15120
15121 =back
15122
15123 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15124
15125 =over 4
15126
15127 =item SYNOPSIS
15128
15129 =item DESCRIPTION
15130
15131 B<alpha-2>, B<alpha-3>, B<numeric>
15132
15133 =over 4
15134
15135 =item SPECIAL CODES
15136
15137 =back
15138
15139 =item CONVERSION ROUTINES
15140
15141 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15142 script_code2code( CODE, CODESET, CODESET )
15143
15144 =item QUERY ROUTINES
15145
15146 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15147
15148 =item EXAMPLES
15149
15150 =item KNOWN BUGS AND LIMITATIONS
15151
15152 =item SEE ALSO
15153
15154 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15155 http://www.evertype.com/standards/iso15924/
15156
15157 =item AUTHOR
15158
15159 =item COPYRIGHT
15160
15161 =back
15162
15163 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15164
15165 =over 4
15166
15167 =item SYNOPSIS
15168
15169 =item DESCRIPTION
15170
15171 encode_base64($str, [$eol]), decode_base64($str)
15172
15173 =item DIAGNOSTICS
15174
15175 Premature end of base64 data, Premature padding of base64 data
15176
15177 =item EXAMPLES
15178
15179 =item COPYRIGHT
15180
15181 =back
15182
15183 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15184 of quoted-printable strings
15185
15186 =over 4
15187
15188 =item SYNOPSIS
15189
15190 =item DESCRIPTION
15191
15192 encode_qp($str), decode_qp($str);
15193
15194 =item COPYRIGHT
15195
15196 =back
15197
15198 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15199 strings
15200
15201 =over 4
15202
15203 =item SYNOPSIS
15204
15205 =item DESCRIPTION
15206
15207 encode_qp($str), decode_qp($str);
15208
15209 =item COPYRIGHT
15210
15211 =back
15212
15213 =head2 Math::BigFloat - Arbitrary size floating point math package
15214
15215 =over 4
15216
15217 =item SYNOPSIS
15218
15219 =item DESCRIPTION
15220
15221 =over 4
15222
15223 =item Canonical notation
15224
15225 =item Output
15226
15227 =item C<mantissa()>, C<exponent()> and C<parts()>
15228
15229 =item Accuracy vs. Precision
15230
15231 =item Rounding
15232
15233 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15234 ), fround  ( -$scale ) and fround ( 0 )
15235
15236 =back
15237
15238 =item EXAMPLES
15239
15240   # not ready yet
15241
15242 =item Autocreating constants
15243
15244 =over 4
15245
15246 =item Math library
15247
15248 =item Using Math::BigInt::Lite
15249
15250 =back
15251
15252 =item BUGS
15253
15254 =item CAVEAT
15255
15256 stringify, bstr(), bdiv, Modifying and =, bpow
15257
15258 =item LICENSE
15259
15260 =item AUTHORS
15261
15262 =back
15263
15264 =head2 Math::BigInt - Arbitrary size integer math package
15265
15266 =over 4
15267
15268 =item SYNOPSIS
15269
15270 =item DESCRIPTION
15271
15272 Canonical notation, Input, Output
15273
15274 =item METHODS
15275
15276 =over 4
15277
15278 =item config
15279
15280 =item accuracy
15281
15282 =item brsft
15283
15284 =item new
15285
15286 =item bnan
15287
15288 =item bzero
15289
15290 =item binf
15291
15292 =item bone
15293
15294 =item is_one()/is_zero()/is_nan()/is_inf()
15295
15296 =item is_positive()/is_negative()
15297
15298         $x->is_positive();              # true if >= 0
15299         $x->is_negative();              # true if <  0
15300
15301 =item is_odd()/is_even()/is_int()
15302
15303 =item bcmp
15304
15305 =item bacmp
15306
15307 =item sign
15308
15309 =item bcmp
15310
15311 =item bneg
15312
15313 =item babs
15314
15315 =item bnorm
15316
15317 =item bnot
15318
15319 =item binc
15320
15321 =item bdec
15322
15323 =item badd
15324
15325 =item bsub
15326
15327 =item bmul
15328
15329 =item bdiv
15330
15331 =item bmod
15332
15333 =item bmodinv
15334
15335 =item bmodpow
15336
15337 =item bpow
15338
15339 =item blsft
15340
15341 =item brsft
15342
15343 =item band
15344
15345 =item bior
15346
15347 =item bxor
15348
15349 =item bnot
15350
15351 =item bsqrt
15352
15353 =item bfac
15354
15355 =item round
15356
15357 =item bround
15358
15359 =item bfround
15360
15361 =item bfloor
15362
15363 =item bceil
15364
15365 =item bgcd
15366
15367 =item blcm
15368
15369 =item exponent
15370
15371 =item mantissa
15372
15373 =item parts
15374
15375 =item copy
15376
15377 =item as_number
15378
15379 =item bsstr
15380
15381 =item as_hex
15382
15383 =item as_bin
15384
15385 =back
15386
15387 =item ACCURACY and PRECISION
15388
15389 =over 4
15390
15391 =item Precision P
15392
15393 =item Accuracy A
15394
15395 =item Fallback F
15396
15397 =item Rounding mode R
15398
15399 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15400 (significant digits), Setting/Accessing, Creating numbers, Usage,
15401 Precedence, Overriding globals, Local settings, Rounding, Default values,
15402 Remarks
15403
15404 =back
15405
15406 =item INTERNALS
15407
15408 =over 4
15409
15410 =item MATH LIBRARY
15411
15412 =item SIGN
15413
15414 =item mantissa(), exponent() and parts()
15415
15416 =back
15417
15418 =item EXAMPLES
15419
15420   use Math::BigInt;
15421
15422 =item Autocreating constants
15423
15424 =item PERFORMANCE
15425
15426 =over 4
15427
15428 =item Alternative math libraries
15429
15430 =item SUBCLASSING
15431
15432 =back
15433
15434 =item Subclassing Math::BigInt
15435
15436 =item UPGRADING
15437
15438 =over 4
15439
15440 =item Auto-upgrade
15441
15442 bsqrt(), div(), blog()
15443
15444 =back
15445
15446 =item BUGS
15447
15448 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15449
15450 =item CAVEATS
15451
15452 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15453 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15454 types, bsqrt(), brsft()
15455
15456 =item LICENSE
15457
15458 =item SEE ALSO
15459
15460 =item AUTHORS
15461
15462 =back
15463
15464 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15465
15466 =over 4
15467
15468 =item SYNOPSIS
15469
15470 =item DESCRIPTION
15471
15472 =item EXPORT
15473
15474 =item WRAP YOUR OWN
15475
15476 =item LICENSE
15477
15478 This program is free software; you may redistribute it and/or modify it
15479 under
15480 the same terms as Perl itself.
15481
15482 =item AUTHORS
15483
15484 =item SEE ALSO
15485
15486 =back
15487
15488 =head2 Math::BigRat - arbitrarily big rationals
15489
15490 =over 4
15491
15492 =item SYNOPSIS
15493
15494 =item DESCRIPTION
15495
15496 =over 4
15497
15498 =item MATH LIBRARY
15499
15500 =back
15501
15502 =item METHODS
15503
15504 =over 4
15505
15506 =item new()
15507
15508 =item numerator()
15509
15510 =item denominator()
15511
15512         $d = $x->denominator();
15513
15514 =item parts()
15515
15516 =item as_number()
15517
15518 =item bfac()
15519
15520 =item blog()
15521
15522 =item bround()/round()/bfround()
15523
15524 =back
15525
15526 =item BUGS
15527
15528 =item LICENSE
15529
15530 =item SEE ALSO
15531
15532 =item AUTHORS
15533
15534 =back
15535
15536 =head2 Math::Complex - complex numbers and associated mathematical
15537 functions
15538
15539 =over 4
15540
15541 =item SYNOPSIS
15542
15543 =item DESCRIPTION
15544
15545 =item OPERATIONS
15546
15547 =item CREATION
15548
15549 =item STRINGIFICATION
15550
15551 =over 4
15552
15553 =item CHANGED IN PERL 5.6
15554
15555 =back
15556
15557 =item USAGE
15558
15559 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15560
15561 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15562
15563 =item BUGS
15564
15565 =item AUTHORS
15566
15567 =back
15568
15569 =head2 Math::Trig - trigonometric functions
15570
15571 =over 4
15572
15573 =item SYNOPSIS
15574
15575 =item DESCRIPTION
15576
15577 =item TRIGONOMETRIC FUNCTIONS
15578
15579 B<tan>
15580
15581 =over 4
15582
15583 =item ERRORS DUE TO DIVISION BY ZERO
15584
15585 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15586
15587 =back
15588
15589 =item PLANE ANGLE CONVERSIONS
15590
15591 =item RADIAL COORDINATE CONVERSIONS
15592
15593 =over 4
15594
15595 =item COORDINATE SYSTEMS
15596
15597 =item 3-D ANGLE CONVERSIONS
15598
15599 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15600 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15601
15602 =back
15603
15604 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15605
15606 =item EXAMPLES
15607
15608 =over 4
15609
15610 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15611
15612 =back
15613
15614 =item BUGS
15615
15616 =item AUTHORS
15617
15618 =back
15619
15620 =head2 Memoize - Make functions faster by trading space for time
15621
15622 =over 4
15623
15624 =item SYNOPSIS
15625
15626 =item DESCRIPTION
15627
15628 =item DETAILS
15629
15630 =item OPTIONS
15631
15632 =over 4
15633
15634 =item INSTALL
15635
15636 =item NORMALIZER
15637
15638 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15639
15640 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15641
15642 =back
15643
15644 =item OTHER FACILITIES
15645
15646 =over 4
15647
15648 =item C<unmemoize>
15649
15650 =item C<flush_cache>
15651
15652 =back
15653
15654 =item CAVEATS
15655
15656 =item PERSISTENT CACHE SUPPORT
15657
15658 =item EXPIRATION SUPPORT
15659
15660 =item BUGS
15661
15662 =item MAILING LIST
15663
15664 =item AUTHOR
15665
15666 =item COPYRIGHT AND LICENSE
15667
15668 =item THANK YOU
15669
15670 =back
15671
15672 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15673 Storable use
15674
15675 =over 4
15676
15677 =item DESCRIPTION
15678
15679 =back
15680
15681 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15682 memoized values
15683
15684 =over 4
15685
15686 =item SYNOPSIS
15687
15688 =item DESCRIPTION
15689
15690 =item INTERFACE
15691
15692  TIEHASH,  EXISTS,  STORE
15693
15694 =item ALTERNATIVES
15695
15696 =item CAVEATS
15697
15698 =item AUTHOR
15699
15700 =item SEE ALSO
15701
15702 =back
15703
15704 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15705
15706 =over 4
15707
15708 =item DESCRIPTION
15709
15710 =back
15711
15712 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15713
15714 =over 4
15715
15716 =item DESCRIPTION
15717
15718 =back
15719
15720 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15721 Storable use
15722
15723 =over 4
15724
15725 =item DESCRIPTION
15726
15727 =back
15728
15729 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15730 Storable use
15731
15732 =over 4
15733
15734 =item DESCRIPTION
15735
15736 =back
15737
15738 =head2 Memoize::Storable - store Memoized data in Storable database
15739
15740 =over 4
15741
15742 =item DESCRIPTION
15743
15744 =back
15745
15746 =head2 NDBM_File - Tied access to ndbm files
15747
15748 =over 4
15749
15750 =item SYNOPSIS
15751
15752 =item DESCRIPTION
15753
15754 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15755
15756 =item DIAGNOSTICS
15757
15758 =over 4
15759
15760 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15761
15762 =back
15763
15764 =item BUGS AND WARNINGS
15765
15766 =back
15767
15768 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15769
15770 =over 4
15771
15772 =item SYNOPSIS
15773
15774 =item DESCRIPTION
15775
15776 =over 4
15777
15778 =item Enforcing redispatch
15779
15780 =item Avoiding repetitions
15781
15782 =back
15783
15784 =item AUTHOR
15785
15786 =item BUGS AND IRRITATIONS
15787
15788 =item COPYRIGHT
15789
15790 =back
15791
15792 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15793
15794 =over 4
15795
15796 =item SYNOPSIS
15797
15798 =item DESCRIPTION
15799
15800 =item USER METHODS
15801
15802 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15803 dataend ()
15804
15805 =item CLASS METHODS
15806
15807 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15808 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15809 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15810
15811 =item EXPORTS
15812
15813 =item AUTHOR
15814
15815 =item COPYRIGHT
15816
15817 =back
15818
15819 =head2 Net::Config - Local configuration data for libnet
15820
15821 =over 4
15822
15823 =item SYNOPSYS
15824
15825 =item DESCRIPTION
15826
15827 =item METHODS
15828
15829 requires_firewall HOST
15830
15831 =item NetConfig VALUES
15832
15833 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15834 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15835 ftp_int_pasive, local_netmask, test_hosts, test_exists
15836
15837 =back
15838
15839 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15840 and domain
15841
15842 =over 4
15843
15844 =item SYNOPSIS
15845
15846 =item DESCRIPTION
15847
15848 hostfqdn (), hostname (), hostdomain ()
15849
15850 =item AUTHOR
15851
15852 =item COPYRIGHT
15853
15854 =back
15855
15856 =head2 Net::FTP - FTP Client class
15857
15858 =over 4
15859
15860 =item SYNOPSIS
15861
15862 =item DESCRIPTION
15863
15864 =item OVERVIEW
15865
15866 =item CONSTRUCTOR
15867
15868 new (HOST [,OPTIONS])
15869
15870 =item METHODS
15871
15872 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15873 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15874 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15875 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15876 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15877 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15878 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15879 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15880 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15881 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15882 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15883 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15884 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15885
15886 =over 4
15887
15888 =item Methods for the adventurous
15889
15890 quot (CMD [,ARGS])
15891
15892 =back
15893
15894 =item THE dataconn CLASS
15895
15896 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15897 bytes_read (), abort (), close ()
15898
15899 =item UNIMPLEMENTED
15900
15901 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15902
15903 =item REPORTING BUGS
15904
15905 =item AUTHOR
15906
15907 =item SEE ALSO
15908
15909 =item USE EXAMPLES
15910
15911 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15912
15913 =item CREDITS
15914
15915 =item COPYRIGHT
15916
15917 =back
15918
15919 =head2 Net::NNTP - NNTP Client class
15920
15921 =over 4
15922
15923 =item SYNOPSIS
15924
15925 =item DESCRIPTION
15926
15927 =item CONSTRUCTOR
15928
15929 new ( [ HOST ] [, OPTIONS ])
15930
15931 =item METHODS
15932
15933 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15934 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15935 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15936 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15937 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15938 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15939 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15940
15941 =over 4
15942
15943 =item Extension methods
15944
15945 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15946 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15947 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15948 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15949 GROUP ] ), reader
15950
15951 =back
15952
15953 =item UNSUPPORTED
15954
15955 =item DEFINITIONS
15956
15957 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15958
15959 =item SEE ALSO
15960
15961 =item AUTHOR
15962
15963 =item COPYRIGHT
15964
15965 =back
15966
15967 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15968
15969 =over 4
15970
15971 =item SYNOPSIS
15972
15973 =item DESCRIPTION
15974
15975 =item EXAMPLES
15976
15977 =item CONSTRUCTOR
15978
15979 new ( [ HOST, ] [ OPTIONS ] )
15980
15981 =item METHODS
15982
15983 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15984 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15985 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15986 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15987
15988 =item NOTES
15989
15990 =item SEE ALSO
15991
15992 =item AUTHOR
15993
15994 =item COPYRIGHT
15995
15996 =back
15997
15998 =head2 Net::Ping - check a remote host for reachability
15999
16000 =over 4
16001
16002 =item SYNOPSIS
16003
16004 =item DESCRIPTION
16005
16006 =over 4
16007
16008 =item Functions
16009
16010 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->hires( { 0 | 1 }
16011 );, $p->bind($local_addr);, $p->ping($host [, $timeout]);,
16012 $p->open($host);, $p->close();, pingecho($host [, $timeout]);
16013
16014 =back
16015
16016 =item WARNING
16017
16018 =item NOTES
16019
16020 =item AUTHORS
16021
16022 =item COPYRIGHT
16023
16024 =back
16025
16026 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16027
16028 =over 4
16029
16030 =item SYNOPSIS
16031
16032 =item DESCRIPTION
16033
16034 =item EXAMPLES
16035
16036 =item CONSTRUCTOR
16037
16038 new Net::SMTP [ HOST, ] [ OPTIONS ]
16039
16040 =item METHODS
16041
16042 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16043 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16044 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16045 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16046 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16047 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16048 quit ()
16049
16050 =item ADDRESSES
16051
16052 =item SEE ALSO
16053
16054 =item AUTHOR
16055
16056 =item COPYRIGHT
16057
16058 =back
16059
16060 =head2 Net::Time - time and daytime network client interface
16061
16062 =over 4
16063
16064 =item SYNOPSIS
16065
16066 =item DESCRIPTION
16067
16068 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16069 PROTOCOL [, TIMEOUT]]])
16070
16071 =item AUTHOR
16072
16073 =item COPYRIGHT
16074
16075 =back
16076
16077 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16078 functions
16079
16080 =over 4
16081
16082 =item SYNOPSIS
16083
16084 =item DESCRIPTION
16085
16086 =item EXAMPLES
16087
16088 =item NOTE
16089
16090 =item AUTHOR
16091
16092 =back
16093
16094 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16095
16096 =over 4
16097
16098 =item DESCRIPTION
16099
16100 =over 4
16101
16102 =item Where to get this document
16103
16104 =item How to contribute to this document
16105
16106 =back
16107
16108 =item Author and Copyright Information
16109
16110 =over 4
16111
16112 =item Disclaimer
16113
16114 =back
16115
16116 =item Obtaining and installing libnet
16117
16118 =over 4
16119
16120 =item What is libnet ?
16121
16122 =item Which version of perl do I need ?
16123
16124 =item What other modules do I need ?
16125
16126 =item What machines support libnet ?
16127
16128 =item Where can I get the latest libnet release
16129
16130 =back
16131
16132 =item Using Net::FTP
16133
16134 =over 4
16135
16136 =item How do I download files from an FTP server ?
16137
16138 =item How do I transfer files in binary mode ?
16139
16140 =item How can I get the size of a file on a remote FTP server ?
16141
16142 =item How can I get the modification time of a file on a remote FTP server
16143 ?
16144
16145 =item How can I change the permissions of a file on a remote server ?
16146
16147 =item Can I do a reget operation like the ftp command ?
16148
16149 =item How do I get a directory listing from an FTP server ?
16150
16151 =item Changing directory to "" does not fail ?
16152
16153 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16154
16155 =item I am behind an FTP proxy firewall, but cannot access machines outside
16156 ?
16157
16158 =item My ftp proxy firewall does not listen on port 21
16159
16160 =item Is it possible to change the file permissions of a file on an FTP
16161 server ?
16162
16163 =item I have seen scripts call a method message, but cannot find it
16164 documented ?
16165
16166 =item Why does Net::FTP not implement mput and mget methods
16167
16168 =back
16169
16170 =item Using Net::SMTP
16171
16172 =over 4
16173
16174 =item Why can't the part of an Email address after the @ be used as the
16175 hostname ?
16176
16177 =item Why does Net::SMTP not do DNS MX lookups ?
16178
16179 =item The verify method always returns true ?
16180
16181 =back
16182
16183 =item Debugging scripts
16184
16185 =over 4
16186
16187 =item How can I debug my scripts that use Net::* modules ?
16188
16189 =back
16190
16191 =item AUTHOR AND COPYRIGHT
16192
16193 =back
16194
16195 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16196 functions
16197
16198 =over 4
16199
16200 =item SYNOPSIS
16201
16202 =item DESCRIPTION
16203
16204 =item EXAMPLES
16205
16206 =item NOTE
16207
16208 =item AUTHOR
16209
16210 =back
16211
16212 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16213 functions
16214
16215 =over 4
16216
16217 =item SYNOPSIS
16218
16219 =item DESCRIPTION
16220
16221 =item NOTE
16222
16223 =item AUTHOR
16224
16225 =back
16226
16227 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16228 functions
16229
16230 =over 4
16231
16232 =item SYNOPSIS
16233
16234 =item DESCRIPTION
16235
16236 =item EXAMPLES
16237
16238 =item NOTE
16239
16240 =item AUTHOR
16241
16242 =back
16243
16244 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16245
16246 =over 4
16247
16248 =item SYNOPSIS
16249
16250 =item DESCRIPTION
16251
16252 =item THE .netrc FILE
16253
16254 machine name, default, login name, password string, account string, macdef
16255 name
16256
16257 =item CONSTRUCTOR
16258
16259 lookup ( MACHINE [, LOGIN ])
16260
16261 =item METHODS
16262
16263 login (), password (), account (), lpa ()
16264
16265 =item AUTHOR
16266
16267 =item SEE ALSO
16268
16269 =item COPYRIGHT
16270
16271 =back
16272
16273 =head2 O - Generic interface to Perl Compiler backends
16274
16275 =over 4
16276
16277 =item SYNOPSIS
16278
16279 =item DESCRIPTION
16280
16281 =item CONVENTIONS
16282
16283 =item IMPLEMENTATION
16284
16285 =item BUGS
16286
16287 =item AUTHOR
16288
16289 =back
16290
16291 =head2 ODBM_File - Tied access to odbm files
16292
16293 =over 4
16294
16295 =item SYNOPSIS
16296
16297 =item DESCRIPTION
16298
16299 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16300
16301 =item DIAGNOSTICS
16302
16303 =over 4
16304
16305 =item C<odbm store returned -1, errno 22, key "..." at ...>
16306
16307 =back
16308
16309 =item BUGS AND WARNINGS
16310
16311 =back
16312
16313 =head2 Opcode - Disable named opcodes when compiling perl code
16314
16315 =over 4
16316
16317 =item SYNOPSIS
16318
16319 =item DESCRIPTION
16320
16321 =item NOTE
16322
16323 =item WARNING
16324
16325 =item Operator Names and Operator Lists
16326
16327 an operator name (opname), an operator tag name (optag), a negated opname
16328 or optag, an operator set (opset)
16329
16330 =item Opcode Functions
16331
16332 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16333 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16334 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16335 opdump (PAT)
16336
16337 =item Manipulating Opsets
16338
16339 =item TO DO (maybe)
16340
16341 =back
16342
16343 =over 4
16344
16345 =item Predefined Opcode Tags
16346
16347 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16348 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16349 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16350 :dangerous
16351
16352 =item SEE ALSO
16353
16354 =item AUTHORS
16355
16356 =back
16357
16358 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16359 compartments
16360
16361 =over 4
16362
16363 =item SYNOPSIS
16364
16365 =item DESCRIPTION
16366
16367 a new namespace, an operator mask
16368
16369 =item WARNING
16370
16371 =over 4
16372
16373 =item RECENT CHANGES
16374
16375 =item Methods in class Safe
16376
16377 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16378 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16379 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16380 root (NAMESPACE), mask (MASK)
16381
16382 =item Some Safety Issues
16383
16384 Memory, CPU, Snooping, Signals, State Changes
16385
16386 =item AUTHOR
16387
16388 =back
16389
16390 =back
16391
16392 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16393 compiling
16394
16395 =over 4
16396
16397 =item SYNOPSIS
16398
16399 =item DESCRIPTION
16400
16401 =item SEE ALSO
16402
16403 =back
16404
16405 =head2 POSIX - Perl interface to IEEE Std 1003.1
16406
16407 =over 4
16408
16409 =item SYNOPSIS
16410
16411 =item DESCRIPTION
16412
16413 =item NOTE
16414
16415 =item CAVEATS
16416
16417 =item FUNCTIONS
16418
16419 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16420 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16421 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16422 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16423 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16424 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16425 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16426 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16427 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16428 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16429 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16430 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16431 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16432 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16433 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16434 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16435 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16436 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16437 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16438 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16439 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16440 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16441 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16442 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16443 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16444 wctomb, write
16445
16446 =item CLASSES
16447
16448 =over 4
16449
16450 =item POSIX::SigAction
16451
16452 new
16453
16454 =item POSIX::SigSet
16455
16456 new, addset, delset, emptyset, fillset, ismember
16457
16458 =item POSIX::Termios
16459
16460 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16461 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16462 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16463 field values, c_cflag field values, c_iflag field values, c_lflag field
16464 values, c_oflag field values
16465
16466 =back
16467
16468 =item PATHNAME CONSTANTS
16469
16470 Constants
16471
16472 =item POSIX CONSTANTS
16473
16474 Constants
16475
16476 =item SYSTEM CONFIGURATION
16477
16478 Constants
16479
16480 =item ERRNO
16481
16482 Constants
16483
16484 =item FCNTL
16485
16486 Constants
16487
16488 =item FLOAT
16489
16490 Constants
16491
16492 =item LIMITS
16493
16494 Constants
16495
16496 =item LOCALE
16497
16498 Constants
16499
16500 =item MATH
16501
16502 Constants
16503
16504 =item SIGNAL
16505
16506 Constants
16507
16508 =item STAT
16509
16510 Constants, Macros
16511
16512 =item STDLIB
16513
16514 Constants
16515
16516 =item STDIO
16517
16518 Constants
16519
16520 =item TIME
16521
16522 Constants
16523
16524 =item UNISTD
16525
16526 Constants
16527
16528 =item WAIT
16529
16530 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16531 WTERMSIG, WIFSTOPPED, WSTOPSIG
16532
16533 =back
16534
16535 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16536 name space
16537
16538 =over 4
16539
16540 =item SYNOPSIS
16541
16542 =item DESCRIPTION
16543
16544 unix, stdio, perlio, crlf, utf8, bytes, raw
16545
16546 =over 4
16547
16548 =item Defaults and how to override them
16549
16550 =back
16551
16552 =item AUTHOR
16553
16554 =item SEE ALSO
16555
16556 =back
16557
16558 =head2 PerlIO::Scalar - support module for in-memory IO.
16559
16560 =over 4
16561
16562 =item SYNOPSIS
16563
16564 =item DESCRIPTION
16565
16566 =back
16567
16568 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
16569
16570 =over 4
16571
16572 =item SYNOPSIS
16573
16574 =item DESCRIPTION
16575
16576 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16577 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
16578 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
16579 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16580 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16581 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16582 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16583
16584 =over 4
16585
16586 =item Example - a Hexadecimal Handle
16587
16588 =back
16589
16590 =back
16591
16592 =head2 PerlIO::encoding - encoding layer
16593
16594 =over 4
16595
16596 =item SYNOPSIS
16597
16598 =item DESCRIPTION
16599
16600 =item SEE ALSO
16601
16602 =back
16603
16604 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16605
16606 =over 4
16607
16608 =item SYNOPSIS
16609
16610 =item OPTIONS/ARGUMENTS
16611
16612 =over 4
16613
16614 =item podchecker()
16615
16616 B<-warnings> =E<gt> I<val>
16617
16618 =back
16619
16620 =item DESCRIPTION
16621
16622 =item DIAGNOSTICS
16623
16624 =over 4
16625
16626 =item Errors
16627
16628 empty =headn, =over on line I<N> without closing =back, =item without
16629 previous =over, =back without previous =over, No argument for =begin, =end
16630 without =begin, Nested =begin's, =for without formatter specification,
16631 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16632 interior-sequence "I<SEQ>", nested commands
16633 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16634 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16635 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16636 after =back
16637
16638 =item Warnings
16639
16640 multiple occurrence of link target I<name>, line containing nothing but
16641 whitespace in paragraph, file does not start with =head, previous =item has
16642 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16643 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16644 items in =over, No argument for =item, empty section in previous paragraph,
16645 Verbatim paragraph in NAME section
16646
16647 =item Hyperlinks
16648
16649 ignoring leading/trailing whitespace in link, (section) in '$page'
16650 deprecated, alternative text/node '%s' contains non-escaped | or /
16651
16652 =back
16653
16654 =item RETURN VALUE
16655
16656 =item EXAMPLES
16657
16658 =item INTERFACE
16659
16660 =back
16661
16662 C<Pod::Checker-E<gt>new( %options )>
16663
16664 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16665 @args )>
16666
16667 C<$checker-E<gt>num_errors()>
16668
16669 C<$checker-E<gt>name()>
16670
16671 C<$checker-E<gt>node()>
16672
16673 C<$checker-E<gt>idx()>
16674
16675 C<$checker-E<gt>hyperlink()>
16676
16677 =over 4
16678
16679 =item AUTHOR
16680
16681 =back
16682
16683 =head2 Pod::Find - find POD documents in directory trees
16684
16685 =over 4
16686
16687 =item SYNOPSIS
16688
16689 =item DESCRIPTION
16690
16691 =back
16692
16693 =over 4
16694
16695 =item C<pod_find( { %opts } , @directories )>
16696
16697 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16698 1>
16699
16700 =back
16701
16702 =over 4
16703
16704 =item C<simplify_name( $str )>
16705
16706 =back
16707
16708 =over 4
16709
16710 =item C<pod_where( { %opts }, $pod )>
16711
16712 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16713 1>
16714
16715 =back
16716
16717 =over 4
16718
16719 =item C<contains_pod( $file , $verbose )>
16720
16721 =back
16722
16723 =over 4
16724
16725 =item AUTHOR
16726
16727 =item SEE ALSO
16728
16729 =back
16730
16731 =head2 Pod::Html - module to convert pod files to HTML
16732
16733 =over 4
16734
16735 =item SYNOPSIS
16736
16737 =item DESCRIPTION
16738
16739 =item ARGUMENTS
16740
16741 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16742 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16743 title, verbose
16744
16745 =item EXAMPLE
16746
16747 =item ENVIRONMENT
16748
16749 =item AUTHOR
16750
16751 =item SEE ALSO
16752
16753 =item COPYRIGHT
16754
16755 =back
16756
16757 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16758 commands, etc.
16759
16760 =over 4
16761
16762 =item SYNOPSIS
16763
16764 =item REQUIRES
16765
16766 =item EXPORTS
16767
16768 =item DESCRIPTION
16769
16770 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16771 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16772
16773 =back
16774
16775 =over 4
16776
16777 =item B<Pod::InputSource>
16778
16779 =back
16780
16781 =over 4
16782
16783 =item B<new()>
16784
16785 =back
16786
16787 =over 4
16788
16789 =item B<name()>
16790
16791 =back
16792
16793 =over 4
16794
16795 =item B<handle()>
16796
16797 =back
16798
16799 =over 4
16800
16801 =item B<was_cutting()>
16802
16803 =back
16804
16805 =over 4
16806
16807 =item B<Pod::Paragraph>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item Pod::Paragraph-E<gt>B<new()>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item $pod_para-E<gt>B<cmd_name()>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item $pod_para-E<gt>B<text()>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item $pod_para-E<gt>B<raw_text()>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item $pod_para-E<gt>B<cmd_prefix()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item $pod_para-E<gt>B<cmd_separator()>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item $pod_para-E<gt>B<parse_tree()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item $pod_para-E<gt>B<file_line()>
16856
16857 =back
16858
16859 =over 4
16860
16861 =item B<Pod::InteriorSequence>
16862
16863 =back
16864
16865 =over 4
16866
16867 =item Pod::InteriorSequence-E<gt>B<new()>
16868
16869 =back
16870
16871 =over 4
16872
16873 =item $pod_seq-E<gt>B<cmd_name()>
16874
16875 =back
16876
16877 =over 4
16878
16879 =item $pod_seq-E<gt>B<prepend()>
16880
16881 =back
16882
16883 =over 4
16884
16885 =item $pod_seq-E<gt>B<append()>
16886
16887 =back
16888
16889 =over 4
16890
16891 =item $pod_seq-E<gt>B<nested()>
16892
16893 =back
16894
16895 =over 4
16896
16897 =item $pod_seq-E<gt>B<raw_text()>
16898
16899 =back
16900
16901 =over 4
16902
16903 =item $pod_seq-E<gt>B<left_delimiter()>
16904
16905 =back
16906
16907 =over 4
16908
16909 =item $pod_seq-E<gt>B<right_delimiter()>
16910
16911 =back
16912
16913 =over 4
16914
16915 =item $pod_seq-E<gt>B<parse_tree()>
16916
16917 =back
16918
16919 =over 4
16920
16921 =item $pod_seq-E<gt>B<file_line()>
16922
16923 =back
16924
16925 =over 4
16926
16927 =item Pod::InteriorSequence::B<DESTROY()>
16928
16929 =back
16930
16931 =over 4
16932
16933 =item B<Pod::ParseTree>
16934
16935 =back
16936
16937 =over 4
16938
16939 =item Pod::ParseTree-E<gt>B<new()>
16940
16941 =back
16942
16943 =over 4
16944
16945 =item $ptree-E<gt>B<top()>
16946
16947 =back
16948
16949 =over 4
16950
16951 =item $ptree-E<gt>B<children()>
16952
16953 =back
16954
16955 =over 4
16956
16957 =item $ptree-E<gt>B<prepend()>
16958
16959 =back
16960
16961 =over 4
16962
16963 =item $ptree-E<gt>B<append()>
16964
16965 =back
16966
16967 =over 4
16968
16969 =item $ptree-E<gt>B<raw_text()>
16970
16971 =back
16972
16973 =over 4
16974
16975 =item Pod::ParseTree::B<DESTROY()>
16976
16977 =back
16978
16979 =over 4
16980
16981 =item SEE ALSO
16982
16983 =item AUTHOR
16984
16985 =back
16986
16987 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
16988
16989 =over 4
16990
16991 =item SYNOPSIS
16992
16993 =item DESCRIPTION
16994
16995 =back
16996
16997 =over 4
16998
16999 =item OBJECT METHODS
17000
17001 C<initialize>
17002
17003 =back
17004
17005 =over 4
17006
17007 =item Data Accessors
17008
17009 B<AddPreamble>
17010
17011 =back
17012
17013 B<AddPostamble>
17014
17015 B<Head1Level>
17016
17017 B<Label>
17018
17019 B<LevelNoNum>
17020
17021 B<MakeIndex>
17022
17023 B<ReplaceNAMEwithSection>
17024
17025 B<StartWithNewPage>
17026
17027 B<TableOfContents>
17028
17029 B<UniqueLabels>
17030
17031 B<UserPreamble>
17032
17033 B<UserPostamble>
17034
17035 B<Lists>
17036
17037 =over 4
17038
17039 =item Subclassed methods
17040
17041 =back
17042
17043 B<begin_pod>
17044
17045 B<end_pod>
17046
17047 B<command>
17048
17049 B<verbatim>
17050
17051 B<textblock>
17052
17053 B<interior_sequence>
17054
17055 =over 4
17056
17057 =item List Methods
17058
17059 B<begin_list>
17060
17061 =back
17062
17063 B<end_list>
17064
17065 B<add_item>
17066
17067 =over 4
17068
17069 =item Methods for headings
17070
17071 B<head>
17072
17073 =back
17074
17075 =over 4
17076
17077 =item Internal methods
17078
17079 B<_output>
17080
17081 =back
17082
17083 B<_replace_special_chars>
17084
17085 B<_replace_special_chars_late>
17086
17087 B<_create_label>
17088
17089 B<_create_index>
17090
17091 B<_clean_latex_commands>
17092
17093 B<_split_delimited>
17094
17095 =over 4
17096
17097 =item NOTES
17098
17099 =item SEE ALSO
17100
17101 =item AUTHORS
17102
17103 =item COPYRIGHT
17104
17105 =item REVISION
17106
17107 =back
17108
17109 =head2 Pod::Man - Convert POD data to formatted *roff input
17110
17111 =over 4
17112
17113 =item SYNOPSIS
17114
17115 =item DESCRIPTION
17116
17117 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17118 release, section
17119
17120 =item DIAGNOSTICS
17121
17122 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17123 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17124 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17125 =back
17126
17127 =item BUGS
17128
17129 =item CAVEATS
17130
17131 =item SEE ALSO
17132
17133 =item AUTHOR
17134
17135 =item COPYRIGHT AND LICENSE
17136
17137 =back
17138
17139 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17140
17141 =over 4
17142
17143 =item SYNOPSIS
17144
17145 =item DESCRIPTION
17146
17147 =item AUTHOR
17148
17149 =item COPYRIGHT AND LICENSE
17150
17151 =back
17152
17153 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17154
17155 =over 4
17156
17157 =item SYNOPSIS
17158
17159 =item DESCRIPTION
17160
17161 =back
17162
17163 =over 4
17164
17165 =item Pod::List
17166
17167 Pod::List-E<gt>new()
17168
17169 =back
17170
17171 $list-E<gt>file()
17172
17173 $list-E<gt>start()
17174
17175 $list-E<gt>indent()
17176
17177 $list-E<gt>type()
17178
17179 $list-E<gt>rx()
17180
17181 $list-E<gt>item()
17182
17183 $list-E<gt>parent()
17184
17185 $list-E<gt>tag()
17186
17187 =over 4
17188
17189 =item Pod::Hyperlink
17190
17191 Pod::Hyperlink-E<gt>new()
17192
17193 =back
17194
17195 $link-E<gt>parse($string)
17196
17197 $link-E<gt>markup($string)
17198
17199 $link-E<gt>text()
17200
17201 $link-E<gt>warning()
17202
17203 $link-E<gt>file(), $link-E<gt>line()
17204
17205 $link-E<gt>page()
17206
17207 $link-E<gt>node()
17208
17209 $link-E<gt>alttext()
17210
17211 $link-E<gt>type()
17212
17213 $link-E<gt>link()
17214
17215 =over 4
17216
17217 =item Pod::Cache
17218
17219 Pod::Cache-E<gt>new()
17220
17221 =back
17222
17223 $cache-E<gt>item()
17224
17225 $cache-E<gt>find_page($name)
17226
17227 =over 4
17228
17229 =item Pod::Cache::Item
17230
17231 Pod::Cache::Item-E<gt>new()
17232
17233 =back
17234
17235 $cacheitem-E<gt>page()
17236
17237 $cacheitem-E<gt>description()
17238
17239 $cacheitem-E<gt>path()
17240
17241 $cacheitem-E<gt>file()
17242
17243 $cacheitem-E<gt>nodes()
17244
17245 $cacheitem-E<gt>find_node($name)
17246
17247 $cacheitem-E<gt>idx()
17248
17249 =over 4
17250
17251 =item AUTHOR
17252
17253 =item SEE ALSO
17254
17255 =back
17256
17257 =head2 Pod::Parser - base class for creating POD filters and translators
17258
17259 =over 4
17260
17261 =item SYNOPSIS
17262
17263 =item REQUIRES
17264
17265 =item EXPORTS
17266
17267 =item DESCRIPTION
17268
17269 =item QUICK OVERVIEW
17270
17271 =item PARSING OPTIONS
17272
17273 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17274 B<-warnings> (default: unset)
17275
17276 =back
17277
17278 =over 4
17279
17280 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17281
17282 =back
17283
17284 =over 4
17285
17286 =item B<command()>
17287
17288 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17289
17290 =back
17291
17292 =over 4
17293
17294 =item B<verbatim()>
17295
17296 C<$text>, C<$line_num>, C<$pod_para>
17297
17298 =back
17299
17300 =over 4
17301
17302 =item B<textblock()>
17303
17304 C<$text>, C<$line_num>, C<$pod_para>
17305
17306 =back
17307
17308 =over 4
17309
17310 =item B<interior_sequence()>
17311
17312 =back
17313
17314 =over 4
17315
17316 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17317
17318 =back
17319
17320 =over 4
17321
17322 =item B<new()>
17323
17324 =back
17325
17326 =over 4
17327
17328 =item B<initialize()>
17329
17330 =back
17331
17332 =over 4
17333
17334 =item B<begin_pod()>
17335
17336 =back
17337
17338 =over 4
17339
17340 =item B<begin_input()>
17341
17342 =back
17343
17344 =over 4
17345
17346 =item B<end_input()>
17347
17348 =back
17349
17350 =over 4
17351
17352 =item B<end_pod()>
17353
17354 =back
17355
17356 =over 4
17357
17358 =item B<preprocess_line()>
17359
17360 =back
17361
17362 =over 4
17363
17364 =item B<preprocess_paragraph()>
17365
17366 =back
17367
17368 =over 4
17369
17370 =item METHODS FOR PARSING AND PROCESSING
17371
17372 =back
17373
17374 =over 4
17375
17376 =item B<parse_text()>
17377
17378 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17379 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17380 I<code-ref>|I<method-name>
17381
17382 =back
17383
17384 =over 4
17385
17386 =item B<interpolate()>
17387
17388 =back
17389
17390 =over 4
17391
17392 =item B<parse_paragraph()>
17393
17394 =back
17395
17396 =over 4
17397
17398 =item B<parse_from_filehandle()>
17399
17400 =back
17401
17402 =over 4
17403
17404 =item B<parse_from_file()>
17405
17406 =back
17407
17408 =over 4
17409
17410 =item ACCESSOR METHODS
17411
17412 =back
17413
17414 =over 4
17415
17416 =item B<errorsub()>
17417
17418 =back
17419
17420 =over 4
17421
17422 =item B<cutting()>
17423
17424 =back
17425
17426 =over 4
17427
17428 =item B<parseopts()>
17429
17430 =back
17431
17432 =over 4
17433
17434 =item B<output_file()>
17435
17436 =back
17437
17438 =over 4
17439
17440 =item B<output_handle()>
17441
17442 =back
17443
17444 =over 4
17445
17446 =item B<input_file()>
17447
17448 =back
17449
17450 =over 4
17451
17452 =item B<input_handle()>
17453
17454 =back
17455
17456 =over 4
17457
17458 =item B<input_streams()>
17459
17460 =back
17461
17462 =over 4
17463
17464 =item B<top_stream()>
17465
17466 =back
17467
17468 =over 4
17469
17470 =item PRIVATE METHODS AND DATA
17471
17472 =back
17473
17474 =over 4
17475
17476 =item B<_push_input_stream()>
17477
17478 =back
17479
17480 =over 4
17481
17482 =item B<_pop_input_stream()>
17483
17484 =back
17485
17486 =over 4
17487
17488 =item TREE-BASED PARSING
17489
17490 =item SEE ALSO
17491
17492 =item AUTHOR
17493
17494 =back
17495
17496 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17497
17498 =over 4
17499
17500 =item SYNOPSIS
17501
17502 =item DESCRIPTION
17503
17504 =over 4
17505
17506 =item EXPORT
17507
17508 =back
17509
17510 =item AUTHOR
17511
17512 =item SEE ALSO
17513
17514 =back
17515
17516 =head2 Pod::Select, podselect() - extract selected sections of POD from
17517 input
17518
17519 =over 4
17520
17521 =item SYNOPSIS
17522
17523 =item REQUIRES
17524
17525 =item EXPORTS
17526
17527 =item DESCRIPTION
17528
17529 =item SECTION SPECIFICATIONS
17530
17531 =item RANGE SPECIFICATIONS
17532
17533 =back
17534
17535 =over 4
17536
17537 =item OBJECT METHODS
17538
17539 =back
17540
17541 =over 4
17542
17543 =item B<curr_headings()>
17544
17545 =back
17546
17547 =over 4
17548
17549 =item B<select()>
17550
17551 =back
17552
17553 =over 4
17554
17555 =item B<add_selection()>
17556
17557 =back
17558
17559 =over 4
17560
17561 =item B<clear_selections()>
17562
17563 =back
17564
17565 =over 4
17566
17567 =item B<match_section()>
17568
17569 =back
17570
17571 =over 4
17572
17573 =item B<is_selected()>
17574
17575 =back
17576
17577 =over 4
17578
17579 =item EXPORTED FUNCTIONS
17580
17581 =back
17582
17583 =over 4
17584
17585 =item B<podselect()>
17586
17587 B<-output>, B<-sections>, B<-ranges>
17588
17589 =back
17590
17591 =over 4
17592
17593 =item PRIVATE METHODS AND DATA
17594
17595 =back
17596
17597 =over 4
17598
17599 =item B<_compile_section_spec()>
17600
17601 =back
17602
17603 =over 4
17604
17605 =item $self->{_SECTION_HEADINGS}
17606
17607 =back
17608
17609 =over 4
17610
17611 =item $self->{_SELECTED_SECTIONS}
17612
17613 =back
17614
17615 =over 4
17616
17617 =item SEE ALSO
17618
17619 =item AUTHOR
17620
17621 =back
17622
17623 =head2 Pod::Text - Convert POD data to formatted ASCII text
17624
17625 =over 4
17626
17627 =item SYNOPSIS
17628
17629 =item DESCRIPTION
17630
17631 alt, code, indent, loose, quotes, sentence, width
17632
17633 =item DIAGNOSTICS
17634
17635 Bizarre space in item, Item called without tag, Can't open %s for reading:
17636 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17637 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17638 Unmatched =back
17639
17640 =item RESTRICTIONS
17641
17642 =item NOTES
17643
17644 =item SEE ALSO
17645
17646 =item AUTHOR
17647
17648 =item COPYRIGHT AND LICENSE
17649
17650 =back
17651
17652 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17653
17654 =over 4
17655
17656 =item SYNOPSIS
17657
17658 =item DESCRIPTION
17659
17660 =item BUGS
17661
17662 =item SEE ALSO
17663
17664 =item AUTHOR
17665
17666 =item COPYRIGHT AND LICENSE
17667
17668 =back
17669
17670 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17671 text
17672
17673 =over 4
17674
17675 =item SYNOPSIS
17676
17677 =item DESCRIPTION
17678
17679 =item BUGS
17680
17681 =item SEE ALSO
17682
17683 =item AUTHOR
17684
17685 =item COPYRIGHT AND LICENSE
17686
17687 =back
17688
17689 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17690 text with format escapes
17691
17692 =over 4
17693
17694 =item SYNOPSIS
17695
17696 =item DESCRIPTION
17697
17698 =item NOTES
17699
17700 =item SEE ALSO
17701
17702 =item AUTHOR
17703
17704 =item COPYRIGHT AND LICENSE
17705
17706 =back
17707
17708 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17709 documentation
17710
17711 =over 4
17712
17713 =item SYNOPSIS
17714
17715 =item ARGUMENTS
17716
17717 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17718 C<-pathlist>
17719
17720 =item DESCRIPTION
17721
17722 =item EXAMPLES
17723
17724 =over 4
17725
17726 =item Recommended Use
17727
17728 =back
17729
17730 =item CAVEATS
17731
17732 =item AUTHOR
17733
17734 =item ACKNOWLEDGEMENTS
17735
17736 =back
17737
17738 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17739 translators.
17740
17741 =over 4
17742
17743 =item HEADINGS
17744
17745 =item This C<is> a "level 1" heading
17746
17747 =over 4
17748
17749 =item ``Level'' "2 I<heading>
17750
17751 =back
17752
17753 =item This C<is> a "level 1" heading
17754
17755 =over 4
17756
17757 =item ``Level'' 2 I<heading>
17758
17759 =back
17760
17761 =item LINKS
17762
17763 =item OVER AND ITEMS
17764
17765 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17766 text
17767
17768 =item FORMATTING CODES
17769
17770 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17771
17772 =item VERBATIM
17773
17774 =item CONCLUSION
17775
17776 =back
17777
17778 =head2 Pod::t::htmlescp, Escape Sequences Test
17779
17780 =over 4
17781
17782 =item DESCRIPTION
17783
17784 =back
17785
17786 =head2 Pod::t::htmlview, Test HTML Rendering
17787
17788 =over 4
17789
17790 =item SYNOPSIS
17791
17792 =item DESCRIPTION
17793
17794 =item METHODS =E<gt> OTHER STUFF
17795
17796 =over 4
17797
17798 =item new()
17799
17800 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17801 Sat, 3 Mat
17802
17803 =item old()
17804
17805 =back
17806
17807 =item TESTING FOR AND BEGIN
17808
17809 =item TESTING URLs hyperlinking
17810
17811 =item SEE ALSO
17812
17813 =back
17814
17815 =head2 SDBM_File - Tied access to sdbm files
17816
17817 =over 4
17818
17819 =item SYNOPSIS
17820
17821 =item DESCRIPTION
17822
17823 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17824
17825 =item DIAGNOSTICS
17826
17827 =over 4
17828
17829 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17830
17831 =back
17832
17833 =item BUGS AND WARNINGS
17834
17835 =back
17836
17837 =head2 Safe - Compile and execute code in restricted compartments
17838
17839 =over 4
17840
17841 =item SYNOPSIS
17842
17843 =item DESCRIPTION
17844
17845 a new namespace, an operator mask
17846
17847 =item WARNING
17848
17849 =over 4
17850
17851 =item RECENT CHANGES
17852
17853 =item Methods in class Safe
17854
17855 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17856 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17857 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17858 root (NAMESPACE), mask (MASK)
17859
17860 =item Some Safety Issues
17861
17862 Memory, CPU, Snooping, Signals, State Changes
17863
17864 =item AUTHOR
17865
17866 =back
17867
17868 =back
17869
17870 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17871
17872 =over 4
17873
17874 =item SYNOPSIS
17875
17876 =item DESCRIPTION
17877
17878 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17879 EXPR, tainted EXPR, weaken REF
17880
17881 =item KNOWN BUGS
17882
17883 =item COPYRIGHT
17884
17885 =item BLATANT PLUG
17886
17887 =back
17888
17889 =head2 Search::Dict, look - search for key in dictionary file
17890
17891 =over 4
17892
17893 =item SYNOPSIS
17894
17895 =item DESCRIPTION
17896
17897 =back
17898
17899 =head2 SelectSaver - save and restore selected file handle
17900
17901 =over 4
17902
17903 =item SYNOPSIS
17904
17905 =item DESCRIPTION
17906
17907 =back
17908
17909 =head2 SelfLoader - load functions only on demand
17910
17911 =over 4
17912
17913 =item SYNOPSIS
17914
17915 =item DESCRIPTION
17916
17917 =over 4
17918
17919 =item The __DATA__ token
17920
17921 =item SelfLoader autoloading
17922
17923 =item Autoloading and package lexicals
17924
17925 =item SelfLoader and AutoLoader
17926
17927 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17928
17929 =item Classes and inherited methods.
17930
17931 =back
17932
17933 =item Multiple packages and fully qualified subroutine names
17934
17935 =back
17936
17937 =head2 Shell - run shell commands transparently within perl
17938
17939 =over 4
17940
17941 =item SYNOPSIS
17942
17943 =item DESCRIPTION
17944
17945 =over 4
17946
17947 =item OBJECT ORIENTED SYNTAX
17948
17949 =back
17950
17951 =item AUTHOR
17952
17953 =back
17954
17955 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17956 socket.h defines and structure manipulators
17957
17958 =over 4
17959
17960 =item SYNOPSIS
17961
17962 =item DESCRIPTION
17963
17964 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17965 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17966 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17967 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17968 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17969
17970 =back
17971
17972 =head2 Storable - persistence for Perl data structures
17973
17974 =over 4
17975
17976 =item SYNOPSIS
17977
17978 =item DESCRIPTION
17979
17980 =item MEMORY STORE
17981
17982 =item ADVISORY LOCKING
17983
17984 =item SPEED
17985
17986 =item CANONICAL REPRESENTATION
17987
17988 =item FORWARD COMPATIBILITY
17989
17990 utf8 data, restricted hashes, files from future versions of Storable
17991
17992 =item ERROR REPORTING
17993
17994 =item WIZARDS ONLY
17995
17996 =over 4
17997
17998 =item Hooks
17999
18000 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18001 I<serialized>, ..
18002
18003 =item Predicates
18004
18005 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18006 C<Storable::is_retrieving>
18007
18008 =item Recursion
18009
18010 =item Deep Cloning
18011
18012 =back
18013
18014 =item Storable magic
18015
18016 =item EXAMPLES
18017
18018 =item WARNING
18019
18020 =item BUGS
18021
18022 =over 4
18023
18024 =item 64 bit data in perl 5.6.0 and 5.6.1
18025
18026 =back
18027
18028 =item CREDITS
18029
18030 =item AUTHOR
18031
18032 =item SEE ALSO
18033
18034 =back
18035
18036 =head2 Switch - A switch statement for Perl
18037
18038 =over 4
18039
18040 =item VERSION
18041
18042 =item SYNOPSIS
18043
18044 =item BACKGROUND
18045
18046 =item DESCRIPTION
18047
18048 =over 4
18049
18050 =item Allowing fall-through
18051
18052 =item Automating fall-through
18053
18054 =item Alternative syntax
18055
18056 =item Higher-order Operations
18057
18058 =back
18059
18060 =item DEPENDENCIES
18061
18062 =item AUTHOR
18063
18064 =item BUGS
18065
18066 =item LIMITATION
18067
18068 =item COPYRIGHT
18069
18070 =back
18071
18072 =head2 Symbol - manipulate Perl symbols and their names
18073
18074 =over 4
18075
18076 =item SYNOPSIS
18077
18078 =item DESCRIPTION
18079
18080 =back
18081
18082 =head2 Sys::Hostname - Try every conceivable way to get hostname
18083
18084 =over 4
18085
18086 =item SYNOPSIS
18087
18088 =item DESCRIPTION
18089
18090 =item AUTHOR
18091
18092 =back
18093
18094 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18095 interface to the UNIX syslog(3) calls
18096
18097 =over 4
18098
18099 =item SYNOPSIS
18100
18101 =item DESCRIPTION
18102
18103 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18104 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18105 in 5.004_02), closelog
18106
18107 =item EXAMPLES
18108
18109 =item SEE ALSO
18110
18111 =item AUTHOR
18112
18113 =back
18114
18115 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18116 Perl interface to the UNIX syslog(3) calls
18117
18118 =over 4
18119
18120 =item SYNOPSIS
18121
18122 =item DESCRIPTION
18123
18124 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18125 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18126 in 5.004_02), closelog
18127
18128 =item EXAMPLES
18129
18130 =item SEE ALSO
18131
18132 =item AUTHOR
18133
18134 =back
18135
18136 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18137
18138 =over 4
18139
18140 =item SYNOPSIS
18141
18142 =item DESCRIPTION
18143
18144 =item DIAGNOSTICS
18145
18146 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18147 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18148 comma allowed after filehandle, No name for escape sequence %s
18149
18150 =item ENVIRONMENT
18151
18152 ANSI_COLORS_DISABLED
18153
18154 =item RESTRICTIONS
18155
18156 =item NOTES
18157
18158 =item SEE ALSO
18159
18160 =item AUTHORS
18161
18162 =item LICENSE
18163
18164 =back
18165
18166 =head2 Term::Cap - Perl termcap interface
18167
18168 =over 4
18169
18170 =item SYNOPSIS
18171
18172 =item DESCRIPTION
18173
18174 =over 4
18175
18176 =item METHODS
18177
18178 =back
18179
18180 =back
18181
18182 B<Tgetent>, OSPEED, TERM
18183
18184 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18185
18186 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18187
18188 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18189
18190 B<Trequire>
18191
18192 =over 4
18193
18194 =item EXAMPLES
18195
18196 =item COPYRIGHT AND LICENSE
18197
18198 =item AUTHOR
18199
18200 =item SEE ALSO
18201
18202 =back
18203
18204 =head2 Term::Complete - Perl word completion module
18205
18206 =over 4
18207
18208 =item SYNOPSIS
18209
18210 =item DESCRIPTION
18211
18212 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18213
18214 =item DIAGNOSTICS
18215
18216 =item BUGS
18217
18218 =item AUTHOR
18219
18220 =back
18221
18222 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18223 no real package is found, substitutes stubs instead of basic functions.
18224
18225 =over 4
18226
18227 =item SYNOPSIS
18228
18229 =item DESCRIPTION
18230
18231 =item Minimal set of supported functions
18232
18233 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18234 C<MinLine>, C<findConsole>, Attribs, C<Features>
18235
18236 =item Additional supported functions
18237
18238 C<tkRunning>, C<ornaments>, C<newTTY>
18239
18240 =item EXPORTS
18241
18242 =item ENVIRONMENT
18243
18244 =item CAVEATS
18245
18246 =back
18247
18248 =head2 Test - provides a simple framework for writing test scripts
18249
18250 =over 4
18251
18252 =item SYNOPSIS
18253
18254 =item DESCRIPTION
18255
18256 =over 4
18257
18258 =item Functions
18259
18260 B<plan>
18261
18262 =back
18263
18264 =back
18265
18266 B<_to_value>
18267
18268 B<ok>
18269
18270 =over 4
18271
18272 =item TEST TYPES
18273
18274 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18275
18276 =item ONFAIL
18277
18278 =item BUGS and CAVEATS
18279
18280 =item NOTE
18281
18282 =item SEE ALSO
18283
18284 =item AUTHOR
18285
18286 =back
18287
18288 =head2 Test::Builder - Backend for building test libraries
18289
18290 =over 4
18291
18292 =item SYNOPSIS
18293
18294 =item DESCRIPTION
18295
18296 =over 4
18297
18298 =item Construction
18299
18300 B<new>
18301
18302 =back
18303
18304 =back
18305
18306 =over 4
18307
18308 =item Setting up tests
18309
18310 B<exported_to>
18311
18312 =back
18313
18314 B<plan>
18315
18316 B<expected_tests>
18317
18318 B<no_plan>
18319
18320 B<skip_all>
18321
18322 =over 4
18323
18324 =item Running tests
18325
18326 B<ok>
18327
18328 =back
18329
18330 B<is_eq>, B<is_num>
18331
18332 B<isnt_eq>, B<isnt_num>
18333
18334 B<like>, B<unlike>
18335
18336 B<maybe_regex>
18337
18338 B<cmp_ok>
18339
18340 B<BAILOUT>
18341
18342 B<skip>
18343
18344 B<todo_skip>
18345
18346 B<skip_rest>
18347
18348 =over 4
18349
18350 =item Test style
18351
18352 B<level>
18353
18354 =back
18355
18356 B<use_numbers>
18357
18358 B<no_header>, B<no_ending>
18359
18360 =over 4
18361
18362 =item Output
18363
18364 B<diag>
18365
18366 =back
18367
18368 B<_print>
18369
18370 B<output>, B<failure_output>, B<todo_output>
18371
18372 =over 4
18373
18374 =item Test Status and Info
18375
18376 B<current_test>
18377
18378 =back
18379
18380 B<summary>
18381
18382 B<details>  I<UNIMPLEMENTED>, B<todo>
18383
18384 B<caller>
18385
18386 B<_sanity_check>
18387
18388 B<_whoa>
18389
18390 B<_my_exit>
18391
18392 =over 4
18393
18394 =item EXAMPLES
18395
18396 =item SEE ALSO
18397
18398 =item AUTHORS
18399
18400 =item COPYRIGHT
18401
18402 =back
18403
18404 =head2 Test::Harness - run perl standard test scripts with statistics
18405
18406 =over 4
18407
18408 =item SYNOPSIS
18409
18410 =item DESCRIPTION
18411
18412 =over 4
18413
18414 =item The test script output
18415
18416 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18417 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18418 else>
18419
18420 =item Taint mode
18421
18422 =item Configuration variables.
18423
18424 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18425
18426 =item Failure
18427
18428 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18429 Failed>
18430
18431 =item Functions
18432
18433 B<runtests>
18434
18435 =back
18436
18437 =back
18438
18439 B<_all_ok>
18440
18441 B<_globdir>
18442
18443 B<_run_all_tests>
18444
18445 B<_mk_leader>
18446
18447 B<_leader_width>
18448
18449 =over 4
18450
18451 =item EXPORT
18452
18453 =item DIAGNOSTICS
18454
18455 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18456 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18457 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18458 %s>, C<FAILED--Further testing stopped: %s>
18459
18460 =item ENVIRONMENT
18461
18462 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18463 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18464 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18465
18466 =item EXAMPLE
18467
18468 =item SEE ALSO
18469
18470 =item AUTHORS
18471
18472 =item TODO
18473
18474 =item BUGS
18475
18476 =back
18477
18478 =head2 Test::Harness::Assert - simple assert
18479
18480 =over 4
18481
18482 =item SYNOPSIS
18483
18484 =item DESCRIPTION
18485
18486 =over 4
18487
18488 =item Functions
18489
18490 B<assert>
18491
18492 =back
18493
18494 =back
18495
18496 =over 4
18497
18498 =item AUTHOR
18499
18500 =item SEE ALSO
18501
18502 =back
18503
18504 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18505
18506 =over 4
18507
18508 =item SYNOPSIS
18509
18510 =item DESCRIPTION
18511
18512 =back
18513
18514 =head2 Test::Harness::Straps - detailed analysis of test results
18515
18516 =over 4
18517
18518 =item SYNOPSIS
18519
18520 =item DESCRIPTION
18521
18522 =over 4
18523
18524 =item Construction
18525
18526 B<new>
18527
18528 =back
18529
18530 =back
18531
18532 B<_init>
18533
18534 =over 4
18535
18536 =item Analysis
18537
18538 B<analyze>
18539
18540 =back
18541
18542 B<analyze_fh>
18543
18544 B<analyze_file>
18545
18546 B<_switches>
18547
18548 B<_INC2PERL5LIB>
18549
18550 B<_filtered_INC>
18551
18552 B<_restore_PERL5LIB>
18553
18554 =over 4
18555
18556 =item Parsing
18557
18558 B<_is_comment>
18559
18560 =back
18561
18562 B<_is_header>
18563
18564 B<_is_test>
18565
18566 B<_is_bail_out>
18567
18568 B<_reset_file_state>
18569
18570 =over 4
18571
18572 =item Results
18573
18574 B<_detailize>
18575
18576 =back
18577
18578 =over 4
18579
18580 =item EXAMPLES
18581
18582 =item AUTHOR
18583
18584 =item SEE ALSO
18585
18586 =back
18587
18588 =head2 Test::More - yet another framework for writing test scripts
18589
18590 =over 4
18591
18592 =item SYNOPSIS
18593
18594 =item DESCRIPTION
18595
18596 =over 4
18597
18598 =item I love it when a plan comes together
18599
18600 =back
18601
18602 =back
18603
18604 =over 4
18605
18606 =item Test names
18607
18608 =item I'm ok, you're not ok.
18609
18610 B<ok>
18611
18612 =back
18613
18614 B<is>, B<isnt>
18615
18616 B<like>
18617
18618 B<unlike>
18619
18620 B<cmp_ok>
18621
18622 B<can_ok>
18623
18624 B<isa_ok>
18625
18626 B<pass>, B<fail>
18627
18628 =over 4
18629
18630 =item Diagnostics
18631
18632 B<diag>
18633
18634 =back
18635
18636 =over 4
18637
18638 =item Module tests
18639
18640 B<use_ok>
18641
18642 =back
18643
18644 B<require_ok>
18645
18646 =over 4
18647
18648 =item Conditional tests
18649
18650 B<SKIP: BLOCK>
18651
18652 =back
18653
18654 B<TODO: BLOCK>, B<todo_skip>
18655
18656 =over 4
18657
18658 =item Comparison functions
18659
18660 B<is_deeply>
18661
18662 =back
18663
18664 B<eq_array>
18665
18666 B<eq_hash>
18667
18668 B<eq_set>
18669
18670 =over 4
18671
18672 =item Extending and Embedding Test::More
18673
18674 B<builder>
18675
18676 =back
18677
18678 =over 4
18679
18680 =item NOTES
18681
18682 =item BUGS and CAVEATS
18683
18684 Making your own ok(), The eq_* family has some caveats, Test::Harness
18685 upgrades
18686
18687 =item HISTORY
18688
18689 =item SEE ALSO
18690
18691 =item AUTHORS
18692
18693 =item COPYRIGHT
18694
18695 =back
18696
18697 =head2 Test::Simple - Basic utilities for writing tests.
18698
18699 =over 4
18700
18701 =item SYNOPSIS
18702
18703 =item DESCRIPTION
18704
18705 B<ok>
18706
18707 =back
18708
18709 =over 4
18710
18711 =item EXAMPLE
18712
18713 =item CAVEATS
18714
18715 =item NOTES
18716
18717 =item HISTORY
18718
18719 =item SEE ALSO
18720
18721 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18722 L<Test::Harness>
18723
18724 =item AUTHORS
18725
18726 =item COPYRIGHT
18727
18728 =back
18729
18730 =head2 Test::Tutorial - A tutorial about writing really basic tests
18731
18732 =over 4
18733
18734 =item DESCRIPTION
18735
18736 =over 4
18737
18738 =item Nuts and bolts of testing.
18739
18740 =item Where to start?
18741
18742 =item Names
18743
18744 =item Test the manual
18745
18746 =item Sometimes the tests are wrong
18747
18748 =item Testing lots of values
18749
18750 =item Informative names
18751
18752 =item Skipping tests
18753
18754 =item Todo tests
18755
18756 =item Testing with taint mode.
18757
18758 =back
18759
18760 =item FOOTNOTES
18761
18762 =item AUTHORS
18763
18764 =item COPYRIGHT
18765
18766 =back
18767
18768 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18769
18770 =over 4
18771
18772 =item SYNOPSIS
18773
18774 =item DESCRIPTION
18775
18776 =item EXAMPLE
18777
18778 =back
18779
18780 =head2 Text::Balanced - Extract delimited text sequences from strings.
18781
18782 =over 4
18783
18784 =item SYNOPSIS
18785
18786 =item DESCRIPTION
18787
18788 =over 4
18789
18790 =item General behaviour in list contexts
18791
18792 [0], [1], [2]
18793
18794 =item General behaviour in scalar and void contexts
18795
18796 =item A note about prefixes
18797
18798 =item C<extract_delimited>
18799
18800 =item C<extract_bracketed>
18801
18802 =item C<extract_tagged>
18803
18804 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18805 [0], [1], [2], [3], [4], [5]
18806
18807 =item C<gen_extract_tagged>
18808
18809 =item C<extract_quotelike>
18810
18811 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18812
18813 =item C<extract_quotelike> and "here documents"
18814
18815 [0], [1], [2], [3], [4], [5], [6], [7..10]
18816
18817 =item C<extract_codeblock>
18818
18819 =item C<extract_multiple>
18820
18821 =item C<gen_delimited_pat>
18822
18823 =back
18824
18825 =item DIAGNOSTICS
18826
18827  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
18828 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18829 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
18830 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18831 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18832 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18833 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18834 after dereferencer>, C<Did not find expected opening bracket at %s>,
18835 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18836 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18837 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18838 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18839 tag>
18840
18841 =item AUTHOR
18842
18843 =item BUGS AND IRRITATIONS
18844
18845 =item COPYRIGHT
18846
18847 =back
18848
18849 =head2 Text::ParseWords - parse text into an array of tokens or array of
18850 arrays
18851
18852 =over 4
18853
18854 =item SYNOPSIS
18855
18856 =item DESCRIPTION
18857
18858 =item EXAMPLES
18859
18860 =item AUTHORS
18861
18862 =back
18863
18864 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18865 by Knuth
18866
18867 =over 4
18868
18869 =item SYNOPSIS
18870
18871 =item DESCRIPTION
18872
18873 =item EXAMPLES
18874
18875 =item LIMITATIONS
18876
18877 =item AUTHOR
18878
18879 =back
18880
18881 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18882 unexpand(1)
18883
18884 =over 4
18885
18886 =item SYNOPSIS
18887
18888 =item DESCRIPTION
18889
18890 =item BUGS
18891
18892 =item AUTHOR
18893
18894 =back
18895
18896 =head2 Text::Wrap - line wrapping to form simple paragraphs
18897
18898 =over 4
18899
18900 =item SYNOPSIS
18901
18902 =item DESCRIPTION
18903
18904 =item OVERRIDES
18905
18906 =item EXAMPLE
18907
18908 =item AUTHOR
18909
18910 =back
18911
18912 =head2 Thread - manipulate threads in Perl (for old code only)
18913
18914 =over 4
18915
18916 =item CAVEAT
18917
18918 =item SYNOPSIS
18919
18920 =item DESCRIPTION
18921
18922 =item FUNCTIONS
18923
18924 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18925 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18926 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18927
18928 =item METHODS
18929
18930 join, eval, detach, equal, tid, flags, done
18931
18932 =item LIMITATIONS
18933
18934 =item SEE ALSO
18935
18936 =back
18937
18938 =head2 Thread::Queue - thread-safe queues (for old code only)
18939
18940 =over 4
18941
18942 =item CAVEAT
18943
18944 =item SYNOPSIS
18945
18946 =item DESCRIPTION
18947
18948 =item FUNCTIONS AND METHODS
18949
18950 new, enqueue LIST, dequeue, dequeue_nb, pending
18951
18952 =item SEE ALSO
18953
18954 =back
18955
18956 =head2 Thread::Semaphore - thread-safe semaphores (for old code only)
18957
18958 =over 4
18959
18960 =item CAVEAT
18961
18962 =item SYNOPSIS
18963
18964 =item DESCRIPTION
18965
18966 =item FUNCTIONS AND METHODS
18967
18968 new, new NUMBER, down, down NUMBER, up, up NUMBER
18969
18970 =back
18971
18972 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18973
18974 =over 4
18975
18976 =item SYNOPSIS
18977
18978 =item DESCRIPTION
18979
18980 =item BUGS
18981
18982 =back
18983
18984 =head2 Thread::Specific - thread-specific keys
18985
18986 =over 4
18987
18988 =item SYNOPSIS
18989
18990 =item DESCRIPTION
18991
18992 =back
18993
18994 =head2 Tie::Array - base class for tied arrays
18995
18996 =over 4
18997
18998 =item SYNOPSIS
18999
19000 =item DESCRIPTION
19001
19002 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19003 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19004 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19005 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19006
19007 =item CAVEATS
19008
19009 =item AUTHOR
19010
19011 =back
19012
19013 =head2 Tie::File - Access the lines of a disk file via a Perl array
19014
19015 =over 4
19016
19017 =item SYNOPSIS
19018
19019 =item DESCRIPTION
19020
19021 =over 4
19022
19023 =item C<recsep>
19024
19025 =item C<autochomp>
19026
19027 =item C<mode>
19028
19029 =item C<memory>
19030
19031 =item C<dw_size>
19032
19033 =item Option Format
19034
19035 =back
19036
19037 =item Public Methods
19038
19039 =over 4
19040
19041 =item C<flock>
19042
19043 =item C<autochomp>
19044
19045 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19046
19047 =back
19048
19049 =item Tying to an already-opened filehandle
19050
19051 =item Deferred Writing
19052
19053 =over 4
19054
19055 =item Autodeferring
19056
19057 =back
19058
19059 =item CAVEATS
19060
19061 =item SUBCLASSING
19062
19063 =item WHAT ABOUT C<DB_File>?
19064
19065 =item AUTHOR
19066
19067 =item LICENSE
19068
19069 =item WARRANTY
19070
19071 =item THANKS
19072
19073 =item TODO
19074
19075 =back
19076
19077 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19078 handles
19079
19080 =over 4
19081
19082 =item SYNOPSIS
19083
19084 =item DESCRIPTION
19085
19086 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19087 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19088 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19089 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19090
19091 =item MORE INFORMATION
19092
19093 =item COMPATIBILITY
19094
19095 =back
19096
19097 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19098 tied hashes
19099
19100 =over 4
19101
19102 =item SYNOPSIS
19103
19104 =item DESCRIPTION
19105
19106 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19107 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19108
19109 =item Inheriting from B<Tie::StdHash>
19110
19111 =item Inheriting from B<Tie::ExtraHash>
19112
19113 =item C<UNTIE> and C<DESTROY>
19114
19115 =item MORE INFORMATION
19116
19117 =back
19118
19119 =head2 Tie::Memoize - add data to hash when needed
19120
19121 =over 4
19122
19123 =item SYNOPSIS
19124
19125 =item DESCRIPTION
19126
19127 =item Inheriting from B<Tie::Memoize>
19128
19129 =item EXAMPLE
19130
19131 =item BUGS
19132
19133 =item AUTHOR
19134
19135 =back
19136
19137 =head2 Tie::RefHash - use references as hash keys
19138
19139 =over 4
19140
19141 =item SYNOPSIS
19142
19143 =item DESCRIPTION
19144
19145 =item EXAMPLE
19146
19147 =item AUTHOR
19148
19149 =item VERSION
19150
19151 =item SEE ALSO
19152
19153 =back
19154
19155 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19156 scalars
19157
19158 =over 4
19159
19160 =item SYNOPSIS
19161
19162 =item DESCRIPTION
19163
19164 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19165
19166 =item MORE INFORMATION
19167
19168 =back
19169
19170 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19171
19172 =over 4
19173
19174 =item SYNOPSIS
19175
19176 =item DESCRIPTION
19177
19178 =item CAVEATS
19179
19180 =back
19181
19182 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19183 timers
19184
19185 =over 4
19186
19187 =item SYNOPSIS
19188
19189 =item DESCRIPTION
19190
19191 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19192 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19193 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19194 getitimer ( $which )
19195
19196 =item EXAMPLES
19197
19198 =item C API
19199
19200 =item CAVEATS
19201
19202 =item AUTHORS
19203
19204 =item REVISION
19205
19206 =item COPYRIGHT
19207
19208 =back
19209
19210 =head2 Time::Local - efficiently compute time from local and GMT time
19211
19212 =over 4
19213
19214 =item SYNOPSIS
19215
19216 =item DESCRIPTION
19217
19218 =item IMPLEMENTATION
19219
19220 =item BUGS
19221
19222 =back
19223
19224 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19225 function
19226
19227 =over 4
19228
19229 =item SYNOPSIS
19230
19231 =item DESCRIPTION
19232
19233 =item NOTE
19234
19235 =item AUTHOR
19236
19237 =back
19238
19239 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19240 function
19241
19242 =over 4
19243
19244 =item SYNOPSIS
19245
19246 =item DESCRIPTION
19247
19248 =item NOTE
19249
19250 =item AUTHOR
19251
19252 =back
19253
19254 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19255
19256 =over 4
19257
19258 =item SYNOPSIS
19259
19260 =item DESCRIPTION
19261
19262 =item AUTHOR
19263
19264 =back
19265
19266 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19267
19268 =over 4
19269
19270 =item SYNOPSIS
19271
19272 =item DESCRIPTION
19273
19274 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19275 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19276
19277 =back
19278
19279 =head2 Unicode::Collate - Unicode Collation Algorithm
19280
19281 =over 4
19282
19283 =item SYNOPSIS
19284
19285 =item DESCRIPTION
19286
19287 =over 4
19288
19289 =item Constructor and Tailoring
19290
19291 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19292 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19293 undefChar, katakana_before_hiragana, upper_before_lower
19294
19295 =item Methods for Collation
19296
19297 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19298 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19299 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19300 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19301 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19302 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19303 $Collator-E<gt>viewSortKey($string)>, C<$position =
19304 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19305 $Collator-E<gt>index($string, $substring)>
19306
19307 =item Other Methods
19308
19309 UCA_Version, Base_Unicode_Version
19310
19311 =item EXPORT
19312
19313 =item TODO
19314
19315 =item CAVEAT
19316
19317 =item BUGS
19318
19319 =back
19320
19321 =item AUTHOR
19322
19323 =item SEE ALSO
19324
19325 http://www.unicode.org/unicode/reports/tr10/,
19326 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19327 http://www.unicode.org/unicode/reports/tr15/,
19328 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19329
19330 =back
19331
19332 =head2 Unicode::Normalize - Unicode Normalization Forms
19333
19334 =over 4
19335
19336 =item SYNOPSIS
19337
19338 =item DESCRIPTION
19339
19340 =over 4
19341
19342 =item Normalization Forms
19343
19344 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19345 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19346 C<$normalized_string = normalize($form_name, $string)>
19347
19348 =item Decomposition and Composition
19349
19350 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19351 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19352 reorder($string)>, C<$composed_string   = compose($string)>
19353
19354 =item Quick Check
19355
19356 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19357 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19358 check($form_name, $string)>
19359
19360 =item Character Data
19361
19362 C<$canonical_decomposed = getCanon($codepoint)>,
19363 C<$compatibility_decomposed = getCompat($codepoint)>,
19364 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19365 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19366 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19367 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19368 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19369
19370 =item EXPORT
19371
19372 =back
19373
19374 =item AUTHOR
19375
19376 =item SEE ALSO
19377
19378 http://www.unicode.org/unicode/reports/tr15/,
19379 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19380
19381 =back
19382
19383 =head2 Unicode::UCD - Unicode character database
19384
19385 =over 4
19386
19387 =item SYNOPSIS
19388
19389 =item DESCRIPTION
19390
19391 =back
19392
19393 =over 4
19394
19395 =item charinfo
19396
19397 =back
19398
19399 =over 4
19400
19401 =item charblock
19402
19403 =back
19404
19405 =over 4
19406
19407 =item charscript
19408
19409 =back
19410
19411 =over 4
19412
19413 =item charblocks
19414
19415 =back
19416
19417 =over 4
19418
19419 =item charscripts
19420
19421 =back
19422
19423 =over 4
19424
19425 =item Blocks versus Scripts
19426
19427 =item Matching Scripts and Blocks
19428
19429 =item Code Point Arguments
19430
19431 =item charinrange
19432
19433 =back
19434
19435 =over 4
19436
19437 =item compexcl
19438
19439 =back
19440
19441 =over 4
19442
19443 =item casefold
19444
19445 =back
19446
19447 =over 4
19448
19449 =item casespec
19450
19451 =back
19452
19453 =over 4
19454
19455 =item Unicode::UCD::UnicodeVersion
19456
19457 =back
19458
19459 =over 4
19460
19461 =item Implementation Note
19462
19463 =back
19464
19465 =over 4
19466
19467 =item BUGS
19468
19469 =item AUTHOR
19470
19471 =back
19472
19473 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19474 functions
19475
19476 =over 4
19477
19478 =item SYNOPSIS
19479
19480 =item DESCRIPTION
19481
19482 =item NOTE
19483
19484 =item AUTHOR
19485
19486 =back
19487
19488 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19489 functions
19490
19491 =over 4
19492
19493 =item SYNOPSIS
19494
19495 =item DESCRIPTION
19496
19497 =over 4
19498
19499 =item System Specifics
19500
19501 =back
19502
19503 =item NOTE
19504
19505 =item AUTHOR
19506
19507 =item HISTORY
19508
19509 March 18th, 2000
19510
19511 =back
19512
19513 =head2 Win32 - Interfaces to some Win32 API Functions
19514
19515 =over 4
19516
19517 =item DESCRIPTION
19518
19519 =over 4
19520
19521 =item Alphabetical Listing of Win32 Functions
19522
19523 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19524 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19525 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19526 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19527 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19528 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19529 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19530 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19531 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19532 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19533 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19534 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19535 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19536 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19537 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19538 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19539 Win32::UnregisterServer(LIBRARYNAME)
19540
19541 =back
19542
19543 =back
19544
19545 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
19546
19547 =over 4
19548
19549 =item SYNOPSIS
19550
19551 =item DESCRIPTION
19552
19553 =back
19554
19555 =over 4
19556
19557 =item NOTES
19558
19559 =item AUTHOR
19560
19561 =back
19562
19563 =head2 XSLoader - Dynamically load C libraries into Perl code
19564
19565 =over 4
19566
19567 =item SYNOPSIS
19568
19569 =item DESCRIPTION
19570
19571 =item AUTHOR
19572
19573 =back
19574
19575 =head1 AUXILIARY DOCUMENTATION
19576
19577 Here should be listed all the extra programs' documentation, but they
19578 don't all have manual pages yet:
19579
19580 =over 4
19581
19582 =item a2p
19583
19584 =item s2p
19585
19586 =item find2perl
19587
19588 =item h2ph
19589
19590 =item c2ph
19591
19592 =item h2xs
19593
19594 =item xsubpp
19595
19596 =item pod2man
19597
19598 =item wrapsuid
19599
19600 =back
19601
19602 =head1 AUTHOR
19603
19604 Larry Wall <F<larry@wall.org>>, with the help of oodles
19605 of other folks.
19606