pod/perltoc.pod

   1
   2 =head1 NAME
   3
   4 perltoc - perl documentation table of contents
   5
   6 =head1 DESCRIPTION
   7
   8 This page provides a brief table of contents for the rest of the Perl
   9 documentation set.  It is meant to be scanned quickly or grepped
  10 through to locate the proper section you're looking for.
  11
  12 =head1 BASIC DOCUMENTATION
  13
  14 =head2 perl - Practical Extraction and Report Language
  15
  16 =over 4
  17
  18 =item SYNOPSIS
  19
  20 =over 4
  21
  22 =item Overview
  23
  24 =item Tutorials
  25
  26 =item Reference Manual
  27
  28 =item Internals and C Language Interface
  29
  30 =item Miscellaneous
  31
  32 =item Language-Specific
  33
  34 =item Platform-Specific
  35
  36 =back
  37
  38 =item DESCRIPTION
  39
  40 =item AVAILABILITY
  41
  42 =item ENVIRONMENT
  43
  44 =item AUTHOR
  45
  46 =item FILES
  47
  48 =item SEE ALSO
  49
  50 =item DIAGNOSTICS
  51
  52 =item BUGS
  53
  54 =item NOTES
  55
  56 =back
  57
  58 =head2 perlintro -- a brief introduction and overview of Perl
  59
  60 =over 4
  61
  62 =item DESCRIPTION
  63
  64 =over 4
  65
  66 =item What is Perl?
  67
  68 =item Running Perl programs
  69
  70 =item Basic syntax overview
  71
  72 =item Perl variable types
  73
  74 Scalars, Arrays, Hashes
  75
  76 =item Variable scoping
  77
  78 =item Conditional and looping constructs
  79
  80 if, while, for, foreach
  81
  82 =item Builtin operators and functions
  83
  84 Arithmetic, Numeric comparison, String comparison, Boolean logic,
  85 Miscellaneous
  86
  87 =item Files and I/O
  88
  89 =item Regular expressions
  90
  91 Simple matching, Simple substitution, More complex regular expressions,
  92 Parentheses for capturing, Other regexp features
  93
  94 =item Writing subroutines
  95
  96 =item OO Perl
  97
  98 =item Using Perl modules
  99
 100 =back
 101
 102 =item AUTHOR
 103
 104 =back
 105
 106 =head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31
 107 17:37:17 $)
 108
 109 =over 4
 110
 111 =item DESCRIPTION
 112
 113 =over 4
 114
 115 =item Where to get the perlfaq
 116
 117 =item How to contribute to the perlfaq
 118
 119 =item What will happen if you mail your Perl programming problems to the
 120 authors
 121
 122 =back
 123
 124 =item Credits
 125
 126 =item Author and Copyright Information
 127
 128 =over 4
 129
 130 =item Bundled Distributions
 131
 132 =item Disclaimer
 133
 134 =back
 135
 136 =item Table of Contents
 137
 138 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
 139 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
 140 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
 141 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
 142 Interaction, perlfaq9 - Networking
 143
 144 =item The Questions
 145
 146 =over 4
 147
 148 =item L<perlfaq1>: General Questions About Perl
 149
 150 =item L<perlfaq2>: Obtaining and Learning about Perl
 151
 152 =item L<perlfaq3>: Programming Tools
 153
 154 =item L<perlfaq4>: Data Manipulation
 155
 156 =item L<perlfaq5>: Files and Formats
 157
 158 =item L<perlfaq6>: Regular Expressions
 159
 160 =item L<perlfaq7>: General Perl Language Issues
 161
 162 =item L<perlfaq8>: System Interaction
 163
 164 =item L<perlfaq9>: Networking
 165
 166 =back
 167
 168 =back
 169
 170 =head2 perlbook - Perl book information
 171
 172 =over 4
 173
 174 =item DESCRIPTION
 175
 176 =back
 177
 178 =head2 perlsyn - Perl syntax
 179
 180 =over 4
 181
 182 =item DESCRIPTION
 183
 184 =over 4
 185
 186 =item Declarations
 187
 188 =item Comments
 189
 190 =item Simple Statements
 191
 192 =item Compound Statements
 193
 194 =item Loop Control
 195
 196 =item For Loops
 197
 198 =item Foreach Loops
 199
 200 =item Basic BLOCKs and Switch Statements
 201
 202 =item Goto
 203
 204 =item PODs: Embedded Documentation
 205
 206 =item Plain Old Comments (Not!)
 207
 208 =back
 209
 210 =back
 211
 212 =head2 perldata - Perl data types
 213
 214 =over 4
 215
 216 =item DESCRIPTION
 217
 218 =over 4
 219
 220 =item Variable names
 221
 222 =item Context
 223
 224 =item Scalar values
 225
 226 =item Scalar value constructors
 227
 228 =item List value constructors
 229
 230 =item Subscripts
 231
 232 =item Slices
 233
 234 =item Typeglobs and Filehandles
 235
 236 =back
 237
 238 =item SEE ALSO
 239
 240 =back
 241
 242 =head2 perlop - Perl operators and precedence
 243
 244 =over 4
 245
 246 =item SYNOPSIS
 247
 248 =item DESCRIPTION
 249
 250 =over 4
 251
 252 =item Terms and List Operators (Leftward)
 253
 254 =item The Arrow Operator
 255
 256 =item Auto-increment and Auto-decrement
 257
 258 =item Exponentiation
 259
 260 =item Symbolic Unary Operators
 261
 262 =item Binding Operators
 263
 264 =item Multiplicative Operators
 265
 266 =item Additive Operators
 267
 268 =item Shift Operators
 269
 270 =item Named Unary Operators
 271
 272 =item Relational Operators
 273
 274 =item Equality Operators
 275
 276 =item Bitwise And
 277
 278 =item Bitwise Or and Exclusive Or
 279
 280 =item C-style Logical And
 281
 282 =item C-style Logical Or
 283
 284 =item C-style Logical Defined-Or
 285
 286 =item Range Operators
 287
 288 =item Conditional Operator
 289
 290 =item Assignment Operators
 291
 292 =item Comma Operator
 293
 294 =item List Operators (Rightward)
 295
 296 =item Logical Not
 297
 298 =item Logical And
 299
 300 =item Logical or, Defined or, and Exclusive Or
 301
 302 =item C Operators Missing From Perl
 303
 304 unary &, unary *, (TYPE)
 305
 306 =item Quote and Quote-like Operators
 307
 308 =item Regexp Quote-Like Operators
 309
 310 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 311 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 312 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 313 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 314
 315 =item Gory details of parsing quoted constructs
 316
 317 Finding the end, Removal of backslashes before delimiters, Interpolation,
 318 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 319 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 320 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 321 regular expressions
 322
 323 =item I/O Operators
 324
 325 =item Constant Folding
 326
 327 =item Bitwise String Operators
 328
 329 =item Integer Arithmetic
 330
 331 =item Floating-point Arithmetic
 332
 333 =item Bigger Numbers
 334
 335 =back
 336
 337 =back
 338
 339 =head2 perlsub - Perl subroutines
 340
 341 =over 4
 342
 343 =item SYNOPSIS
 344
 345 =item DESCRIPTION
 346
 347 =over 4
 348
 349 =item Private Variables via my()
 350
 351 =item Persistent Private Variables
 352
 353 =item Temporary Values via local()
 354
 355 =item Lvalue subroutines
 356
 357 Lvalue subroutines are EXPERIMENTAL
 358
 359 =item Passing Symbol Table Entries (typeglobs)
 360
 361 =item When to Still Use local()
 362
 363 =item Pass by Reference
 364
 365 =item Prototypes
 366
 367 =item Constant Functions
 368
 369 =item Overriding Built-in Functions
 370
 371 =item Autoloading
 372
 373 =item Subroutine Attributes
 374
 375 =back
 376
 377 =item SEE ALSO
 378
 379 =back
 380
 381 =head2 perlfunc - Perl builtin functions
 382
 383 =over 4
 384
 385 =item DESCRIPTION
 386
 387 =over 4
 388
 389 =item Perl Functions by Category
 390
 391 Functions for SCALARs or strings, Regular expressions and pattern matching,
 392 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 393 Functions for real %HASHes, Input and output functions, Functions for fixed
 394 length data or records, Functions for filehandles, files, or directories,
 395 Keywords related to the control flow of your perl program, Keywords related
 396 to scoping, Miscellaneous functions, Functions for processes and process
 397 groups, Keywords related to perl modules, Keywords related to classes and
 398 object-orientedness, Low-level socket functions, System V interprocess
 399 communication functions, Fetching user and group info, Fetching network
 400 info, Time-related functions, Functions new in perl5, Functions obsoleted
 401 in perl5
 402
 403 =item Portability
 404
 405 =item Alphabetical Listing of Perl Functions
 406
 407 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
 408 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 409 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
 410 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
 411 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
 412 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
 413 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 414 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
 415 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
 416 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
 417 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
 418 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
 419 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
 420 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
 421 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
 422 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
 423 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
 424 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
 425 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
 426 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
 427 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
 428 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
 429 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
 430 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 431 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 432 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 433 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
 434 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
 435 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
 436 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
 437 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
 438 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
 439 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
 440 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
 441 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
 442 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
 443 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
 444 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
 445 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
 446 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
 447 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 448 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 449 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 450 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
 451 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
 452 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
 453 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
 454 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
 455 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 456 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 457 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 458 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 459 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 460 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 461 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 462 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 463 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 464 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
 465 parameter index, flags, vector flag, (minimum) width, precision, or maximum
 466 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
 467 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
 468 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
 469 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 470 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 471 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 472 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 473 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 474 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 475 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 476 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 477 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 478 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 479 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
 480 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
 481 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
 482 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
 483
 484 =back
 485
 486 =back
 487
 488 =head2 perlreftut - Mark's very short tutorial about references
 489
 490 =over 4
 491
 492 =item DESCRIPTION
 493
 494 =item Who Needs Complicated Data Structures?
 495
 496 =item The Solution
 497
 498 =item Syntax
 499
 500 =over 4
 501
 502 =item Making References
 503
 504 =item Using References
 505
 506 =item An Example
 507
 508 =item Arrow Rule
 509
 510 =back
 511
 512 =item Solution
 513
 514 =item The Rest
 515
 516 =item Summary
 517
 518 =item Credits
 519
 520 =over 4
 521
 522 =item Distribution Conditions
 523
 524 =back
 525
 526 =back
 527
 528 =head2 perldsc - Perl Data Structures Cookbook
 529
 530 =over 4
 531
 532 =item DESCRIPTION
 533
 534 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 535 more elaborate constructs
 536
 537 =item REFERENCES
 538
 539 =item COMMON MISTAKES
 540
 541 =item CAVEAT ON PRECEDENCE
 542
 543 =item WHY YOU SHOULD ALWAYS C<use strict>
 544
 545 =item DEBUGGING
 546
 547 =item CODE EXAMPLES
 548
 549 =item ARRAYS OF ARRAYS
 550
 551 =over 4
 552
 553 =item Declaration of an ARRAY OF ARRAYS
 554
 555 =item Generation of an ARRAY OF ARRAYS
 556
 557 =item Access and Printing of an ARRAY OF ARRAYS
 558
 559 =back
 560
 561 =item HASHES OF ARRAYS
 562
 563 =over 4
 564
 565 =item Declaration of a HASH OF ARRAYS
 566
 567 =item Generation of a HASH OF ARRAYS
 568
 569 =item Access and Printing of a HASH OF ARRAYS
 570
 571 =back
 572
 573 =item ARRAYS OF HASHES
 574
 575 =over 4
 576
 577 =item Declaration of an ARRAY OF HASHES
 578
 579 =item Generation of an ARRAY OF HASHES
 580
 581 =item Access and Printing of an ARRAY OF HASHES
 582
 583 =back
 584
 585 =item HASHES OF HASHES
 586
 587 =over 4
 588
 589 =item Declaration of a HASH OF HASHES
 590
 591 =item Generation of a HASH OF HASHES
 592
 593 =item Access and Printing of a HASH OF HASHES
 594
 595 =back
 596
 597 =item MORE ELABORATE RECORDS
 598
 599 =over 4
 600
 601 =item Declaration of MORE ELABORATE RECORDS
 602
 603 =item Declaration of a HASH OF COMPLEX RECORDS
 604
 605 =item Generation of a HASH OF COMPLEX RECORDS
 606
 607 =back
 608
 609 =item Database Ties
 610
 611 =item SEE ALSO
 612
 613 =item AUTHOR
 614
 615 =back
 616
 617 =head2 perlrequick - Perl regular expressions quick start
 618
 619 =over 4
 620
 621 =item DESCRIPTION
 622
 623 =item The Guide
 624
 625 =over 4
 626
 627 =item Simple word matching
 628
 629 =item Using character classes
 630
 631 =item Matching this or that
 632
 633 =item Grouping things and hierarchical matching
 634
 635 =item Extracting matches
 636
 637 =item Matching repetitions
 638
 639 =item More matching
 640
 641 =item Search and replace
 642
 643 =item The split operator
 644
 645 =back
 646
 647 =item BUGS
 648
 649 =item SEE ALSO
 650
 651 =item AUTHOR AND COPYRIGHT
 652
 653 =over 4
 654
 655 =item Acknowledgments
 656
 657 =back
 658
 659 =back
 660
 661 =head2 perlpod - the Plain Old Documentation format
 662
 663 =over 4
 664
 665 =item DESCRIPTION
 666
 667 =over 4
 668
 669 =item Ordinary Paragraph
 670
 671 =item Verbatim Paragraph
 672
 673 =item Command Paragraph
 674
 675 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 676 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 677 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 678 I<formatname>>, C<=for I<formatname> I<text...>>
 679
 680 =item Formatting Codes
 681
 682 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 683 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 684 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 685 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 686 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 687 (zero-effect) formatting code
 688
 689 =item The Intent
 690
 691 =item Embedding Pods in Perl Modules
 692
 693 =item Hints for Writing Pod
 694
 695 =back
 696
 697 =item SEE ALSO
 698
 699 =item AUTHOR
 700
 701 =back
 702
 703 =head2 perlpodspec - Plain Old Documentation: format specification and
 704 notes
 705
 706 =over 4
 707
 708 =item DESCRIPTION
 709
 710 =item Pod Definitions
 711
 712 =item Pod Commands
 713
 714 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 715 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 716
 717 =item Pod Formatting Codes
 718
 719 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 720 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 721 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 722 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 723 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 724 contains non-breaking spaces
 725
 726 =item Notes on Implementing Pod Processors
 727
 728 =item About LE<lt>...E<gt> Codes
 729
 730 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 731
 732 =item About =over...=back Regions
 733
 734 =item About Data Paragraphs and "=begin/=end" Regions
 735
 736 =item SEE ALSO
 737
 738 =item AUTHOR
 739
 740 =back
 741
 742 =head2 perlstyle - Perl style guide
 743
 744 =over 4
 745
 746 =item DESCRIPTION
 747
 748 =back
 749
 750 =head2 perltrap - Perl traps for the unwary
 751
 752 =over 4
 753
 754 =item DESCRIPTION
 755
 756 =over 4
 757
 758 =item Awk Traps
 759
 760 =item C/C++ Traps
 761
 762 =item Sed Traps
 763
 764 =item Shell Traps
 765
 766 =item Perl Traps
 767
 768 =item Perl4 to Perl5 Traps
 769
 770 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 771 Traps, General data type traps, Context Traps - scalar, list contexts,
 772 Precedence Traps, General Regular Expression Traps using s///, etc,
 773 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 774
 775 =item Discontinuance, Deprecation, and BugFix traps
 776
 777 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 778 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 779 Discontinuance, Deprecation, Discontinuance, Discontinuance
 780
 781 =item Parsing Traps
 782
 783 Parsing, Parsing, Parsing, Parsing, Parsing
 784
 785 =item Numerical Traps
 786
 787 Numerical, Numerical, Numerical, Bitwise string ops
 788
 789 =item General data type traps
 790
 791 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 792 (Constants), (Scalars), (Variable Suicide)
 793
 794 =item Context Traps - scalar, list contexts
 795
 796 (list context), (scalar context), (scalar context), (list, builtin)
 797
 798 =item Precedence Traps
 799
 800 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 801 Precedence
 802
 803 =item General Regular Expression Traps using s///, etc.
 804
 805 Regular Expression, Regular Expression, Regular Expression, Regular
 806 Expression, Regular Expression, Regular Expression, Regular Expression,
 807 Regular Expression, Regular Expression
 808
 809 =item Subroutine, Signal, Sorting Traps
 810
 811 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 812
 813 =item OS Traps
 814
 815 (SysV), (SysV)
 816
 817 =item Interpolation Traps
 818
 819 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 820 Interpolation, Interpolation, Interpolation, Interpolation
 821
 822 =item DBM Traps
 823
 824 DBM, DBM
 825
 826 =item Unclassified Traps
 827
 828 C<require>/C<do> trap using returned value, C<split> on empty string with
 829 LIMIT specified
 830
 831 =back
 832
 833 =back
 834
 835 =head2 perlcheat - Perl 5 Cheat Sheet
 836
 837 =over 4
 838
 839 =item DESCRIPTION
 840
 841 =over 4
 842
 843 =item The sheet
 844
 845 =back
 846
 847 =item ACKNOWLEDGEMENTS
 848
 849 =item AUTHOR
 850
 851 =item SEE ALSO
 852
 853 =back
 854
 855 =head2 perlrun - how to execute the Perl interpreter
 856
 857 =over 4
 858
 859 =item SYNOPSIS
 860
 861 =item DESCRIPTION
 862
 863 =over 4
 864
 865 =item #! and quoting on non-Unix systems
 866
 867 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 868
 869 =item Location of Perl
 870
 871 =item Command Switches
 872
 873 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
 874 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
 875 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
 876 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 877 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 878 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 879 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 880 B<-X>, B<-x> I<directory>
 881
 882 =back
 883
 884 =item ENVIRONMENT
 885
 886 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 887 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 888 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 889 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
 890 PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
 891 (specific to the VMS port)
 892
 893 =back
 894
 895 =head2 perldiag - various Perl diagnostics
 896
 897 =over 4
 898
 899 =item DESCRIPTION
 900
 901 =back
 902
 903 =head2 perllexwarn - Perl Lexical Warnings
 904
 905 =over 4
 906
 907 =item DESCRIPTION
 908
 909 =over 4
 910
 911 =item Default Warnings and Optional Warnings
 912
 913 =item What's wrong with B<-w> and C<$^W>
 914
 915 =item Controlling Warnings from the Command Line
 916
 917 B<-w>, B<-W>, B<-X>
 918
 919 =item Backward Compatibility
 920
 921 =item Category Hierarchy
 922
 923 =item Fatal Warnings
 924
 925 =item Reporting Warnings from a Module
 926
 927 =back
 928
 929 =item TODO
 930
 931 =item SEE ALSO
 932
 933 =item AUTHOR
 934
 935 =back
 936
 937 =head2 perldebtut - Perl debugging tutorial
 938
 939 =over 4
 940
 941 =item DESCRIPTION
 942
 943 =item use strict
 944
 945 =item Looking at data and -w and v
 946
 947 =item help
 948
 949 =item Stepping through code
 950
 951 =item Placeholder for a, w, t, T
 952
 953 =item REGULAR EXPRESSIONS
 954
 955 =item OUTPUT TIPS
 956
 957 =item CGI
 958
 959 =item GUIs
 960
 961 =item SUMMARY
 962
 963 =item SEE ALSO
 964
 965 =item AUTHOR
 966
 967 =item CONTRIBUTORS
 968
 969 =back
 970
 971 =head2 perldebug - Perl debugging
 972
 973 =over 4
 974
 975 =item DESCRIPTION
 976
 977 =item The Perl Debugger
 978
 979 =over 4
 980
 981 =item Debugger Commands
 982
 983 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 984 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 985 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 986 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 987 subname [condition], b postpone subname [condition], b load filename, b
 988 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 989 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 990 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
 991 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
 992 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
 993 [manpage]
 994
 995 =item Configurable Options
 996
 997 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 998 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 999 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
1000 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
1001 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
1002 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
1003 C<NonStop>
1004
1005 =item Debugger input/output
1006
1007 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
1008 listing
1009
1010 =item Debugging compile-time statements
1011
1012 =item Debugger Customization
1013
1014 =item Readline Support
1015
1016 =item Editor Support for Debugging
1017
1018 =item The Perl Profiler
1019
1020 =back
1021
1022 =item Debugging regular expressions
1023
1024 =item Debugging memory usage
1025
1026 =item SEE ALSO
1027
1028 =item BUGS
1029
1030 =back
1031
1032 =head2 perlvar - Perl predefined variables
1033
1034 =over 4
1035
1036 =item DESCRIPTION
1037
1038 =over 4
1039
1040 =item Predefined Names
1041
1042 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1043 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
1044 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1045 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1046 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1047 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1048 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1049 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1050 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1051 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1052 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1053 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1054 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1055 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1056 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1057 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1058 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1059 IO::Handle->format_line_break_characters EXPR,
1060 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1061 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1062 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1063 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1064 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1065 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1066 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1067 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1068 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
1069 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
1070 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
1071 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
1072 $SIG{expr}
1073
1074 =item Error Indicators
1075
1076 =item Technical Note on the Syntax of Variable Names
1077
1078 =back
1079
1080 =item BUGS
1081
1082 =back
1083
1084 =head2 perllol - Manipulating Arrays of Arrays in Perl
1085
1086 =over 4
1087
1088 =item DESCRIPTION
1089
1090 =over 4
1091
1092 =item Declaration and Access of Arrays of Arrays
1093
1094 =item Growing Your Own
1095
1096 =item Access and Printing
1097
1098 =item Slices
1099
1100 =back
1101
1102 =item SEE ALSO
1103
1104 =item AUTHOR
1105
1106 =back
1107
1108 =head2 perlopentut - tutorial on opening things in Perl
1109
1110 =over 4
1111
1112 =item DESCRIPTION
1113
1114 =item Open E<agrave> la shell
1115
1116 =over 4
1117
1118 =item Simple Opens
1119
1120 =item Indirect Filehandles
1121
1122 =item Pipe Opens
1123
1124 =item The Minus File
1125
1126 =item Mixing Reads and Writes
1127
1128 =item Filters
1129
1130 =back
1131
1132 =item Open E<agrave> la C
1133
1134 =over 4
1135
1136 =item Permissions E<agrave> la mode
1137
1138 =back
1139
1140 =item Obscure Open Tricks
1141
1142 =over 4
1143
1144 =item Re-Opening Files (dups)
1145
1146 =item Dispelling the Dweomer
1147
1148 =item Paths as Opens
1149
1150 =item Single Argument Open
1151
1152 =item Playing with STDIN and STDOUT
1153
1154 =back
1155
1156 =item Other I/O Issues
1157
1158 =over 4
1159
1160 =item Opening Non-File Files
1161
1162 =item Opening Named Pipes
1163
1164 =item Opening Sockets
1165
1166 =item Binary Files
1167
1168 =item File Locking
1169
1170 =item IO Layers
1171
1172 =back
1173
1174 =item SEE ALSO
1175
1176 =item AUTHOR and COPYRIGHT
1177
1178 =item HISTORY
1179
1180 =back
1181
1182 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1183
1184 =over 4
1185
1186 =item DESCRIPTION
1187
1188 =item The Basic Principle
1189
1190 =item Packing Text
1191
1192 =item Packing Numbers
1193
1194 =over 4
1195
1196 =item Integers
1197
1198 =item Unpacking a Stack Frame
1199
1200 =item How to Eat an Egg on a Net
1201
1202 =item Floating point Numbers
1203
1204 =back
1205
1206 =item Exotic Templates
1207
1208 =over 4
1209
1210 =item Bit Strings
1211
1212 =item Uuencoding
1213
1214 =item Doing Sums
1215
1216 =item  Unicode
1217
1218 =item Another Portable Binary Encoding
1219
1220 =back
1221
1222 =item Template Grouping
1223
1224 =item Lengths and Widths
1225
1226 =over 4
1227
1228 =item String Lengths
1229
1230 =item Dynamic Templates
1231
1232 =item Counting Repetitions
1233
1234 =back
1235
1236 =item Packing and Unpacking C Structures
1237
1238 =over 4
1239
1240 =item The Alignment Pit
1241
1242 =item Alignment, Take 2
1243
1244 =item Alignment, Take 3
1245
1246 =item Pointers for How to Use Them
1247
1248 =back
1249
1250 =item Pack Recipes
1251
1252 =item Funnies Section
1253
1254 =item Authors
1255
1256 =back
1257
1258 =head2 perlretut - Perl regular expressions tutorial
1259
1260 =over 4
1261
1262 =item DESCRIPTION
1263
1264 =item Part 1: The basics
1265
1266 =over 4
1267
1268 =item Simple word matching
1269
1270 =item Using character classes
1271
1272 =item Matching this or that
1273
1274 =item Grouping things and hierarchical matching
1275
1276 =item Extracting matches
1277
1278 =item Matching repetitions
1279
1280 =item Building a regexp
1281
1282 =item Using regular expressions in Perl
1283
1284 =back
1285
1286 =item Part 2: Power tools
1287
1288 =over 4
1289
1290 =item More on characters, strings, and character classes
1291
1292 =item Compiling and saving regular expressions
1293
1294 =item Embedding comments and modifiers in a regular expression
1295
1296 =item Non-capturing groupings
1297
1298 =item Looking ahead and looking behind
1299
1300 =item Using independent subexpressions to prevent backtracking
1301
1302 =item Conditional expressions
1303
1304 =item A bit of magic: executing Perl code in a regular expression
1305
1306 =item Pragmas and debugging
1307
1308 =back
1309
1310 =item BUGS
1311
1312 =item SEE ALSO
1313
1314 =item AUTHOR AND COPYRIGHT
1315
1316 =over 4
1317
1318 =item Acknowledgments
1319
1320 =back
1321
1322 =back
1323
1324 =head2 perlre - Perl regular expressions
1325
1326 =over 4
1327
1328 =item DESCRIPTION
1329
1330 i, m, s, x
1331
1332 =over 4
1333
1334 =item Regular Expressions
1335
1336 [1], [2], [3], cntrl, graph, print, punct, xdigit
1337
1338 =item Extended Patterns
1339
1340 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1341 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1342 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1343 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1344
1345 =item Backtracking
1346
1347 =item Version 8 Regular Expressions
1348
1349 =item Warning on \1 vs $1
1350
1351 =item Repeated patterns matching zero-length substring
1352
1353 =item Combining pieces together
1354
1355 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1356 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1357 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1358 C<(?(condition)yes-pattern|no-pattern)>
1359
1360 =item Creating custom RE engines
1361
1362 =back
1363
1364 =item BUGS
1365
1366 =item SEE ALSO
1367
1368 =back
1369
1370 =head2 perlreref - Perl Regular Expressions Reference
1371
1372 =over 4
1373
1374 =item DESCRIPTION
1375
1376 =over 4
1377
1378 =item OPERATORS
1379
1380 =item SYNTAX
1381
1382 =item ESCAPE SEQUENCES
1383
1384 =item CHARACTER CLASSES
1385
1386 =item ANCHORS
1387
1388 =item QUANTIFIERS
1389
1390 =item EXTENDED CONSTRUCTS
1391
1392 =item VARIABLES
1393
1394 =item FUNCTIONS
1395
1396 =item TERMINOLOGY
1397
1398 =back
1399
1400 =item AUTHOR
1401
1402 =item SEE ALSO
1403
1404 =item THANKS
1405
1406 =back
1407
1408 =head2 perlref - Perl references and nested data structures
1409
1410 =over 4
1411
1412 =item NOTE
1413
1414 =item DESCRIPTION
1415
1416 =over 4
1417
1418 =item Making References
1419
1420 =item Using References
1421
1422 =item Symbolic references
1423
1424 =item Not-so-symbolic references
1425
1426 =item Pseudo-hashes: Using an array as a hash
1427
1428 =item Function Templates
1429
1430 =back
1431
1432 =item WARNING
1433
1434 =item SEE ALSO
1435
1436 =back
1437
1438 =head2 perlform - Perl formats
1439
1440 =over 4
1441
1442 =item DESCRIPTION
1443
1444 =over 4
1445
1446 =item Format Variables
1447
1448 =back
1449
1450 =item NOTES
1451
1452 =over 4
1453
1454 =item Footers
1455
1456 =item Accessing Formatting Internals
1457
1458 =back
1459
1460 =item WARNINGS
1461
1462 =back
1463
1464 =head2 perlboot - Beginner's Object-Oriented Tutorial
1465
1466 =over 4
1467
1468 =item DESCRIPTION
1469
1470 =over 4
1471
1472 =item If we could talk to the animals...
1473
1474 =item Introducing the method invocation arrow
1475
1476 =item Invoking a barnyard
1477
1478 =item The extra parameter of method invocation
1479
1480 =item Calling a second method to simplify things
1481
1482 =item Inheriting the windpipes
1483
1484 =item A few notes about @ISA
1485
1486 =item Overriding the methods
1487
1488 =item Starting the search from a different place
1489
1490 =item The SUPER way of doing things
1491
1492 =item Where we're at so far...
1493
1494 =item A horse is a horse, of course of course -- or is it?
1495
1496 =item Invoking an instance method
1497
1498 =item Accessing the instance data
1499
1500 =item How to build a horse
1501
1502 =item Inheriting the constructor
1503
1504 =item Making a method work with either classes or instances
1505
1506 =item Adding parameters to a method
1507
1508 =item More interesting instances
1509
1510 =item A horse of a different color
1511
1512 =item Summary
1513
1514 =back
1515
1516 =item SEE ALSO
1517
1518 =item COPYRIGHT
1519
1520 =back
1521
1522 =head2 perltoot - Tom's object-oriented tutorial for perl
1523
1524 =over 4
1525
1526 =item DESCRIPTION
1527
1528 =item Creating a Class
1529
1530 =over 4
1531
1532 =item Object Representation
1533
1534 =item Class Interface
1535
1536 =item Constructors and Instance Methods
1537
1538 =item Planning for the Future: Better Constructors
1539
1540 =item Destructors
1541
1542 =item Other Object Methods
1543
1544 =back
1545
1546 =item Class Data
1547
1548 =over 4
1549
1550 =item Accessing Class Data
1551
1552 =item Debugging Methods
1553
1554 =item Class Destructors
1555
1556 =item Documenting the Interface
1557
1558 =back
1559
1560 =item Aggregation
1561
1562 =item Inheritance
1563
1564 =over 4
1565
1566 =item Overridden Methods
1567
1568 =item Multiple Inheritance
1569
1570 =item UNIVERSAL: The Root of All Objects
1571
1572 =back
1573
1574 =item Alternate Object Representations
1575
1576 =over 4
1577
1578 =item Arrays as Objects
1579
1580 =item Closures as Objects
1581
1582 =back
1583
1584 =item AUTOLOAD: Proxy Methods
1585
1586 =over 4
1587
1588 =item Autoloaded Data Methods
1589
1590 =item Inherited Autoloaded Data Methods
1591
1592 =back
1593
1594 =item Metaclassical Tools
1595
1596 =over 4
1597
1598 =item Class::Struct
1599
1600 =item Data Members as Variables
1601
1602 =back
1603
1604 =item NOTES
1605
1606 =over 4
1607
1608 =item Object Terminology
1609
1610 =back
1611
1612 =item SEE ALSO
1613
1614 =item AUTHOR AND COPYRIGHT
1615
1616 =item COPYRIGHT
1617
1618 =over 4
1619
1620 =item Acknowledgments
1621
1622 =back
1623
1624 =back
1625
1626 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1627
1628 =over 4
1629
1630 =item DESCRIPTION
1631
1632 =item Class Data in a Can
1633
1634 =item Class Data as Package Variables
1635
1636 =over 4
1637
1638 =item Putting All Your Eggs in One Basket
1639
1640 =item Inheritance Concerns
1641
1642 =item The Eponymous Meta-Object
1643
1644 =item Indirect References to Class Data
1645
1646 =item Monadic Classes
1647
1648 =item Translucent Attributes
1649
1650 =back
1651
1652 =item Class Data as Lexical Variables
1653
1654 =over 4
1655
1656 =item Privacy and Responsibility
1657
1658 =item File-Scoped Lexicals
1659
1660 =item More Inheritance Concerns
1661
1662 =item Locking the Door and Throwing Away the Key
1663
1664 =item Translucency Revisited
1665
1666 =back
1667
1668 =item NOTES
1669
1670 =item SEE ALSO
1671
1672 =item AUTHOR AND COPYRIGHT
1673
1674 =item ACKNOWLEDGEMENTS
1675
1676 =item HISTORY
1677
1678 =back
1679
1680 =head2 perlobj - Perl objects
1681
1682 =over 4
1683
1684 =item DESCRIPTION
1685
1686 =over 4
1687
1688 =item An Object is Simply a Reference
1689
1690 =item A Class is Simply a Package
1691
1692 =item A Method is Simply a Subroutine
1693
1694 =item Method Invocation
1695
1696 =item Indirect Object Syntax
1697
1698 =item Default UNIVERSAL methods
1699
1700 isa(CLASS), can(METHOD), VERSION( [NEED] )
1701
1702 =item Destructors
1703
1704 =item Summary
1705
1706 =item Two-Phased Garbage Collection
1707
1708 =back
1709
1710 =item SEE ALSO
1711
1712 =back
1713
1714 =head2 perlbot - Bag'o Object Tricks (the BOT)
1715
1716 =over 4
1717
1718 =item DESCRIPTION
1719
1720 =item OO SCALING TIPS
1721
1722 =item INSTANCE VARIABLES
1723
1724 =item SCALAR INSTANCE VARIABLES
1725
1726 =item INSTANCE VARIABLE INHERITANCE
1727
1728 =item OBJECT RELATIONSHIPS
1729
1730 =item OVERRIDING SUPERCLASS METHODS
1731
1732 =item USING RELATIONSHIP WITH SDBM
1733
1734 =item THINKING OF CODE REUSE
1735
1736 =item CLASS CONTEXT AND THE OBJECT
1737
1738 =item INHERITING A CONSTRUCTOR
1739
1740 =item DELEGATION
1741
1742 =item SEE ALSO
1743
1744 =back
1745
1746 =head2 perltie - how to hide an object class in a simple variable
1747
1748 =over 4
1749
1750 =item SYNOPSIS
1751
1752 =item DESCRIPTION
1753
1754 =over 4
1755
1756 =item Tying Scalars
1757
1758 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1759 DESTROY this
1760
1761 =item Tying Arrays
1762
1763 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1764 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1765 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1766 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1767 this
1768
1769 =item Tying Hashes
1770
1771 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1772 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1773 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1774
1775 =item Tying FileHandles
1776
1777 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1778 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1779 DESTROY this
1780
1781 =item UNTIE this
1782
1783 =item The C<untie> Gotcha
1784
1785 =back
1786
1787 =item SEE ALSO
1788
1789 =item BUGS
1790
1791 =item AUTHOR
1792
1793 =back
1794
1795 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1796 safe subprocesses, sockets, and semaphores)
1797
1798 =over 4
1799
1800 =item DESCRIPTION
1801
1802 =item Signals
1803
1804 =over 4
1805
1806 =item Handling the SIGHUP Signal in Daemons
1807
1808 =back
1809
1810 =item Named Pipes
1811
1812 =over 4
1813
1814 =item Deferred Signals (Safe signals)
1815
1816 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
1817 "faults", Signals triggered by operating system state
1818
1819 =back
1820
1821 =item Using open() for IPC
1822
1823 =over 4
1824
1825 =item Filehandles
1826
1827 =item Background Processes
1828
1829 =item Complete Dissociation of Child from Parent
1830
1831 =item Safe Pipe Opens
1832
1833 =item Bidirectional Communication with Another Process
1834
1835 =item Bidirectional Communication with Yourself
1836
1837 =back
1838
1839 =item Sockets: Client/Server Communication
1840
1841 =over 4
1842
1843 =item Internet Line Terminators
1844
1845 =item Internet TCP Clients and Servers
1846
1847 =item Unix-Domain TCP Clients and Servers
1848
1849 =back
1850
1851 =item TCP Clients with IO::Socket
1852
1853 =over 4
1854
1855 =item A Simple Client
1856
1857 C<Proto>, C<PeerAddr>, C<PeerPort>
1858
1859 =item A Webget Client
1860
1861 =item Interactive Client with IO::Socket
1862
1863 =back
1864
1865 =item TCP Servers with IO::Socket
1866
1867 Proto, LocalPort, Listen, Reuse
1868
1869 =item UDP: Message Passing
1870
1871 =item SysV IPC
1872
1873 =item NOTES
1874
1875 =item BUGS
1876
1877 =item AUTHOR
1878
1879 =item SEE ALSO
1880
1881 =back
1882
1883 =head2 perlfork - Perl's fork() emulation
1884
1885 =over 4
1886
1887 =item SYNOPSIS
1888
1889 =item DESCRIPTION
1890
1891 =over 4
1892
1893 =item Behavior of other Perl features in forked pseudo-processes
1894
1895 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1896 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1897 files, directories and network sockets
1898
1899 =item Resource limits
1900
1901 =item Killing the parent process
1902
1903 =item Lifetime of the parent process and pseudo-processes
1904
1905 =item CAVEATS AND LIMITATIONS
1906
1907 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1908 Global state maintained by XSUBs, Interpreter embedded in larger
1909 application, Thread-safety of extensions
1910
1911 =back
1912
1913 =item BUGS
1914
1915 =item AUTHOR
1916
1917 =item SEE ALSO
1918
1919 =back
1920
1921 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1922
1923 =over 4
1924
1925 =item SYNOPSIS
1926
1927 =item DESCRIPTION
1928
1929 =item Storing numbers
1930
1931 =item Numeric operators and numeric conversions
1932
1933 =item Flavors of Perl numeric operations
1934
1935 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
1936 mathematical operators, Bitwise operators, Bitwise operators during C<use
1937 integer>, Operators which expect an integer, Operators which expect a
1938 string
1939
1940 =item AUTHOR
1941
1942 =item SEE ALSO
1943
1944 =back
1945
1946 =head2 perlthrtut - tutorial on threads in Perl
1947
1948 =over 4
1949
1950 =item DESCRIPTION
1951
1952 =item Status
1953
1954 =item What Is A Thread Anyway?
1955
1956 =item Threaded Program Models
1957
1958 =over 4
1959
1960 =item Boss/Worker
1961
1962 =item Work Crew
1963
1964 =item Pipeline
1965
1966 =back
1967
1968 =item What kind of threads are Perl threads?
1969
1970 =item Thread-Safe Modules
1971
1972 =item Thread Basics
1973
1974 =over 4
1975
1976 =item Basic Thread Support
1977
1978 =item A Note about the Examples
1979
1980 =item Creating Threads
1981
1982 =item Waiting For A Thread To Exit
1983
1984 =item Ignoring A Thread
1985
1986 =back
1987
1988 =item Threads And Data
1989
1990 =over 4
1991
1992 =item Shared And Unshared Data
1993
1994 =item Thread Pitfalls: Races
1995
1996 =back
1997
1998 =item Synchronization and control
1999
2000 =over 4
2001
2002 =item Controlling access: lock()
2003
2004 =item A Thread Pitfall: Deadlocks
2005
2006 =item Queues: Passing Data Around
2007
2008 =item Semaphores: Synchronizing Data Access
2009
2010 =item Basic semaphores
2011
2012 =item Advanced Semaphores
2013
2014 =item cond_wait() and cond_signal()
2015
2016 =item Giving up control
2017
2018 =back
2019
2020 =item General Thread Utility Routines
2021
2022 =over 4
2023
2024 =item What Thread Am I In?
2025
2026 =item Thread IDs
2027
2028 =item Are These Threads The Same?
2029
2030 =item What Threads Are Running?
2031
2032 =back
2033
2034 =item A Complete Example
2035
2036 =item Different implementations of threads
2037
2038 =item Performance considerations
2039
2040 =item Process-scope Changes
2041
2042 =item Thread-Safety of System Libraries
2043
2044 =item Conclusion
2045
2046 =item Bibliography
2047
2048 =over 4
2049
2050 =item Introductory Texts
2051
2052 =item OS-Related References
2053
2054 =item Other References
2055
2056 =back
2057
2058 =item Acknowledgements
2059
2060 =item AUTHOR
2061
2062 =item Copyrights
2063
2064 =back
2065
2066 =head2 perlothrtut - old tutorial on threads in Perl
2067
2068 =over 4
2069
2070 =item DESCRIPTION
2071
2072 =item What Is A Thread Anyway?
2073
2074 =item Threaded Program Models
2075
2076 =over 4
2077
2078 =item Boss/Worker
2079
2080 =item Work Crew
2081
2082 =item Pipeline
2083
2084 =back
2085
2086 =item Native threads
2087
2088 =item What kind of threads are perl threads?
2089
2090 =item Threadsafe Modules
2091
2092 =item Thread Basics
2093
2094 =over 4
2095
2096 =item Basic Thread Support
2097
2098 =item Creating Threads
2099
2100 =item Giving up control
2101
2102 =item Waiting For A Thread To Exit
2103
2104 =item Errors In Threads
2105
2106 =item Ignoring A Thread
2107
2108 =back
2109
2110 =item Threads And Data
2111
2112 =over 4
2113
2114 =item Shared And Unshared Data
2115
2116 =item Thread Pitfall: Races
2117
2118 =item Controlling access: lock()
2119
2120 =item Thread Pitfall: Deadlocks
2121
2122 =item Queues: Passing Data Around
2123
2124 =back
2125
2126 =item Threads And Code
2127
2128 =over 4
2129
2130 =item Semaphores: Synchronizing Data Access
2131
2132 Basic semaphores, Advanced Semaphores
2133
2134 =item Attributes: Restricting Access To Subroutines
2135
2136 =item Subroutine Locks
2137
2138 =item Methods
2139
2140 =item Locking A Subroutine
2141
2142 =back
2143
2144 =item General Thread Utility Routines
2145
2146 =over 4
2147
2148 =item What Thread Am I In?
2149
2150 =item Thread IDs
2151
2152 =item Are These Threads The Same?
2153
2154 =item What Threads Are Running?
2155
2156 =back
2157
2158 =item A Complete Example
2159
2160 =item Conclusion
2161
2162 =item Bibliography
2163
2164 =over 4
2165
2166 =item Introductory Texts
2167
2168 =item OS-Related References
2169
2170 =item Other References
2171
2172 =back
2173
2174 =item Acknowledgements
2175
2176 =item AUTHOR
2177
2178 =item Copyrights
2179
2180 =back
2181
2182 =head2 perlport - Writing portable Perl
2183
2184 =over 4
2185
2186 =item DESCRIPTION
2187
2188 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2189 portable
2190
2191 =item ISSUES
2192
2193 =over 4
2194
2195 =item Newlines
2196
2197 =item Numbers endianness and Width
2198
2199 =item Files and Filesystems
2200
2201 =item System Interaction
2202
2203 =item Command names versus file pathnames
2204
2205 =item Networking
2206
2207 =item Interprocess Communication (IPC)
2208
2209 =item External Subroutines (XS)
2210
2211 =item Standard Modules
2212
2213 =item Time and Date
2214
2215 =item Character sets and character encoding
2216
2217 =item Internationalisation
2218
2219 =item System Resources
2220
2221 =item Security
2222
2223 =item Style
2224
2225 =back
2226
2227 =item CPAN Testers
2228
2229 Mailing list: cpan-testers@perl.org, Testing results:
2230 http://testers.cpan.org/
2231
2232 =item PLATFORMS
2233
2234 =over 4
2235
2236 =item Unix
2237
2238 =item DOS and Derivatives
2239
2240 =item S<Mac OS>
2241
2242 =item VMS
2243
2244 =item VOS
2245
2246 =item EBCDIC Platforms
2247
2248 =item Acorn RISC OS
2249
2250 =item Other perls
2251
2252 =back
2253
2254 =item FUNCTION IMPLEMENTATIONS
2255
2256 =over 4
2257
2258 =item Alphabetical Listing of Perl Functions
2259
2260 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2261 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2262 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2263 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2264 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2265 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2266 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2267 getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
2268 getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
2269 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
2270 endhostent, endnetent, endprotoent, endservent, getsockopt
2271 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
2272 kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
2273 lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
2274 ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
2275 READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
2276 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
2277 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2278 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2279 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2280 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2281 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2282 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2283 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2284 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2285 wait, waitpid PID,FLAGS
2286
2287 =back
2288
2289 =item CHANGES
2290
2291 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
2292 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
2293 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
2294 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
2295 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
2296 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
2297
2298 =item Supported Platforms
2299
2300 =item SEE ALSO
2301
2302 =item AUTHORS / CONTRIBUTORS
2303
2304 =back
2305
2306 =head2 perllocale - Perl locale handling (internationalization and
2307 localization)
2308
2309 =over 4
2310
2311 =item DESCRIPTION
2312
2313 =item PREPARING TO USE LOCALES
2314
2315 =item USING LOCALES
2316
2317 =over 4
2318
2319 =item The use locale pragma
2320
2321 =item The setlocale function
2322
2323 =item Finding locales
2324
2325 =item LOCALE PROBLEMS
2326
2327 =item Temporarily fixing locale problems
2328
2329 =item Permanently fixing locale problems
2330
2331 =item Permanently fixing your system's locale configuration
2332
2333 =item Fixing system locale configuration
2334
2335 =item The localeconv function
2336
2337 =item I18N::Langinfo
2338
2339 =back
2340
2341 =item LOCALE CATEGORIES
2342
2343 =over 4
2344
2345 =item Category LC_COLLATE: Collation
2346
2347 =item Category LC_CTYPE: Character Types
2348
2349 =item Category LC_NUMERIC: Numeric Formatting
2350
2351 =item Category LC_MONETARY: Formatting of monetary amounts
2352
2353 =item LC_TIME
2354
2355 =item Other categories
2356
2357 =back
2358
2359 =item SECURITY
2360
2361 =item ENVIRONMENT
2362
2363 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2364 LC_NUMERIC, LC_TIME, LANG
2365
2366 =item NOTES
2367
2368 =over 4
2369
2370 =item Backward compatibility
2371
2372 =item I18N:Collate obsolete
2373
2374 =item Sort speed and memory use impacts
2375
2376 =item write() and LC_NUMERIC
2377
2378 =item Freely available locale definitions
2379
2380 =item I18n and l10n
2381
2382 =item An imperfect standard
2383
2384 =back
2385
2386 =item Unicode and UTF-8
2387
2388 =item BUGS
2389
2390 =over 4
2391
2392 =item Broken systems
2393
2394 =back
2395
2396 =item SEE ALSO
2397
2398 =item HISTORY
2399
2400 =back
2401
2402 =head2 perluniintro - Perl Unicode introduction
2403
2404 =over 4
2405
2406 =item DESCRIPTION
2407
2408 =over 4
2409
2410 =item Unicode
2411
2412 =item Perl's Unicode Support
2413
2414 =item Perl's Unicode Model
2415
2416 =item Unicode and EBCDIC
2417
2418 =item Creating Unicode
2419
2420 =item Handling Unicode
2421
2422 =item Legacy Encodings
2423
2424 =item Unicode I/O
2425
2426 =item Displaying Unicode As Text
2427
2428 =item Special Cases
2429
2430 =item Advanced Topics
2431
2432 =item Miscellaneous
2433
2434 =item Questions With Answers
2435
2436 =item Hexadecimal Notation
2437
2438 =item Further Resources
2439
2440 =back
2441
2442 =item UNICODE IN OLDER PERLS
2443
2444 =item SEE ALSO
2445
2446 =item ACKNOWLEDGMENTS
2447
2448 =item AUTHOR, COPYRIGHT, AND LICENSE
2449
2450 =back
2451
2452 =head2 perlunicode - Unicode support in Perl
2453
2454 =over 4
2455
2456 =item DESCRIPTION
2457
2458 =over 4
2459
2460 =item Important Caveats
2461
2462 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
2463 enable UTF-8/UTF-EBCDIC in scripts
2464
2465 =item Byte and Character Semantics
2466
2467 =item Effects of Character Semantics
2468
2469 =item Scripts
2470
2471 =item Blocks
2472
2473 =item User-Defined Character Properties
2474
2475 =item Character Encodings for Input and Output
2476
2477 =item Unicode Regular Expression Support Level
2478
2479 =item Unicode Encodings
2480
2481 =item Security Implications of Unicode
2482
2483 =item Unicode in Perl on EBCDIC
2484
2485 =item Locales
2486
2487 =item When Unicode Does Not Happen
2488
2489 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
2490
2491 =item Using Unicode in XS
2492
2493 =back
2494
2495 =item BUGS
2496
2497 =over 4
2498
2499 =item Interaction with Locales
2500
2501 =item Interaction with Extensions
2502
2503 =item Speed
2504
2505 =item Porting code from perl-5.6.X
2506
2507 =back
2508
2509 =item SEE ALSO
2510
2511 =back
2512
2513 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2514
2515 =over 4
2516
2517 =item DESCRIPTION
2518
2519 =item COMMON CHARACTER CODE SETS
2520
2521 =over 4
2522
2523 =item ASCII
2524
2525 =item ISO 8859
2526
2527 =item Latin 1 (ISO 8859-1)
2528
2529 =item EBCDIC
2530
2531 =item 13 variant characters
2532
2533 =item 0037
2534
2535 =item 1047
2536
2537 =item POSIX-BC
2538
2539 =item Unicode code points versus EBCDIC code points
2540
2541 =item Remaining Perl Unicode problems in EBCDIC
2542
2543 =item Unicode and UTF
2544
2545 =item Using Encode
2546
2547 =back
2548
2549 =item SINGLE OCTET TABLES
2550
2551 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2552
2553 =item IDENTIFYING CHARACTER CODE SETS
2554
2555 =item CONVERSIONS
2556
2557 =over 4
2558
2559 =item tr///
2560
2561 =item iconv
2562
2563 =item C RTL
2564
2565 =back
2566
2567 =item OPERATOR DIFFERENCES
2568
2569 =item FUNCTION DIFFERENCES
2570
2571 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2572
2573 =item REGULAR EXPRESSION DIFFERENCES
2574
2575 =item SOCKETS
2576
2577 =item SORTING
2578
2579 =over 4
2580
2581 =item Ignore ASCII vs. EBCDIC sort differences.
2582
2583 =item MONO CASE then sort data.
2584
2585 =item Convert, sort data, then re convert.
2586
2587 =item Perform sorting on one type of machine only.
2588
2589 =back
2590
2591 =item TRANSFORMATION FORMATS
2592
2593 =over 4
2594
2595 =item URL decoding and encoding
2596
2597 =item uu encoding and decoding
2598
2599 =item Quoted-Printable encoding and decoding
2600
2601 =item Caesarian ciphers
2602
2603 =back
2604
2605 =item Hashing order and checksums
2606
2607 =item I18N AND L10N
2608
2609 =item MULTI OCTET CHARACTER SETS
2610
2611 =item OS ISSUES
2612
2613 =over 4
2614
2615 =item OS/400
2616
2617 PASE, IFS access
2618
2619 =item OS/390, z/OS
2620
2621 chcp, dataset access, OS/390, z/OS iconv, locales
2622
2623 =item VM/ESA?
2624
2625 =item POSIX-BC?
2626
2627 =back
2628
2629 =item BUGS
2630
2631 =item SEE ALSO
2632
2633 =item REFERENCES
2634
2635 =item HISTORY
2636
2637 =item AUTHOR
2638
2639 =back
2640
2641 =head2 perlsec - Perl security
2642
2643 =over 4
2644
2645 =item DESCRIPTION
2646
2647 =over 4
2648
2649 =item Laundering and Detecting Tainted Data
2650
2651 =item Switches On the "#!" Line
2652
2653 =item Cleaning Up Your Path
2654
2655 =item Security Bugs
2656
2657 =item Protecting Your Programs
2658
2659 =item Unicode
2660
2661 =item Algorithmic Complexity Attacks
2662
2663 =back
2664
2665 =item SEE ALSO
2666
2667 =back
2668
2669 =head2 perlmod - Perl modules (packages and symbol tables)
2670
2671 =over 4
2672
2673 =item DESCRIPTION
2674
2675 =over 4
2676
2677 =item Packages
2678
2679 =item Symbol Tables
2680
2681 =item Package Constructors and Destructors
2682
2683 =item Perl Classes
2684
2685 =item Perl Modules
2686
2687 =item Making your module threadsafe
2688
2689 =back
2690
2691 =item SEE ALSO
2692
2693 =back
2694
2695 =head2 perlmodinstall - Installing CPAN Modules
2696
2697 =over 4
2698
2699 =item DESCRIPTION
2700
2701 =over 4
2702
2703 =item PREAMBLE
2704
2705 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2706 module (sometimes unnecessary), B<INSTALL> the module
2707
2708 =back
2709
2710 =item PORTABILITY
2711
2712 =item HEY
2713
2714 =item AUTHOR
2715
2716 =item COPYRIGHT
2717
2718 =back
2719
2720 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2721
2722 =over 4
2723
2724 =item THE PERL MODULE LIBRARY
2725
2726 =over 4
2727
2728 =item Pragmatic Modules
2729
2730 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
2731 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
2732 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
2733 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
2734 vmsish, warnings, warnings::register
2735
2736 =item Standard Modules
2737
2738 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2739 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2740 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2741 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2742 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2743 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2744 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
2745 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
2746 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
2747 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
2748 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
2749 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
2750 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
2751 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
2752 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
2753 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
2754 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2755 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
2756 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
2757 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2758 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
2759 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
2760 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
2761 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
2762 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
2763 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
2764 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
2765 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
2766 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
2767 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
2768 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
2769 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
2770 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
2771 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
2772 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
2773 Locale::Currency, Locale::Language, Locale::Maketext,
2774 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
2775 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
2776 Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex,
2777 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
2778 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
2779 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
2780 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
2781 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
2782 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
2783 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
2784 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
2785 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
2786 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
2787 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
2788 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
2789 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
2790 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
2791 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
2792 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
2793 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
2794 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
2795 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
2796 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
2797 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
2798 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
2799 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
2800 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
2801 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
2802 XSLoader
2803
2804 =item Extension Modules
2805
2806 =back
2807
2808 =item CPAN
2809
2810 =over 4
2811
2812 =item Africa
2813
2814 South Africa
2815
2816 =item Asia
2817
2818 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
2819 Arabia, Singapore, South Korea, Taiwan
2820
2821 =item Central America
2822
2823 Costa Rica
2824
2825 =item Europe
2826
2827 Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia,
2828 Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
2829 Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia,
2830 Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United
2831 Kingdom
2832
2833 =item North America
2834
2835 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
2836 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
2837 Illinois, Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey,
2838 New York, North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
2839 Utah, Virginia, Washington, Wisconsin
2840
2841 =item Oceania
2842
2843 Australia, New Zealand, United States
2844
2845 =item South America
2846
2847 Argentina, Brazil, Chile
2848
2849 =item RSYNC Mirrors
2850
2851 =back
2852
2853 =item Modules: Creation, Use, and Abuse
2854
2855 =over 4
2856
2857 =item Guidelines for Module Creation
2858
2859 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2860
2861 =item Guidelines for Reusing Application Code
2862
2863 =back
2864
2865 =item NOTE
2866
2867 =back
2868
2869 =head2 perlmodstyle - Perl module style guide
2870
2871 =over 4
2872
2873 =item INTRODUCTION
2874
2875 =item QUICK CHECKLIST
2876
2877 =over 4
2878
2879 =item Before you start
2880
2881 =item The API
2882
2883 =item Stability
2884
2885 =item Documentation
2886
2887 =item Release considerations
2888
2889 =back
2890
2891 =item BEFORE YOU START WRITING A MODULE
2892
2893 =over 4
2894
2895 =item Has it been done before?
2896
2897 =item Do one thing and do it well
2898
2899 =item What's in a name?
2900
2901 =back
2902
2903 =item DESIGNING AND WRITING YOUR MODULE
2904
2905 =over 4
2906
2907 =item To OO or not to OO?
2908
2909 =item Designing your API
2910
2911 Write simple routines to do simple things, Separate functionality from
2912 output, Provide sensible shortcuts and defaults, Naming conventions,
2913 Parameter passing
2914
2915 =item Strictness and warnings
2916
2917 =item Backwards compatibility
2918
2919 =item Error handling and messages
2920
2921 =back
2922
2923 =item DOCUMENTING YOUR MODULE
2924
2925 =over 4
2926
2927 =item POD
2928
2929 =item README, INSTALL, release notes, changelogs
2930
2931 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
2932 perl Build test, perl Build install
2933
2934 =back
2935
2936 =item RELEASE CONSIDERATIONS
2937
2938 =over 4
2939
2940 =item Version numbering
2941
2942 =item Pre-requisites
2943
2944 =item Testing
2945
2946 =item Packaging
2947
2948 =item Licensing
2949
2950 =back
2951
2952 =item COMMON PITFALLS
2953
2954 =over 4
2955
2956 =item Reinventing the wheel
2957
2958 =item Trying to do too much
2959
2960 =item Inappropriate documentation
2961
2962 =back
2963
2964 =item SEE ALSO
2965
2966 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
2967 Testing tools, http://pause.perl.org/, Any good book on software
2968 engineering
2969
2970 =item AUTHOR
2971
2972 =back
2973
2974 =head2 perlnewmod - preparing a new module for distribution
2975
2976 =over 4
2977
2978 =item DESCRIPTION
2979
2980 =over 4
2981
2982 =item Warning
2983
2984 =item What should I make into a module?
2985
2986 =item Step-by-step: Preparing the ground
2987
2988 Look around, Check it's new, Discuss the need, Choose a name, Check again
2989
2990 =item Step-by-step: Making the module
2991
2992 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2993 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2994 documentation|perlpod>, Write tests, Write the README
2995
2996 =item Step-by-step: Distributing your module
2997
2998 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2999 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3000
3001 =back
3002
3003 =item AUTHOR
3004
3005 =item SEE ALSO
3006
3007 =back
3008
3009 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
3010 2003/07/09 15:47:28 $)
3011
3012 =over 4
3013
3014 =item DESCRIPTION
3015
3016 =over 4
3017
3018 =item What is Perl?
3019
3020 =item Who supports Perl?  Who develops it?  Why is it free?
3021
3022 =item Which version of Perl should I use?
3023
3024 =item What are perl4 and perl5?
3025
3026 =item What is Ponie?
3027
3028 =item What is perl6?
3029
3030 =item How stable is Perl?
3031
3032 =item Is Perl difficult to learn?
3033
3034 =item How does Perl compare with other languages like Java, Python, REXX,
3035 Scheme, or Tcl?
3036
3037 =item Can I do [task] in Perl?
3038
3039 =item When shouldn't I program in Perl?
3040
3041 =item What's the difference between "perl" and "Perl"?
3042
3043 =item Is it a Perl program or a Perl script?
3044
3045 =item What is a JAPH?
3046
3047 =item Where can I get a list of Larry Wall witticisms?
3048
3049 =item How can I convince my sysadmin/supervisor/employees to use version
3050 5/5.6.1/Perl instead of some other language?
3051
3052 =back
3053
3054 =item AUTHOR AND COPYRIGHT
3055
3056 =back
3057
3058 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $,
3059 $Date: 2003/01/26 17:50:56 $)
3060
3061 =over 4
3062
3063 =item DESCRIPTION
3064
3065 =over 4
3066
3067 =item What machines support Perl?  Where do I get it?
3068
3069 =item How can I get a binary version of Perl?
3070
3071 =item I don't have a C compiler on my system.  How can I compile perl?
3072
3073 =item I copied the Perl binary from one machine to another, but scripts
3074 don't work.
3075
3076 =item I grabbed the sources and tried to compile but gdbm/dynamic
3077 loading/malloc/linking/... failed.  How do I make it work?
3078
3079 =item What modules and extensions are available for Perl?  What is CPAN?
3080 What does CPAN/src/... mean?
3081
3082 =item Is there an ISO or ANSI certified version of Perl?
3083
3084 =item Where can I get information on Perl?
3085
3086 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
3087
3088 =item Where should I post source code?
3089
3090 =item Perl Books
3091
3092 References, Tutorials, Task-Oriented, Special Topics
3093
3094 =item Perl in Magazines
3095
3096 =item Perl on the Net: FTP and WWW Access
3097
3098 =item What mailing lists are there for Perl?
3099
3100 =item Archives of comp.lang.perl.misc
3101
3102 =item Where can I buy a commercial version of Perl?
3103
3104 =item Where do I send bug reports?
3105
3106 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
3107
3108 =back
3109
3110 =item AUTHOR AND COPYRIGHT
3111
3112 =back
3113
3114 =head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31
3115 17:34:56 $)
3116
3117 =over 4
3118
3119 =item DESCRIPTION
3120
3121 =over 4
3122
3123 =item How do I do (anything)?
3124
3125 =item How can I use Perl interactively?
3126
3127 =item Is there a Perl shell?
3128
3129 =item How do I find which modules are installed on my system?
3130
3131 =item How do I debug my Perl programs?
3132
3133 =item How do I profile my Perl programs?
3134
3135 =item How do I cross-reference my Perl programs?
3136
3137 =item Is there a pretty-printer (formatter) for Perl?
3138
3139 =item Is there a ctags for Perl?
3140
3141 =item Is there an IDE or Windows Perl Editor?
3142
3143 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
3144 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
3145 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3146
3147 =item Where can I get Perl macros for vi?
3148
3149 =item Where can I get perl-mode for emacs?
3150
3151 =item How can I use curses with Perl?
3152
3153 =item How can I use X or Tk with Perl?
3154
3155 =item How can I generate simple menus without using CGI or Tk?
3156
3157 =item How can I make my Perl program run faster?
3158
3159 =item How can I make my Perl program take less memory?
3160
3161 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3162 stringification, Pass by reference, Tie large variables to disk
3163
3164 =item Is it safe to return a reference to local or lexical data?
3165
3166 =item How can I free an array or hash so my program shrinks?
3167
3168 =item How can I make my CGI script more efficient?
3169
3170 =item How can I hide the source for my Perl program?
3171
3172 =item How can I compile my Perl program into byte code or C?
3173
3174 =item How can I compile Perl into Java?
3175
3176 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3177
3178 =item Can I write useful Perl programs on the command line?
3179
3180 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3181
3182 =item Where can I learn about CGI or Web programming in Perl?
3183
3184 =item Where can I learn about object-oriented Perl programming?
3185
3186 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3187
3188 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3189 my C program; what am I doing wrong?
3190
3191 =item When I tried to run my script, I got this message. What does it mean?
3192
3193 =item What's MakeMaker?
3194
3195 =back
3196
3197 =item AUTHOR AND COPYRIGHT
3198
3199 =back
3200
3201 =head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28
3202 17:35:21 $)
3203
3204 =over 4
3205
3206 =item DESCRIPTION
3207
3208 =item Data: Numbers
3209
3210 =over 4
3211
3212 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3213 numbers I should be getting (eg, 19.95)?
3214
3215 =item Why isn't my octal data interpreted correctly?
3216
3217 =item Does Perl have a round() function?  What about ceil() and floor()?
3218 Trig functions?
3219
3220 =item How do I convert between numeric representations?
3221
3222 How do I convert hexadecimal into decimal, How do I convert from decimal to
3223 hexadecimal, How do I convert from octal to decimal, How do I convert from
3224 decimal to octal, How do I convert from binary to decimal, How do I convert
3225 from decimal to binary
3226
3227 =item Why doesn't & work the way I want it to?
3228
3229 =item How do I multiply matrices?
3230
3231 =item How do I perform an operation on a series of integers?
3232
3233 =item How can I output Roman numerals?
3234
3235 =item Why aren't my random numbers random?
3236
3237 =item How do I get a random number between X and Y?
3238
3239 =back
3240
3241 =item Data: Dates
3242
3243 =over 4
3244
3245 =item How do I find the day or week of the year?
3246
3247 =item How can I compare two dates and find the difference?
3248
3249 =item How can I take a string and turn it into epoch seconds?
3250
3251 =item How can I find the Julian Day?
3252
3253 =item How do I find yesterday's date?
3254
3255 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3256
3257 =back
3258
3259 =item Data: Strings
3260
3261 =over 4
3262
3263 =item How do I validate input?
3264
3265 =item How do I unescape a string?
3266
3267 =item How do I remove consecutive pairs of characters?
3268
3269 =item How do I expand function calls in a string?
3270
3271 =item How do I find matching/nesting anything?
3272
3273 =item How do I reverse a string?
3274
3275 =item How do I expand tabs in a string?
3276
3277 =item How do I reformat a paragraph?
3278
3279 =item How can I access or change N characters of a string?
3280
3281 =item How do I change the Nth occurrence of something?
3282
3283 =item How can I count the number of occurrences of a substring within a
3284 string?
3285
3286 =item How do I capitalize all the words on one line?
3287
3288 =item How can I split a [character] delimited string except when inside
3289 [character]?
3290
3291 =item How do I strip blank space from the beginning/end of a string?
3292
3293 =item How do I pad a string with blanks or pad a number with zeroes?
3294
3295 =item How do I extract selected columns from a string?
3296
3297 =item How do I find the soundex value of a string?
3298
3299 =item How can I expand variables in text strings?
3300
3301 =item What's wrong with always quoting "$vars"?
3302
3303 =item Why don't my E<lt>E<lt>HERE documents work?
3304
3305 There must be no space after the E<lt>E<lt> part, There (probably) should
3306 be a semicolon at the end, You can't (easily) have any space in front of
3307 the tag
3308
3309 =back
3310
3311 =item Data: Arrays
3312
3313 =over 4
3314
3315 =item What is the difference between a list and an array?
3316
3317 =item What is the difference between $array[1] and @array[1]?
3318
3319 =item How can I remove duplicate elements from a list or array?
3320
3321 a), b), c), d), e)
3322
3323 =item How can I tell whether a certain element is contained in a list or
3324 array?
3325
3326 =item How do I compute the difference of two arrays?  How do I compute the
3327 intersection of two arrays?
3328
3329 =item How do I test whether two arrays or hashes are equal?
3330
3331 =item How do I find the first array element for which a condition is true?
3332
3333 =item How do I handle linked lists?
3334
3335 =item How do I handle circular lists?
3336
3337 =item How do I shuffle an array randomly?
3338
3339 =item How do I process/modify each element of an array?
3340
3341 =item How do I select a random element from an array?
3342
3343 =item How do I permute N elements of a list?
3344
3345 =item How do I sort an array by (anything)?
3346
3347 =item How do I manipulate arrays of bits?
3348
3349 =item Why does defined() return true on empty arrays and hashes?
3350
3351 =back
3352
3353 =item Data: Hashes (Associative Arrays)
3354
3355 =over 4
3356
3357 =item How do I process an entire hash?
3358
3359 =item What happens if I add or remove keys from a hash while iterating over
3360 it?
3361
3362 =item How do I look up a hash element by value?
3363
3364 =item How can I know how many entries are in a hash?
3365
3366 =item How do I sort a hash (optionally by value instead of key)?
3367
3368 =item How can I always keep my hash sorted?
3369
3370 =item What's the difference between "delete" and "undef" with hashes?
3371
3372 =item Why don't my tied hashes make the defined/exists distinction?
3373
3374 =item How do I reset an each() operation part-way through?
3375
3376 =item How can I get the unique keys from two hashes?
3377
3378 =item How can I store a multidimensional array in a DBM file?
3379
3380 =item How can I make my hash remember the order I put elements into it?
3381
3382 =item Why does passing a subroutine an undefined element in a hash create
3383 it?
3384
3385 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3386 array of hashes or arrays?
3387
3388 =item How can I use a reference as a hash key?
3389
3390 =back
3391
3392 =item Data: Misc
3393
3394 =over 4
3395
3396 =item How do I handle binary data correctly?
3397
3398 =item How do I determine whether a scalar is a number/whole/integer/float?
3399
3400 =item How do I keep persistent data across program calls?
3401
3402 =item How do I print out or copy a recursive data structure?
3403
3404 =item How do I define methods for every class/object?
3405
3406 =item How do I verify a credit card checksum?
3407
3408 =item How do I pack arrays of doubles or floats for XS code?
3409
3410 =back
3411
3412 =item AUTHOR AND COPYRIGHT
3413
3414 =back
3415
3416 =head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
3417 17:45:46 $)
3418
3419 =over 4
3420
3421 =item DESCRIPTION
3422
3423 =over 4
3424
3425 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3426
3427 =item How do I change one line in a file/delete a line in a file/insert a
3428 line in the middle of a file/append to the beginning of a file?
3429
3430 =item How do I count the number of lines in a file?
3431
3432 =item How can I use Perl's C<-i> option from within a program?
3433
3434 =item How do I make a temporary file name?
3435
3436 =item How can I manipulate fixed-record-length files?
3437
3438 =item How can I make a filehandle local to a subroutine?  How do I pass
3439 filehandles between subroutines?  How do I make an array of filehandles?
3440
3441 =item How can I use a filehandle indirectly?
3442
3443 =item How can I set up a footer format to be used with write()?
3444
3445 =item How can I write() into a string?
3446
3447 =item How can I output my numbers with commas added?
3448
3449 =item How can I translate tildes (~) in a filename?
3450
3451 =item How come when I open a file read-write it wipes it out?
3452
3453 =item Why do I sometimes get an "Argument list too long" when I use
3454 E<lt>*E<gt>?
3455
3456 =item Is there a leak/bug in glob()?
3457
3458 =item How can I open a file with a leading ">" or trailing blanks?
3459
3460 =item How can I reliably rename a file?
3461
3462 =item How can I lock a file?
3463
3464 =item Why can't I just open(FH, "E<gt>file.lock")?
3465
3466 =item I still don't get locking.  I just want to increment the number in
3467 the file.  How can I do this?
3468
3469 =item All I want to do is append a small amount of text to the end of a
3470 file.  Do I still have to use locking?
3471
3472 =item How do I randomly update a binary file?
3473
3474 =item How do I get a file's timestamp in perl?
3475
3476 =item How do I set a file's timestamp in perl?
3477
3478 =item How do I print to more than one file at once?
3479
3480 =item How can I read in an entire file all at once?
3481
3482 =item How can I read in a file by paragraphs?
3483
3484 =item How can I read a single character from a file?  From the keyboard?
3485
3486 =item How can I tell whether there's a character waiting on a filehandle?
3487
3488 =item How do I do a C<tail -f> in perl?
3489
3490 =item How do I dup() a filehandle in Perl?
3491
3492 =item How do I close a file descriptor by number?
3493
3494 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3495 `C:\temp\foo.exe` work?
3496
3497 =item Why doesn't glob("*.*") get all the files?
3498
3499 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3500 protected files?  Isn't this a bug in Perl?
3501
3502 =item How do I select a random line from a file?
3503
3504 =item Why do I get weird spaces when I print an array of lines?
3505
3506 =back
3507
3508 =item AUTHOR AND COPYRIGHT
3509
3510 =back
3511
3512 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
3513 20:05:28 $)
3514
3515 =over 4
3516
3517 =item DESCRIPTION
3518
3519 =over 4
3520
3521 =item How can I hope to use regular expressions without creating illegible
3522 and unmaintainable code?
3523
3524 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3525
3526 =item I'm having trouble matching over more than one line.  What's wrong?
3527
3528 =item How can I pull out lines between two patterns that are themselves on
3529 different lines?
3530
3531 =item I put a regular expression into $/ but it didn't work. What's wrong?
3532
3533 =item How do I substitute case insensitively on the LHS while preserving
3534 case on the RHS?
3535
3536 =item How can I make C<\w> match national character sets?
3537
3538 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3539
3540 =item How can I quote a variable to use in a regex?
3541
3542 =item What is C</o> really for?
3543
3544 =item How do I use a regular expression to strip C style comments from a
3545 file?
3546
3547 =item Can I use Perl regular expressions to match balanced text?
3548
3549 =item What does it mean that regexes are greedy?  How can I get around it?
3550
3551 =item How do I process each word on each line?
3552
3553 =item How can I print out a word-frequency or line-frequency summary?
3554
3555 =item How can I do approximate matching?
3556
3557 =item How do I efficiently match many regular expressions at once?
3558
3559 =item Why don't word-boundary searches with C<\b> work for me?
3560
3561 =item Why does using $&, $`, or $' slow my program down?
3562
3563 =item What good is C<\G> in a regular expression?
3564
3565 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3566
3567 =item What's wrong with using grep or map in a void context?
3568
3569 =item How can I match strings with multibyte characters?
3570
3571 =item How do I match a pattern that is supplied by the user?
3572
3573 =back
3574
3575 =item AUTHOR AND COPYRIGHT
3576
3577 =back
3578
3579 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
3580 2003/07/24 02:17:21 $)
3581
3582 =over 4
3583
3584 =item DESCRIPTION
3585
3586 =over 4
3587
3588 =item Can I get a BNF/yacc/RE for the Perl language?
3589
3590 =item What are all these $@%&* punctuation signs, and how do I know when to
3591 use them?
3592
3593 =item Do I always/never have to quote my strings or use semicolons and
3594 commas?
3595
3596 =item How do I skip some return values?
3597
3598 =item How do I temporarily block warnings?
3599
3600 =item What's an extension?
3601
3602 =item Why do Perl operators have different precedence than C operators?
3603
3604 =item How do I declare/create a structure?
3605
3606 =item How do I create a module?
3607
3608 =item How do I create a class?
3609
3610 =item How can I tell if a variable is tainted?
3611
3612 =item What's a closure?
3613
3614 =item What is variable suicide and how can I prevent it?
3615
3616 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3617 Regex}?
3618
3619 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3620 Passing Methods
3621
3622 =item How do I create a static variable?
3623
3624 =item What's the difference between dynamic and lexical (static) scoping?
3625 Between local() and my()?
3626
3627 =item How can I access a dynamic variable while a similarly named lexical
3628 is in scope?
3629
3630 =item What's the difference between deep and shallow binding?
3631
3632 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
3633
3634 =item How do I redefine a builtin function, operator, or method?
3635
3636 =item What's the difference between calling a function as &foo and foo()?
3637
3638 =item How do I create a switch or case statement?
3639
3640 =item How can I catch accesses to undefined variables, functions, or
3641 methods?
3642
3643 =item Why can't a method included in this same file be found?
3644
3645 =item How can I find out my current package?
3646
3647 =item How can I comment out a large block of perl code?
3648
3649 =item How do I clear a package?
3650
3651 =item How can I use a variable as a variable name?
3652
3653 =item What does "bad interpreter" mean?
3654
3655 =back
3656
3657 =item AUTHOR AND COPYRIGHT
3658
3659 =back
3660
3661 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
3662 17:44:04 $)
3663
3664 =over 4
3665
3666 =item DESCRIPTION
3667
3668 =over 4
3669
3670 =item How do I find out which operating system I'm running under?
3671
3672 =item How come exec() doesn't return?
3673
3674 =item How do I do fancy stuff with the keyboard/screen/mouse?
3675
3676 Keyboard, Screen, Mouse
3677
3678 =item How do I print something out in color?
3679
3680 =item How do I read just one key without waiting for a return key?
3681
3682 =item How do I check whether input is ready on the keyboard?
3683
3684 =item How do I clear the screen?
3685
3686 =item How do I get the screen size?
3687
3688 =item How do I ask the user for a password?
3689
3690 =item How do I read and write the serial port?
3691
3692 lockfiles, open mode, end of line, flushing output, non-blocking input
3693
3694 =item How do I decode encrypted password files?
3695
3696 =item How do I start a process in the background?
3697
3698 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3699
3700 =item How do I trap control characters/signals?
3701
3702 =item How do I modify the shadow password file on a Unix system?
3703
3704 =item How do I set the time and date?
3705
3706 =item How can I sleep() or alarm() for under a second?
3707
3708 =item How can I measure time under a second?
3709
3710 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3711
3712 =item Why doesn't my sockets program work under System V (Solaris)?  What
3713 does the error message "Protocol not supported" mean?
3714
3715 =item How can I call my system's unique C functions from Perl?
3716
3717 =item Where do I get the include files to do ioctl() or syscall()?
3718
3719 =item Why do setuid perl scripts complain about kernel problems?
3720
3721 =item How can I open a pipe both to and from a command?
3722
3723 =item Why can't I get the output of a command with system()?
3724
3725 =item How can I capture STDERR from an external command?
3726
3727 =item Why doesn't open() return an error when a pipe open fails?
3728
3729 =item What's wrong with using backticks in a void context?
3730
3731 =item How can I call backticks without shell processing?
3732
3733 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3734 ^Z on MS-DOS)?
3735
3736 =item How can I convert my shell script to perl?
3737
3738 =item Can I use perl to run a telnet or ftp session?
3739
3740 =item How can I write expect in Perl?
3741
3742 =item Is there a way to hide perl's command line from programs such as
3743 "ps"?
3744
3745 =item I {changed directory, modified my environment} in a perl script.  How
3746 come the change disappeared when I exited the script?  How do I get my
3747 changes to be visible?
3748
3749 Unix
3750
3751 =item How do I close a process's filehandle without waiting for it to
3752 complete?
3753
3754 =item How do I fork a daemon process?
3755
3756 =item How do I find out if I'm running interactively or not?
3757
3758 =item How do I timeout a slow event?
3759
3760 =item How do I set CPU limits?
3761
3762 =item How do I avoid zombies on a Unix system?
3763
3764 =item How do I use an SQL database?
3765
3766 =item How do I make a system() exit on control-C?
3767
3768 =item How do I open a file without blocking?
3769
3770 =item How do I install a module from CPAN?
3771
3772 =item What's the difference between require and use?
3773
3774 =item How do I keep my own module/library directory?
3775
3776 =item How do I add the directory my program lives in to the module/library
3777 search path?
3778
3779 =item How do I add a directory to my include path at runtime?
3780
3781 =item What is socket.ph and where do I get it?
3782
3783 =back
3784
3785 =item AUTHOR AND COPYRIGHT
3786
3787 =back
3788
3789 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
3790 $)
3791
3792 =over 4
3793
3794 =item DESCRIPTION
3795
3796 =over 4
3797
3798 =item What is the correct form of response from a CGI script?
3799
3800 =item My CGI script runs from the command line but not the browser.  (500
3801 Server Error)
3802
3803 =item How can I get better error messages from a CGI program?
3804
3805 =item How do I remove HTML from a string?
3806
3807 =item How do I extract URLs?
3808
3809 =item How do I download a file from the user's machine?  How do I open a
3810 file on another machine?
3811
3812 =item How do I make a pop-up menu in HTML?
3813
3814 =item How do I fetch an HTML file?
3815
3816 =item How do I automate an HTML form submission?
3817
3818 =item How do I decode or create those %-encodings on the web?
3819
3820 =item How do I redirect to another page?
3821
3822 =item How do I put a password on my web pages?
3823
3824 =item How do I edit my .htpasswd and .htgroup files with Perl?
3825
3826 =item How do I make sure users can't enter values into a form that cause my
3827 CGI script to do bad things?
3828
3829 =item How do I parse a mail header?
3830
3831 =item How do I decode a CGI form?
3832
3833 =item How do I check a valid mail address?
3834
3835 =item How do I decode a MIME/BASE64 string?
3836
3837 =item How do I return the user's mail address?
3838
3839 =item How do I send mail?
3840
3841 =item How do I use MIME to make an attachment to a mail message?
3842
3843 =item How do I read mail?
3844
3845 =item How do I find out my hostname/domainname/IP address?
3846
3847 =item How do I fetch a news article or the active newsgroups?
3848
3849 =item How do I fetch/put an FTP file?
3850
3851 =item How can I do RPC in Perl?
3852
3853 =back
3854
3855 =item AUTHOR AND COPYRIGHT
3856
3857 =back
3858
3859 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3860
3861 =over 4
3862
3863 =item DESCRIPTION
3864
3865 =over 4
3866
3867 =item Layout
3868
3869 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3870
3871 =back
3872
3873 =item Using The Back Ends
3874
3875 =over 4
3876
3877 =item The Cross Referencing Back End
3878
3879 i, &, s, r
3880
3881 =item The Decompiling Back End
3882
3883 =item The Lint Back End
3884
3885 =item The Simple C Back End
3886
3887 =item The Bytecode Back End
3888
3889 =item The Optimized C Back End
3890
3891 =back
3892
3893 =item Module List for the Compiler Suite
3894
3895 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3896 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3897 B::Stackobj, B::Stash, B::Terse, B::Xref
3898
3899 =item KNOWN PROBLEMS
3900
3901 =item AUTHOR
3902
3903 =back
3904
3905 =head2 perlembed - how to embed perl in your C program
3906
3907 =over 4
3908
3909 =item DESCRIPTION
3910
3911 =over 4
3912
3913 =item PREAMBLE
3914
3915 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3916 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3917
3918 =item ROADMAP
3919
3920 =item Compiling your C program
3921
3922 =item Adding a Perl interpreter to your C program
3923
3924 =item Calling a Perl subroutine from your C program
3925
3926 =item Evaluating a Perl statement from your C program
3927
3928 =item Performing Perl pattern matches and substitutions from your C program
3929
3930 =item Fiddling with the Perl stack from your C program
3931
3932 =item Maintaining a persistent interpreter
3933
3934 =item Execution of END blocks
3935
3936 =item Maintaining multiple interpreter instances
3937
3938 =item Using Perl modules, which themselves use C libraries, from your C
3939 program
3940
3941 =back
3942
3943 =item Embedding Perl under Win32
3944
3945 =item Hiding Perl_
3946
3947 =item MORAL
3948
3949 =item AUTHOR
3950
3951 =item COPYRIGHT
3952
3953 =back
3954
3955 =head2 perldebguts - Guts of Perl debugging
3956
3957 =over 4
3958
3959 =item DESCRIPTION
3960
3961 =item Debugger Internals
3962
3963 =over 4
3964
3965 =item Writing Your Own Debugger
3966
3967 =back
3968
3969 =item Frame Listing Output Examples
3970
3971 =item Debugging regular expressions
3972
3973 =over 4
3974
3975 =item Compile-time output
3976
3977 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3978 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3979 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3980 C<anchored(TYPE)>
3981
3982 =item Types of nodes
3983
3984 =item Run-time output
3985
3986 =back
3987
3988 =item Debugging Perl memory usage
3989
3990 =over 4
3991
3992 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3993
3994 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3995 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3996 6144>
3997
3998 =item Example of using B<-DL> switch
3999
4000 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4001
4002 =item B<-DL> details
4003
4004 C<!!!>, C<!!>, C<!>
4005
4006 =item Limitations of B<-DL> statistics
4007
4008 =back
4009
4010 =item SEE ALSO
4011
4012 =back
4013
4014 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4015
4016 =over 4
4017
4018 =item DESCRIPTION
4019
4020 =item SPECIAL NOTES
4021
4022 =over 4
4023
4024 =item make
4025
4026 =item Version caveat
4027
4028 =item Dynamic Loading versus Static Loading
4029
4030 =back
4031
4032 =item TUTORIAL
4033
4034 =over 4
4035
4036 =item EXAMPLE 1
4037
4038 =item EXAMPLE 2
4039
4040 =item What has gone on?
4041
4042 =item Writing good test scripts
4043
4044 =item EXAMPLE 3
4045
4046 =item What's new here?
4047
4048 =item Input and Output Parameters
4049
4050 =item The XSUBPP Program
4051
4052 =item The TYPEMAP file
4053
4054 =item Warning about Output Arguments
4055
4056 =item EXAMPLE 4
4057
4058 =item What has happened here?
4059
4060 =item Anatomy of .xs file
4061
4062 =item Getting the fat out of XSUBs
4063
4064 =item More about XSUB arguments
4065
4066 =item The Argument Stack
4067
4068 =item Extending your Extension
4069
4070 =item Documenting your Extension
4071
4072 =item Installing your Extension
4073
4074 =item EXAMPLE 5
4075
4076 =item New Things in this Example
4077
4078 =item EXAMPLE 6
4079
4080 =item New Things in this Example
4081
4082 =item EXAMPLE 7 (Coming Soon)
4083
4084 =item EXAMPLE 8 (Coming Soon)
4085
4086 =item EXAMPLE 9 Passing open files to XSes
4087
4088 =item Troubleshooting these Examples
4089
4090 =back
4091
4092 =item See also
4093
4094 =item Author
4095
4096 =over 4
4097
4098 =item Last Changed
4099
4100 =back
4101
4102 =back
4103
4104 =head2 perlxs - XS language reference manual
4105
4106 =over 4
4107
4108 =item DESCRIPTION
4109
4110 =over 4
4111
4112 =item Introduction
4113
4114 =item On The Road
4115
4116 =item The Anatomy of an XSUB
4117
4118 =item The Argument Stack
4119
4120 =item The RETVAL Variable
4121
4122 =item The MODULE Keyword
4123
4124 =item The PACKAGE Keyword
4125
4126 =item The PREFIX Keyword
4127
4128 =item The OUTPUT: Keyword
4129
4130 =item The NO_OUTPUT Keyword
4131
4132 =item The CODE: Keyword
4133
4134 =item The INIT: Keyword
4135
4136 =item The NO_INIT Keyword
4137
4138 =item Initializing Function Parameters
4139
4140 =item Default Parameter Values
4141
4142 =item The PREINIT: Keyword
4143
4144 =item The SCOPE: Keyword
4145
4146 =item The INPUT: Keyword
4147
4148 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4149
4150 =item The C<length(NAME)> Keyword
4151
4152 =item Variable-length Parameter Lists
4153
4154 =item The C_ARGS: Keyword
4155
4156 =item The PPCODE: Keyword
4157
4158 =item Returning Undef And Empty Lists
4159
4160 =item The REQUIRE: Keyword
4161
4162 =item The CLEANUP: Keyword
4163
4164 =item The POSTCALL: Keyword
4165
4166 =item The BOOT: Keyword
4167
4168 =item The VERSIONCHECK: Keyword
4169
4170 =item The PROTOTYPES: Keyword
4171
4172 =item The PROTOTYPE: Keyword
4173
4174 =item The ALIAS: Keyword
4175
4176 =item The OVERLOAD: Keyword
4177
4178 =item The FALLBACK: Keyword
4179
4180 =item The INTERFACE: Keyword
4181
4182 =item The INTERFACE_MACRO: Keyword
4183
4184 =item The INCLUDE: Keyword
4185
4186 =item The CASE: Keyword
4187
4188 =item The & Unary Operator
4189
4190 =item Inserting POD, Comments and C Preprocessor Directives
4191
4192 =item Using XS With C++
4193
4194 =item Interface Strategy
4195
4196 =item Perl Objects And C Structures
4197
4198 =item The Typemap
4199
4200 =item Safely Storing Static Data in XS
4201
4202 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4203
4204 =back
4205
4206 =item EXAMPLES
4207
4208 =item XS VERSION
4209
4210 =item AUTHOR
4211
4212 =back
4213
4214 =head2 perlclib - Internal replacements for standard C library functions
4215
4216 =over 4
4217
4218 =item DESCRIPTION
4219
4220 =over 4
4221
4222 =item Conventions
4223
4224 C<t>, C<p>, C<n>, C<s>
4225
4226 =item File Operations
4227
4228 =item File Input and Output
4229
4230 =item File Positioning
4231
4232 =item Memory Management and String Handling
4233
4234 =item Character Class Tests
4235
4236 =item F<stdlib.h> functions
4237
4238 =item Miscellaneous functions
4239
4240 =back
4241
4242 =item SEE ALSO
4243
4244 =back
4245
4246 =head2 perlguts - Introduction to the Perl API
4247
4248 =over 4
4249
4250 =item DESCRIPTION
4251
4252 =item Variables
4253
4254 =over 4
4255
4256 =item Datatypes
4257
4258 =item What is an "IV"?
4259
4260 =item Working with SVs
4261
4262 =item Offsets
4263
4264 =item What's Really Stored in an SV?
4265
4266 =item Working with AVs
4267
4268 =item Working with HVs
4269
4270 =item Hash API Extensions
4271
4272 =item AVs, HVs and undefined values
4273
4274 =item References
4275
4276 =item Blessed References and Class Objects
4277
4278 =item Creating New Variables
4279
4280 GV_ADDMULTI, GV_ADDWARN
4281
4282 =item Reference Counts and Mortality
4283
4284 =item Stashes and Globs
4285
4286 =item Double-Typed SVs
4287
4288 =item Magic Variables
4289
4290 =item Assigning Magic
4291
4292 =item Magic Virtual Tables
4293
4294 =item Finding Magic
4295
4296 =item Understanding the Magic of Tied Hashes and Arrays
4297
4298 =item Localizing changes
4299
4300 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4301 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4302 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4303 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4304 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4305 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4306 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4307 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4308 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4309 save_hptr(HV **hptr)>
4310
4311 =back
4312
4313 =item Subroutines
4314
4315 =over 4
4316
4317 =item XSUBs and the Argument Stack
4318
4319 =item Calling Perl Routines from within C Programs
4320
4321 =item Memory Allocation
4322
4323 =item PerlIO
4324
4325 =item Putting a C value on Perl stack
4326
4327 =item Scratchpads
4328
4329 =item Scratchpads and recursion
4330
4331 =back
4332
4333 =item Compiled code
4334
4335 =over 4
4336
4337 =item Code tree
4338
4339 =item Examining the tree
4340
4341 =item Compile pass 1: check routines
4342
4343 =item Compile pass 1a: constant folding
4344
4345 =item Compile pass 2: context propagation
4346
4347 =item Compile pass 3: peephole optimization
4348
4349 =item Pluggable runops
4350
4351 =back
4352
4353 =item Examining internal data structures with the C<dump> functions
4354
4355 =item How multiple interpreters and concurrency are supported
4356
4357 =over 4
4358
4359 =item Background and PERL_IMPLICIT_CONTEXT
4360
4361 =item So what happened to dTHR?
4362
4363 =item How do I use all this in extensions?
4364
4365 =item Should I do anything special if I call perl from multiple threads?
4366
4367 =item Future Plans and PERL_IMPLICIT_SYS
4368
4369 =back
4370
4371 =item Internal Functions
4372
4373 A, p, d, s, n, r, f, M, o, j, x
4374
4375 =over 4
4376
4377 =item Formatted Printing of IVs, UVs, and NVs
4378
4379 =item Pointer-To-Integer and Integer-To-Pointer
4380
4381 =item Source Documentation
4382
4383 =back
4384
4385 =item Unicode Support
4386
4387 =over 4
4388
4389 =item What B<is> Unicode, anyway?
4390
4391 =item How can I recognise a UTF8 string?
4392
4393 =item How does UTF8 represent Unicode characters?
4394
4395 =item How does Perl store UTF8 strings?
4396
4397 =item How do I convert a string to UTF8?
4398
4399 =item Is there anything else I need to know?
4400
4401 =back
4402
4403 =item Custom Operators
4404
4405 =item AUTHORS
4406
4407 =item SEE ALSO
4408
4409 =back
4410
4411 =head2 perlcall - Perl calling conventions from C
4412
4413 =over 4
4414
4415 =item DESCRIPTION
4416
4417 An Error Handler, An Event Driven Program
4418
4419 =item THE CALL_ FUNCTIONS
4420
4421 call_sv, call_pv, call_method, call_argv
4422
4423 =item FLAG VALUES
4424
4425 =over 4
4426
4427 =item  G_VOID
4428
4429 =item  G_SCALAR
4430
4431 =item G_ARRAY
4432
4433 =item G_DISCARD
4434
4435 =item G_NOARGS
4436
4437 =item G_EVAL
4438
4439 =item G_KEEPERR
4440
4441 =item Determining the Context
4442
4443 =back
4444
4445 =item KNOWN PROBLEMS
4446
4447 =item EXAMPLES
4448
4449 =over 4
4450
4451 =item No Parameters, Nothing returned
4452
4453 =item Passing Parameters
4454
4455 =item Returning a Scalar
4456
4457 =item Returning a list of values
4458
4459 =item Returning a list in a scalar context
4460
4461 =item Returning Data from Perl via the parameter list
4462
4463 =item Using G_EVAL
4464
4465 =item Using G_KEEPERR
4466
4467 =item Using call_sv
4468
4469 =item Using call_argv
4470
4471 =item Using call_method
4472
4473 =item Using GIMME_V
4474
4475 =item Using Perl to dispose of temporaries
4476
4477 =item Strategies for storing Callback Context Information
4478
4479 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4480 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4481 callback
4482
4483 =item Alternate Stack Manipulation
4484
4485 =item Creating and calling an anonymous subroutine in C
4486
4487 =back
4488
4489 =item SEE ALSO
4490
4491 =item AUTHOR
4492
4493 =item DATE
4494
4495 =back
4496
4497 =head2 perlutil - utilities packaged with the Perl distribution
4498
4499 =over 4
4500
4501 =item DESCRIPTION
4502
4503 =over 4
4504
4505 =item DOCUMENTATION
4506
4507 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4508 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4509 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4510 L<roffitall|roffitall>
4511
4512 =item CONVERTORS
4513
4514 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4515
4516 =item Administration
4517
4518 L<libnetcfg|libnetcfg>
4519
4520 =item Development
4521
4522 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4523 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4524
4525 =item SEE ALSO
4526
4527 =back
4528
4529 =back
4530
4531 =head2 perlfilter - Source Filters
4532
4533 =over 4
4534
4535 =item DESCRIPTION
4536
4537 =item CONCEPTS
4538
4539 =item USING FILTERS
4540
4541 =item WRITING A SOURCE FILTER
4542
4543 =item WRITING A SOURCE FILTER IN C
4544
4545 B<Decryption Filters>
4546
4547 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4548
4549 =item WRITING A SOURCE FILTER IN PERL
4550
4551 =item USING CONTEXT: THE DEBUG FILTER
4552
4553 =item CONCLUSION
4554
4555 =item THINGS TO LOOK OUT FOR
4556
4557 Some Filters Clobber the C<DATA> Handle
4558
4559 =item REQUIREMENTS
4560
4561 =item AUTHOR
4562
4563 =item Copyrights
4564
4565 =back
4566
4567 =head2 perldbmfilter - Perl DBM Filters
4568
4569 =over 4
4570
4571 =item SYNOPSIS
4572
4573 =item DESCRIPTION
4574
4575 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4576 B<filter_fetch_value>
4577
4578 =over 4
4579
4580 =item The Filter
4581
4582 =item An Example -- the NULL termination problem.
4583
4584 =item Another Example -- Key is a C int.
4585
4586 =back
4587
4588 =item SEE ALSO
4589
4590 =item AUTHOR
4591
4592 =back
4593
4594 =head2 perlapi - autogenerated documentation for the perl public API
4595
4596 =over 4
4597
4598 =item DESCRIPTION
4599
4600 =item "Gimme" Values
4601
4602 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4603
4604 =item Array Manipulation Functions
4605
4606 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4607 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4608 get_av, newAV, Nullav, sortsv
4609
4610 =item Callback Functions
4611
4612 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4613 FREETMPS, LEAVE, SAVETMPS
4614
4615 =item Character classes
4616
4617 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4618
4619 =item Cloning an interpreter
4620
4621 perl_clone
4622
4623 =item CV Manipulation Functions
4624
4625 CvSTASH, get_cv, Nullcv
4626
4627 =item Embedding Functions
4628
4629 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4630 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4631
4632 =item Functions in file pp_pack.c
4633
4634 packlist, pack_cat, unpackstring, unpack_str
4635
4636 =item Global Variables
4637
4638 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4639
4640 =item GV Functions
4641
4642 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4643 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4644
4645 =item Handy Values
4646
4647 HEf_SVKEY, Nullch, Nullsv
4648
4649 =item Hash Manipulation Functions
4650
4651 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4652 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4653 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4654 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4655 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4656
4657 =item Magical Functions
4658
4659 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4660 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4661 SvSetSV, SvSetSV_nosteal, SvSHARE
4662
4663 =item Memory Management
4664
4665 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4666 savepv, savepvn, savesharedpv, StructCopy, Zero
4667
4668 =item Miscellaneous Functions
4669
4670 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4671 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4672 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
4673
4674 =item Numeric functions
4675
4676 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4677 scan_hex, scan_oct
4678
4679 =item Optree Manipulation Functions
4680
4681 cv_const_sv, newCONSTSUB, newXS
4682
4683 =item Pad Data Structures
4684
4685 pad_sv
4686
4687 =item Stack Manipulation Macros
4688
4689 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4690 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4691 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4692 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4693 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4694
4695 =item SV Flags
4696
4697 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4698
4699 =item SV Manipulation Functions
4700
4701 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4702 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4703 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4704 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4705 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
4706 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4707 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4708 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4709 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4710 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4711 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
4712 SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
4713 SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
4714 SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
4715 sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
4716 sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
4717 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
4718 sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
4719 sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
4720 sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
4721 sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
4722 sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
4723 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
4724 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
4725 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
4726 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
4727 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4728 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4729 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4730 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
4731 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
4732 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
4733 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4734
4735 =item Unicode Support
4736
4737 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4738 pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display,
4739 to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper,
4740 utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
4741 utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4742 uvuni_to_utf8_flags
4743
4744 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4745
4746 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4747 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4748
4749 =item Warning and Dieing
4750
4751 croak, warn
4752
4753 =item AUTHORS
4754
4755 =item SEE ALSO
4756
4757 =back
4758
4759 =head2 perlintern - autogenerated documentation of purely B<internal>
4760                  Perl functions
4761
4762 =over 4
4763
4764 =item DESCRIPTION
4765
4766 =item CV reference counts and CvOUTSIDE
4767
4768 CvWEAKOUTSIDE
4769
4770 =item Functions in file pad.h
4771
4772 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4773 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4774 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4775 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV,
4776 PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4777
4778 =item Functions in file pp_ctl.c
4779
4780 find_runcv
4781
4782 =item Global Variables
4783
4784 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4785 PL_rs
4786
4787 =item GV Functions
4788
4789 is_gv_magical
4790
4791 =item IO Functions
4792
4793 start_glob
4794
4795 =item Pad Data Structures
4796
4797 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4798 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4799 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4800 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4801
4802 =item Stack Manipulation Macros
4803
4804 djSP, LVRET
4805
4806 =item SV Manipulation Functions
4807
4808 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4809
4810 =item AUTHORS
4811
4812 =item SEE ALSO
4813
4814 =back
4815
4816 =head2 perliol - C API for Perl's implementation of IO in Layers.
4817
4818 =over 4
4819
4820 =item SYNOPSIS
4821
4822 =item DESCRIPTION
4823
4824 =over 4
4825
4826 =item History and Background
4827
4828 =item Layers vs Disciplines
4829
4830 =item Data Structures
4831
4832 =item Functions and Attributes
4833
4834 =item Per-instance Data
4835
4836 =item Layers in action.
4837
4838 =item Per-instance flag bits
4839
4840 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4841 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4842 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4843 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4844
4845 =item Methods in Detail
4846
4847 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4848 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4849 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4850 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4851 Set_ptrcnt
4852
4853 =item Implementing PerlIO Layers
4854
4855 C implementations, Perl implementations
4856
4857 =item Core Layers
4858
4859 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4860
4861 =item Extension Layers
4862
4863 ":encoding", ":scalar", ":via"
4864
4865 =back
4866
4867 =item TODO
4868
4869 =back
4870
4871 =head2 perlapio - perl's IO abstraction interface.
4872
4873 =over 4
4874
4875 =item SYNOPSIS
4876
4877 =item DESCRIPTION
4878
4879 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4880 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4881 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4882 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4883 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4884 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4885 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4886 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4887 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4888 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4889 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4890
4891 =over 4
4892
4893 =item Co-existence with stdio
4894
4895 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4896 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4897
4898 =item "Fast gets" Functions
4899
4900 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4901 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4902 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4903 B<PerlIO_get_bufsiz(f)>
4904
4905 =item Other Functions
4906
4907 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4908 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4909
4910 =back
4911
4912 =back
4913
4914 =head2 perltodo - Perl TO-DO List
4915
4916 =over 4
4917
4918 =item DESCRIPTION
4919
4920 =item To do during 5.6.x
4921
4922 =over 4
4923
4924 =item Support for I/O disciplines
4925
4926 =item Autoload bytes.pm
4927
4928 =item Make "\u{XXXX}" et al work
4929
4930 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4931
4932 =item Overloadable regex assertions
4933
4934 =item Unicode
4935
4936 =item Work out exit/die semantics for threads
4937
4938 =item Better support for nonpreemptive threading systems like GNU pth
4939
4940 =item Typed lexicals for compiler
4941
4942 =item Compiler workarounds for Win32
4943
4944 =item AUTOLOADing in the compiler
4945
4946 =item Fixing comppadlist when compiling
4947
4948 =item Cleaning up exported namespace
4949
4950 =item Complete signal handling
4951
4952 =item Out-of-source builds
4953
4954 =item POSIX realtime support
4955
4956 =item UNIX98 support
4957
4958 =item IPv6 Support
4959
4960 =item Long double conversion
4961
4962 =item Locales
4963
4964 =item Arithmetic on non-Arabic numerals
4965
4966 =item POSIX Unicode character classes
4967
4968 =item Factoring out common suffices/prefices in regexps (trie optimization)
4969
4970 =item Security audit shipped utilities
4971
4972 =item Sort out the uid-setting mess
4973
4974 =item Custom opcodes
4975
4976 =item DLL Versioning
4977
4978 =item Introduce @( and @)
4979
4980 =item Floating point handling
4981
4982 =item IV/UV preservation
4983
4984 =item Replace pod2html with something using Pod::Parser
4985
4986 =item Automate module testing on CPAN
4987
4988 =item sendmsg and recvmsg
4989
4990 =item Rewrite perlre documentation
4991
4992 =item Convert example code to IO::Handle filehandles
4993
4994 =item Document Win32 choices
4995
4996 =item Check new modules
4997
4998 =item Make roffitall find pods and libs itself
4999
5000 =back
5001
5002 =item To do at some point
5003
5004 =over 4
5005
5006 =item Remove regular expression recursion
5007
5008 =item Memory leaks after failed eval
5009
5010 =item bitfields in pack
5011
5012 =item Cross compilation
5013
5014 =item Perl preprocessor / macros
5015
5016 =item Perl lexer in Perl
5017
5018 =item Using POSIX calls internally
5019
5020 =item -i rename file when changed
5021
5022 =item All ARGV input should act like E<lt>E<gt>
5023
5024 =item Support for rerunning debugger
5025
5026 =item Test Suite for the Debugger
5027
5028 =item my sub foo { }
5029
5030 =item One-pass global destruction
5031
5032 =item Rewrite regexp parser
5033
5034 =item Cache recently used regexps
5035
5036 =item Cross-compilation support
5037
5038 =item Bit-shifting bitvectors
5039
5040 =item debugger pragma
5041
5042 =item use less pragma
5043
5044 =item switch structures
5045
5046 =item Cache eval tree
5047
5048 =item rcatmaybe
5049
5050 =item Shrink opcode tables
5051
5052 =item Optimize away @_
5053
5054 =item Prototypes versus indirect objects
5055
5056 =item Install HTML
5057
5058 =item Prototype method calls
5059
5060 =item Return context prototype declarations
5061
5062 =item magic_setisa
5063
5064 =item Garbage collection
5065
5066 =item IO tutorial
5067
5068 =item Rewrite perldoc
5069
5070 =item Install .3p manpages
5071
5072 =item Unicode tutorial
5073
5074 =item Update POSIX.pm for 1003.1-2
5075
5076 =item Retargetable installation
5077
5078 =item POSIX emulation on non-POSIX systems
5079
5080 =item Rename Win32 headers
5081
5082 =item Finish off lvalue functions
5083
5084 =item Update sprintf documentation
5085
5086 =item Use fchown/fchmod internally
5087
5088 =item Make v-strings overloaded objects
5089
5090 =item Allow restricted hash assignment
5091
5092 =item Should overload be inheritable?
5093
5094 =item Taint rethink
5095
5096 =item Perform correctly when XSUBs call subroutines that exit via
5097 goto(LABEL) and friends
5098
5099 =back
5100
5101 =item Vague ideas
5102
5103 =over 4
5104
5105 =item ref() in list context
5106
5107 =item Make tr/// return histogram of characters in list context
5108
5109 =item Compile to real threaded code
5110
5111 =item Structured types
5112
5113 =item Modifiable $1 et al.
5114
5115 =item Procedural interfaces for IO::*, etc.
5116
5117 =item RPC modules
5118
5119 =item Attach/detach debugger from running program
5120
5121 =item GUI::Native
5122
5123 =item foreach(reverse ...)
5124
5125 =item Constant function cache
5126
5127 =item Approximate regular expression matching
5128
5129 =back
5130
5131 =item Ongoing
5132
5133 =over 4
5134
5135 =item Update guts documentation
5136
5137 =item Add more tests
5138
5139 =item Update auxiliary tools
5140
5141 =item Create debugging macros
5142
5143 =item truncate to the people
5144
5145 =item Unicode in Filenames
5146
5147 =back
5148
5149 =item Unicode in %ENV
5150
5151 =item Recently done things
5152
5153 =over 4
5154
5155 =item Alternative RE syntax module
5156
5157 =item Safe signal handling
5158
5159 =item Tie Modules
5160
5161 =item gettimeofday
5162
5163 =item setitimer and getimiter
5164
5165 =item Testing __DIE__ hook
5166
5167 =item CPP equivalent in Perl
5168
5169 =item Explicit switch statements
5170
5171 =item autocroak
5172
5173 =item UTF/EBCDIC
5174
5175 =item UTF Regexes
5176
5177 =item perlcc to produce executable
5178
5179 =item END blocks saved in compiled output
5180
5181 =item Secure temporary file module
5182
5183 =item Integrate Time::HiRes
5184
5185 =item Turn Cwd into XS
5186
5187 =item Mmap for input
5188
5189 =item Byte to/from UTF8 and UTF8 to/from local conversion
5190
5191 =item Add sockatmark support
5192
5193 =item Mailing list archives
5194
5195 =item Bug tracking
5196
5197 =item Integrate MacPerl
5198
5199 =item Web "nerve center" for Perl
5200
5201 =item Regular expression tutorial
5202
5203 =item Debugging Tutorial
5204
5205 =item Integrate new modules
5206
5207 =item Integrate profiler
5208
5209 =item Y2K error detection
5210
5211 =item Regular expression debugger
5212
5213 =item POD checker
5214
5215 =item "Dynamic" lexicals
5216
5217 =item Cache precompiled modules
5218
5219 =back
5220
5221 =item Deprecated Wishes
5222
5223 =over 4
5224
5225 =item Loop control on do{}
5226
5227 =item Lexically scoped typeglobs
5228
5229 =item format BOTTOM
5230
5231 =item report HANDLE
5232
5233 =item Generalised want()/caller())
5234
5235 =item Named prototypes
5236
5237 =item Built-in globbing
5238
5239 =item Regression tests for suidperl
5240
5241 =item Cached hash values
5242
5243 =item Add compression modules
5244
5245 =item Reorganise documentation into tutorials/references
5246
5247 =item Remove distinction between functions and operators
5248
5249 =item Make XS easier to use
5250
5251 =item Make embedding easier to use
5252
5253 =item man for perl
5254
5255 =item my $Package::variable
5256
5257 =item "or" tests defined, not truth
5258
5259 =item "class"-based lexicals
5260
5261 =item byteperl
5262
5263 =item Lazy evaluation / tail recursion removal
5264
5265 =item Make "use utf8" the default
5266
5267 =item Unicode collation and normalization
5268
5269 =item pack/unpack tutorial
5270
5271 =back
5272
5273 =back
5274
5275 =head2 perlhack - How to hack at the Perl internals
5276
5277 =over 4
5278
5279 =item DESCRIPTION
5280
5281 Does concept match the general goals of Perl?, Where is the
5282 implementation?, Backwards compatibility, Could it be a module instead?, Is
5283 the feature generic enough?, Does it potentially introduce new bugs?, Does
5284 it preclude other desirable features?, Is the implementation robust?, Is
5285 the implementation generic enough to be portable?, Is the implementation
5286 tested?, Is there enough documentation?, Is there another way to do it?,
5287 Does it create too much work?, Patches speak louder than words
5288
5289 =over 4
5290
5291 =item Keeping in sync
5292
5293 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5294 NFS, rsync'ing the patches
5295
5296 =item Why rsync the source tree
5297
5298 It's easier to rsync the source tree, It's more reliable
5299
5300 =item Why rsync the patches
5301
5302 It's easier to rsync the patches, It's a good reference, Finding a start
5303 point, Finding how to fix a bug, Finding the source of misbehaviour
5304
5305 =item Perlbug administration
5306
5307 =item Submitting patches
5308
5309 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5310 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5311
5312 =item Finding Your Way Around
5313
5314 Core modules, Tests, Documentation, Configure, Interpreter
5315
5316 =item Elements of the interpreter
5317
5318 Startup, Parsing, Optimization, Running
5319
5320 =item Internal Variable Types
5321
5322 =item Op Trees
5323
5324 =item Stacks
5325
5326 Argument stack, Mark stack, Save stack
5327
5328 =item Millions of Macros
5329
5330 =item The .i Targets
5331
5332 =item Poking at Perl
5333
5334 =item Using a source-level debugger
5335
5336 run [args], break function_name, break source.c:xxx, step, next, continue,
5337 finish, 'enter', print
5338
5339 =item gdb macro support
5340
5341 =item Dumping Perl Data Structures
5342
5343 =item Patching
5344
5345 =item Patching a core module
5346
5347 =item Adding a new function to the core
5348
5349 =item Writing a test
5350
5351 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5352 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5353 t/cmd t/run t/io t/op, t/lib ext lib
5354
5355 =item Special Make Test Targets
5356
5357 coretest, test.deparse, minitest, test.third check.third utest.third
5358 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8,
5359 test_harness
5360
5361 =item Running tests by hand
5362
5363 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5364
5365 =back
5366
5367 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5368
5369 =over 4
5370
5371 =item Rational Software's Purify
5372
5373 =item Purify on Unix
5374
5375 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5376
5377 =item Purify on NT
5378
5379 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5380
5381 =item Compaq's/Digital's/HP's Third Degree
5382
5383 =item PERL_DESTRUCT_LEVEL
5384
5385 =item Profiling
5386
5387 =item Gprof Profiling
5388
5389 -a, -b, -e routine, -f routine, -s, -z
5390
5391 =item GCC gcov Profiling
5392
5393 =item Pixie Profiling
5394
5395 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5396 -z[ero]
5397
5398 =item Miscellaneous tricks
5399
5400 =item CONCLUSION
5401
5402 I<The Road goes ever on and on, down from the door where it began.>
5403
5404 =back
5405
5406 =item AUTHOR
5407
5408 =back
5409
5410 =head2 perldoc - Look up Perl documentation in Pod format.
5411
5412 =over 4
5413
5414 =item SYNOPSIS
5415
5416 =item DESCRIPTION
5417
5418 =item OPTIONS
5419
5420 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5421 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5422 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5423 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5424 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5425 B<-V>
5426
5427 =item SECURITY
5428
5429 =item ENVIRONMENT
5430
5431 =item AUTHOR
5432
5433 =back
5434
5435 =head2 perlhist - the Perl history records
5436
5437 =over 4
5438
5439 =item DESCRIPTION
5440
5441 =item INTRODUCTION
5442
5443 =item THE KEEPERS OF THE PUMPKIN
5444
5445 =over 4
5446
5447 =item PUMPKIN?
5448
5449 =back
5450
5451 =item THE RECORDS
5452
5453 =over 4
5454
5455 =item SELECTED RELEASE SIZES
5456
5457 =item SELECTED PATCH SIZES
5458
5459 =back
5460
5461 =item THE KEEPERS OF THE RECORDS
5462
5463 =back
5464
5465 =head2 perldelta - what is new for perl v5.9.0
5466
5467 =over 4
5468
5469 =item DESCRIPTION
5470
5471 =item Incompatible Changes
5472
5473 =over 4
5474
5475 =item The C<$*> variable has been removed
5476
5477 =back
5478
5479 =item Core Enhancements
5480
5481 =over 4
5482
5483 =item Tied Arrays with Negative Array Indices
5484
5485 =back
5486
5487 =item Modules and Pragmata
5488
5489 =item Utility Changes
5490
5491 =item New Documentation
5492
5493 =item Performance Enhancements
5494
5495 =item Installation and Configuration Improvements
5496
5497 =item Selected Bug Fixes
5498
5499 =item New or Changed Diagnostics
5500
5501 =item Changed Internals
5502
5503 =item New Tests
5504
5505 =item Known Problems
5506
5507 =item Platform Specific Problems
5508
5509 =item Reporting Bugs
5510
5511 =item SEE ALSO
5512
5513 =back
5514
5515 =head2 perl58delta, perldelta - what is new for perl v5.8.0
5516
5517 =over 4
5518
5519 =item DESCRIPTION
5520
5521 =item Highlights In 5.8.0
5522
5523 =item Incompatible Changes
5524
5525 =over 4
5526
5527 =item Binary Incompatibility
5528
5529 =item 64-bit platforms and malloc
5530
5531 =item AIX Dynaloading
5532
5533 =item Attributes for C<my> variables now handled at run-time
5534
5535 =item Socket Extension Dynamic in VMS
5536
5537 =item IEEE-format Floating Point Default on OpenVMS Alpha
5538
5539 =item New Unicode Semantics (no more C<use utf8>, almost)
5540
5541 =item New Unicode Properties
5542
5543 =item REF(...) Instead Of SCALAR(...)
5544
5545 =item pack/unpack D/F recycled
5546
5547 =item glob() now returns filenames in alphabetical order
5548
5549 =item Deprecations
5550
5551 =back
5552
5553 =item Core Enhancements
5554
5555 =over 4
5556
5557 =item Unicode Overhaul
5558
5559 =item PerlIO is Now The Default
5560
5561 =item ithreads
5562
5563 =item Restricted Hashes
5564
5565 =item Safe Signals
5566
5567 =item Understanding of Numbers
5568
5569 =item Arrays now always interpolate into double-quoted strings [561]
5570
5571 =item Miscellaneous Changes
5572
5573 =back
5574
5575 =item Modules and Pragmata
5576
5577 =over 4
5578
5579 =item New Modules and Pragmata
5580
5581 =item Updated And Improved Modules and Pragmata
5582
5583 =back
5584
5585 =item Utility Changes
5586
5587 =item New Documentation
5588
5589 =item Performance Enhancements
5590
5591 =item Installation and Configuration Improvements
5592
5593 =over 4
5594
5595 =item Generic Improvements
5596
5597 =item New Or Improved Platforms
5598
5599 =back
5600
5601 =item Selected Bug Fixes
5602
5603 =over 4
5604
5605 =item Platform Specific Changes and Fixes
5606
5607 =back
5608
5609 =item New or Changed Diagnostics
5610
5611 =item Changed Internals
5612
5613 =item Security Vulnerability Closed [561]
5614
5615 =item New Tests
5616
5617 =item Known Problems
5618
5619 =over 4
5620
5621 =item The Compiler Suite Is Still Very Experimental
5622
5623 =item Localising Tied Arrays and Hashes Is Broken
5624
5625 =item Building Extensions Can Fail Because Of Largefiles
5626
5627 =item Modifying $_ Inside for(..)
5628
5629 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5630
5631 =item lib/ftmp-security tests warn 'system possibly insecure'
5632
5633 =item libwww-perl (LWP) fails base/date #51
5634
5635 =item PDL failing some tests
5636
5637 =item Perl_get_sv
5638
5639 =item Self-tying Problems
5640
5641 =item ext/threads/t/libc
5642
5643 =item Failure of Thread (5.005-style) tests
5644
5645 =item Timing problems
5646
5647 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5648
5649 =item Unicode in package/class and subroutine names does not work
5650
5651 =back
5652
5653 =item Platform Specific Problems
5654
5655 =over 4
5656
5657 =item AIX
5658
5659 =item Alpha systems with old gccs fail several tests
5660
5661 =item AmigaOS
5662
5663 =item BeOS
5664
5665 =item Cygwin "unable to remap"
5666
5667 =item Cygwin ndbm tests fail on FAT
5668
5669 =item DJGPP Failures
5670
5671 =item FreeBSD built with ithreads coredumps reading large directories
5672
5673 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5674
5675 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5676
5677 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5678
5679 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5680
5681 =item Linux With Sfio Fails op/misc Test 48
5682
5683 =item Mac OS X
5684
5685 =item Mac OS X dyld undefined symbols
5686
5687 =item OS/2 Test Failures
5688
5689 =item op/sprintf tests 91, 129, and 130
5690
5691 =item SCO
5692
5693 =item Solaris 2.5
5694
5695 =item Solaris x86 Fails Tests With -Duse64bitint
5696
5697 =item SUPER-UX (NEC SX)
5698
5699 =item Term::ReadKey not working on Win32
5700
5701 =item UNICOS/mk
5702
5703 =item UTS
5704
5705 =item VOS (Stratus)
5706
5707 =item VMS
5708
5709 =item Win32
5710
5711 =item XML::Parser not working
5712
5713 =item z/OS (OS/390)
5714
5715 =item Unicode Support on EBCDIC Still Spotty
5716
5717 =item Seen In Perl 5.7 But Gone Now
5718
5719 =back
5720
5721 =item Reporting Bugs
5722
5723 =item SEE ALSO
5724
5725 =item HISTORY
5726
5727 =back
5728
5729 =head2 perl573delta - what's new for perl v5.7.3
5730
5731 =over 4
5732
5733 =item DESCRIPTION
5734
5735 =item Changes
5736
5737 =item Reporting Bugs
5738
5739 =item SEE ALSO
5740
5741 =item HISTORY
5742
5743 =back
5744
5745 =head2 perl572delta - what's new for perl v5.7.2
5746
5747 =over 4
5748
5749 =item DESCRIPTION
5750
5751 =item Security Vulnerability Closed
5752
5753 =item Incompatible Changes
5754
5755 =over 4
5756
5757 =item 64-bit platforms and malloc
5758
5759 =item AIX Dynaloading
5760
5761 =item Socket Extension Dynamic in VMS
5762
5763 =item Different Definition of the Unicode Character Classes \p{In...}
5764
5765 =item Deprecations
5766
5767 =back
5768
5769 =item Core Enhancements
5770
5771 =item Modules and Pragmata
5772
5773 =over 4
5774
5775 =item New Modules and Distributions
5776
5777 =item Updated And Improved Modules and Pragmata
5778
5779 =back
5780
5781 =item Utility Changes
5782
5783 =item New Documentation
5784
5785 =item Installation and Configuration Improvements
5786
5787 =over 4
5788
5789 =item New Or Improved Platforms
5790
5791 =item Generic Improvements
5792
5793 =back
5794
5795 =item Selected Bug Fixes
5796
5797 =over 4
5798
5799 =item Platform Specific Changes and Fixes
5800
5801 =back
5802
5803 =item New or Changed Diagnostics
5804
5805 =item Source Code Enhancements
5806
5807 =over 4
5808
5809 =item MAGIC constants
5810
5811 =item Better commented code
5812
5813 =item Regex pre-/post-compilation items matched up
5814
5815 =item gcc -Wall
5816
5817 =back
5818
5819 =item New Tests
5820
5821 =item Known Problems
5822
5823 =over 4
5824
5825 =item AIX
5826
5827 =item Amiga Perl Invoking Mystery
5828
5829 =item lib/ftmp-security tests warn 'system possibly insecure'
5830
5831 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5832
5833 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5834
5835 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5836
5837 =item Linux With Sfio Fails op/misc Test 48
5838
5839 =item OS/390
5840
5841 =item op/sprintf tests 129 and 130
5842
5843 =item  Failure of Thread tests
5844
5845 =item UNICOS
5846
5847 =item UTS
5848
5849 =item VMS
5850
5851 =item Win32
5852
5853 =item Localising a Tied Variable Leaks Memory
5854
5855 =item Self-tying of Arrays and Hashes Is Forbidden
5856
5857 =item Variable Attributes are not Currently Usable for Tieing
5858
5859 =item Building Extensions Can Fail Because Of Largefiles
5860
5861 =item The Compiler Suite Is Still Experimental
5862
5863 =item The Long Double Support is Still Experimental
5864
5865 =back
5866
5867 =item Reporting Bugs
5868
5869 =item SEE ALSO
5870
5871 =item HISTORY
5872
5873 =back
5874
5875 =head2 perl571delta - what's new for perl v5.7.1
5876
5877 =over 4
5878
5879 =item DESCRIPTION
5880
5881 =item Security Vulnerability Closed
5882
5883 =item Incompatible Changes
5884
5885 =item Core Enhancements
5886
5887 =over 4
5888
5889 =item AUTOLOAD Is Now Lvaluable
5890
5891 =item PerlIO is Now The Default
5892
5893 =item Signals Are Now Safe
5894
5895 =back
5896
5897 =item Modules and Pragmata
5898
5899 =over 4
5900
5901 =item New Modules
5902
5903 =item Updated And Improved Modules and Pragmata
5904
5905 =back
5906
5907 =item Performance Enhancements
5908
5909 =item Utility Changes
5910
5911 =item New Documentation
5912
5913 =over 4
5914
5915 =item perlclib
5916
5917 =item perliol
5918
5919 =item README.aix
5920
5921 =item README.bs2000
5922
5923 =item README.macos
5924
5925 =item README.mpeix
5926
5927 =item README.solaris
5928
5929 =item README.vos
5930
5931 =item Porting/repository.pod
5932
5933 =back
5934
5935 =item Installation and Configuration Improvements
5936
5937 =over 4
5938
5939 =item New Or Improved Platforms
5940
5941 =item Generic Improvements
5942
5943 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5944 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5945 d_strtoq, d_u32align, d_ualarm, d_usleep
5946
5947 =back
5948
5949 =item Selected Bug Fixes
5950
5951 =over 4
5952
5953 =item Platform Specific Changes and Fixes
5954
5955 =back
5956
5957 =item New or Changed Diagnostics
5958
5959 =item Changed Internals
5960
5961 =item New Tests
5962
5963 =item Known Problems
5964
5965 =over 4
5966
5967 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5968
5969 =item lib/ftmp-security tests warn 'system possibly insecure'
5970
5971 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5972
5973 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5974
5975 =item lib/b test 19
5976
5977 =item Linux With Sfio Fails op/misc Test 48
5978
5979 =item sigaction test 13 in VMS
5980
5981 =item sprintf tests 129 and 130
5982
5983 =item  Failure of Thread tests
5984
5985 =item Localising a Tied Variable Leaks Memory
5986
5987 =item Self-tying of Arrays and Hashes Is Forbidden
5988
5989 =item Building Extensions Can Fail Because Of Largefiles
5990
5991 =item The Compiler Suite Is Still Experimental
5992
5993 =back
5994
5995 =item Reporting Bugs
5996
5997 =item SEE ALSO
5998
5999 =item HISTORY
6000
6001 =back
6002
6003 =head2 perl570delta - what's new for perl v5.7.0
6004
6005 =over 4
6006
6007 =item DESCRIPTION
6008
6009 =item Security Vulnerability Closed
6010
6011 =item Incompatible Changes
6012
6013 =item Core Enhancements
6014
6015 =item Modules and Pragmata
6016
6017 =over 4
6018
6019 =item New Modules
6020
6021 =item Updated And Improved Modules and Pragmata
6022
6023 =back
6024
6025 =item Utility Changes
6026
6027 =item New Documentation
6028
6029 =item Performance Enhancements
6030
6031 =item Installation and Configuration Improvements
6032
6033 =over 4
6034
6035 =item Generic Improvements
6036
6037 =back
6038
6039 =item Selected Bug Fixes
6040
6041 =over 4
6042
6043 =item Platform Specific Changes and Fixes
6044
6045 =back
6046
6047 =item New or Changed Diagnostics
6048
6049 =item Changed Internals
6050
6051 =item Known Problems
6052
6053 =over 4
6054
6055 =item Unicode Support Still Far From Perfect
6056
6057 =item EBCDIC Still A Lost Platform
6058
6059 =item Building Extensions Can Fail Because Of Largefiles
6060
6061 =item ftmp-security tests warn 'system possibly insecure'
6062
6063 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6064
6065 =item Long Doubles Still Don't Work In Solaris
6066
6067 =item Linux With Sfio Fails op/misc Test 48
6068
6069 =item Storable tests fail in some platforms
6070
6071 =item Threads Are Still Experimental
6072
6073 =item The Compiler Suite Is Still Experimental
6074
6075 =back
6076
6077 =item Reporting Bugs
6078
6079 =item SEE ALSO
6080
6081 =item HISTORY
6082
6083 =back
6084
6085 =head2 perl561delta - what's new for perl v5.6.x
6086
6087 =over 4
6088
6089 =item DESCRIPTION
6090
6091 =item Summary of changes between 5.6.0 and 5.6.1
6092
6093 =over 4
6094
6095 =item Security Issues
6096
6097 =item Core bug fixes
6098
6099 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6100 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6101 references to special variables, Lexical warnings, Spurious warnings and
6102 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6103 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6104 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6105 Module;>, Tests
6106
6107 =item Core features
6108
6109 =item Configuration issues
6110
6111 =item Documentation
6112
6113 =item Bundled modules
6114
6115 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6116 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6117 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6118 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6119
6120 =item Platform-specific improvements
6121
6122 NCR MP-RAS, NonStop-UX
6123
6124 =back
6125
6126 =item Core Enhancements
6127
6128 =over 4
6129
6130 =item Interpreter cloning, threads, and concurrency
6131
6132 =item Lexically scoped warning categories
6133
6134 =item Unicode and UTF-8 support
6135
6136 =item Support for interpolating named characters
6137
6138 =item "our" declarations
6139
6140 =item Support for strings represented as a vector of ordinals
6141
6142 =item Improved Perl version numbering system
6143
6144 =item New syntax for declaring subroutine attributes
6145
6146 =item File and directory handles can be autovivified
6147
6148 =item open() with more than two arguments
6149
6150 =item 64-bit support
6151
6152 =item Large file support
6153
6154 =item Long doubles
6155
6156 =item "more bits"
6157
6158 =item Enhanced support for sort() subroutines
6159
6160 =item C<sort $coderef @foo> allowed
6161
6162 =item File globbing implemented internally
6163
6164 =item Support for CHECK blocks
6165
6166 =item POSIX character class syntax [: :] supported
6167
6168 =item Better pseudo-random number generator
6169
6170 =item Improved C<qw//> operator
6171
6172 =item Better worst-case behavior of hashes
6173
6174 =item pack() format 'Z' supported
6175
6176 =item pack() format modifier '!' supported
6177
6178 =item pack() and unpack() support counted strings
6179
6180 =item Comments in pack() templates
6181
6182 =item Weak references
6183
6184 =item Binary numbers supported
6185
6186 =item Lvalue subroutines
6187
6188 =item Some arrows may be omitted in calls through references
6189
6190 =item Boolean assignment operators are legal lvalues
6191
6192 =item exists() is supported on subroutine names
6193
6194 =item exists() and delete() are supported on array elements
6195
6196 =item Pseudo-hashes work better
6197
6198 =item Automatic flushing of output buffers
6199
6200 =item Better diagnostics on meaningless filehandle operations
6201
6202 =item Where possible, buffered data discarded from duped input filehandle
6203
6204 =item eof() has the same old magic as <>
6205
6206 =item binmode() can be used to set :crlf and :raw modes
6207
6208 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6209
6210 =item system(), backticks and pipe open now reflect exec() failure
6211
6212 =item Improved diagnostics
6213
6214 =item Diagnostics follow STDERR
6215
6216 =item More consistent close-on-exec behavior
6217
6218 =item syswrite() ease-of-use
6219
6220 =item Better syntax checks on parenthesized unary operators
6221
6222 =item Bit operators support full native integer width
6223
6224 =item Improved security features
6225
6226 =item More functional bareword prototype (*)
6227
6228 =item C<require> and C<do> may be overridden
6229
6230 =item $^X variables may now have names longer than one character
6231
6232 =item New variable $^C reflects C<-c> switch
6233
6234 =item New variable $^V contains Perl version as a string
6235
6236 =item Optional Y2K warnings
6237
6238 =item Arrays now always interpolate into double-quoted strings
6239
6240 =back
6241
6242 =item Modules and Pragmata
6243
6244 =over 4
6245
6246 =item Modules
6247
6248 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6249 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6250 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6251 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6252 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6253 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6254 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6255 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6256
6257 =item Pragmata
6258
6259 =back
6260
6261 =item Utility Changes
6262
6263 =over 4
6264
6265 =item dprofpp
6266
6267 =item find2perl
6268
6269 =item h2xs
6270
6271 =item perlcc
6272
6273 =item perldoc
6274
6275 =item The Perl Debugger
6276
6277 =back
6278
6279 =item Improved Documentation
6280
6281 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6282 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6283 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6284 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6285
6286 =item Performance enhancements
6287
6288 =over 4
6289
6290 =item Simple sort() using { $a <=> $b } and the like are optimized
6291
6292 =item Optimized assignments to lexical variables
6293
6294 =item Faster subroutine calls
6295
6296 =item delete(), each(), values() and hash iteration are faster
6297
6298 =back
6299
6300 =item Installation and Configuration Improvements
6301
6302 =over 4
6303
6304 =item -Dusethreads means something different
6305
6306 =item New Configure flags
6307
6308 =item Threadedness and 64-bitness now more daring
6309
6310 =item Long Doubles
6311
6312 =item -Dusemorebits
6313
6314 =item -Duselargefiles
6315
6316 =item installusrbinperl
6317
6318 =item SOCKS support
6319
6320 =item C<-A> flag
6321
6322 =item Enhanced Installation Directories
6323
6324 =item gcc automatically tried if 'cc' does not seem to be working
6325
6326 =back
6327
6328 =item Platform specific changes
6329
6330 =over 4
6331
6332 =item Supported platforms
6333
6334 =item DOS
6335
6336 =item OS390 (OpenEdition MVS)
6337
6338 =item VMS
6339
6340 =item Win32
6341
6342 =back
6343
6344 =item Significant bug fixes
6345
6346 =over 4
6347
6348 =item <HANDLE> on empty files
6349
6350 =item C<eval '...'> improvements
6351
6352 =item All compilation errors are true errors
6353
6354 =item Implicitly closed filehandles are safer
6355
6356 =item Behavior of list slices is more consistent
6357
6358 =item C<(\$)> prototype and C<$foo{a}>
6359
6360 =item C<goto &sub> and AUTOLOAD
6361
6362 =item C<-bareword> allowed under C<use integer>
6363
6364 =item Failures in DESTROY()
6365
6366 =item Locale bugs fixed
6367
6368 =item Memory leaks
6369
6370 =item Spurious subroutine stubs after failed subroutine calls
6371
6372 =item Taint failures under C<-U>
6373
6374 =item END blocks and the C<-c> switch
6375
6376 =item Potential to leak DATA filehandles
6377
6378 =back
6379
6380 =item New or Changed Diagnostics
6381
6382 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6383 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6384 / cannot take a count, / must be followed by a, A or Z, / must be followed
6385 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6386 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6387 passed through, /%s/ should probably be written as "%s", %s() called too
6388 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6389 argument is not a HASH or ARRAY element or slice, %s argument is not a
6390 subroutine name, %s package attribute may clash with future reserved word:
6391 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6392 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6393 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6394 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6395 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6396 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6397 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6398 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6399 weaken a nonreference, Character class [:%s:] unknown, Character class
6400 syntax [%s] belongs inside character classes, Constant is not %s reference,
6401 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6402 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6403 "local" instead of "our"?), Document contains no data, entering effective
6404 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6405 output, flock() on closed filehandle %s, Global symbol "%s" requires
6406 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6407 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6408 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6409 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6410 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6411 separator character %s in attribute list, Invalid separator character %s in
6412 subroutine attribute list, leaving effective %s failed, Lvalue subs
6413 returning %s not implemented yet, Method %s not permitted, Missing
6414 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6415 No %s specified for -%c, No package name allowed for variable %s in "our",
6416 No space allowed after -%c, no UTC offset information; assuming local time
6417 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6418 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6419 around "%s" list, Possible unintended interpolation of %s in string,
6420 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6421 instead, Premature end of script headers, Repeat count in pack overflows,
6422 Repeat count in unpack overflows, realloc() of freed memory ignored,
6423 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6424 zero-length expression, switching effective %s is not implemented, This
6425 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6426 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6427 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6428 escape \\%c passed through, Unterminated attribute parameter in attribute
6429 list, Unterminated attribute list, Unterminated attribute parameter in
6430 subroutine attribute list, Unterminated subroutine attribute list, Value of
6431 CLI symbol "%s" too long, Version number must be a constant number
6432
6433 =item New tests
6434
6435 =item Incompatible Changes
6436
6437 =over 4
6438
6439 =item Perl Source Incompatibilities
6440
6441 CHECK is a new keyword, Treatment of list slices of undef has changed,
6442 Format of $English::PERL_VERSION is different, Literals of the form
6443 C<1.2.3> parse differently, Possibly changed pseudo-random number
6444 generator, Hashing function for hash keys has changed, C<undef> fails on
6445 read only values, Close-on-exec bit may be set on pipe and socket handles,
6446 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6447 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6448 Text of some diagnostic output has changed, C<%@> has been removed,
6449 Parenthesized not() behaves like a list operator, Semantics of bareword
6450 prototype C<(*)> have changed, Semantics of bit operators may have changed
6451 on 64-bit platforms, More builtins taint their results
6452
6453 =item C Source Incompatibilities
6454
6455 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6456
6457 =item Compatible C Source API Changes
6458
6459 C<PATCHLEVEL> is now C<PERL_VERSION>
6460
6461 =item Binary Incompatibilities
6462
6463 =back
6464
6465 =item Known Problems
6466
6467 =over 4
6468
6469 =item Localizing a tied hash element may leak memory
6470
6471 =item Known test failures
6472
6473 =item EBCDIC platforms not fully supported
6474
6475 =item UNICOS/mk CC failures during Configure run
6476
6477 =item Arrow operator and arrays
6478
6479 =item Experimental features
6480
6481 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6482 pseudo-hash data type, The Compiler suite, Internal implementation of file
6483 globbing, The DB module, The regular expression code constructs:
6484
6485 =back
6486
6487 =item Obsolete Diagnostics
6488
6489 Character class syntax [: :] is reserved for future extensions, Ill-formed
6490 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6491 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6492 to mean "${$}<digit>" is deprecated
6493
6494 =item Reporting Bugs
6495
6496 =item SEE ALSO
6497
6498 =item HISTORY
6499
6500 =back
6501
6502 =head2 perl56delta - what's new for perl v5.6.0
6503
6504 =over 4
6505
6506 =item DESCRIPTION
6507
6508 =item Core Enhancements
6509
6510 =over 4
6511
6512 =item Interpreter cloning, threads, and concurrency
6513
6514 =item Lexically scoped warning categories
6515
6516 =item Unicode and UTF-8 support
6517
6518 =item Support for interpolating named characters
6519
6520 =item "our" declarations
6521
6522 =item Support for strings represented as a vector of ordinals
6523
6524 =item Improved Perl version numbering system
6525
6526 =item New syntax for declaring subroutine attributes
6527
6528 =item File and directory handles can be autovivified
6529
6530 =item open() with more than two arguments
6531
6532 =item 64-bit support
6533
6534 =item Large file support
6535
6536 =item Long doubles
6537
6538 =item "more bits"
6539
6540 =item Enhanced support for sort() subroutines
6541
6542 =item C<sort $coderef @foo> allowed
6543
6544 =item File globbing implemented internally
6545
6546 =item Support for CHECK blocks
6547
6548 =item POSIX character class syntax [: :] supported
6549
6550 =item Better pseudo-random number generator
6551
6552 =item Improved C<qw//> operator
6553
6554 =item Better worst-case behavior of hashes
6555
6556 =item pack() format 'Z' supported
6557
6558 =item pack() format modifier '!' supported
6559
6560 =item pack() and unpack() support counted strings
6561
6562 =item Comments in pack() templates
6563
6564 =item Weak references
6565
6566 =item Binary numbers supported
6567
6568 =item Lvalue subroutines
6569
6570 =item Some arrows may be omitted in calls through references
6571
6572 =item Boolean assignment operators are legal lvalues
6573
6574 =item exists() is supported on subroutine names
6575
6576 =item exists() and delete() are supported on array elements
6577
6578 =item Pseudo-hashes work better
6579
6580 =item Automatic flushing of output buffers
6581
6582 =item Better diagnostics on meaningless filehandle operations
6583
6584 =item Where possible, buffered data discarded from duped input filehandle
6585
6586 =item eof() has the same old magic as <>
6587
6588 =item binmode() can be used to set :crlf and :raw modes
6589
6590 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6591
6592 =item system(), backticks and pipe open now reflect exec() failure
6593
6594 =item Improved diagnostics
6595
6596 =item Diagnostics follow STDERR
6597
6598 =item More consistent close-on-exec behavior
6599
6600 =item syswrite() ease-of-use
6601
6602 =item Better syntax checks on parenthesized unary operators
6603
6604 =item Bit operators support full native integer width
6605
6606 =item Improved security features
6607
6608 =item More functional bareword prototype (*)
6609
6610 =item C<require> and C<do> may be overridden
6611
6612 =item $^X variables may now have names longer than one character
6613
6614 =item New variable $^C reflects C<-c> switch
6615
6616 =item New variable $^V contains Perl version as a string
6617
6618 =item Optional Y2K warnings
6619
6620 =item Arrays now always interpolate into double-quoted strings
6621
6622 =back
6623
6624 =item Modules and Pragmata
6625
6626 =over 4
6627
6628 =item Modules
6629
6630 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6631 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6632 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6633 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6634 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6635 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6636 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6637 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6638
6639 =item Pragmata
6640
6641 =back
6642
6643 =item Utility Changes
6644
6645 =over 4
6646
6647 =item dprofpp
6648
6649 =item find2perl
6650
6651 =item h2xs
6652
6653 =item perlcc
6654
6655 =item perldoc
6656
6657 =item The Perl Debugger
6658
6659 =back
6660
6661 =item Improved Documentation
6662
6663 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6664 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6665 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6666 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6667
6668 =item Performance enhancements
6669
6670 =over 4
6671
6672 =item Simple sort() using { $a <=> $b } and the like are optimized
6673
6674 =item Optimized assignments to lexical variables
6675
6676 =item Faster subroutine calls
6677
6678 =item delete(), each(), values() and hash iteration are faster
6679
6680 =back
6681
6682 =item Installation and Configuration Improvements
6683
6684 =over 4
6685
6686 =item -Dusethreads means something different
6687
6688 =item New Configure flags
6689
6690 =item Threadedness and 64-bitness now more daring
6691
6692 =item Long Doubles
6693
6694 =item -Dusemorebits
6695
6696 =item -Duselargefiles
6697
6698 =item installusrbinperl
6699
6700 =item SOCKS support
6701
6702 =item C<-A> flag
6703
6704 =item Enhanced Installation Directories
6705
6706 =back
6707
6708 =item Platform specific changes
6709
6710 =over 4
6711
6712 =item Supported platforms
6713
6714 =item DOS
6715
6716 =item OS390 (OpenEdition MVS)
6717
6718 =item VMS
6719
6720 =item Win32
6721
6722 =back
6723
6724 =item Significant bug fixes
6725
6726 =over 4
6727
6728 =item <HANDLE> on empty files
6729
6730 =item C<eval '...'> improvements
6731
6732 =item All compilation errors are true errors
6733
6734 =item Implicitly closed filehandles are safer
6735
6736 =item Behavior of list slices is more consistent
6737
6738 =item C<(\$)> prototype and C<$foo{a}>
6739
6740 =item C<goto &sub> and AUTOLOAD
6741
6742 =item C<-bareword> allowed under C<use integer>
6743
6744 =item Failures in DESTROY()
6745
6746 =item Locale bugs fixed
6747
6748 =item Memory leaks
6749
6750 =item Spurious subroutine stubs after failed subroutine calls
6751
6752 =item Taint failures under C<-U>
6753
6754 =item END blocks and the C<-c> switch
6755
6756 =item Potential to leak DATA filehandles
6757
6758 =back
6759
6760 =item New or Changed Diagnostics
6761
6762 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6763 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6764 / cannot take a count, / must be followed by a, A or Z, / must be followed
6765 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6766 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6767 passed through, /%s/ should probably be written as "%s", %s() called too
6768 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6769 argument is not a HASH or ARRAY element or slice, %s argument is not a
6770 subroutine name, %s package attribute may clash with future reserved word:
6771 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6772 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6773 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6774 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6775 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6776 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6777 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6778 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6779 weaken a nonreference, Character class [:%s:] unknown, Character class
6780 syntax [%s] belongs inside character classes, Constant is not %s reference,
6781 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6782 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6783 "local" instead of "our"?), Document contains no data, entering effective
6784 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6785 output, flock() on closed filehandle %s, Global symbol "%s" requires
6786 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6787 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6788 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6789 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6790 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6791 separator character %s in attribute list, Invalid separator character %s in
6792 subroutine attribute list, leaving effective %s failed, Lvalue subs
6793 returning %s not implemented yet, Method %s not permitted, Missing
6794 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6795 No %s specified for -%c, No package name allowed for variable %s in "our",
6796 No space allowed after -%c, no UTC offset information; assuming local time
6797 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6798 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6799 around "%s" list, Possible unintended interpolation of %s in string,
6800 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6801 instead, Premature end of script headers, Repeat count in pack overflows,
6802 Repeat count in unpack overflows, realloc() of freed memory ignored,
6803 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6804 zero-length expression, switching effective %s is not implemented, This
6805 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6806 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6807 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6808 escape \\%c passed through, Unterminated attribute parameter in attribute
6809 list, Unterminated attribute list, Unterminated attribute parameter in
6810 subroutine attribute list, Unterminated subroutine attribute list, Value of
6811 CLI symbol "%s" too long, Version number must be a constant number
6812
6813 =item New tests
6814
6815 =item Incompatible Changes
6816
6817 =over 4
6818
6819 =item Perl Source Incompatibilities
6820
6821 CHECK is a new keyword, Treatment of list slices of undef has changed,
6822 Format of $English::PERL_VERSION is different, Literals of the form
6823 C<1.2.3> parse differently, Possibly changed pseudo-random number
6824 generator, Hashing function for hash keys has changed, C<undef> fails on
6825 read only values, Close-on-exec bit may be set on pipe and socket handles,
6826 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6827 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6828 Text of some diagnostic output has changed, C<%@> has been removed,
6829 Parenthesized not() behaves like a list operator, Semantics of bareword
6830 prototype C<(*)> have changed, Semantics of bit operators may have changed
6831 on 64-bit platforms, More builtins taint their results
6832
6833 =item C Source Incompatibilities
6834
6835 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6836
6837 =item Compatible C Source API Changes
6838
6839 C<PATCHLEVEL> is now C<PERL_VERSION>
6840
6841 =item Binary Incompatibilities
6842
6843 =back
6844
6845 =item Known Problems
6846
6847 =over 4
6848
6849 =item Thread test failures
6850
6851 =item EBCDIC platforms not supported
6852
6853 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6854
6855 =item NEXTSTEP 3.3 POSIX test failure
6856
6857 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6858 gcc
6859
6860 =item UNICOS/mk CC failures during Configure run
6861
6862 =item Arrow operator and arrays
6863
6864 =item Experimental features
6865
6866 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6867 pseudo-hash data type, The Compiler suite, Internal implementation of file
6868 globbing, The DB module, The regular expression code constructs:
6869
6870 =back
6871
6872 =item Obsolete Diagnostics
6873
6874 Character class syntax [: :] is reserved for future extensions, Ill-formed
6875 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6876 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6877 to mean "${$}<digit>" is deprecated
6878
6879 =item Reporting Bugs
6880
6881 =item SEE ALSO
6882
6883 =item HISTORY
6884
6885 =back
6886
6887 =head2 perl5005delta - what's new for perl5.005
6888
6889 =over 4
6890
6891 =item DESCRIPTION
6892
6893 =item About the new versioning system
6894
6895 =item Incompatible Changes
6896
6897 =over 4
6898
6899 =item WARNING:  This version is not binary compatible with Perl 5.004.
6900
6901 =item Default installation structure has changed
6902
6903 =item Perl Source Compatibility
6904
6905 =item C Source Compatibility
6906
6907 =item Binary Compatibility
6908
6909 =item Security fixes may affect compatibility
6910
6911 =item Relaxed new mandatory warnings introduced in 5.004
6912
6913 =item Licensing
6914
6915 =back
6916
6917 =item Core Changes
6918
6919 =over 4
6920
6921 =item Threads
6922
6923 =item Compiler
6924
6925 =item Regular Expressions
6926
6927 Many new and improved optimizations, Many bug fixes, New regular expression
6928 constructs, New operator for precompiled regular expressions, Other
6929 improvements, Incompatible changes
6930
6931 =item   Improved malloc()
6932
6933 =item Quicksort is internally implemented
6934
6935 =item Reliable signals
6936
6937 =item Reliable stack pointers
6938
6939 =item More generous treatment of carriage returns
6940
6941 =item Memory leaks
6942
6943 =item Better support for multiple interpreters
6944
6945 =item Behavior of local() on array and hash elements is now well-defined
6946
6947 =item C<%!> is transparently tied to the L<Errno> module
6948
6949 =item Pseudo-hashes are supported
6950
6951 =item C<EXPR foreach EXPR> is supported
6952
6953 =item Keywords can be globally overridden
6954
6955 =item C<$^E> is meaningful on Win32
6956
6957 =item C<foreach (1..1000000)> optimized
6958
6959 =item C<Foo::> can be used as implicitly quoted package name
6960
6961 =item C<exists $Foo::{Bar::}> tests existence of a package
6962
6963 =item Better locale support
6964
6965 =item Experimental support for 64-bit platforms
6966
6967 =item prototype() returns useful results on builtins
6968
6969 =item Extended support for exception handling
6970
6971 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6972
6973 =item All C<printf> format conversions are handled internally
6974
6975 =item New C<INIT> keyword
6976
6977 =item New C<lock> keyword
6978
6979 =item New C<qr//> operator
6980
6981 =item C<our> is now a reserved word
6982
6983 =item Tied arrays are now fully supported
6984
6985 =item Tied handles support is better
6986
6987 =item 4th argument to substr
6988
6989 =item Negative LENGTH argument to splice
6990
6991 =item Magic lvalues are now more magical
6992
6993 =item <> now reads in records
6994
6995 =back
6996
6997 =item Supported Platforms
6998
6999 =over 4
7000
7001 =item New Platforms
7002
7003 =item Changes in existing support
7004
7005 =back
7006
7007 =item Modules and Pragmata
7008
7009 =over 4
7010
7011 =item New Modules
7012
7013 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7014 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7015 Thread, attrs, fields, re
7016
7017 =item Changes in existing modules
7018
7019 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7020 MakeMaker, CPAN, Cwd
7021
7022 =back
7023
7024 =item Utility Changes
7025
7026 =item Documentation Changes
7027
7028 =item New Diagnostics
7029
7030 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7031 while coercing array into hash, Bareword "%s" refers to nonexistent
7032 package, Can't call method "%s" on an undefined value, Can't check
7033 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7034 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7035 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7036 for "%s", Character class syntax [. .] is reserved for future extensions,
7037 Character class syntax [: :] is reserved for future extensions, Character
7038 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7039 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7040 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7041 package main), Illegal hex digit ignored, No such array field, No such
7042 field "%s" in variable %s of type %s, Out of memory during ridiculously
7043 large request, Range iterator outside integer range, Recursive inheritance
7044 detected while looking for method '%s' %s, Reference found where even-sized
7045 list expected, Undefined value assigned to typeglob, Use of reserved word
7046 "%s" is deprecated, perl: warning: Setting locale failed
7047
7048 =item Obsolete Diagnostics
7049
7050 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7051 temporary file, regexp too big
7052
7053 =item Configuration Changes
7054
7055 =item BUGS
7056
7057 =item SEE ALSO
7058
7059 =item HISTORY
7060
7061 =back
7062
7063 =head2 perl5004delta - what's new for perl5.004
7064
7065 =over 4
7066
7067 =item DESCRIPTION
7068
7069 =item Supported Environments
7070
7071 =item Core Changes
7072
7073 =over 4
7074
7075 =item List assignment to %ENV works
7076
7077 =item Change to "Can't locate Foo.pm in @INC" error
7078
7079 =item Compilation option: Binary compatibility with 5.003
7080
7081 =item $PERL5OPT environment variable
7082
7083 =item Limitations on B<-M>, B<-m>, and B<-T> options
7084
7085 =item More precise warnings
7086
7087 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7088
7089 =item Previously deprecated %OVERLOAD is no longer usable
7090
7091 =item Subroutine arguments created only when they're modified
7092
7093 =item Group vector changeable with C<$)>
7094
7095 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7096
7097 =item Fixed localization of $<digit>, $&, etc.
7098
7099 =item No resetting of $. on implicit close
7100
7101 =item C<wantarray> may return undef
7102
7103 =item C<eval EXPR> determines value of EXPR in scalar context
7104
7105 =item Changes to tainting checks
7106
7107 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7108 spawning if tainted $TERM doesn't look like a terminal name
7109
7110 =item New Opcode module and revised Safe module
7111
7112 =item Embedding improvements
7113
7114 =item Internal change: FileHandle class based on IO::* classes
7115
7116 =item Internal change: PerlIO abstraction interface
7117
7118 =item New and changed syntax
7119
7120 $coderef->(PARAMS)
7121
7122 =item New and changed builtin constants
7123
7124 __PACKAGE__
7125
7126 =item New and changed builtin variables
7127
7128 $^E, $^H, $^M
7129
7130 =item New and changed builtin functions
7131
7132 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7133 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7134 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7135 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7136 nested C<sub{}> closures work now, formats work right on changing lexicals
7137
7138 =item New builtin methods
7139
7140 isa(CLASS), can(METHOD), VERSION( [NEED] )
7141
7142 =item TIEHANDLE now supported
7143
7144 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7145 LIST, READLINE this, GETC this, DESTROY this
7146
7147 =item Malloc enhancements
7148
7149 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7150
7151 =item Miscellaneous efficiency enhancements
7152
7153 =back
7154
7155 =item Support for More Operating Systems
7156
7157 =over 4
7158
7159 =item Win32
7160
7161 =item Plan 9
7162
7163 =item QNX
7164
7165 =item AmigaOS
7166
7167 =back
7168
7169 =item Pragmata
7170
7171 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7172 constant NAME => VALUE, use locale, use ops, use vmsish
7173
7174 =item Modules
7175
7176 =over 4
7177
7178 =item Required Updates
7179
7180 =item Installation directories
7181
7182 =item Module information summary
7183
7184 =item Fcntl
7185
7186 =item IO
7187
7188 =item Math::Complex
7189
7190 =item Math::Trig
7191
7192 =item DB_File
7193
7194 =item Net::Ping
7195
7196 =item Object-oriented overrides for builtin operators
7197
7198 =back
7199
7200 =item Utility Changes
7201
7202 =over 4
7203
7204 =item pod2html
7205
7206 Sends converted HTML to standard output
7207
7208 =item xsubpp
7209
7210 C<void> XSUBs now default to returning nothing
7211
7212 =back
7213
7214 =item C Language API Changes
7215
7216 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7217 manipulating hashes
7218
7219 =item Documentation Changes
7220
7221 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7222 L<perlmodlib>, L<perldebug>, L<perlsec>
7223
7224 =item New Diagnostics
7225
7226 "my" variable %s masks earlier declaration in same scope, %s argument is
7227 not a HASH element or slice, Allocation too large: %lx, Allocation too
7228 large, Applying %s to %s will act on scalar(%s), Attempt to free
7229 nonexistent shared string, Attempt to use reference as lvalue in substr,
7230 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7231 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7232 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7233 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7234 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7235 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7236 %s, Integer overflow in hex number, Integer overflow in octal number,
7237 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7238 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7239 possible typo, Null picture in formline, Offset outside string, Out of
7240 memory!, Out of memory during request for %s, panic: frexp, Possible
7241 attempt to put comments in qw() list, Possible attempt to separate words
7242 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7243 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7244 option, untie attempted while %d inner references still exist, Unrecognized
7245 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7246 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7247 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7248 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7249 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7250 long, Process terminated by SIG%s
7251
7252 =item BUGS
7253
7254 =item SEE ALSO
7255
7256 =item HISTORY
7257
7258 =back
7259
7260 =head2 perlartistic -- the Perl Artistic License
7261
7262 =over 4
7263
7264 =item SYNOPSIS
7265
7266 =item DESCRIPTION
7267
7268 =item The "Artistic License"
7269
7270 =over 4
7271
7272 =item Preamble
7273
7274 =item Definitions
7275
7276 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7277 copying fee", "Freely Available"
7278
7279 =item Conditions
7280
7281 a), b), c), d), a), b), c), d)
7282
7283 =back
7284
7285 =back
7286
7287 =head2 perlgpl -- the GNU Public General Public License, version 2
7288
7289 =over 4
7290
7291 =item SYNOPSIS
7292
7293 =back
7294
7295 =over 4
7296
7297 =item DESCRIPTION
7298
7299 =item GNU GENERAL PUBLIC LICENSE
7300
7301 =back
7302
7303 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7304
7305 =over 4
7306
7307 =item DESCRIPTION
7308
7309 =over 4
7310
7311 =item Compiling Perl 5 on AIX
7312
7313 =item OS level
7314
7315 =item Building Dynamic Extensions on AIX
7316
7317 =item The IBM ANSI C Compiler
7318
7319 =item Using GNU's gcc for building perl
7320
7321 =item Using Large Files with Perl
7322
7323 =item Threaded Perl
7324
7325 =item 64-bit Perl
7326
7327 =item AIX 4.2 and extensions using C++ with statics
7328
7329 =back
7330
7331 =item AUTHOR
7332
7333 =item DATE
7334
7335 =back
7336
7337 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7338
7339 =over 4
7340
7341 =item DESCRIPTION
7342
7343 =item AUTHOR
7344
7345 =back
7346
7347 =head2 perlamiga - Perl under Amiga OS
7348
7349 =over 4
7350
7351 =item NOTE
7352
7353 =item SYNOPSIS
7354
7355 =back
7356
7357 =over 4
7358
7359 =item DESCRIPTION
7360
7361 =over 4
7362
7363 =item Prerequisites for Compiling Perl on AmigaOS
7364
7365 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7366
7367 =item Starting Perl programs under AmigaOS
7368
7369 =item Shortcomings of Perl under AmigaOS
7370
7371 =back
7372
7373 =item INSTALLATION
7374
7375 =item Accessing documentation
7376
7377 =over 4
7378
7379 =item Manpages for Perl on AmigaOS
7380
7381 =item Perl HTML Documentation on AmigaOS
7382
7383 =item Perl GNU Info Files on AmigaOS
7384
7385 =item Perl LaTeX Documentation on AmigaOS
7386
7387 =back
7388
7389 =item BUILDING PERL ON AMIGAOS
7390
7391 =over 4
7392
7393 =item Build Prerequisites for Perl on AmigaOS
7394
7395 =item Getting the Perl Source for AmigaOS
7396
7397 =item Making Perl on AmigaOS
7398
7399 =item Testing Perl on AmigaOS
7400
7401 =item Installing the built Perl on AmigaOS
7402
7403 =back
7404
7405 =item PERL 5.8.0 BROKEN IN AMIGAOS
7406
7407 =item AUTHORS
7408
7409 =item SEE ALSO
7410
7411 =back
7412
7413 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7414
7415 =over 4
7416
7417 =item DESCRIPTION
7418
7419 =over 4
7420
7421 =item General Issues with Perl on BeOS
7422
7423 =item BeOS Release-specific Notes
7424
7425 R4 x86, R4 PPC
7426
7427 =item Contact Information
7428
7429 =item Update 2002-05-30
7430
7431 =back
7432
7433 =back
7434
7435 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7436
7437 =over 4
7438
7439 =item SYNOPSIS
7440
7441 =item DESCRIPTION
7442
7443 =over 4
7444
7445 =item gzip on BS2000
7446
7447 =item bison on BS2000
7448
7449 =item Unpacking Perl Distribution on BS2000
7450
7451 =item Compiling Perl on BS2000
7452
7453 =item Testing Perl on BS2000
7454
7455 =item Installing Perl on BS2000
7456
7457 =item Using Perl in the Posix-Shell of BS2000
7458
7459 =item Using Perl in "native" BS2000
7460
7461 =item Floating point anomalies on BS2000
7462
7463 =back
7464
7465 =item AUTHORS
7466
7467 =item SEE ALSO
7468
7469 =over 4
7470
7471 =item Mailing list
7472
7473 =back
7474
7475 =item HISTORY
7476
7477 =back
7478
7479 =over 4
7480
7481 =item Name
7482
7483 =item Description
7484
7485 =item Build
7486
7487 =over 4
7488
7489 =item Tools & SDK
7490
7491 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7492 celib-sources, Rainer Keuchel's console-sources
7493
7494 =item Make
7495
7496 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run
7497   compile.bat dist
7498
7499 =back
7500
7501 =item Acknowledgements
7502
7503 =item AUTHORS
7504
7505 =back
7506
7507 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7508
7509 =over 4
7510
7511 =item SYNOPSIS
7512
7513 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7514
7515 =over 4
7516
7517 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7518
7519 =item Cygwin Configuration
7520
7521 C<PATH>, I<nroff>, Permissions
7522
7523 =back
7524
7525 =item CONFIGURE PERL ON CYGWIN
7526
7527 =over 4
7528
7529 =item Stripping Perl Binaries on Cygwin
7530
7531 =item Optional Libraries for Perl on Cygwin
7532
7533 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7534 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7535
7536 =item Configure-time Options for Perl on Cygwin
7537
7538 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7539 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7540 C<-Dmksymlinks>
7541
7542 =item Suspicious Warnings on Cygwin
7543
7544 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7545
7546 =back
7547
7548 =item MAKE ON CYGWIN
7549
7550 =over 4
7551
7552 =item Warnings on Cygwin
7553
7554 =item ld2 on Cygwin
7555
7556 =back
7557
7558 =item TEST ON CYGWIN
7559
7560 =over 4
7561
7562 =item File Permissions on Cygwin
7563
7564 =item NDBM_File and ODBM_File do not work on FAT filesystems
7565
7566 =item C<fork()> failures in io_* tests
7567
7568 =item Script Portability on Cygwin
7569
7570 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
7571
7572 =back
7573
7574 =item INSTALL PERL ON CYGWIN
7575
7576 =item MANIFEST ON CYGWIN
7577
7578 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7579 Source, Compiled Module Source, Perl Modules/Scripts
7580
7581 =item BUGS ON CYGWIN
7582
7583 =item AUTHORS
7584
7585 =item HISTORY
7586
7587 =back
7588
7589 =head2 perldgux - Perl under DG/UX.
7590
7591 =over 4
7592
7593 =item SYNOPSIS
7594
7595 =back
7596
7597 =over 4
7598
7599 =item DESCRIPTION
7600
7601 =item BUILDING PERL ON DG/UX
7602
7603 =over 4
7604
7605 =item Non-threaded Perl on DG/UX
7606
7607 =item Threaded Perl on DG/UX
7608
7609 =item Testing Perl on DG/UX
7610
7611 =item Installing the built perl on DG/UX
7612
7613 =back
7614
7615 =item AUTHOR
7616
7617 =item SEE ALSO
7618
7619 =back
7620
7621 =head2 perldos - Perl under DOS, W31, W95.
7622
7623 =over 4
7624
7625 =item SYNOPSIS
7626
7627 =item DESCRIPTION
7628
7629 =over 4
7630
7631 =item Prerequisites for Compiling Perl on DOS
7632
7633 DJGPP, Pthreads
7634
7635 =item Shortcomings of Perl under DOS
7636
7637 =item Building Perl on DOS
7638
7639 =item Testing Perl on DOS
7640
7641 =item Installation of Perl on DOS
7642
7643 =back
7644
7645 =item BUILDING AND INSTALLING MODULES ON DOS
7646
7647 =over 4
7648
7649 =item Building Prerequisites for Perl on DOS
7650
7651 =item Unpacking CPAN Modules on DOS
7652
7653 =item Building Non-XS Modules on DOS
7654
7655 =item Building XS Modules on DOS
7656
7657 =back
7658
7659 =item AUTHOR
7660
7661 =item SEE ALSO
7662
7663 =back
7664
7665 =head2 perlepoc, README.epoc - Perl for EPOC
7666
7667 =over 4
7668
7669 =item SYNOPSIS
7670
7671 =item INTRODUCTION
7672
7673 =item INSTALLING PERL ON EPOC
7674
7675 =item STARTING PERL ON EPOC
7676
7677 =over 4
7678
7679 =item Editors on Epoc
7680
7681 =item Features of Perl on Epoc
7682
7683 =item Restrictions of Perl on Epoc
7684
7685 =item Compiling Perl 5 on the EPOC cross compiling environment
7686
7687 =back
7688
7689 =item SUPPORT STATUS OF PERL ON EPOC
7690
7691 =item AUTHOR
7692
7693 =item LAST UPDATE
7694
7695 =back
7696
7697 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7698
7699 =over 4
7700
7701 =item DESCRIPTION
7702
7703 =over 4
7704
7705 =item FreeBSD core dumps from readdir_r with ithreads
7706
7707 =item $^X doesn't always contain a full path in FreeBSD
7708
7709 =item Perl will no longer be part of "base FreeBSD"
7710
7711 =back
7712
7713 =item AUTHOR
7714
7715 =back
7716
7717 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7718 (HP-UX) systems
7719
7720 =over 4
7721
7722 =item DESCRIPTION
7723
7724 =over 4
7725
7726 =item Using perl as shipped with HP-UX
7727
7728 =item Using perl from HP's porting centre
7729
7730 =item Compiling Perl 5 on HP-UX
7731
7732 =item PA-RISC
7733
7734 =item PA-RISC 1.0
7735
7736 =item PA-RISC 1.1
7737
7738 =item PA-RISC 2.0
7739
7740 =item Itanium
7741
7742 =item Portability Between PA-RISC Versions
7743
7744 =item Itanium Processor Family and HP-UX
7745
7746 =item Building Dynamic Extensions on HP-UX
7747
7748 =item The HP ANSI C Compiler
7749
7750 =item The GNU C Compiler
7751
7752 =item Using Large Files with Perl on HP-UX
7753
7754 =item Threaded Perl on HP-UX
7755
7756 =item 64-bit Perl on HP-UX
7757
7758 =item Oracle on HP-UX
7759
7760 =item GDBM and Threads on HP-UX
7761
7762 =item NFS filesystems and utime(2) on HP-UX
7763
7764 =item perl -P and // and HP-UX
7765
7766 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7767
7768 =back
7769
7770 =item nss_delete core dump from op/pwent or op/grent
7771
7772 =item AUTHOR
7773
7774 =item DATE
7775
7776 =back
7777
7778 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7779
7780 =over 4
7781
7782 =item DESCRIPTION
7783
7784 =over 4
7785
7786 =item Known Problems with Perl on Hurd
7787
7788 =back
7789
7790 =item AUTHOR
7791
7792 =back
7793
7794 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7795
7796 =over 4
7797
7798 =item DESCRIPTION
7799
7800 =over 4
7801
7802 =item Building 32-bit Perl in Irix
7803
7804 =item Building 64-bit Perl in Irix
7805
7806 =item About Compiler Versions of Irix
7807
7808 =item Linker Problems in Irix
7809
7810 =item Malloc in Irix
7811
7812 =item Building with threads in Irix
7813
7814 =item Irix 5.3
7815
7816 =back
7817
7818 =item AUTHOR
7819
7820 =back
7821
7822 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7823 systems
7824
7825 =over 4
7826
7827 =item DESCRIPTION
7828
7829 =over 4
7830
7831 =item Compiling Perl 5 on MachTen
7832
7833 =item Failures during C<make test> on MachTen
7834
7835 op/lexassign.t, pragma/warnings.t
7836
7837 =item Building external modules on MachTen
7838
7839 =back
7840
7841 =item AUTHOR
7842
7843 =item DATE
7844
7845 =back
7846
7847 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7848
7849 =over 4
7850
7851 =item SYNOPSIS
7852
7853 =item DESCRIPTION
7854
7855 =item AUTHOR
7856
7857 =item DATE
7858
7859 =back
7860
7861 =head2 perlmacosx, README.macosx - Perl under Mac OS X
7862
7863 =over 4
7864
7865 =item SYNOPSIS
7866
7867 =item DESCRIPTION
7868
7869 =item INSTALLATION PREFIX
7870
7871 =item LIBPERL AND PREBINDING
7872
7873 =item UPDATING PANTHER
7874
7875 =item MACPERL
7876
7877 =item CARBON
7878
7879 =item COCOA
7880
7881 =item AUTHOR
7882
7883 =item DATE
7884
7885 =back
7886
7887 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7888
7889 =over 4
7890
7891 =item DESCRIPTION
7892
7893 =item Known problems with Perl on MiNT
7894
7895 =item AUTHOR
7896
7897 =back
7898
7899 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7900
7901 =over 4
7902
7903 =item SYNOPSIS
7904
7905 =item NOTE
7906
7907 =item Binary distribution from HP
7908
7909 =item What's New in Perl for MPE/iX
7910
7911 =item Welcome to Perl/iX
7912
7913 =item System Requirements for Perl/iX
7914
7915 =item How to Obtain Perl/iX
7916
7917 =item Perl/iX Distribution Contents Highlights
7918
7919 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7920 public_html/feedback.cgi, src/perl-5.6.0-mpe
7921
7922 =item How to Compile Perl/iX
7923
7924  4,  6
7925
7926 =item Getting Started with Perl/iX
7927
7928 =item MPE/iX Implementation Considerations
7929
7930 =item Known Perl/iX Bugs Under Investigation
7931
7932 =item Perl/iX To-Do List
7933
7934 =item Perl/iX Change History
7935
7936 =item AUTHOR
7937
7938 =item Name
7939
7940 =item Description
7941
7942 =item Build
7943
7944 =over 4
7945
7946 =item Tools & SDK
7947
7948 =item Setup
7949
7950 SetNWBld.bat, Buildtype.bat
7951
7952 =item Make
7953
7954 =item Interpreter
7955
7956 =item Extensions
7957
7958 =back
7959
7960 =item Install
7961
7962 =item Build new extensions
7963
7964 =item Acknowledgements
7965
7966 =item Authors
7967
7968 =item Date
7969
7970 =back
7971
7972 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7973
7974 =over 4
7975
7976 =item SYNOPSIS
7977
7978 =back
7979
7980 =over 4
7981
7982 =item DESCRIPTION
7983
7984 =over 4
7985
7986 =item Target
7987
7988 =item Other OSes
7989
7990 =item Prerequisites
7991
7992 EMX, RSX, HPFS, pdksh
7993
7994 =item Starting Perl programs under OS/2 (and DOS and...)
7995
7996 =item Starting OS/2 (and DOS) programs under Perl
7997
7998 =back
7999
8000 =item Frequently asked questions
8001
8002 =over 4
8003
8004 =item "It does not work"
8005
8006 =item I cannot run external programs
8007
8008 =item I cannot embed perl into my program, or use F<perl.dll> from my
8009 program.
8010
8011 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8012 L<ExtUtils::Embed>?
8013
8014 =item C<``> and pipe-C<open> do not work under DOS.
8015
8016 =item Cannot start C<find.exe "pattern" file>
8017
8018 =back
8019
8020 =item INSTALLATION
8021
8022 =over 4
8023
8024 =item Automatic binary installation
8025
8026 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8027
8028 =item Manual binary installation
8029
8030 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8031 (statically linked), Executables for Perl utilities, Main Perl library,
8032 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8033 and utilities, Manpages for Perl modules, Source for Perl documentation,
8034 Perl manual in F<.INF> format, Pdksh
8035
8036 =item B<Warning>
8037
8038 =back
8039
8040 =item Accessing documentation
8041
8042 =over 4
8043
8044 =item OS/2 F<.INF> file
8045
8046 =item Plain text
8047
8048 =item Manpages
8049
8050 =item HTML
8051
8052 =item GNU C<info> files
8053
8054 =item F<PDF> files
8055
8056 =item C<LaTeX> docs
8057
8058 =back
8059
8060 =item BUILD
8061
8062 =over 4
8063
8064 =item The short story
8065
8066 =item Prerequisites
8067
8068 =item Getting perl source
8069
8070 =item Application of the patches
8071
8072 =item Hand-editing
8073
8074 =item Making
8075
8076 =item Testing
8077
8078 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8079 F<op/stat.t>
8080
8081 =item Installing the built perl
8082
8083 =item C<a.out>-style build
8084
8085 =back
8086
8087 =item Build FAQ
8088
8089 =over 4
8090
8091 =item Some C</> became C<\> in pdksh.
8092
8093 =item C<'errno'> - unresolved external
8094
8095 =item Problems with tr or sed
8096
8097 =item Some problem (forget which ;-)
8098
8099 =item Library ... not found
8100
8101 =item Segfault in make
8102
8103 =item op/sprintf test failure
8104
8105 =back
8106
8107 =item Specific (mis)features of OS/2 port
8108
8109 =over 4
8110
8111 =item C<setpriority>, C<getpriority>
8112
8113 =item C<system()>
8114
8115 =item C<extproc> on the first line
8116
8117 =item Additional modules:
8118
8119 =item Prebuilt methods:
8120
8121 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8122  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
8123 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
8124 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
8125 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
8126 C<Cwd::extLibpath_set( path [, type ] )>,
8127 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8128 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8129 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8130 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8131 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8132 C<OS2::DLLname([how [, \&xsub]])>
8133
8134 =item Prebuilt variables:
8135
8136 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8137 $OS2::nsyserror
8138
8139 =item Misfeatures
8140
8141 =item Modifications
8142
8143 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8144 C<flock>
8145
8146 =item Identifying DLLs
8147
8148 =item Centralized management of resources
8149
8150 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8151 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8152 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8153 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8154
8155 =back
8156
8157 =item Perl flavors
8158
8159 =over 4
8160
8161 =item F<perl.exe>
8162
8163 =item F<perl_.exe>
8164
8165 =item F<perl__.exe>
8166
8167 =item F<perl___.exe>
8168
8169 =item Why strange names?
8170
8171 =item Why dynamic linking?
8172
8173 =item Why chimera build?
8174
8175 =back
8176
8177 =item ENVIRONMENT
8178
8179 =over 4
8180
8181 =item C<PERLLIB_PREFIX>
8182
8183 =item C<PERL_BADLANG>
8184
8185 =item C<PERL_BADFREE>
8186
8187 =item C<PERL_SH_DIR>
8188
8189 =item C<USE_PERL_FLOCK>
8190
8191 =item C<TMP> or C<TEMP>
8192
8193 =back
8194
8195 =item Evolution
8196
8197 =over 4
8198
8199 =item Text-mode filehandles
8200
8201 =item Priorities
8202
8203 =item DLL name mangling: pre 5.6.2
8204
8205 =item DLL name mangling: 5.6.2 and beyond
8206
8207 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8208 C<LIBPATH>
8209
8210 =item DLL forwarder generation
8211
8212 =item Threading
8213
8214 =item Calls to external programs
8215
8216 =item Memory allocation
8217
8218 =item Threads
8219
8220 C<COND_WAIT>, F<os2.c>
8221
8222 =back
8223
8224 =item BUGS
8225
8226 =back
8227
8228 =over 4
8229
8230 =item AUTHOR
8231
8232 =item SEE ALSO
8233
8234 =back
8235
8236 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8237 and z/OS
8238
8239 =over 4
8240
8241 =item SYNOPSIS
8242
8243 =item DESCRIPTION
8244
8245 =over 4
8246
8247 =item Tools
8248
8249 =item Unpacking Perl distribution on OS/390
8250
8251 =item Setup and utilities for Perl on OS/390
8252
8253 =item Configure Perl on OS/390
8254
8255 =item Build, Test, Install Perl on OS/390
8256
8257 =item Build Anomalies with Perl on OS/390
8258
8259 =item Testing Anomalies with Perl on OS/390
8260
8261 =item Installation Anomalies with Perl on OS/390
8262
8263 =item Usage Hints for Perl on OS/390
8264
8265 =item Floating Point Anomalies with Perl on OS/390
8266
8267 =item Modules and Extensions for Perl on OS/390
8268
8269 =back
8270
8271 =item AUTHORS
8272
8273 =item SEE ALSO
8274
8275 =over 4
8276
8277 =item Mailing list for Perl on OS/390
8278
8279 =back
8280
8281 =item HISTORY
8282
8283 =back
8284
8285 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8286
8287 =over 4
8288
8289 =item DESCRIPTION
8290
8291 =over 4
8292
8293 =item Compiling Perl for OS/400 PASE
8294
8295 =item Installing Perl in OS/400 PASE
8296
8297 =item Using Perl in OS/400 PASE
8298
8299 =item Known Problems
8300
8301 =item Perl on ILE
8302
8303 =back
8304
8305 =item AUTHORS
8306
8307 =back
8308
8309 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8310
8311 =over 4
8312
8313 =item DESCRIPTION
8314
8315 =over 4
8316
8317 =item Required Software for Compiling Perl on QNX4
8318
8319 /bin/sh, ar, nm, cpp, make
8320
8321 =item Outstanding Issues with Perl on QNX4
8322
8323 =item QNX auxiliary files
8324
8325 qnx/ar, qnx/cpp
8326
8327 =item Outstanding issues with perl under QNX6
8328
8329 =back
8330
8331 =item AUTHOR
8332
8333 =back
8334
8335 =head2 perlplan9 - Plan 9-specific documentation for Perl
8336
8337 =over 4
8338
8339 =item DESCRIPTION
8340
8341 =over 4
8342
8343 =item Invoking Perl
8344
8345 =item What's in Plan 9 Perl
8346
8347 =item What's not in Plan 9 Perl
8348
8349 =item Perl5 Functions not currently supported in Plan 9 Perl
8350
8351 =item Signals in Plan 9 Perl
8352
8353 =back
8354
8355 =item COMPILING AND INSTALLING PERL ON PLAN 9
8356
8357 =over 4
8358
8359 =item Installing Perl Documentation on Plan 9
8360
8361 =back
8362
8363 =item BUGS
8364
8365 =item Revision date
8366
8367 =item AUTHOR
8368
8369 =back
8370
8371 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8372
8373 =over 4
8374
8375 =item DESCRIPTION
8376
8377 =over 4
8378
8379 =item Solaris Version Numbers.
8380
8381 =back
8382
8383 =item RESOURCES
8384
8385 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8386
8387 =item SETTING UP
8388
8389 =over 4
8390
8391 =item File Extraction Problems on Solaris.
8392
8393 =item Compiler and Related Tools on Solaris.
8394
8395 =item Environment for Compiling perl on Solaris
8396
8397 =back
8398
8399 =item RUN CONFIGURE.
8400
8401 =over 4
8402
8403 =item 64-bit perl on Solaris.
8404
8405 =item Threads in perl on Solaris.
8406
8407 =item Malloc Issues with perl on Solaris.
8408
8409 =back
8410
8411 =item MAKE PROBLEMS.
8412
8413 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8414 relocation error:, dlopen: stub interception failed, #error "No
8415 DATAMODEL_NATIVE specified", sh: ar: not found
8416
8417 =item MAKE TEST
8418
8419 =over 4
8420
8421 =item op/stat.t test 4 in Solaris
8422
8423 =item nss_delete core dump from op/pwent or op/grent
8424
8425 =back
8426
8427 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8428
8429 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8430
8431 =over 4
8432
8433 =item Limits on Numbers of Open Files on Solaris.
8434
8435 =back
8436
8437 =item SOLARIS-SPECIFIC MODULES.
8438
8439 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8440
8441 =over 4
8442
8443 =item Proc::ProcessTable on Solaris
8444
8445 =item BSD::Resource on Solaris
8446
8447 =item Net::SSLeay on Solaris
8448
8449 =back
8450
8451 =item AUTHOR
8452
8453 =item LAST MODIFIED
8454
8455 =back
8456
8457 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8458 Digital UNIX formerly known as DEC OSF/1) systems
8459
8460 =over 4
8461
8462 =item DESCRIPTION
8463
8464 =over 4
8465
8466 =item Compiling Perl 5 on Tru64
8467
8468 =item Using Large Files with Perl on Tru64
8469
8470 =item Threaded Perl on Tru64
8471
8472 =item Long Doubles on Tru64
8473
8474 =item DB_File tests failing on Tru64
8475
8476 =item 64-bit Perl on Tru64
8477
8478 =item Warnings about floating-point overflow when compiling Perl on Tru64
8479
8480 =back
8481
8482 =item Testing Perl on Tru64
8483
8484 =item ext/ODBM_File/odbm Test Failing With Static Builds
8485
8486 =item Perl Fails Because Of Unresolved Symbol sockatmark
8487
8488 =item AUTHOR
8489
8490 =back
8491
8492 =head2 perluts - Perl under UTS
8493
8494 =over 4
8495
8496 =item SYNOPSIS
8497
8498 =item DESCRIPTION
8499
8500 =item BUILDING PERL ON UTS
8501
8502 =item Installing the built perl on UTS
8503
8504 =item AUTHOR
8505
8506 =back
8507
8508 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8509
8510 =over 4
8511
8512 =item SYNOPSIS
8513
8514 =item DESCRIPTION
8515
8516 =over 4
8517
8518 =item Unpacking Perl Distribution on VM/ESA
8519
8520 =item Setup Perl and utilities on VM/ESA
8521
8522 =item Configure Perl on VM/ESA
8523
8524 =item Testing Anomalies of Perl on VM/ESA
8525
8526 =item Usage Hints for Perl on VM/ESA
8527
8528 =back
8529
8530 =item AUTHORS
8531
8532 =item SEE ALSO
8533
8534 =over 4
8535
8536 =item Mailing list for Perl on VM/ESA
8537
8538 =back
8539
8540 =back
8541
8542 =head2 perlvms - VMS-specific documentation for Perl
8543
8544 =over 4
8545
8546 =item DESCRIPTION
8547
8548 =item Installation
8549
8550 =item Organization of Perl Images
8551
8552 =over 4
8553
8554 =item Core Images
8555
8556 =item Perl Extensions
8557
8558 =item Installing static extensions
8559
8560 =item Installing dynamic extensions
8561
8562 =back
8563
8564 =item File specifications
8565
8566 =over 4
8567
8568 =item Syntax
8569
8570 =item Wildcard expansion
8571
8572 =item Pipes
8573
8574 =back
8575
8576 =item PERL5LIB and PERLLIB
8577
8578 =item Command line
8579
8580 =over 4
8581
8582 =item I/O redirection and backgrounding
8583
8584 =item Command line switches
8585
8586 -i, -S, -u
8587
8588 =back
8589
8590 =item Perl functions
8591
8592 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8593 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8594 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8595 LIST, waitpid PID,FLAGS
8596
8597 =item Perl variables
8598
8599 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8600
8601 =item Standard modules with VMS-specific differences
8602
8603 =over 4
8604
8605 =item SDBM_File
8606
8607 =back
8608
8609 =item Revision date
8610
8611 =item AUTHOR
8612
8613 =back
8614
8615 =head2 perlvos, README.vos - Perl for Stratus VOS
8616
8617 =over 4
8618
8619 =item SYNOPSIS
8620
8621 =item BUILDING PERL FOR VOS
8622
8623 =item INSTALLING PERL IN VOS
8624
8625 =item USING PERL IN VOS
8626
8627 =over 4
8628
8629 =item Restrictions of Perl on VOS
8630
8631 =item Handling of underflow and overflow
8632
8633 =back
8634
8635 =item TEST STATUS
8636
8637 =item SUPPORT STATUS
8638
8639 =item AUTHOR
8640
8641 =item LAST UPDATE
8642
8643 =back
8644
8645 =head2 perlwin32 - Perl under Windows
8646
8647 =over 4
8648
8649 =item SYNOPSIS
8650
8651 =item DESCRIPTION
8652
8653 =over 4
8654
8655 =item Setting Up Perl on Win32
8656
8657 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8658 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
8659
8660 =item Building
8661
8662 =item Testing Perl on Win32
8663
8664 =item Installation of Perl on Win32
8665
8666 =item Usage Hints for Perl on Win32
8667
8668 Environment Variables, File Globbing, Using perl from the command line,
8669 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8670 Extensions, Notes on 64-bit Windows
8671
8672 =item Running Perl Scripts
8673
8674 Miscellaneous Things
8675
8676 =back
8677
8678 =item BUGS AND CAVEATS
8679
8680 =item AUTHORS
8681
8682 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8683 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8684 E<lt>nick@ing-simmons.netE<gt>
8685
8686 =item SEE ALSO
8687
8688 =item HISTORY
8689
8690 =back
8691
8692 =head1 PRAGMA DOCUMENTATION
8693
8694 =head2 attrs - set/get attributes of a subroutine (deprecated)
8695
8696 =over 4
8697
8698 =item SYNOPSIS
8699
8700 =item DESCRIPTION
8701
8702 method, locked
8703
8704 =back
8705
8706 =head2 re - Perl pragma to alter regular expression behaviour
8707
8708 =over 4
8709
8710 =item SYNOPSIS
8711
8712 =item DESCRIPTION
8713
8714 =back
8715
8716 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8717 data structures between threads
8718
8719 =over 4
8720
8721 =item SYNOPSIS
8722
8723 =item DESCRIPTION
8724
8725 =item EXPORT
8726
8727 =item FUNCTIONS
8728
8729 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8730 cond_broadcast VARIABLE
8731
8732 =item NOTES
8733
8734 =item BUGS
8735
8736 =item AUTHOR
8737
8738 =item SEE ALSO
8739
8740 =back
8741
8742 =head2 threads - Perl extension allowing use of interpreter based threads
8743 from perl
8744
8745 =over 4
8746
8747 =item SYNOPSIS
8748
8749 =item DESCRIPTION
8750
8751 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8752 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8753 threads->list();, async BLOCK;
8754
8755 =item WARNINGS
8756
8757 A thread exited while %d other threads were still running
8758
8759 =item TODO
8760
8761 =item BUGS
8762
8763 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8764 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8765
8766 =item AUTHOR and COPYRIGHT
8767
8768 =item SEE ALSO
8769
8770 =back
8771
8772 =head2 assertions - select assertions in blocks of code
8773
8774 =over 4
8775
8776 =item SYNOPSIS
8777
8778 =item DESCRIPTION
8779
8780 =item SEE ALSO
8781
8782 =item AUTHOR
8783
8784 =item COPYRIGHT AND LICENSE
8785
8786 =back
8787
8788 =head2 assertions::activate - activate assertions
8789
8790 =over 4
8791
8792 =item SYNOPSIS
8793
8794 =item DESCRIPTION
8795
8796 =item SEE ALSO
8797
8798 =item AUTHOR
8799
8800 =item COPYRIGHT AND LICENSE
8801
8802 =back
8803
8804 =head2 attributes - get/set subroutine or variable attributes
8805
8806 =over 4
8807
8808 =item SYNOPSIS
8809
8810 =item DESCRIPTION
8811
8812 =over 4
8813
8814 =item Built-in Attributes
8815
8816 locked, method, lvalue
8817
8818 =item Available Subroutines
8819
8820 get, reftype
8821
8822 =item Package-specific Attribute Handling
8823
8824 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8825
8826 =item Syntax of Attribute Lists
8827
8828 =back
8829
8830 =item EXPORTS
8831
8832 =over 4
8833
8834 =item Default exports
8835
8836 =item Available exports
8837
8838 =item Export tags defined
8839
8840 =back
8841
8842 =item EXAMPLES
8843
8844 =item SEE ALSO
8845
8846 =back
8847
8848 =head2 attrs - set/get attributes of a subroutine (deprecated)
8849
8850 =over 4
8851
8852 =item SYNOPSIS
8853
8854 =item DESCRIPTION
8855
8856 method, locked
8857
8858 =back
8859
8860 =head2 autouse - postpone load of modules until a function is used
8861
8862 =over 4
8863
8864 =item SYNOPSIS
8865
8866 =item DESCRIPTION
8867
8868 =item WARNING
8869
8870 =item AUTHOR
8871
8872 =item SEE ALSO
8873
8874 =back
8875
8876 =head2 base - Establish IS-A relationship with base class at compile time
8877
8878 =over 4
8879
8880 =item SYNOPSIS
8881
8882 =item DESCRIPTION
8883
8884 =item HISTORY
8885
8886 =item SEE ALSO
8887
8888 =back
8889
8890 =head2 bigint - Transparent BigInteger support for Perl
8891
8892 =over 4
8893
8894 =item SYNOPSIS
8895
8896 =item DESCRIPTION
8897
8898 =over 4
8899
8900 =item OPTIONS
8901
8902 a or accuracy, p or precision, t or trace, l or lib, v or version
8903
8904 =item MATH LIBRARY
8905
8906 =item INTERNAL FORMAT
8907
8908 =item SIGN
8909
8910 =item METHODS
8911
8912 =item CAVEAT
8913
8914 =back
8915
8916 =item MODULES USED
8917
8918 =item EXAMPLES
8919
8920 =item LICENSE
8921
8922 =item SEE ALSO
8923
8924 =item AUTHORS
8925
8926 =back
8927
8928 =head2 bignum - Transparent BigNumber support for Perl
8929
8930 =over 4
8931
8932 =item SYNOPSIS
8933
8934 =item DESCRIPTION
8935
8936 =over 4
8937
8938 =item OPTIONS
8939
8940 a or accuracy, p or precision, t or trace, l or lib, v or version
8941
8942 =item METHODS
8943
8944 =item CAVEAT
8945
8946 inf(), NaN(), upgrade()
8947
8948 =item MATH LIBRARY
8949
8950 =item INTERNAL FORMAT
8951
8952 =item SIGN
8953
8954 =back
8955
8956 =item MODULES USED
8957
8958 =item EXAMPLES
8959
8960 =item LICENSE
8961
8962 =item SEE ALSO
8963
8964 =item AUTHORS
8965
8966 =back
8967
8968 =head2 bigrat - Transparent BigNumber/BigRationale support for Perl
8969
8970 =over 4
8971
8972 =item SYNOPSIS
8973
8974 =item DESCRIPTION
8975
8976 =over 4
8977
8978 =item MODULES USED
8979
8980 =item MATH LIBRARY
8981
8982 =item SIGN
8983
8984 =item METHODS
8985
8986 =item CAVEAT
8987
8988 =back
8989
8990 =item EXAMPLES
8991
8992         perl -Mbigrat -le 'print sqrt(33)'
8993         perl -Mbigrat -le 'print 2*255'
8994         perl -Mbigrat -le 'print 4.5+2*255'
8995         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8996         perl -Mbigrat -le 'print 12->is_odd()';
8997
8998 =item LICENSE
8999
9000 =item SEE ALSO
9001
9002 =item AUTHORS
9003
9004 =back
9005
9006 =head2 blib - Use MakeMaker's uninstalled version of a package
9007
9008 =over 4
9009
9010 =item SYNOPSIS
9011
9012 =item DESCRIPTION
9013
9014 =item BUGS
9015
9016 =item AUTHOR
9017
9018 =back
9019
9020 =head2 bytes - Perl pragma to force byte semantics rather than character
9021 semantics
9022
9023 =over 4
9024
9025 =item SYNOPSIS
9026
9027 =item DESCRIPTION
9028
9029 =item SEE ALSO
9030
9031 =back
9032
9033 =head2 charnames - define character names for C<\N{named}> string literal
9034 escapes
9035
9036 =over 4
9037
9038 =item SYNOPSIS
9039
9040 =item DESCRIPTION
9041
9042 =item CUSTOM TRANSLATORS
9043
9044 =item CUSTOM ALIASES
9045
9046 =over 4
9047
9048 =item Anonymous hashes
9049
9050 =item Alias file
9051
9052 =item Alias shortcut
9053
9054 =back
9055
9056 =item charnames::viacode(code)
9057
9058 =item charnames::vianame(name)
9059
9060 =item ALIASES
9061
9062 =item ILLEGAL CHARACTERS
9063
9064 =item BUGS
9065
9066 =back
9067
9068 =head2 constant - Perl pragma to declare constants
9069
9070 =over 4
9071
9072 =item SYNOPSIS
9073
9074 =item DESCRIPTION
9075
9076 =item NOTES
9077
9078 =over 4
9079
9080 =item List constants
9081
9082 =item Defining multiple constants at once
9083
9084 =item Magic constants
9085
9086 =back
9087
9088 =item TECHNICAL NOTES
9089
9090 =item BUGS
9091
9092 =item AUTHOR
9093
9094 =item COPYRIGHT
9095
9096 =back
9097
9098 =head2 diagnostics - Perl compiler pragma to force verbose warning
9099 diagnostics
9100
9101 =over 4
9102
9103 =item SYNOPSIS
9104
9105 =item DESCRIPTION
9106
9107 =over 4
9108
9109 =item The C<diagnostics> Pragma
9110
9111 =item The I<splain> Program
9112
9113 =back
9114
9115 =item EXAMPLES
9116
9117 =item INTERNALS
9118
9119 =item BUGS
9120
9121 =item AUTHOR
9122
9123 =back
9124
9125 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9126
9127 =over 4
9128
9129 =item SYNOPSIS
9130
9131 =item ABSTRACT
9132
9133 =over 4
9134
9135 =item Literal Conversions
9136
9137 =item PerlIO layers for C<STD(IN|OUT)>
9138
9139 =back
9140
9141 =item FEATURES THAT REQUIRE 5.8.1
9142
9143 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9144
9145 =item USAGE
9146
9147 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9148 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9149
9150 =item The Filter Option
9151
9152 =over 4
9153
9154 =item Filter-related changes at Encode version 1.87
9155
9156 =back
9157
9158 =item CAVEATS
9159
9160 =over 4
9161
9162 =item NOT SCOPED
9163
9164 =item DO NOT MIX MULTIPLE ENCODINGS
9165
9166 =item tr/// with ranges
9167
9168 Legend of characters above
9169
9170 =back
9171
9172 =item EXAMPLE - Greekperl
9173
9174 =item KNOWN PROBLEMS
9175
9176 literals in regex that are longer than 127 bytes, EBCDIC, format
9177
9178 =item HISTORY
9179
9180 =item SEE ALSO
9181
9182 =back
9183
9184 =head2 fields - compile-time class fields
9185
9186 =over 4
9187
9188 =item SYNOPSIS
9189
9190 =item DESCRIPTION
9191
9192 new, phash
9193
9194 =item SEE ALSO
9195
9196 =back
9197
9198 =head2 filetest - Perl pragma to control the filetest permission operators
9199
9200 =over 4
9201
9202 =item SYNOPSIS
9203
9204 =item DESCRIPTION
9205
9206 =over 4
9207
9208 =item subpragma access
9209
9210 =back
9211
9212 =back
9213
9214 =head2 if - C<use> a Perl module if a condition holds
9215
9216 =over 4
9217
9218 =item SYNOPSIS
9219
9220 =item DESCRIPTION
9221
9222 =item BUGS
9223
9224 =item AUTHOR
9225
9226 =back
9227
9228 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9229 point
9230
9231 =over 4
9232
9233 =item SYNOPSIS
9234
9235 =item DESCRIPTION
9236
9237 =back
9238
9239 =head2 less - perl pragma to request less of something from the compiler
9240
9241 =over 4
9242
9243 =item SYNOPSIS
9244
9245 =item DESCRIPTION
9246
9247 =back
9248
9249 =head2 lib - manipulate @INC at compile time
9250
9251 =over 4
9252
9253 =item SYNOPSIS
9254
9255 =item DESCRIPTION
9256
9257 =over 4
9258
9259 =item Adding directories to @INC
9260
9261 =item Deleting directories from @INC
9262
9263 =item Restoring original @INC
9264
9265 =back
9266
9267 =item CAVEATS
9268
9269 =item NOTES
9270
9271 =item SEE ALSO
9272
9273 =item AUTHOR
9274
9275 =back
9276
9277 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9278 operations
9279
9280 =over 4
9281
9282 =item SYNOPSIS
9283
9284 =item DESCRIPTION
9285
9286 =back
9287
9288 =head2 open - perl pragma to set default PerlIO layers for input and output
9289
9290 =over 4
9291
9292 =item SYNOPSIS
9293
9294 =item DESCRIPTION
9295
9296 =item NONPERLIO FUNCTIONALITY
9297
9298 =item IMPLEMENTATION DETAILS
9299
9300 =item SEE ALSO
9301
9302 =back
9303
9304 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9305
9306 =over 4
9307
9308 =item SYNOPSIS
9309
9310 =item DESCRIPTION
9311
9312 =item SEE ALSO
9313
9314 =back
9315
9316 =head2 overload - Package for overloading perl operations
9317
9318 =over 4
9319
9320 =item SYNOPSIS
9321
9322 =item DESCRIPTION
9323
9324 =over 4
9325
9326 =item Declaration of overloaded functions
9327
9328 =item Calling Conventions for Binary Operations
9329
9330 FALSE, TRUE, C<undef>
9331
9332 =item Calling Conventions for Unary Operations
9333
9334 =item Calling Conventions for Mutators
9335
9336 C<++> and C<-->, C<x=> and other assignment versions
9337
9338 =item Overloadable Operations
9339
9340 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9341 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9342 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9343
9344 =item Inheritance and overloading
9345
9346 Strings as values of C<use overload> directive, Overloading of an operation
9347 is inherited by derived classes
9348
9349 =back
9350
9351 =item SPECIAL SYMBOLS FOR C<use overload>
9352
9353 =over 4
9354
9355 =item Last Resort
9356
9357 =item Fallback
9358
9359 C<undef>, TRUE, defined, but FALSE
9360
9361 =item Copy Constructor
9362
9363 B<Example>
9364
9365 =back
9366
9367 =item MAGIC AUTOGENERATION
9368
9369 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9370 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9371 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9372 I<Copy operator>
9373
9374 =item Losing overloading
9375
9376 =item Run-time Overloading
9377
9378 =item Public functions
9379
9380 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9381
9382 =item Overloading constants
9383
9384 integer, float, binary, q, qr
9385
9386 =item IMPLEMENTATION
9387
9388 =item Metaphor clash
9389
9390 =item Cookbook
9391
9392 =over 4
9393
9394 =item Two-face scalars
9395
9396 =item Two-face references
9397
9398 =item Symbolic calculator
9399
9400 =item I<Really> symbolic calculator
9401
9402 =back
9403
9404 =item AUTHOR
9405
9406 =item DIAGNOSTICS
9407
9408 Odd number of arguments for overload::constant, `%s' is not an overloadable
9409 type, `%s' is not a code reference
9410
9411 =item BUGS
9412
9413 =back
9414
9415 =head2 re - Perl pragma to alter regular expression behaviour
9416
9417 =over 4
9418
9419 =item SYNOPSIS
9420
9421 =item DESCRIPTION
9422
9423 =back
9424
9425 =head2 sigtrap - Perl pragma to enable simple signal handling
9426
9427 =over 4
9428
9429 =item SYNOPSIS
9430
9431 =item DESCRIPTION
9432
9433 =item OPTIONS
9434
9435 =over 4
9436
9437 =item SIGNAL HANDLERS
9438
9439 B<stack-trace>, B<die>, B<handler> I<your-handler>
9440
9441 =item SIGNAL LISTS
9442
9443 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9444
9445 =item OTHER
9446
9447 B<untrapped>, B<any>, I<signal>, I<number>
9448
9449 =back
9450
9451 =item EXAMPLES
9452
9453 =back
9454
9455 =head2 sort - perl pragma to control sort() behaviour
9456
9457 =over 4
9458
9459 =item SYNOPSIS
9460
9461 =item DESCRIPTION
9462
9463 =item CAVEATS
9464
9465 =back
9466
9467 =head2 strict - Perl pragma to restrict unsafe constructs
9468
9469 =over 4
9470
9471 =item SYNOPSIS
9472
9473 =item DESCRIPTION
9474
9475 C<strict refs>, C<strict vars>, C<strict subs>
9476
9477 =item HISTORY
9478
9479 =back
9480
9481 =head2 subs - Perl pragma to predeclare sub names
9482
9483 =over 4
9484
9485 =item SYNOPSIS
9486
9487 =item DESCRIPTION
9488
9489 =back
9490
9491 =head2 threads - Perl extension allowing use of interpreter based threads
9492 from perl
9493
9494 =over 4
9495
9496 =item SYNOPSIS
9497
9498 =item DESCRIPTION
9499
9500 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9501 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9502 threads->list();, async BLOCK;
9503
9504 =item WARNINGS
9505
9506 A thread exited while %d other threads were still running
9507
9508 =item TODO
9509
9510 =item BUGS
9511
9512 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9513 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9514
9515 =item AUTHOR and COPYRIGHT
9516
9517 =item SEE ALSO
9518
9519 =back
9520
9521 =head2 threadshared, threads::shared - Perl extension for sharing data
9522 structures between threads
9523
9524 =over 4
9525
9526 =item SYNOPSIS
9527
9528 =item DESCRIPTION
9529
9530 =item EXPORT
9531
9532 =item FUNCTIONS
9533
9534 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9535 cond_broadcast VARIABLE
9536
9537 =item NOTES
9538
9539 =item BUGS
9540
9541 =item AUTHOR
9542
9543 =item SEE ALSO
9544
9545 =back
9546
9547 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9548 code
9549
9550 =over 4
9551
9552 =item SYNOPSIS
9553
9554 =item DESCRIPTION
9555
9556 =over 4
9557
9558 =item Utility functions
9559
9560 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9561 utf8::encode($string), $flag = utf8::decode($string), $flag =
9562 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
9563
9564 =back
9565
9566 =item BUGS
9567
9568 =item SEE ALSO
9569
9570 =back
9571
9572 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9573
9574 =over 4
9575
9576 =item SYNOPSIS
9577
9578 =item DESCRIPTION
9579
9580 =back
9581
9582 =head2 version - Perl extension for Version Objects
9583
9584 =over 4
9585
9586 =item SYNOPSIS
9587
9588 =item DESCRIPTION
9589
9590 =over 4
9591
9592 =item What IS a version
9593
9594 Numeric Versions, V-String Versions
9595
9596 =item Numeric Versions
9597
9598 =item V-String Versions
9599
9600 =item Object Methods
9601
9602 New Operator, Stringification, Numification, Comparison operators, Logical
9603 Operators
9604
9605 =item Quoting
9606
9607 =item Types of Versions Objects
9608
9609 Ordinary versions, alpha versions
9610
9611 =item Replacement UNIVERSAL::VERSION
9612
9613 =back
9614
9615 =item EXPORT
9616
9617 =item AUTHOR
9618
9619 =item SEE ALSO
9620
9621 =back
9622
9623 =head2 vmsish - Perl pragma to control VMS-specific language features
9624
9625 =over 4
9626
9627 =item SYNOPSIS
9628
9629 =item DESCRIPTION
9630
9631 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9632
9633 =back
9634
9635 =head2 warnings - Perl pragma to control optional warnings
9636
9637 =over 4
9638
9639 =item SYNOPSIS
9640
9641 =item DESCRIPTION
9642
9643 use warnings::register, warnings::enabled(), warnings::enabled($category),
9644 warnings::enabled($object), warnings::warn($message),
9645 warnings::warn($category, $message), warnings::warn($object, $message),
9646 warnings::warnif($message), warnings::warnif($category, $message),
9647 warnings::warnif($object, $message)
9648
9649 =back
9650
9651 =head2 warnings::register - warnings import function
9652
9653 =over 4
9654
9655 =item SYNOPSIS
9656
9657 =item DESCRIPTION
9658
9659 =back
9660
9661 =head1 MODULE DOCUMENTATION
9662
9663 =head2 AnyDBM_File - provide framework for multiple DBMs
9664
9665 =over 4
9666
9667 =item SYNOPSIS
9668
9669 =item DESCRIPTION
9670
9671 =over 4
9672
9673 =item DBM Comparisons
9674
9675 [0], [1], [2], [3]
9676
9677 =back
9678
9679 =item SEE ALSO
9680
9681 =back
9682
9683 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9684
9685 =over 4
9686
9687 =item VERSION
9688
9689 =item SYNOPSIS
9690
9691 =item DESCRIPTION
9692
9693 [0], [1], [2], [3], [4], [5]
9694
9695 =over 4
9696
9697 =item Typed lexicals
9698
9699 =item Type-specific attribute handlers
9700
9701 =item Non-interpretive attribute handlers
9702
9703 =item Phase-specific attribute handlers
9704
9705 =item Attributes as C<tie> interfaces
9706
9707 =back
9708
9709 =item EXAMPLES
9710
9711 =item DIAGNOSTICS
9712
9713 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9714 attributes>, C<Declaration of %s attribute in package %s may clash with
9715 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9716 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9717 be able to apply END handler>
9718
9719 =item AUTHOR
9720
9721 =item BUGS
9722
9723 =item COPYRIGHT
9724
9725 =back
9726
9727 =head2 AutoLoader - load subroutines only on demand
9728
9729 =over 4
9730
9731 =item SYNOPSIS
9732
9733 =item DESCRIPTION
9734
9735 =over 4
9736
9737 =item Subroutine Stubs
9738
9739 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9740
9741 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9742
9743 =item Package Lexicals
9744
9745 =item Not Using AutoLoader
9746
9747 =item B<AutoLoader> vs. B<SelfLoader>
9748
9749 =back
9750
9751 =item CAVEATS
9752
9753 =item SEE ALSO
9754
9755 =back
9756
9757 =head2 AutoSplit - split a package for autoloading
9758
9759 =over 4
9760
9761 =item SYNOPSIS
9762
9763 =item DESCRIPTION
9764
9765 $keep, $check, $modtime
9766
9767 =over 4
9768
9769 =item Multiple packages
9770
9771 =back
9772
9773 =item DIAGNOSTICS
9774
9775 =back
9776
9777 =head2 B - The Perl Compiler
9778
9779 =over 4
9780
9781 =item SYNOPSIS
9782
9783 =item DESCRIPTION
9784
9785 =item OVERVIEW
9786
9787 =item Utility Functions
9788
9789 =over 4
9790
9791 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
9792 objects
9793
9794 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
9795 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
9796
9797 =item Functions for Examining the Symbol Table
9798
9799 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
9800
9801 =item Functions Returning C<B::OP> objects or for walking op trees
9802
9803 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
9804
9805 =item Miscellaneous Utility Functions
9806
9807 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
9808 perlstring(STR), class(OBJ), threadsv_names
9809
9810 =back
9811
9812 =item OVERVIEW OF CLASSES
9813
9814 =over 4
9815
9816 =item SV-RELATED CLASSES
9817
9818 =item B::SV Methods
9819
9820 REFCNT, FLAGS, object_2svref
9821
9822 =item B::IV Methods
9823
9824 IV, IVX, UVX, int_value, needs64bits, packiv
9825
9826 =item B::NV Methods
9827
9828 NV, NVX
9829
9830 =item B::RV Methods
9831
9832 RV
9833
9834 =item B::PV Methods
9835
9836 PV, RV, PVX
9837
9838 =item B::PVMG Methods
9839
9840 MAGIC, SvSTASH
9841
9842 =item B::MAGIC Methods
9843
9844 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9845
9846 =item B::PVLV Methods
9847
9848 TARGOFF, TARGLEN, TYPE, TARG
9849
9850 =item B::BM Methods
9851
9852 USEFUL, PREVIOUS, RARE, TABLE
9853
9854 =item B::GV Methods
9855
9856 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9857 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9858
9859 =item B::IO Methods
9860
9861 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9862 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9863
9864 =item B::AV Methods
9865
9866 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
9867
9868 =item B::CV Methods
9869
9870 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
9871 XSUBANY, CvFLAGS, const_sv
9872
9873 =item B::HV Methods
9874
9875 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9876
9877 =item OP-RELATED CLASSES
9878
9879 =item B::OP Methods
9880
9881 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9882
9883 =item B::UNOP METHOD
9884
9885 first
9886
9887 =item B::BINOP METHOD
9888
9889 last
9890
9891 =item B::LOGOP METHOD
9892
9893 other
9894
9895 =item B::LISTOP METHOD
9896
9897 children
9898
9899 =item B::PMOP Methods
9900
9901 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9902 pmpermflags, precomp, pmoffset
9903
9904 =item B::SVOP METHOD
9905
9906 sv, gv
9907
9908 =item B::PADOP METHOD
9909
9910 padix
9911
9912 =item B::PVOP METHOD
9913
9914 pv
9915
9916 =item B::LOOP Methods
9917
9918 redoop, nextop, lastop
9919
9920 =item B::COP Methods
9921
9922 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
9923
9924 =back
9925
9926 =item AUTHOR
9927
9928 =back
9929
9930 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9931 bytecode
9932
9933 =over 4
9934
9935 =item SYNOPSIS
9936
9937 =item DESCRIPTION
9938
9939 %insn_data, @insn_name, @optype, @specialsv_name
9940
9941 =item AUTHOR
9942
9943 =back
9944
9945 =head2 B::Assembler - Assemble Perl bytecode
9946
9947 =over 4
9948
9949 =item SYNOPSIS
9950
9951 =item DESCRIPTION
9952
9953 =item AUTHORS
9954
9955 =back
9956
9957 =head2 B::Bblock - Walk basic blocks
9958
9959 =over 4
9960
9961 =item SYNOPSIS
9962
9963 =item DESCRIPTION
9964
9965 =over 4
9966
9967 =item Functions
9968
9969 B<find_leaders>
9970
9971 =back
9972
9973 =item AUTHOR
9974
9975 =back
9976
9977 =head2 B::Bytecode - Perl compiler's bytecode backend
9978
9979 =over 4
9980
9981 =item SYNOPSIS
9982
9983 =item DESCRIPTION
9984
9985 =item EXAMPLE
9986
9987 =item OPTIONS
9988
9989 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
9990
9991 =item KNOWN BUGS
9992
9993 =item NOTICE
9994
9995 =item AUTHORS
9996
9997 =back
9998
9999 =head2 B::C - Perl compiler's C backend
10000
10001 =over 4
10002
10003 =item SYNOPSIS
10004
10005 =item DESCRIPTION
10006
10007 =item OPTIONS
10008
10009 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10010 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10011 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10012 B<-llimit>
10013
10014 =item EXAMPLES
10015
10016 =item BUGS
10017
10018 =item AUTHOR
10019
10020 =back
10021
10022 =head2 B::CC - Perl compiler's optimized C translation backend
10023
10024 =over 4
10025
10026 =item SYNOPSIS
10027
10028 =item DESCRIPTION
10029
10030 =item OPTIONS
10031
10032 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10033 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10034 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10035
10036 =item EXAMPLES
10037
10038 =item BUGS
10039
10040 =item DIFFERENCES
10041
10042 =over 4
10043
10044 =item Loops
10045
10046 =item Context of ".."
10047
10048 =item Arithmetic
10049
10050 =item Deprecated features
10051
10052 =back
10053
10054 =item AUTHOR
10055
10056 =back
10057
10058 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10059
10060 =over 4
10061
10062 =item SYNOPSIS
10063
10064 =item DESCRIPTION
10065
10066 =item EXAMPLE
10067
10068 =item OPTIONS
10069
10070 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
10071 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
10072 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10073
10074 =item FORMATTING SPECIFICATIONS
10075
10076 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10077 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10078 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10079 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10080 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10081 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10082 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
10083 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10084
10085 =item ABBREVIATIONS
10086
10087 =over 4
10088
10089 =item OP flags abbreviations
10090
10091 =item OP class abbreviations
10092
10093 =back
10094
10095 =item Using B::Concise outside of the O framework
10096
10097 =item AUTHOR
10098
10099 =back
10100
10101 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10102
10103 =over 4
10104
10105 =item SYNOPSIS
10106
10107 =item DESCRIPTION
10108
10109 =item AUTHOR
10110
10111 =back
10112
10113 =head2 B::Deparse - Perl compiler backend to produce perl code
10114
10115 =over 4
10116
10117 =item SYNOPSIS
10118
10119 =item DESCRIPTION
10120
10121 =item OPTIONS
10122
10123 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10124 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10125
10126 =item USING B::Deparse AS A MODULE
10127
10128 =over 4
10129
10130 =item Synopsis
10131
10132 =item Description
10133
10134 =item new
10135
10136 =item ambient_pragmas
10137
10138 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10139
10140 =item coderef2text
10141
10142 =back
10143
10144 =item BUGS
10145
10146 =item AUTHOR
10147
10148 =back
10149
10150 =head2 B::Disassembler - Disassemble Perl bytecode
10151
10152 =over 4
10153
10154 =item SYNOPSIS
10155
10156 =item DESCRIPTION
10157
10158 =item AUTHOR
10159
10160 =back
10161
10162 =head2 B::Lint - Perl lint
10163
10164 =over 4
10165
10166 =item SYNOPSIS
10167
10168 =item DESCRIPTION
10169
10170 =item OPTIONS AND LINT CHECKS
10171
10172 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10173 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10174 B<regexp-variables>, B<all>, B<none>
10175
10176 =item NON LINT-CHECK OPTIONS
10177
10178 B<-u Package>
10179
10180 =item BUGS
10181
10182 =item AUTHOR
10183
10184 =back
10185
10186 =head2 B::O, O - Generic interface to Perl Compiler backends
10187
10188 =over 4
10189
10190 =item SYNOPSIS
10191
10192 =item DESCRIPTION
10193
10194 =item CONVENTIONS
10195
10196 =item IMPLEMENTATION
10197
10198 =item BUGS
10199
10200 =item AUTHOR
10201
10202 =back
10203
10204 =head2 B::Showlex - Show lexical variables used in functions or files
10205
10206 =over 4
10207
10208 =item SYNOPSIS
10209
10210 =item DESCRIPTION
10211
10212 =item AUTHOR
10213
10214 =back
10215
10216 =head2 B::Stackobj - Helper module for CC backend
10217
10218 =over 4
10219
10220 =item SYNOPSIS
10221
10222 =item DESCRIPTION
10223
10224 =item AUTHOR
10225
10226 =back
10227
10228 =head2 B::Stash - show what stashes are loaded
10229
10230 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10231
10232 =over 4
10233
10234 =item SYNOPSIS
10235
10236 =item DESCRIPTION
10237
10238 =item AUTHOR
10239
10240 =back
10241
10242 =head2 B::Xref - Generates cross reference reports for Perl programs
10243
10244 =over 4
10245
10246 =item SYNOPSIS
10247
10248 =item DESCRIPTION
10249
10250 =item OPTIONS
10251
10252 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10253
10254 =item BUGS
10255
10256 =item AUTHOR
10257
10258 =back
10259
10260 =head2 Bblock, B::Bblock - Walk basic blocks
10261
10262 =over 4
10263
10264 =item SYNOPSIS
10265
10266 =item DESCRIPTION
10267
10268 =over 4
10269
10270 =item Functions
10271
10272 B<find_leaders>
10273
10274 =back
10275
10276 =item AUTHOR
10277
10278 =back
10279
10280 =head2 Benchmark - benchmark running times of Perl code
10281
10282 =over 4
10283
10284 =item SYNOPSIS
10285
10286 =item DESCRIPTION
10287
10288 =over 4
10289
10290 =item Methods
10291
10292 new, debug, iters
10293
10294 =item Standard Exports
10295
10296 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10297 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10298 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10299
10300 =item Optional Exports
10301
10302 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10303 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10304 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10305
10306 =item :hireswallclock
10307
10308 =back
10309
10310 =item NOTES
10311
10312 =item EXAMPLES
10313
10314 =item INHERITANCE
10315
10316 =item CAVEATS
10317
10318 =item SEE ALSO
10319
10320 =item AUTHORS
10321
10322 =item MODIFICATION HISTORY
10323
10324 =back
10325
10326 =head2 ByteLoader - load byte compiled perl code
10327
10328 =over 4
10329
10330 =item SYNOPSIS
10331
10332 =item DESCRIPTION
10333
10334 =item AUTHOR
10335
10336 =item SEE ALSO
10337
10338 =back
10339
10340 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10341
10342 =over 4
10343
10344 =item SYNOPSIS
10345
10346 =item DESCRIPTION
10347
10348 =item EXAMPLE
10349
10350 =item OPTIONS
10351
10352 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10353
10354 =item KNOWN BUGS
10355
10356 =item NOTICE
10357
10358 =item AUTHORS
10359
10360 =back
10361
10362 =head2 CGI - Simple Common Gateway Interface Class
10363
10364 =over 4
10365
10366 =item SYNOPSIS
10367
10368 =item ABSTRACT
10369
10370 =item DESCRIPTION
10371
10372 =over 4
10373
10374 =item PROGRAMMING STYLE
10375
10376 =item CALLING CGI.PM ROUTINES
10377
10378 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10379
10380 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10381
10382 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10383
10384 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10385
10386 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10387
10388 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10389
10390 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10391
10392 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10393
10394 =item DELETING A PARAMETER COMPLETELY:
10395
10396 =item DELETING ALL PARAMETERS:
10397
10398 =item DIRECT ACCESS TO THE PARAMETER LIST:
10399
10400 =item FETCHING THE PARAMETER LIST AS A HASH:
10401
10402 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10403
10404 =item RETRIEVING CGI ERRORS
10405
10406 =item USING THE FUNCTION-ORIENTED INTERFACE
10407
10408 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10409 B<:standard>, B<:all>
10410
10411 =item PRAGMAS
10412
10413 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10414 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10415 -private_tempfiles
10416
10417 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10418
10419 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10420 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10421 a </ul> tag)
10422
10423 =back
10424
10425 =item GENERATING DYNAMIC DOCUMENTS
10426
10427 =over 4
10428
10429 =item CREATING A STANDARD HTTP HEADER:
10430
10431 =item GENERATING A REDIRECTION HEADER
10432
10433 =item CREATING THE HTML DOCUMENT HEADER
10434
10435 B<Parameters:>, 4, 5, 6..
10436
10437 =item ENDING THE HTML DOCUMENT:
10438
10439 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10440
10441 =item OBTAINING THE SCRIPT'S URL
10442
10443 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10444 (B<-query_string>), B<-base>
10445
10446 =item MIXING POST AND URL PARAMETERS
10447
10448 =back
10449
10450 =item CREATING STANDARD HTML ELEMENTS:
10451
10452 =over 4
10453
10454 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10455
10456 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10457
10458 =item HTML SHORTCUTS AND LIST INTERPOLATION
10459
10460 =item NON-STANDARD HTML SHORTCUTS
10461
10462 =item AUTOESCAPING HTML
10463
10464 $escaped_string = escapeHTML("unescaped string");, $charset =
10465 charset([$charset]);, $flag = autoEscape([$flag]);
10466
10467 =item PRETTY-PRINTING HTML
10468
10469 =back
10470
10471 =item CREATING FILL-OUT FORMS:
10472
10473 =over 4
10474
10475 =item CREATING AN ISINDEX TAG
10476
10477 =item STARTING AND ENDING A FORM
10478
10479 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10480
10481 =item CREATING A TEXT FIELD
10482
10483 B<Parameters>
10484
10485 =item CREATING A BIG TEXT FIELD
10486
10487 =item CREATING A PASSWORD FIELD
10488
10489 =item CREATING A FILE UPLOAD FIELD
10490
10491 B<Parameters>
10492
10493 =item CREATING A POPUP MENU
10494
10495 =item CREATING AN OPTION GROUP
10496
10497 =item CREATING A SCROLLING LIST
10498
10499 B<Parameters:>
10500
10501 =item CREATING A GROUP OF RELATED CHECKBOXES
10502
10503 B<Parameters:>
10504
10505 =item CREATING A STANDALONE CHECKBOX
10506
10507 B<Parameters:>
10508
10509 =item CREATING A RADIO BUTTON GROUP
10510
10511 B<Parameters:>
10512
10513 =item CREATING A SUBMIT BUTTON
10514
10515 B<Parameters:>
10516
10517 =item CREATING A RESET BUTTON
10518
10519 =item CREATING A DEFAULT BUTTON
10520
10521 =item CREATING A HIDDEN FIELD
10522
10523 B<Parameters:>
10524
10525 =item CREATING A CLICKABLE IMAGE BUTTON
10526
10527 B<Parameters:>, 3. The third option (-align, optional) is an alignment
10528 type, and may be TOP, BOTTOM or MIDDLE
10529
10530 =item CREATING A JAVASCRIPT ACTION BUTTON
10531
10532 =back
10533
10534 =item HTTP COOKIES
10535
10536 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10537 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10538
10539 =item WORKING WITH FRAMES
10540
10541 1. Create a <Frameset> document, 2. Specify the destination for the
10542 document in the HTTP header, 3. Specify the destination for the document in
10543 the <form> tag
10544
10545 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10546
10547 =item DEBUGGING
10548
10549 =over 4
10550
10551 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10552
10553 =back
10554
10555 =item FETCHING ENVIRONMENT VARIABLES
10556
10557 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10558 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
10559 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
10560 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10561 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10562 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10563
10564 =item USING NPH SCRIPTS
10565
10566 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10567 parameters
10568
10569 =item Server Push
10570
10571 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10572
10573 =item Avoiding Denial of Service Attacks
10574
10575 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10576 basis>, B<2. Globally for all scripts>
10577
10578 =item COMPATIBILITY WITH CGI-LIB.PL
10579
10580 =item AUTHOR INFORMATION
10581
10582 =item CREDITS
10583
10584 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10585 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10586 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10587 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10588 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10589 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10590 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10591 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10592 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10593 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10594 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10595 ...and many many more..
10596
10597 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10598
10599 =item BUGS
10600
10601 =item SEE ALSO
10602
10603 =back
10604
10605 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10606
10607 =over 4
10608
10609 =item SYNOPSIS
10610
10611 =item ABSTRACT
10612
10613 =item DESCRIPTION
10614
10615 =item AUTHOR INFORMATION
10616
10617 =item BUGS
10618
10619 =item SEE ALSO
10620
10621 =back
10622
10623 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10624 other) error log
10625
10626 =over 4
10627
10628 =item SYNOPSIS
10629
10630 =item DESCRIPTION
10631
10632 =item REDIRECTING ERROR MESSAGES
10633
10634 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10635
10636 =over 4
10637
10638 =item Changing the default message
10639
10640 =back
10641
10642 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10643
10644 =item OVERRIDING THE NAME OF THE PROGRAM
10645
10646 =item AUTHORS
10647
10648 =item SEE ALSO
10649
10650 =back
10651
10652 =head2 CGI::Cookie - Interface to Netscape Cookies
10653
10654 =over 4
10655
10656 =item SYNOPSIS
10657
10658 =item DESCRIPTION
10659
10660 =item USING CGI::Cookie
10661
10662 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10663
10664 =over 4
10665
10666 =item Creating New Cookies
10667
10668 =item Sending the Cookie to the Browser
10669
10670 =item Recovering Previous Cookies
10671
10672 =item Manipulating Cookies
10673
10674 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10675
10676 =back
10677
10678 =item AUTHOR INFORMATION
10679
10680 =item BUGS
10681
10682 =item SEE ALSO
10683
10684 =back
10685
10686 =head2 CGI::Fast - CGI Interface for Fast CGI
10687
10688 =over 4
10689
10690 =item SYNOPSIS
10691
10692 =item DESCRIPTION
10693
10694 =item OTHER PIECES OF THE PUZZLE
10695
10696 =item WRITING FASTCGI PERL SCRIPTS
10697
10698 =item INSTALLING FASTCGI SCRIPTS
10699
10700 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10701
10702 =item EXTERNAL FASTCGI SERVER INVOCATION
10703
10704 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10705
10706 =item CAVEATS
10707
10708 =item AUTHOR INFORMATION
10709
10710 =item BUGS
10711
10712 =item SEE ALSO
10713
10714 =back
10715
10716 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10717
10718 =over 4
10719
10720 =item SYNOPSIS
10721
10722 =item DESCRIPTION
10723
10724 =over 4
10725
10726 =item Tags that won't be formatted
10727
10728 =item Customizing the Indenting
10729
10730 =back
10731
10732 =item BUGS
10733
10734 =item AUTHOR
10735
10736 =item SEE ALSO
10737
10738 =back
10739
10740 =head2 CGI::Push - Simple Interface to Server Push
10741
10742 =over 4
10743
10744 =item SYNOPSIS
10745
10746 =item DESCRIPTION
10747
10748 =item USING CGI::Push
10749
10750 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10751
10752 =over 4
10753
10754 =item Heterogeneous Pages
10755
10756 =item Changing the Page Delay on the Fly
10757
10758 =back
10759
10760 =item INSTALLING CGI::Push SCRIPTS
10761
10762 =item AUTHOR INFORMATION
10763
10764 =item BUGS
10765
10766 =item SEE ALSO
10767
10768 =back
10769
10770 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10771
10772 =over 4
10773
10774 =item SYNOPSIS
10775
10776 =item ABSTRACT
10777
10778 =item DESCRIPTION
10779
10780 =item AUTHOR INFORMATION
10781
10782 =item BUGS
10783
10784 =item SEE ALSO
10785
10786 =back
10787
10788 =head2 CGI::Util - Internal utilities used by CGI module
10789
10790 =over 4
10791
10792 =item SYNOPSIS
10793
10794 =item DESCRIPTION
10795
10796 =item AUTHOR INFORMATION
10797
10798 =item SEE ALSO
10799
10800 =back
10801
10802 =head2 CPAN - query, download and build perl modules from CPAN sites
10803
10804 =over 4
10805
10806 =item SYNOPSIS
10807
10808 =item STATUS
10809
10810 =item DESCRIPTION
10811
10812 =over 4
10813
10814 =item Interactive Mode
10815
10816 Searching for authors, bundles, distribution files and modules, make, test,
10817 install, clean  modules or distributions, get, readme, look module or
10818 distribution, ls author, Signals
10819
10820 =item CPAN::Shell
10821
10822 =item autobundle
10823
10824 =item recompile
10825
10826 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10827
10828 =item Programmer's interface
10829
10830 expand($type,@things), expandany(@things), Programming Examples
10831
10832 =item Methods in the other Classes
10833
10834 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10835 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10836 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10837 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10838 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10839 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10840 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10841 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10842 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10843 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10844 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10845 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10846 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10847 CPAN::Distribution::look(), CPAN::Distribution::make(),
10848 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10849 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10850 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10851 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10852 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10853 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10854 CPAN::Module::description(), CPAN::Module::force($method,@args),
10855 CPAN::Module::get(), CPAN::Module::inst_file(),
10856 CPAN::Module::inst_version(), CPAN::Module::install(),
10857 CPAN::Module::look(), CPAN::Module::make(),
10858 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10859 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10860
10861 =item Cache Manager
10862
10863 =item Bundles
10864
10865 =item Prerequisites
10866
10867 =item Finding packages and VERSION
10868
10869 =item Debugging
10870
10871 =item Floppy, Zip, Offline Mode
10872
10873 =back
10874
10875 =item CONFIGURATION
10876
10877 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10878 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10879 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10880 [unshift|push|splice] E<lt>listE<gt>>
10881
10882 =over 4
10883
10884 =item Note on urllist parameter's format
10885
10886 =item urllist parameter has CD-ROM support
10887
10888 =back
10889
10890 =item SECURITY
10891
10892 =item EXPORT
10893
10894 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10895
10896 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10897
10898 =over 4
10899
10900 =item Three basic types of firewalls
10901
10902 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10903
10904 =item Configuring lynx or ncftp for going through a firewall
10905
10906 =back
10907
10908 =item FAQ
10909
10910 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10911
10912 =item BUGS
10913
10914 =item AUTHOR
10915
10916 =item TRANSLATIONS
10917
10918 =item SEE ALSO
10919
10920 =back
10921
10922 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10923
10924 =over 4
10925
10926 =item SYNOPSIS
10927
10928 =item DESCRIPTION
10929
10930 =back
10931
10932 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10933 module
10934
10935 =over 4
10936
10937 =item SYNOPSIS
10938
10939 =item DESCRIPTION
10940
10941 =item  SEE ALSO
10942
10943 =back
10944
10945 =head2 Carp, carp    - warn of errors (from perspective of caller)
10946
10947 =over 4
10948
10949 =item SYNOPSIS
10950
10951 =item DESCRIPTION
10952
10953 =over 4
10954
10955 =item Forcing a Stack Trace
10956
10957 =back
10958
10959 =item BUGS
10960
10961 =back
10962
10963 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10964
10965 =head2 Class::ISA -- report the search path for a class's ISA tree
10966
10967 =over 4
10968
10969 =item SYNOPSIS
10970
10971 =item DESCRIPTION
10972
10973 =item FUNCTIONS
10974
10975 the function Class::ISA::super_path($CLASS), the function
10976 Class::ISA::self_and_super_path($CLASS), the function
10977 Class::ISA::self_and_super_versions($CLASS)
10978
10979 =item CAUTIONARY NOTES
10980
10981 =item COPYRIGHT
10982
10983 =item AUTHOR
10984
10985 =back
10986
10987 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10988
10989 =over 4
10990
10991 =item SYNOPSIS
10992
10993 =item DESCRIPTION
10994
10995 =over 4
10996
10997 =item The C<struct()> function
10998
10999 =item Class Creation at Compile Time
11000
11001 =item Element Types and Accessor Methods
11002
11003 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11004 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11005
11006 =item Initializing with C<new>
11007
11008 =back
11009
11010 =item EXAMPLES
11011
11012 Example 1, Example 2, Example 3
11013
11014 =item Author and Modification History
11015
11016 =back
11017
11018 =head2 Config - access Perl configuration information
11019
11020 =over 4
11021
11022 =item SYNOPSIS
11023
11024 =item DESCRIPTION
11025
11026 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11027
11028 =item EXAMPLE
11029
11030 =item WARNING
11031
11032 =item GLOSSARY
11033
11034 =over 4
11035
11036 =item _
11037
11038 C<_a>, C<_exe>, C<_o>
11039
11040 =item a
11041
11042 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11043 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11044 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11045 C<asctime_r_proto>, C<awk>
11046
11047 =item b
11048
11049 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11050
11051 =item c
11052
11053 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11054 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11055 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11056 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11057 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11058 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11059 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11060
11061 =item d
11062
11063 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11064 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11065 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11066 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11067 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11068 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11069 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11070 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11071 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11072 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11073 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11074 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11075 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11076 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11077 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11078 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11079 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11080 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11081 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11082 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11083 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11084 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11085 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11086 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11087 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11088 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11089 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11090 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11091 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11092 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11093 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11094 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11095 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11096 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11097 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11098 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11099 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11100 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11101 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11102 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11103 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11104 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11105 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11106 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11107 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11108 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11109 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11110 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11111 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11112 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11113 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11114 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11115 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11116 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11117 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11118 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11119 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11120 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11121 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11122 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11123 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11124 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11125 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11126 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11127 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11128 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11129 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11130 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11131 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11132 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11133 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11134 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11135 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11136 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11137 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11138 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11139 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11140 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11141 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11142 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11143 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11144 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11145 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11146 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11147 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11148 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11149 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11150 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11151 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11152 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11153 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11154 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11155
11156 =item e
11157
11158 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11159 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11160 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11161 C<expr>, C<extensions>, C<extras>
11162
11163 =item f
11164
11165 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11166 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11167 C<full_sed>
11168
11169 =item g
11170
11171 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11172 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11173 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11174 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11175 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11176 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11177 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11178 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11179 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11180 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11181
11182 =item h
11183
11184 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11185 C<html3dir>, C<html3direxp>
11186
11187 =item i
11188
11189 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11190 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11191 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11192 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11193 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11194 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11195 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11196 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11197 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11198 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11199 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11200 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11201 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11202 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11203 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11204 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11205 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11206 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11207 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11208 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11209 C<installprefixexp>, C<installprivlib>, C<installscript>,
11210 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11211 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11212 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11213 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11214 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11215 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11216 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11217
11218 =item k
11219
11220 C<known_extensions>, C<ksh>
11221
11222 =item l
11223
11224 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11225 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11226 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11227 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11228 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11229 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11230 C<lseektype>
11231
11232 =item m
11233
11234 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11235 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11236 C<man3direxp>, C<man3ext>
11237
11238 =item M
11239
11240 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11241 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11242 C<myuname>
11243
11244 =item n
11245
11246 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11247 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11248 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11249 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11250 C<nvsize>, C<nvtype>
11251
11252 =item o
11253
11254 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11255 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11256
11257 =item p
11258
11259 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11260 C<perl>, C<perl_patchlevel>
11261
11262 =item P
11263
11264 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11265 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11266 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
11267 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
11268
11269 =item q
11270
11271 C<quadkind>, C<quadtype>
11272
11273 =item r
11274
11275 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11276 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11277 C<rmail>, C<run>, C<runnm>
11278
11279 =item s
11280
11281 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11282 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11283 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11284 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11285 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11286 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11287 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11288 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11289 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11290 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11291 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11292 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11293 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11294 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11295 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11296 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11297 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11298 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11299 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11300 C<submit>, C<subversion>, C<sysman>
11301
11302 =item t
11303
11304 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11305 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11306 C<ttyname_r_proto>
11307
11308 =item u
11309
11310 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11311 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11312 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11313 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11314 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11315 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11316 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11317 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11318 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11319 C<uvXUformat>
11320
11321 =item v
11322
11323 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11324 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11325 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11326 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11327 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11328 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11329 C<versiononly>, C<vi>, C<voidflags>
11330
11331 =item x
11332
11333 C<xlibpth>, C<xs_apiversion>
11334
11335 =item y
11336
11337 C<yacc>, C<yaccflags>
11338
11339 =item z
11340
11341 C<zcat>, C<zip>
11342
11343 =back
11344
11345 =item NOTE
11346
11347 =back
11348
11349 =head2 Cwd - get pathname of current working directory
11350
11351 =over 4
11352
11353 =item SYNOPSIS
11354
11355 =item DESCRIPTION
11356
11357 =over 4
11358
11359 =item getcwd and friends
11360
11361 getcwd, cwd, fastcwd, fastgetcwd
11362
11363 =item abs_path and friends
11364
11365 abs_path, realpath, fast_abs_path
11366
11367 =item $ENV{PWD}
11368
11369 =back
11370
11371 =item NOTES
11372
11373 =item SEE ALSO
11374
11375 =back
11376
11377 =head2 DB - programmatic interface to the Perl debugging API (draft,
11378 subject to
11379 change)
11380
11381 =over 4
11382
11383 =item SYNOPSIS
11384
11385 =item DESCRIPTION
11386
11387 =over 4
11388
11389 =item Global Variables
11390
11391  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
11392 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
11393 $DB::lineno
11394
11395 =item API Methods
11396
11397 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11398 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11399
11400 =item Client Callback Methods
11401
11402 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11403 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11404 CLIENT->output(LIST)
11405
11406 =back
11407
11408 =item BUGS
11409
11410 =item AUTHOR
11411
11412 =back
11413
11414 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11415
11416 =over 4
11417
11418 =item SYNOPSIS
11419
11420 =item DESCRIPTION
11421
11422 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11423
11424 =over 4
11425
11426 =item Using DB_File with Berkeley DB version 2 or greater
11427
11428 =item Interface to Berkeley DB
11429
11430 =item Opening a Berkeley DB Database File
11431
11432 =item Default Parameters
11433
11434 =item In Memory Databases
11435
11436 =back
11437
11438 =item DB_HASH
11439
11440 =over 4
11441
11442 =item A Simple Example
11443
11444 =back
11445
11446 =item DB_BTREE
11447
11448 =over 4
11449
11450 =item Changing the BTREE sort order
11451
11452 =item Handling Duplicate Keys
11453
11454 =item The get_dup() Method
11455
11456 =item The find_dup() Method
11457
11458 =item The del_dup() Method
11459
11460 =item Matching Partial Keys
11461
11462 =back
11463
11464 =item DB_RECNO
11465
11466 =over 4
11467
11468 =item The 'bval' Option
11469
11470 =item A Simple Example
11471
11472 =item Extra RECNO Methods
11473
11474 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11475 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11476 length, elements);>
11477
11478 =item Another Example
11479
11480 =back
11481
11482 =item THE API INTERFACE
11483
11484 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11485 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11486 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11487 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11488
11489 =item DBM FILTERS
11490
11491 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11492 B<filter_fetch_value>
11493
11494 =over 4
11495
11496 =item The Filter
11497
11498 =item An Example -- the NULL termination problem.
11499
11500 =item Another Example -- Key is a C int.
11501
11502 =back
11503
11504 =item HINTS AND TIPS
11505
11506 =over 4
11507
11508 =item Locking: The Trouble with fd
11509
11510 =item Safe ways to lock a database
11511
11512 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11513
11514 =item Sharing Databases With C Applications
11515
11516 =item The untie() Gotcha
11517
11518 =back
11519
11520 =item COMMON QUESTIONS
11521
11522 =over 4
11523
11524 =item Why is there Perl source in my database?
11525
11526 =item How do I store complex data structures with DB_File?
11527
11528 =item What does "Invalid Argument" mean?
11529
11530 =item What does "Bareword 'DB_File' not allowed" mean?
11531
11532 =back
11533
11534 =item REFERENCES
11535
11536 =item HISTORY
11537
11538 =item BUGS
11539
11540 =item AVAILABILITY
11541
11542 =item COPYRIGHT
11543
11544 =item SEE ALSO
11545
11546 =item AUTHOR
11547
11548 =back
11549
11550 =head2 Data::Dumper - stringified perl data structures, suitable for both
11551 printing and C<eval>
11552
11553 =over 4
11554
11555 =item SYNOPSIS
11556
11557 =item DESCRIPTION
11558
11559 =over 4
11560
11561 =item Methods
11562
11563 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11564 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11565 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11566 I<$OBJ>->Reset
11567
11568 =item Functions
11569
11570 Dumper(I<LIST>)
11571
11572 =item Configuration Variables or Methods
11573
11574 =item Exports
11575
11576 Dumper
11577
11578 =back
11579
11580 =item EXAMPLES
11581
11582 =item BUGS
11583
11584 =over 4
11585
11586 =item NOTE
11587
11588 =back
11589
11590 =item AUTHOR
11591
11592 =item VERSION
11593
11594 =item SEE ALSO
11595
11596 =back
11597
11598 =head2 Devel::DProf - a Perl code profiler
11599
11600 =over 4
11601
11602 =item SYNOPSIS
11603
11604 =item DESCRIPTION
11605
11606 =item PROFILE FORMAT
11607
11608 =item AUTOLOAD
11609
11610 =item ENVIRONMENT
11611
11612 =item BUGS
11613
11614 =item SEE ALSO
11615
11616 =back
11617
11618 =head2 Devel::PPPort - Perl/Pollution/Portability
11619
11620 =over 4
11621
11622 =item SYNOPSIS
11623
11624 =item DESCRIPTION
11625
11626 =over 4
11627
11628 =item WriteFile
11629
11630 =back
11631
11632 =item ppport.h
11633
11634 =item AUTHOR
11635
11636 =item SEE ALSO
11637
11638 =back
11639
11640 =head2 Devel::Peek - A data debugging tool for the XS programmer
11641
11642 =over 4
11643
11644 =item SYNOPSIS
11645
11646 =item DESCRIPTION
11647
11648 =over 4
11649
11650 =item Runtime debugging
11651
11652 =item Memory footprint debugging
11653
11654 =back
11655
11656 =item EXAMPLES
11657
11658 =over 4
11659
11660 =item A simple scalar string
11661
11662 =item A simple scalar number
11663
11664 =item A simple scalar with an extra reference
11665
11666 =item A reference to a simple scalar
11667
11668 =item A reference to an array
11669
11670 =item A reference to a hash
11671
11672 =item Dumping a large array or hash
11673
11674 =item A reference to an SV which holds a C pointer
11675
11676 =item A reference to a subroutine
11677
11678 =back
11679
11680 =item EXPORTS
11681
11682 =item BUGS
11683
11684 =item AUTHOR
11685
11686 =item SEE ALSO
11687
11688 =back
11689
11690 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11691
11692 =over 4
11693
11694 =item SYNOPSIS
11695
11696 =item DESCRIPTION
11697
11698 =back
11699
11700 =head2 Digest:: - Modules that calculate message digests
11701
11702 =over 4
11703
11704 =item SYNOPSIS
11705
11706 =item DESCRIPTION
11707
11708 I<binary>, I<hex>, I<base64>
11709
11710 =item OO INTERFACE
11711
11712 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11713 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
11714 $ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
11715 $ctx->hexdigest, $ctx->b64digest
11716
11717 =item SEE ALSO
11718
11719 =item AUTHOR
11720
11721 =back
11722
11723 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11724
11725 =over 4
11726
11727 =item SYNOPSIS
11728
11729 =item DESCRIPTION
11730
11731 =item FUNCTIONS
11732
11733 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11734
11735 =item METHODS
11736
11737 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
11738 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11739
11740 =item EXAMPLES
11741
11742 =item SEE ALSO
11743
11744 =item COPYRIGHT
11745
11746 =item AUTHORS
11747
11748 =back
11749
11750 =head2 DirHandle - supply object methods for directory handles
11751
11752 =over 4
11753
11754 =item SYNOPSIS
11755
11756 =item DESCRIPTION
11757
11758 =item NOTES
11759
11760 =back
11761
11762 =head2 Dumpvalue - provides screen dump of Perl data.
11763
11764 =over 4
11765
11766 =item SYNOPSIS
11767
11768 =item DESCRIPTION
11769
11770 =over 4
11771
11772 =item Creation
11773
11774 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11775 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11776 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11777 stopDbSignal
11778
11779 =item Methods
11780
11781 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11782 compactDump, veryCompact, set, get
11783
11784 =back
11785
11786 =back
11787
11788 =head2 DynaLoader - Dynamically load C libraries into Perl code
11789
11790 =over 4
11791
11792 =item SYNOPSIS
11793
11794 =item DESCRIPTION
11795
11796 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11797 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11798 dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
11799 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11800 bootstrap()
11801
11802 =item AUTHOR
11803
11804 =back
11805
11806 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11807 Perl code
11808
11809 =over 4
11810
11811 =item SYNOPSIS
11812
11813 =item DESCRIPTION
11814
11815 =over 4
11816
11817 =item Migration from C<DynaLoader>
11818
11819 =item Backward compatible boilerplate
11820
11821 =back
11822
11823 =item Order of initialization: early load()
11824
11825 =over 4
11826
11827 =item The most hairy case
11828
11829 =back
11830
11831 =item LIMITATIONS
11832
11833 =item AUTHOR
11834
11835 =back
11836
11837 =head2 Encode - character encodings
11838
11839 =over 4
11840
11841 =item SYNOPSIS
11842
11843 =over 4
11844
11845 =item Table of Contents
11846
11847 =back
11848
11849 =item DESCRIPTION
11850
11851 =over 4
11852
11853 =item TERMINOLOGY
11854
11855 =back
11856
11857 =item PERL ENCODING API
11858
11859 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11860 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11861 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11862 CHECK]);
11863
11864 =over 4
11865
11866 =item Listing available encodings
11867
11868 =item Defining Aliases
11869
11870 =back
11871
11872 =item Encoding via PerlIO
11873
11874 =item Handling Malformed Data
11875
11876 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11877 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11878 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11879 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11880 bitmask
11881
11882 =over 4
11883
11884 =item Unimplemented fallback schemes
11885
11886 =back
11887
11888 =item Defining Encodings
11889
11890 =item The UTF-8 flag
11891
11892 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11893
11894 =over 4
11895
11896 =item Messing with Perl's Internals
11897
11898 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11899
11900 =back
11901
11902 =item SEE ALSO
11903
11904 =item MAINTAINER
11905
11906 =back
11907
11908 =head2 Encode::Alias - alias definitions to encodings
11909
11910 =over 4
11911
11912 =item SYNOPSIS
11913
11914 =item DESCRIPTION
11915
11916 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11917 reference, e.g.:
11918
11919 =over 4
11920
11921 =item Alias overloading
11922
11923 =back
11924
11925 =item SEE ALSO
11926
11927 =back
11928
11929 =head2 Encode::Byte - Single Byte Encodings
11930
11931 =over 4
11932
11933 =item SYNOPSIS
11934
11935 =item ABSTRACT
11936
11937 =item DESCRIPTION
11938
11939 =item SEE ALSO
11940
11941 =back
11942
11943 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11944
11945 =head2 Encode::CN - China-based Chinese Encodings
11946
11947 =over 4
11948
11949 =item SYNOPSIS
11950
11951 =item DESCRIPTION
11952
11953 =item NOTES
11954
11955 =item BUGS
11956
11957 =item SEE ALSO
11958
11959 =back
11960
11961 =head2 Encode::CN::HZ -- internally used by Encode::CN
11962
11963 =head2 Encode::Config -- internally used by Encode
11964
11965 =head2 Encode::EBCDIC - EBCDIC Encodings
11966
11967 =over 4
11968
11969 =item SYNOPSIS
11970
11971 =item ABSTRACT
11972
11973 =item DESCRIPTION
11974
11975 =item SEE ALSO
11976
11977 =back
11978
11979 =head2 Encode::Encoding - Encode Implementation Base Class
11980
11981 =over 4
11982
11983 =item SYNOPSIS
11984
11985 =item DESCRIPTION
11986
11987 =over 4
11988
11989 =item Methods you should implement
11990
11991 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11992 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11993
11994 =item Other methods defined in Encode::Encodings
11995
11996 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11997
11998 =item Example: Encode::ROT13
11999
12000 =back
12001
12002 =item Why the heck Encode API is different?
12003
12004 =over 4
12005
12006 =item Compiled Encodings
12007
12008 =back
12009
12010 =item SEE ALSO
12011
12012 Scheme 1, Scheme 2, Other Schemes
12013
12014 =back
12015
12016 =head2 Encode::Guess -- Guesses encoding from data
12017
12018 =over 4
12019
12020 =item SYNOPSIS
12021
12022 =item ABSTRACT
12023
12024 =item DESCRIPTION
12025
12026 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12027 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12028 guess_encoding($data, [, I<list of suspects>])
12029
12030 =item CAVEATS
12031
12032 =item TO DO
12033
12034 =item SEE ALSO
12035
12036 =back
12037
12038 =head2 Encode::JP - Japanese Encodings
12039
12040 =over 4
12041
12042 =item SYNOPSIS
12043
12044 =item ABSTRACT
12045
12046 =item DESCRIPTION
12047
12048 =item Note on ISO-2022-JP(-1)?
12049
12050 =item BUGS
12051
12052 =item SEE ALSO
12053
12054 =back
12055
12056 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12057
12058 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12059
12060 =head2 Encode::KR - Korean Encodings
12061
12062 =over 4
12063
12064 =item SYNOPSIS
12065
12066 =item DESCRIPTION
12067
12068 =item BUGS
12069
12070 =item SEE ALSO
12071
12072 =back
12073
12074 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12075
12076 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12077
12078 =over 4
12079
12080 =item SYNOPSIS
12081
12082 =item ABSTRACT
12083
12084 =item DESCRIPTION
12085
12086 =item BUGS
12087
12088 =item SEE ALSO
12089
12090 =back
12091
12092 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12093
12094 =over 4
12095
12096 =item Overview
12097
12098 =item How does it work?
12099
12100 =item Line Buffering
12101
12102 =over 4
12103
12104 =item How can I tell whether my encoding fully supports PerlIO ?
12105
12106 =back
12107
12108 =item SEE ALSO
12109
12110 =back
12111
12112 =head2 Encode::Supported -- Encodings supported by Encode
12113
12114 =over 4
12115
12116 =item DESCRIPTION
12117
12118 =over 4
12119
12120 =item Encoding Names
12121
12122 =back
12123
12124 =item Supported Encodings
12125
12126 =over 4
12127
12128 =item Built-in Encodings
12129
12130 =item Encode::Unicode -- other Unicode encodings
12131
12132 =item Encode::Byte -- Extended ASCII
12133
12134 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12135 the Cyrillic world, gsm0338 - Hentai Latin 1
12136
12137 =item CJK: Chinese, Japanese, Korean (Multibyte)
12138
12139 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12140 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12141 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12142
12143 =item Miscellaneous encodings
12144
12145 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12146
12147 =back
12148
12149 =item Unsupported encodings
12150
12151   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12152 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12153 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12154 Various Mac encodings, (Mac) Indic encodings
12155
12156 =item Encoding vs. Charset -- terminology
12157
12158 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12159
12160 =over 4
12161
12162 =item Microsoft-related naming mess
12163
12164 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12165
12166 =back
12167
12168 =item Glossary
12169
12170 character repertoire, coded character set (CCS), character encoding scheme
12171 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12172 UTF-16
12173
12174 =item See Also
12175
12176 =item References
12177
12178 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12179 RFC, UC, Unicode Glossary
12180
12181 =over 4
12182
12183 =item Other Notable Sites
12184
12185 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12186 "Introduction to i18n"
12187
12188 =item Offline sources
12189
12190 C<CJKV Information Processing> by Ken Lunde
12191
12192 =back
12193
12194 =back
12195
12196 =head2 Encode::Symbol - Symbol Encodings
12197
12198 =over 4
12199
12200 =item SYNOPSIS
12201
12202 =item ABSTRACT
12203
12204 =item DESCRIPTION
12205
12206 =item SEE ALSO
12207
12208 =back
12209
12210 =head2 Encode::TW - Taiwan-based Chinese Encodings
12211
12212 =over 4
12213
12214 =item SYNOPSIS
12215
12216 =item DESCRIPTION
12217
12218 =item NOTES
12219
12220 =item BUGS
12221
12222 =item SEE ALSO
12223
12224 =back
12225
12226 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12227
12228 =over 4
12229
12230 =item SYNOPSIS
12231
12232 =item ABSTRACT
12233
12234 L<http://www.unicode.org/glossary/> says:, Quick Reference
12235
12236 =item Size, Endianness, and BOM
12237
12238 =over 4
12239
12240 =item by size
12241
12242 =item by endianness
12243
12244 BOM as integer when fetched in network byte order
12245
12246 =back
12247
12248 =item Surrogate Pairs
12249
12250 =item SEE ALSO
12251
12252 =back
12253
12254 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12255
12256 =over 4
12257
12258 =item SYNOPSIS
12259
12260 =item ABSTRACT
12261
12262 =item In Practice
12263
12264 =item SEE ALSO
12265
12266 =back
12267
12268 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12269 encodings
12270
12271 =over 4
12272
12273 =item SYNOPSIS
12274
12275 =item DESCRIPTION
12276
12277 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12278 reference, e.g.:
12279
12280 =over 4
12281
12282 =item Alias overloading
12283
12284 =back
12285
12286 =item SEE ALSO
12287
12288 =back
12289
12290 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12291 Internally used by Encode::??::ISO_2022_*
12292
12293 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12294 Encode::CN
12295
12296 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12297 Encode
12298
12299 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12300 Implementation Base Class
12301
12302 =over 4
12303
12304 =item SYNOPSIS
12305
12306 =item DESCRIPTION
12307
12308 =over 4
12309
12310 =item Methods you should implement
12311
12312 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12313 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12314
12315 =item Other methods defined in Encode::Encodings
12316
12317 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12318
12319 =item Example: Encode::ROT13
12320
12321 =back
12322
12323 =item Why the heck Encode API is different?
12324
12325 =over 4
12326
12327 =item Compiled Encodings
12328
12329 =back
12330
12331 =item SEE ALSO
12332
12333 Scheme 1, Scheme 2, Other Schemes
12334
12335 =back
12336
12337 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12338 data
12339
12340 =over 4
12341
12342 =item SYNOPSIS
12343
12344 =item ABSTRACT
12345
12346 =item DESCRIPTION
12347
12348 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12349 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12350 guess_encoding($data, [, I<list of suspects>])
12351
12352 =item CAVEATS
12353
12354 =item TO DO
12355
12356 =item SEE ALSO
12357
12358 =back
12359
12360 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12361 Encode::JP::2022_JP*
12362
12363 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12364 by Encode::JP
12365
12366 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12367 used by Encode::KR
12368
12369 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12370 and 'Q' header encoding
12371
12372 =over 4
12373
12374 =item SYNOPSIS
12375
12376 =item ABSTRACT
12377
12378 =item DESCRIPTION
12379
12380 =item BUGS
12381
12382 =item SEE ALSO
12383
12384 =back
12385
12386 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12387 on Encode and PerlIO
12388
12389 =over 4
12390
12391 =item Overview
12392
12393 =item How does it work?
12394
12395 =item Line Buffering
12396
12397 =over 4
12398
12399 =item How can I tell whether my encoding fully supports PerlIO ?
12400
12401 =back
12402
12403 =item SEE ALSO
12404
12405 =back
12406
12407 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12408 supported by Encode
12409
12410 =over 4
12411
12412 =item DESCRIPTION
12413
12414 =over 4
12415
12416 =item Encoding Names
12417
12418 =back
12419
12420 =item Supported Encodings
12421
12422 =over 4
12423
12424 =item Built-in Encodings
12425
12426 =item Encode::Unicode -- other Unicode encodings
12427
12428 =item Encode::Byte -- Extended ASCII
12429
12430 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12431 the Cyrillic world, gsm0338 - Hentai Latin 1
12432
12433 =item CJK: Chinese, Japanese, Korean (Multibyte)
12434
12435 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12436 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12437 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12438
12439 =item Miscellaneous encodings
12440
12441 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12442
12443 =back
12444
12445 =item Unsupported encodings
12446
12447   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12448 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12449 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12450 Various Mac encodings, (Mac) Indic encodings
12451
12452 =item Encoding vs. Charset -- terminology
12453
12454 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12455
12456 =over 4
12457
12458 =item Microsoft-related naming mess
12459
12460 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12461
12462 =back
12463
12464 =item Glossary
12465
12466 character repertoire, coded character set (CCS), character encoding scheme
12467 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12468 UTF-16
12469
12470 =item See Also
12471
12472 =item References
12473
12474 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12475 RFC, UC, Unicode Glossary
12476
12477 =over 4
12478
12479 =item Other Notable Sites
12480
12481 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12482 "Introduction to i18n"
12483
12484 =item Offline sources
12485
12486 C<CJKV Information Processing> by Ken Lunde
12487
12488 =back
12489
12490 =back
12491
12492 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12493 encoding
12494
12495 =over 4
12496
12497 =item SYNOPSIS
12498
12499 =item ABSTRACT
12500
12501 =item In Practice
12502
12503 =item SEE ALSO
12504
12505 =back
12506
12507 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12508
12509 =over 4
12510
12511 =item SYNOPSIS
12512
12513 =item ABSTRACT
12514
12515 =item Description
12516
12517 =over 4
12518
12519 =item Predefined Methods
12520
12521 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12522 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12523 $e-E<gt>bytes([$encoding])
12524
12525 =item Example: base64 transcoder
12526
12527 =item Operator Overloading
12528
12529 =back
12530
12531 =item SEE ALSO
12532
12533 =back
12534
12535 =head2 Encodencoding, encoding - allows you to write your script in
12536 non-ascii or non-utf8
12537
12538 =over 4
12539
12540 =item SYNOPSIS
12541
12542 =item ABSTRACT
12543
12544 =over 4
12545
12546 =item Literal Conversions
12547
12548 =item PerlIO layers for C<STD(IN|OUT)>
12549
12550 =back
12551
12552 =item FEATURES THAT REQUIRE 5.8.1
12553
12554 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12555
12556 =item USAGE
12557
12558 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12559 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12560
12561 =item The Filter Option
12562
12563 =over 4
12564
12565 =item Filter-related changes at Encode version 1.87
12566
12567 =back
12568
12569 =item CAVEATS
12570
12571 =over 4
12572
12573 =item NOT SCOPED
12574
12575 =item DO NOT MIX MULTIPLE ENCODINGS
12576
12577 =item tr/// with ranges
12578
12579 Legend of characters above
12580
12581 =back
12582
12583 =item EXAMPLE - Greekperl
12584
12585 =item KNOWN PROBLEMS
12586
12587 literals in regex that are longer than 127 bytes, EBCDIC, format
12588
12589 =item HISTORY
12590
12591 =item SEE ALSO
12592
12593 =back
12594
12595 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12596
12597 =over 4
12598
12599 =item SYNOPSIS
12600
12601 =item ABSTRACT
12602
12603 =item Description
12604
12605 =over 4
12606
12607 =item Predefined Methods
12608
12609 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12610 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12611 $e-E<gt>bytes([$encoding])
12612
12613 =item Example: base64 transcoder
12614
12615 =item Operator Overloading
12616
12617 =back
12618
12619 =item SEE ALSO
12620
12621 =back
12622
12623 =head2 English - use nice English (or awk) names for ugly punctuation
12624 variables
12625
12626 =over 4
12627
12628 =item SYNOPSIS
12629
12630 =item DESCRIPTION
12631
12632 =item PERFORMANCE
12633
12634 =back
12635
12636 =head2 Env - perl module that imports environment variables as scalars or
12637 arrays
12638
12639 =over 4
12640
12641 =item SYNOPSIS
12642
12643 =item DESCRIPTION
12644
12645 =item LIMITATIONS
12646
12647 =item AUTHOR
12648
12649 =back
12650
12651 =head2 Errno - System errno constants
12652
12653 =over 4
12654
12655 =item SYNOPSIS
12656
12657 =item DESCRIPTION
12658
12659 =item CAVEATS
12660
12661 =item AUTHOR
12662
12663 =item COPYRIGHT
12664
12665 =back
12666
12667 =head2 Exporter - Implements default import method for modules
12668
12669 =over 4
12670
12671 =item SYNOPSIS
12672
12673 =item DESCRIPTION
12674
12675 =over 4
12676
12677 =item How to Export
12678
12679 =item Selecting What To Export
12680
12681 =item How to Import
12682
12683 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12684
12685 =back
12686
12687 =item Advanced features
12688
12689 =over 4
12690
12691 =item Specialised Import Lists
12692
12693 =item Exporting without using Exporter's import method
12694
12695 =item Module Version Checking
12696
12697 =item Managing Unknown Symbols
12698
12699 =item Tag Handling Utility Functions
12700
12701 =item Generating combined tags
12702
12703 =item C<AUTOLOAD>ed Constants
12704
12705 =back
12706
12707 =back
12708
12709 =head2 Exporter::Heavy - Exporter guts
12710
12711 =over 4
12712
12713 =item SYNOPSIS
12714
12715 =item DESCRIPTION
12716
12717 =back
12718
12719 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12720 Makefiles etc.
12721
12722 =over 4
12723
12724 =item SYNOPSIS
12725
12726 =item DESCRIPTION
12727
12728 =back
12729
12730 cat
12731
12732 eqtime src dst
12733
12734 rm_rf files...
12735
12736 rm_f files...
12737
12738 touch files ..
12739
12740 mv source... destination
12741
12742 cp source... destination
12743
12744 chmod mode files..
12745
12746 mkpath directory..
12747
12748 test_f file
12749
12750 =over 4
12751
12752 =item BUGS
12753
12754 =item SEE ALSO
12755
12756 =item AUTHOR
12757
12758 =back
12759
12760 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12761
12762 =over 4
12763
12764 =item SYNOPSIS
12765
12766 =item DESCRIPTION
12767
12768 B<test_harness>
12769
12770 =back
12771
12772 B<pod2man>
12773
12774 B<warn_if_old_packlist>
12775
12776 B<perllocal_install>
12777
12778 B<uninstall>
12779
12780 =head2 ExtUtils::Constant - generate XS code to import C header constants
12781
12782 =over 4
12783
12784 =item SYNOPSIS
12785
12786 =item DESCRIPTION
12787
12788 =item USAGE
12789
12790 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12791
12792 =item FUNCTIONS
12793
12794 =back
12795
12796 C_stringify NAME
12797
12798 perl_stringify NAME
12799
12800 constant_types
12801
12802 memEQ_clause NAME, CHECKED_AT, INDENT
12803
12804 assign INDENT, TYPE, PRE, POST, VALUE..
12805
12806 return_clause
12807
12808 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12809
12810 params WHAT
12811
12812 dump_names
12813
12814 dogfood
12815
12816 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12817 def_post, utf8
12818
12819 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12820
12821 autoload PACKAGE, VERSION, AUTOLOADER
12822
12823 WriteMakefileSnippet
12824
12825 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12826 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12827
12828 =over 4
12829
12830 =item AUTHOR
12831
12832 =back
12833
12834 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12835
12836 =over 4
12837
12838 =item SYNOPSIS
12839
12840 =item DESCRIPTION
12841
12842 =item @EXPORT
12843
12844 =item FUNCTIONS
12845
12846 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12847 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12848
12849 =item EXAMPLES
12850
12851 =item SEE ALSO
12852
12853 =item AUTHOR
12854
12855 =back
12856
12857 =head2 ExtUtils::Install - install files from here to there
12858
12859 =over 4
12860
12861 =item SYNOPSIS
12862
12863 =item DESCRIPTION
12864
12865 =over 4
12866
12867 =item Functions
12868
12869 B<install>
12870
12871 =back
12872
12873 =back
12874
12875 B<install_default> I<DISCOURAGED>
12876
12877 B<uninstall>
12878
12879 B<pm_to_blib>
12880
12881 _autosplit
12882
12883 =over 4
12884
12885 =item ENVIRONMENT
12886
12887 B<PERL_INSTALL_ROOT>
12888
12889 =item AUTHOR
12890
12891 =item LICENSE
12892
12893 =back
12894
12895 =head2 ExtUtils::Installed - Inventory management of installed modules
12896
12897 =over 4
12898
12899 =item SYNOPSIS
12900
12901 =item DESCRIPTION
12902
12903 =item USAGE
12904
12905 =item FUNCTIONS
12906
12907 new(), modules(), files(), directories(), directory_tree(), validate(),
12908 packlist(), version()
12909
12910 =item EXAMPLE
12911
12912 =item AUTHOR
12913
12914 =back
12915
12916 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12917
12918 =over 4
12919
12920 =item SYNOPSIS
12921
12922 =item DESCRIPTION
12923
12924 For static extensions, For dynamic extensions at build/link time, For
12925 dynamic extensions at load time
12926
12927 =over 4
12928
12929 =item EXTRALIBS
12930
12931 =item LDLOADLIBS and LD_RUN_PATH
12932
12933 =item BSLOADLIBS
12934
12935 =back
12936
12937 =item PORTABILITY
12938
12939 =over 4
12940
12941 =item VMS implementation
12942
12943 =item Win32 implementation
12944
12945 =back
12946
12947 =item SEE ALSO
12948
12949 =back
12950
12951 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12952
12953 =over 4
12954
12955 =item SYNOPSIS
12956
12957 =item DESCRIPTION
12958
12959 =back
12960
12961 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12962
12963 =over 4
12964
12965 =item SYNOPSIS
12966
12967 =item DESCRIPTION
12968
12969 =item Inherently Cross-Platform Methods
12970
12971 installvars
12972
12973 =back
12974
12975 os_flavor_is
12976
12977 =over 4
12978
12979 =item File::Spec wrappers
12980
12981 catfile
12982
12983 =back
12984
12985 =over 4
12986
12987 =item Thought To Be Cross-Platform Methods
12988
12989 B<split_command>
12990
12991 =back
12992
12993 B<echo>
12994
12995 init_VERSION
12996
12997 wraplist
12998
12999 manifypods
13000
13001 manifypods_target
13002
13003 makemakerdflt_target
13004
13005 special_targets
13006
13007 POD2MAN_macro
13008
13009 test_via_harness
13010
13011 test_via_script
13012
13013 libscan
13014
13015 tool_autosplit
13016
13017 all_target
13018
13019 metafile_target
13020
13021 metafile_addtomanifest_target
13022
13023 =over 4
13024
13025 =item Abstract methods
13026
13027 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13028 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13029 platform_constants
13030
13031 =back
13032
13033 os_flavor
13034
13035 =over 4
13036
13037 =item AUTHOR
13038
13039 =back
13040
13041 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13042 ExtUtils::MakeMaker
13043
13044 =over 4
13045
13046 =item SYNOPSIS
13047
13048 =item DESCRIPTION
13049
13050 =back
13051
13052 os_flavor (o)
13053
13054 init_linker
13055
13056 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13057 ExtUtils::MakeMaker
13058
13059 =over 4
13060
13061 =item SYNOPSIS
13062
13063 =item DESCRIPTION
13064
13065 os_flavor (o)
13066
13067 =back
13068
13069 cflags (o)
13070
13071 replace_manpage_separator (o)
13072
13073 init_linker
13074
13075 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13076
13077 =over 4
13078
13079 =item SYNOPSIS
13080
13081 =item DESCRIPTION
13082
13083 =over 4
13084
13085 =item Overridden methods
13086
13087 os_flavor
13088
13089 =back
13090
13091 =back
13092
13093 B<replace_manpage_separator>
13094
13095 =over 4
13096
13097 =item AUTHOR
13098
13099 =item SEE ALSO
13100
13101 =back
13102
13103 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13104 ExtUtils::MakeMaker
13105
13106 =over 4
13107
13108 =item SYNOPSIS
13109
13110 =item DESCRIPTION
13111
13112 =back
13113
13114 maybe_command
13115
13116 guess_name
13117
13118 macify
13119
13120 patternify
13121
13122 init_main
13123
13124 init_others
13125
13126 init_platform, platform_constants
13127
13128 init_dirscan
13129
13130 init_VERSION (o)
13131
13132 special_targets (o)
13133
13134 static (o)
13135
13136 dlsyms (o)
13137
13138 dynamic (o)
13139
13140 clean (o)
13141
13142 clean_subdirs_target
13143
13144 realclean (o)
13145
13146 realclean_subdirs_target
13147
13148 rulez (o)
13149
13150 processPL (o)
13151
13152 os_flavor
13153
13154 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13155 ExtUtils::MakeMaker
13156
13157 =over 4
13158
13159 =item SYNOPSIS
13160
13161 =item DESCRIPTION
13162
13163 =back
13164
13165 os_flavor
13166
13167 init_platform (o), platform_constants
13168
13169 const_cccmd (o)
13170
13171 static_lib (o)
13172
13173 dynamic_lib (o)
13174
13175 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13176 ExtUtils::MakeMaker
13177
13178 =over 4
13179
13180 =item SYNOPSIS
13181
13182 =item DESCRIPTION
13183
13184 =item METHODS
13185
13186 init_dist (o)
13187
13188 =back
13189
13190 init_linker
13191
13192 os_flavor
13193
13194 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13195
13196 =over 4
13197
13198 =item SYNOPSIS
13199
13200 =item DESCRIPTION
13201
13202 =over 4
13203
13204 =item Overridden methods
13205
13206 os_flavor
13207
13208 =back
13209
13210 =back
13211
13212 B<replace_manpage_separator>
13213
13214 =over 4
13215
13216 =item AUTHOR
13217
13218 =item SEE ALSO
13219
13220 =back
13221
13222 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13223
13224 =over 4
13225
13226 =item SYNOPSIS
13227
13228 =item DESCRIPTION
13229
13230 =item METHODS
13231
13232 =back
13233
13234 =over 4
13235
13236 =item Methods
13237
13238 os_flavor (o)
13239
13240 =back
13241
13242 c_o (o)
13243
13244 cflags (o)
13245
13246 clean (o)
13247
13248 clean_subdirs_target
13249
13250 const_cccmd (o)
13251
13252 const_config (o)
13253
13254 const_loadlibs (o)
13255
13256 constants (o)
13257
13258 depend (o)
13259
13260 dir_target (o)
13261
13262 init_DEST
13263
13264 init_dist
13265
13266 dist (o)
13267
13268 dist_basics (o)
13269
13270 dist_ci (o)
13271
13272 dist_core (o)
13273
13274 B<dist_target>
13275
13276 B<tardist_target>
13277
13278 B<zipdist_target>
13279
13280 B<tarfile_target>
13281
13282 zipfile_target
13283
13284 uutardist_target
13285
13286 shdist_target
13287
13288 distdir
13289
13290 dist_test
13291
13292 dlsyms (o)
13293
13294 dynamic (o)
13295
13296 dynamic_bs (o)
13297
13298 dynamic_lib (o)
13299
13300 exescan
13301
13302 extliblist
13303
13304 find_perl
13305
13306 find_tests
13307
13308 =over 4
13309
13310 =item Methods to actually produce chunks of text for the Makefile
13311
13312 fixin
13313
13314 =back
13315
13316 force (o)
13317
13318 guess_name
13319
13320 has_link_code
13321
13322 init_dirscan
13323
13324 init_DIRFILESEP
13325
13326 init_main
13327
13328 init_others
13329
13330 init_INST
13331
13332 init_INSTALL
13333
13334 init_linker
13335
13336 init_lib2arch
13337
13338 init_PERL
13339
13340 init_platform (o), platform_constants (o)
13341
13342 init_PERM
13343
13344 init_xs
13345
13346 install (o)
13347
13348 installbin (o)
13349
13350 linkext (o)
13351
13352 lsdir
13353
13354 macro (o)
13355
13356 makeaperl (o)
13357
13358 makefile (o)
13359
13360 maybe_command
13361
13362 needs_linking (o)
13363
13364 nicetext
13365
13366 parse_abstract
13367
13368 parse_version
13369
13370 pasthru (o)
13371
13372 perl_script
13373
13374 perldepend (o)
13375
13376 perm_rw (o)
13377
13378 perm_rwx (o)
13379
13380 pm_to_blib
13381
13382 post_constants (o)
13383
13384 post_initialize (o)
13385
13386 postamble (o)
13387
13388 ppd
13389
13390 prefixify
13391
13392 processPL (o)
13393
13394 quote_paren
13395
13396 realclean (o)
13397
13398 realclean_subdirs_target
13399
13400 replace_manpage_separator
13401
13402 oneliner (o)
13403
13404 quote_literal
13405
13406 escape_newlines
13407
13408 max_exec_len
13409
13410 static (o)
13411
13412 static_lib (o)
13413
13414 staticmake (o)
13415
13416 subdir_x (o)
13417
13418 subdirs (o)
13419
13420 test (o)
13421
13422 test_via_harness (override)
13423
13424 test_via_script (override)
13425
13426 tools_other (o)
13427
13428 tool_xsubpp (o)
13429
13430 all_target
13431
13432 top_targets (o)
13433
13434 writedoc
13435
13436 xs_c (o)
13437
13438 xs_cpp (o)
13439
13440 xs_o (o)
13441
13442 =over 4
13443
13444 =item SEE ALSO
13445
13446 =back
13447
13448 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13449 ExtUtils::MakeMaker
13450
13451 =over 4
13452
13453 =item SYNOPSIS
13454
13455 =item DESCRIPTION
13456
13457 =over 4
13458
13459 =item Methods always loaded
13460
13461 wraplist
13462
13463 =back
13464
13465 =back
13466
13467 =over 4
13468
13469 =item Methods
13470
13471 guess_name (override)
13472
13473 =back
13474
13475 find_perl (override)
13476
13477 maybe_command (override)
13478
13479 perl_script (override)
13480
13481 replace_manpage_separator
13482
13483 init_DEST
13484
13485 init_DIRFILESEP
13486
13487 init_main (override)
13488
13489 init_others (override)
13490
13491 init_platform (override)
13492
13493 platform_constants
13494
13495 init_VERSION (override)
13496
13497 constants (override)
13498
13499 special_targets
13500
13501 cflags (override)
13502
13503 const_cccmd (override)
13504
13505 tool_sxubpp (override)
13506
13507 tools_other (override)
13508
13509 init_dist (override)
13510
13511 c_o (override)
13512
13513 xs_c (override)
13514
13515 xs_o (override)
13516
13517 dlsyms (override)
13518
13519 dynamic_lib (override)
13520
13521 dynamic_bs (override)
13522
13523 static_lib (override)
13524
13525 processPL (override)
13526
13527 installbin (override)
13528
13529 subdir_x (override)
13530
13531 clean (override)
13532
13533 clean_subdirs_target
13534
13535 realclean (override)
13536
13537 zipfile_target (o), tarfile_target (o), shdist_target (o)
13538
13539 dist_test (override)
13540
13541 install (override)
13542
13543 perldepend (override)
13544
13545 makefile (override)
13546
13547 find_tests (override)
13548
13549 test (override)
13550
13551 makeaperl (override)
13552
13553 nicetext (override)
13554
13555 prefixify (override)
13556
13557 oneliner (o)
13558
13559 B<echo> (o)
13560
13561 quote_literal
13562
13563 escape_newlines
13564
13565 max_exec_len
13566
13567 init_linker (o)
13568
13569 eliminate_macros
13570
13571 fixpath
13572
13573 os_flavor
13574
13575 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13576 ExtUtils::MakeMaker
13577
13578 =over 4
13579
13580 =item SYNOPSIS
13581
13582 =item DESCRIPTION
13583
13584 =back
13585
13586 =over 4
13587
13588 =item Overridden methods
13589
13590 B<dlsyms>
13591
13592 =back
13593
13594 replace_manpage_separator
13595
13596 B<maybe_command>
13597
13598 B<find_tests>
13599
13600 B<init_DIRFILESEP>
13601
13602 B<init_others>
13603
13604 init_platform (o), platform_constants (o)
13605
13606 special_targets (o)
13607
13608 static_lib (o)
13609
13610 dynamic_lib (o)
13611
13612 clean
13613
13614 init_linker
13615
13616 perl_script
13617
13618 xs_o (o)
13619
13620 pasthru (o)
13621
13622 oneliner (o)
13623
13624 max_exec_len
13625
13626 os_flavor
13627
13628 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13629
13630 =over 4
13631
13632 =item SYNOPSIS
13633
13634 =item DESCRIPTION
13635
13636 =over 4
13637
13638 =item Overriden methods
13639
13640 dist_test
13641
13642 =back
13643
13644 =back
13645
13646 subdir_x
13647
13648 xs_c
13649
13650 xs_cpp
13651
13652 xs_o
13653
13654 clean_subdirs_target
13655
13656 realclean_subdirs_target
13657
13658 max_exec_len
13659
13660 os_flavor
13661
13662 =over 4
13663
13664 =item AUTHOR
13665
13666 =back
13667
13668 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13669
13670 =over 4
13671
13672 =item SYNOPSIS
13673
13674 =item DESCRIPTION
13675
13676 =back
13677
13678 =head2 ExtUtils::MakeMaker - Create a module Makefile
13679
13680 =over 4
13681
13682 =item SYNOPSIS
13683
13684 =item DESCRIPTION
13685
13686 =over 4
13687
13688 =item How To Write A Makefile.PL
13689
13690 =item Default Makefile Behaviour
13691
13692 =item make test
13693
13694 =item make testdb
13695
13696 =item make install
13697
13698 =item PREFIX and LIB attribute
13699
13700 =item AFS users
13701
13702 =item Static Linking of a new Perl Binary
13703
13704 =item Determination of Perl Library and Installation Locations
13705
13706 =item Which architecture dependent directory?
13707
13708 =item Using Attributes and Parameters
13709
13710 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13711 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13712 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13713 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13714 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13715 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13716 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13717 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13718 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13719 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13720 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13721 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
13722 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13723 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
13724 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13725 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13726 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
13727 VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
13728
13729 =item Additional lowercase attributes
13730
13731 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
13732 test, tool_autosplit
13733
13734 =item Overriding MakeMaker Methods
13735
13736 =item The End Of Cargo Cult Programming
13737
13738 C<<MAN3PODS => ' '>>
13739
13740 =item Hintsfile support
13741
13742 =item Distribution Support
13743
13744    make distcheck,    make skipcheck,    make distclean,    make manifest,
13745   make distdir,   make disttest,    make tardist,    make dist,    make
13746 uutardist,    make shdist,    make zipdist,    make ci
13747
13748 =item Module Meta-Data
13749
13750 =item Disabling an extension
13751
13752 =item Other Handy Functions
13753
13754 prompt
13755
13756 =back
13757
13758 =item ENVIRONMENT
13759
13760 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13761
13762 =item SEE ALSO
13763
13764 =item AUTHORS
13765
13766 =item LICENSE
13767
13768 =back
13769
13770 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
13771 MakeMaker
13772
13773 =over 4
13774
13775 =item DESCRIPTION
13776
13777 =over 4
13778
13779 =item Philosophy and History
13780
13781 Why not just use <insert other build config tool here>?, What's
13782 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
13783 shell commands, easier to customize, cleaner internals, less cruft
13784
13785 =item Module Writing
13786
13787 How do I keep my $VERSION up to date without resetting it manually?, What's
13788 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
13789
13790 =item XS
13791
13792 How to I prevent "object version X.XX does not match bootstrap parameter
13793 Y.YY" errors?, How do I make two or more XS files coexist in the same
13794 directory?
13795
13796 =back
13797
13798 =item PATCHING
13799
13800 =item AUTHOR
13801
13802 =item SEE ALSO
13803
13804 =back
13805
13806 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
13807
13808 =over 4
13809
13810 =item SYNOPSIS
13811
13812 =item DESCRIPTION
13813
13814 =over 4
13815
13816 =item The Mantra
13817
13818 =item The Layout
13819
13820 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
13821 bin/
13822
13823 =back
13824
13825 =item SEE ALSO
13826
13827 =back
13828
13829 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
13830
13831 =over 4
13832
13833 =item SYNOPSIS
13834
13835 =item DESCRIPTION
13836
13837 =back
13838
13839 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
13840
13841 =over 4
13842
13843 =item SYNOPSIS
13844
13845 =item DESCRIPTION
13846
13847 =back
13848
13849 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13850
13851 =over 4
13852
13853 =item SYNOPSIS
13854
13855 =item DESCRIPTION
13856
13857 =over 4
13858
13859 =item Functions
13860
13861 mkmanifest
13862
13863 =back
13864
13865 =back
13866
13867 manifind
13868
13869 manicheck
13870
13871 filecheck
13872
13873 fullcheck
13874
13875 skipcheck
13876
13877 maniread
13878
13879 manicopy
13880
13881 maniadd
13882
13883 =over 4
13884
13885 =item MANIFEST
13886
13887 =item MANIFEST.SKIP
13888
13889 =item EXPORT_OK
13890
13891 =item GLOBAL VARIABLES
13892
13893 =back
13894
13895 =over 4
13896
13897 =item DIAGNOSTICS
13898
13899 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13900 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13901
13902 =item ENVIRONMENT
13903
13904 B<PERL_MM_MANIFEST_DEBUG>
13905
13906 =item SEE ALSO
13907
13908 =item AUTHOR
13909
13910 =back
13911
13912 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13913
13914 =over 4
13915
13916 =item SYNOPSIS
13917
13918 =item DESCRIPTION
13919
13920 =back
13921
13922 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13923 extension
13924
13925 =over 4
13926
13927 =item SYNOPSIS
13928
13929 =item DESCRIPTION
13930
13931 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13932
13933 =item AUTHOR
13934
13935 =item REVISION
13936
13937 =back
13938
13939 =head2 ExtUtils::Packlist - manage .packlist files
13940
13941 =over 4
13942
13943 =item SYNOPSIS
13944
13945 =item DESCRIPTION
13946
13947 =item USAGE
13948
13949 =item FUNCTIONS
13950
13951 new(), read(), write(), validate(), packlist_file()
13952
13953 =item EXAMPLE
13954
13955 =item AUTHOR
13956
13957 =back
13958
13959 =head2 ExtUtils::testlib - add blib/* directories to @INC
13960
13961 =over 4
13962
13963 =item SYNOPSIS
13964
13965 =item DESCRIPTION
13966
13967 =back
13968
13969 =head2 Fatal - replace functions with equivalents which succeed or die
13970
13971 =over 4
13972
13973 =item SYNOPSIS
13974
13975 =item DESCRIPTION
13976
13977 =item AUTHOR
13978
13979 =back
13980
13981 =head2 Fcntl - load the C Fcntl.h defines
13982
13983 =over 4
13984
13985 =item SYNOPSIS
13986
13987 =item DESCRIPTION
13988
13989 =item NOTE
13990
13991 =item EXPORTED SYMBOLS
13992
13993 =back
13994
13995 =head2 File::Basename, fileparse - split a pathname into pieces
13996
13997 =over 4
13998
13999 =item SYNOPSIS
14000
14001 =item DESCRIPTION
14002
14003 fileparse_set_fstype, fileparse
14004
14005 =item EXAMPLES
14006
14007 C<basename>, C<dirname>
14008
14009 =back
14010
14011 =head2 File::CheckTree, validate - run many filetest checks on a tree
14012
14013 =over 4
14014
14015 =item SYNOPSIS
14016
14017 =item DESCRIPTION
14018
14019 =item AUTHOR
14020
14021 =item HISTORY
14022
14023 =back
14024
14025 =head2 File::Compare - Compare files or filehandles
14026
14027 =over 4
14028
14029 =item SYNOPSIS
14030
14031 =item DESCRIPTION
14032
14033 =item RETURN
14034
14035 =item AUTHOR
14036
14037 =back
14038
14039 =head2 File::Copy - Copy files or filehandles
14040
14041 =over 4
14042
14043 =item SYNOPSIS
14044
14045 =item DESCRIPTION
14046
14047 =over 4
14048
14049 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14050
14051 rmscopy($from,$to[,$date_flag])
14052
14053 =back
14054
14055 =item RETURN
14056
14057 =item NOTES
14058
14059 =item AUTHOR
14060
14061 =back
14062
14063 =head2 File::DosGlob - DOS like globbing and then some
14064
14065 =over 4
14066
14067 =item SYNOPSIS
14068
14069 =item DESCRIPTION
14070
14071 =item NOTES
14072
14073 =item EXPORTS (by request only)
14074
14075 =item BUGS
14076
14077 =item AUTHOR
14078
14079 =item HISTORY
14080
14081 =item SEE ALSO
14082
14083 =back
14084
14085 =head2 File::Find - Traverse a directory tree.
14086
14087 =over 4
14088
14089 =item SYNOPSIS
14090
14091 =item DESCRIPTION
14092
14093 B<find>, B<finddepth>
14094
14095 =over 4
14096
14097 =item %options
14098
14099 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14100 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14101 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14102
14103 =item The wanted function
14104
14105 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14106 filename within that directory, C<$File::Find::name> is the complete
14107 pathname to the file
14108
14109 =back
14110
14111 =item WARNINGS
14112
14113 =item CAVEAT
14114
14115 $dont_use_nlink, symlinks
14116
14117 =item NOTES
14118
14119 =item HISTORY
14120
14121 =back
14122
14123 =head2 File::Glob - Perl extension for BSD glob routine
14124
14125 =over 4
14126
14127 =item SYNOPSIS
14128
14129 =item DESCRIPTION
14130
14131 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14132 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14133 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14134
14135 =item DIAGNOSTICS
14136
14137 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14138
14139 =item NOTES
14140
14141 =item AUTHOR
14142
14143 =back
14144
14145 =head2 File::Path - create or remove directory trees
14146
14147 =over 4
14148
14149 =item SYNOPSIS
14150
14151 =item DESCRIPTION
14152
14153 =item DIAGNOSTICS
14154
14155 =item AUTHORS
14156
14157 =back
14158
14159 =head2 File::Spec - portably perform operations on file names
14160
14161 =over 4
14162
14163 =item SYNOPSIS
14164
14165 =item DESCRIPTION
14166
14167 =item METHODS
14168
14169 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14170 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14171 splitdir, catpath(), abs2rel, rel2abs()
14172
14173 =item SEE ALSO
14174
14175 =item AUTHORS
14176
14177 =back
14178
14179 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14180
14181 =over 4
14182
14183 =item SYNOPSIS
14184
14185 =item DESCRIPTION
14186
14187 =back
14188
14189 canonpath
14190
14191 file_name_is_absolute
14192
14193 tmpdir (override)
14194
14195 =head2 File::Spec::Epoc - methods for Epoc file specs
14196
14197 =over 4
14198
14199 =item SYNOPSIS
14200
14201 =item DESCRIPTION
14202
14203 =item AUTHORS
14204
14205 =back
14206
14207 canonpath()
14208
14209 =over 4
14210
14211 =item SEE ALSO
14212
14213 =back
14214
14215 =head2 File::Spec::Functions - portably perform operations on file names
14216
14217 =over 4
14218
14219 =item SYNOPSIS
14220
14221 =item DESCRIPTION
14222
14223 =over 4
14224
14225 =item Exports
14226
14227 =back
14228
14229 =item SEE ALSO
14230
14231 =back
14232
14233 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14234
14235 =over 4
14236
14237 =item SYNOPSIS
14238
14239 =item DESCRIPTION
14240
14241 =item METHODS
14242
14243 canonpath
14244
14245 =back
14246
14247 catdir()
14248
14249 catfile
14250
14251 curdir
14252
14253 devnull
14254
14255 rootdir
14256
14257 tmpdir
14258
14259 updir
14260
14261 file_name_is_absolute
14262
14263 path
14264
14265 splitpath
14266
14267 splitdir
14268
14269 catpath
14270
14271 abs2rel
14272
14273 rel2abs
14274
14275 =over 4
14276
14277 =item AUTHORS
14278
14279 =item SEE ALSO
14280
14281 =back
14282
14283 tmpdir
14284
14285 canonpath
14286
14287 splitpath
14288
14289 splitdir
14290
14291 catpath
14292
14293 =head2 File::Spec::OS2 - methods for OS/2 file specs
14294
14295 =over 4
14296
14297 =item SYNOPSIS
14298
14299 =item DESCRIPTION
14300
14301 =back
14302
14303 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14304 modules
14305
14306 =over 4
14307
14308 =item SYNOPSIS
14309
14310 =item DESCRIPTION
14311
14312 =item METHODS
14313
14314 canonpath()
14315
14316 =back
14317
14318 catdir()
14319
14320 catfile
14321
14322 curdir
14323
14324 devnull
14325
14326 rootdir
14327
14328 tmpdir
14329
14330 updir
14331
14332 no_upwards
14333
14334 case_tolerant
14335
14336 file_name_is_absolute
14337
14338 path
14339
14340 join
14341
14342 splitpath
14343
14344 splitdir
14345
14346 catpath()
14347
14348 abs2rel
14349
14350 rel2abs()
14351
14352 =over 4
14353
14354 =item SEE ALSO
14355
14356 =back
14357
14358 =head2 File::Spec::VMS - methods for VMS file specs
14359
14360 =over 4
14361
14362 =item SYNOPSIS
14363
14364 =item DESCRIPTION
14365
14366 eliminate_macros
14367
14368 =back
14369
14370 fixpath
14371
14372 =over 4
14373
14374 =item Methods always loaded
14375
14376 canonpath (override)
14377
14378 =back
14379
14380 catdir
14381
14382 catfile
14383
14384 curdir (override)
14385
14386 devnull (override)
14387
14388 rootdir (override)
14389
14390 tmpdir (override)
14391
14392 updir (override)
14393
14394 case_tolerant (override)
14395
14396 path (override)
14397
14398 file_name_is_absolute (override)
14399
14400 splitpath (override)
14401
14402 splitdir (override)
14403
14404 catpath (override)
14405
14406 abs2rel (override)
14407
14408 rel2abs (override)
14409
14410 =over 4
14411
14412 =item SEE ALSO
14413
14414 =back
14415
14416 =head2 File::Spec::Win32 - methods for Win32 file specs
14417
14418 =over 4
14419
14420 =item SYNOPSIS
14421
14422 =item DESCRIPTION
14423
14424 devnull
14425
14426 =back
14427
14428 tmpdir
14429
14430 catfile
14431
14432 canonpath
14433
14434 splitpath
14435
14436 splitdir
14437
14438 catpath
14439
14440 =over 4
14441
14442 =item Note For File::Spec::Win32 Maintainers
14443
14444 =back
14445
14446 =over 4
14447
14448 =item SEE ALSO
14449
14450 =back
14451
14452 =head2 File::Temp - return name and handle of a temporary file safely
14453
14454 =over 4
14455
14456 =item PORTABILITY
14457
14458 =item SYNOPSIS
14459
14460 =item DESCRIPTION
14461
14462 =back
14463
14464 =over 4
14465
14466 =item FUNCTIONS
14467
14468 B<tempfile>
14469
14470 =back
14471
14472 B<tempdir>
14473
14474 =over 4
14475
14476 =item MKTEMP FUNCTIONS
14477
14478 B<mkstemp>
14479
14480 =back
14481
14482 B<mkstemps>
14483
14484 B<mkdtemp>
14485
14486 B<mktemp>
14487
14488 =over 4
14489
14490 =item POSIX FUNCTIONS
14491
14492 B<tmpnam>
14493
14494 =back
14495
14496 B<tmpfile>
14497
14498 =over 4
14499
14500 =item ADDITIONAL FUNCTIONS
14501
14502 B<tempnam>
14503
14504 =back
14505
14506 =over 4
14507
14508 =item UTILITY FUNCTIONS
14509
14510 B<unlink0>
14511
14512 =back
14513
14514 =over 4
14515
14516 =item PACKAGE VARIABLES
14517
14518 B<safe_level>, STANDARD, MEDIUM, HIGH
14519
14520 =back
14521
14522 TopSystemUID
14523
14524 =over 4
14525
14526 =item WARNING
14527
14528 =over 4
14529
14530 =item Temporary files and NFS
14531
14532 =back
14533
14534 =item HISTORY
14535
14536 =item SEE ALSO
14537
14538 =item AUTHOR
14539
14540 =back
14541
14542 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14543
14544 =over 4
14545
14546 =item SYNOPSIS
14547
14548 =item DESCRIPTION
14549
14550 =item BUGS
14551
14552 =item NOTE
14553
14554 =item AUTHOR
14555
14556 =back
14557
14558 =head2 FileCache - keep more files open than the system permits
14559
14560 =over 4
14561
14562 =item SYNOPSIS
14563
14564 =item DESCRIPTION
14565
14566 cacheout EXPR, cacheout MODE, EXPR
14567
14568 =item CAVEATS
14569
14570 =item BUGS
14571
14572 =item NOTES
14573
14574 =back
14575
14576 =head2 FileHandle - supply object methods for filehandles
14577
14578 =over 4
14579
14580 =item SYNOPSIS
14581
14582 =item DESCRIPTION
14583
14584 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14585
14586 =item SEE ALSO
14587
14588 =back
14589
14590 =head2 Filter::Simple - Simplified source filtering
14591
14592 =over 4
14593
14594 =item SYNOPSIS
14595
14596 =item DESCRIPTION
14597
14598 =over 4
14599
14600 =item The Problem
14601
14602 =item A Solution
14603
14604 =item Disabling or changing <no> behaviour
14605
14606 =item All-in-one interface
14607
14608 =item Filtering only specific components of source code
14609
14610 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14611 C<"all">
14612
14613 =item Filtering only the code parts of source code
14614
14615 Most source code ceases to be grammatically correct when it is broken up
14616 into the pieces between string literals and regexes. So the C<'code'>
14617 component filter behaves slightly differently from the other partial
14618 filters
14619 described in the previous section.
14620
14621 =item Using Filter::Simple with an explicit C<import> subroutine
14622
14623 =item Using Filter::Simple and Exporter together
14624
14625 =item How it works
14626
14627 =back
14628
14629 =item AUTHOR
14630
14631 =item COPYRIGHT
14632
14633 =back
14634
14635 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14636
14637 =over 4
14638
14639 =item SYNOPSIS
14640
14641 =item DESCRIPTION
14642
14643 =over 4
14644
14645 =item B<use Filter::Util::Call>
14646
14647 =item B<import()>
14648
14649 =item B<filter() and anonymous sub>
14650
14651 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14652
14653 =back
14654
14655 =item EXAMPLES
14656
14657 =over 4
14658
14659 =item Example 1: A simple filter.
14660
14661 =item Example 2: Using the context
14662
14663 =item Example 3: Using the context within the filter
14664
14665 =item Example 4: Using filter_del
14666
14667 =back
14668
14669 =item Filter::Simple
14670
14671 =item AUTHOR
14672
14673 =item DATE
14674
14675 =back
14676
14677 =head2 FindBin - Locate directory of original perl script
14678
14679 =over 4
14680
14681 =item SYNOPSIS
14682
14683 =item DESCRIPTION
14684
14685 =item EXPORTABLE VARIABLES
14686
14687 =item KNOWN ISSUES
14688
14689 =item KNOWN BUGS
14690
14691 =item AUTHORS
14692
14693 =item COPYRIGHT
14694
14695 =back
14696
14697 =head2 GDBM_File - Perl5 access to the gdbm library.
14698
14699 =over 4
14700
14701 =item SYNOPSIS
14702
14703 =item DESCRIPTION
14704
14705 =item AVAILABILITY
14706
14707 =item BUGS
14708
14709 =item SEE ALSO
14710
14711 =back
14712
14713 =head2 Getopt::Long - Extended processing of command line options
14714
14715 =over 4
14716
14717 =item SYNOPSIS
14718
14719 =item DESCRIPTION
14720
14721 =item Command Line Options, an Introduction
14722
14723 =item Getting Started with Getopt::Long
14724
14725 =over 4
14726
14727 =item Simple options
14728
14729 =item A little bit less simple options
14730
14731 =item Mixing command line option with other arguments
14732
14733 =item Options with values
14734
14735 =item Options with multiple values
14736
14737 =item Options with hash values
14738
14739 =item User-defined subroutines to handle options
14740
14741 =item Options with multiple names
14742
14743 =item Case and abbreviations
14744
14745 =item Summary of Option Specifications
14746
14747 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
14748 + [ I<desttype> ]
14749
14750 =back
14751
14752 =item Advanced Possibilities
14753
14754 =over 4
14755
14756 =item Object oriented interface
14757
14758 =item Thread Safety
14759
14760 =item Documentation and help texts
14761
14762 =item Storing options in a hash
14763
14764 =item Bundling
14765
14766 =item The lonesome dash
14767
14768 =item Argument callback
14769
14770 =back
14771
14772 =item Configuring Getopt::Long
14773
14774 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
14775 require_order, permute, bundling (default: disabled), bundling_override
14776 (default: disabled), ignore_case  (default: enabled), ignore_case_always
14777 (default: disabled), auto_version (default:disabled), auto_help
14778 (default:disabled), pass_through (default: disabled), prefix,
14779 prefix_pattern, debug (default: disabled)
14780
14781 =item Exportable Methods
14782
14783 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
14784
14785 =item Return values and Errors
14786
14787 =item Legacy
14788
14789 =over 4
14790
14791 =item Default destinations
14792
14793 =item Alternative option starters
14794
14795 =item Configuration variables
14796
14797 =back
14798
14799 =item Trouble Shooting
14800
14801 =over 4
14802
14803 =item Warning: Ignoring '!' modifier for short option
14804
14805 =item GetOptions does not return a false result when an option is not
14806 supplied
14807
14808 =item GetOptions does not split the command line correctly
14809
14810 =item Undefined subroutine &main::GetOptions called
14811
14812 =item How do I put a "-?" option into a Getopt::Long?
14813
14814 =back
14815
14816 =item AUTHOR
14817
14818 =item COPYRIGHT AND DISCLAIMER
14819
14820 =back
14821
14822 =head2 Getopt::Std, getopt - Process single-character switches with switch
14823 clustering
14824
14825 =over 4
14826
14827 =item SYNOPSIS
14828
14829 =item DESCRIPTION
14830
14831 =item C<--help> and C<--version>
14832
14833 =back
14834
14835 =head2 Hash::Util - A selection of general-utility hash subroutines
14836
14837 =over 4
14838
14839 =item SYNOPSIS
14840
14841 =item DESCRIPTION
14842
14843 =over 4
14844
14845 =item Restricted hashes
14846
14847 lock_keys, unlock_keys
14848
14849 =back
14850
14851 =back
14852
14853 lock_value, unlock_value
14854
14855 B<lock_hash>, B<unlock_hash>
14856
14857 =over 4
14858
14859 =item CAVEATS
14860
14861 =item AUTHOR
14862
14863 =item SEE ALSO
14864
14865 =back
14866
14867 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14868 locale
14869
14870 =over 4
14871
14872 =item SYNOPSIS
14873
14874 =item DESCRIPTION
14875
14876 =back
14877
14878 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14879 tags
14880
14881 =over 4
14882
14883 =item SYNOPSIS
14884
14885 =item DESCRIPTION
14886
14887 =back
14888
14889 the function is_language_tag($lang1)
14890
14891 the function extract_language_tags($whatever)
14892
14893 the function same_language_tag($lang1, $lang2)
14894
14895 the function similarity_language_tag($lang1, $lang2)
14896
14897 the function is_dialect_of($lang1, $lang2)
14898
14899 the function super_languages($lang1)
14900
14901 the function locale2language_tag($locale_identifier)
14902
14903 the function encode_language_tag($lang1)
14904
14905 the function alternate_language_tags($lang1)
14906
14907 the function @langs = panic_languages(@accept_languages)
14908
14909 =over 4
14910
14911 =item ABOUT LOWERCASING
14912
14913 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14914
14915 =item SEE ALSO
14916
14917 =item COPYRIGHT
14918
14919 =item AUTHOR
14920
14921 =back
14922
14923 =head2 I18N::LangTags::List -- tags and names for human languages
14924
14925 =over 4
14926
14927 =item SYNOPSIS
14928
14929 =item DESCRIPTION
14930
14931 =item ABOUT LANGUAGE TAGS
14932
14933 =item LIST OF LANGUAGES
14934
14935 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
14936 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
14937 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
14938 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
14939 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
14940 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
14941 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
14942 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
14943 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
14944 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
14945 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
14946 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
14947 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
14948 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
14949 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
14950 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
14951 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
14952 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
14953 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
14954 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
14955 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
14956 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
14957 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
14958 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
14959 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
14960 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
14961 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
14962 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
14963 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
14964 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
14965 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
14966 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
14967 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
14968 English, {enm} : Old English (1100-1500), {ang} : Old English
14969 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
14970 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
14971 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
14972 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
14973 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
14974 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
14975 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
14976 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
14977 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
14978 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
14979 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
14980 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
14981 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14982 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14983 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
14984 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
14985 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
14986 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
14987 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
14988 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
14989 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
14990 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
14991 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
14992 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
14993 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
14994 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
14995 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
14996 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
14997 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
14998 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
14999 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15000 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15001 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15002 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15003 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15004 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15005 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15006 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15007 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15008 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15009 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15010 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15011 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15012 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15013 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15014 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15015 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15016 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15017 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15018 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15019 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15020 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15021 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15022 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15023 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15024 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15025 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15026 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15027 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15028 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15029 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15030 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15031 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15032 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15033 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15034 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15035 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15036 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15037 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15038 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15039 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15040 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15041 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15042 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15043 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15044 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15045 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15046 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15047 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15048 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15049 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15050 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15051 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15052 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15053 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15054 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15055 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15056 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15057 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15058 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15059 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15060 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15061 {zun} : Zuni
15062
15063 =item SEE ALSO
15064
15065 =item COPYRIGHT AND DISCLAIMER
15066
15067 =item AUTHOR
15068
15069 =back
15070
15071 =head2 I18N::Langinfo - query locale information
15072
15073 =over 4
15074
15075 =item SYNOPSIS
15076
15077 =item DESCRIPTION
15078
15079 =over 4
15080
15081 =item EXPORT
15082
15083 =back
15084
15085 =item SEE ALSO
15086
15087 =item AUTHOR
15088
15089 =item COPYRIGHT AND LICENSE
15090
15091 =back
15092
15093 =head2 IO - load various IO modules
15094
15095 =over 4
15096
15097 =item SYNOPSIS
15098
15099 =item DESCRIPTION
15100
15101 =item DEPRECATED
15102
15103 =back
15104
15105 =head2 IO::Dir - supply object methods for directory handles
15106
15107 =over 4
15108
15109 =item SYNOPSIS
15110
15111 =item DESCRIPTION
15112
15113 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15114 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15115
15116 =item SEE ALSO
15117
15118 =item AUTHOR
15119
15120 =item COPYRIGHT
15121
15122 =back
15123
15124 =head2 IO::File - supply object methods for filehandles
15125
15126 =over 4
15127
15128 =item SYNOPSIS
15129
15130 =item DESCRIPTION
15131
15132 =item CONSTRUCTOR
15133
15134 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15135
15136 =item METHODS
15137
15138 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15139
15140 =item SEE ALSO
15141
15142 =item HISTORY
15143
15144 =back
15145
15146 =head2 IO::Handle - supply object methods for I/O handles
15147
15148 =over 4
15149
15150 =item SYNOPSIS
15151
15152 =item DESCRIPTION
15153
15154 =item CONSTRUCTOR
15155
15156 new (), new_from_fd ( FD, MODE )
15157
15158 =item METHODS
15159
15160 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15161 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15162 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15163 $io->blocking ( [ BOOL ] ), $io->untaint
15164
15165 =item NOTE
15166
15167 =item SEE ALSO
15168
15169 =item BUGS
15170
15171 =item HISTORY
15172
15173 =back
15174
15175 =head2 IO::Pipe - supply object methods for pipes
15176
15177 =over 4
15178
15179 =item SYNOPSIS
15180
15181 =item DESCRIPTION
15182
15183 =item CONSTRUCTOR
15184
15185 new ( [READER, WRITER] )
15186
15187 =item METHODS
15188
15189 reader ([ARGS]), writer ([ARGS]), handles ()
15190
15191 =item SEE ALSO
15192
15193 =item AUTHOR
15194
15195 =item COPYRIGHT
15196
15197 =back
15198
15199 =head2 IO::Poll - Object interface to system poll call
15200
15201 =over 4
15202
15203 =item SYNOPSIS
15204
15205 =item DESCRIPTION
15206
15207 =item METHODS
15208
15209 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15210 IO ), handles( [ EVENT_MASK ] )
15211
15212 =item SEE ALSO
15213
15214 =item AUTHOR
15215
15216 =item COPYRIGHT
15217
15218 =back
15219
15220 =head2 IO::Seekable - supply seek based methods for I/O objects
15221
15222 =over 4
15223
15224 =item SYNOPSIS
15225
15226 =item DESCRIPTION
15227
15228 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15229 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15230 $io->tell
15231
15232 =item SEE ALSO
15233
15234 =item HISTORY
15235
15236 =back
15237
15238 =head2 IO::Select - OO interface to the select system call
15239
15240 =over 4
15241
15242 =item SYNOPSIS
15243
15244 =item DESCRIPTION
15245
15246 =item CONSTRUCTOR
15247
15248 new ( [ HANDLES ] )
15249
15250 =item METHODS
15251
15252 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15253 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15254 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15255
15256 =item EXAMPLE
15257
15258 =item AUTHOR
15259
15260 =item COPYRIGHT
15261
15262 =back
15263
15264 =head2 IO::Socket - Object interface to socket communications
15265
15266 =over 4
15267
15268 =item SYNOPSIS
15269
15270 =item DESCRIPTION
15271
15272 =item CONSTRUCTOR
15273
15274 new ( [ARGS] )
15275
15276 =item METHODS
15277
15278 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15279 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15280
15281 =item SEE ALSO
15282
15283 =item AUTHOR
15284
15285 =item COPYRIGHT
15286
15287 =back
15288
15289 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15290
15291 =over 4
15292
15293 =item SYNOPSIS
15294
15295 =item DESCRIPTION
15296
15297 =item CONSTRUCTOR
15298
15299 new ( [ARGS] )
15300
15301 =over 4
15302
15303 =item METHODS
15304
15305 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15306 ()
15307
15308 =back
15309
15310 =item SEE ALSO
15311
15312 =item AUTHOR
15313
15314 =item COPYRIGHT
15315
15316 =back
15317
15318 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15319
15320 =over 4
15321
15322 =item SYNOPSIS
15323
15324 =item DESCRIPTION
15325
15326 =item CONSTRUCTOR
15327
15328 new ( [ARGS] )
15329
15330 =item METHODS
15331
15332 hostpath(), peerpath()
15333
15334 =item SEE ALSO
15335
15336 =item AUTHOR
15337
15338 =item COPYRIGHT
15339
15340 =back
15341
15342 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15343 handles
15344
15345 =over 4
15346
15347 =item SYNOPSIS
15348
15349 =item DESCRIPTION
15350
15351 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15352 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15353
15354 =item SEE ALSO
15355
15356 =item AUTHOR
15357
15358 =item COPYRIGHT
15359
15360 =back
15361
15362 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15363
15364 =over 4
15365
15366 =item SYNOPSIS
15367
15368 =item DESCRIPTION
15369
15370 =item CONSTRUCTOR
15371
15372 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15373
15374 =item METHODS
15375
15376 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15377
15378 =item SEE ALSO
15379
15380 =item HISTORY
15381
15382 =back
15383
15384 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15385 handles
15386
15387 =over 4
15388
15389 =item SYNOPSIS
15390
15391 =item DESCRIPTION
15392
15393 =item CONSTRUCTOR
15394
15395 new (), new_from_fd ( FD, MODE )
15396
15397 =item METHODS
15398
15399 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15400 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15401 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15402 $io->blocking ( [ BOOL ] ), $io->untaint
15403
15404 =item NOTE
15405
15406 =item SEE ALSO
15407
15408 =item BUGS
15409
15410 =item HISTORY
15411
15412 =back
15413
15414 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15415
15416 =over 4
15417
15418 =item SYNOPSIS
15419
15420 =item DESCRIPTION
15421
15422 =item CONSTRUCTOR
15423
15424 new ( [READER, WRITER] )
15425
15426 =item METHODS
15427
15428 reader ([ARGS]), writer ([ARGS]), handles ()
15429
15430 =item SEE ALSO
15431
15432 =item AUTHOR
15433
15434 =item COPYRIGHT
15435
15436 =back
15437
15438 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15439
15440 =over 4
15441
15442 =item SYNOPSIS
15443
15444 =item DESCRIPTION
15445
15446 =item METHODS
15447
15448 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15449 IO ), handles( [ EVENT_MASK ] )
15450
15451 =item SEE ALSO
15452
15453 =item AUTHOR
15454
15455 =item COPYRIGHT
15456
15457 =back
15458
15459 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15460 I/O objects
15461
15462 =over 4
15463
15464 =item SYNOPSIS
15465
15466 =item DESCRIPTION
15467
15468 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15469 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15470 $io->tell
15471
15472 =item SEE ALSO
15473
15474 =item HISTORY
15475
15476 =back
15477
15478 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15479 call
15480
15481 =over 4
15482
15483 =item SYNOPSIS
15484
15485 =item DESCRIPTION
15486
15487 =item CONSTRUCTOR
15488
15489 new ( [ HANDLES ] )
15490
15491 =item METHODS
15492
15493 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15494 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15495 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15496
15497 =item EXAMPLE
15498
15499 =item AUTHOR
15500
15501 =item COPYRIGHT
15502
15503 =back
15504
15505 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15506 communications
15507
15508 =over 4
15509
15510 =item SYNOPSIS
15511
15512 =item DESCRIPTION
15513
15514 =item CONSTRUCTOR
15515
15516 new ( [ARGS] )
15517
15518 =item METHODS
15519
15520 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15521 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15522
15523 =item SEE ALSO
15524
15525 =item AUTHOR
15526
15527 =item COPYRIGHT
15528
15529 =back
15530
15531 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15532 AF_INET domain sockets
15533
15534 =over 4
15535
15536 =item SYNOPSIS
15537
15538 =item DESCRIPTION
15539
15540 =item CONSTRUCTOR
15541
15542 new ( [ARGS] )
15543
15544 =over 4
15545
15546 =item METHODS
15547
15548 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15549 ()
15550
15551 =back
15552
15553 =item SEE ALSO
15554
15555 =item AUTHOR
15556
15557 =item COPYRIGHT
15558
15559 =back
15560
15561 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15562 AF_UNIX domain sockets
15563
15564 =over 4
15565
15566 =item SYNOPSIS
15567
15568 =item DESCRIPTION
15569
15570 =item CONSTRUCTOR
15571
15572 new ( [ARGS] )
15573
15574 =item METHODS
15575
15576 hostpath(), peerpath()
15577
15578 =item SEE ALSO
15579
15580 =item AUTHOR
15581
15582 =item COPYRIGHT
15583
15584 =back
15585
15586 =head2 IPC::Msg - SysV Msg IPC object class
15587
15588 =over 4
15589
15590 =item SYNOPSIS
15591
15592 =item DESCRIPTION
15593
15594 =item METHODS
15595
15596 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15597 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15598 FLAGS ] ), stat
15599
15600 =item SEE ALSO
15601
15602 =item AUTHOR
15603
15604 =item COPYRIGHT
15605
15606 =back
15607
15608 =head2 IPC::Open2, open2 - open a process for both reading and writing
15609
15610 =over 4
15611
15612 =item SYNOPSIS
15613
15614 =item DESCRIPTION
15615
15616 =item WARNING
15617
15618 =item SEE ALSO
15619
15620 =back
15621
15622 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15623 handling
15624
15625 =over 4
15626
15627 =item SYNOPSIS
15628
15629 =item DESCRIPTION
15630
15631 =item WARNING
15632
15633 =back
15634
15635 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15636
15637 =over 4
15638
15639 =item SYNOPSIS
15640
15641 =item DESCRIPTION
15642
15643 =item METHODS
15644
15645 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15646 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15647 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15648 , VALUE ), stat
15649
15650 =item SEE ALSO
15651
15652 =item AUTHOR
15653
15654 =item COPYRIGHT
15655
15656 =back
15657
15658 =head2 IPC::SysV - SysV IPC constants
15659
15660 =over 4
15661
15662 =item SYNOPSIS
15663
15664 =item DESCRIPTION
15665
15666 ftok( PATH, ID )
15667
15668 =item SEE ALSO
15669
15670 =item AUTHORS
15671
15672 =item COPYRIGHT
15673
15674 =back
15675
15676 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15677
15678 =over 4
15679
15680 =item SYNOPSIS
15681
15682 =item DESCRIPTION
15683
15684 =item METHODS
15685
15686 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15687 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15688 FLAGS ] ), stat
15689
15690 =item SEE ALSO
15691
15692 =item AUTHOR
15693
15694 =item COPYRIGHT
15695
15696 =back
15697
15698 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15699 class
15700
15701 =over 4
15702
15703 =item SYNOPSIS
15704
15705 =item DESCRIPTION
15706
15707 =item METHODS
15708
15709 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15710 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15711 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15712 , VALUE ), stat
15713
15714 =item SEE ALSO
15715
15716 =item AUTHOR
15717
15718 =item COPYRIGHT
15719
15720 =back
15721
15722 =head2 List::Util - A selection of general-utility list subroutines
15723
15724 =over 4
15725
15726 =item SYNOPSIS
15727
15728 =item DESCRIPTION
15729
15730 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15731 BLOCK LIST, shuffle LIST, sum LIST
15732
15733 =item KNOWN BUGS
15734
15735 =item SUGGESTED ADDITIONS
15736
15737 =item COPYRIGHT
15738
15739 =back
15740
15741 =head2 List::Utilib::List::Util, List::Util - A selection of
15742 general-utility list subroutines
15743
15744 =over 4
15745
15746 =item SYNOPSIS
15747
15748 =item DESCRIPTION
15749
15750 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15751 BLOCK LIST, shuffle LIST, sum LIST
15752
15753 =item KNOWN BUGS
15754
15755 =item SUGGESTED ADDITIONS
15756
15757 =item COPYRIGHT
15758
15759 =back
15760
15761 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
15762 general-utility scalar subroutines
15763
15764 =over 4
15765
15766 =item SYNOPSIS
15767
15768 =item DESCRIPTION
15769
15770 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
15771 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
15772 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
15773
15774 =item KNOWN BUGS
15775
15776 =item COPYRIGHT
15777
15778 =item BLATANT PLUG
15779
15780 =back
15781
15782 =head2 Locale::Constants - constants for Locale codes
15783
15784 =over 4
15785
15786 =item SYNOPSIS
15787
15788 =item DESCRIPTION
15789
15790 =item KNOWN BUGS AND LIMITATIONS
15791
15792 =item SEE ALSO
15793
15794 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
15795
15796 =item AUTHOR
15797
15798 =item COPYRIGHT
15799
15800 =back
15801
15802 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
15803
15804 =over 4
15805
15806 =item SYNOPSIS
15807
15808 =item DESCRIPTION
15809
15810 B<alpha-2>, B<alpha-3>, B<numeric>
15811
15812 =item CONVERSION ROUTINES
15813
15814 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
15815 country_code2code( CODE, CODESET, CODESET )
15816
15817 =item QUERY ROUTINES
15818
15819 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
15820
15821 =item SEMI-PRIVATE ROUTINES
15822
15823 =over 4
15824
15825 =item alias_code
15826
15827 =item rename_country
15828
15829 =back
15830
15831 =item EXAMPLES
15832
15833 =item DOMAIN NAMES
15834
15835 =item KNOWN BUGS AND LIMITATIONS
15836
15837 =item SEE ALSO
15838
15839 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
15840 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
15841 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
15842 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
15843
15844 =item AUTHOR
15845
15846 =item COPYRIGHT
15847
15848 =back
15849
15850 =head2 Locale::Currency - ISO three letter codes for currency
15851 identification (ISO 4217)
15852
15853 =over 4
15854
15855 =item SYNOPSIS
15856
15857 =item DESCRIPTION
15858
15859 XTS, XXX
15860
15861 =item CONVERSION ROUTINES
15862
15863 code2currency(), currency2code()
15864
15865 =item QUERY ROUTINES
15866
15867 C<all_currency_codes()>, C<all_currency_names()>
15868
15869 =item EXAMPLES
15870
15871 =item KNOWN BUGS AND LIMITATIONS
15872
15873 =item SEE ALSO
15874
15875 Locale::Country, Locale::Script, ISO 4217:1995,
15876 http://www.bsi-global.com/iso4217currency
15877
15878 =item AUTHOR
15879
15880 =item COPYRIGHT
15881
15882 =back
15883
15884 =head2 Locale::Language - ISO two letter codes for language identification
15885 (ISO 639)
15886
15887 =over 4
15888
15889 =item SYNOPSIS
15890
15891 =item DESCRIPTION
15892
15893 =item CONVERSION ROUTINES
15894
15895 code2language(), language2code()
15896
15897 =item QUERY ROUTINES
15898
15899 C<all_language_codes()>, C<all_language_names()>
15900
15901 =item EXAMPLES
15902
15903 =item KNOWN BUGS AND LIMITATIONS
15904
15905 =item SEE ALSO
15906
15907 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15908 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15909
15910 =item AUTHOR
15911
15912 =item COPYRIGHT
15913
15914 =back
15915
15916 =head2 Locale::Maketext - framework for localization
15917
15918 =over 4
15919
15920 =item SYNOPSIS
15921
15922 =item DESCRIPTION
15923
15924 =item QUICK OVERVIEW
15925
15926 =item METHODS
15927
15928 =over 4
15929
15930 =item Construction Methods
15931
15932 =item The "maketext" Method
15933
15934 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15935
15936 =item Utility Methods
15937
15938 $language->quant($number, $singular), $language->quant($number, $singular,
15939 $plural), $language->quant($number, $singular, $plural, $negative),
15940 $language->numf($number), $language->sprintf($format, @items),
15941 $language->language_tag(), $language->encoding()
15942
15943 =item Language Handle Attributes and Internals
15944
15945 =back
15946
15947 =item LANGUAGE CLASS HIERARCHIES
15948
15949 =item ENTRIES IN EACH LEXICON
15950
15951 =item BRACKET NOTATION
15952
15953 =item AUTO LEXICONS
15954
15955 =item CONTROLLING LOOKUP FAILURE
15956
15957 =item HOW TO USE MAKETEXT
15958
15959 =item SEE ALSO
15960
15961 =item COPYRIGHT AND DISCLAIMER
15962
15963 =item AUTHOR
15964
15965 =back
15966
15967 =head2 Locale::Maketext::TPJ13 -- article about software localization
15968
15969 =over 4
15970
15971 =item SYNOPSIS
15972
15973 =item DESCRIPTION
15974
15975 =item Localization and Perl: gettext breaks, Maketext fixes
15976
15977 =over 4
15978
15979 =item A Localization Horror Story: It Could Happen To You
15980
15981 =item The Linguistic View
15982
15983 =item Breaking gettext
15984
15985 =item Replacing gettext
15986
15987 =item Buzzwords: Abstraction and Encapsulation
15988
15989 =item Buzzword: Isomorphism
15990
15991 =item Buzzword: Inheritance
15992
15993 =item Buzzword: Concision
15994
15995 =item The Devil in the Details
15996
15997 =item The Proof in the Pudding: Localizing Web Sites
15998
15999 =item References
16000
16001 =back
16002
16003 =back
16004
16005 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16006
16007 =over 4
16008
16009 =item SYNOPSIS
16010
16011 =item DESCRIPTION
16012
16013 B<alpha-2>, B<alpha-3>, B<numeric>
16014
16015 =over 4
16016
16017 =item SPECIAL CODES
16018
16019 =back
16020
16021 =item CONVERSION ROUTINES
16022
16023 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16024 script_code2code( CODE, CODESET, CODESET )
16025
16026 =item QUERY ROUTINES
16027
16028 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16029
16030 =item EXAMPLES
16031
16032 =item KNOWN BUGS AND LIMITATIONS
16033
16034 =item SEE ALSO
16035
16036 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16037 http://www.evertype.com/standards/iso15924/
16038
16039 =item AUTHOR
16040
16041 =item COPYRIGHT
16042
16043 =back
16044
16045 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16046
16047 =over 4
16048
16049 =item SYNOPSIS
16050
16051 =item DESCRIPTION
16052
16053 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16054
16055 =item DIAGNOSTICS
16056
16057 Premature end of base64 data, Premature padding of base64 data
16058
16059 =item EXAMPLES
16060
16061 =item COPYRIGHT
16062
16063 =back
16064
16065 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16066 of quoted-printable strings
16067
16068 =over 4
16069
16070 =item SYNOPSIS
16071
16072 =item DESCRIPTION
16073
16074 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16075
16076 =item COPYRIGHT
16077
16078 =back
16079
16080 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16081 strings
16082
16083 =over 4
16084
16085 =item SYNOPSIS
16086
16087 =item DESCRIPTION
16088
16089 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16090
16091 =item COPYRIGHT
16092
16093 =back
16094
16095 =head2 Math::BigFloat - Arbitrary size floating point math package
16096
16097 =over 4
16098
16099 =item SYNOPSIS
16100
16101 =item DESCRIPTION
16102
16103 =over 4
16104
16105 =item Canonical notation
16106
16107 =item Output
16108
16109 =item C<mantissa()>, C<exponent()> and C<parts()>
16110
16111 =item Accuracy vs. Precision
16112
16113 =item Rounding
16114
16115 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16116 ), fround  ( -$scale ) and fround ( 0 )
16117
16118 =back
16119
16120 =item EXAMPLES
16121
16122   # not ready yet
16123
16124 =item Autocreating constants
16125
16126 =over 4
16127
16128 =item Math library
16129
16130 =item Using Math::BigInt::Lite
16131
16132 =back
16133
16134 =item BUGS
16135
16136 =item CAVEATS
16137
16138 stringify, bstr(), bdiv, Modifying and =, bpow
16139
16140 =item SEE ALSO
16141
16142 =item LICENSE
16143
16144 =item AUTHORS
16145
16146 =back
16147
16148 =head2 Math::BigInt - Arbitrary size integer math package
16149
16150 =over 4
16151
16152 =item SYNOPSIS
16153
16154 =item DESCRIPTION
16155
16156 Canonical notation, Input, Output
16157
16158 =item METHODS
16159
16160 =over 4
16161
16162 =item config
16163
16164 =item accuracy
16165
16166 =item precision
16167
16168 =item brsft
16169
16170 =item new
16171
16172 =item bnan
16173
16174 =item bzero
16175
16176 =item binf
16177
16178 =item bone
16179
16180 =item is_one()/is_zero()/is_nan()/is_inf()
16181
16182 =item is_positive()/is_negative()
16183
16184         $x->is_positive();              # true if >= 0
16185         $x->is_negative();              # true if <  0
16186
16187 =item is_odd()/is_even()/is_int()
16188
16189 =item bcmp
16190
16191 =item bacmp
16192
16193 =item sign
16194
16195 =item bcmp
16196
16197 =item bneg
16198
16199 =item babs
16200
16201 =item bnorm
16202
16203 =item bnot
16204
16205 =item binc
16206
16207 =item bdec
16208
16209 =item badd
16210
16211 =item bsub
16212
16213 =item bmul
16214
16215 =item bdiv
16216
16217 =item bmod
16218
16219 =item bmodinv
16220
16221 =item bmodpow
16222
16223 =item bpow
16224
16225 =item blsft
16226
16227 =item brsft
16228
16229 =item band
16230
16231 =item bior
16232
16233 =item bxor
16234
16235 =item bnot
16236
16237 =item bsqrt
16238
16239 =item bfac
16240
16241 =item round
16242
16243 =item bround
16244
16245 =item bfround
16246
16247 =item bfloor
16248
16249 =item bceil
16250
16251 =item bgcd
16252
16253 =item blcm
16254
16255 =item exponent
16256
16257 =item mantissa
16258
16259 =item parts
16260
16261 =item copy
16262
16263 =item as_number
16264
16265 =item bsstr
16266
16267 =item as_hex
16268
16269 =item as_bin
16270
16271 =back
16272
16273 =item ACCURACY and PRECISION
16274
16275 =over 4
16276
16277 =item Precision P
16278
16279 =item Accuracy A
16280
16281 =item Fallback F
16282
16283 =item Rounding mode R
16284
16285 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16286 (significant digits), Setting/Accessing, Creating numbers, Usage,
16287 Precedence, Overriding globals, Local settings, Rounding, Default values,
16288 Remarks
16289
16290 =back
16291
16292 =item INTERNALS
16293
16294 =over 4
16295
16296 =item MATH LIBRARY
16297
16298 =item SIGN
16299
16300 =item mantissa(), exponent() and parts()
16301
16302 =back
16303
16304 =item EXAMPLES
16305
16306   use Math::BigInt;
16307
16308 =item Autocreating constants
16309
16310 =item PERFORMANCE
16311
16312 =over 4
16313
16314 =item Alternative math libraries
16315
16316 =item SUBCLASSING
16317
16318 =back
16319
16320 =item Subclassing Math::BigInt
16321
16322 =item UPGRADING
16323
16324 =over 4
16325
16326 =item Auto-upgrade
16327
16328 bsqrt(), div(), blog()
16329
16330 =back
16331
16332 =item BUGS
16333
16334 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16335 5.6.0
16336
16337 =item CAVEATS
16338
16339 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16340 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16341 types, bsqrt(), brsft()
16342
16343 =item LICENSE
16344
16345 =item SEE ALSO
16346
16347 =item AUTHORS
16348
16349 =back
16350
16351 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16352
16353 =over 4
16354
16355 =item SYNOPSIS
16356
16357 =item DESCRIPTION
16358
16359 =item STORAGE
16360
16361 =item METHODS
16362
16363 =item WRAP YOUR OWN
16364
16365 =item LICENSE
16366
16367 This program is free software; you may redistribute it and/or modify it
16368 under
16369 the same terms as Perl itself.
16370
16371 =item AUTHORS
16372
16373 =item SEE ALSO
16374
16375 =back
16376
16377 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16378 scalars
16379
16380 =over 4
16381
16382 =item SYNOPSIS
16383
16384 =item DESCRIPTION
16385
16386 =item LICENSE
16387
16388 This program is free software; you may redistribute it and/or modify it
16389 under
16390 the same terms as Perl itself.
16391
16392 =item AUTHOR
16393
16394 =item SEE ALSO
16395
16396 =back
16397
16398 =head2 Math::BigRat - arbitrarily big rationales
16399
16400 =over 4
16401
16402 =item SYNOPSIS
16403
16404 =item DESCRIPTION
16405
16406 =over 4
16407
16408 =item MATH LIBRARY
16409
16410 =back
16411
16412 =item METHODS
16413
16414 =over 4
16415
16416 =item new()
16417
16418 =item numerator()
16419
16420 =item denominator()
16421
16422         $d = $x->denominator();
16423
16424 =item parts()
16425
16426 =item as_number()
16427
16428 =item bfac()
16429
16430 =item blog()
16431
16432 =item bround()/round()/bfround()
16433
16434 =item bmod()
16435
16436 =item is_one()
16437
16438 =item is_zero()
16439
16440 =item is_positive()
16441
16442 =item is_negative()
16443
16444 =item is_int()
16445
16446 =item is_odd()
16447
16448 =item is_even()
16449
16450 =item bceil()
16451
16452 =item bfloor()
16453
16454         $x->bfloor();
16455
16456 =item config
16457
16458 =back
16459
16460 =item BUGS
16461
16462 inf handling (partial), NaN handling (partial), rounding (not implemented
16463 except for bceil/bfloor), $x ** $y where $y is not an integer
16464
16465 =item LICENSE
16466
16467 =item SEE ALSO
16468
16469 =item AUTHORS
16470
16471 =back
16472
16473 =head2 Math::Complex - complex numbers and associated mathematical
16474 functions
16475
16476 =over 4
16477
16478 =item SYNOPSIS
16479
16480 =item DESCRIPTION
16481
16482 =item OPERATIONS
16483
16484 =item CREATION
16485
16486 =item STRINGIFICATION
16487
16488 =over 4
16489
16490 =item CHANGED IN PERL 5.6
16491
16492 =back
16493
16494 =item USAGE
16495
16496 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16497
16498 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16499
16500 =item BUGS
16501
16502 =item AUTHORS
16503
16504 =back
16505
16506 =head2 Math::Trig - trigonometric functions
16507
16508 =over 4
16509
16510 =item SYNOPSIS
16511
16512 =item DESCRIPTION
16513
16514 =item TRIGONOMETRIC FUNCTIONS
16515
16516 B<tan>
16517
16518 =over 4
16519
16520 =item ERRORS DUE TO DIVISION BY ZERO
16521
16522 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16523
16524 =back
16525
16526 =item PLANE ANGLE CONVERSIONS
16527
16528 =item RADIAL COORDINATE CONVERSIONS
16529
16530 =over 4
16531
16532 =item COORDINATE SYSTEMS
16533
16534 =item 3-D ANGLE CONVERSIONS
16535
16536 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16537 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16538
16539 =back
16540
16541 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16542
16543 =item EXAMPLES
16544
16545 =over 4
16546
16547 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16548
16549 =back
16550
16551 =item BUGS
16552
16553 =item AUTHORS
16554
16555 =back
16556
16557 =head2 Memoize - Make functions faster by trading space for time
16558
16559 =over 4
16560
16561 =item SYNOPSIS
16562
16563 =item DESCRIPTION
16564
16565 =item DETAILS
16566
16567 =item OPTIONS
16568
16569 =over 4
16570
16571 =item INSTALL
16572
16573 =item NORMALIZER
16574
16575 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16576
16577 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16578
16579 =back
16580
16581 =item OTHER FACILITIES
16582
16583 =over 4
16584
16585 =item C<unmemoize>
16586
16587 =item C<flush_cache>
16588
16589 =back
16590
16591 =item CAVEATS
16592
16593 =item PERSISTENT CACHE SUPPORT
16594
16595 =item EXPIRATION SUPPORT
16596
16597 =item BUGS
16598
16599 =item MAILING LIST
16600
16601 =item AUTHOR
16602
16603 =item COPYRIGHT AND LICENSE
16604
16605 =item THANK YOU
16606
16607 =back
16608
16609 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16610 Storable use
16611
16612 =over 4
16613
16614 =item DESCRIPTION
16615
16616 =back
16617
16618 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16619 memoized values
16620
16621 =over 4
16622
16623 =item SYNOPSIS
16624
16625 =item DESCRIPTION
16626
16627 =item INTERFACE
16628
16629  TIEHASH,  EXISTS,  STORE
16630
16631 =item ALTERNATIVES
16632
16633 =item CAVEATS
16634
16635 =item AUTHOR
16636
16637 =item SEE ALSO
16638
16639 =back
16640
16641 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16642
16643 =over 4
16644
16645 =item DESCRIPTION
16646
16647 =back
16648
16649 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16650
16651 =over 4
16652
16653 =item DESCRIPTION
16654
16655 =back
16656
16657 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16658 Storable use
16659
16660 =over 4
16661
16662 =item DESCRIPTION
16663
16664 =back
16665
16666 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16667 Storable use
16668
16669 =over 4
16670
16671 =item DESCRIPTION
16672
16673 =back
16674
16675 =head2 Memoize::Storable - store Memoized data in Storable database
16676
16677 =over 4
16678
16679 =item DESCRIPTION
16680
16681 =back
16682
16683 =head2 NDBM_File - Tied access to ndbm files
16684
16685 =over 4
16686
16687 =item SYNOPSIS
16688
16689 =item DESCRIPTION
16690
16691 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16692
16693 =item DIAGNOSTICS
16694
16695 =over 4
16696
16697 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16698
16699 =back
16700
16701 =item BUGS AND WARNINGS
16702
16703 =back
16704
16705 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
16706
16707 =over 4
16708
16709 =item SYNOPSIS
16710
16711 =item DESCRIPTION
16712
16713 =over 4
16714
16715 =item Enforcing redispatch
16716
16717 =item Avoiding repetitions
16718
16719 =back
16720
16721 =item AUTHOR
16722
16723 =item BUGS AND IRRITATIONS
16724
16725 =item COPYRIGHT
16726
16727 =back
16728
16729 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
16730
16731 =over 4
16732
16733 =item SYNOPSIS
16734
16735 =item DESCRIPTION
16736
16737 =item USER METHODS
16738
16739 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
16740 dataend ()
16741
16742 =item CLASS METHODS
16743
16744 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
16745 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
16746 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
16747
16748 =item EXPORTS
16749
16750 =item AUTHOR
16751
16752 =item COPYRIGHT
16753
16754 =back
16755
16756 =head2 Net::Config - Local configuration data for libnet
16757
16758 =over 4
16759
16760 =item SYNOPSYS
16761
16762 =item DESCRIPTION
16763
16764 =item METHODS
16765
16766 requires_firewall HOST
16767
16768 =item NetConfig VALUES
16769
16770 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
16771 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
16772 ftp_int_pasive, local_netmask, test_hosts, test_exists
16773
16774 =back
16775
16776 =head2 Net::Domain - Attempt to evaluate the current host's internet name
16777 and domain
16778
16779 =over 4
16780
16781 =item SYNOPSIS
16782
16783 =item DESCRIPTION
16784
16785 hostfqdn (), hostname (), hostdomain ()
16786
16787 =item AUTHOR
16788
16789 =item COPYRIGHT
16790
16791 =back
16792
16793 =head2 Net::FTP - FTP Client class
16794
16795 =over 4
16796
16797 =item SYNOPSIS
16798
16799 =item DESCRIPTION
16800
16801 =item OVERVIEW
16802
16803 =item CONSTRUCTOR
16804
16805 new (HOST [,OPTIONS])
16806
16807 =item METHODS
16808
16809 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
16810 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
16811 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
16812 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
16813 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ),
16814 dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put (
16815 LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ),
16816 append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size
16817 ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
16818 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
16819 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
16820 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
16821 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
16822 abort (), quit ()
16823
16824 =over 4
16825
16826 =item Methods for the adventurous
16827
16828 quot (CMD [,ARGS])
16829
16830 =back
16831
16832 =item THE dataconn CLASS
16833
16834 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
16835 bytes_read (), abort (), close ()
16836
16837 =item UNIMPLEMENTED
16838
16839 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
16840
16841 =item REPORTING BUGS
16842
16843 =item AUTHOR
16844
16845 =item SEE ALSO
16846
16847 =item USE EXAMPLES
16848
16849 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
16850
16851 =item CREDITS
16852
16853 =item COPYRIGHT
16854
16855 =back
16856
16857 =head2 Net::NNTP - NNTP Client class
16858
16859 =over 4
16860
16861 =item SYNOPSIS
16862
16863 =item DESCRIPTION
16864
16865 =item CONSTRUCTOR
16866
16867 new ( [ HOST ] [, OPTIONS ])
16868
16869 =item METHODS
16870
16871 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
16872 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
16873 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
16874 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
16875 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
16876 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
16877 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
16878
16879 =over 4
16880
16881 =item Extension methods
16882
16883 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
16884 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
16885 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
16886 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
16887 GROUP ] ), reader
16888
16889 =back
16890
16891 =item UNSUPPORTED
16892
16893 =item DEFINITIONS
16894
16895 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
16896
16897 =item SEE ALSO
16898
16899 =item AUTHOR
16900
16901 =item COPYRIGHT
16902
16903 =back
16904
16905 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
16906
16907 =over 4
16908
16909 =item SYNOPSIS
16910
16911 =item DESCRIPTION
16912
16913 =item CONSTRUCTOR
16914
16915 new ( [ HOST, ] [ OPTIONS ] )
16916
16917 =item METHODS
16918
16919 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16920 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16921 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16922 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16923
16924 =item NOTES
16925
16926 =item SEE ALSO
16927
16928 =item AUTHOR
16929
16930 =item COPYRIGHT
16931
16932 =back
16933
16934 =head2 Net::Ping - check a remote host for reachability
16935
16936 =over 4
16937
16938 =item SYNOPSIS
16939
16940 =item DESCRIPTION
16941
16942 =over 4
16943
16944 =item Functions
16945
16946 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
16947 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
16948 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
16949 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
16950 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
16951 [, $timeout]);
16952
16953 =back
16954
16955 =item NOTES
16956
16957 =item INSTALL
16958
16959 =item BUGS
16960
16961 =item AUTHORS
16962
16963 =item COPYRIGHT
16964
16965 =back
16966
16967 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16968
16969 =over 4
16970
16971 =item SYNOPSIS
16972
16973 =item DESCRIPTION
16974
16975 =item EXAMPLES
16976
16977 =item CONSTRUCTOR
16978
16979 new Net::SMTP [ HOST, ] [ OPTIONS ]
16980
16981 =item METHODS
16982
16983 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16984 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16985 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16986 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16987 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16988 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16989 quit ()
16990
16991 =item ADDRESSES
16992
16993 =item SEE ALSO
16994
16995 =item AUTHOR
16996
16997 =item COPYRIGHT
16998
16999 =back
17000
17001 =head2 Net::Time - time and daytime network client interface
17002
17003 =over 4
17004
17005 =item SYNOPSIS
17006
17007 =item DESCRIPTION
17008
17009 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17010 PROTOCOL [, TIMEOUT]]])
17011
17012 =item AUTHOR
17013
17014 =item COPYRIGHT
17015
17016 =back
17017
17018 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17019 functions
17020
17021 =over 4
17022
17023 =item SYNOPSIS
17024
17025 =item DESCRIPTION
17026
17027 =item EXAMPLES
17028
17029 =item NOTE
17030
17031 =item AUTHOR
17032
17033 =back
17034
17035 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17036
17037 =over 4
17038
17039 =item DESCRIPTION
17040
17041 =over 4
17042
17043 =item Where to get this document
17044
17045 =item How to contribute to this document
17046
17047 =back
17048
17049 =item Author and Copyright Information
17050
17051 =over 4
17052
17053 =item Disclaimer
17054
17055 =back
17056
17057 =item Obtaining and installing libnet
17058
17059 =over 4
17060
17061 =item What is libnet ?
17062
17063 =item Which version of perl do I need ?
17064
17065 =item What other modules do I need ?
17066
17067 =item What machines support libnet ?
17068
17069 =item Where can I get the latest libnet release
17070
17071 =back
17072
17073 =item Using Net::FTP
17074
17075 =over 4
17076
17077 =item How do I download files from an FTP server ?
17078
17079 =item How do I transfer files in binary mode ?
17080
17081 =item How can I get the size of a file on a remote FTP server ?
17082
17083 =item How can I get the modification time of a file on a remote FTP server
17084 ?
17085
17086 =item How can I change the permissions of a file on a remote server ?
17087
17088 =item Can I do a reget operation like the ftp command ?
17089
17090 =item How do I get a directory listing from an FTP server ?
17091
17092 =item Changing directory to "" does not fail ?
17093
17094 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17095
17096 =item I am behind an FTP proxy firewall, but cannot access machines outside
17097 ?
17098
17099 =item My ftp proxy firewall does not listen on port 21
17100
17101 =item Is it possible to change the file permissions of a file on an FTP
17102 server ?
17103
17104 =item I have seen scripts call a method message, but cannot find it
17105 documented ?
17106
17107 =item Why does Net::FTP not implement mput and mget methods
17108
17109 =back
17110
17111 =item Using Net::SMTP
17112
17113 =over 4
17114
17115 =item Why can't the part of an Email address after the @ be used as the
17116 hostname ?
17117
17118 =item Why does Net::SMTP not do DNS MX lookups ?
17119
17120 =item The verify method always returns true ?
17121
17122 =back
17123
17124 =item Debugging scripts
17125
17126 =over 4
17127
17128 =item How can I debug my scripts that use Net::* modules ?
17129
17130 =back
17131
17132 =item AUTHOR AND COPYRIGHT
17133
17134 =back
17135
17136 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17137 functions
17138
17139 =over 4
17140
17141 =item SYNOPSIS
17142
17143 =item DESCRIPTION
17144
17145 =item EXAMPLES
17146
17147 =item NOTE
17148
17149 =item AUTHOR
17150
17151 =back
17152
17153 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17154 functions
17155
17156 =over 4
17157
17158 =item SYNOPSIS
17159
17160 =item DESCRIPTION
17161
17162 =item NOTE
17163
17164 =item AUTHOR
17165
17166 =back
17167
17168 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17169 functions
17170
17171 =over 4
17172
17173 =item SYNOPSIS
17174
17175 =item DESCRIPTION
17176
17177 =item EXAMPLES
17178
17179 =item NOTE
17180
17181 =item AUTHOR
17182
17183 =back
17184
17185 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17186
17187 =over 4
17188
17189 =item SYNOPSIS
17190
17191 =item DESCRIPTION
17192
17193 =item THE .netrc FILE
17194
17195 machine name, default, login name, password string, account string, macdef
17196 name
17197
17198 =item CONSTRUCTOR
17199
17200 lookup ( MACHINE [, LOGIN ])
17201
17202 =item METHODS
17203
17204 login (), password (), account (), lpa ()
17205
17206 =item AUTHOR
17207
17208 =item SEE ALSO
17209
17210 =item COPYRIGHT
17211
17212 =back
17213
17214 =head2 O - Generic interface to Perl Compiler backends
17215
17216 =over 4
17217
17218 =item SYNOPSIS
17219
17220 =item DESCRIPTION
17221
17222 =item CONVENTIONS
17223
17224 =item IMPLEMENTATION
17225
17226 =item BUGS
17227
17228 =item AUTHOR
17229
17230 =back
17231
17232 =head2 ODBM_File - Tied access to odbm files
17233
17234 =over 4
17235
17236 =item SYNOPSIS
17237
17238 =item DESCRIPTION
17239
17240 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17241
17242 =item DIAGNOSTICS
17243
17244 =over 4
17245
17246 =item C<odbm store returned -1, errno 22, key "..." at ...>
17247
17248 =back
17249
17250 =item BUGS AND WARNINGS
17251
17252 =back
17253
17254 =head2 Opcode - Disable named opcodes when compiling perl code
17255
17256 =over 4
17257
17258 =item SYNOPSIS
17259
17260 =item DESCRIPTION
17261
17262 =item NOTE
17263
17264 =item WARNING
17265
17266 =item Operator Names and Operator Lists
17267
17268 an operator name (opname), an operator tag name (optag), a negated opname
17269 or optag, an operator set (opset)
17270
17271 =item Opcode Functions
17272
17273 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17274 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17275 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17276 opdump (PAT)
17277
17278 =item Manipulating Opsets
17279
17280 =item TO DO (maybe)
17281
17282 =back
17283
17284 =over 4
17285
17286 =item Predefined Opcode Tags
17287
17288 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17289 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17290 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17291 :dangerous
17292
17293 =item SEE ALSO
17294
17295 =item AUTHORS
17296
17297 =back
17298
17299 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17300 compartments
17301
17302 =over 4
17303
17304 =item SYNOPSIS
17305
17306 =item DESCRIPTION
17307
17308 a new namespace, an operator mask
17309
17310 =item WARNING
17311
17312 =over 4
17313
17314 =item RECENT CHANGES
17315
17316 =item Methods in class Safe
17317
17318 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17319 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17320 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17321 root (NAMESPACE), mask (MASK)
17322
17323 =item Some Safety Issues
17324
17325 Memory, CPU, Snooping, Signals, State Changes
17326
17327 =item AUTHOR
17328
17329 =back
17330
17331 =back
17332
17333 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17334 compiling
17335
17336 =over 4
17337
17338 =item SYNOPSIS
17339
17340 =item DESCRIPTION
17341
17342 =item SEE ALSO
17343
17344 =back
17345
17346 =head2 POSIX - Perl interface to IEEE Std 1003.1
17347
17348 =over 4
17349
17350 =item SYNOPSIS
17351
17352 =item DESCRIPTION
17353
17354 =item NOTE
17355
17356 =item CAVEATS
17357
17358 =item FUNCTIONS
17359
17360 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17361 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17362 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17363 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17364 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17365 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17366 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17367 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17368 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17369 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17370 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17371 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17372 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17373 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17374 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17375 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17376 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17377 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17378 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17379 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17380 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17381 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17382 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17383 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17384 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17385 wctomb, write
17386
17387 =item CLASSES
17388
17389 =over 4
17390
17391 =item POSIX::SigAction
17392
17393 new, handler, mask, flags, safe
17394
17395 =item POSIX::SigSet
17396
17397 new, addset, delset, emptyset, fillset, ismember
17398
17399 =item POSIX::Termios
17400
17401 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17402 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17403 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17404 field values, c_cflag field values, c_iflag field values, c_lflag field
17405 values, c_oflag field values
17406
17407 =back
17408
17409 =item PATHNAME CONSTANTS
17410
17411 Constants
17412
17413 =item POSIX CONSTANTS
17414
17415 Constants
17416
17417 =item SYSTEM CONFIGURATION
17418
17419 Constants
17420
17421 =item ERRNO
17422
17423 Constants
17424
17425 =item FCNTL
17426
17427 Constants
17428
17429 =item FLOAT
17430
17431 Constants
17432
17433 =item LIMITS
17434
17435 Constants
17436
17437 =item LOCALE
17438
17439 Constants
17440
17441 =item MATH
17442
17443 Constants
17444
17445 =item SIGNAL
17446
17447 Constants
17448
17449 =item STAT
17450
17451 Constants, Macros
17452
17453 =item STDLIB
17454
17455 Constants
17456
17457 =item STDIO
17458
17459 Constants
17460
17461 =item TIME
17462
17463 Constants
17464
17465 =item UNISTD
17466
17467 Constants
17468
17469 =item WAIT
17470
17471 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17472 WTERMSIG, WIFSTOPPED, WSTOPSIG
17473
17474 =back
17475
17476 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17477 name space
17478
17479 =over 4
17480
17481 =item SYNOPSIS
17482
17483 =item DESCRIPTION
17484
17485 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
17486
17487 =over 4
17488
17489 =item Custom Layers
17490
17491 :encoding, :via
17492
17493 =item Alternatives to raw
17494
17495 =item Defaults and how to override them
17496
17497 =item Querying the layers of filehandle
17498
17499 =back
17500
17501 =item AUTHOR
17502
17503 =item SEE ALSO
17504
17505 =back
17506
17507 =head2 PerlIO::encoding - encoding layer
17508
17509 =over 4
17510
17511 =item SYNOPSIS
17512
17513 =item DESCRIPTION
17514
17515 =item SEE ALSO
17516
17517 =back
17518
17519 =head2 PerlIO::scalar - support module for in-memory IO.
17520
17521 =over 4
17522
17523 =item SYNOPSIS
17524
17525 =item DESCRIPTION
17526
17527 =back
17528
17529 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17530
17531 =over 4
17532
17533 =item SYNOPSIS
17534
17535 =item DESCRIPTION
17536
17537 =item EXPECTED METHODS
17538
17539 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17540 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
17541 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
17542 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
17543 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
17544 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
17545 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
17546 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
17547
17548 =item EXAMPLES
17549
17550 =over 4
17551
17552 =item Example - a Hexadecimal Handle
17553
17554 =back
17555
17556 =back
17557
17558 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17559
17560 =over 4
17561
17562 =item SYNOPSIS
17563
17564 =item DESCRIPTION
17565
17566 =item SEE ALSO
17567
17568 =item COPYRIGHT
17569
17570 =back
17571
17572 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17573
17574 =over 4
17575
17576 =item SYNOPSIS
17577
17578 =item OPTIONS/ARGUMENTS
17579
17580 =over 4
17581
17582 =item podchecker()
17583
17584 B<-warnings> =E<gt> I<val>
17585
17586 =back
17587
17588 =item DESCRIPTION
17589
17590 =item DIAGNOSTICS
17591
17592 =over 4
17593
17594 =item Errors
17595
17596 empty =headn, =over on line I<N> without closing =back, =item without
17597 previous =over, =back without previous =over, No argument for =begin, =end
17598 without =begin, Nested =begin's, =for without formatter specification,
17599 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17600 interior-sequence "I<SEQ>", nested commands
17601 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17602 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17603 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17604 after =back
17605
17606 =item Warnings
17607
17608 multiple occurrence of link target I<name>, line containing nothing but
17609 whitespace in paragraph, file does not start with =head, previous =item has
17610 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17611 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17612 items in =over, No argument for =item, empty section in previous paragraph,
17613 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17614 level
17615
17616 =item Hyperlinks
17617
17618 ignoring leading/trailing whitespace in link, (section) in '$page'
17619 deprecated, alternative text/node '%s' contains non-escaped | or /
17620
17621 =back
17622
17623 =item RETURN VALUE
17624
17625 =item EXAMPLES
17626
17627 =item INTERFACE
17628
17629 =back
17630
17631 C<Pod::Checker-E<gt>new( %options )>
17632
17633 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17634 @args )>
17635
17636 C<$checker-E<gt>num_errors()>
17637
17638 C<$checker-E<gt>num_warnings()>
17639
17640 C<$checker-E<gt>name()>
17641
17642 C<$checker-E<gt>node()>
17643
17644 C<$checker-E<gt>idx()>
17645
17646 C<$checker-E<gt>hyperlink()>
17647
17648 =over 4
17649
17650 =item AUTHOR
17651
17652 =back
17653
17654 =head2 Pod::Find - find POD documents in directory trees
17655
17656 =over 4
17657
17658 =item SYNOPSIS
17659
17660 =item DESCRIPTION
17661
17662 =back
17663
17664 =over 4
17665
17666 =item C<pod_find( { %opts } , @directories )>
17667
17668 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17669 1>
17670
17671 =back
17672
17673 =over 4
17674
17675 =item C<simplify_name( $str )>
17676
17677 =back
17678
17679 =over 4
17680
17681 =item C<pod_where( { %opts }, $pod )>
17682
17683 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17684 1>
17685
17686 =back
17687
17688 =over 4
17689
17690 =item C<contains_pod( $file , $verbose )>
17691
17692 =back
17693
17694 =over 4
17695
17696 =item AUTHOR
17697
17698 =item SEE ALSO
17699
17700 =back
17701
17702 =head2 Pod::Html - module to convert pod files to HTML
17703
17704 =over 4
17705
17706 =item SYNOPSIS
17707
17708 =item DESCRIPTION
17709
17710 =item ARGUMENTS
17711
17712 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
17713 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
17714 title, verbose
17715
17716 =item EXAMPLE
17717
17718 =item ENVIRONMENT
17719
17720 =item AUTHOR
17721
17722 =item SEE ALSO
17723
17724 =item COPYRIGHT
17725
17726 =back
17727
17728 =head2 Pod::InputObjects - objects representing POD input paragraphs,
17729 commands, etc.
17730
17731 =over 4
17732
17733 =item SYNOPSIS
17734
17735 =item REQUIRES
17736
17737 =item EXPORTS
17738
17739 =item DESCRIPTION
17740
17741 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
17742 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
17743
17744 =back
17745
17746 =over 4
17747
17748 =item B<Pod::InputSource>
17749
17750 =back
17751
17752 =over 4
17753
17754 =item B<new()>
17755
17756 =back
17757
17758 =over 4
17759
17760 =item B<name()>
17761
17762 =back
17763
17764 =over 4
17765
17766 =item B<handle()>
17767
17768 =back
17769
17770 =over 4
17771
17772 =item B<was_cutting()>
17773
17774 =back
17775
17776 =over 4
17777
17778 =item B<Pod::Paragraph>
17779
17780 =back
17781
17782 =over 4
17783
17784 =item Pod::Paragraph-E<gt>B<new()>
17785
17786 =back
17787
17788 =over 4
17789
17790 =item $pod_para-E<gt>B<cmd_name()>
17791
17792 =back
17793
17794 =over 4
17795
17796 =item $pod_para-E<gt>B<text()>
17797
17798 =back
17799
17800 =over 4
17801
17802 =item $pod_para-E<gt>B<raw_text()>
17803
17804 =back
17805
17806 =over 4
17807
17808 =item $pod_para-E<gt>B<cmd_prefix()>
17809
17810 =back
17811
17812 =over 4
17813
17814 =item $pod_para-E<gt>B<cmd_separator()>
17815
17816 =back
17817
17818 =over 4
17819
17820 =item $pod_para-E<gt>B<parse_tree()>
17821
17822 =back
17823
17824 =over 4
17825
17826 =item $pod_para-E<gt>B<file_line()>
17827
17828 =back
17829
17830 =over 4
17831
17832 =item B<Pod::InteriorSequence>
17833
17834 =back
17835
17836 =over 4
17837
17838 =item Pod::InteriorSequence-E<gt>B<new()>
17839
17840 =back
17841
17842 =over 4
17843
17844 =item $pod_seq-E<gt>B<cmd_name()>
17845
17846 =back
17847
17848 =over 4
17849
17850 =item $pod_seq-E<gt>B<prepend()>
17851
17852 =back
17853
17854 =over 4
17855
17856 =item $pod_seq-E<gt>B<append()>
17857
17858 =back
17859
17860 =over 4
17861
17862 =item $pod_seq-E<gt>B<nested()>
17863
17864 =back
17865
17866 =over 4
17867
17868 =item $pod_seq-E<gt>B<raw_text()>
17869
17870 =back
17871
17872 =over 4
17873
17874 =item $pod_seq-E<gt>B<left_delimiter()>
17875
17876 =back
17877
17878 =over 4
17879
17880 =item $pod_seq-E<gt>B<right_delimiter()>
17881
17882 =back
17883
17884 =over 4
17885
17886 =item $pod_seq-E<gt>B<parse_tree()>
17887
17888 =back
17889
17890 =over 4
17891
17892 =item $pod_seq-E<gt>B<file_line()>
17893
17894 =back
17895
17896 =over 4
17897
17898 =item Pod::InteriorSequence::B<DESTROY()>
17899
17900 =back
17901
17902 =over 4
17903
17904 =item B<Pod::ParseTree>
17905
17906 =back
17907
17908 =over 4
17909
17910 =item Pod::ParseTree-E<gt>B<new()>
17911
17912 =back
17913
17914 =over 4
17915
17916 =item $ptree-E<gt>B<top()>
17917
17918 =back
17919
17920 =over 4
17921
17922 =item $ptree-E<gt>B<children()>
17923
17924 =back
17925
17926 =over 4
17927
17928 =item $ptree-E<gt>B<prepend()>
17929
17930 =back
17931
17932 =over 4
17933
17934 =item $ptree-E<gt>B<append()>
17935
17936 =back
17937
17938 =over 4
17939
17940 =item $ptree-E<gt>B<raw_text()>
17941
17942 =back
17943
17944 =over 4
17945
17946 =item Pod::ParseTree::B<DESTROY()>
17947
17948 =back
17949
17950 =over 4
17951
17952 =item SEE ALSO
17953
17954 =item AUTHOR
17955
17956 =back
17957
17958 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17959
17960 =over 4
17961
17962 =item SYNOPSIS
17963
17964 =item DESCRIPTION
17965
17966 =back
17967
17968 =over 4
17969
17970 =item OBJECT METHODS
17971
17972 C<initialize>
17973
17974 =back
17975
17976 =over 4
17977
17978 =item Data Accessors
17979
17980 B<AddPreamble>
17981
17982 =back
17983
17984 B<AddPostamble>
17985
17986 B<Head1Level>
17987
17988 B<Label>
17989
17990 B<LevelNoNum>
17991
17992 B<MakeIndex>
17993
17994 B<ReplaceNAMEwithSection>
17995
17996 B<StartWithNewPage>
17997
17998 B<TableOfContents>
17999
18000 B<UniqueLabels>
18001
18002 B<UserPreamble>
18003
18004 B<UserPostamble>
18005
18006 B<Lists>
18007
18008 =over 4
18009
18010 =item Subclassed methods
18011
18012 =back
18013
18014 B<begin_pod>
18015
18016 B<end_pod>
18017
18018 B<command>
18019
18020 B<verbatim>
18021
18022 B<textblock>
18023
18024 B<interior_sequence>
18025
18026 =over 4
18027
18028 =item List Methods
18029
18030 B<begin_list>
18031
18032 =back
18033
18034 B<end_list>
18035
18036 B<add_item>
18037
18038 =over 4
18039
18040 =item Methods for headings
18041
18042 B<head>
18043
18044 =back
18045
18046 =over 4
18047
18048 =item Internal methods
18049
18050 B<_output>
18051
18052 =back
18053
18054 B<_replace_special_chars>
18055
18056 B<_replace_special_chars_late>
18057
18058 B<_create_label>
18059
18060 B<_create_index>
18061
18062 B<_clean_latex_commands>
18063
18064 B<_split_delimited>
18065
18066 =over 4
18067
18068 =item NOTES
18069
18070 =item SEE ALSO
18071
18072 =item AUTHORS
18073
18074 =item COPYRIGHT
18075
18076 =item REVISION
18077
18078 =back
18079
18080 =head2 Pod::Man - Convert POD data to formatted *roff input
18081
18082 =over 4
18083
18084 =item SYNOPSIS
18085
18086 =item DESCRIPTION
18087
18088 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18089 release, section
18090
18091 =item DIAGNOSTICS
18092
18093 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18094 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18095 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18096 =back
18097
18098 =item BUGS
18099
18100 =item CAVEATS
18101
18102 =item SEE ALSO
18103
18104 =item AUTHOR
18105
18106 =item COPYRIGHT AND LICENSE
18107
18108 =back
18109
18110 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18111
18112 =over 4
18113
18114 =item SYNOPSIS
18115
18116 =item DESCRIPTION
18117
18118 =item SEE ALSO
18119
18120 =item AUTHOR
18121
18122 =item COPYRIGHT AND LICENSE
18123
18124 =back
18125
18126 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18127
18128 =over 4
18129
18130 =item SYNOPSIS
18131
18132 =item DESCRIPTION
18133
18134 =back
18135
18136 =over 4
18137
18138 =item Pod::List
18139
18140 Pod::List-E<gt>new()
18141
18142 =back
18143
18144 $list-E<gt>file()
18145
18146 $list-E<gt>start()
18147
18148 $list-E<gt>indent()
18149
18150 $list-E<gt>type()
18151
18152 $list-E<gt>rx()
18153
18154 $list-E<gt>item()
18155
18156 $list-E<gt>parent()
18157
18158 $list-E<gt>tag()
18159
18160 =over 4
18161
18162 =item Pod::Hyperlink
18163
18164 Pod::Hyperlink-E<gt>new()
18165
18166 =back
18167
18168 $link-E<gt>parse($string)
18169
18170 $link-E<gt>markup($string)
18171
18172 $link-E<gt>text()
18173
18174 $link-E<gt>warning()
18175
18176 $link-E<gt>file(), $link-E<gt>line()
18177
18178 $link-E<gt>page()
18179
18180 $link-E<gt>node()
18181
18182 $link-E<gt>alttext()
18183
18184 $link-E<gt>type()
18185
18186 $link-E<gt>link()
18187
18188 =over 4
18189
18190 =item Pod::Cache
18191
18192 Pod::Cache-E<gt>new()
18193
18194 =back
18195
18196 $cache-E<gt>item()
18197
18198 $cache-E<gt>find_page($name)
18199
18200 =over 4
18201
18202 =item Pod::Cache::Item
18203
18204 Pod::Cache::Item-E<gt>new()
18205
18206 =back
18207
18208 $cacheitem-E<gt>page()
18209
18210 $cacheitem-E<gt>description()
18211
18212 $cacheitem-E<gt>path()
18213
18214 $cacheitem-E<gt>file()
18215
18216 $cacheitem-E<gt>nodes()
18217
18218 $cacheitem-E<gt>find_node($name)
18219
18220 $cacheitem-E<gt>idx()
18221
18222 =over 4
18223
18224 =item AUTHOR
18225
18226 =item SEE ALSO
18227
18228 =back
18229
18230 =head2 Pod::Parser - base class for creating POD filters and translators
18231
18232 =over 4
18233
18234 =item SYNOPSIS
18235
18236 =item REQUIRES
18237
18238 =item EXPORTS
18239
18240 =item DESCRIPTION
18241
18242 =item QUICK OVERVIEW
18243
18244 =item PARSING OPTIONS
18245
18246 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18247 B<-warnings> (default: unset)
18248
18249 =back
18250
18251 =over 4
18252
18253 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18254
18255 =back
18256
18257 =over 4
18258
18259 =item B<command()>
18260
18261 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18262
18263 =back
18264
18265 =over 4
18266
18267 =item B<verbatim()>
18268
18269 C<$text>, C<$line_num>, C<$pod_para>
18270
18271 =back
18272
18273 =over 4
18274
18275 =item B<textblock()>
18276
18277 C<$text>, C<$line_num>, C<$pod_para>
18278
18279 =back
18280
18281 =over 4
18282
18283 =item B<interior_sequence()>
18284
18285 =back
18286
18287 =over 4
18288
18289 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18290
18291 =back
18292
18293 =over 4
18294
18295 =item B<new()>
18296
18297 =back
18298
18299 =over 4
18300
18301 =item B<initialize()>
18302
18303 =back
18304
18305 =over 4
18306
18307 =item B<begin_pod()>
18308
18309 =back
18310
18311 =over 4
18312
18313 =item B<begin_input()>
18314
18315 =back
18316
18317 =over 4
18318
18319 =item B<end_input()>
18320
18321 =back
18322
18323 =over 4
18324
18325 =item B<end_pod()>
18326
18327 =back
18328
18329 =over 4
18330
18331 =item B<preprocess_line()>
18332
18333 =back
18334
18335 =over 4
18336
18337 =item B<preprocess_paragraph()>
18338
18339 =back
18340
18341 =over 4
18342
18343 =item METHODS FOR PARSING AND PROCESSING
18344
18345 =back
18346
18347 =over 4
18348
18349 =item B<parse_text()>
18350
18351 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18352 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18353 I<code-ref>|I<method-name>
18354
18355 =back
18356
18357 =over 4
18358
18359 =item B<interpolate()>
18360
18361 =back
18362
18363 =over 4
18364
18365 =item B<parse_paragraph()>
18366
18367 =back
18368
18369 =over 4
18370
18371 =item B<parse_from_filehandle()>
18372
18373 =back
18374
18375 =over 4
18376
18377 =item B<parse_from_file()>
18378
18379 =back
18380
18381 =over 4
18382
18383 =item ACCESSOR METHODS
18384
18385 =back
18386
18387 =over 4
18388
18389 =item B<errorsub()>
18390
18391 =back
18392
18393 =over 4
18394
18395 =item B<cutting()>
18396
18397 =back
18398
18399 =over 4
18400
18401 =item B<parseopts()>
18402
18403 =back
18404
18405 =over 4
18406
18407 =item B<output_file()>
18408
18409 =back
18410
18411 =over 4
18412
18413 =item B<output_handle()>
18414
18415 =back
18416
18417 =over 4
18418
18419 =item B<input_file()>
18420
18421 =back
18422
18423 =over 4
18424
18425 =item B<input_handle()>
18426
18427 =back
18428
18429 =over 4
18430
18431 =item B<input_streams()>
18432
18433 =back
18434
18435 =over 4
18436
18437 =item B<top_stream()>
18438
18439 =back
18440
18441 =over 4
18442
18443 =item PRIVATE METHODS AND DATA
18444
18445 =back
18446
18447 =over 4
18448
18449 =item B<_push_input_stream()>
18450
18451 =back
18452
18453 =over 4
18454
18455 =item B<_pop_input_stream()>
18456
18457 =back
18458
18459 =over 4
18460
18461 =item TREE-BASED PARSING
18462
18463 =item SEE ALSO
18464
18465 =item AUTHOR
18466
18467 =back
18468
18469 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18470
18471 =over 4
18472
18473 =item SYNOPSIS
18474
18475 =item DESCRIPTION
18476
18477 =item SEE ALSO
18478
18479 =item COPYRIGHT AND DISCLAIMERS
18480
18481 =item AUTHOR
18482
18483 =back
18484
18485 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18486
18487 =over 4
18488
18489 =item SYNOPSIS
18490
18491 =item DESCRIPTION
18492
18493 =item CAVEAT
18494
18495 =item SEE ALSO
18496
18497 =item COPYRIGHT AND DISCLAIMERS
18498
18499 =item AUTHOR
18500
18501 =back
18502
18503 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18504
18505 =over 4
18506
18507 =item SYNOPSIS
18508
18509 =item DESCRIPTION
18510
18511 =item CAVEAT
18512
18513 =item SEE ALSO
18514
18515 =item COPYRIGHT AND DISCLAIMERS
18516
18517 =item AUTHOR
18518
18519 =back
18520
18521 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18522
18523 =over 4
18524
18525 =item SYNOPSIS
18526
18527 =item DESCRIPTION
18528
18529 =item SEE ALSO
18530
18531 =item COPYRIGHT AND DISCLAIMERS
18532
18533 =item AUTHOR
18534
18535 =back
18536
18537 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18538
18539 =over 4
18540
18541 =item SYNOPSIS
18542
18543 =item DESCRIPTION
18544
18545 =item SEE ALSO
18546
18547 =item COPYRIGHT AND DISCLAIMERS
18548
18549 =item AUTHOR
18550
18551 =back
18552
18553 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18554
18555 =over 4
18556
18557 =item SYNOPSIS
18558
18559 =item DESCRIPTION
18560
18561 =item CAVEAT
18562
18563 =item SEE ALSO
18564
18565 =item COPYRIGHT AND DISCLAIMERS
18566
18567 =item AUTHOR
18568
18569 =back
18570
18571 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18572
18573 =over 4
18574
18575 =item SYNOPSIS
18576
18577 =item DESCRIPTION
18578
18579 =item SEE ALSO
18580
18581 =item AUTHOR
18582
18583 =back
18584
18585 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18586
18587 =over 4
18588
18589 =item SYNOPSIS
18590
18591 =item DESCRIPTION
18592
18593 =item SEE ALSO
18594
18595 =item COPYRIGHT AND DISCLAIMERS
18596
18597 =item AUTHOR
18598
18599 =back
18600
18601 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18602
18603 =over 4
18604
18605 =item SYNOPSIS
18606
18607 =item DESCRIPTION
18608
18609 alt, indent, loose, sentence, width
18610
18611 =item DIAGNOSTICS
18612
18613 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18614 Unknown sequence: %s, Unmatched =back
18615
18616 =item RESTRICTIONS
18617
18618 =item NOTES
18619
18620 =item SEE ALSO
18621
18622 =item AUTHOR
18623
18624 =back
18625
18626 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18627
18628 =over 4
18629
18630 =item SYNOPSIS
18631
18632 =item DESCRIPTION
18633
18634 =over 4
18635
18636 =item EXPORT
18637
18638 =back
18639
18640 =item AUTHOR
18641
18642 =item SEE ALSO
18643
18644 =back
18645
18646 =head2 Pod::Select, podselect() - extract selected sections of POD from
18647 input
18648
18649 =over 4
18650
18651 =item SYNOPSIS
18652
18653 =item REQUIRES
18654
18655 =item EXPORTS
18656
18657 =item DESCRIPTION
18658
18659 =item SECTION SPECIFICATIONS
18660
18661 =item RANGE SPECIFICATIONS
18662
18663 =back
18664
18665 =over 4
18666
18667 =item OBJECT METHODS
18668
18669 =back
18670
18671 =over 4
18672
18673 =item B<curr_headings()>
18674
18675 =back
18676
18677 =over 4
18678
18679 =item B<select()>
18680
18681 =back
18682
18683 =over 4
18684
18685 =item B<add_selection()>
18686
18687 =back
18688
18689 =over 4
18690
18691 =item B<clear_selections()>
18692
18693 =back
18694
18695 =over 4
18696
18697 =item B<match_section()>
18698
18699 =back
18700
18701 =over 4
18702
18703 =item B<is_selected()>
18704
18705 =back
18706
18707 =over 4
18708
18709 =item EXPORTED FUNCTIONS
18710
18711 =back
18712
18713 =over 4
18714
18715 =item B<podselect()>
18716
18717 B<-output>, B<-sections>, B<-ranges>
18718
18719 =back
18720
18721 =over 4
18722
18723 =item PRIVATE METHODS AND DATA
18724
18725 =back
18726
18727 =over 4
18728
18729 =item B<_compile_section_spec()>
18730
18731 =back
18732
18733 =over 4
18734
18735 =item $self->{_SECTION_HEADINGS}
18736
18737 =back
18738
18739 =over 4
18740
18741 =item $self->{_SELECTED_SECTIONS}
18742
18743 =back
18744
18745 =over 4
18746
18747 =item SEE ALSO
18748
18749 =item AUTHOR
18750
18751 =back
18752
18753 =head2 Pod::Text - Convert POD data to formatted ASCII text
18754
18755 =over 4
18756
18757 =item SYNOPSIS
18758
18759 =item DESCRIPTION
18760
18761 alt, code, indent, loose, margin, quotes, sentence, width
18762
18763 =item DIAGNOSTICS
18764
18765 Bizarre space in item, Item called without tag, Can't open %s for reading:
18766 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
18767 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
18768 Unmatched =back
18769
18770 =item RESTRICTIONS
18771
18772 =item NOTES
18773
18774 =item SEE ALSO
18775
18776 =item AUTHOR
18777
18778 =item COPYRIGHT AND LICENSE
18779
18780 =back
18781
18782 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
18783
18784 =over 4
18785
18786 =item SYNOPSIS
18787
18788 =item DESCRIPTION
18789
18790 =item BUGS
18791
18792 =item SEE ALSO
18793
18794 =item AUTHOR
18795
18796 =item COPYRIGHT AND LICENSE
18797
18798 =back
18799
18800 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
18801 text
18802
18803 =over 4
18804
18805 =item SYNOPSIS
18806
18807 =item DESCRIPTION
18808
18809 =item BUGS
18810
18811 =item SEE ALSO
18812
18813 =item AUTHOR
18814
18815 =item COPYRIGHT AND LICENSE
18816
18817 =back
18818
18819 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
18820 escapes
18821
18822 =over 4
18823
18824 =item SYNOPSIS
18825
18826 =item DESCRIPTION
18827
18828 =item NOTES
18829
18830 =item SEE ALSO
18831
18832 =item AUTHOR
18833
18834 =item COPYRIGHT AND LICENSE
18835
18836 =back
18837
18838 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
18839 documentation
18840
18841 =over 4
18842
18843 =item SYNOPSIS
18844
18845 =item ARGUMENTS
18846
18847 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
18848 C<-pathlist>
18849
18850 =item DESCRIPTION
18851
18852 =item EXAMPLES
18853
18854 =over 4
18855
18856 =item Recommended Use
18857
18858 =back
18859
18860 =item CAVEATS
18861
18862 =item AUTHOR
18863
18864 =item ACKNOWLEDGEMENTS
18865
18866 =back
18867
18868 =head2 SDBM_File - Tied access to sdbm files
18869
18870 =over 4
18871
18872 =item SYNOPSIS
18873
18874 =item DESCRIPTION
18875
18876 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18877
18878 =item DIAGNOSTICS
18879
18880 =over 4
18881
18882 =item C<sdbm store returned -1, errno 22, key "..." at ...>
18883
18884 =back
18885
18886 =item BUGS AND WARNINGS
18887
18888 =back
18889
18890 =head2 Safe - Compile and execute code in restricted compartments
18891
18892 =over 4
18893
18894 =item SYNOPSIS
18895
18896 =item DESCRIPTION
18897
18898 a new namespace, an operator mask
18899
18900 =item WARNING
18901
18902 =over 4
18903
18904 =item RECENT CHANGES
18905
18906 =item Methods in class Safe
18907
18908 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18909 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18910 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18911 root (NAMESPACE), mask (MASK)
18912
18913 =item Some Safety Issues
18914
18915 Memory, CPU, Snooping, Signals, State Changes
18916
18917 =item AUTHOR
18918
18919 =back
18920
18921 =back
18922
18923 =head2 Scalar::Util - A selection of general-utility scalar subroutines
18924
18925 =over 4
18926
18927 =item SYNOPSIS
18928
18929 =item DESCRIPTION
18930
18931 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
18932 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
18933 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
18934
18935 =item KNOWN BUGS
18936
18937 =item COPYRIGHT
18938
18939 =item BLATANT PLUG
18940
18941 =back
18942
18943 =head2 Search::Dict, look - search for key in dictionary file
18944
18945 =over 4
18946
18947 =item SYNOPSIS
18948
18949 =item DESCRIPTION
18950
18951 =back
18952
18953 =head2 SelectSaver - save and restore selected file handle
18954
18955 =over 4
18956
18957 =item SYNOPSIS
18958
18959 =item DESCRIPTION
18960
18961 =back
18962
18963 =head2 SelfLoader - load functions only on demand
18964
18965 =over 4
18966
18967 =item SYNOPSIS
18968
18969 =item DESCRIPTION
18970
18971 =over 4
18972
18973 =item The __DATA__ token
18974
18975 =item SelfLoader autoloading
18976
18977 =item Autoloading and package lexicals
18978
18979 =item SelfLoader and AutoLoader
18980
18981 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
18982
18983 =item Classes and inherited methods.
18984
18985 =back
18986
18987 =item Multiple packages and fully qualified subroutine names
18988
18989 =back
18990
18991 =head2 Shell - run shell commands transparently within perl
18992
18993 =over 4
18994
18995 =item SYNOPSIS
18996
18997 =item DESCRIPTION
18998
18999 =over 4
19000
19001 =item OBJECT ORIENTED SYNTAX
19002
19003 =back
19004
19005 =item AUTHOR
19006
19007 =back
19008
19009 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19010 socket.h defines and structure manipulators
19011
19012 =over 4
19013
19014 =item SYNOPSIS
19015
19016 =item DESCRIPTION
19017
19018 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19019 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19020 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19021 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19022 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19023
19024 =back
19025
19026 =head2 Storable - persistence for Perl data structures
19027
19028 =over 4
19029
19030 =item SYNOPSIS
19031
19032 =item DESCRIPTION
19033
19034 =item MEMORY STORE
19035
19036 =item ADVISORY LOCKING
19037
19038 =item SPEED
19039
19040 =item CANONICAL REPRESENTATION
19041
19042 =item CODE REFERENCES
19043
19044 =item FORWARD COMPATIBILITY
19045
19046 utf8 data, restricted hashes, files from future versions of Storable
19047
19048 =item ERROR REPORTING
19049
19050 =item WIZARDS ONLY
19051
19052 =over 4
19053
19054 =item Hooks
19055
19056 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19057 I<serialized>, ..
19058
19059 =item Predicates
19060
19061 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19062 C<Storable::is_retrieving>
19063
19064 =item Recursion
19065
19066 =item Deep Cloning
19067
19068 =back
19069
19070 =item Storable magic
19071
19072 =item EXAMPLES
19073
19074 =item WARNING
19075
19076 =item BUGS
19077
19078 =over 4
19079
19080 =item 64 bit data in perl 5.6.0 and 5.6.1
19081
19082 =back
19083
19084 =item CREDITS
19085
19086 =item AUTHOR
19087
19088 =item SEE ALSO
19089
19090 =back
19091
19092 =head2 Switch - A switch statement for Perl
19093
19094 =over 4
19095
19096 =item VERSION
19097
19098 =item SYNOPSIS
19099
19100 =item BACKGROUND
19101
19102 =item DESCRIPTION
19103
19104 =over 4
19105
19106 =item Allowing fall-through
19107
19108 =item Automating fall-through
19109
19110 =item Alternative syntax
19111
19112 =item Higher-order Operations
19113
19114 =back
19115
19116 =item DEPENDENCIES
19117
19118 =item AUTHOR
19119
19120 =item BUGS
19121
19122 =item LIMITATION
19123
19124 =item COPYRIGHT
19125
19126 =back
19127
19128 =head2 Symbol - manipulate Perl symbols and their names
19129
19130 =over 4
19131
19132 =item SYNOPSIS
19133
19134 =item DESCRIPTION
19135
19136 =back
19137
19138 =head2 Sys::Hostname - Try every conceivable way to get hostname
19139
19140 =over 4
19141
19142 =item SYNOPSIS
19143
19144 =item DESCRIPTION
19145
19146 =item AUTHOR
19147
19148 =back
19149
19150 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19151 interface to the UNIX syslog(3) calls
19152
19153 =over 4
19154
19155 =item SYNOPSIS
19156
19157 =item DESCRIPTION
19158
19159 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19160 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19161 in 5.004_02), closelog
19162
19163 =item EXAMPLES
19164
19165 =item SEE ALSO
19166
19167 =item AUTHOR
19168
19169 =back
19170
19171 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19172 Perl interface to the UNIX syslog(3) calls
19173
19174 =over 4
19175
19176 =item SYNOPSIS
19177
19178 =item DESCRIPTION
19179
19180 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19181 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19182 in 5.004_02), closelog
19183
19184 =item EXAMPLES
19185
19186 =item SEE ALSO
19187
19188 =item AUTHOR
19189
19190 =back
19191
19192 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19193
19194 =over 4
19195
19196 =item SYNOPSIS
19197
19198 =item DESCRIPTION
19199
19200 =item DIAGNOSTICS
19201
19202 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19203 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19204 comma allowed after filehandle, No name for escape sequence %s
19205
19206 =item ENVIRONMENT
19207
19208 ANSI_COLORS_DISABLED
19209
19210 =item RESTRICTIONS
19211
19212 =item NOTES
19213
19214 =item SEE ALSO
19215
19216 =item AUTHORS
19217
19218 =item COPYRIGHT AND LICENSE
19219
19220 =back
19221
19222 =head2 Term::Cap - Perl termcap interface
19223
19224 =over 4
19225
19226 =item SYNOPSIS
19227
19228 =item DESCRIPTION
19229
19230 =over 4
19231
19232 =item METHODS
19233
19234 =back
19235
19236 =back
19237
19238 B<Tgetent>, OSPEED, TERM
19239
19240 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19241
19242 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19243
19244 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19245
19246 B<Trequire>
19247
19248 =over 4
19249
19250 =item EXAMPLES
19251
19252 =item COPYRIGHT AND LICENSE
19253
19254 =item AUTHOR
19255
19256 =item SEE ALSO
19257
19258 =back
19259
19260 =head2 Term::Complete - Perl word completion module
19261
19262 =over 4
19263
19264 =item SYNOPSIS
19265
19266 =item DESCRIPTION
19267
19268 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19269
19270 =item DIAGNOSTICS
19271
19272 =item BUGS
19273
19274 =item AUTHOR
19275
19276 =back
19277
19278 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19279 If no real package is found, substitutes stubs instead of basic functions.
19280
19281 =over 4
19282
19283 =item SYNOPSIS
19284
19285 =item DESCRIPTION
19286
19287 =item Minimal set of supported functions
19288
19289 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19290 C<findConsole>, Attribs, C<Features>
19291
19292 =item Additional supported functions
19293
19294 C<tkRunning>, C<ornaments>, C<newTTY>
19295
19296 =item EXPORTS
19297
19298 =item ENVIRONMENT
19299
19300 =item CAVEATS
19301
19302 =back
19303
19304 =head2 Test - provides a simple framework for writing test scripts
19305
19306 =over 4
19307
19308 =item SYNOPSIS
19309
19310 =item DESCRIPTION
19311
19312 =item QUICK START GUIDE
19313
19314 =over 4
19315
19316 =item Functions
19317
19318 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19319 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19320
19321 =back
19322
19323 =back
19324
19325 B<_to_value>
19326
19327 C<ok(...)>
19328
19329 C<skip(I<skip_if_true>, I<args...>)>
19330
19331 =over 4
19332
19333 =item TEST TYPES
19334
19335 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19336
19337 =item ONFAIL
19338
19339 =item BUGS and CAVEATS
19340
19341 =item NOTE
19342
19343 =item SEE ALSO
19344
19345 =item AUTHOR
19346
19347 =back
19348
19349 =head2 Test::Builder - Backend for building test libraries
19350
19351 =over 4
19352
19353 =item SYNOPSIS
19354
19355 =item DESCRIPTION
19356
19357 =over 4
19358
19359 =item Construction
19360
19361 B<new>
19362
19363 =back
19364
19365 =back
19366
19367 =over 4
19368
19369 =item Setting up tests
19370
19371 B<exported_to>
19372
19373 =back
19374
19375 B<plan>
19376
19377 B<expected_tests>
19378
19379 B<no_plan>
19380
19381 B<has_plan>
19382
19383 B<skip_all>
19384
19385 =over 4
19386
19387 =item Running tests
19388
19389 B<ok>
19390
19391 =back
19392
19393 B<is_eq>, B<is_num>
19394
19395 B<isnt_eq>, B<isnt_num>
19396
19397 B<like>, B<unlike>
19398
19399 B<maybe_regex>
19400
19401 B<cmp_ok>
19402
19403 B<BAILOUT>
19404
19405 B<skip>
19406
19407 B<todo_skip>
19408
19409 B<skip_rest>
19410
19411 =over 4
19412
19413 =item Test style
19414
19415 B<level>
19416
19417 =back
19418
19419 B<use_numbers>
19420
19421 B<no_header>, B<no_ending>
19422
19423 =over 4
19424
19425 =item Output
19426
19427 B<diag>
19428
19429 =back
19430
19431 B<_print>
19432
19433 B<output>, B<failure_output>, B<todo_output>
19434
19435 =over 4
19436
19437 =item Test Status and Info
19438
19439 B<current_test>
19440
19441 =back
19442
19443 B<summary>
19444
19445 B<details>
19446
19447 B<todo>
19448
19449 B<caller>
19450
19451 B<_sanity_check>
19452
19453 B<_whoa>
19454
19455 B<_my_exit>
19456
19457 =over 4
19458
19459 =item THREADS
19460
19461 =item EXAMPLES
19462
19463 =item SEE ALSO
19464
19465 =item AUTHORS
19466
19467 =item COPYRIGHT
19468
19469 =back
19470
19471 =head2 Test::Harness - run perl standard test scripts with statistics
19472
19473 =over 4
19474
19475 =item SYNOPSIS
19476
19477 =item DESCRIPTION
19478
19479 =over 4
19480
19481 =item The test script output
19482
19483 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19484 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19485 else>
19486
19487 =item Taint mode
19488
19489 =item Configuration variables.
19490
19491 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19492
19493 =item Failure
19494
19495 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19496 Failed>
19497
19498 =item Functions
19499
19500 B<runtests>
19501
19502 =back
19503
19504 =back
19505
19506 B<_all_ok>
19507
19508 B<_globdir>
19509
19510 B<_run_all_tests>
19511
19512 B<_mk_leader>
19513
19514 B<_leader_width>
19515
19516 =over 4
19517
19518 =item EXPORT
19519
19520 =item DIAGNOSTICS
19521
19522 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19523 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19524 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19525 %s>, C<FAILED--Further testing stopped: %s>
19526
19527 =item ENVIRONMENT
19528
19529 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19530 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19531 C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19532
19533 =item EXAMPLE
19534
19535 =item SEE ALSO
19536
19537 =item AUTHORS
19538
19539 =item LICENSE
19540
19541 =item TODO
19542
19543 =item BUGS
19544
19545 =back
19546
19547 =head2 Test::Harness::Assert - simple assert
19548
19549 =over 4
19550
19551 =item SYNOPSIS
19552
19553 =item DESCRIPTION
19554
19555 =over 4
19556
19557 =item Functions
19558
19559 B<assert>
19560
19561 =back
19562
19563 =back
19564
19565 =over 4
19566
19567 =item AUTHOR
19568
19569 =item SEE ALSO
19570
19571 =back
19572
19573 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19574
19575 =over 4
19576
19577 =item SYNOPSIS
19578
19579 =item DESCRIPTION
19580
19581 =back
19582
19583 =head2 Test::Harness::Straps - detailed analysis of test results
19584
19585 =over 4
19586
19587 =item SYNOPSIS
19588
19589 =item DESCRIPTION
19590
19591 =over 4
19592
19593 =item Construction
19594
19595 B<new>
19596
19597 =back
19598
19599 =back
19600
19601 B<_init>
19602
19603 =over 4
19604
19605 =item Analysis
19606
19607 B<analyze>
19608
19609 =back
19610
19611 B<analyze_fh>
19612
19613 B<analyze_file>
19614
19615 B<_switches>
19616
19617 B<_INC2PERL5LIB>
19618
19619 B<_filtered_INC>
19620
19621 B<_restore_PERL5LIB>
19622
19623 =over 4
19624
19625 =item Parsing
19626
19627 B<_is_comment>
19628
19629 =back
19630
19631 B<_is_header>
19632
19633 B<_is_test>
19634
19635 B<_is_bail_out>
19636
19637 B<_reset_file_state>
19638
19639 =over 4
19640
19641 =item Results
19642
19643 B<_detailize>
19644
19645 =back
19646
19647 =over 4
19648
19649 =item EXAMPLES
19650
19651 =item AUTHOR
19652
19653 =item SEE ALSO
19654
19655 =back
19656
19657 =head2 Test::More - yet another framework for writing test scripts
19658
19659 =over 4
19660
19661 =item SYNOPSIS
19662
19663 =item DESCRIPTION
19664
19665 =over 4
19666
19667 =item I love it when a plan comes together
19668
19669 =back
19670
19671 =back
19672
19673 =over 4
19674
19675 =item Test names
19676
19677 =item I'm ok, you're not ok.
19678
19679 B<ok>
19680
19681 =back
19682
19683 B<is>, B<isnt>
19684
19685 B<like>
19686
19687 B<unlike>
19688
19689 B<cmp_ok>
19690
19691 B<can_ok>
19692
19693 B<isa_ok>
19694
19695 B<pass>, B<fail>
19696
19697 =over 4
19698
19699 =item Diagnostics
19700
19701 B<diag>
19702
19703 =back
19704
19705 =over 4
19706
19707 =item Module tests
19708
19709 B<use_ok>
19710
19711 =back
19712
19713 B<require_ok>
19714
19715 =over 4
19716
19717 =item Conditional tests
19718
19719 B<SKIP: BLOCK>
19720
19721 =back
19722
19723 B<TODO: BLOCK>, B<todo_skip>
19724
19725 When do I use SKIP vs. TODO?
19726
19727 =over 4
19728
19729 =item Comparison functions
19730
19731 B<is_deeply>
19732
19733 =back
19734
19735 B<eq_array>
19736
19737 B<eq_hash>
19738
19739 B<eq_set>
19740
19741 =over 4
19742
19743 =item Extending and Embedding Test::More
19744
19745 B<builder>
19746
19747 =back
19748
19749 =over 4
19750
19751 =item NOTES
19752
19753 =item BUGS and CAVEATS
19754
19755 Making your own ok(), The eq_* family has some caveats, Test::Harness
19756 upgrades
19757
19758 =item HISTORY
19759
19760 =item SEE ALSO
19761
19762 =item AUTHORS
19763
19764 =item COPYRIGHT
19765
19766 =back
19767
19768 =head2 Test::Simple - Basic utilities for writing tests.
19769
19770 =over 4
19771
19772 =item SYNOPSIS
19773
19774 =item DESCRIPTION
19775
19776 B<ok>
19777
19778 =back
19779
19780 =over 4
19781
19782 =item EXAMPLE
19783
19784 =item CAVEATS
19785
19786 =item NOTES
19787
19788 =item HISTORY
19789
19790 =item SEE ALSO
19791
19792 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
19793 L<Test::Harness>
19794
19795 =item AUTHORS
19796
19797 =item COPYRIGHT
19798
19799 =back
19800
19801 =head2 Test::Tutorial - A tutorial about writing really basic tests
19802
19803 =over 4
19804
19805 =item DESCRIPTION
19806
19807 =over 4
19808
19809 =item Nuts and bolts of testing.
19810
19811 =item Where to start?
19812
19813 =item Names
19814
19815 =item Test the manual
19816
19817 =item Sometimes the tests are wrong
19818
19819 =item Testing lots of values
19820
19821 =item Informative names
19822
19823 =item Skipping tests
19824
19825 =item Todo tests
19826
19827 =item Testing with taint mode.
19828
19829 =back
19830
19831 =item FOOTNOTES
19832
19833 =item AUTHORS
19834
19835 =item COPYRIGHT
19836
19837 =back
19838
19839 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
19840
19841 =over 4
19842
19843 =item SYNOPSIS
19844
19845 =item DESCRIPTION
19846
19847 =item EXAMPLE
19848
19849 =back
19850
19851 =head2 Text::Balanced - Extract delimited text sequences from strings.
19852
19853 =over 4
19854
19855 =item SYNOPSIS
19856
19857 =item DESCRIPTION
19858
19859 =over 4
19860
19861 =item General behaviour in list contexts
19862
19863 [0], [1], [2]
19864
19865 =item General behaviour in scalar and void contexts
19866
19867 =item A note about prefixes
19868
19869 =item C<extract_delimited>
19870
19871 =item C<extract_bracketed>
19872
19873 =item C<extract_variable>
19874
19875 [0], [1], [2]
19876
19877 =item C<extract_tagged>
19878
19879 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
19880 [0], [1], [2], [3], [4], [5]
19881
19882 =item C<gen_extract_tagged>
19883
19884 =item C<extract_quotelike>
19885
19886 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
19887
19888 =item C<extract_quotelike> and "here documents"
19889
19890 [0], [1], [2], [3], [4], [5], [6], [7..10]
19891
19892 =item C<extract_codeblock>
19893
19894 =item C<extract_multiple>
19895
19896 =item C<gen_delimited_pat>
19897
19898 =back
19899
19900 =item DIAGNOSTICS
19901
19902  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
19903 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
19904 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
19905 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
19906 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
19907 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
19908 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
19909 after dereferencer>, C<Did not find expected opening bracket at %s>,
19910 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
19911 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
19912 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
19913 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
19914 tag>
19915
19916 =item AUTHOR
19917
19918 =item BUGS AND IRRITATIONS
19919
19920 =item COPYRIGHT
19921
19922 =back
19923
19924 =head2 Text::ParseWords - parse text into an array of tokens or array of
19925 arrays
19926
19927 =over 4
19928
19929 =item SYNOPSIS
19930
19931 =item DESCRIPTION
19932
19933 =item EXAMPLES
19934
19935 =item AUTHORS
19936
19937 =back
19938
19939 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
19940 by Knuth
19941
19942 =over 4
19943
19944 =item SYNOPSIS
19945
19946 =item DESCRIPTION
19947
19948 =item EXAMPLES
19949
19950 =item LIMITATIONS
19951
19952 =item AUTHOR
19953
19954 =back
19955
19956 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
19957 unexpand(1)
19958
19959 =over 4
19960
19961 =item SYNOPSIS
19962
19963 =item DESCRIPTION
19964
19965 =item BUGS
19966
19967 =item AUTHOR
19968
19969 =back
19970
19971 =head2 Text::Wrap - line wrapping to form simple paragraphs
19972
19973 =over 4
19974
19975 =item SYNOPSIS
19976
19977 =item DESCRIPTION
19978
19979 =item OVERRIDES
19980
19981 =item EXAMPLE
19982
19983 =item AUTHOR
19984
19985 =back
19986
19987 =head2 Thread - manipulate threads in Perl (for old code only)
19988
19989 =over 4
19990
19991 =item CAVEAT
19992
19993 =item SYNOPSIS
19994
19995 =item DESCRIPTION
19996
19997 =item FUNCTIONS
19998
19999 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20000 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20001 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20002
20003 =item METHODS
20004
20005 join, eval, detach, equal, tid, flags, done
20006
20007 =item LIMITATIONS
20008
20009 =item SEE ALSO
20010
20011 =back
20012
20013 =head2 Thread::Queue - thread-safe queues
20014
20015 =over 4
20016
20017 =item SYNOPSIS
20018
20019 =item DESCRIPTION
20020
20021 =item FUNCTIONS AND METHODS
20022
20023 new, enqueue LIST, dequeue, dequeue_nb, pending
20024
20025 =item SEE ALSO
20026
20027 =back
20028
20029 =head2 Thread::Semaphore - thread-safe semaphores
20030
20031 =over 4
20032
20033 =item SYNOPSIS
20034
20035 =item DESCRIPTION
20036
20037 =item FUNCTIONS AND METHODS
20038
20039 new, new NUMBER, down, down NUMBER, up, up NUMBER
20040
20041 =back
20042
20043 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20044 (for old code)
20045
20046 =over 4
20047
20048 =item CAVEAT
20049
20050 =item SYNOPSIS
20051
20052 =item DESCRIPTION
20053
20054 =item BUGS
20055
20056 =back
20057
20058 =head2 Thread::Specific - thread-specific keys
20059
20060 =over 4
20061
20062 =item SYNOPSIS
20063
20064 =item DESCRIPTION
20065
20066 =back
20067
20068 =head2 Tie::Array - base class for tied arrays
20069
20070 =over 4
20071
20072 =item SYNOPSIS
20073
20074 =item DESCRIPTION
20075
20076 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20077 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20078 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20079 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20080
20081 =item CAVEATS
20082
20083 =item AUTHOR
20084
20085 =back
20086
20087 =head2 Tie::File - Access the lines of a disk file via a Perl array
20088
20089 =over 4
20090
20091 =item SYNOPSIS
20092
20093 =item DESCRIPTION
20094
20095 =over 4
20096
20097 =item C<recsep>
20098
20099 =item C<autochomp>
20100
20101 =item C<mode>
20102
20103 =item C<memory>
20104
20105 =item C<dw_size>
20106
20107 =item Option Format
20108
20109 =back
20110
20111 =item Public Methods
20112
20113 =over 4
20114
20115 =item C<flock>
20116
20117 =item C<autochomp>
20118
20119 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20120
20121 =item C<offset>
20122
20123 =back
20124
20125 =item Tying to an already-opened filehandle
20126
20127 =item Deferred Writing
20128
20129 =over 4
20130
20131 =item Autodeferring
20132
20133 =back
20134
20135 =item CONCURRENT ACCESS TO FILES
20136
20137 =item CAVEATS
20138
20139 =item SUBCLASSING
20140
20141 =item WHAT ABOUT C<DB_File>?
20142
20143 =item AUTHOR
20144
20145 =item LICENSE
20146
20147 =item WARRANTY
20148
20149 =item THANKS
20150
20151 =item TODO
20152
20153 =back
20154
20155 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20156 handles
20157
20158 =over 4
20159
20160 =item SYNOPSIS
20161
20162 =item DESCRIPTION
20163
20164 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20165 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20166 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20167 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20168
20169 =item MORE INFORMATION
20170
20171 =item COMPATIBILITY
20172
20173 =back
20174
20175 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20176 tied hashes
20177
20178 =over 4
20179
20180 =item SYNOPSIS
20181
20182 =item DESCRIPTION
20183
20184 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20185 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20186
20187 =item Inheriting from B<Tie::StdHash>
20188
20189 =item Inheriting from B<Tie::ExtraHash>
20190
20191 =item C<UNTIE> and C<DESTROY>
20192
20193 =item MORE INFORMATION
20194
20195 =back
20196
20197 =head2 Tie::Memoize - add data to hash when needed
20198
20199 =over 4
20200
20201 =item SYNOPSIS
20202
20203 =item DESCRIPTION
20204
20205 =item Inheriting from B<Tie::Memoize>
20206
20207 =item EXAMPLE
20208
20209 =item BUGS
20210
20211 =item AUTHOR
20212
20213 =back
20214
20215 =head2 Tie::RefHash - use references as hash keys
20216
20217 =over 4
20218
20219 =item SYNOPSIS
20220
20221 =item DESCRIPTION
20222
20223 =item EXAMPLE
20224
20225 =item AUTHOR
20226
20227 =item VERSION
20228
20229 =item SEE ALSO
20230
20231 =back
20232
20233 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20234 scalars
20235
20236 =over 4
20237
20238 =item SYNOPSIS
20239
20240 =item DESCRIPTION
20241
20242 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20243
20244 =item MORE INFORMATION
20245
20246 =back
20247
20248 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20249
20250 =over 4
20251
20252 =item SYNOPSIS
20253
20254 =item DESCRIPTION
20255
20256 =item CAVEATS
20257
20258 =back
20259
20260 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20261 timers
20262
20263 =over 4
20264
20265 =item SYNOPSIS
20266
20267 =item DESCRIPTION
20268
20269 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20270 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20271 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
20272 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
20273 $which )
20274
20275 =item EXAMPLES
20276
20277 =item C API
20278
20279 =item DIAGNOSTICS
20280
20281 =over 4
20282
20283 =item negative time not invented yet
20284
20285 =item internal error: useconds < 0 (unsigned ... signed ...)
20286
20287 =back
20288
20289 =item CAVEATS
20290
20291 =item AUTHORS
20292
20293 =item COPYRIGHT AND LICENSE
20294
20295 =back
20296
20297 =head2 Time::Local - efficiently compute time from local and GMT time
20298
20299 =over 4
20300
20301 =item SYNOPSIS
20302
20303 =item DESCRIPTION
20304
20305 =item IMPLEMENTATION
20306
20307 =item BUGS
20308
20309 =item SUPPORT
20310
20311 =item AUTHOR
20312
20313 =back
20314
20315 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20316 function
20317
20318 =over 4
20319
20320 =item SYNOPSIS
20321
20322 =item DESCRIPTION
20323
20324 =item NOTE
20325
20326 =item AUTHOR
20327
20328 =back
20329
20330 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20331 function
20332
20333 =over 4
20334
20335 =item SYNOPSIS
20336
20337 =item DESCRIPTION
20338
20339 =item NOTE
20340
20341 =item AUTHOR
20342
20343 =back
20344
20345 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20346
20347 =over 4
20348
20349 =item SYNOPSIS
20350
20351 =item DESCRIPTION
20352
20353 =item AUTHOR
20354
20355 =back
20356
20357 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20358
20359 =over 4
20360
20361 =item SYNOPSIS
20362
20363 =item DESCRIPTION
20364
20365 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20366 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20367 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20368
20369 =item EXPORTS
20370
20371 =back
20372
20373 =head2 Unicode::Collate - Unicode Collation Algorithm
20374
20375 =over 4
20376
20377 =item SYNOPSIS
20378
20379 =item DESCRIPTION
20380
20381 =over 4
20382
20383 =item Constructor and Tailoring
20384
20385 UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
20386 normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
20387 undefName, undefChar, katakana_before_hiragana, upper_before_lower
20388
20389 =item Methods for Collation
20390
20391 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20392 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20393 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20394 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20395 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20396 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20397 $Collator-E<gt>viewSortKey($string)>
20398
20399 =item Methods for Searching
20400
20401 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20402 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20403 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20404 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20405 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20406 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20407 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20408
20409 =item Other Methods
20410
20411 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
20412 Base_Unicode_Version
20413
20414 =item EXPORT
20415
20416 =item CAVEAT
20417
20418 =item Conformance Test
20419
20420 =back
20421
20422 =item AUTHOR
20423
20424 =item SEE ALSO
20425
20426 http://www.unicode.org/reports/tr10/,
20427 http://www.unicode.org/reports/tr10/allkeys.txt,
20428 http://www.unicode.org/reports/tr10/CollationTest.html
20429 http://www.unicode.org/reports/tr10/CollationTest.zip,
20430 http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
20431
20432 =back
20433
20434 =head2 Unicode::Normalize - Unicode Normalization Forms
20435
20436 =over 4
20437
20438 =item SYNOPSIS
20439
20440 =item DESCRIPTION
20441
20442 =over 4
20443
20444 =item Normalization Forms
20445
20446 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20447 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20448 C<$normalized_string = normalize($form_name, $string)>
20449
20450 =item Decomposition and Composition
20451
20452 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20453 decompose($string, $useCompatMapping)>, C<$reordered_string  =
20454 reorder($string)>, C<$composed_string   = compose($string)>
20455
20456 =item Quick Check
20457
20458 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20459 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20460 check($form_name, $string)>
20461
20462 =item Character Data
20463
20464 C<$canonical_decomposed = getCanon($codepoint)>,
20465 C<$compatibility_decomposed = getCompat($codepoint)>,
20466 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20467 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20468 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20469 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20470 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20471
20472 =item EXPORT
20473
20474 =back
20475
20476 =item AUTHOR
20477
20478 =item SEE ALSO
20479
20480 http://www.unicode.org/unicode/reports/tr15/,
20481 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
20482
20483 =back
20484
20485 =head2 Unicode::UCD - Unicode character database
20486
20487 =over 4
20488
20489 =item SYNOPSIS
20490
20491 =item DESCRIPTION
20492
20493 =back
20494
20495 =over 4
20496
20497 =item charinfo
20498
20499 =back
20500
20501 =over 4
20502
20503 =item charblock
20504
20505 =back
20506
20507 =over 4
20508
20509 =item charscript
20510
20511 =back
20512
20513 =over 4
20514
20515 =item charblocks
20516
20517 =back
20518
20519 =over 4
20520
20521 =item charscripts
20522
20523 =back
20524
20525 =over 4
20526
20527 =item Blocks versus Scripts
20528
20529 =item Matching Scripts and Blocks
20530
20531 =item Code Point Arguments
20532
20533 =item charinrange
20534
20535 =back
20536
20537 =over 4
20538
20539 =item compexcl
20540
20541 =back
20542
20543 =over 4
20544
20545 =item casefold
20546
20547 =back
20548
20549 =over 4
20550
20551 =item casespec
20552
20553 =back
20554
20555 =over 4
20556
20557 =item Unicode::UCD::UnicodeVersion
20558
20559 =back
20560
20561 =over 4
20562
20563 =item Implementation Note
20564
20565 =back
20566
20567 =over 4
20568
20569 =item BUGS
20570
20571 =item AUTHOR
20572
20573 =back
20574
20575 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20576 functions
20577
20578 =over 4
20579
20580 =item SYNOPSIS
20581
20582 =item DESCRIPTION
20583
20584 =item NOTE
20585
20586 =item AUTHOR
20587
20588 =back
20589
20590 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20591 functions
20592
20593 =over 4
20594
20595 =item SYNOPSIS
20596
20597 =item DESCRIPTION
20598
20599 =over 4
20600
20601 =item System Specifics
20602
20603 =back
20604
20605 =item NOTE
20606
20607 =item AUTHOR
20608
20609 =item HISTORY
20610
20611 March 18th, 2000
20612
20613 =back
20614
20615 =head2 Win32 - Interfaces to some Win32 API Functions
20616
20617 =over 4
20618
20619 =item DESCRIPTION
20620
20621 =over 4
20622
20623 =item Alphabetical Listing of Win32 Functions
20624
20625 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20626 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20627 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20628 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20629 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20630 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20631 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20632 Win32::GetOSVersion(), Win32::GetOSName(),
20633 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20634 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20635 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20636 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20637 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20638 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20639 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20640 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20641 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
20642 Win32::UnregisterServer(LIBRARYNAME)
20643
20644 =back
20645
20646 =back
20647
20648 =head2 XSLoader - Dynamically load C libraries into Perl code
20649
20650 =over 4
20651
20652 =item SYNOPSIS
20653
20654 =item DESCRIPTION
20655
20656 =over 4
20657
20658 =item Migration from C<DynaLoader>
20659
20660 =item Backward compatible boilerplate
20661
20662 =back
20663
20664 =item Order of initialization: early load()
20665
20666 =over 4
20667
20668 =item The most hairy case
20669
20670 =back
20671
20672 =item LIMITATIONS
20673
20674 =item AUTHOR
20675
20676 =back
20677
20678 =head1 AUXILIARY DOCUMENTATION
20679
20680 Here should be listed all the extra programs' documentation, but they
20681 don't all have manual pages yet:
20682
20683 =over 4
20684
20685 =item a2p
20686
20687 =item s2p
20688
20689 =item find2perl
20690
20691 =item h2ph
20692
20693 =item c2ph
20694
20695 =item h2xs
20696
20697 =item xsubpp
20698
20699 =item pod2man
20700
20701 =item wrapsuid
20702
20703 =back
20704
20705 =head1 AUTHOR
20706
20707 Larry Wall <F<larry@wall.org>>, with the help of oodles
20708 of other folks.
20709