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 Simple Statements
 189
 190 =item Compound Statements
 191
 192 =item Loop Control
 193
 194 =item For Loops
 195
 196 =item Foreach Loops
 197
 198 =item Basic BLOCKs and Switch Statements
 199
 200 =item Goto
 201
 202 =item PODs: Embedded Documentation
 203
 204 =item Plain Old Comments (Not!)
 205
 206 =back
 207
 208 =back
 209
 210 =head2 perldata - Perl data types
 211
 212 =over 4
 213
 214 =item DESCRIPTION
 215
 216 =over 4
 217
 218 =item Variable names
 219
 220 =item Context
 221
 222 =item Scalar values
 223
 224 =item Scalar value constructors
 225
 226 =item List value constructors
 227
 228 =item Subscripts
 229
 230 =item Slices
 231
 232 =item Typeglobs and Filehandles
 233
 234 =back
 235
 236 =item SEE ALSO
 237
 238 =back
 239
 240 =head2 perlop - Perl operators and precedence
 241
 242 =over 4
 243
 244 =item SYNOPSIS
 245
 246 =item DESCRIPTION
 247
 248 =over 4
 249
 250 =item Terms and List Operators (Leftward)
 251
 252 =item The Arrow Operator
 253
 254 =item Auto-increment and Auto-decrement
 255
 256 =item Exponentiation
 257
 258 =item Symbolic Unary Operators
 259
 260 =item Binding Operators
 261
 262 =item Multiplicative Operators
 263
 264 =item Additive Operators
 265
 266 =item Shift Operators
 267
 268 =item Named Unary Operators
 269
 270 =item Relational Operators
 271
 272 =item Equality Operators
 273
 274 =item Bitwise And
 275
 276 =item Bitwise Or and Exclusive Or
 277
 278 =item C-style Logical And
 279
 280 =item C-style Logical Or
 281
 282 =item C-style Logical Defined-Or
 283
 284 =item Range Operators
 285
 286 =item Conditional Operator
 287
 288 =item Assignment Operators
 289
 290 =item Comma Operator
 291
 292 =item List Operators (Rightward)
 293
 294 =item Logical Not
 295
 296 =item Logical And
 297
 298 =item Logical or, Defined or, and Exclusive Or
 299
 300 =item C Operators Missing From Perl
 301
 302 unary &, unary *, (TYPE)
 303
 304 =item Quote and Quote-like Operators
 305
 306 =item Regexp Quote-Like Operators
 307
 308 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 309 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 310 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 311 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 312
 313 =item Gory details of parsing quoted constructs
 314
 315 Finding the end, Removal of backslashes before delimiters, Interpolation,
 316 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 317 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 318 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 319 regular expressions
 320
 321 =item I/O Operators
 322
 323 =item Constant Folding
 324
 325 =item Bitwise String Operators
 326
 327 =item Integer Arithmetic
 328
 329 =item Floating-point Arithmetic
 330
 331 =item Bigger Numbers
 332
 333 =back
 334
 335 =back
 336
 337 =head2 perlsub - Perl subroutines
 338
 339 =over 4
 340
 341 =item SYNOPSIS
 342
 343 =item DESCRIPTION
 344
 345 =over 4
 346
 347 =item Private Variables via my()
 348
 349 =item Persistent Private Variables
 350
 351 =item Temporary Values via local()
 352
 353 =item Lvalue subroutines
 354
 355 Lvalue subroutines are EXPERIMENTAL
 356
 357 =item Passing Symbol Table Entries (typeglobs)
 358
 359 =item When to Still Use local()
 360
 361 =item Pass by Reference
 362
 363 =item Prototypes
 364
 365 =item Constant Functions
 366
 367 =item Overriding Built-in Functions
 368
 369 =item Autoloading
 370
 371 =item Subroutine Attributes
 372
 373 =back
 374
 375 =item SEE ALSO
 376
 377 =back
 378
 379 =head2 perlfunc - Perl builtin functions
 380
 381 =over 4
 382
 383 =item DESCRIPTION
 384
 385 =over 4
 386
 387 =item Perl Functions by Category
 388
 389 Functions for SCALARs or strings, Regular expressions and pattern matching,
 390 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 391 Functions for real %HASHes, Input and output functions, Functions for fixed
 392 length data or records, Functions for filehandles, files, or directories,
 393 Keywords related to the control flow of your perl program, Keywords related
 394 to scoping, Miscellaneous functions, Functions for processes and process
 395 groups, Keywords related to perl modules, Keywords related to classes and
 396 object-orientedness, Low-level socket functions, System V interprocess
 397 communication functions, Fetching user and group info, Fetching network
 398 info, Time-related functions, Functions new in perl5, Functions obsoleted
 399 in perl5
 400
 401 =item Portability
 402
 403 =item Alphabetical Listing of Perl Functions
 404
 405 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
 406 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 407 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
 408 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
 409 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
 410 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
 411 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 412 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
 413 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
 414 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
 415 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
 416 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
 417 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
 418 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
 419 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
 420 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
 421 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
 422 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
 423 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
 424 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
 425 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
 426 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
 427 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
 428 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 429 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 430 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 431 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
 432 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
 433 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
 434 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
 435 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
 436 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
 437 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
 438 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
 439 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
 440 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
 441 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
 442 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
 443 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
 444 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
 445 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 446 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 447 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 448 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
 449 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
 450 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
 451 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
 452 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
 453 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 454 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 455 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 456 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 457 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 458 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 459 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 460 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 461 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 462 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
 463 parameter index, flags, vector flag, (minimum) width, precision, or maximum
 464 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
 465 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
 466 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
 467 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 468 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 469 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 470 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 471 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 472 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 473 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 474 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 475 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 476 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 477 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
 478 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
 479 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
 480 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
 481
 482 =back
 483
 484 =back
 485
 486 =head2 perlreftut - Mark's very short tutorial about references
 487
 488 =over 4
 489
 490 =item DESCRIPTION
 491
 492 =item Who Needs Complicated Data Structures?
 493
 494 =item The Solution
 495
 496 =item Syntax
 497
 498 =over 4
 499
 500 =item Making References
 501
 502 =item Using References
 503
 504 =item An Example
 505
 506 =item Arrow Rule
 507
 508 =back
 509
 510 =item Solution
 511
 512 =item The Rest
 513
 514 =item Summary
 515
 516 =item Credits
 517
 518 =over 4
 519
 520 =item Distribution Conditions
 521
 522 =back
 523
 524 =back
 525
 526 =head2 perldsc - Perl Data Structures Cookbook
 527
 528 =over 4
 529
 530 =item DESCRIPTION
 531
 532 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 533 more elaborate constructs
 534
 535 =item REFERENCES
 536
 537 =item COMMON MISTAKES
 538
 539 =item CAVEAT ON PRECEDENCE
 540
 541 =item WHY YOU SHOULD ALWAYS C<use strict>
 542
 543 =item DEBUGGING
 544
 545 =item CODE EXAMPLES
 546
 547 =item ARRAYS OF ARRAYS
 548
 549 =over 4
 550
 551 =item Declaration of an ARRAY OF ARRAYS
 552
 553 =item Generation of an ARRAY OF ARRAYS
 554
 555 =item Access and Printing of an ARRAY OF ARRAYS
 556
 557 =back
 558
 559 =item HASHES OF ARRAYS
 560
 561 =over 4
 562
 563 =item Declaration of a HASH OF ARRAYS
 564
 565 =item Generation of a HASH OF ARRAYS
 566
 567 =item Access and Printing of a HASH OF ARRAYS
 568
 569 =back
 570
 571 =item ARRAYS OF HASHES
 572
 573 =over 4
 574
 575 =item Declaration of an ARRAY OF HASHES
 576
 577 =item Generation of an ARRAY OF HASHES
 578
 579 =item Access and Printing of an ARRAY OF HASHES
 580
 581 =back
 582
 583 =item HASHES OF HASHES
 584
 585 =over 4
 586
 587 =item Declaration of a HASH OF HASHES
 588
 589 =item Generation of a HASH OF HASHES
 590
 591 =item Access and Printing of a HASH OF HASHES
 592
 593 =back
 594
 595 =item MORE ELABORATE RECORDS
 596
 597 =over 4
 598
 599 =item Declaration of MORE ELABORATE RECORDS
 600
 601 =item Declaration of a HASH OF COMPLEX RECORDS
 602
 603 =item Generation of a HASH OF COMPLEX RECORDS
 604
 605 =back
 606
 607 =item Database Ties
 608
 609 =item SEE ALSO
 610
 611 =item AUTHOR
 612
 613 =back
 614
 615 =head2 perlrequick - Perl regular expressions quick start
 616
 617 =over 4
 618
 619 =item DESCRIPTION
 620
 621 =item The Guide
 622
 623 =over 4
 624
 625 =item Simple word matching
 626
 627 =item Using character classes
 628
 629 =item Matching this or that
 630
 631 =item Grouping things and hierarchical matching
 632
 633 =item Extracting matches
 634
 635 =item Matching repetitions
 636
 637 =item More matching
 638
 639 =item Search and replace
 640
 641 =item The split operator
 642
 643 =back
 644
 645 =item BUGS
 646
 647 =item SEE ALSO
 648
 649 =item AUTHOR AND COPYRIGHT
 650
 651 =over 4
 652
 653 =item Acknowledgments
 654
 655 =back
 656
 657 =back
 658
 659 =head2 perlpod - the Plain Old Documentation format
 660
 661 =over 4
 662
 663 =item DESCRIPTION
 664
 665 =over 4
 666
 667 =item Ordinary Paragraph
 668
 669 =item Verbatim Paragraph
 670
 671 =item Command Paragraph
 672
 673 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 674 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 675 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 676 I<formatname>>, C<=for I<formatname> I<text...>>
 677
 678 =item Formatting Codes
 679
 680 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 681 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 682 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 683 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 684 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 685 (zero-effect) formatting code
 686
 687 =item The Intent
 688
 689 =item Embedding Pods in Perl Modules
 690
 691 =item Hints for Writing Pod
 692
 693 =back
 694
 695 =item SEE ALSO
 696
 697 =item AUTHOR
 698
 699 =back
 700
 701 =head2 perlpodspec - Plain Old Documentation: format specification and
 702 notes
 703
 704 =over 4
 705
 706 =item DESCRIPTION
 707
 708 =item Pod Definitions
 709
 710 =item Pod Commands
 711
 712 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 713 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 714
 715 =item Pod Formatting Codes
 716
 717 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 718 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 719 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 720 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 721 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 722 contains non-breaking spaces
 723
 724 =item Notes on Implementing Pod Processors
 725
 726 =item About LE<lt>...E<gt> Codes
 727
 728 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 729
 730 =item About =over...=back Regions
 731
 732 =item About Data Paragraphs and "=begin/=end" Regions
 733
 734 =item SEE ALSO
 735
 736 =item AUTHOR
 737
 738 =back
 739
 740 =head2 perlstyle - Perl style guide
 741
 742 =over 4
 743
 744 =item DESCRIPTION
 745
 746 =back
 747
 748 =head2 perltrap - Perl traps for the unwary
 749
 750 =over 4
 751
 752 =item DESCRIPTION
 753
 754 =over 4
 755
 756 =item Awk Traps
 757
 758 =item C/C++ Traps
 759
 760 =item Sed Traps
 761
 762 =item Shell Traps
 763
 764 =item Perl Traps
 765
 766 =item Perl4 to Perl5 Traps
 767
 768 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 769 Traps, General data type traps, Context Traps - scalar, list contexts,
 770 Precedence Traps, General Regular Expression Traps using s///, etc,
 771 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 772
 773 =item Discontinuance, Deprecation, and BugFix traps
 774
 775 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 776 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 777 Discontinuance, Deprecation, Discontinuance, Discontinuance
 778
 779 =item Parsing Traps
 780
 781 Parsing, Parsing, Parsing, Parsing, Parsing
 782
 783 =item Numerical Traps
 784
 785 Numerical, Numerical, Numerical, Bitwise string ops
 786
 787 =item General data type traps
 788
 789 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 790 (Constants), (Scalars), (Variable Suicide)
 791
 792 =item Context Traps - scalar, list contexts
 793
 794 (list context), (scalar context), (scalar context), (list, builtin)
 795
 796 =item Precedence Traps
 797
 798 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 799 Precedence
 800
 801 =item General Regular Expression Traps using s///, etc.
 802
 803 Regular Expression, Regular Expression, Regular Expression, Regular
 804 Expression, Regular Expression, Regular Expression, Regular Expression,
 805 Regular Expression
 806
 807 =item Subroutine, Signal, Sorting Traps
 808
 809 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 810
 811 =item OS Traps
 812
 813 (SysV), (SysV)
 814
 815 =item Interpolation Traps
 816
 817 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 818 Interpolation, Interpolation, Interpolation, Interpolation
 819
 820 =item DBM Traps
 821
 822 DBM, DBM
 823
 824 =item Unclassified Traps
 825
 826 C<require>/C<do> trap using returned value, C<split> on empty string with
 827 LIMIT specified
 828
 829 =back
 830
 831 =back
 832
 833 =head2 perlrun - how to execute the Perl interpreter
 834
 835 =over 4
 836
 837 =item SYNOPSIS
 838
 839 =item DESCRIPTION
 840
 841 =over 4
 842
 843 =item #! and quoting on non-Unix systems
 844
 845 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 846
 847 =item Location of Perl
 848
 849 =item Command Switches
 850
 851 B<-0>[I<octal/hexadecimal>], B<-a>, B<-C [I<number/list>]>, B<-c>, B<-d>,
 852 B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e>
 853 I<commandline>, B<-F>I<pattern>, B<-h>, B<-i>[I<extension>],
 854 B<-I>I<directory>, B<-l>[I<octnum>], B<-m>[B<->]I<module>,
 855 B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 856 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 857 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 858 B<-X>, B<-x> I<directory>
 859
 860 =back
 861
 862 =item ENVIRONMENT
 863
 864 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 865 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 866 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 867 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
 868 PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
 869
 870 =back
 871
 872 =head2 perldiag - various Perl diagnostics
 873
 874 =over 4
 875
 876 =item DESCRIPTION
 877
 878 =back
 879
 880 =head2 perllexwarn - Perl Lexical Warnings
 881
 882 =over 4
 883
 884 =item DESCRIPTION
 885
 886 =over 4
 887
 888 =item Default Warnings and Optional Warnings
 889
 890 =item What's wrong with B<-w> and C<$^W>
 891
 892 =item Controlling Warnings from the Command Line
 893
 894 B<-w>, B<-W>, B<-X>
 895
 896 =item Backward Compatibility
 897
 898 =item Category Hierarchy
 899
 900 =item Fatal Warnings
 901
 902 =item Reporting Warnings from a Module
 903
 904 =back
 905
 906 =item TODO
 907
 908 =item SEE ALSO
 909
 910 =item AUTHOR
 911
 912 =back
 913
 914 =head2 perldebtut - Perl debugging tutorial
 915
 916 =over 4
 917
 918 =item DESCRIPTION
 919
 920 =item use strict
 921
 922 =item Looking at data and -w and v
 923
 924 =item help
 925
 926 =item Stepping through code
 927
 928 =item Placeholder for a, w, t, T
 929
 930 =item REGULAR EXPRESSIONS
 931
 932 =item OUTPUT TIPS
 933
 934 =item CGI
 935
 936 =item GUIs
 937
 938 =item SUMMARY
 939
 940 =item SEE ALSO
 941
 942 =item AUTHOR
 943
 944 =item CONTRIBUTORS
 945
 946 =back
 947
 948 =head2 perldebug - Perl debugging
 949
 950 =over 4
 951
 952 =item DESCRIPTION
 953
 954 =item The Perl Debugger
 955
 956 =over 4
 957
 958 =item Debugger Commands
 959
 960 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 961 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 962 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 963 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 964 subname [condition], b postpone subname [condition], b load filename, b
 965 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 966 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 967 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
 968 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
 969 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
 970 [manpage]
 971
 972 =item Configurable Options
 973
 974 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 975 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 976 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 977 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
 978 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
 979 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
 980 C<NonStop>
 981
 982 =item Debugger input/output
 983
 984 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 985 listing
 986
 987 =item Debugging compile-time statements
 988
 989 =item Debugger Customization
 990
 991 =item Readline Support
 992
 993 =item Editor Support for Debugging
 994
 995 =item The Perl Profiler
 996
 997 =back
 998
 999 =item Debugging regular expressions
1000
1001 =item Debugging memory usage
1002
1003 =item SEE ALSO
1004
1005 =item BUGS
1006
1007 =back
1008
1009 =head2 perlvar - Perl predefined variables
1010
1011 =over 4
1012
1013 =item DESCRIPTION
1014
1015 =over 4
1016
1017 =item Predefined Names
1018
1019 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1020 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1021 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1022 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1023 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1024 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1025 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1026 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1027 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1028 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1029 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1030 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1031 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1032 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1033 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1034 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1035 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1036 IO::Handle->format_line_break_characters EXPR,
1037 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1038 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1039 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1040 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1041 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1042 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1043 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1044 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1045 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1046 $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, $PERL_VERSION, $^V, $WARNING, $^W,
1047 ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F,
1048 @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1049
1050 =item Error Indicators
1051
1052 =item Technical Note on the Syntax of Variable Names
1053
1054 =back
1055
1056 =item BUGS
1057
1058 =back
1059
1060 =head2 perllol - Manipulating Arrays of Arrays in Perl
1061
1062 =over 4
1063
1064 =item DESCRIPTION
1065
1066 =over 4
1067
1068 =item Declaration and Access of Arrays of Arrays
1069
1070 =item Growing Your Own
1071
1072 =item Access and Printing
1073
1074 =item Slices
1075
1076 =back
1077
1078 =item SEE ALSO
1079
1080 =item AUTHOR
1081
1082 =back
1083
1084 =head2 perlopentut - tutorial on opening things in Perl
1085
1086 =over 4
1087
1088 =item DESCRIPTION
1089
1090 =item Open E<agrave> la shell
1091
1092 =over 4
1093
1094 =item Simple Opens
1095
1096 =item Indirect Filehandles
1097
1098 =item Pipe Opens
1099
1100 =item The Minus File
1101
1102 =item Mixing Reads and Writes
1103
1104 =item Filters
1105
1106 =back
1107
1108 =item Open E<agrave> la C
1109
1110 =over 4
1111
1112 =item Permissions E<agrave> la mode
1113
1114 =back
1115
1116 =item Obscure Open Tricks
1117
1118 =over 4
1119
1120 =item Re-Opening Files (dups)
1121
1122 =item Dispelling the Dweomer
1123
1124 =item Paths as Opens
1125
1126 =item Single Argument Open
1127
1128 =item Playing with STDIN and STDOUT
1129
1130 =back
1131
1132 =item Other I/O Issues
1133
1134 =over 4
1135
1136 =item Opening Non-File Files
1137
1138 =item Opening Named Pipes
1139
1140 =item Opening Sockets
1141
1142 =item Binary Files
1143
1144 =item File Locking
1145
1146 =item IO Layers
1147
1148 =back
1149
1150 =item SEE ALSO
1151
1152 =item AUTHOR and COPYRIGHT
1153
1154 =item HISTORY
1155
1156 =back
1157
1158 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1159
1160 =over 4
1161
1162 =item DESCRIPTION
1163
1164 =item The Basic Principle
1165
1166 =item Packing Text
1167
1168 =item Packing Numbers
1169
1170 =over 4
1171
1172 =item Integers
1173
1174 =item Unpacking a Stack Frame
1175
1176 =item How to Eat an Egg on a Net
1177
1178 =item Floating point Numbers
1179
1180 =back
1181
1182 =item Exotic Templates
1183
1184 =over 4
1185
1186 =item Bit Strings
1187
1188 =item Uuencoding
1189
1190 =item Doing Sums
1191
1192 =item  Unicode
1193
1194 =item Another Portable Binary Encoding
1195
1196 =back
1197
1198 =item Template Grouping
1199
1200 =item Lengths and Widths
1201
1202 =over 4
1203
1204 =item String Lengths
1205
1206 =item Dynamic Templates
1207
1208 =item Counting Repetitions
1209
1210 =back
1211
1212 =item Packing and Unpacking C Structures
1213
1214 =over 4
1215
1216 =item The Alignment Pit
1217
1218 =item Alignment, Take 2
1219
1220 =item Alignment, Take 3
1221
1222 =item Pointers for How to Use Them
1223
1224 =back
1225
1226 =item Pack Recipes
1227
1228 =item Funnies Section
1229
1230 =item Authors
1231
1232 =back
1233
1234 =head2 perlretut - Perl regular expressions tutorial
1235
1236 =over 4
1237
1238 =item DESCRIPTION
1239
1240 =item Part 1: The basics
1241
1242 =over 4
1243
1244 =item Simple word matching
1245
1246 =item Using character classes
1247
1248 =item Matching this or that
1249
1250 =item Grouping things and hierarchical matching
1251
1252 =item Extracting matches
1253
1254 =item Matching repetitions
1255
1256 =item Building a regexp
1257
1258 =item Using regular expressions in Perl
1259
1260 =back
1261
1262 =item Part 2: Power tools
1263
1264 =over 4
1265
1266 =item More on characters, strings, and character classes
1267
1268 =item Compiling and saving regular expressions
1269
1270 =item Embedding comments and modifiers in a regular expression
1271
1272 =item Non-capturing groupings
1273
1274 =item Looking ahead and looking behind
1275
1276 =item Using independent subexpressions to prevent backtracking
1277
1278 =item Conditional expressions
1279
1280 =item A bit of magic: executing Perl code in a regular expression
1281
1282 =item Pragmas and debugging
1283
1284 =back
1285
1286 =item BUGS
1287
1288 =item SEE ALSO
1289
1290 =item AUTHOR AND COPYRIGHT
1291
1292 =over 4
1293
1294 =item Acknowledgments
1295
1296 =back
1297
1298 =back
1299
1300 =head2 perlre - Perl regular expressions
1301
1302 =over 4
1303
1304 =item DESCRIPTION
1305
1306 i, m, s, x
1307
1308 =over 4
1309
1310 =item Regular Expressions
1311
1312 [1], [2], [3], cntrl, graph, print, punct, xdigit
1313
1314 =item Extended Patterns
1315
1316 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1317 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1318 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1319 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1320
1321 =item Backtracking
1322
1323 =item Version 8 Regular Expressions
1324
1325 =item Warning on \1 vs $1
1326
1327 =item Repeated patterns matching zero-length substring
1328
1329 =item Combining pieces together
1330
1331 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1332 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1333 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1334 C<(?(condition)yes-pattern|no-pattern)>
1335
1336 =item Creating custom RE engines
1337
1338 =back
1339
1340 =item BUGS
1341
1342 =item SEE ALSO
1343
1344 =back
1345
1346 =head2 perlref - Perl references and nested data structures
1347
1348 =over 4
1349
1350 =item NOTE
1351
1352 =item DESCRIPTION
1353
1354 =over 4
1355
1356 =item Making References
1357
1358 =item Using References
1359
1360 =item Symbolic references
1361
1362 =item Not-so-symbolic references
1363
1364 =item Pseudo-hashes: Using an array as a hash
1365
1366 =item Function Templates
1367
1368 =back
1369
1370 =item WARNING
1371
1372 =item SEE ALSO
1373
1374 =back
1375
1376 =head2 perlform - Perl formats
1377
1378 =over 4
1379
1380 =item DESCRIPTION
1381
1382 =over 4
1383
1384 =item Format Variables
1385
1386 =back
1387
1388 =item NOTES
1389
1390 =over 4
1391
1392 =item Footers
1393
1394 =item Accessing Formatting Internals
1395
1396 =back
1397
1398 =item WARNINGS
1399
1400 =back
1401
1402 =head2 perlboot - Beginner's Object-Oriented Tutorial
1403
1404 =over 4
1405
1406 =item DESCRIPTION
1407
1408 =over 4
1409
1410 =item If we could talk to the animals...
1411
1412 =item Introducing the method invocation arrow
1413
1414 =item Invoking a barnyard
1415
1416 =item The extra parameter of method invocation
1417
1418 =item Calling a second method to simplify things
1419
1420 =item Inheriting the windpipes
1421
1422 =item A few notes about @ISA
1423
1424 =item Overriding the methods
1425
1426 =item Starting the search from a different place
1427
1428 =item The SUPER way of doing things
1429
1430 =item Where we're at so far...
1431
1432 =item A horse is a horse, of course of course -- or is it?
1433
1434 =item Invoking an instance method
1435
1436 =item Accessing the instance data
1437
1438 =item How to build a horse
1439
1440 =item Inheriting the constructor
1441
1442 =item Making a method work with either classes or instances
1443
1444 =item Adding parameters to a method
1445
1446 =item More interesting instances
1447
1448 =item A horse of a different color
1449
1450 =item Summary
1451
1452 =back
1453
1454 =item SEE ALSO
1455
1456 =item COPYRIGHT
1457
1458 =back
1459
1460 =head2 perltoot - Tom's object-oriented tutorial for perl
1461
1462 =over 4
1463
1464 =item DESCRIPTION
1465
1466 =item Creating a Class
1467
1468 =over 4
1469
1470 =item Object Representation
1471
1472 =item Class Interface
1473
1474 =item Constructors and Instance Methods
1475
1476 =item Planning for the Future: Better Constructors
1477
1478 =item Destructors
1479
1480 =item Other Object Methods
1481
1482 =back
1483
1484 =item Class Data
1485
1486 =over 4
1487
1488 =item Accessing Class Data
1489
1490 =item Debugging Methods
1491
1492 =item Class Destructors
1493
1494 =item Documenting the Interface
1495
1496 =back
1497
1498 =item Aggregation
1499
1500 =item Inheritance
1501
1502 =over 4
1503
1504 =item Overridden Methods
1505
1506 =item Multiple Inheritance
1507
1508 =item UNIVERSAL: The Root of All Objects
1509
1510 =back
1511
1512 =item Alternate Object Representations
1513
1514 =over 4
1515
1516 =item Arrays as Objects
1517
1518 =item Closures as Objects
1519
1520 =back
1521
1522 =item AUTOLOAD: Proxy Methods
1523
1524 =over 4
1525
1526 =item Autoloaded Data Methods
1527
1528 =item Inherited Autoloaded Data Methods
1529
1530 =back
1531
1532 =item Metaclassical Tools
1533
1534 =over 4
1535
1536 =item Class::Struct
1537
1538 =item Data Members as Variables
1539
1540 =back
1541
1542 =item NOTES
1543
1544 =over 4
1545
1546 =item Object Terminology
1547
1548 =back
1549
1550 =item SEE ALSO
1551
1552 =item AUTHOR AND COPYRIGHT
1553
1554 =item COPYRIGHT
1555
1556 =over 4
1557
1558 =item Acknowledgments
1559
1560 =back
1561
1562 =back
1563
1564 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1565
1566 =over 4
1567
1568 =item DESCRIPTION
1569
1570 =item Class Data in a Can
1571
1572 =item Class Data as Package Variables
1573
1574 =over 4
1575
1576 =item Putting All Your Eggs in One Basket
1577
1578 =item Inheritance Concerns
1579
1580 =item The Eponymous Meta-Object
1581
1582 =item Indirect References to Class Data
1583
1584 =item Monadic Classes
1585
1586 =item Translucent Attributes
1587
1588 =back
1589
1590 =item Class Data as Lexical Variables
1591
1592 =over 4
1593
1594 =item Privacy and Responsibility
1595
1596 =item File-Scoped Lexicals
1597
1598 =item More Inheritance Concerns
1599
1600 =item Locking the Door and Throwing Away the Key
1601
1602 =item Translucency Revisited
1603
1604 =back
1605
1606 =item NOTES
1607
1608 =item SEE ALSO
1609
1610 =item AUTHOR AND COPYRIGHT
1611
1612 =item ACKNOWLEDGEMENTS
1613
1614 =item HISTORY
1615
1616 =back
1617
1618 =head2 perlobj - Perl objects
1619
1620 =over 4
1621
1622 =item DESCRIPTION
1623
1624 =over 4
1625
1626 =item An Object is Simply a Reference
1627
1628 =item A Class is Simply a Package
1629
1630 =item A Method is Simply a Subroutine
1631
1632 =item Method Invocation
1633
1634 =item Indirect Object Syntax
1635
1636 =item Default UNIVERSAL methods
1637
1638 isa(CLASS), can(METHOD), VERSION( [NEED] )
1639
1640 =item Destructors
1641
1642 =item Summary
1643
1644 =item Two-Phased Garbage Collection
1645
1646 =back
1647
1648 =item SEE ALSO
1649
1650 =back
1651
1652 =head2 perlbot - Bag'o Object Tricks (the BOT)
1653
1654 =over 4
1655
1656 =item DESCRIPTION
1657
1658 =item OO SCALING TIPS
1659
1660 =item INSTANCE VARIABLES
1661
1662 =item SCALAR INSTANCE VARIABLES
1663
1664 =item INSTANCE VARIABLE INHERITANCE
1665
1666 =item OBJECT RELATIONSHIPS
1667
1668 =item OVERRIDING SUPERCLASS METHODS
1669
1670 =item USING RELATIONSHIP WITH SDBM
1671
1672 =item THINKING OF CODE REUSE
1673
1674 =item CLASS CONTEXT AND THE OBJECT
1675
1676 =item INHERITING A CONSTRUCTOR
1677
1678 =item DELEGATION
1679
1680 =item SEE ALSO
1681
1682 =back
1683
1684 =head2 perltie - how to hide an object class in a simple variable
1685
1686 =over 4
1687
1688 =item SYNOPSIS
1689
1690 =item DESCRIPTION
1691
1692 =over 4
1693
1694 =item Tying Scalars
1695
1696 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1697 DESTROY this
1698
1699 =item Tying Arrays
1700
1701 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1702 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1703 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1704 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1705 this
1706
1707 =item Tying Hashes
1708
1709 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1710 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1711 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1712
1713 =item Tying FileHandles
1714
1715 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1716 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1717 DESTROY this
1718
1719 =item UNTIE this
1720
1721 =item The C<untie> Gotcha
1722
1723 =back
1724
1725 =item SEE ALSO
1726
1727 =item BUGS
1728
1729 =item AUTHOR
1730
1731 =back
1732
1733 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1734 safe subprocesses, sockets, and semaphores)
1735
1736 =over 4
1737
1738 =item DESCRIPTION
1739
1740 =item Signals
1741
1742 =over 4
1743
1744 =item Handling the SIGHUP Signal in Daemons
1745
1746 =back
1747
1748 =item Named Pipes
1749
1750 =over 4
1751
1752 =item Deferred Signals (Safe signals)
1753
1754 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1755 triggered by operating system state
1756
1757 =back
1758
1759 =item Using open() for IPC
1760
1761 =over 4
1762
1763 =item Filehandles
1764
1765 =item Background Processes
1766
1767 =item Complete Dissociation of Child from Parent
1768
1769 =item Safe Pipe Opens
1770
1771 =item Bidirectional Communication with Another Process
1772
1773 =item Bidirectional Communication with Yourself
1774
1775 =back
1776
1777 =item Sockets: Client/Server Communication
1778
1779 =over 4
1780
1781 =item Internet Line Terminators
1782
1783 =item Internet TCP Clients and Servers
1784
1785 =item Unix-Domain TCP Clients and Servers
1786
1787 =back
1788
1789 =item TCP Clients with IO::Socket
1790
1791 =over 4
1792
1793 =item A Simple Client
1794
1795 C<Proto>, C<PeerAddr>, C<PeerPort>
1796
1797 =item A Webget Client
1798
1799 =item Interactive Client with IO::Socket
1800
1801 =back
1802
1803 =item TCP Servers with IO::Socket
1804
1805 Proto, LocalPort, Listen, Reuse
1806
1807 =item UDP: Message Passing
1808
1809 =item SysV IPC
1810
1811 =item NOTES
1812
1813 =item BUGS
1814
1815 =item AUTHOR
1816
1817 =item SEE ALSO
1818
1819 =back
1820
1821 =head2 perlfork - Perl's fork() emulation
1822
1823 =over 4
1824
1825 =item SYNOPSIS
1826
1827 =item DESCRIPTION
1828
1829 =over 4
1830
1831 =item Behavior of other Perl features in forked pseudo-processes
1832
1833 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1834 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1835 files, directories and network sockets
1836
1837 =item Resource limits
1838
1839 =item Killing the parent process
1840
1841 =item Lifetime of the parent process and pseudo-processes
1842
1843 =item CAVEATS AND LIMITATIONS
1844
1845 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1846 Global state maintained by XSUBs, Interpreter embedded in larger
1847 application, Thread-safety of extensions
1848
1849 =back
1850
1851 =item BUGS
1852
1853 =item AUTHOR
1854
1855 =item SEE ALSO
1856
1857 =back
1858
1859 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1860
1861 =over 4
1862
1863 =item SYNOPSIS
1864
1865 =item DESCRIPTION
1866
1867 =item Storing numbers
1868
1869 =item Numeric operators and numeric conversions
1870
1871 =item Flavors of Perl numeric operations
1872
1873 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
1874 mathematical operators, Bitwise operators, Bitwise operators during C<use
1875 integer>, Operators which expect an integer, Operators which expect a
1876 string
1877
1878 =item AUTHOR
1879
1880 =item SEE ALSO
1881
1882 =back
1883
1884 =head2 perlthrtut - tutorial on threads in Perl
1885
1886 =over 4
1887
1888 =item DESCRIPTION
1889
1890 =item Status
1891
1892 =item What Is A Thread Anyway?
1893
1894 =item Threaded Program Models
1895
1896 =over 4
1897
1898 =item Boss/Worker
1899
1900 =item Work Crew
1901
1902 =item Pipeline
1903
1904 =back
1905
1906 =item Native threads
1907
1908 =item What kind of threads are Perl threads?
1909
1910 =item Thread-Safe Modules
1911
1912 =item Thread Basics
1913
1914 =over 4
1915
1916 =item Basic Thread Support
1917
1918 =item A Note about the Examples
1919
1920 =item Creating Threads
1921
1922 =item Giving up control
1923
1924 =item Waiting For A Thread To Exit
1925
1926 =item Ignoring A Thread
1927
1928 =back
1929
1930 =item Threads And Data
1931
1932 =over 4
1933
1934 =item Shared And Unshared Data
1935
1936 =item Thread Pitfalls: Races
1937
1938 =back
1939
1940 =item Synchronization and control
1941
1942 =over 4
1943
1944 =item Controlling access: lock()
1945
1946 =item A Thread Pitfall: Deadlocks
1947
1948 =item Queues: Passing Data Around
1949
1950 =item Semaphores: Synchronizing Data Access
1951
1952 =item Basic semaphores
1953
1954 =item Advanced Semaphores
1955
1956 =item cond_wait() and cond_signal()
1957
1958 =back
1959
1960 =item General Thread Utility Routines
1961
1962 =over 4
1963
1964 =item What Thread Am I In?
1965
1966 =item Thread IDs
1967
1968 =item Are These Threads The Same?
1969
1970 =item What Threads Are Running?
1971
1972 =back
1973
1974 =item A Complete Example
1975
1976 =item Performance considerations
1977
1978 =item Process-scope Changes
1979
1980 =item Thread-Safety of System Libraries
1981
1982 =item Conclusion
1983
1984 =item Bibliography
1985
1986 =over 4
1987
1988 =item Introductory Texts
1989
1990 =item OS-Related References
1991
1992 =item Other References
1993
1994 =back
1995
1996 =item Acknowledgements
1997
1998 =item AUTHOR
1999
2000 =item Copyrights
2001
2002 =back
2003
2004 =head2 perlothrtut - old tutorial on threads in Perl
2005
2006 =over 4
2007
2008 =item DESCRIPTION
2009
2010 =item What Is A Thread Anyway?
2011
2012 =item Threaded Program Models
2013
2014 =over 4
2015
2016 =item Boss/Worker
2017
2018 =item Work Crew
2019
2020 =item Pipeline
2021
2022 =back
2023
2024 =item Native threads
2025
2026 =item What kind of threads are perl threads?
2027
2028 =item Threadsafe Modules
2029
2030 =item Thread Basics
2031
2032 =over 4
2033
2034 =item Basic Thread Support
2035
2036 =item Creating Threads
2037
2038 =item Giving up control
2039
2040 =item Waiting For A Thread To Exit
2041
2042 =item Errors In Threads
2043
2044 =item Ignoring A Thread
2045
2046 =back
2047
2048 =item Threads And Data
2049
2050 =over 4
2051
2052 =item Shared And Unshared Data
2053
2054 =item Thread Pitfall: Races
2055
2056 =item Controlling access: lock()
2057
2058 =item Thread Pitfall: Deadlocks
2059
2060 =item Queues: Passing Data Around
2061
2062 =back
2063
2064 =item Threads And Code
2065
2066 =over 4
2067
2068 =item Semaphores: Synchronizing Data Access
2069
2070 Basic semaphores, Advanced Semaphores
2071
2072 =item Attributes: Restricting Access To Subroutines
2073
2074 =item Subroutine Locks
2075
2076 =item Methods
2077
2078 =item Locking A Subroutine
2079
2080 =back
2081
2082 =item General Thread Utility Routines
2083
2084 =over 4
2085
2086 =item What Thread Am I In?
2087
2088 =item Thread IDs
2089
2090 =item Are These Threads The Same?
2091
2092 =item What Threads Are Running?
2093
2094 =back
2095
2096 =item A Complete Example
2097
2098 =item Conclusion
2099
2100 =item Bibliography
2101
2102 =over 4
2103
2104 =item Introductory Texts
2105
2106 =item OS-Related References
2107
2108 =item Other References
2109
2110 =back
2111
2112 =item Acknowledgements
2113
2114 =item AUTHOR
2115
2116 =item Copyrights
2117
2118 =back
2119
2120 =head2 perlport - Writing portable Perl
2121
2122 =over 4
2123
2124 =item DESCRIPTION
2125
2126 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2127 portable
2128
2129 =item ISSUES
2130
2131 =over 4
2132
2133 =item Newlines
2134
2135 =item Numbers endianness and Width
2136
2137 =item Files and Filesystems
2138
2139 =item System Interaction
2140
2141 =item Command names versus file pathnames
2142
2143 =item Interprocess Communication (IPC)
2144
2145 =item External Subroutines (XS)
2146
2147 =item Standard Modules
2148
2149 =item Time and Date
2150
2151 =item Character sets and character encoding
2152
2153 =item Internationalisation
2154
2155 =item System Resources
2156
2157 =item Security
2158
2159 =item Style
2160
2161 =back
2162
2163 =item CPAN Testers
2164
2165 Mailing list: cpan-testers@perl.org, Testing results:
2166 http://testers.cpan.org/
2167
2168 =item PLATFORMS
2169
2170 =over 4
2171
2172 =item Unix
2173
2174 =item DOS and Derivatives
2175
2176 =item S<Mac OS>
2177
2178 =item VMS
2179
2180 =item VOS
2181
2182 =item EBCDIC Platforms
2183
2184 =item Acorn RISC OS
2185
2186 =item Other perls
2187
2188 =back
2189
2190 =item FUNCTION IMPLEMENTATIONS
2191
2192 =over 4
2193
2194 =item Alphabetical Listing of Perl Functions
2195
2196 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2197 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2198 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2199 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2200 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2201 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2202 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2203 getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
2204 getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
2205 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
2206 endhostent, endnetent, endprotoent, endservent, getsockopt
2207 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
2208 kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
2209 lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
2210 ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
2211 READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
2212 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
2213 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2214 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2215 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2216 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2217 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2218 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2219 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2220 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2221 wait, waitpid PID,FLAGS
2222
2223 =back
2224
2225 =item CHANGES
2226
2227 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
2228 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
2229 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
2230 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
2231 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
2232 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
2233
2234 =item Supported Platforms
2235
2236 =item SEE ALSO
2237
2238 =item AUTHORS / CONTRIBUTORS
2239
2240 =back
2241
2242 =head2 perllocale - Perl locale handling (internationalization and
2243 localization)
2244
2245 =over 4
2246
2247 =item DESCRIPTION
2248
2249 =item PREPARING TO USE LOCALES
2250
2251 =item USING LOCALES
2252
2253 =over 4
2254
2255 =item The use locale pragma
2256
2257 =item The setlocale function
2258
2259 =item Finding locales
2260
2261 =item LOCALE PROBLEMS
2262
2263 =item Temporarily fixing locale problems
2264
2265 =item Permanently fixing locale problems
2266
2267 =item Permanently fixing your system's locale configuration
2268
2269 =item Fixing system locale configuration
2270
2271 =item The localeconv function
2272
2273 =item I18N::Langinfo
2274
2275 =back
2276
2277 =item LOCALE CATEGORIES
2278
2279 =over 4
2280
2281 =item Category LC_COLLATE: Collation
2282
2283 =item Category LC_CTYPE: Character Types
2284
2285 =item Category LC_NUMERIC: Numeric Formatting
2286
2287 =item Category LC_MONETARY: Formatting of monetary amounts
2288
2289 =item LC_TIME
2290
2291 =item Other categories
2292
2293 =back
2294
2295 =item SECURITY
2296
2297 =item ENVIRONMENT
2298
2299 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2300 LC_NUMERIC, LC_TIME, LANG
2301
2302 =item NOTES
2303
2304 =over 4
2305
2306 =item Backward compatibility
2307
2308 =item I18N:Collate obsolete
2309
2310 =item Sort speed and memory use impacts
2311
2312 =item write() and LC_NUMERIC
2313
2314 =item Freely available locale definitions
2315
2316 =item I18n and l10n
2317
2318 =item An imperfect standard
2319
2320 =back
2321
2322 =item Unicode and UTF-8
2323
2324 =item BUGS
2325
2326 =over 4
2327
2328 =item Broken systems
2329
2330 =back
2331
2332 =item SEE ALSO
2333
2334 =item HISTORY
2335
2336 =back
2337
2338 =head2 perluniintro - Perl Unicode introduction
2339
2340 =over 4
2341
2342 =item DESCRIPTION
2343
2344 =over 4
2345
2346 =item Unicode
2347
2348 =item Perl's Unicode Support
2349
2350 =item Perl's Unicode Model
2351
2352 =item Unicode and EBCDIC
2353
2354 =item Creating Unicode
2355
2356 =item Handling Unicode
2357
2358 =item Legacy Encodings
2359
2360 =item Unicode I/O
2361
2362 =item Displaying Unicode As Text
2363
2364 =item Special Cases
2365
2366 =item Advanced Topics
2367
2368 =item Miscellaneous
2369
2370 =item Questions With Answers
2371
2372 =item Hexadecimal Notation
2373
2374 =item Further Resources
2375
2376 =back
2377
2378 =item UNICODE IN OLDER PERLS
2379
2380 =item SEE ALSO
2381
2382 =item ACKNOWLEDGMENTS
2383
2384 =item AUTHOR, COPYRIGHT, AND LICENSE
2385
2386 =back
2387
2388 =head2 perlunicode - Unicode support in Perl
2389
2390 =over 4
2391
2392 =item DESCRIPTION
2393
2394 =over 4
2395
2396 =item Important Caveats
2397
2398 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
2399 enable UTF-8/UTF-EBCDIC in scripts
2400
2401 =item Byte and Character Semantics
2402
2403 =item Effects of Character Semantics
2404
2405 =item Scripts
2406
2407 =item Blocks
2408
2409 =item User-Defined Character Properties
2410
2411 =item Character Encodings for Input and Output
2412
2413 =item Unicode Regular Expression Support Level
2414
2415 =item Unicode Encodings
2416
2417 =item Security Implications of Unicode
2418
2419 =item Unicode in Perl on EBCDIC
2420
2421 =item Locales
2422
2423 =item When Unicode Does Not Happen
2424
2425 chmod, chmod, chown, chroot, exec, link, mkdir, rename, rmdir, stat,
2426 symlink, truncate, unlink, utime, %ENV, glob (aka the <*>), open, opendir,
2427 sysopen, qx (aka the backtick operator), system, readdir, readlink
2428
2429 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
2430
2431 =item Using Unicode in XS
2432
2433 =back
2434
2435 =item BUGS
2436
2437 =over 4
2438
2439 =item Interaction with Locales
2440
2441 =item Interaction with Extensions
2442
2443 =item Speed
2444
2445 =item Porting code from perl-5.6.X
2446
2447 =back
2448
2449 =item SEE ALSO
2450
2451 =back
2452
2453 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2454
2455 =over 4
2456
2457 =item DESCRIPTION
2458
2459 =item COMMON CHARACTER CODE SETS
2460
2461 =over 4
2462
2463 =item ASCII
2464
2465 =item ISO 8859
2466
2467 =item Latin 1 (ISO 8859-1)
2468
2469 =item EBCDIC
2470
2471 =item 13 variant characters
2472
2473 =item 0037
2474
2475 =item 1047
2476
2477 =item POSIX-BC
2478
2479 =item Unicode code points versus EBCDIC code points
2480
2481 =item Remaining Perl Unicode problems in EBCDIC
2482
2483 =item Unicode and UTF
2484
2485 =item Using Encode
2486
2487 =back
2488
2489 =item SINGLE OCTET TABLES
2490
2491 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2492
2493 =item IDENTIFYING CHARACTER CODE SETS
2494
2495 =item CONVERSIONS
2496
2497 =over 4
2498
2499 =item tr///
2500
2501 =item iconv
2502
2503 =item C RTL
2504
2505 =back
2506
2507 =item OPERATOR DIFFERENCES
2508
2509 =item FUNCTION DIFFERENCES
2510
2511 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2512
2513 =item REGULAR EXPRESSION DIFFERENCES
2514
2515 =item SOCKETS
2516
2517 =item SORTING
2518
2519 =over 4
2520
2521 =item Ignore ASCII vs. EBCDIC sort differences.
2522
2523 =item MONO CASE then sort data.
2524
2525 =item Convert, sort data, then re convert.
2526
2527 =item Perform sorting on one type of machine only.
2528
2529 =back
2530
2531 =item TRANSFORMATION FORMATS
2532
2533 =over 4
2534
2535 =item URL decoding and encoding
2536
2537 =item uu encoding and decoding
2538
2539 =item Quoted-Printable encoding and decoding
2540
2541 =item Caesarian ciphers
2542
2543 =back
2544
2545 =item Hashing order and checksums
2546
2547 =item I18N AND L10N
2548
2549 =item MULTI OCTET CHARACTER SETS
2550
2551 =item OS ISSUES
2552
2553 =over 4
2554
2555 =item OS/400
2556
2557 PASE, IFS access
2558
2559 =item OS/390, z/OS
2560
2561 chcp, dataset access, OS/390, z/OS iconv, locales
2562
2563 =item VM/ESA?
2564
2565 =item POSIX-BC?
2566
2567 =back
2568
2569 =item BUGS
2570
2571 =item SEE ALSO
2572
2573 =item REFERENCES
2574
2575 =item HISTORY
2576
2577 =item AUTHOR
2578
2579 =back
2580
2581 =head2 perlsec - Perl security
2582
2583 =over 4
2584
2585 =item DESCRIPTION
2586
2587 =over 4
2588
2589 =item Laundering and Detecting Tainted Data
2590
2591 =item Switches On the "#!" Line
2592
2593 =item Cleaning Up Your Path
2594
2595 =item Security Bugs
2596
2597 =item Protecting Your Programs
2598
2599 =item Unicode
2600
2601 =back
2602
2603 =item SEE ALSO
2604
2605 =back
2606
2607 =head2 perlmod - Perl modules (packages and symbol tables)
2608
2609 =over 4
2610
2611 =item DESCRIPTION
2612
2613 =over 4
2614
2615 =item Packages
2616
2617 =item Symbol Tables
2618
2619 =item Package Constructors and Destructors
2620
2621 =item Perl Classes
2622
2623 =item Perl Modules
2624
2625 =item Making your module threadsafe
2626
2627 =back
2628
2629 =item SEE ALSO
2630
2631 =back
2632
2633 =head2 perlmodinstall - Installing CPAN Modules
2634
2635 =over 4
2636
2637 =item DESCRIPTION
2638
2639 =over 4
2640
2641 =item PREAMBLE
2642
2643 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2644 module (sometimes unnecessary), B<INSTALL> the module
2645
2646 =back
2647
2648 =item PORTABILITY
2649
2650 =item HEY
2651
2652 =item AUTHOR
2653
2654 =item COPYRIGHT
2655
2656 =back
2657
2658 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2659
2660 =over 4
2661
2662 =item THE PERL MODULE LIBRARY
2663
2664 =over 4
2665
2666 =item Pragmatic Modules
2667
2668 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
2669 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
2670 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
2671 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
2672 vmsish, warnings, warnings::register
2673
2674 =item Standard Modules
2675
2676 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2677 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2678 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2679 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2680 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2681 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2682 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
2683 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
2684 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
2685 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
2686 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
2687 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
2688 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
2689 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
2690 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
2691 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
2692 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2693 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
2694 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
2695 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2696 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
2697 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
2698 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
2699 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
2700 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
2701 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
2702 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
2703 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
2704 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
2705 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
2706 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
2707 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
2708 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
2709 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
2710 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
2711 Locale::Currency, Locale::Language, Locale::Maketext,
2712 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
2713 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
2714 Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex,
2715 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
2716 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
2717 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
2718 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
2719 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
2720 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
2721 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
2722 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
2723 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
2724 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
2725 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
2726 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
2727 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
2728 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
2729 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
2730 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
2731 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
2732 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
2733 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
2734 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
2735 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
2736 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
2737 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
2738 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
2739 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
2740 XSLoader
2741
2742 =item Extension Modules
2743
2744 =back
2745
2746 =item CPAN
2747
2748 =over 4
2749
2750 =item Africa
2751
2752 South Africa
2753
2754 =item Asia
2755
2756 China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian
2757 Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand
2758
2759 =item Central America
2760
2761 Costa Rica
2762
2763 =item Europe
2764
2765 Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia,
2766 Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
2767 Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia,
2768 Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United
2769 Kingdom
2770
2771 =item North America
2772
2773 Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico
2774
2775 =item United States
2776
2777 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
2778 Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York,
2779 North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
2780 Utah, Virginia, ashington, Wisconsin
2781
2782 =item Oceania
2783
2784 Australia, New Zealand
2785
2786 =item South America
2787
2788 Argentina, Brazil, Chile
2789
2790 =item RSYNC Mirrors
2791
2792 =back
2793
2794 =item Modules: Creation, Use, and Abuse
2795
2796 =over 4
2797
2798 =item Guidelines for Module Creation
2799
2800 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2801
2802 =item Guidelines for Reusing Application Code
2803
2804 =back
2805
2806 =item NOTE
2807
2808 =back
2809
2810 =head2 perlmodstyle - Perl module style guide
2811
2812 =over 4
2813
2814 =item INTRODUCTION
2815
2816 =item QUICK CHECKLIST
2817
2818 =over 4
2819
2820 =item Before you start
2821
2822 =item The API
2823
2824 =item Stability
2825
2826 =item Documentation
2827
2828 =item Release considerations
2829
2830 =back
2831
2832 =item BEFORE YOU START WRITING A MODULE
2833
2834 =over 4
2835
2836 =item Has it been done before?
2837
2838 =item Do one thing and do it well
2839
2840 =item What's in a name?
2841
2842 =back
2843
2844 =item DESIGNING AND WRITING YOUR MODULE
2845
2846 =over 4
2847
2848 =item To OO or not to OO?
2849
2850 =item Designing your API
2851
2852 Write simple routines to do simple things, Separate functionality from
2853 output, Provide sensible shortcuts and defaults, Naming conventions,
2854 Parameter passing
2855
2856 =item Strictness and warnings
2857
2858 =item Backwards compatibility
2859
2860 =item Error handling and messages
2861
2862 =back
2863
2864 =item DOCUMENTING YOUR MODULE
2865
2866 =over 4
2867
2868 =item POD
2869
2870 =item README, INSTALL, release notes, changelogs
2871
2872 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
2873 perl Build test, perl Build install
2874
2875 =back
2876
2877 =item RELEASE CONSIDERATIONS
2878
2879 =over 4
2880
2881 =item Version numbering
2882
2883 =item Pre-requisites
2884
2885 =item Testing
2886
2887 =item Packaging
2888
2889 =item Licensing
2890
2891 =back
2892
2893 =item COMMON PITFALLS
2894
2895 =over 4
2896
2897 =item Reinventing the wheel
2898
2899 =item Trying to do too much
2900
2901 =item Inappropriate documentation
2902
2903 =back
2904
2905 =item SEE ALSO
2906
2907 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
2908 Testing tools, http://pause.perl.org/, Any good book on software
2909 engineering
2910
2911 =item AUTHOR
2912
2913 =back
2914
2915 =head2 perlnewmod - preparing a new module for distribution
2916
2917 =over 4
2918
2919 =item DESCRIPTION
2920
2921 =over 4
2922
2923 =item Warning
2924
2925 =item What should I make into a module?
2926
2927 =item Step-by-step: Preparing the ground
2928
2929 Look around, Check it's new, Discuss the need, Choose a name, Check again
2930
2931 =item Step-by-step: Making the module
2932
2933 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2934 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2935 documentation|perlpod>, Write tests, Write the README
2936
2937 =item Step-by-step: Distributing your module
2938
2939 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2940 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2941
2942 =back
2943
2944 =item AUTHOR
2945
2946 =item SEE ALSO
2947
2948 =back
2949
2950 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.11 $, $Date:
2951 2002/12/06 07:40:11 $)
2952
2953 =over 4
2954
2955 =item DESCRIPTION
2956
2957 =over 4
2958
2959 =item What is Perl?
2960
2961 =item Who supports Perl?  Who develops it?  Why is it free?
2962
2963 =item Which version of Perl should I use?
2964
2965 =item What are perl4 and perl5?
2966
2967 =item What is perl6?
2968
2969 =item How stable is Perl?
2970
2971 =item Is Perl difficult to learn?
2972
2973 =item How does Perl compare with other languages like Java, Python, REXX,
2974 Scheme, or Tcl?
2975
2976 =item Can I do [task] in Perl?
2977
2978 =item When shouldn't I program in Perl?
2979
2980 =item What's the difference between "perl" and "Perl"?
2981
2982 =item Is it a Perl program or a Perl script?
2983
2984 =item What is a JAPH?
2985
2986 =item Where can I get a list of Larry Wall witticisms?
2987
2988 =item How can I convince my sysadmin/supervisor/employees to use version
2989 5/5.6.1/Perl instead of some other language?
2990
2991 =back
2992
2993 =item AUTHOR AND COPYRIGHT
2994
2995 =back
2996
2997 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $,
2998 $Date: 2003/01/26 17:50:56 $)
2999
3000 =over 4
3001
3002 =item DESCRIPTION
3003
3004 =over 4
3005
3006 =item What machines support Perl?  Where do I get it?
3007
3008 =item How can I get a binary version of Perl?
3009
3010 =item I don't have a C compiler on my system.  How can I compile perl?
3011
3012 =item I copied the Perl binary from one machine to another, but scripts
3013 don't work.
3014
3015 =item I grabbed the sources and tried to compile but gdbm/dynamic
3016 loading/malloc/linking/... failed.  How do I make it work?
3017
3018 =item What modules and extensions are available for Perl?  What is CPAN?
3019 What does CPAN/src/... mean?
3020
3021 =item Is there an ISO or ANSI certified version of Perl?
3022
3023 =item Where can I get information on Perl?
3024
3025 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
3026
3027 =item Where should I post source code?
3028
3029 =item Perl Books
3030
3031 References, Tutorials, Task-Oriented, Special Topics
3032
3033 =item Perl in Magazines
3034
3035 =item Perl on the Net: FTP and WWW Access
3036
3037 =item What mailing lists are there for Perl?
3038
3039 =item Archives of comp.lang.perl.misc
3040
3041 =item Where can I buy a commercial version of Perl?
3042
3043 =item Where do I send bug reports?
3044
3045 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
3046
3047 =back
3048
3049 =item AUTHOR AND COPYRIGHT
3050
3051 =back
3052
3053 =head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31
3054 17:34:56 $)
3055
3056 =over 4
3057
3058 =item DESCRIPTION
3059
3060 =over 4
3061
3062 =item How do I do (anything)?
3063
3064 =item How can I use Perl interactively?
3065
3066 =item Is there a Perl shell?
3067
3068 =item How do I find which modules are installed on my system?
3069
3070 =item How do I debug my Perl programs?
3071
3072 =item How do I profile my Perl programs?
3073
3074 =item How do I cross-reference my Perl programs?
3075
3076 =item Is there a pretty-printer (formatter) for Perl?
3077
3078 =item Is there a ctags for Perl?
3079
3080 =item Is there an IDE or Windows Perl Editor?
3081
3082 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
3083 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
3084 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3085
3086 =item Where can I get Perl macros for vi?
3087
3088 =item Where can I get perl-mode for emacs?
3089
3090 =item How can I use curses with Perl?
3091
3092 =item How can I use X or Tk with Perl?
3093
3094 =item How can I generate simple menus without using CGI or Tk?
3095
3096 =item How can I make my Perl program run faster?
3097
3098 =item How can I make my Perl program take less memory?
3099
3100 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3101 stringification, Pass by reference, Tie large variables to disk
3102
3103 =item Is it safe to return a reference to local or lexical data?
3104
3105 =item How can I free an array or hash so my program shrinks?
3106
3107 =item How can I make my CGI script more efficient?
3108
3109 =item How can I hide the source for my Perl program?
3110
3111 =item How can I compile my Perl program into byte code or C?
3112
3113 =item How can I compile Perl into Java?
3114
3115 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3116
3117 =item Can I write useful Perl programs on the command line?
3118
3119 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3120
3121 =item Where can I learn about CGI or Web programming in Perl?
3122
3123 =item Where can I learn about object-oriented Perl programming?
3124
3125 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3126
3127 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3128 my C program; what am I doing wrong?
3129
3130 =item When I tried to run my script, I got this message. What does it mean?
3131
3132 =item What's MakeMaker?
3133
3134 =back
3135
3136 =item AUTHOR AND COPYRIGHT
3137
3138 =back
3139
3140 =head2 perlfaq4 - Data Manipulation ($Revision: 1.43 $, $Date: 2003/02/23
3141 20:25:09 $)
3142
3143 =over 4
3144
3145 =item DESCRIPTION
3146
3147 =item Data: Numbers
3148
3149 =over 4
3150
3151 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3152 numbers I should be getting (eg, 19.95)?
3153
3154 =item Why isn't my octal data interpreted correctly?
3155
3156 =item Does Perl have a round() function?  What about ceil() and floor()?
3157 Trig functions?
3158
3159 =item How do I convert between numeric representations?
3160
3161 How do I convert hexadecimal into decimal, How do I convert from decimal to
3162 hexadecimal, How do I convert from octal to decimal, How do I convert from
3163 decimal to octal, How do I convert from binary to decimal, How do I convert
3164 from decimal to binary
3165
3166 =item Why doesn't & work the way I want it to?
3167
3168 =item How do I multiply matrices?
3169
3170 =item How do I perform an operation on a series of integers?
3171
3172 =item How can I output Roman numerals?
3173
3174 =item Why aren't my random numbers random?
3175
3176 =item How do I get a random number between X and Y?
3177
3178 =back
3179
3180 =item Data: Dates
3181
3182 =over 4
3183
3184 =item How do I find the day or week of the year?
3185
3186 =item How can I compare two dates and find the difference?
3187
3188 =item How can I take a string and turn it into epoch seconds?
3189
3190 =item How can I find the Julian Day?
3191
3192 =item How do I find yesterday's date?
3193
3194 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3195
3196 =back
3197
3198 =item Data: Strings
3199
3200 =over 4
3201
3202 =item How do I validate input?
3203
3204 =item How do I unescape a string?
3205
3206 =item How do I remove consecutive pairs of characters?
3207
3208 =item How do I expand function calls in a string?
3209
3210 =item How do I find matching/nesting anything?
3211
3212 =item How do I reverse a string?
3213
3214 =item How do I expand tabs in a string?
3215
3216 =item How do I reformat a paragraph?
3217
3218 =item How can I access or change N characters of a string?
3219
3220 =item How do I change the Nth occurrence of something?
3221
3222 =item How can I count the number of occurrences of a substring within a
3223 string?
3224
3225 =item How do I capitalize all the words on one line?
3226
3227 =item How can I split a [character] delimited string except when inside
3228 [character]?
3229
3230 =item How do I strip blank space from the beginning/end of a string?
3231
3232 =item How do I pad a string with blanks or pad a number with zeroes?
3233
3234 =item How do I extract selected columns from a string?
3235
3236 =item How do I find the soundex value of a string?
3237
3238 =item How can I expand variables in text strings?
3239
3240 =item What's wrong with always quoting "$vars"?
3241
3242 =item Why don't my E<lt>E<lt>HERE documents work?
3243
3244 There must be no space after the E<lt>E<lt> part, There (probably) should
3245 be a semicolon at the end, You can't (easily) have any space in front of
3246 the tag
3247
3248 =back
3249
3250 =item Data: Arrays
3251
3252 =over 4
3253
3254 =item What is the difference between a list and an array?
3255
3256 =item What is the difference between $array[1] and @array[1]?
3257
3258 =item How can I remove duplicate elements from a list or array?
3259
3260 a), b), c), d), e)
3261
3262 =item How can I tell whether a certain element is contained in a list or
3263 array?
3264
3265 =item How do I compute the difference of two arrays?  How do I compute the
3266 intersection of two arrays?
3267
3268 =item How do I test whether two arrays or hashes are equal?
3269
3270 =item How do I find the first array element for which a condition is true?
3271
3272 =item How do I handle linked lists?
3273
3274 =item How do I handle circular lists?
3275
3276 =item How do I shuffle an array randomly?
3277
3278 =item How do I process/modify each element of an array?
3279
3280 =item How do I select a random element from an array?
3281
3282 =item How do I permute N elements of a list?
3283
3284 =item How do I sort an array by (anything)?
3285
3286 =item How do I manipulate arrays of bits?
3287
3288 =item Why does defined() return true on empty arrays and hashes?
3289
3290 =back
3291
3292 =item Data: Hashes (Associative Arrays)
3293
3294 =over 4
3295
3296 =item How do I process an entire hash?
3297
3298 =item What happens if I add or remove keys from a hash while iterating over
3299 it?
3300
3301 =item How do I look up a hash element by value?
3302
3303 =item How can I know how many entries are in a hash?
3304
3305 =item How do I sort a hash (optionally by value instead of key)?
3306
3307 =item How can I always keep my hash sorted?
3308
3309 =item What's the difference between "delete" and "undef" with hashes?
3310
3311 =item Why don't my tied hashes make the defined/exists distinction?
3312
3313 =item How do I reset an each() operation part-way through?
3314
3315 =item How can I get the unique keys from two hashes?
3316
3317 =item How can I store a multidimensional array in a DBM file?
3318
3319 =item How can I make my hash remember the order I put elements into it?
3320
3321 =item Why does passing a subroutine an undefined element in a hash create
3322 it?
3323
3324 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3325 array of hashes or arrays?
3326
3327 =item How can I use a reference as a hash key?
3328
3329 =back
3330
3331 =item Data: Misc
3332
3333 =over 4
3334
3335 =item How do I handle binary data correctly?
3336
3337 =item How do I determine whether a scalar is a number/whole/integer/float?
3338
3339 =item How do I keep persistent data across program calls?
3340
3341 =item How do I print out or copy a recursive data structure?
3342
3343 =item How do I define methods for every class/object?
3344
3345 =item How do I verify a credit card checksum?
3346
3347 =item How do I pack arrays of doubles or floats for XS code?
3348
3349 =back
3350
3351 =item AUTHOR AND COPYRIGHT
3352
3353 =back
3354
3355 =head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
3356 17:45:46 $)
3357
3358 =over 4
3359
3360 =item DESCRIPTION
3361
3362 =over 4
3363
3364 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3365
3366 =item How do I change one line in a file/delete a line in a file/insert a
3367 line in the middle of a file/append to the beginning of a file?
3368
3369 =item How do I count the number of lines in a file?
3370
3371 =item How can I use Perl's C<-i> option from within a program?
3372
3373 =item How do I make a temporary file name?
3374
3375 =item How can I manipulate fixed-record-length files?
3376
3377 =item How can I make a filehandle local to a subroutine?  How do I pass
3378 filehandles between subroutines?  How do I make an array of filehandles?
3379
3380 =item How can I use a filehandle indirectly?
3381
3382 =item How can I set up a footer format to be used with write()?
3383
3384 =item How can I write() into a string?
3385
3386 =item How can I output my numbers with commas added?
3387
3388 =item How can I translate tildes (~) in a filename?
3389
3390 =item How come when I open a file read-write it wipes it out?
3391
3392 =item Why do I sometimes get an "Argument list too long" when I use
3393 E<lt>*E<gt>?
3394
3395 =item Is there a leak/bug in glob()?
3396
3397 =item How can I open a file with a leading ">" or trailing blanks?
3398
3399 =item How can I reliably rename a file?
3400
3401 =item How can I lock a file?
3402
3403 =item Why can't I just open(FH, "E<gt>file.lock")?
3404
3405 =item I still don't get locking.  I just want to increment the number in
3406 the file.  How can I do this?
3407
3408 =item All I want to do is append a small amount of text to the end of a
3409 file.  Do I still have to use locking?
3410
3411 =item How do I randomly update a binary file?
3412
3413 =item How do I get a file's timestamp in perl?
3414
3415 =item How do I set a file's timestamp in perl?
3416
3417 =item How do I print to more than one file at once?
3418
3419 =item How can I read in an entire file all at once?
3420
3421 =item How can I read in a file by paragraphs?
3422
3423 =item How can I read a single character from a file?  From the keyboard?
3424
3425 =item How can I tell whether there's a character waiting on a filehandle?
3426
3427 =item How do I do a C<tail -f> in perl?
3428
3429 =item How do I dup() a filehandle in Perl?
3430
3431 =item How do I close a file descriptor by number?
3432
3433 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3434 `C:\temp\foo.exe` work?
3435
3436 =item Why doesn't glob("*.*") get all the files?
3437
3438 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3439 protected files?  Isn't this a bug in Perl?
3440
3441 =item How do I select a random line from a file?
3442
3443 =item Why do I get weird spaces when I print an array of lines?
3444
3445 =back
3446
3447 =item AUTHOR AND COPYRIGHT
3448
3449 =back
3450
3451 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
3452 20:05:28 $)
3453
3454 =over 4
3455
3456 =item DESCRIPTION
3457
3458 =over 4
3459
3460 =item How can I hope to use regular expressions without creating illegible
3461 and unmaintainable code?
3462
3463 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3464
3465 =item I'm having trouble matching over more than one line.  What's wrong?
3466
3467 =item How can I pull out lines between two patterns that are themselves on
3468 different lines?
3469
3470 =item I put a regular expression into $/ but it didn't work. What's wrong?
3471
3472 =item How do I substitute case insensitively on the LHS while preserving
3473 case on the RHS?
3474
3475 =item How can I make C<\w> match national character sets?
3476
3477 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3478
3479 =item How can I quote a variable to use in a regex?
3480
3481 =item What is C</o> really for?
3482
3483 =item How do I use a regular expression to strip C style comments from a
3484 file?
3485
3486 =item Can I use Perl regular expressions to match balanced text?
3487
3488 =item What does it mean that regexes are greedy?  How can I get around it?
3489
3490 =item How do I process each word on each line?
3491
3492 =item How can I print out a word-frequency or line-frequency summary?
3493
3494 =item How can I do approximate matching?
3495
3496 =item How do I efficiently match many regular expressions at once?
3497
3498 =item Why don't word-boundary searches with C<\b> work for me?
3499
3500 =item Why does using $&, $`, or $' slow my program down?
3501
3502 =item What good is C<\G> in a regular expression?
3503
3504 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3505
3506 =item What's wrong with using grep or map in a void context?
3507
3508 =item How can I match strings with multibyte characters?
3509
3510 =item How do I match a pattern that is supplied by the user?
3511
3512 =back
3513
3514 =item AUTHOR AND COPYRIGHT
3515
3516 =back
3517
3518 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.14 $, $Date:
3519 2003/01/31 17:38:14 $)
3520
3521 =over 4
3522
3523 =item DESCRIPTION
3524
3525 =over 4
3526
3527 =item Can I get a BNF/yacc/RE for the Perl language?
3528
3529 =item What are all these $@%&* punctuation signs, and how do I know when to
3530 use them?
3531
3532 =item Do I always/never have to quote my strings or use semicolons and
3533 commas?
3534
3535 =item How do I skip some return values?
3536
3537 =item How do I temporarily block warnings?
3538
3539 =item What's an extension?
3540
3541 =item Why do Perl operators have different precedence than C operators?
3542
3543 =item How do I declare/create a structure?
3544
3545 =item How do I create a module?
3546
3547 =item How do I create a class?
3548
3549 =item How can I tell if a variable is tainted?
3550
3551 =item What's a closure?
3552
3553 =item What is variable suicide and how can I prevent it?
3554
3555 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3556 Regex}?
3557
3558 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3559 Passing Methods
3560
3561 =item How do I create a static variable?
3562
3563 =item What's the difference between dynamic and lexical (static) scoping?
3564 Between local() and my()?
3565
3566 =item How can I access a dynamic variable while a similarly named lexical
3567 is in scope?
3568
3569 =item What's the difference between deep and shallow binding?
3570
3571 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
3572
3573 =item How do I redefine a builtin function, operator, or method?
3574
3575 =item What's the difference between calling a function as &foo and foo()?
3576
3577 =item How do I create a switch or case statement?
3578
3579 =item How can I catch accesses to undefined variables, functions, or
3580 methods?
3581
3582 =item Why can't a method included in this same file be found?
3583
3584 =item How can I find out my current package?
3585
3586 =item How can I comment out a large block of perl code?
3587
3588 =item How do I clear a package?
3589
3590 =item How can I use a variable as a variable name?
3591
3592 =item What does "bad interpreter" mean?
3593
3594 =back
3595
3596 =item AUTHOR AND COPYRIGHT
3597
3598 =back
3599
3600 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
3601 17:44:04 $)
3602
3603 =over 4
3604
3605 =item DESCRIPTION
3606
3607 =over 4
3608
3609 =item How do I find out which operating system I'm running under?
3610
3611 =item How come exec() doesn't return?
3612
3613 =item How do I do fancy stuff with the keyboard/screen/mouse?
3614
3615 Keyboard, Screen, Mouse
3616
3617 =item How do I print something out in color?
3618
3619 =item How do I read just one key without waiting for a return key?
3620
3621 =item How do I check whether input is ready on the keyboard?
3622
3623 =item How do I clear the screen?
3624
3625 =item How do I get the screen size?
3626
3627 =item How do I ask the user for a password?
3628
3629 =item How do I read and write the serial port?
3630
3631 lockfiles, open mode, end of line, flushing output, non-blocking input
3632
3633 =item How do I decode encrypted password files?
3634
3635 =item How do I start a process in the background?
3636
3637 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3638
3639 =item How do I trap control characters/signals?
3640
3641 =item How do I modify the shadow password file on a Unix system?
3642
3643 =item How do I set the time and date?
3644
3645 =item How can I sleep() or alarm() for under a second?
3646
3647 =item How can I measure time under a second?
3648
3649 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3650
3651 =item Why doesn't my sockets program work under System V (Solaris)?  What
3652 does the error message "Protocol not supported" mean?
3653
3654 =item How can I call my system's unique C functions from Perl?
3655
3656 =item Where do I get the include files to do ioctl() or syscall()?
3657
3658 =item Why do setuid perl scripts complain about kernel problems?
3659
3660 =item How can I open a pipe both to and from a command?
3661
3662 =item Why can't I get the output of a command with system()?
3663
3664 =item How can I capture STDERR from an external command?
3665
3666 =item Why doesn't open() return an error when a pipe open fails?
3667
3668 =item What's wrong with using backticks in a void context?
3669
3670 =item How can I call backticks without shell processing?
3671
3672 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3673 ^Z on MS-DOS)?
3674
3675 =item How can I convert my shell script to perl?
3676
3677 =item Can I use perl to run a telnet or ftp session?
3678
3679 =item How can I write expect in Perl?
3680
3681 =item Is there a way to hide perl's command line from programs such as
3682 "ps"?
3683
3684 =item I {changed directory, modified my environment} in a perl script.  How
3685 come the change disappeared when I exited the script?  How do I get my
3686 changes to be visible?
3687
3688 Unix
3689
3690 =item How do I close a process's filehandle without waiting for it to
3691 complete?
3692
3693 =item How do I fork a daemon process?
3694
3695 =item How do I find out if I'm running interactively or not?
3696
3697 =item How do I timeout a slow event?
3698
3699 =item How do I set CPU limits?
3700
3701 =item How do I avoid zombies on a Unix system?
3702
3703 =item How do I use an SQL database?
3704
3705 =item How do I make a system() exit on control-C?
3706
3707 =item How do I open a file without blocking?
3708
3709 =item How do I install a module from CPAN?
3710
3711 =item What's the difference between require and use?
3712
3713 =item How do I keep my own module/library directory?
3714
3715 =item How do I add the directory my program lives in to the module/library
3716 search path?
3717
3718 =item How do I add a directory to my include path at runtime?
3719
3720 =item What is socket.ph and where do I get it?
3721
3722 =back
3723
3724 =item AUTHOR AND COPYRIGHT
3725
3726 =back
3727
3728 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
3729 $)
3730
3731 =over 4
3732
3733 =item DESCRIPTION
3734
3735 =over 4
3736
3737 =item What is the correct form of response from a CGI script?
3738
3739 =item My CGI script runs from the command line but not the browser.  (500
3740 Server Error)
3741
3742 =item How can I get better error messages from a CGI program?
3743
3744 =item How do I remove HTML from a string?
3745
3746 =item How do I extract URLs?
3747
3748 =item How do I download a file from the user's machine?  How do I open a
3749 file on another machine?
3750
3751 =item How do I make a pop-up menu in HTML?
3752
3753 =item How do I fetch an HTML file?
3754
3755 =item How do I automate an HTML form submission?
3756
3757 =item How do I decode or create those %-encodings on the web?
3758
3759 =item How do I redirect to another page?
3760
3761 =item How do I put a password on my web pages?
3762
3763 =item How do I edit my .htpasswd and .htgroup files with Perl?
3764
3765 =item How do I make sure users can't enter values into a form that cause my
3766 CGI script to do bad things?
3767
3768 =item How do I parse a mail header?
3769
3770 =item How do I decode a CGI form?
3771
3772 =item How do I check a valid mail address?
3773
3774 =item How do I decode a MIME/BASE64 string?
3775
3776 =item How do I return the user's mail address?
3777
3778 =item How do I send mail?
3779
3780 =item How do I use MIME to make an attachment to a mail message?
3781
3782 =item How do I read mail?
3783
3784 =item How do I find out my hostname/domainname/IP address?
3785
3786 =item How do I fetch a news article or the active newsgroups?
3787
3788 =item How do I fetch/put an FTP file?
3789
3790 =item How can I do RPC in Perl?
3791
3792 =back
3793
3794 =item AUTHOR AND COPYRIGHT
3795
3796 =back
3797
3798 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3799
3800 =over 4
3801
3802 =item DESCRIPTION
3803
3804 =over 4
3805
3806 =item Layout
3807
3808 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3809
3810 =back
3811
3812 =item Using The Back Ends
3813
3814 =over 4
3815
3816 =item The Cross Referencing Back End
3817
3818 i, &, s, r
3819
3820 =item The Decompiling Back End
3821
3822 =item The Lint Back End
3823
3824 =item The Simple C Back End
3825
3826 =item The Bytecode Back End
3827
3828 =item The Optimized C Back End
3829
3830 =back
3831
3832 =item Module List for the Compiler Suite
3833
3834 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3835 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3836 B::Stackobj, B::Stash, B::Terse, B::Xref
3837
3838 =item KNOWN PROBLEMS
3839
3840 =item AUTHOR
3841
3842 =back
3843
3844 =head2 perlembed - how to embed perl in your C program
3845
3846 =over 4
3847
3848 =item DESCRIPTION
3849
3850 =over 4
3851
3852 =item PREAMBLE
3853
3854 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3855 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3856
3857 =item ROADMAP
3858
3859 =item Compiling your C program
3860
3861 =item Adding a Perl interpreter to your C program
3862
3863 =item Calling a Perl subroutine from your C program
3864
3865 =item Evaluating a Perl statement from your C program
3866
3867 =item Performing Perl pattern matches and substitutions from your C program
3868
3869 =item Fiddling with the Perl stack from your C program
3870
3871 =item Maintaining a persistent interpreter
3872
3873 =item Execution of END blocks
3874
3875 =item Maintaining multiple interpreter instances
3876
3877 =item Using Perl modules, which themselves use C libraries, from your C
3878 program
3879
3880 =back
3881
3882 =item Embedding Perl under Win32
3883
3884 =item Hiding Perl_
3885
3886 =item MORAL
3887
3888 =item AUTHOR
3889
3890 =item COPYRIGHT
3891
3892 =back
3893
3894 =head2 perldebguts - Guts of Perl debugging
3895
3896 =over 4
3897
3898 =item DESCRIPTION
3899
3900 =item Debugger Internals
3901
3902 =over 4
3903
3904 =item Writing Your Own Debugger
3905
3906 =back
3907
3908 =item Frame Listing Output Examples
3909
3910 =item Debugging regular expressions
3911
3912 =over 4
3913
3914 =item Compile-time output
3915
3916 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3917 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3918 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3919 C<anchored(TYPE)>
3920
3921 =item Types of nodes
3922
3923 =item Run-time output
3924
3925 =back
3926
3927 =item Debugging Perl memory usage
3928
3929 =over 4
3930
3931 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3932
3933 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3934 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3935 6144>
3936
3937 =item Example of using B<-DL> switch
3938
3939 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3940
3941 =item B<-DL> details
3942
3943 C<!!!>, C<!!>, C<!>
3944
3945 =item Limitations of B<-DL> statistics
3946
3947 =back
3948
3949 =item SEE ALSO
3950
3951 =back
3952
3953 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3954
3955 =over 4
3956
3957 =item DESCRIPTION
3958
3959 =item SPECIAL NOTES
3960
3961 =over 4
3962
3963 =item make
3964
3965 =item Version caveat
3966
3967 =item Dynamic Loading versus Static Loading
3968
3969 =back
3970
3971 =item TUTORIAL
3972
3973 =over 4
3974
3975 =item EXAMPLE 1
3976
3977 =item EXAMPLE 2
3978
3979 =item What has gone on?
3980
3981 =item Writing good test scripts
3982
3983 =item EXAMPLE 3
3984
3985 =item What's new here?
3986
3987 =item Input and Output Parameters
3988
3989 =item The XSUBPP Program
3990
3991 =item The TYPEMAP file
3992
3993 =item Warning about Output Arguments
3994
3995 =item EXAMPLE 4
3996
3997 =item What has happened here?
3998
3999 =item Anatomy of .xs file
4000
4001 =item Getting the fat out of XSUBs
4002
4003 =item More about XSUB arguments
4004
4005 =item The Argument Stack
4006
4007 =item Extending your Extension
4008
4009 =item Documenting your Extension
4010
4011 =item Installing your Extension
4012
4013 =item EXAMPLE 5
4014
4015 =item New Things in this Example
4016
4017 =item EXAMPLE 6
4018
4019 =item New Things in this Example
4020
4021 =item EXAMPLE 7 (Coming Soon)
4022
4023 =item EXAMPLE 8 (Coming Soon)
4024
4025 =item EXAMPLE 9 Passing open files to XSes
4026
4027 =item Troubleshooting these Examples
4028
4029 =back
4030
4031 =item See also
4032
4033 =item Author
4034
4035 =over 4
4036
4037 =item Last Changed
4038
4039 =back
4040
4041 =back
4042
4043 =head2 perlxs - XS language reference manual
4044
4045 =over 4
4046
4047 =item DESCRIPTION
4048
4049 =over 4
4050
4051 =item Introduction
4052
4053 =item On The Road
4054
4055 =item The Anatomy of an XSUB
4056
4057 =item The Argument Stack
4058
4059 =item The RETVAL Variable
4060
4061 =item The MODULE Keyword
4062
4063 =item The PACKAGE Keyword
4064
4065 =item The PREFIX Keyword
4066
4067 =item The OUTPUT: Keyword
4068
4069 =item The NO_OUTPUT Keyword
4070
4071 =item The CODE: Keyword
4072
4073 =item The INIT: Keyword
4074
4075 =item The NO_INIT Keyword
4076
4077 =item Initializing Function Parameters
4078
4079 =item Default Parameter Values
4080
4081 =item The PREINIT: Keyword
4082
4083 =item The SCOPE: Keyword
4084
4085 =item The INPUT: Keyword
4086
4087 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4088
4089 =item The C<length(NAME)> Keyword
4090
4091 =item Variable-length Parameter Lists
4092
4093 =item The C_ARGS: Keyword
4094
4095 =item The PPCODE: Keyword
4096
4097 =item Returning Undef And Empty Lists
4098
4099 =item The REQUIRE: Keyword
4100
4101 =item The CLEANUP: Keyword
4102
4103 =item The POSTCALL: Keyword
4104
4105 =item The BOOT: Keyword
4106
4107 =item The VERSIONCHECK: Keyword
4108
4109 =item The PROTOTYPES: Keyword
4110
4111 =item The PROTOTYPE: Keyword
4112
4113 =item The ALIAS: Keyword
4114
4115 =item The OVERLOAD: Keyword
4116
4117 =item The FALLBACK: Keyword
4118
4119 =item The INTERFACE: Keyword
4120
4121 =item The INTERFACE_MACRO: Keyword
4122
4123 =item The INCLUDE: Keyword
4124
4125 =item The CASE: Keyword
4126
4127 =item The & Unary Operator
4128
4129 =item Inserting POD, Comments and C Preprocessor Directives
4130
4131 =item Using XS With C++
4132
4133 =item Interface Strategy
4134
4135 =item Perl Objects And C Structures
4136
4137 =item The Typemap
4138
4139 =item Safely Storing Static Data in XS
4140
4141 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4142
4143 =back
4144
4145 =item EXAMPLES
4146
4147 =item XS VERSION
4148
4149 =item AUTHOR
4150
4151 =back
4152
4153 =head2 perlclib - Internal replacements for standard C library functions
4154
4155 =over 4
4156
4157 =item DESCRIPTION
4158
4159 =over 4
4160
4161 =item Conventions
4162
4163 C<t>, C<p>, C<n>, C<s>
4164
4165 =item File Operations
4166
4167 =item File Input and Output
4168
4169 =item File Positioning
4170
4171 =item Memory Management and String Handling
4172
4173 =item Character Class Tests
4174
4175 =item F<stdlib.h> functions
4176
4177 =item Miscellaneous functions
4178
4179 =back
4180
4181 =item SEE ALSO
4182
4183 =back
4184
4185 =head2 perlguts - Introduction to the Perl API
4186
4187 =over 4
4188
4189 =item DESCRIPTION
4190
4191 =item Variables
4192
4193 =over 4
4194
4195 =item Datatypes
4196
4197 =item What is an "IV"?
4198
4199 =item Working with SVs
4200
4201 =item Offsets
4202
4203 =item What's Really Stored in an SV?
4204
4205 =item Working with AVs
4206
4207 =item Working with HVs
4208
4209 =item Hash API Extensions
4210
4211 =item References
4212
4213 =item Blessed References and Class Objects
4214
4215 =item Creating New Variables
4216
4217 GV_ADDMULTI, GV_ADDWARN
4218
4219 =item Reference Counts and Mortality
4220
4221 =item Stashes and Globs
4222
4223 =item Double-Typed SVs
4224
4225 =item Magic Variables
4226
4227 =item Assigning Magic
4228
4229 =item Magic Virtual Tables
4230
4231 =item Finding Magic
4232
4233 =item Understanding the Magic of Tied Hashes and Arrays
4234
4235 =item Localizing changes
4236
4237 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4238 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4239 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4240 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4241 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4242 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4243 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4244 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4245 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4246 save_hptr(HV **hptr)>
4247
4248 =back
4249
4250 =item Subroutines
4251
4252 =over 4
4253
4254 =item XSUBs and the Argument Stack
4255
4256 =item Calling Perl Routines from within C Programs
4257
4258 =item Memory Allocation
4259
4260 =item PerlIO
4261
4262 =item Putting a C value on Perl stack
4263
4264 =item Scratchpads
4265
4266 =item Scratchpads and recursion
4267
4268 =back
4269
4270 =item Compiled code
4271
4272 =over 4
4273
4274 =item Code tree
4275
4276 =item Examining the tree
4277
4278 =item Compile pass 1: check routines
4279
4280 =item Compile pass 1a: constant folding
4281
4282 =item Compile pass 2: context propagation
4283
4284 =item Compile pass 3: peephole optimization
4285
4286 =item Pluggable runops
4287
4288 =back
4289
4290 =item Examining internal data structures with the C<dump> functions
4291
4292 =item How multiple interpreters and concurrency are supported
4293
4294 =over 4
4295
4296 =item Background and PERL_IMPLICIT_CONTEXT
4297
4298 =item So what happened to dTHR?
4299
4300 =item How do I use all this in extensions?
4301
4302 =item Should I do anything special if I call perl from multiple threads?
4303
4304 =item Future Plans and PERL_IMPLICIT_SYS
4305
4306 =back
4307
4308 =item Internal Functions
4309
4310 A, p, d, s, n, r, f, M, o, j, x
4311
4312 =over 4
4313
4314 =item Formatted Printing of IVs, UVs, and NVs
4315
4316 =item Pointer-To-Integer and Integer-To-Pointer
4317
4318 =item Source Documentation
4319
4320 =back
4321
4322 =item Unicode Support
4323
4324 =over 4
4325
4326 =item What B<is> Unicode, anyway?
4327
4328 =item How can I recognise a UTF8 string?
4329
4330 =item How does UTF8 represent Unicode characters?
4331
4332 =item How does Perl store UTF8 strings?
4333
4334 =item How do I convert a string to UTF8?
4335
4336 =item Is there anything else I need to know?
4337
4338 =back
4339
4340 =item Custom Operators
4341
4342 =item AUTHORS
4343
4344 =item SEE ALSO
4345
4346 =back
4347
4348 =head2 perlcall - Perl calling conventions from C
4349
4350 =over 4
4351
4352 =item DESCRIPTION
4353
4354 An Error Handler, An Event Driven Program
4355
4356 =item THE CALL_ FUNCTIONS
4357
4358 call_sv, call_pv, call_method, call_argv
4359
4360 =item FLAG VALUES
4361
4362 =over 4
4363
4364 =item  G_VOID
4365
4366 =item  G_SCALAR
4367
4368 =item G_ARRAY
4369
4370 =item G_DISCARD
4371
4372 =item G_NOARGS
4373
4374 =item G_EVAL
4375
4376 =item G_KEEPERR
4377
4378 =item Determining the Context
4379
4380 =back
4381
4382 =item KNOWN PROBLEMS
4383
4384 =item EXAMPLES
4385
4386 =over 4
4387
4388 =item No Parameters, Nothing returned
4389
4390 =item Passing Parameters
4391
4392 =item Returning a Scalar
4393
4394 =item Returning a list of values
4395
4396 =item Returning a list in a scalar context
4397
4398 =item Returning Data from Perl via the parameter list
4399
4400 =item Using G_EVAL
4401
4402 =item Using G_KEEPERR
4403
4404 =item Using call_sv
4405
4406 =item Using call_argv
4407
4408 =item Using call_method
4409
4410 =item Using GIMME_V
4411
4412 =item Using Perl to dispose of temporaries
4413
4414 =item Strategies for storing Callback Context Information
4415
4416 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4417 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4418 callback
4419
4420 =item Alternate Stack Manipulation
4421
4422 =item Creating and calling an anonymous subroutine in C
4423
4424 =back
4425
4426 =item SEE ALSO
4427
4428 =item AUTHOR
4429
4430 =item DATE
4431
4432 =back
4433
4434 =head2 perlutil - utilities packaged with the Perl distribution
4435
4436 =over 4
4437
4438 =item DESCRIPTION
4439
4440 =over 4
4441
4442 =item DOCUMENTATION
4443
4444 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4445 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4446 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4447 L<roffitall|roffitall>
4448
4449 =item CONVERTORS
4450
4451 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4452
4453 =item Administration
4454
4455 L<libnetcfg|libnetcfg>
4456
4457 =item Development
4458
4459 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4460 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4461
4462 =item SEE ALSO
4463
4464 =back
4465
4466 =back
4467
4468 =head2 perlfilter - Source Filters
4469
4470 =over 4
4471
4472 =item DESCRIPTION
4473
4474 =item CONCEPTS
4475
4476 =item USING FILTERS
4477
4478 =item WRITING A SOURCE FILTER
4479
4480 =item WRITING A SOURCE FILTER IN C
4481
4482 B<Decryption Filters>
4483
4484 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4485
4486 =item WRITING A SOURCE FILTER IN PERL
4487
4488 =item USING CONTEXT: THE DEBUG FILTER
4489
4490 =item CONCLUSION
4491
4492 =item THINGS TO LOOK OUT FOR
4493
4494 Some Filters Clobber the C<DATA> Handle
4495
4496 =item REQUIREMENTS
4497
4498 =item AUTHOR
4499
4500 =item Copyrights
4501
4502 =back
4503
4504 =head2 perldbmfilter - Perl DBM Filters
4505
4506 =over 4
4507
4508 =item SYNOPSIS
4509
4510 =item DESCRIPTION
4511
4512 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4513 B<filter_fetch_value>
4514
4515 =over 4
4516
4517 =item The Filter
4518
4519 =item An Example -- the NULL termination problem.
4520
4521 =item Another Example -- Key is a C int.
4522
4523 =back
4524
4525 =item SEE ALSO
4526
4527 =item AUTHOR
4528
4529 =back
4530
4531 =head2 perlapi - autogenerated documentation for the perl public API
4532
4533 =over 4
4534
4535 =item DESCRIPTION
4536
4537 =item "Gimme" Values
4538
4539 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4540
4541 =item Array Manipulation Functions
4542
4543 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4544 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4545 get_av, newAV, Nullav, sortsv
4546
4547 =item Callback Functions
4548
4549 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4550 FREETMPS, LEAVE, SAVETMPS
4551
4552 =item Character classes
4553
4554 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4555
4556 =item Cloning an interpreter
4557
4558 perl_clone
4559
4560 =item CV Manipulation Functions
4561
4562 CvSTASH, get_cv, Nullcv
4563
4564 =item Embedding Functions
4565
4566 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4567 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4568
4569 =item Functions in file pp_pack.c
4570
4571 packlist, pack_cat, unpackstring, unpack_str
4572
4573 =item Global Variables
4574
4575 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4576
4577 =item GV Functions
4578
4579 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4580 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4581
4582 =item Handy Values
4583
4584 HEf_SVKEY, Nullch, Nullsv
4585
4586 =item Hash Manipulation Functions
4587
4588 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4589 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4590 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4591 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4592 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4593
4594 =item Magical Functions
4595
4596 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4597 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4598 SvSetSV, SvSetSV_nosteal, SvSHARE
4599
4600 =item Memory Management
4601
4602 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4603 savepv, savepvn, savesharedpv, StructCopy, Zero
4604
4605 =item Miscellaneous Functions
4606
4607 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4608 strNE, strnEQ, strnNE
4609
4610 =item Numeric functions
4611
4612 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4613 scan_hex, scan_oct
4614
4615 =item Optree Manipulation Functions
4616
4617 cv_const_sv, newCONSTSUB, newXS
4618
4619 =item Pad Data Structures
4620
4621 pad_sv
4622
4623 =item Stack Manipulation Macros
4624
4625 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4626 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4627 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4628 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4629 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4630
4631 =item SV Flags
4632
4633 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4634
4635 =item SV Manipulation Functions
4636
4637 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4638 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4639 new_version, scan_version, scan_vstring, SvCUR, SvCUR_set, SvEND, SvGROW,
4640 SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
4641 SvIOK_UV, SvIsCOW, SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK,
4642 SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV,
4643 SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4644 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4645 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4646 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4647 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
4648 SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
4649 SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
4650 SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
4651 sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
4652 sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
4653 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
4654 sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
4655 sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
4656 sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
4657 sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
4658 sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref,
4659 sv_nolocking, sv_nosharing, sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b,
4660 sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force,
4661 sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype,
4662 sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg,
4663 sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
4664 sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
4665 sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv,
4666 sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted,
4667 sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade,
4668 sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
4669 sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn,
4670 upg_version, vcmp, vnumify, vstringify
4671
4672 =item Unicode Support
4673
4674 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4675 pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display,
4676 to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper,
4677 utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
4678 utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4679 uvuni_to_utf8_flags
4680
4681 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4682
4683 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4684 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4685
4686 =item Warning and Dieing
4687
4688 croak, warn
4689
4690 =item AUTHORS
4691
4692 =item SEE ALSO
4693
4694 =back
4695
4696 =head2 perlintern - autogenerated documentation of purely B<internal>
4697                  Perl functions
4698
4699 =over 4
4700
4701 =item DESCRIPTION
4702
4703 =item CV reference counts and CvOUTSIDE
4704
4705 CvWEAKOUTSIDE
4706
4707 =item Functions in file pad.h
4708
4709 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4710 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4711 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4712 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV,
4713 PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4714
4715 =item Functions in file pp_ctl.c
4716
4717 find_runcv
4718
4719 =item Global Variables
4720
4721 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4722 PL_rs
4723
4724 =item GV Functions
4725
4726 is_gv_magical
4727
4728 =item IO Functions
4729
4730 start_glob
4731
4732 =item Pad Data Structures
4733
4734 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4735 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4736 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4737 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4738
4739 =item Stack Manipulation Macros
4740
4741 djSP, LVRET
4742
4743 =item SV Manipulation Functions
4744
4745 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4746
4747 =item AUTHORS
4748
4749 =item SEE ALSO
4750
4751 =back
4752
4753 =head2 perliol - C API for Perl's implementation of IO in Layers.
4754
4755 =over 4
4756
4757 =item SYNOPSIS
4758
4759 =item DESCRIPTION
4760
4761 =over 4
4762
4763 =item History and Background
4764
4765 =item Layers vs Disciplines
4766
4767 =item Data Structures
4768
4769 =item Functions and Attributes
4770
4771 =item Per-instance Data
4772
4773 =item Layers in action.
4774
4775 =item Per-instance flag bits
4776
4777 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4778 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4779 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4780 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4781
4782 =item Methods in Detail
4783
4784 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4785 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4786 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4787 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4788 Set_ptrcnt
4789
4790 =item Implementing PerlIO Layers
4791
4792 =item Core Layers
4793
4794 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4795
4796 =item Extension Layers
4797
4798 ":encoding", ":scalar", ":via"
4799
4800 =back
4801
4802 =item TODO
4803
4804 =back
4805
4806 =head2 perlapio - perl's IO abstraction interface.
4807
4808 =over 4
4809
4810 =item SYNOPSIS
4811
4812 =item DESCRIPTION
4813
4814 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4815 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4816 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4817 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4818 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4819 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4820 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4821 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4822 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4823 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4824 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4825
4826 =over 4
4827
4828 =item Co-existence with stdio
4829
4830 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4831 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4832
4833 =item "Fast gets" Functions
4834
4835 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4836 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4837 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4838 B<PerlIO_get_bufsiz(f)>
4839
4840 =item Other Functions
4841
4842 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4843 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4844
4845 =back
4846
4847 =back
4848
4849 =head2 perltodo - Perl TO-DO List
4850
4851 =over 4
4852
4853 =item DESCRIPTION
4854
4855 =item To do during 5.6.x
4856
4857 =over 4
4858
4859 =item Support for I/O disciplines
4860
4861 =item Autoload bytes.pm
4862
4863 =item Make "\u{XXXX}" et al work
4864
4865 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4866
4867 =item Overloadable regex assertions
4868
4869 =item Unicode
4870
4871 =item Work out exit/die semantics for threads
4872
4873 =item Better support for nonpreemptive threading systems like GNU pth
4874
4875 =item Typed lexicals for compiler
4876
4877 =item Compiler workarounds for Win32
4878
4879 =item AUTOLOADing in the compiler
4880
4881 =item Fixing comppadlist when compiling
4882
4883 =item Cleaning up exported namespace
4884
4885 =item Complete signal handling
4886
4887 =item Out-of-source builds
4888
4889 =item POSIX realtime support
4890
4891 =item UNIX98 support
4892
4893 =item IPv6 Support
4894
4895 =item Long double conversion
4896
4897 =item Locales
4898
4899 =item Arithmetic on non-Arabic numerals
4900
4901 =item POSIX Unicode character classes
4902
4903 =item Factoring out common suffices/prefices in regexps (trie optimization)
4904
4905 =item Security audit shipped utilities
4906
4907 =item Sort out the uid-setting mess
4908
4909 =item Custom opcodes
4910
4911 =item DLL Versioning
4912
4913 =item Introduce @( and @)
4914
4915 =item Floating point handling
4916
4917 =item IV/UV preservation
4918
4919 =item Replace pod2html with something using Pod::Parser
4920
4921 =item Automate module testing on CPAN
4922
4923 =item sendmsg and recvmsg
4924
4925 =item Rewrite perlre documentation
4926
4927 =item Convert example code to IO::Handle filehandles
4928
4929 =item Document Win32 choices
4930
4931 =item Check new modules
4932
4933 =item Make roffitall find pods and libs itself
4934
4935 =back
4936
4937 =item To do at some point
4938
4939 =over 4
4940
4941 =item Remove regular expression recursion
4942
4943 =item Memory leaks after failed eval
4944
4945 =item bitfields in pack
4946
4947 =item Cross compilation
4948
4949 =item Perl preprocessor / macros
4950
4951 =item Perl lexer in Perl
4952
4953 =item Using POSIX calls internally
4954
4955 =item -i rename file when changed
4956
4957 =item All ARGV input should act like E<lt>E<gt>
4958
4959 =item Support for rerunning debugger
4960
4961 =item Test Suite for the Debugger
4962
4963 =item my sub foo { }
4964
4965 =item One-pass global destruction
4966
4967 =item Rewrite regexp parser
4968
4969 =item Cache recently used regexps
4970
4971 =item Cross-compilation support
4972
4973 =item Bit-shifting bitvectors
4974
4975 =item debugger pragma
4976
4977 =item use less pragma
4978
4979 =item switch structures
4980
4981 =item Cache eval tree
4982
4983 =item rcatmaybe
4984
4985 =item Shrink opcode tables
4986
4987 =item Optimize away @_
4988
4989 =item Prototypes versus indirect objects
4990
4991 =item Install HTML
4992
4993 =item Prototype method calls
4994
4995 =item Return context prototype declarations
4996
4997 =item magic_setisa
4998
4999 =item Garbage collection
5000
5001 =item IO tutorial
5002
5003 =item Rewrite perldoc
5004
5005 =item Install .3p manpages
5006
5007 =item Unicode tutorial
5008
5009 =item Update POSIX.pm for 1003.1-2
5010
5011 =item Retargetable installation
5012
5013 =item POSIX emulation on non-POSIX systems
5014
5015 =item Rename Win32 headers
5016
5017 =item Finish off lvalue functions
5018
5019 =item Update sprintf documentation
5020
5021 =item Use fchown/fchmod internally
5022
5023 =item Make v-strings overloaded objects
5024
5025 =item Allow restricted hash assignment
5026
5027 =item Should overload be inheritable?
5028
5029 =item Taint rethink
5030
5031 =back
5032
5033 =item Vague ideas
5034
5035 =over 4
5036
5037 =item ref() in list context
5038
5039 =item Make tr/// return histogram of characters in list context
5040
5041 =item Compile to real threaded code
5042
5043 =item Structured types
5044
5045 =item Modifiable $1 et al.
5046
5047 =item Procedural interfaces for IO::*, etc.
5048
5049 =item RPC modules
5050
5051 =item Attach/detach debugger from running program
5052
5053 =item GUI::Native
5054
5055 =item foreach(reverse ...)
5056
5057 =item Constant function cache
5058
5059 =item Approximate regular expression matching
5060
5061 =back
5062
5063 =item Ongoing
5064
5065 =over 4
5066
5067 =item Update guts documentation
5068
5069 =item Add more tests
5070
5071 =item Update auxiliary tools
5072
5073 =item Create debugging macros
5074
5075 =item truncate to the people
5076
5077 =item Unicode in Filenames
5078
5079 =back
5080
5081 =item Unicode in %ENV
5082
5083 =item Recently done things
5084
5085 =over 4
5086
5087 =item Alternative RE syntax module
5088
5089 =item Safe signal handling
5090
5091 =item Tie Modules
5092
5093 =item gettimeofday
5094
5095 =item setitimer and getimiter
5096
5097 =item Testing __DIE__ hook
5098
5099 =item CPP equivalent in Perl
5100
5101 =item Explicit switch statements
5102
5103 =item autocroak
5104
5105 =item UTF/EBCDIC
5106
5107 =item UTF Regexes
5108
5109 =item perlcc to produce executable
5110
5111 =item END blocks saved in compiled output
5112
5113 =item Secure temporary file module
5114
5115 =item Integrate Time::HiRes
5116
5117 =item Turn Cwd into XS
5118
5119 =item Mmap for input
5120
5121 =item Byte to/from UTF8 and UTF8 to/from local conversion
5122
5123 =item Add sockatmark support
5124
5125 =item Mailing list archives
5126
5127 =item Bug tracking
5128
5129 =item Integrate MacPerl
5130
5131 =item Web "nerve center" for Perl
5132
5133 =item Regular expression tutorial
5134
5135 =item Debugging Tutorial
5136
5137 =item Integrate new modules
5138
5139 =item Integrate profiler
5140
5141 =item Y2K error detection
5142
5143 =item Regular expression debugger
5144
5145 =item POD checker
5146
5147 =item "Dynamic" lexicals
5148
5149 =item Cache precompiled modules
5150
5151 =back
5152
5153 =item Deprecated Wishes
5154
5155 =over 4
5156
5157 =item Loop control on do{}
5158
5159 =item Lexically scoped typeglobs
5160
5161 =item format BOTTOM
5162
5163 =item report HANDLE
5164
5165 =item Generalised want()/caller())
5166
5167 =item Named prototypes
5168
5169 =item Built-in globbing
5170
5171 =item Regression tests for suidperl
5172
5173 =item Cached hash values
5174
5175 =item Add compression modules
5176
5177 =item Reorganise documentation into tutorials/references
5178
5179 =item Remove distinction between functions and operators
5180
5181 =item Make XS easier to use
5182
5183 =item Make embedding easier to use
5184
5185 =item man for perl
5186
5187 =item my $Package::variable
5188
5189 =item "or" tests defined, not truth
5190
5191 =item "class"-based lexicals
5192
5193 =item byteperl
5194
5195 =item Lazy evaluation / tail recursion removal
5196
5197 =item Make "use utf8" the default
5198
5199 =item Unicode collation and normalization
5200
5201 =item pack/unpack tutorial
5202
5203 =back
5204
5205 =back
5206
5207 =head2 perlhack - How to hack at the Perl internals
5208
5209 =over 4
5210
5211 =item DESCRIPTION
5212
5213 Does concept match the general goals of Perl?, Where is the
5214 implementation?, Backwards compatibility, Could it be a module instead?, Is
5215 the feature generic enough?, Does it potentially introduce new bugs?, Does
5216 it preclude other desirable features?, Is the implementation robust?, Is
5217 the implementation generic enough to be portable?, Is the implementation
5218 tested?, Is there enough documentation?, Is there another way to do it?,
5219 Does it create too much work?, Patches speak louder than words
5220
5221 =over 4
5222
5223 =item Keeping in sync
5224
5225 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5226 NFS, rsync'ing the patches
5227
5228 =item Why rsync the source tree
5229
5230 It's easier to rsync the source tree, It's more reliable
5231
5232 =item Why rsync the patches
5233
5234 It's easier to rsync the patches, It's a good reference, Finding a start
5235 point, Finding how to fix a bug, Finding the source of misbehaviour
5236
5237 =item Perlbug administration
5238
5239 =item Submitting patches
5240
5241 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5242 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5243
5244 =item Finding Your Way Around
5245
5246 Core modules, Tests, Documentation, Configure, Interpreter
5247
5248 =item Elements of the interpreter
5249
5250 Startup, Parsing, Optimization, Running
5251
5252 =item Internal Variable Types
5253
5254 =item Op Trees
5255
5256 =item Stacks
5257
5258 Argument stack, Mark stack, Save stack
5259
5260 =item Millions of Macros
5261
5262 =item Poking at Perl
5263
5264 =item Using a source-level debugger
5265
5266 run [args], break function_name, break source.c:xxx, step, next, continue,
5267 finish, 'enter', print
5268
5269 =item Dumping Perl Data Structures
5270
5271 =item Patching
5272
5273 =item Patching a core module
5274
5275 =item Adding a new function to the core
5276
5277 =item Writing a test
5278
5279 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5280 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5281 t/cmd t/run t/io t/op, t/lib ext lib
5282
5283 =item Special Make Test Targets
5284
5285 coretest, test.deparse, minitest, test.third check.third utest.third
5286 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8,
5287 test_harness
5288
5289 =item Running tests by hand
5290
5291 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5292
5293 =back
5294
5295 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5296
5297 =over 4
5298
5299 =item Rational Software's Purify
5300
5301 =item Purify on Unix
5302
5303 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5304
5305 =item Purify on NT
5306
5307 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5308
5309 =item Compaq's/Digital's/HP's Third Degree
5310
5311 =item PERL_DESTRUCT_LEVEL
5312
5313 =item Profiling
5314
5315 =item Gprof Profiling
5316
5317 -a, -b, -e routine, -f routine, -s, -z
5318
5319 =item GCC gcov Profiling
5320
5321 =item Pixie Profiling
5322
5323 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5324 -z[ero]
5325
5326 =item Miscellaneous tricks
5327
5328 =item CONCLUSION
5329
5330 I<The Road goes ever on and on, down from the door where it began.>
5331
5332 =back
5333
5334 =item AUTHOR
5335
5336 =back
5337
5338 =head2 perldoc - Look up Perl documentation in Pod format.
5339
5340 =over 4
5341
5342 =item SYNOPSIS
5343
5344 =item DESCRIPTION
5345
5346 =item OPTIONS
5347
5348 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5349 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5350 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5351 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5352 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5353 B<-V>
5354
5355 =item SECURITY
5356
5357 =item ENVIRONMENT
5358
5359 =item AUTHOR
5360
5361 =back
5362
5363 =head2 perlhist - the Perl history records
5364
5365 =over 4
5366
5367 =item DESCRIPTION
5368
5369 =item INTRODUCTION
5370
5371 =item THE KEEPERS OF THE PUMPKIN
5372
5373 =over 4
5374
5375 =item PUMPKIN?
5376
5377 =back
5378
5379 =item THE RECORDS
5380
5381 =over 4
5382
5383 =item SELECTED RELEASE SIZES
5384
5385 =item SELECTED PATCH SIZES
5386
5387 =back
5388
5389 =item THE KEEPERS OF THE RECORDS
5390
5391 =back
5392
5393 =head2 perldelta - what is new for perl v5.9.0
5394
5395 =over 4
5396
5397 =item DESCRIPTION
5398
5399 =item Incompatible Changes
5400
5401 =item Core Enhancements
5402
5403 =over 4
5404
5405 =item Tied Arrays with Negative Array Indices
5406
5407 =back
5408
5409 =item Modules and Pragmata
5410
5411 =item Utility Changes
5412
5413 =item New Documentation
5414
5415 =item Performance Enhancements
5416
5417 =item Installation and Configuration Improvements
5418
5419 =item Selected Bug Fixes
5420
5421 =item New or Changed Diagnostics
5422
5423 =item Changed Internals
5424
5425 =item New Tests
5426
5427 =item Known Problems
5428
5429 =item Platform Specific Problems
5430
5431 =item Reporting Bugs
5432
5433 =item SEE ALSO
5434
5435 =back
5436
5437 =head2 perl58delta, perldelta - what is new for perl v5.8.0
5438
5439 =over 4
5440
5441 =item DESCRIPTION
5442
5443 =item Highlights In 5.8.0
5444
5445 =item Incompatible Changes
5446
5447 =over 4
5448
5449 =item Binary Incompatibility
5450
5451 =item 64-bit platforms and malloc
5452
5453 =item AIX Dynaloading
5454
5455 =item Attributes for C<my> variables now handled at run-time
5456
5457 =item Socket Extension Dynamic in VMS
5458
5459 =item IEEE-format Floating Point Default on OpenVMS Alpha
5460
5461 =item New Unicode Semantics (no more C<use utf8>, almost)
5462
5463 =item New Unicode Properties
5464
5465 =item REF(...) Instead Of SCALAR(...)
5466
5467 =item pack/unpack D/F recycled
5468
5469 =item glob() now returns filenames in alphabetical order
5470
5471 =item Deprecations
5472
5473 =back
5474
5475 =item Core Enhancements
5476
5477 =over 4
5478
5479 =item Unicode Overhaul
5480
5481 =item PerlIO is Now The Default
5482
5483 =item ithreads
5484
5485 =item Restricted Hashes
5486
5487 =item Safe Signals
5488
5489 =item Understanding of Numbers
5490
5491 =item Arrays now always interpolate into double-quoted strings [561]
5492
5493 =item Miscellaneous Changes
5494
5495 =back
5496
5497 =item Modules and Pragmata
5498
5499 =over 4
5500
5501 =item New Modules and Pragmata
5502
5503 =item Updated And Improved Modules and Pragmata
5504
5505 =back
5506
5507 =item Utility Changes
5508
5509 =item New Documentation
5510
5511 =item Performance Enhancements
5512
5513 =item Installation and Configuration Improvements
5514
5515 =over 4
5516
5517 =item Generic Improvements
5518
5519 =item New Or Improved Platforms
5520
5521 =back
5522
5523 =item Selected Bug Fixes
5524
5525 =over 4
5526
5527 =item Platform Specific Changes and Fixes
5528
5529 =back
5530
5531 =item New or Changed Diagnostics
5532
5533 =item Changed Internals
5534
5535 =item Security Vulnerability Closed [561]
5536
5537 =item New Tests
5538
5539 =item Known Problems
5540
5541 =over 4
5542
5543 =item The Compiler Suite Is Still Very Experimental
5544
5545 =item Localising Tied Arrays and Hashes Is Broken
5546
5547 =item Building Extensions Can Fail Because Of Largefiles
5548
5549 =item Modifying $_ Inside for(..)
5550
5551 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5552
5553 =item lib/ftmp-security tests warn 'system possibly insecure'
5554
5555 =item libwww-perl (LWP) fails base/date #51
5556
5557 =item PDL failing some tests
5558
5559 =item Perl_get_sv
5560
5561 =item Self-tying Problems
5562
5563 =item ext/threads/t/libc
5564
5565 =item Failure of Thread (5.005-style) tests
5566
5567 =item Timing problems
5568
5569 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5570
5571 =item Unicode in package/class and subroutine names does not work
5572
5573 =back
5574
5575 =item Platform Specific Problems
5576
5577 =over 4
5578
5579 =item AIX
5580
5581 =item Alpha systems with old gccs fail several tests
5582
5583 =item AmigaOS
5584
5585 =item BeOS
5586
5587 =item Cygwin "unable to remap"
5588
5589 =item Cygwin ndbm tests fail on FAT
5590
5591 =item DJGPP Failures
5592
5593 =item FreeBSD built with ithreads coredumps reading large directories
5594
5595 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5596
5597 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5598
5599 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5600
5601 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5602
5603 =item Linux With Sfio Fails op/misc Test 48
5604
5605 =item Mac OS X
5606
5607 =item Mac OS X dyld undefined symbols
5608
5609 =item OS/2 Test Failures
5610
5611 =item op/sprintf tests 91, 129, and 130
5612
5613 =item SCO
5614
5615 =item Solaris 2.5
5616
5617 =item Solaris x86 Fails Tests With -Duse64bitint
5618
5619 =item SUPER-UX (NEC SX)
5620
5621 =item Term::ReadKey not working on Win32
5622
5623 =item UNICOS/mk
5624
5625 =item UTS
5626
5627 =item VOS (Stratus)
5628
5629 =item VMS
5630
5631 =item Win32
5632
5633 =item XML::Parser not working
5634
5635 =item z/OS (OS/390)
5636
5637 =item Unicode Support on EBCDIC Still Spotty
5638
5639 =item Seen In Perl 5.7 But Gone Now
5640
5641 =back
5642
5643 =item Reporting Bugs
5644
5645 =item SEE ALSO
5646
5647 =item HISTORY
5648
5649 =back
5650
5651 =head2 perl573delta - what's new for perl v5.7.3
5652
5653 =over 4
5654
5655 =item DESCRIPTION
5656
5657 =item Changes
5658
5659 =item Reporting Bugs
5660
5661 =item SEE ALSO
5662
5663 =item HISTORY
5664
5665 =back
5666
5667 =head2 perl572delta - what's new for perl v5.7.2
5668
5669 =over 4
5670
5671 =item DESCRIPTION
5672
5673 =item Security Vulnerability Closed
5674
5675 =item Incompatible Changes
5676
5677 =over 4
5678
5679 =item 64-bit platforms and malloc
5680
5681 =item AIX Dynaloading
5682
5683 =item Socket Extension Dynamic in VMS
5684
5685 =item Different Definition of the Unicode Character Classes \p{In...}
5686
5687 =item Deprecations
5688
5689 =back
5690
5691 =item Core Enhancements
5692
5693 =item Modules and Pragmata
5694
5695 =over 4
5696
5697 =item New Modules and Distributions
5698
5699 =item Updated And Improved Modules and Pragmata
5700
5701 =back
5702
5703 =item Utility Changes
5704
5705 =item New Documentation
5706
5707 =item Installation and Configuration Improvements
5708
5709 =over 4
5710
5711 =item New Or Improved Platforms
5712
5713 =item Generic Improvements
5714
5715 =back
5716
5717 =item Selected Bug Fixes
5718
5719 =over 4
5720
5721 =item Platform Specific Changes and Fixes
5722
5723 =back
5724
5725 =item New or Changed Diagnostics
5726
5727 =item Source Code Enhancements
5728
5729 =over 4
5730
5731 =item MAGIC constants
5732
5733 =item Better commented code
5734
5735 =item Regex pre-/post-compilation items matched up
5736
5737 =item gcc -Wall
5738
5739 =back
5740
5741 =item New Tests
5742
5743 =item Known Problems
5744
5745 =over 4
5746
5747 =item AIX
5748
5749 =item Amiga Perl Invoking Mystery
5750
5751 =item lib/ftmp-security tests warn 'system possibly insecure'
5752
5753 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5754
5755 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5756
5757 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5758
5759 =item Linux With Sfio Fails op/misc Test 48
5760
5761 =item OS/390
5762
5763 =item op/sprintf tests 129 and 130
5764
5765 =item  Failure of Thread tests
5766
5767 =item UNICOS
5768
5769 =item UTS
5770
5771 =item VMS
5772
5773 =item Win32
5774
5775 =item Localising a Tied Variable Leaks Memory
5776
5777 =item Self-tying of Arrays and Hashes Is Forbidden
5778
5779 =item Variable Attributes are not Currently Usable for Tieing
5780
5781 =item Building Extensions Can Fail Because Of Largefiles
5782
5783 =item The Compiler Suite Is Still Experimental
5784
5785 =item The Long Double Support is Still Experimental
5786
5787 =back
5788
5789 =item Reporting Bugs
5790
5791 =item SEE ALSO
5792
5793 =item HISTORY
5794
5795 =back
5796
5797 =head2 perl571delta - what's new for perl v5.7.1
5798
5799 =over 4
5800
5801 =item DESCRIPTION
5802
5803 =item Security Vulnerability Closed
5804
5805 =item Incompatible Changes
5806
5807 =item Core Enhancements
5808
5809 =over 4
5810
5811 =item AUTOLOAD Is Now Lvaluable
5812
5813 =item PerlIO is Now The Default
5814
5815 =item Signals Are Now Safe
5816
5817 =back
5818
5819 =item Modules and Pragmata
5820
5821 =over 4
5822
5823 =item New Modules
5824
5825 =item Updated And Improved Modules and Pragmata
5826
5827 =back
5828
5829 =item Performance Enhancements
5830
5831 =item Utility Changes
5832
5833 =item New Documentation
5834
5835 =over 4
5836
5837 =item perlclib
5838
5839 =item perliol
5840
5841 =item README.aix
5842
5843 =item README.bs2000
5844
5845 =item README.macos
5846
5847 =item README.mpeix
5848
5849 =item README.solaris
5850
5851 =item README.vos
5852
5853 =item Porting/repository.pod
5854
5855 =back
5856
5857 =item Installation and Configuration Improvements
5858
5859 =over 4
5860
5861 =item New Or Improved Platforms
5862
5863 =item Generic Improvements
5864
5865 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5866 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5867 d_strtoq, d_u32align, d_ualarm, d_usleep
5868
5869 =back
5870
5871 =item Selected Bug Fixes
5872
5873 =over 4
5874
5875 =item Platform Specific Changes and Fixes
5876
5877 =back
5878
5879 =item New or Changed Diagnostics
5880
5881 =item Changed Internals
5882
5883 =item New Tests
5884
5885 =item Known Problems
5886
5887 =over 4
5888
5889 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5890
5891 =item lib/ftmp-security tests warn 'system possibly insecure'
5892
5893 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5894
5895 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5896
5897 =item lib/b test 19
5898
5899 =item Linux With Sfio Fails op/misc Test 48
5900
5901 =item sigaction test 13 in VMS
5902
5903 =item sprintf tests 129 and 130
5904
5905 =item  Failure of Thread tests
5906
5907 =item Localising a Tied Variable Leaks Memory
5908
5909 =item Self-tying of Arrays and Hashes Is Forbidden
5910
5911 =item Building Extensions Can Fail Because Of Largefiles
5912
5913 =item The Compiler Suite Is Still Experimental
5914
5915 =back
5916
5917 =item Reporting Bugs
5918
5919 =item SEE ALSO
5920
5921 =item HISTORY
5922
5923 =back
5924
5925 =head2 perl570delta - what's new for perl v5.7.0
5926
5927 =over 4
5928
5929 =item DESCRIPTION
5930
5931 =item Security Vulnerability Closed
5932
5933 =item Incompatible Changes
5934
5935 =item Core Enhancements
5936
5937 =item Modules and Pragmata
5938
5939 =over 4
5940
5941 =item New Modules
5942
5943 =item Updated And Improved Modules and Pragmata
5944
5945 =back
5946
5947 =item Utility Changes
5948
5949 =item New Documentation
5950
5951 =item Performance Enhancements
5952
5953 =item Installation and Configuration Improvements
5954
5955 =over 4
5956
5957 =item Generic Improvements
5958
5959 =back
5960
5961 =item Selected Bug Fixes
5962
5963 =over 4
5964
5965 =item Platform Specific Changes and Fixes
5966
5967 =back
5968
5969 =item New or Changed Diagnostics
5970
5971 =item Changed Internals
5972
5973 =item Known Problems
5974
5975 =over 4
5976
5977 =item Unicode Support Still Far From Perfect
5978
5979 =item EBCDIC Still A Lost Platform
5980
5981 =item Building Extensions Can Fail Because Of Largefiles
5982
5983 =item ftmp-security tests warn 'system possibly insecure'
5984
5985 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5986
5987 =item Long Doubles Still Don't Work In Solaris
5988
5989 =item Linux With Sfio Fails op/misc Test 48
5990
5991 =item Storable tests fail in some platforms
5992
5993 =item Threads Are Still Experimental
5994
5995 =item The Compiler Suite Is Still Experimental
5996
5997 =back
5998
5999 =item Reporting Bugs
6000
6001 =item SEE ALSO
6002
6003 =item HISTORY
6004
6005 =back
6006
6007 =head2 perl561delta - what's new for perl v5.6.x
6008
6009 =over 4
6010
6011 =item DESCRIPTION
6012
6013 =item Summary of changes between 5.6.0 and 5.6.1
6014
6015 =over 4
6016
6017 =item Security Issues
6018
6019 =item Core bug fixes
6020
6021 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6022 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6023 references to special variables, Lexical warnings, Spurious warnings and
6024 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6025 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6026 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6027 Module;>, Tests
6028
6029 =item Core features
6030
6031 =item Configuration issues
6032
6033 =item Documentation
6034
6035 =item Bundled modules
6036
6037 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6038 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6039 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6040 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6041
6042 =item Platform-specific improvements
6043
6044 NCR MP-RAS, NonStop-UX
6045
6046 =back
6047
6048 =item Core Enhancements
6049
6050 =over 4
6051
6052 =item Interpreter cloning, threads, and concurrency
6053
6054 =item Lexically scoped warning categories
6055
6056 =item Unicode and UTF-8 support
6057
6058 =item Support for interpolating named characters
6059
6060 =item "our" declarations
6061
6062 =item Support for strings represented as a vector of ordinals
6063
6064 =item Improved Perl version numbering system
6065
6066 =item New syntax for declaring subroutine attributes
6067
6068 =item File and directory handles can be autovivified
6069
6070 =item open() with more than two arguments
6071
6072 =item 64-bit support
6073
6074 =item Large file support
6075
6076 =item Long doubles
6077
6078 =item "more bits"
6079
6080 =item Enhanced support for sort() subroutines
6081
6082 =item C<sort $coderef @foo> allowed
6083
6084 =item File globbing implemented internally
6085
6086 =item Support for CHECK blocks
6087
6088 =item POSIX character class syntax [: :] supported
6089
6090 =item Better pseudo-random number generator
6091
6092 =item Improved C<qw//> operator
6093
6094 =item Better worst-case behavior of hashes
6095
6096 =item pack() format 'Z' supported
6097
6098 =item pack() format modifier '!' supported
6099
6100 =item pack() and unpack() support counted strings
6101
6102 =item Comments in pack() templates
6103
6104 =item Weak references
6105
6106 =item Binary numbers supported
6107
6108 =item Lvalue subroutines
6109
6110 =item Some arrows may be omitted in calls through references
6111
6112 =item Boolean assignment operators are legal lvalues
6113
6114 =item exists() is supported on subroutine names
6115
6116 =item exists() and delete() are supported on array elements
6117
6118 =item Pseudo-hashes work better
6119
6120 =item Automatic flushing of output buffers
6121
6122 =item Better diagnostics on meaningless filehandle operations
6123
6124 =item Where possible, buffered data discarded from duped input filehandle
6125
6126 =item eof() has the same old magic as <>
6127
6128 =item binmode() can be used to set :crlf and :raw modes
6129
6130 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6131
6132 =item system(), backticks and pipe open now reflect exec() failure
6133
6134 =item Improved diagnostics
6135
6136 =item Diagnostics follow STDERR
6137
6138 =item More consistent close-on-exec behavior
6139
6140 =item syswrite() ease-of-use
6141
6142 =item Better syntax checks on parenthesized unary operators
6143
6144 =item Bit operators support full native integer width
6145
6146 =item Improved security features
6147
6148 =item More functional bareword prototype (*)
6149
6150 =item C<require> and C<do> may be overridden
6151
6152 =item $^X variables may now have names longer than one character
6153
6154 =item New variable $^C reflects C<-c> switch
6155
6156 =item New variable $^V contains Perl version as a string
6157
6158 =item Optional Y2K warnings
6159
6160 =item Arrays now always interpolate into double-quoted strings
6161
6162 =back
6163
6164 =item Modules and Pragmata
6165
6166 =over 4
6167
6168 =item Modules
6169
6170 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6171 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6172 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6173 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6174 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6175 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6176 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6177 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6178
6179 =item Pragmata
6180
6181 =back
6182
6183 =item Utility Changes
6184
6185 =over 4
6186
6187 =item dprofpp
6188
6189 =item find2perl
6190
6191 =item h2xs
6192
6193 =item perlcc
6194
6195 =item perldoc
6196
6197 =item The Perl Debugger
6198
6199 =back
6200
6201 =item Improved Documentation
6202
6203 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6204 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6205 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6206 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6207
6208 =item Performance enhancements
6209
6210 =over 4
6211
6212 =item Simple sort() using { $a <=> $b } and the like are optimized
6213
6214 =item Optimized assignments to lexical variables
6215
6216 =item Faster subroutine calls
6217
6218 =item delete(), each(), values() and hash iteration are faster
6219
6220 =back
6221
6222 =item Installation and Configuration Improvements
6223
6224 =over 4
6225
6226 =item -Dusethreads means something different
6227
6228 =item New Configure flags
6229
6230 =item Threadedness and 64-bitness now more daring
6231
6232 =item Long Doubles
6233
6234 =item -Dusemorebits
6235
6236 =item -Duselargefiles
6237
6238 =item installusrbinperl
6239
6240 =item SOCKS support
6241
6242 =item C<-A> flag
6243
6244 =item Enhanced Installation Directories
6245
6246 =item gcc automatically tried if 'cc' does not seem to be working
6247
6248 =back
6249
6250 =item Platform specific changes
6251
6252 =over 4
6253
6254 =item Supported platforms
6255
6256 =item DOS
6257
6258 =item OS390 (OpenEdition MVS)
6259
6260 =item VMS
6261
6262 =item Win32
6263
6264 =back
6265
6266 =item Significant bug fixes
6267
6268 =over 4
6269
6270 =item <HANDLE> on empty files
6271
6272 =item C<eval '...'> improvements
6273
6274 =item All compilation errors are true errors
6275
6276 =item Implicitly closed filehandles are safer
6277
6278 =item Behavior of list slices is more consistent
6279
6280 =item C<(\$)> prototype and C<$foo{a}>
6281
6282 =item C<goto &sub> and AUTOLOAD
6283
6284 =item C<-bareword> allowed under C<use integer>
6285
6286 =item Failures in DESTROY()
6287
6288 =item Locale bugs fixed
6289
6290 =item Memory leaks
6291
6292 =item Spurious subroutine stubs after failed subroutine calls
6293
6294 =item Taint failures under C<-U>
6295
6296 =item END blocks and the C<-c> switch
6297
6298 =item Potential to leak DATA filehandles
6299
6300 =back
6301
6302 =item New or Changed Diagnostics
6303
6304 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6305 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6306 / cannot take a count, / must be followed by a, A or Z, / must be followed
6307 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6308 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6309 passed through, /%s/ should probably be written as "%s", %s() called too
6310 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6311 argument is not a HASH or ARRAY element or slice, %s argument is not a
6312 subroutine name, %s package attribute may clash with future reserved word:
6313 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6314 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6315 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6316 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6317 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6318 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6319 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6320 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6321 weaken a nonreference, Character class [:%s:] unknown, Character class
6322 syntax [%s] belongs inside character classes, Constant is not %s reference,
6323 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6324 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6325 "local" instead of "our"?), Document contains no data, entering effective
6326 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6327 output, flock() on closed filehandle %s, Global symbol "%s" requires
6328 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6329 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6330 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6331 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6332 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6333 separator character %s in attribute list, Invalid separator character %s in
6334 subroutine attribute list, leaving effective %s failed, Lvalue subs
6335 returning %s not implemented yet, Method %s not permitted, Missing
6336 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6337 No %s specified for -%c, No package name allowed for variable %s in "our",
6338 No space allowed after -%c, no UTC offset information; assuming local time
6339 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6340 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6341 around "%s" list, Possible unintended interpolation of %s in string,
6342 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6343 instead, Premature end of script headers, Repeat count in pack overflows,
6344 Repeat count in unpack overflows, realloc() of freed memory ignored,
6345 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6346 zero-length expression, switching effective %s is not implemented, This
6347 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6348 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6349 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6350 escape \\%c passed through, Unterminated attribute parameter in attribute
6351 list, Unterminated attribute list, Unterminated attribute parameter in
6352 subroutine attribute list, Unterminated subroutine attribute list, Value of
6353 CLI symbol "%s" too long, Version number must be a constant number
6354
6355 =item New tests
6356
6357 =item Incompatible Changes
6358
6359 =over 4
6360
6361 =item Perl Source Incompatibilities
6362
6363 CHECK is a new keyword, Treatment of list slices of undef has changed,
6364 Format of $English::PERL_VERSION is different, Literals of the form
6365 C<1.2.3> parse differently, Possibly changed pseudo-random number
6366 generator, Hashing function for hash keys has changed, C<undef> fails on
6367 read only values, Close-on-exec bit may be set on pipe and socket handles,
6368 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6369 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6370 Text of some diagnostic output has changed, C<%@> has been removed,
6371 Parenthesized not() behaves like a list operator, Semantics of bareword
6372 prototype C<(*)> have changed, Semantics of bit operators may have changed
6373 on 64-bit platforms, More builtins taint their results
6374
6375 =item C Source Incompatibilities
6376
6377 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6378
6379 =item Compatible C Source API Changes
6380
6381 C<PATCHLEVEL> is now C<PERL_VERSION>
6382
6383 =item Binary Incompatibilities
6384
6385 =back
6386
6387 =item Known Problems
6388
6389 =over 4
6390
6391 =item Localizing a tied hash element may leak memory
6392
6393 =item Known test failures
6394
6395 =item EBCDIC platforms not fully supported
6396
6397 =item UNICOS/mk CC failures during Configure run
6398
6399 =item Arrow operator and arrays
6400
6401 =item Experimental features
6402
6403 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6404 pseudo-hash data type, The Compiler suite, Internal implementation of file
6405 globbing, The DB module, The regular expression code constructs:
6406
6407 =back
6408
6409 =item Obsolete Diagnostics
6410
6411 Character class syntax [: :] is reserved for future extensions, Ill-formed
6412 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6413 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6414 to mean "${$}<digit>" is deprecated
6415
6416 =item Reporting Bugs
6417
6418 =item SEE ALSO
6419
6420 =item HISTORY
6421
6422 =back
6423
6424 =head2 perl56delta - what's new for perl v5.6.0
6425
6426 =over 4
6427
6428 =item DESCRIPTION
6429
6430 =item Core Enhancements
6431
6432 =over 4
6433
6434 =item Interpreter cloning, threads, and concurrency
6435
6436 =item Lexically scoped warning categories
6437
6438 =item Unicode and UTF-8 support
6439
6440 =item Support for interpolating named characters
6441
6442 =item "our" declarations
6443
6444 =item Support for strings represented as a vector of ordinals
6445
6446 =item Improved Perl version numbering system
6447
6448 =item New syntax for declaring subroutine attributes
6449
6450 =item File and directory handles can be autovivified
6451
6452 =item open() with more than two arguments
6453
6454 =item 64-bit support
6455
6456 =item Large file support
6457
6458 =item Long doubles
6459
6460 =item "more bits"
6461
6462 =item Enhanced support for sort() subroutines
6463
6464 =item C<sort $coderef @foo> allowed
6465
6466 =item File globbing implemented internally
6467
6468 =item Support for CHECK blocks
6469
6470 =item POSIX character class syntax [: :] supported
6471
6472 =item Better pseudo-random number generator
6473
6474 =item Improved C<qw//> operator
6475
6476 =item Better worst-case behavior of hashes
6477
6478 =item pack() format 'Z' supported
6479
6480 =item pack() format modifier '!' supported
6481
6482 =item pack() and unpack() support counted strings
6483
6484 =item Comments in pack() templates
6485
6486 =item Weak references
6487
6488 =item Binary numbers supported
6489
6490 =item Lvalue subroutines
6491
6492 =item Some arrows may be omitted in calls through references
6493
6494 =item Boolean assignment operators are legal lvalues
6495
6496 =item exists() is supported on subroutine names
6497
6498 =item exists() and delete() are supported on array elements
6499
6500 =item Pseudo-hashes work better
6501
6502 =item Automatic flushing of output buffers
6503
6504 =item Better diagnostics on meaningless filehandle operations
6505
6506 =item Where possible, buffered data discarded from duped input filehandle
6507
6508 =item eof() has the same old magic as <>
6509
6510 =item binmode() can be used to set :crlf and :raw modes
6511
6512 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6513
6514 =item system(), backticks and pipe open now reflect exec() failure
6515
6516 =item Improved diagnostics
6517
6518 =item Diagnostics follow STDERR
6519
6520 =item More consistent close-on-exec behavior
6521
6522 =item syswrite() ease-of-use
6523
6524 =item Better syntax checks on parenthesized unary operators
6525
6526 =item Bit operators support full native integer width
6527
6528 =item Improved security features
6529
6530 =item More functional bareword prototype (*)
6531
6532 =item C<require> and C<do> may be overridden
6533
6534 =item $^X variables may now have names longer than one character
6535
6536 =item New variable $^C reflects C<-c> switch
6537
6538 =item New variable $^V contains Perl version as a string
6539
6540 =item Optional Y2K warnings
6541
6542 =item Arrays now always interpolate into double-quoted strings
6543
6544 =back
6545
6546 =item Modules and Pragmata
6547
6548 =over 4
6549
6550 =item Modules
6551
6552 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6553 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6554 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6555 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6556 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6557 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6558 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6559 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6560
6561 =item Pragmata
6562
6563 =back
6564
6565 =item Utility Changes
6566
6567 =over 4
6568
6569 =item dprofpp
6570
6571 =item find2perl
6572
6573 =item h2xs
6574
6575 =item perlcc
6576
6577 =item perldoc
6578
6579 =item The Perl Debugger
6580
6581 =back
6582
6583 =item Improved Documentation
6584
6585 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6586 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6587 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6588 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6589
6590 =item Performance enhancements
6591
6592 =over 4
6593
6594 =item Simple sort() using { $a <=> $b } and the like are optimized
6595
6596 =item Optimized assignments to lexical variables
6597
6598 =item Faster subroutine calls
6599
6600 =item delete(), each(), values() and hash iteration are faster
6601
6602 =back
6603
6604 =item Installation and Configuration Improvements
6605
6606 =over 4
6607
6608 =item -Dusethreads means something different
6609
6610 =item New Configure flags
6611
6612 =item Threadedness and 64-bitness now more daring
6613
6614 =item Long Doubles
6615
6616 =item -Dusemorebits
6617
6618 =item -Duselargefiles
6619
6620 =item installusrbinperl
6621
6622 =item SOCKS support
6623
6624 =item C<-A> flag
6625
6626 =item Enhanced Installation Directories
6627
6628 =back
6629
6630 =item Platform specific changes
6631
6632 =over 4
6633
6634 =item Supported platforms
6635
6636 =item DOS
6637
6638 =item OS390 (OpenEdition MVS)
6639
6640 =item VMS
6641
6642 =item Win32
6643
6644 =back
6645
6646 =item Significant bug fixes
6647
6648 =over 4
6649
6650 =item <HANDLE> on empty files
6651
6652 =item C<eval '...'> improvements
6653
6654 =item All compilation errors are true errors
6655
6656 =item Implicitly closed filehandles are safer
6657
6658 =item Behavior of list slices is more consistent
6659
6660 =item C<(\$)> prototype and C<$foo{a}>
6661
6662 =item C<goto &sub> and AUTOLOAD
6663
6664 =item C<-bareword> allowed under C<use integer>
6665
6666 =item Failures in DESTROY()
6667
6668 =item Locale bugs fixed
6669
6670 =item Memory leaks
6671
6672 =item Spurious subroutine stubs after failed subroutine calls
6673
6674 =item Taint failures under C<-U>
6675
6676 =item END blocks and the C<-c> switch
6677
6678 =item Potential to leak DATA filehandles
6679
6680 =back
6681
6682 =item New or Changed Diagnostics
6683
6684 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6685 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6686 / cannot take a count, / must be followed by a, A or Z, / must be followed
6687 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6688 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6689 passed through, /%s/ should probably be written as "%s", %s() called too
6690 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6691 argument is not a HASH or ARRAY element or slice, %s argument is not a
6692 subroutine name, %s package attribute may clash with future reserved word:
6693 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6694 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6695 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6696 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6697 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6698 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6699 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6700 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6701 weaken a nonreference, Character class [:%s:] unknown, Character class
6702 syntax [%s] belongs inside character classes, Constant is not %s reference,
6703 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6704 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6705 "local" instead of "our"?), Document contains no data, entering effective
6706 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6707 output, flock() on closed filehandle %s, Global symbol "%s" requires
6708 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6709 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6710 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6711 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6712 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6713 separator character %s in attribute list, Invalid separator character %s in
6714 subroutine attribute list, leaving effective %s failed, Lvalue subs
6715 returning %s not implemented yet, Method %s not permitted, Missing
6716 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6717 No %s specified for -%c, No package name allowed for variable %s in "our",
6718 No space allowed after -%c, no UTC offset information; assuming local time
6719 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6720 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6721 around "%s" list, Possible unintended interpolation of %s in string,
6722 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6723 instead, Premature end of script headers, Repeat count in pack overflows,
6724 Repeat count in unpack overflows, realloc() of freed memory ignored,
6725 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6726 zero-length expression, switching effective %s is not implemented, This
6727 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6728 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6729 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6730 escape \\%c passed through, Unterminated attribute parameter in attribute
6731 list, Unterminated attribute list, Unterminated attribute parameter in
6732 subroutine attribute list, Unterminated subroutine attribute list, Value of
6733 CLI symbol "%s" too long, Version number must be a constant number
6734
6735 =item New tests
6736
6737 =item Incompatible Changes
6738
6739 =over 4
6740
6741 =item Perl Source Incompatibilities
6742
6743 CHECK is a new keyword, Treatment of list slices of undef has changed,
6744 Format of $English::PERL_VERSION is different, Literals of the form
6745 C<1.2.3> parse differently, Possibly changed pseudo-random number
6746 generator, Hashing function for hash keys has changed, C<undef> fails on
6747 read only values, Close-on-exec bit may be set on pipe and socket handles,
6748 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6749 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6750 Text of some diagnostic output has changed, C<%@> has been removed,
6751 Parenthesized not() behaves like a list operator, Semantics of bareword
6752 prototype C<(*)> have changed, Semantics of bit operators may have changed
6753 on 64-bit platforms, More builtins taint their results
6754
6755 =item C Source Incompatibilities
6756
6757 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6758
6759 =item Compatible C Source API Changes
6760
6761 C<PATCHLEVEL> is now C<PERL_VERSION>
6762
6763 =item Binary Incompatibilities
6764
6765 =back
6766
6767 =item Known Problems
6768
6769 =over 4
6770
6771 =item Thread test failures
6772
6773 =item EBCDIC platforms not supported
6774
6775 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6776
6777 =item NEXTSTEP 3.3 POSIX test failure
6778
6779 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6780 gcc
6781
6782 =item UNICOS/mk CC failures during Configure run
6783
6784 =item Arrow operator and arrays
6785
6786 =item Experimental features
6787
6788 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6789 pseudo-hash data type, The Compiler suite, Internal implementation of file
6790 globbing, The DB module, The regular expression code constructs:
6791
6792 =back
6793
6794 =item Obsolete Diagnostics
6795
6796 Character class syntax [: :] is reserved for future extensions, Ill-formed
6797 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6798 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6799 to mean "${$}<digit>" is deprecated
6800
6801 =item Reporting Bugs
6802
6803 =item SEE ALSO
6804
6805 =item HISTORY
6806
6807 =back
6808
6809 =head2 perl5005delta - what's new for perl5.005
6810
6811 =over 4
6812
6813 =item DESCRIPTION
6814
6815 =item About the new versioning system
6816
6817 =item Incompatible Changes
6818
6819 =over 4
6820
6821 =item WARNING:  This version is not binary compatible with Perl 5.004.
6822
6823 =item Default installation structure has changed
6824
6825 =item Perl Source Compatibility
6826
6827 =item C Source Compatibility
6828
6829 =item Binary Compatibility
6830
6831 =item Security fixes may affect compatibility
6832
6833 =item Relaxed new mandatory warnings introduced in 5.004
6834
6835 =item Licensing
6836
6837 =back
6838
6839 =item Core Changes
6840
6841 =over 4
6842
6843 =item Threads
6844
6845 =item Compiler
6846
6847 =item Regular Expressions
6848
6849 Many new and improved optimizations, Many bug fixes, New regular expression
6850 constructs, New operator for precompiled regular expressions, Other
6851 improvements, Incompatible changes
6852
6853 =item   Improved malloc()
6854
6855 =item Quicksort is internally implemented
6856
6857 =item Reliable signals
6858
6859 =item Reliable stack pointers
6860
6861 =item More generous treatment of carriage returns
6862
6863 =item Memory leaks
6864
6865 =item Better support for multiple interpreters
6866
6867 =item Behavior of local() on array and hash elements is now well-defined
6868
6869 =item C<%!> is transparently tied to the L<Errno> module
6870
6871 =item Pseudo-hashes are supported
6872
6873 =item C<EXPR foreach EXPR> is supported
6874
6875 =item Keywords can be globally overridden
6876
6877 =item C<$^E> is meaningful on Win32
6878
6879 =item C<foreach (1..1000000)> optimized
6880
6881 =item C<Foo::> can be used as implicitly quoted package name
6882
6883 =item C<exists $Foo::{Bar::}> tests existence of a package
6884
6885 =item Better locale support
6886
6887 =item Experimental support for 64-bit platforms
6888
6889 =item prototype() returns useful results on builtins
6890
6891 =item Extended support for exception handling
6892
6893 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6894
6895 =item All C<printf> format conversions are handled internally
6896
6897 =item New C<INIT> keyword
6898
6899 =item New C<lock> keyword
6900
6901 =item New C<qr//> operator
6902
6903 =item C<our> is now a reserved word
6904
6905 =item Tied arrays are now fully supported
6906
6907 =item Tied handles support is better
6908
6909 =item 4th argument to substr
6910
6911 =item Negative LENGTH argument to splice
6912
6913 =item Magic lvalues are now more magical
6914
6915 =item <> now reads in records
6916
6917 =back
6918
6919 =item Supported Platforms
6920
6921 =over 4
6922
6923 =item New Platforms
6924
6925 =item Changes in existing support
6926
6927 =back
6928
6929 =item Modules and Pragmata
6930
6931 =over 4
6932
6933 =item New Modules
6934
6935 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6936 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6937 Thread, attrs, fields, re
6938
6939 =item Changes in existing modules
6940
6941 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6942 MakeMaker, CPAN, Cwd
6943
6944 =back
6945
6946 =item Utility Changes
6947
6948 =item Documentation Changes
6949
6950 =item New Diagnostics
6951
6952 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6953 while coercing array into hash, Bareword "%s" refers to nonexistent
6954 package, Can't call method "%s" on an undefined value, Can't check
6955 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6956 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6957 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6958 for "%s", Character class syntax [. .] is reserved for future extensions,
6959 Character class syntax [: :] is reserved for future extensions, Character
6960 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6961 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6962 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6963 package main), Illegal hex digit ignored, No such array field, No such
6964 field "%s" in variable %s of type %s, Out of memory during ridiculously
6965 large request, Range iterator outside integer range, Recursive inheritance
6966 detected while looking for method '%s' %s, Reference found where even-sized
6967 list expected, Undefined value assigned to typeglob, Use of reserved word
6968 "%s" is deprecated, perl: warning: Setting locale failed
6969
6970 =item Obsolete Diagnostics
6971
6972 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6973 temporary file, regexp too big
6974
6975 =item Configuration Changes
6976
6977 =item BUGS
6978
6979 =item SEE ALSO
6980
6981 =item HISTORY
6982
6983 =back
6984
6985 =head2 perl5004delta - what's new for perl5.004
6986
6987 =over 4
6988
6989 =item DESCRIPTION
6990
6991 =item Supported Environments
6992
6993 =item Core Changes
6994
6995 =over 4
6996
6997 =item List assignment to %ENV works
6998
6999 =item Change to "Can't locate Foo.pm in @INC" error
7000
7001 =item Compilation option: Binary compatibility with 5.003
7002
7003 =item $PERL5OPT environment variable
7004
7005 =item Limitations on B<-M>, B<-m>, and B<-T> options
7006
7007 =item More precise warnings
7008
7009 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7010
7011 =item Previously deprecated %OVERLOAD is no longer usable
7012
7013 =item Subroutine arguments created only when they're modified
7014
7015 =item Group vector changeable with C<$)>
7016
7017 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7018
7019 =item Fixed localization of $<digit>, $&, etc.
7020
7021 =item No resetting of $. on implicit close
7022
7023 =item C<wantarray> may return undef
7024
7025 =item C<eval EXPR> determines value of EXPR in scalar context
7026
7027 =item Changes to tainting checks
7028
7029 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7030 spawning if tainted $TERM doesn't look like a terminal name
7031
7032 =item New Opcode module and revised Safe module
7033
7034 =item Embedding improvements
7035
7036 =item Internal change: FileHandle class based on IO::* classes
7037
7038 =item Internal change: PerlIO abstraction interface
7039
7040 =item New and changed syntax
7041
7042 $coderef->(PARAMS)
7043
7044 =item New and changed builtin constants
7045
7046 __PACKAGE__
7047
7048 =item New and changed builtin variables
7049
7050 $^E, $^H, $^M
7051
7052 =item New and changed builtin functions
7053
7054 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7055 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7056 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7057 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7058 nested C<sub{}> closures work now, formats work right on changing lexicals
7059
7060 =item New builtin methods
7061
7062 isa(CLASS), can(METHOD), VERSION( [NEED] )
7063
7064 =item TIEHANDLE now supported
7065
7066 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7067 LIST, READLINE this, GETC this, DESTROY this
7068
7069 =item Malloc enhancements
7070
7071 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7072
7073 =item Miscellaneous efficiency enhancements
7074
7075 =back
7076
7077 =item Support for More Operating Systems
7078
7079 =over 4
7080
7081 =item Win32
7082
7083 =item Plan 9
7084
7085 =item QNX
7086
7087 =item AmigaOS
7088
7089 =back
7090
7091 =item Pragmata
7092
7093 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7094 constant NAME => VALUE, use locale, use ops, use vmsish
7095
7096 =item Modules
7097
7098 =over 4
7099
7100 =item Required Updates
7101
7102 =item Installation directories
7103
7104 =item Module information summary
7105
7106 =item Fcntl
7107
7108 =item IO
7109
7110 =item Math::Complex
7111
7112 =item Math::Trig
7113
7114 =item DB_File
7115
7116 =item Net::Ping
7117
7118 =item Object-oriented overrides for builtin operators
7119
7120 =back
7121
7122 =item Utility Changes
7123
7124 =over 4
7125
7126 =item pod2html
7127
7128 Sends converted HTML to standard output
7129
7130 =item xsubpp
7131
7132 C<void> XSUBs now default to returning nothing
7133
7134 =back
7135
7136 =item C Language API Changes
7137
7138 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7139 manipulating hashes
7140
7141 =item Documentation Changes
7142
7143 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7144 L<perlmodlib>, L<perldebug>, L<perlsec>
7145
7146 =item New Diagnostics
7147
7148 "my" variable %s masks earlier declaration in same scope, %s argument is
7149 not a HASH element or slice, Allocation too large: %lx, Allocation too
7150 large, Applying %s to %s will act on scalar(%s), Attempt to free
7151 nonexistent shared string, Attempt to use reference as lvalue in substr,
7152 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7153 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7154 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7155 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7156 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7157 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7158 %s, Integer overflow in hex number, Integer overflow in octal number,
7159 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7160 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7161 possible typo, Null picture in formline, Offset outside string, Out of
7162 memory!, Out of memory during request for %s, panic: frexp, Possible
7163 attempt to put comments in qw() list, Possible attempt to separate words
7164 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7165 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7166 option, untie attempted while %d inner references still exist, Unrecognized
7167 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7168 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7169 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7170 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7171 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7172 long, Process terminated by SIG%s
7173
7174 =item BUGS
7175
7176 =item SEE ALSO
7177
7178 =item HISTORY
7179
7180 =back
7181
7182 =head2 perlartistic -- the Perl Artistic License
7183
7184 =over 4
7185
7186 =item SYNOPSIS
7187
7188 =item DESCRIPTION
7189
7190 =item The "Artistic License"
7191
7192 =over 4
7193
7194 =item Preamble
7195
7196 =item Definitions
7197
7198 "Package" refers to the collection of files distributed by the Copyright
7199 Holder, and derivatives of that collection of files created through textual
7200 modification, "Standard Version" refers to such a Package if it has not
7201 been modified, or has been modified in accordance with the wishes of the
7202 Copyright Holder as specified below, "Copyright Holder" is whoever is named
7203 in the copyright or copyrights for the package, "You" is you, if you're
7204 thinking about copying or distributing this Package, "Reasonable copying
7205 fee" is whatever you can justify on the basis of media cost, duplication
7206 charges, time of people involved, and so on. (You will not be required to
7207 justify it to the Copyright Holder, but only to the computing community at
7208 large as a market that must bear the fee.), "Freely Available" means that
7209 no fee is charged for the item itself, though there may be fees involved in
7210 handling the item. It also means that recipients of the item may
7211 redistribute it under the same conditions they received it
7212
7213 =item Conditions
7214
7215 =back
7216
7217 =back
7218
7219 =head2 perlgpl -- the GNU Public General Public License, version 2
7220
7221 =over 4
7222
7223 =item SYNOPSIS
7224
7225 =back
7226
7227 =over 4
7228
7229 =item DESCRIPTION
7230
7231 =item GNU GENERAL PUBLIC LICENSE
7232
7233 =back
7234
7235 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7236
7237 =over 4
7238
7239 =item DESCRIPTION
7240
7241 =over 4
7242
7243 =item Compiling Perl 5 on AIX
7244
7245 =item OS level
7246
7247 =item Building Dynamic Extensions on AIX
7248
7249 =item The IBM ANSI C Compiler
7250
7251 =item Using GNU's gcc for building perl
7252
7253 =item Using Large Files with Perl
7254
7255 =item Threaded Perl
7256
7257 =item 64-bit Perl
7258
7259 =item AIX 4.2 and extensions using C++ with statics
7260
7261 =back
7262
7263 =item AUTHOR
7264
7265 =item DATE
7266
7267 =back
7268
7269 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7270
7271 =over 4
7272
7273 =item DESCRIPTION
7274
7275 =item AUTHOR
7276
7277 =back
7278
7279 =head2 perlamiga - Perl under Amiga OS
7280
7281 =over 4
7282
7283 =item NOTE
7284
7285 =item SYNOPSIS
7286
7287 =back
7288
7289 =over 4
7290
7291 =item DESCRIPTION
7292
7293 =over 4
7294
7295 =item Prerequisites for Compiling Perl on AmigaOS
7296
7297 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7298
7299 =item Starting Perl programs under AmigaOS
7300
7301 =item Shortcomings of Perl under AmigaOS
7302
7303 =back
7304
7305 =item INSTALLATION
7306
7307 =item Accessing documentation
7308
7309 =over 4
7310
7311 =item Manpages for Perl on AmigaOS
7312
7313 =item Perl HTML Documentation on AmigaOS
7314
7315 =item Perl GNU Info Files on AmigaOS
7316
7317 =item Perl LaTeX Documentation on AmigaOS
7318
7319 =back
7320
7321 =item BUILDING PERL ON AMIGAOS
7322
7323 =over 4
7324
7325 =item Build Prerequisites for Perl on AmigaOS
7326
7327 =item Getting the Perl Source for AmigaOS
7328
7329 =item Making Perl on AmigaOS
7330
7331 =item Testing Perl on AmigaOS
7332
7333 =item Installing the built Perl on AmigaOS
7334
7335 =back
7336
7337 =item PERL 5.8.0 BROKEN IN AMIGAOS
7338
7339 =item AUTHORS
7340
7341 =item SEE ALSO
7342
7343 =back
7344
7345 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7346
7347 =over 4
7348
7349 =item DESCRIPTION
7350
7351 =over 4
7352
7353 =item General Issues with Perl on BeOS
7354
7355 =item BeOS Release-specific Notes
7356
7357 R4 x86, R4 PPC
7358
7359 =item Contact Information
7360
7361 =item Update 2002-05-30
7362
7363 =back
7364
7365 =back
7366
7367 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7368
7369 =over 4
7370
7371 =item SYNOPSIS
7372
7373 =item DESCRIPTION
7374
7375 =over 4
7376
7377 =item gzip on BS2000
7378
7379 =item bison on BS2000
7380
7381 =item Unpacking Perl Distribution on BS2000
7382
7383 =item Compiling Perl on BS2000
7384
7385 =item Testing Perl on BS2000
7386
7387 =item Installing Perl on BS2000
7388
7389 =item Using Perl in the Posix-Shell of BS2000
7390
7391 =item Using Perl in "native" BS2000
7392
7393 =item Floating point anomalies on BS2000
7394
7395 =back
7396
7397 =item AUTHORS
7398
7399 =item SEE ALSO
7400
7401 =over 4
7402
7403 =item Mailing list
7404
7405 =back
7406
7407 =item HISTORY
7408
7409 =back
7410
7411 =over 4
7412
7413 =item Name
7414
7415 =item Description
7416
7417 =item Build
7418
7419 =over 4
7420
7421 =item Tools & SDK
7422
7423 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7424 celib-sources, Rainer Keuchel's console-sources
7425
7426 =item Make
7427
7428 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run
7429   compile.bat dist
7430
7431 =back
7432
7433 =item Acknowledgements
7434
7435 =item AUTHORS
7436
7437 =back
7438
7439 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7440
7441 =over 4
7442
7443 =item SYNOPSIS
7444
7445 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7446
7447 =over 4
7448
7449 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7450
7451 =item Cygwin Configuration
7452
7453 C<PATH>, I<nroff>, Permissions
7454
7455 =back
7456
7457 =item CONFIGURE PERL ON CYGWIN
7458
7459 =over 4
7460
7461 =item Stripping Perl Binaries on Cygwin
7462
7463 =item Optional Libraries for Perl on Cygwin
7464
7465 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7466 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7467
7468 =item Configure-time Options for Perl on Cygwin
7469
7470 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7471 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7472 C<-Dmksymlinks>
7473
7474 =item Suspicious Warnings on Cygwin
7475
7476 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7477
7478 =back
7479
7480 =item MAKE ON CYGWIN
7481
7482 =over 4
7483
7484 =item Warnings on Cygwin
7485
7486 =item ld2 on Cygwin
7487
7488 =back
7489
7490 =item TEST ON CYGWIN
7491
7492 =over 4
7493
7494 =item File Permissions on Cygwin
7495
7496 =item NDBM_File and ODBM_File do not work on FAT filesystems
7497
7498 =item fork() failures in io_* tests
7499
7500 =item Script Portability on Cygwin
7501
7502 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7503
7504 =back
7505
7506 =item INSTALL PERL ON CYGWIN
7507
7508 =item MANIFEST ON CYGWIN
7509
7510 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7511 Source, Compiled Module Source, Perl Modules/Scripts
7512
7513 =item BUGS ON CYGWIN
7514
7515 =item AUTHORS
7516
7517 =item HISTORY
7518
7519 =back
7520
7521 =head2 perldgux - Perl under DG/UX.
7522
7523 =over 4
7524
7525 =item SYNOPSIS
7526
7527 =back
7528
7529 =over 4
7530
7531 =item DESCRIPTION
7532
7533 =item BUILDING PERL ON DG/UX
7534
7535 =over 4
7536
7537 =item Non-threaded Perl on DG/UX
7538
7539 =item Threaded Perl on DG/UX
7540
7541 =item Testing Perl on DG/UX
7542
7543 =item Installing the built perl on DG/UX
7544
7545 =back
7546
7547 =item AUTHOR
7548
7549 =item SEE ALSO
7550
7551 =back
7552
7553 =head2 perldos - Perl under DOS, W31, W95.
7554
7555 =over 4
7556
7557 =item SYNOPSIS
7558
7559 =item DESCRIPTION
7560
7561 =over 4
7562
7563 =item Prerequisites for Compiling Perl on DOS
7564
7565 DJGPP, Pthreads
7566
7567 =item Shortcomings of Perl under DOS
7568
7569 =item Building Perl on DOS
7570
7571 =item Testing Perl on DOS
7572
7573 =item Installation of Perl on DOS
7574
7575 =back
7576
7577 =item BUILDING AND INSTALLING MODULES ON DOS
7578
7579 =over 4
7580
7581 =item Building Prerequisites for Perl on DOS
7582
7583 =item Unpacking CPAN Modules on DOS
7584
7585 =item Building Non-XS Modules on DOS
7586
7587 =item Building XS Modules on DOS
7588
7589 =back
7590
7591 =item AUTHOR
7592
7593 =item SEE ALSO
7594
7595 =back
7596
7597 =head2 perlepoc, README.epoc - Perl for EPOC
7598
7599 =over 4
7600
7601 =item SYNOPSIS
7602
7603 =item INTRODUCTION
7604
7605 =item INSTALLING PERL ON EPOC
7606
7607 =item STARTING PERL ON EPOC
7608
7609 =over 4
7610
7611 =item Editors on Epoc
7612
7613 =item Features of Perl on Epoc
7614
7615 =item Restrictions of Perl on Epoc
7616
7617 =item Compiling Perl 5 on the EPOC cross compiling environment
7618
7619 =back
7620
7621 =item SUPPORT STATUS OF PERL ON EPOC
7622
7623 =item AUTHOR
7624
7625 =item LAST UPDATE
7626
7627 =back
7628
7629 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7630
7631 =over 4
7632
7633 =item DESCRIPTION
7634
7635 =over 4
7636
7637 =item FreeBSD core dumps from readdir_r with ithreads
7638
7639 =item $^X doesn't always contain a full path in FreeBSD
7640
7641 =item Perl will no longer be part of "base FreeBSD"
7642
7643 =back
7644
7645 =item AUTHOR
7646
7647 =back
7648
7649 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7650 (HP-UX) systems
7651
7652 =over 4
7653
7654 =item DESCRIPTION
7655
7656 =over 4
7657
7658 =item Using perl as shipped with HP-UX
7659
7660 =item Using perl from HP's porting centre
7661
7662 =item Compiling Perl 5 on HP-UX
7663
7664 =item PA-RISC
7665
7666 =item PA-RISC 1.0
7667
7668 =item PA-RISC 1.1
7669
7670 =item PA-RISC 2.0
7671
7672 =item Itanium
7673
7674 =item Portability Between PA-RISC Versions
7675
7676 =item Itanium Processor Family and HP-UX
7677
7678 =item Building Dynamic Extensions on HP-UX
7679
7680 =item The HP ANSI C Compiler
7681
7682 =item The GNU C Compiler
7683
7684 =item Using Large Files with Perl on HP-UX
7685
7686 =item Threaded Perl on HP-UX
7687
7688 =item 64-bit Perl on HP-UX
7689
7690 =item Oracle on HP-UX
7691
7692 =item GDBM and Threads on HP-UX
7693
7694 =item NFS filesystems and utime(2) on HP-UX
7695
7696 =item perl -P and // and HP-UX
7697
7698 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7699
7700 =back
7701
7702 =item nss_delete core dump from op/pwent or op/grent
7703
7704 =item AUTHOR
7705
7706 =item DATE
7707
7708 =back
7709
7710 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7711
7712 =over 4
7713
7714 =item DESCRIPTION
7715
7716 =over 4
7717
7718 =item Known Problems with Perl on Hurd
7719
7720 =back
7721
7722 =item AUTHOR
7723
7724 =back
7725
7726 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7727
7728 =over 4
7729
7730 =item DESCRIPTION
7731
7732 =over 4
7733
7734 =item Building 32-bit Perl in Irix
7735
7736 =item Building 64-bit Perl in Irix
7737
7738 =item About Compiler Versions of Irix
7739
7740 =item Linker Problems in Irix
7741
7742 =item Malloc in Irix
7743
7744 =item Building with threads in Irix
7745
7746 =item Irix 5.3
7747
7748 =back
7749
7750 =item AUTHOR
7751
7752 =back
7753
7754 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7755 systems
7756
7757 =over 4
7758
7759 =item DESCRIPTION
7760
7761 =over 4
7762
7763 =item Compiling Perl 5 on MachTen
7764
7765 =item Failures during C<make test> on MachTen
7766
7767 op/lexassign.t, pragma/warnings.t
7768
7769 =item Building external modules on MachTen
7770
7771 =back
7772
7773 =item AUTHOR
7774
7775 =item DATE
7776
7777 =back
7778
7779 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7780
7781 =over 4
7782
7783 =item SYNOPSIS
7784
7785 =item DESCRIPTION
7786
7787 =item AUTHOR
7788
7789 =item DATE
7790
7791 =back
7792
7793 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7794
7795 =over 4
7796
7797 =item DESCRIPTION
7798
7799 =item Known problems with Perl on MiNT
7800
7801 =item AUTHOR
7802
7803 =back
7804
7805 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7806
7807 =over 4
7808
7809 =item SYNOPSIS
7810
7811 =item NOTE
7812
7813 =item Binary distribution from HP
7814
7815 =item What's New in Perl for MPE/iX
7816
7817 =item Welcome to Perl/iX
7818
7819 =item System Requirements for Perl/iX
7820
7821 =item How to Obtain Perl/iX
7822
7823 =item Perl/iX Distribution Contents Highlights
7824
7825 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7826 public_html/feedback.cgi, src/perl-5.6.0-mpe
7827
7828 =item How to Compile Perl/iX
7829
7830  4,  6
7831
7832 =item Getting Started with Perl/iX
7833
7834 =item MPE/iX Implementation Considerations
7835
7836 =item Known Perl/iX Bugs Under Investigation
7837
7838 =item Perl/iX To-Do List
7839
7840 =item Perl/iX Change History
7841
7842 =item AUTHOR
7843
7844 =item Name
7845
7846 =item Description
7847
7848 =item Build
7849
7850 =over 4
7851
7852 =item Tools & SDK
7853
7854 =item Setup
7855
7856 SetNWBld.bat, Buildtype.bat
7857
7858 =item Make
7859
7860 =item Interpreter
7861
7862 =item Extensions
7863
7864 =back
7865
7866 =item Install
7867
7868 =item Build new extensions
7869
7870 =item Acknowledgements
7871
7872 =item Authors
7873
7874 =item Date
7875
7876 =back
7877
7878 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7879
7880 =over 4
7881
7882 =item SYNOPSIS
7883
7884 =back
7885
7886 =over 4
7887
7888 =item DESCRIPTION
7889
7890 =over 4
7891
7892 =item Target
7893
7894 =item Other OSes
7895
7896 =item Prerequisites
7897
7898 EMX, RSX, HPFS, pdksh
7899
7900 =item Starting Perl programs under OS/2 (and DOS and...)
7901
7902 =item Starting OS/2 (and DOS) programs under Perl
7903
7904 =back
7905
7906 =item Frequently asked questions
7907
7908 =over 4
7909
7910 =item "It does not work"
7911
7912 =item I cannot run external programs
7913
7914 =item I cannot embed perl into my program, or use F<perl.dll> from my
7915 program.
7916
7917 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7918 L<ExtUtils::Embed>?
7919
7920 =item C<``> and pipe-C<open> do not work under DOS.
7921
7922 =item Cannot start C<find.exe "pattern" file>
7923
7924 =back
7925
7926 =item INSTALLATION
7927
7928 =over 4
7929
7930 =item Automatic binary installation
7931
7932 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7933
7934 =item Manual binary installation
7935
7936 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7937 (statically linked), Executables for Perl utilities, Main Perl library,
7938 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7939 and utilities, Manpages for Perl modules, Source for Perl documentation,
7940 Perl manual in F<.INF> format, Pdksh
7941
7942 =item B<Warning>
7943
7944 =back
7945
7946 =item Accessing documentation
7947
7948 =over 4
7949
7950 =item OS/2 F<.INF> file
7951
7952 =item Plain text
7953
7954 =item Manpages
7955
7956 =item HTML
7957
7958 =item GNU C<info> files
7959
7960 =item F<PDF> files
7961
7962 =item C<LaTeX> docs
7963
7964 =back
7965
7966 =item BUILD
7967
7968 =over 4
7969
7970 =item The short story
7971
7972 =item Prerequisites
7973
7974 =item Getting perl source
7975
7976 =item Application of the patches
7977
7978 =item Hand-editing
7979
7980 =item Making
7981
7982 =item Testing
7983
7984 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7985 F<op/stat.t>
7986
7987 =item Installing the built perl
7988
7989 =item C<a.out>-style build
7990
7991 =back
7992
7993 =item Build FAQ
7994
7995 =over 4
7996
7997 =item Some C</> became C<\> in pdksh.
7998
7999 =item C<'errno'> - unresolved external
8000
8001 =item Problems with tr or sed
8002
8003 =item Some problem (forget which ;-)
8004
8005 =item Library ... not found
8006
8007 =item Segfault in make
8008
8009 =item op/sprintf test failure
8010
8011 =back
8012
8013 =item Specific (mis)features of OS/2 port
8014
8015 =over 4
8016
8017 =item C<setpriority>, C<getpriority>
8018
8019 =item C<system()>
8020
8021 =item C<extproc> on the first line
8022
8023 =item Additional modules:
8024
8025 =item Prebuilt methods:
8026
8027 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8028  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
8029 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
8030 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
8031 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
8032 C<Cwd::extLibpath_set( path [, type ] )>,
8033 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8034 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8035 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8036 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8037 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8038 C<OS2::DLLname([how [, \&xsub]])>
8039
8040 =item Prebuilt variables:
8041
8042 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8043 $OS2::nsyserror
8044
8045 =item Misfeatures
8046
8047 =item Modifications
8048
8049 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8050 C<flock>
8051
8052 =item Identifying DLLs
8053
8054 =item Centralized management of resources
8055
8056 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8057 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8058 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8059 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8060
8061 =back
8062
8063 =item Perl flavors
8064
8065 =over 4
8066
8067 =item F<perl.exe>
8068
8069 =item F<perl_.exe>
8070
8071 =item F<perl__.exe>
8072
8073 =item F<perl___.exe>
8074
8075 =item Why strange names?
8076
8077 =item Why dynamic linking?
8078
8079 =item Why chimera build?
8080
8081 =back
8082
8083 =item ENVIRONMENT
8084
8085 =over 4
8086
8087 =item C<PERLLIB_PREFIX>
8088
8089 =item C<PERL_BADLANG>
8090
8091 =item C<PERL_BADFREE>
8092
8093 =item C<PERL_SH_DIR>
8094
8095 =item C<USE_PERL_FLOCK>
8096
8097 =item C<TMP> or C<TEMP>
8098
8099 =back
8100
8101 =item Evolution
8102
8103 =over 4
8104
8105 =item Text-mode filehandles
8106
8107 =item Priorities
8108
8109 =item DLL name mangling: pre 5.6.2
8110
8111 =item DLL name mangling: 5.6.2 and beyond
8112
8113 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8114 C<LIBPATH>
8115
8116 =item DLL forwarder generation
8117
8118 =item Threading
8119
8120 =item Calls to external programs
8121
8122 =item Memory allocation
8123
8124 =item Threads
8125
8126 C<COND_WAIT>, F<os2.c>
8127
8128 =back
8129
8130 =item BUGS
8131
8132 =back
8133
8134 =over 4
8135
8136 =item AUTHOR
8137
8138 =item SEE ALSO
8139
8140 =back
8141
8142 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8143 and z/OS
8144
8145 =over 4
8146
8147 =item SYNOPSIS
8148
8149 =item DESCRIPTION
8150
8151 =over 4
8152
8153 =item Tools
8154
8155 =item Unpacking Perl distribution on OS/390
8156
8157 =item Setup and utilities for Perl on OS/390
8158
8159 =item Configure Perl on OS/390
8160
8161 =item Build, Test, Install Perl on OS/390
8162
8163 =item Build Anomalies with Perl on OS/390
8164
8165 =item Testing Anomalies with Perl on OS/390
8166
8167 =item Installation Anomalies with Perl on OS/390
8168
8169 =item Usage Hints for Perl on OS/390
8170
8171 =item Floating Point Anomalies with Perl on OS/390
8172
8173 =item Modules and Extensions for Perl on OS/390
8174
8175 =back
8176
8177 =item AUTHORS
8178
8179 =item SEE ALSO
8180
8181 =over 4
8182
8183 =item Mailing list for Perl on OS/390
8184
8185 =back
8186
8187 =item HISTORY
8188
8189 =back
8190
8191 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8192
8193 =over 4
8194
8195 =item DESCRIPTION
8196
8197 =over 4
8198
8199 =item Compiling Perl for OS/400 PASE
8200
8201 =item Installing Perl in OS/400 PASE
8202
8203 =item Using Perl in OS/400 PASE
8204
8205 =item Known Problems
8206
8207 =item Perl on ILE
8208
8209 =back
8210
8211 =item AUTHORS
8212
8213 =back
8214
8215 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8216
8217 =over 4
8218
8219 =item DESCRIPTION
8220
8221 =over 4
8222
8223 =item Required Software for Compiling Perl on QNX4
8224
8225 /bin/sh, ar, nm, cpp, make
8226
8227 =item Outstanding Issues with Perl on QNX4
8228
8229 =item QNX auxiliary files
8230
8231 qnx/ar, qnx/cpp
8232
8233 =item Outstanding issues with perl under QNX6
8234
8235 =back
8236
8237 =item AUTHOR
8238
8239 =back
8240
8241 =head2 perlplan9 - Plan 9-specific documentation for Perl
8242
8243 =over 4
8244
8245 =item DESCRIPTION
8246
8247 =over 4
8248
8249 =item Invoking Perl
8250
8251 =item What's in Plan 9 Perl
8252
8253 =item What's not in Plan 9 Perl
8254
8255 =item Perl5 Functions not currently supported in Plan 9 Perl
8256
8257 =item Signals in Plan 9 Perl
8258
8259 =back
8260
8261 =item COMPILING AND INSTALLING PERL ON PLAN 9
8262
8263 =over 4
8264
8265 =item Installing Perl Documentation on Plan 9
8266
8267 =back
8268
8269 =item BUGS
8270
8271 =item Revision date
8272
8273 =item AUTHOR
8274
8275 =back
8276
8277 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8278
8279 =over 4
8280
8281 =item DESCRIPTION
8282
8283 =over 4
8284
8285 =item Solaris Version Numbers.
8286
8287 =back
8288
8289 =item RESOURCES
8290
8291 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8292
8293 =item SETTING UP
8294
8295 =over 4
8296
8297 =item File Extraction Problems on Solaris.
8298
8299 =item Compiler and Related Tools on Solaris.
8300
8301 =item Environment for Compiling Perl on Solaris
8302
8303 =back
8304
8305 =item RUN CONFIGURE.
8306
8307 =over 4
8308
8309 =item 64-bit Issues with Perl on Solaris.
8310
8311 =item Threads in Perl on Solaris.
8312
8313 =item Malloc Issues with Perl on Solaris.
8314
8315 =back
8316
8317 =item MAKE PROBLEMS.
8318
8319 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8320 relocation error:, dlopen: stub interception failed, #error "No
8321 DATAMODEL_NATIVE specified", sh: ar: not found
8322
8323 =item MAKE TEST
8324
8325 =over 4
8326
8327 =item op/stat.t test 4 in Solaris
8328
8329 =item nss_delete core dump from op/pwent or op/grent
8330
8331 =back
8332
8333 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8334
8335 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8336
8337 =over 4
8338
8339 =item Limits on Numbers of Open Files on Solaris.
8340
8341 =back
8342
8343 =item SOLARIS-SPECIFIC MODULES.
8344
8345 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8346
8347 =over 4
8348
8349 =item Proc::ProcessTable on Solaris
8350
8351 =item BSD::Resource on Solaris
8352
8353 =item Net::SSLeay on Solaris
8354
8355 =back
8356
8357 =item AUTHOR
8358
8359 =item LAST MODIFIED
8360
8361 =back
8362
8363 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8364 Digital UNIX formerly known as DEC OSF/1) systems
8365
8366 =over 4
8367
8368 =item DESCRIPTION
8369
8370 =over 4
8371
8372 =item Compiling Perl 5 on Tru64
8373
8374 =item Using Large Files with Perl on Tru64
8375
8376 =item Threaded Perl on Tru64
8377
8378 =item Long Doubles on Tru64
8379
8380 =item DB_File tests failing on Tru64
8381
8382 =item 64-bit Perl on Tru64
8383
8384 =item Warnings about floating-point overflow when compiling Perl on Tru64
8385
8386 =back
8387
8388 =item Testing Perl on Tru64
8389
8390 =item ext/ODBM_File/odbm Test Failing With Static Builds
8391
8392 =item Perl Fails Because Of Unresolved Symbol sockatmark
8393
8394 =item AUTHOR
8395
8396 =back
8397
8398 =head2 perluts - Perl under UTS
8399
8400 =over 4
8401
8402 =item SYNOPSIS
8403
8404 =item DESCRIPTION
8405
8406 =item BUILDING PERL ON UTS
8407
8408 =item Installing the built perl on UTS
8409
8410 =item AUTHOR
8411
8412 =back
8413
8414 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8415
8416 =over 4
8417
8418 =item SYNOPSIS
8419
8420 =item DESCRIPTION
8421
8422 =over 4
8423
8424 =item Unpacking Perl Distribution on VM/ESA
8425
8426 =item Setup Perl and utilities on VM/ESA
8427
8428 =item Configure Perl on VM/ESA
8429
8430 =item Testing Anomalies of Perl on VM/ESA
8431
8432 =item Usage Hints for Perl on VM/ESA
8433
8434 =back
8435
8436 =item AUTHORS
8437
8438 =item SEE ALSO
8439
8440 =over 4
8441
8442 =item Mailing list for Perl on VM/ESA
8443
8444 =back
8445
8446 =back
8447
8448 =head2 perlvms - VMS-specific documentation for Perl
8449
8450 =over 4
8451
8452 =item DESCRIPTION
8453
8454 =item Installation
8455
8456 =item Organization of Perl Images
8457
8458 =over 4
8459
8460 =item Core Images
8461
8462 =item Perl Extensions
8463
8464 =item Installing static extensions
8465
8466 =item Installing dynamic extensions
8467
8468 =back
8469
8470 =item File specifications
8471
8472 =over 4
8473
8474 =item Syntax
8475
8476 =item Wildcard expansion
8477
8478 =item Pipes
8479
8480 =back
8481
8482 =item PERL5LIB and PERLLIB
8483
8484 =item Command line
8485
8486 =over 4
8487
8488 =item I/O redirection and backgrounding
8489
8490 =item Command line switches
8491
8492 -i, -S, -u
8493
8494 =back
8495
8496 =item Perl functions
8497
8498 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8499 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8500 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8501 LIST, waitpid PID,FLAGS
8502
8503 =item Perl variables
8504
8505 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8506
8507 =item Standard modules with VMS-specific differences
8508
8509 =over 4
8510
8511 =item SDBM_File
8512
8513 =back
8514
8515 =item Revision date
8516
8517 =item AUTHOR
8518
8519 =back
8520
8521 =head2 perlvos, README.vos - Perl for Stratus VOS
8522
8523 =over 4
8524
8525 =item SYNOPSIS
8526
8527 =item BUILDING PERL FOR VOS
8528
8529 =item INSTALLING PERL IN VOS
8530
8531 =item USING PERL IN VOS
8532
8533 =over 4
8534
8535 =item Restrictions of Perl on VOS
8536
8537 =item Handling of underflow and overflow
8538
8539 =back
8540
8541 =item TEST STATUS
8542
8543 =item SUPPORT STATUS
8544
8545 =item AUTHOR
8546
8547 =item LAST UPDATE
8548
8549 =back
8550
8551 =head2 perlwin32 - Perl under Windows
8552
8553 =over 4
8554
8555 =item SYNOPSIS
8556
8557 =item DESCRIPTION
8558
8559 =over 4
8560
8561 =item Setting Up Perl on Win32
8562
8563 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8564 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
8565
8566 =item Building
8567
8568 =item Testing Perl on Win32
8569
8570 =item Installation of Perl on Win32
8571
8572 =item Usage Hints for Perl on Win32
8573
8574 Environment Variables, File Globbing, Using perl from the command line,
8575 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8576 Extensions, Notes on 64-bit Windows
8577
8578 =item Running Perl Scripts
8579
8580 Miscellaneous Things
8581
8582 =back
8583
8584 =item BUGS AND CAVEATS
8585
8586 =item AUTHORS
8587
8588 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8589 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8590 E<lt>nick@ing-simmons.netE<gt>
8591
8592 =item SEE ALSO
8593
8594 =item HISTORY
8595
8596 =back
8597
8598 =head1 PRAGMA DOCUMENTATION
8599
8600 =head2 attrs - set/get attributes of a subroutine (deprecated)
8601
8602 =over 4
8603
8604 =item SYNOPSIS
8605
8606 =item DESCRIPTION
8607
8608 method, locked
8609
8610 =back
8611
8612 =head2 re - Perl pragma to alter regular expression behaviour
8613
8614 =over 4
8615
8616 =item SYNOPSIS
8617
8618 =item DESCRIPTION
8619
8620 =back
8621
8622 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8623 data structures between threads
8624
8625 =over 4
8626
8627 =item SYNOPSIS
8628
8629 =item DESCRIPTION
8630
8631 =item EXPORT
8632
8633 =item FUNCTIONS
8634
8635 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8636 cond_broadcast VARIABLE
8637
8638 =item NOTES
8639
8640 =item BUGS
8641
8642 =item AUTHOR
8643
8644 =item SEE ALSO
8645
8646 =back
8647
8648 =head2 threads - Perl extension allowing use of interpreter based threads
8649 from perl
8650
8651 =over 4
8652
8653 =item SYNOPSIS
8654
8655 =item DESCRIPTION
8656
8657 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8658 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8659 threads->list();, async BLOCK;
8660
8661 =item WARNINGS
8662
8663 A thread exited while %d other threads were still running
8664
8665 =item TODO
8666
8667 =item BUGS
8668
8669 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8670 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8671
8672 =item AUTHOR and COPYRIGHT
8673
8674 =item SEE ALSO
8675
8676 =back
8677
8678 =head2 assertions - selects assertions
8679
8680 =over 4
8681
8682 =item SYNOPSIS
8683
8684 =item ABSTRACT
8685
8686 =item DESCRIPTION
8687
8688 =over 4
8689
8690 =item EXPORT
8691
8692 =back
8693
8694 =item SEE ALSO
8695
8696 =item AUTHOR
8697
8698 =item COPYRIGHT AND LICENSE
8699
8700 =back
8701
8702 =head2 assertions::activate - assertions activation
8703
8704 =over 4
8705
8706 =item SYNOPSIS
8707
8708 =item ABSTRACT
8709
8710 =item DESCRIPTION
8711
8712 =over 4
8713
8714 =item EXPORT
8715
8716 =back
8717
8718 =item SEE ALSO
8719
8720 =item AUTHOR
8721
8722 =item COPYRIGHT AND LICENSE
8723
8724 =back
8725
8726 =head2 attributes - get/set subroutine or variable attributes
8727
8728 =over 4
8729
8730 =item SYNOPSIS
8731
8732 =item DESCRIPTION
8733
8734 =over 4
8735
8736 =item Built-in Attributes
8737
8738 locked, method, lvalue
8739
8740 =item Available Subroutines
8741
8742 get, reftype
8743
8744 =item Package-specific Attribute Handling
8745
8746 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8747
8748 =item Syntax of Attribute Lists
8749
8750 =back
8751
8752 =item EXPORTS
8753
8754 =over 4
8755
8756 =item Default exports
8757
8758 =item Available exports
8759
8760 =item Export tags defined
8761
8762 =back
8763
8764 =item EXAMPLES
8765
8766 =item SEE ALSO
8767
8768 =back
8769
8770 =head2 attrs - set/get attributes of a subroutine (deprecated)
8771
8772 =over 4
8773
8774 =item SYNOPSIS
8775
8776 =item DESCRIPTION
8777
8778 method, locked
8779
8780 =back
8781
8782 =head2 autouse - postpone load of modules until a function is used
8783
8784 =over 4
8785
8786 =item SYNOPSIS
8787
8788 =item DESCRIPTION
8789
8790 =item WARNING
8791
8792 =item AUTHOR
8793
8794 =item SEE ALSO
8795
8796 =back
8797
8798 =head2 base - Establish IS-A relationship with base class at compile time
8799
8800 =over 4
8801
8802 =item SYNOPSIS
8803
8804 =item DESCRIPTION
8805
8806 =item HISTORY
8807
8808 =item SEE ALSO
8809
8810 =back
8811
8812 =head2 bigint - Transparent BigInteger support for Perl
8813
8814 =over 4
8815
8816 =item SYNOPSIS
8817
8818 =item DESCRIPTION
8819
8820 =over 4
8821
8822 =item OPTIONS
8823
8824 a or accuracy, p or precision, t or trace, l or lib, v or version
8825
8826 =item MATH LIBRARY
8827
8828 =item INTERNAL FORMAT
8829
8830 =item SIGN
8831
8832 =item METHODS
8833
8834 =back
8835
8836 =item MODULES USED
8837
8838 =item EXAMPLES
8839
8840 =item LICENSE
8841
8842 =item SEE ALSO
8843
8844 =item AUTHORS
8845
8846 =back
8847
8848 =head2 bignum - Transparent BigNumber support for Perl
8849
8850 =over 4
8851
8852 =item SYNOPSIS
8853
8854 =item DESCRIPTION
8855
8856 =over 4
8857
8858 =item OPTIONS
8859
8860 a or accuracy, p or precision, t or trace, l or lib, v or version
8861
8862 =item METHODS
8863
8864 inf(), NaN(), upgrade()
8865
8866 =item MATH LIBRARY
8867
8868 =item INTERNAL FORMAT
8869
8870 =item SIGN
8871
8872 =back
8873
8874 =item MODULES USED
8875
8876 =item EXAMPLES
8877
8878 =item LICENSE
8879
8880 =item SEE ALSO
8881
8882 =item AUTHORS
8883
8884 =back
8885
8886 =head2 bigrat - Transparent BigNumber/BigRationale support for Perl
8887
8888 =over 4
8889
8890 =item SYNOPSIS
8891
8892 =item DESCRIPTION
8893
8894 =over 4
8895
8896 =item MODULES USED
8897
8898 =item MATH LIBRARY
8899
8900 =item SIGN
8901
8902 =item METHODS
8903
8904 =back
8905
8906 =item EXAMPLES
8907
8908         perl -Mbigrat -le 'print sqrt(33)'
8909         perl -Mbigrat -le 'print 2*255'
8910         perl -Mbigrat -le 'print 4.5+2*255'
8911         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8912         perl -Mbigrat -le 'print 12->is_odd()';
8913
8914 =item LICENSE
8915
8916 =item SEE ALSO
8917
8918 =item AUTHORS
8919
8920 =back
8921
8922 =head2 blib - Use MakeMaker's uninstalled version of a package
8923
8924 =over 4
8925
8926 =item SYNOPSIS
8927
8928 =item DESCRIPTION
8929
8930 =item BUGS
8931
8932 =item AUTHOR
8933
8934 =back
8935
8936 =head2 bytes - Perl pragma to force byte semantics rather than character
8937 semantics
8938
8939 =over 4
8940
8941 =item SYNOPSIS
8942
8943 =item DESCRIPTION
8944
8945 =item SEE ALSO
8946
8947 =back
8948
8949 =head2 charnames - define character names for C<\N{named}> string literal
8950 escapes
8951
8952 =over 4
8953
8954 =item SYNOPSIS
8955
8956 =item DESCRIPTION
8957
8958 =item CUSTOM TRANSLATORS
8959
8960 =item CUSTOM ALIASES
8961
8962 =over 4
8963
8964 =item Anonymous hashes
8965
8966 =item Alias file
8967
8968 =item Alias shortcut
8969
8970 =back
8971
8972 =item charnames::viacode(code)
8973
8974 =item charnames::vianame(name)
8975
8976 =item ALIASES
8977
8978 =item ILLEGAL CHARACTERS
8979
8980 =item BUGS
8981
8982 =back
8983
8984 =head2 constant - Perl pragma to declare constants
8985
8986 =over 4
8987
8988 =item SYNOPSIS
8989
8990 =item DESCRIPTION
8991
8992 =item NOTES
8993
8994 =over 4
8995
8996 =item List constants
8997
8998 =item Defining multiple constants at once
8999
9000 =item Magic constants
9001
9002 =back
9003
9004 =item TECHNICAL NOTES
9005
9006 =item BUGS
9007
9008 =item AUTHOR
9009
9010 =item COPYRIGHT
9011
9012 =back
9013
9014 =head2 diagnostics - Perl compiler pragma to force verbose warning
9015 diagnostics
9016
9017 =over 4
9018
9019 =item SYNOPSIS
9020
9021 =item DESCRIPTION
9022
9023 =over 4
9024
9025 =item The C<diagnostics> Pragma
9026
9027 =item The I<splain> Program
9028
9029 =back
9030
9031 =item EXAMPLES
9032
9033 =item INTERNALS
9034
9035 =item BUGS
9036
9037 =item AUTHOR
9038
9039 =back
9040
9041 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9042
9043 =over 4
9044
9045 =item SYNOPSIS
9046
9047 =item ABSTRACT
9048
9049 =over 4
9050
9051 =item Literal Conversions
9052
9053 =item PerlIO layers for C<STD(IN|OUT)>
9054
9055 =back
9056
9057 =item FEATURES THAT REQUIRE 5.8.1
9058
9059 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9060
9061 =item USAGE
9062
9063 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9064 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9065
9066 =item The Filter Option
9067
9068 =over 4
9069
9070 =item Filter-related changes at Encode version 1.87
9071
9072 =back
9073
9074 =item CAVEATS
9075
9076 =over 4
9077
9078 =item NOT SCOPED
9079
9080 =item DO NOT MIX MULTIPLE ENCODINGS
9081
9082 =item tr/// with ranges
9083
9084 Legend of characters above
9085
9086 =back
9087
9088 =item EXAMPLE - Greekperl
9089
9090 =item KNOWN PROBLEMS
9091
9092 literals in regex that are longer than 127 bytes, EBCDIC, format
9093
9094 =item HISTORY
9095
9096 =item SEE ALSO
9097
9098 =back
9099
9100 =head2 fields - compile-time class fields
9101
9102 =over 4
9103
9104 =item SYNOPSIS
9105
9106 =item DESCRIPTION
9107
9108 new, phash
9109
9110 =item SEE ALSO
9111
9112 =back
9113
9114 =head2 filetest - Perl pragma to control the filetest permission operators
9115
9116 =over 4
9117
9118 =item SYNOPSIS
9119
9120 =item DESCRIPTION
9121
9122 =over 4
9123
9124 =item subpragma access
9125
9126 =back
9127
9128 =back
9129
9130 =head2 if - C<use> a Perl module if a condition holds
9131
9132 =over 4
9133
9134 =item SYNOPSIS
9135
9136 =item DESCRIPTION
9137
9138 =item BUGS
9139
9140 =item AUTHOR
9141
9142 =back
9143
9144 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9145 point
9146
9147 =over 4
9148
9149 =item SYNOPSIS
9150
9151 =item DESCRIPTION
9152
9153 =back
9154
9155 =head2 less - perl pragma to request less of something from the compiler
9156
9157 =over 4
9158
9159 =item SYNOPSIS
9160
9161 =item DESCRIPTION
9162
9163 =back
9164
9165 =head2 lib - manipulate @INC at compile time
9166
9167 =over 4
9168
9169 =item SYNOPSIS
9170
9171 =item DESCRIPTION
9172
9173 =over 4
9174
9175 =item Adding directories to @INC
9176
9177 =item Deleting directories from @INC
9178
9179 =item Restoring original @INC
9180
9181 =back
9182
9183 =item CAVEATS
9184
9185 =item NOTES
9186
9187 =item SEE ALSO
9188
9189 =item AUTHOR
9190
9191 =back
9192
9193 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9194 operations
9195
9196 =over 4
9197
9198 =item SYNOPSIS
9199
9200 =item DESCRIPTION
9201
9202 =back
9203
9204 =head2 open - perl pragma to set default PerlIO layers for input and output
9205
9206 =over 4
9207
9208 =item SYNOPSIS
9209
9210 =item DESCRIPTION
9211
9212 =item NONPERLIO FUNCTIONALITY
9213
9214 =item IMPLEMENTATION DETAILS
9215
9216 =item SEE ALSO
9217
9218 =back
9219
9220 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9221
9222 =over 4
9223
9224 =item SYNOPSIS
9225
9226 =item DESCRIPTION
9227
9228 =item SEE ALSO
9229
9230 =back
9231
9232 =head2 overload - Package for overloading perl operations
9233
9234 =over 4
9235
9236 =item SYNOPSIS
9237
9238 =item DESCRIPTION
9239
9240 =over 4
9241
9242 =item Declaration of overloaded functions
9243
9244 =item Calling Conventions for Binary Operations
9245
9246 FALSE, TRUE, C<undef>
9247
9248 =item Calling Conventions for Unary Operations
9249
9250 =item Calling Conventions for Mutators
9251
9252 C<++> and C<-->, C<x=> and other assignment versions
9253
9254 =item Overloadable Operations
9255
9256 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9257 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9258 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9259
9260 =item Inheritance and overloading
9261
9262 Strings as values of C<use overload> directive, Overloading of an operation
9263 is inherited by derived classes
9264
9265 =back
9266
9267 =item SPECIAL SYMBOLS FOR C<use overload>
9268
9269 =over 4
9270
9271 =item Last Resort
9272
9273 =item Fallback
9274
9275 C<undef>, TRUE, defined, but FALSE
9276
9277 =item Copy Constructor
9278
9279 B<Example>
9280
9281 =back
9282
9283 =item MAGIC AUTOGENERATION
9284
9285 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9286 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9287 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9288 I<Copy operator>
9289
9290 =item Losing overloading
9291
9292 =item Run-time Overloading
9293
9294 =item Public functions
9295
9296 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9297
9298 =item Overloading constants
9299
9300 integer, float, binary, q, qr
9301
9302 =item IMPLEMENTATION
9303
9304 =item Metaphor clash
9305
9306 =item Cookbook
9307
9308 =over 4
9309
9310 =item Two-face scalars
9311
9312 =item Two-face references
9313
9314 =item Symbolic calculator
9315
9316 =item I<Really> symbolic calculator
9317
9318 =back
9319
9320 =item AUTHOR
9321
9322 =item DIAGNOSTICS
9323
9324 Odd number of arguments for overload::constant, `%s' is not an overloadable
9325 type, `%s' is not a code reference
9326
9327 =item BUGS
9328
9329 =back
9330
9331 =head2 re - Perl pragma to alter regular expression behaviour
9332
9333 =over 4
9334
9335 =item SYNOPSIS
9336
9337 =item DESCRIPTION
9338
9339 =back
9340
9341 =head2 sigtrap - Perl pragma to enable simple signal handling
9342
9343 =over 4
9344
9345 =item SYNOPSIS
9346
9347 =item DESCRIPTION
9348
9349 =item OPTIONS
9350
9351 =over 4
9352
9353 =item SIGNAL HANDLERS
9354
9355 B<stack-trace>, B<die>, B<handler> I<your-handler>
9356
9357 =item SIGNAL LISTS
9358
9359 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9360
9361 =item OTHER
9362
9363 B<untrapped>, B<any>, I<signal>, I<number>
9364
9365 =back
9366
9367 =item EXAMPLES
9368
9369 =back
9370
9371 =head2 sort - perl pragma to control sort() behaviour
9372
9373 =over 4
9374
9375 =item SYNOPSIS
9376
9377 =item DESCRIPTION
9378
9379 =item CAVEATS
9380
9381 =back
9382
9383 =head2 strict - Perl pragma to restrict unsafe constructs
9384
9385 =over 4
9386
9387 =item SYNOPSIS
9388
9389 =item DESCRIPTION
9390
9391 C<strict refs>, C<strict vars>, C<strict subs>
9392
9393 =back
9394
9395 =head2 subs - Perl pragma to predeclare sub names
9396
9397 =over 4
9398
9399 =item SYNOPSIS
9400
9401 =item DESCRIPTION
9402
9403 =back
9404
9405 =head2 threads - Perl extension allowing use of interpreter based threads
9406 from perl
9407
9408 =over 4
9409
9410 =item SYNOPSIS
9411
9412 =item DESCRIPTION
9413
9414 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9415 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9416 threads->list();, async BLOCK;
9417
9418 =item WARNINGS
9419
9420 A thread exited while %d other threads were still running
9421
9422 =item TODO
9423
9424 =item BUGS
9425
9426 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9427 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9428
9429 =item AUTHOR and COPYRIGHT
9430
9431 =item SEE ALSO
9432
9433 =back
9434
9435 =head2 threadshared, threads::shared - Perl extension for sharing data
9436 structures between threads
9437
9438 =over 4
9439
9440 =item SYNOPSIS
9441
9442 =item DESCRIPTION
9443
9444 =item EXPORT
9445
9446 =item FUNCTIONS
9447
9448 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9449 cond_broadcast VARIABLE
9450
9451 =item NOTES
9452
9453 =item BUGS
9454
9455 =item AUTHOR
9456
9457 =item SEE ALSO
9458
9459 =back
9460
9461 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9462 code
9463
9464 =over 4
9465
9466 =item SYNOPSIS
9467
9468 =item DESCRIPTION
9469
9470 =over 4
9471
9472 =item Utility functions
9473
9474 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9475 utf8::encode($string), $flag = utf8::decode($string), $flag =
9476 utf8::valid(STRING)
9477
9478 =back
9479
9480 =item BUGS
9481
9482 =item SEE ALSO
9483
9484 =back
9485
9486 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9487
9488 =over 4
9489
9490 =item SYNOPSIS
9491
9492 =item DESCRIPTION
9493
9494 =back
9495
9496 =head2 version - Perl extension for Version Objects
9497
9498 =over 4
9499
9500 =item SYNOPSIS
9501
9502 =item DESCRIPTION
9503
9504 =over 4
9505
9506 =item What IS a version
9507
9508 Numeric Versions - any initial parameter which "looks like a number", see
9509 L<Numeric Versions>, V-String Versions - any initial parameter which
9510 contains more than one decimal point, contains an embedded underscore, or
9511 has a leading 'v' see L<V-String Versions>
9512
9513 =item Numeric Versions
9514
9515 =item V-String Versions
9516
9517 =item Object Methods
9518
9519 New Operator - Like all OO interfaces, the new() operator is used to
9520 initialize version objects.  One way to increment versions when programming
9521 is to use the CVS variable $Revision, which is automatically incremented by
9522 CVS every time the file is committed to the repository, Stringification -
9523 Any time a version object is used as a string, a stringified representation
9524 is returned in reduced form (no extraneous zeros):, Numification - although
9525 all mathematical operations on version objects are forbidden by default, it
9526 is possible to retrieve a number which roughly corresponds to the version
9527 object through the use of the $obj->numify method.  For formatting
9528 purposes, when displaying a number which corresponds a version object, all
9529 sub versions are assumed to have three decimal places.  So for example:,
9530 Comparison operators - Both cmp and <=> operators perform the same
9531 comparison between terms (upgrading to a version object automatically).
9532 Perl automatically generates all of the other comparison operators based on
9533 those two.  In addition to the obvious equalities listed below, appending a
9534 single trailing 0 term does not change the value of a version for
9535 comparison purposes.  In other words "v1.2" and "v1.2.0" are identical
9536 versions
9537
9538 =item Quoting
9539
9540 =item Types of Versions Objects
9541
9542 Ordinary versions - These are the versions that normal modules will use.
9543 Can contain as many subversions as required. In particular, those using
9544 RCS/CVS can use one of the following:, Beta versions - For module authors
9545 using CPAN, the  convention has been to note unstable releases with an
9546 underscore in the version string, see L<CPAN>.  Beta releases will test as
9547 being newer than the more recent stable release, and less than the next
9548 stable release.  For example:
9549
9550 =item Replacement UNIVERSAL::VERSION
9551
9552 =back
9553
9554 =item EXPORT
9555
9556 =item AUTHOR
9557
9558 =item SEE ALSO
9559
9560 =back
9561
9562 =head2 vmsish - Perl pragma to control VMS-specific language features
9563
9564 =over 4
9565
9566 =item SYNOPSIS
9567
9568 =item DESCRIPTION
9569
9570 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9571
9572 =back
9573
9574 =head2 warnings - Perl pragma to control optional warnings
9575
9576 =over 4
9577
9578 =item SYNOPSIS
9579
9580 =item DESCRIPTION
9581
9582 use warnings::register, warnings::enabled(), warnings::enabled($category),
9583 warnings::enabled($object), warnings::warn($message),
9584 warnings::warn($category, $message), warnings::warn($object, $message),
9585 warnings::warnif($message), warnings::warnif($category, $message),
9586 warnings::warnif($object, $message)
9587
9588 =back
9589
9590 =head2 warnings::register - warnings import function
9591
9592 =over 4
9593
9594 =item SYNOPSIS
9595
9596 =item DESCRIPTION
9597
9598 =back
9599
9600 =head1 MODULE DOCUMENTATION
9601
9602 =head2 AnyDBM_File - provide framework for multiple DBMs
9603
9604 =over 4
9605
9606 =item SYNOPSIS
9607
9608 =item DESCRIPTION
9609
9610 =over 4
9611
9612 =item DBM Comparisons
9613
9614 [0], [1], [2], [3]
9615
9616 =back
9617
9618 =item SEE ALSO
9619
9620 =back
9621
9622 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9623
9624 =over 4
9625
9626 =item VERSION
9627
9628 =item SYNOPSIS
9629
9630 =item DESCRIPTION
9631
9632 [0], [1], [2], [3], [4], [5]
9633
9634 =over 4
9635
9636 =item Typed lexicals
9637
9638 =item Type-specific attribute handlers
9639
9640 =item Non-interpretive attribute handlers
9641
9642 =item Phase-specific attribute handlers
9643
9644 =item Attributes as C<tie> interfaces
9645
9646 =back
9647
9648 =item EXAMPLES
9649
9650 =item DIAGNOSTICS
9651
9652 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9653 attributes>, C<Declaration of %s attribute in package %s may clash with
9654 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9655 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9656 be able to apply END handler>
9657
9658 =item AUTHOR
9659
9660 =item BUGS
9661
9662 =item COPYRIGHT
9663
9664 =back
9665
9666 =head2 AutoLoader - load subroutines only on demand
9667
9668 =over 4
9669
9670 =item SYNOPSIS
9671
9672 =item DESCRIPTION
9673
9674 =over 4
9675
9676 =item Subroutine Stubs
9677
9678 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9679
9680 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9681
9682 =item Package Lexicals
9683
9684 =item Not Using AutoLoader
9685
9686 =item B<AutoLoader> vs. B<SelfLoader>
9687
9688 =back
9689
9690 =item CAVEATS
9691
9692 =item SEE ALSO
9693
9694 =back
9695
9696 =head2 AutoSplit - split a package for autoloading
9697
9698 =over 4
9699
9700 =item SYNOPSIS
9701
9702 =item DESCRIPTION
9703
9704 $keep, $check, $modtime
9705
9706 =over 4
9707
9708 =item Multiple packages
9709
9710 =back
9711
9712 =item DIAGNOSTICS
9713
9714 =back
9715
9716 =head2 B - The Perl Compiler
9717
9718 =over 4
9719
9720 =item SYNOPSIS
9721
9722 =item DESCRIPTION
9723
9724 =item OVERVIEW
9725
9726 =item Utility Functions
9727
9728 =over 4
9729
9730 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
9731 objects
9732
9733 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation,
9734 C<init_av>, check_av, begin_av, end_av, comppadlist, regex_padav,
9735 C<main_cv>
9736
9737 =item Functions for Examining the Symbol Table
9738
9739 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
9740
9741 =item Functions Returning C<B::OP> objects or for walking op trees
9742
9743 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
9744
9745 =item Miscellaneous Utility Functions
9746
9747 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
9748 perlstring(STR), class(OBJ), threadsv_names
9749
9750 =back
9751
9752 =item OVERVIEW OF CLASSES
9753
9754 =over 4
9755
9756 =item SV-RELATED CLASSES
9757
9758 =item B::SV Methods
9759
9760 REFCNT, FLAGS
9761
9762 =item B::IV Methods
9763
9764 IV, IVX, UVX, int_value, needs64bits, packiv
9765
9766 =item B::NV Methods
9767
9768 NV, NVX
9769
9770 =item B::RV Methods
9771
9772 RV
9773
9774 =item B::PV Methods
9775
9776 PV, RV, PVX
9777
9778 =item B::PVMG Methods
9779
9780 MAGIC, SvSTASH
9781
9782 =item B::MAGIC Methods
9783
9784 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9785
9786 =item B::PVLV Methods
9787
9788 TARGOFF, TARGLEN, TYPE, TARG
9789
9790 =item B::BM Methods
9791
9792 USEFUL, PREVIOUS, RARE, TABLE
9793
9794 =item B::GV Methods
9795
9796 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9797 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9798
9799 =item B::IO Methods
9800
9801 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9802 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9803
9804 =item B::AV Methods
9805
9806 FILL, MAX, OFF, ARRAY, AvFLAGS
9807
9808 =item B::CV Methods
9809
9810 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
9811 XSUBANY, CvFLAGS, const_sv
9812
9813 =item B::HV Methods
9814
9815 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9816
9817 =item OP-RELATED CLASSES
9818
9819 =item B::OP Methods
9820
9821 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9822
9823 =item B::UNOP METHOD
9824
9825 first
9826
9827 =item B::BINOP METHOD
9828
9829 last
9830
9831 =item B::LOGOP METHOD
9832
9833 other
9834
9835 =item B::LISTOP METHOD
9836
9837 children
9838
9839 =item B::PMOP Methods
9840
9841 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9842 pmpermflags, precomp, pmoffet
9843
9844 =item B::SVOP METHOD
9845
9846 sv, gv
9847
9848 =item B::PADOP METHOD
9849
9850 padix
9851
9852 =item B::PVOP METHOD
9853
9854 pv
9855
9856 =item B::LOOP Methods
9857
9858 redoop, nextop, lastop
9859
9860 =item B::COP Methods
9861
9862 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
9863
9864 =back
9865
9866 =item AUTHOR
9867
9868 =back
9869
9870 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9871 bytecode
9872
9873 =over 4
9874
9875 =item SYNOPSIS
9876
9877 =item DESCRIPTION
9878
9879 %insn_data, @insn_name, @optype, @specialsv_name
9880
9881 =item AUTHOR
9882
9883 =back
9884
9885 =head2 B::Assembler - Assemble Perl bytecode
9886
9887 =over 4
9888
9889 =item SYNOPSIS
9890
9891 =item DESCRIPTION
9892
9893 =item AUTHORS
9894
9895 =back
9896
9897 =head2 B::Bblock - Walk basic blocks
9898
9899 =over 4
9900
9901 =item SYNOPSIS
9902
9903 =item DESCRIPTION
9904
9905 =over 4
9906
9907 =item Functions
9908
9909 B<find_leaders>
9910
9911 =back
9912
9913 =item AUTHOR
9914
9915 =back
9916
9917 =head2 B::Bytecode - Perl compiler's bytecode backend
9918
9919 =over 4
9920
9921 =item SYNOPSIS
9922
9923 =item DESCRIPTION
9924
9925 =item OPTIONS
9926
9927 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9928 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9929 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9930
9931 =item EXAMPLES
9932
9933 =item BUGS
9934
9935 =item AUTHORS
9936
9937 =back
9938
9939 =head2 B::C - Perl compiler's C backend
9940
9941 =over 4
9942
9943 =item SYNOPSIS
9944
9945 =item DESCRIPTION
9946
9947 =item OPTIONS
9948
9949 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9950 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9951 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9952 B<-llimit>
9953
9954 =item EXAMPLES
9955
9956 =item BUGS
9957
9958 =item AUTHOR
9959
9960 =back
9961
9962 =head2 B::CC - Perl compiler's optimized C translation backend
9963
9964 =over 4
9965
9966 =item SYNOPSIS
9967
9968 =item DESCRIPTION
9969
9970 =item OPTIONS
9971
9972 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9973 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9974 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9975
9976 =item EXAMPLES
9977
9978 =item BUGS
9979
9980 =item DIFFERENCES
9981
9982 =over 4
9983
9984 =item Loops
9985
9986 =item Context of ".."
9987
9988 =item Arithmetic
9989
9990 =item Deprecated features
9991
9992 =back
9993
9994 =item AUTHOR
9995
9996 =back
9997
9998 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9999
10000 =over 4
10001
10002 =item SYNOPSIS
10003
10004 =item DESCRIPTION
10005
10006 =item EXAMPLE
10007
10008 =item OPTIONS
10009
10010 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
10011 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
10012 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10013
10014 =item FORMATTING SPECIFICATIONS
10015
10016 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10017 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10018 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10019 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10020 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10021 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10022 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
10023 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10024
10025 =item ABBREVIATIONS
10026
10027 =over 4
10028
10029 =item OP flags abbreviations
10030
10031 =item OP class abbreviations
10032
10033 =back
10034
10035 =item Using B::Concise outside of the O framework
10036
10037 =item AUTHOR
10038
10039 =back
10040
10041 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10042
10043 =over 4
10044
10045 =item SYNOPSIS
10046
10047 =item DESCRIPTION
10048
10049 =item AUTHOR
10050
10051 =back
10052
10053 =head2 B::Deparse - Perl compiler backend to produce perl code
10054
10055 =over 4
10056
10057 =item SYNOPSIS
10058
10059 =item DESCRIPTION
10060
10061 =item OPTIONS
10062
10063 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
10064 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10065
10066 =item USING B::Deparse AS A MODULE
10067
10068 =over 4
10069
10070 =item Synopsis
10071
10072 =item Description
10073
10074 =item new
10075
10076 =item ambient_pragmas
10077
10078 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10079
10080 =item coderef2text
10081
10082 =back
10083
10084 =item BUGS
10085
10086 =item AUTHOR
10087
10088 =back
10089
10090 =head2 B::Disassembler - Disassemble Perl bytecode
10091
10092 =over 4
10093
10094 =item SYNOPSIS
10095
10096 =item DESCRIPTION
10097
10098 =item AUTHOR
10099
10100 =back
10101
10102 =head2 B::Lint - Perl lint
10103
10104 =over 4
10105
10106 =item SYNOPSIS
10107
10108 =item DESCRIPTION
10109
10110 =item OPTIONS AND LINT CHECKS
10111
10112 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10113 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10114 B<regexp-variables>, B<all>, B<none>
10115
10116 =item NON LINT-CHECK OPTIONS
10117
10118 B<-u Package>
10119
10120 =item BUGS
10121
10122 =item AUTHOR
10123
10124 =back
10125
10126 =head2 B::O, O - Generic interface to Perl Compiler backends
10127
10128 =over 4
10129
10130 =item SYNOPSIS
10131
10132 =item DESCRIPTION
10133
10134 =item CONVENTIONS
10135
10136 =item IMPLEMENTATION
10137
10138 =item BUGS
10139
10140 =item AUTHOR
10141
10142 =back
10143
10144 =head2 B::Showlex - Show lexical variables used in functions or files
10145
10146 =over 4
10147
10148 =item SYNOPSIS
10149
10150 =item DESCRIPTION
10151
10152 =item AUTHOR
10153
10154 =back
10155
10156 =head2 B::Stackobj - Helper module for CC backend
10157
10158 =over 4
10159
10160 =item SYNOPSIS
10161
10162 =item DESCRIPTION
10163
10164 =item AUTHOR
10165
10166 =back
10167
10168 =head2 B::Stash - show what stashes are loaded
10169
10170 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10171
10172 =over 4
10173
10174 =item SYNOPSIS
10175
10176 =item DESCRIPTION
10177
10178 =item AUTHOR
10179
10180 =back
10181
10182 =head2 B::Xref - Generates cross reference reports for Perl programs
10183
10184 =over 4
10185
10186 =item SYNOPSIS
10187
10188 =item DESCRIPTION
10189
10190 =item OPTIONS
10191
10192 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10193
10194 =item BUGS
10195
10196 =item AUTHOR
10197
10198 =back
10199
10200 =head2 Bblock, B::Bblock - Walk basic blocks
10201
10202 =over 4
10203
10204 =item SYNOPSIS
10205
10206 =item DESCRIPTION
10207
10208 =over 4
10209
10210 =item Functions
10211
10212 B<find_leaders>
10213
10214 =back
10215
10216 =item AUTHOR
10217
10218 =back
10219
10220 =head2 Benchmark - benchmark running times of Perl code
10221
10222 =over 4
10223
10224 =item SYNOPSIS
10225
10226 =item DESCRIPTION
10227
10228 =over 4
10229
10230 =item Methods
10231
10232 new, debug, iters
10233
10234 =item Standard Exports
10235
10236 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10237 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10238 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10239
10240 =item Optional Exports
10241
10242 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10243 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10244 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10245
10246 =item :hireswallclock
10247
10248 =back
10249
10250 =item NOTES
10251
10252 =item EXAMPLES
10253
10254 =item INHERITANCE
10255
10256 =item CAVEATS
10257
10258 =item SEE ALSO
10259
10260 =item AUTHORS
10261
10262 =item MODIFICATION HISTORY
10263
10264 =back
10265
10266 =head2 ByteLoader - load byte compiled perl code
10267
10268 =over 4
10269
10270 =item SYNOPSIS
10271
10272 =item DESCRIPTION
10273
10274 =item AUTHOR
10275
10276 =item SEE ALSO
10277
10278 =back
10279
10280 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10281
10282 =over 4
10283
10284 =item SYNOPSIS
10285
10286 =item DESCRIPTION
10287
10288 =item OPTIONS
10289
10290 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
10291 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
10292 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
10293
10294 =item EXAMPLES
10295
10296 =item BUGS
10297
10298 =item AUTHORS
10299
10300 =back
10301
10302 =head2 CGI - Simple Common Gateway Interface Class
10303
10304 =over 4
10305
10306 =item SYNOPSIS
10307
10308 =item ABSTRACT
10309
10310 =item DESCRIPTION
10311
10312 =over 4
10313
10314 =item PROGRAMMING STYLE
10315
10316 =item CALLING CGI.PM ROUTINES
10317
10318 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10319
10320 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10321
10322 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10323
10324 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10325
10326 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10327
10328 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10329
10330 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10331
10332 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10333
10334 =item DELETING A PARAMETER COMPLETELY:
10335
10336 =item DELETING ALL PARAMETERS:
10337
10338 =item DIRECT ACCESS TO THE PARAMETER LIST:
10339
10340 =item FETCHING THE PARAMETER LIST AS A HASH:
10341
10342 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10343
10344 =item RETRIEVING CGI ERRORS
10345
10346 =item USING THE FUNCTION-ORIENTED INTERFACE
10347
10348 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10349 B<:standard>, B<:all>
10350
10351 =item PRAGMAS
10352
10353 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10354 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10355 -private_tempfiles
10356
10357 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10358
10359 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10360 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10361 a </ul> tag)
10362
10363 =back
10364
10365 =item GENERATING DYNAMIC DOCUMENTS
10366
10367 =over 4
10368
10369 =item CREATING A STANDARD HTTP HEADER:
10370
10371 =item GENERATING A REDIRECTION HEADER
10372
10373 =item CREATING THE HTML DOCUMENT HEADER
10374
10375 B<Parameters:>, 4, 5, 6..
10376
10377 =item ENDING THE HTML DOCUMENT:
10378
10379 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10380
10381 =item OBTAINING THE SCRIPT'S URL
10382
10383 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10384 (B<-query_string>), B<-base>
10385
10386 =item MIXING POST AND URL PARAMETERS
10387
10388 =back
10389
10390 =item CREATING STANDARD HTML ELEMENTS:
10391
10392 =over 4
10393
10394 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10395
10396 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10397
10398 =item HTML SHORTCUTS AND LIST INTERPOLATION
10399
10400 =item NON-STANDARD HTML SHORTCUTS
10401
10402 =item AUTOESCAPING HTML
10403
10404 $escaped_string = escapeHTML("unescaped string");, $charset =
10405 charset([$charset]);, $flag = autoEscape([$flag]);
10406
10407 =item PRETTY-PRINTING HTML
10408
10409 =back
10410
10411 =item CREATING FILL-OUT FORMS:
10412
10413 =over 4
10414
10415 =item CREATING AN ISINDEX TAG
10416
10417 =item STARTING AND ENDING A FORM
10418
10419 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10420
10421 =item CREATING A TEXT FIELD
10422
10423 B<Parameters>
10424
10425 =item CREATING A BIG TEXT FIELD
10426
10427 =item CREATING A PASSWORD FIELD
10428
10429 =item CREATING A FILE UPLOAD FIELD
10430
10431 B<Parameters>
10432
10433 =item CREATING A POPUP MENU
10434
10435 =item CREATING AN OPTION GROUP
10436
10437 =item CREATING A SCROLLING LIST
10438
10439 B<Parameters:>
10440
10441 =item CREATING A GROUP OF RELATED CHECKBOXES
10442
10443 B<Parameters:>
10444
10445 =item CREATING A STANDALONE CHECKBOX
10446
10447 B<Parameters:>
10448
10449 =item CREATING A RADIO BUTTON GROUP
10450
10451 B<Parameters:>
10452
10453 =item CREATING A SUBMIT BUTTON
10454
10455 B<Parameters:>
10456
10457 =item CREATING A RESET BUTTON
10458
10459 =item CREATING A DEFAULT BUTTON
10460
10461 =item CREATING A HIDDEN FIELD
10462
10463 B<Parameters:>
10464
10465 =item CREATING A CLICKABLE IMAGE BUTTON
10466
10467 B<Parameters:>
10468
10469 =item CREATING A JAVASCRIPT ACTION BUTTON
10470
10471 =back
10472
10473 =item HTTP COOKIES
10474
10475 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10476 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10477
10478 =item WORKING WITH FRAMES
10479
10480 1. Create a <Frameset> document, 2. Specify the destination for the
10481 document in the HTTP header, 3. Specify the destination for the document in
10482 the <form> tag
10483
10484 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10485
10486 =item DEBUGGING
10487
10488 =over 4
10489
10490 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10491
10492 =back
10493
10494 =item FETCHING ENVIRONMENT VARIABLES
10495
10496 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10497 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10498 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10499 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10500 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10501
10502 =item USING NPH SCRIPTS
10503
10504 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10505 parameters
10506
10507 =item Server Push
10508
10509 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10510
10511 =item Avoiding Denial of Service Attacks
10512
10513 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10514 basis>, B<2. Globally for all scripts>
10515
10516 =item COMPATIBILITY WITH CGI-LIB.PL
10517
10518 =item AUTHOR INFORMATION
10519
10520 =item CREDITS
10521
10522 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10523 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10524 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10525 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10526 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10527 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10528 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10529 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10530 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10531 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10532 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10533 ...and many many more..
10534
10535 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10536
10537 =item BUGS
10538
10539 =item SEE ALSO
10540
10541 =back
10542
10543 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10544
10545 =over 4
10546
10547 =item SYNOPSIS
10548
10549 =item ABSTRACT
10550
10551 =item DESCRIPTION
10552
10553 =item AUTHOR INFORMATION
10554
10555 =item BUGS
10556
10557 =item SEE ALSO
10558
10559 =back
10560
10561 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10562 other) error log
10563
10564 =over 4
10565
10566 =item SYNOPSIS
10567
10568 =item DESCRIPTION
10569
10570 =item REDIRECTING ERROR MESSAGES
10571
10572 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10573
10574 =over 4
10575
10576 =item Changing the default message
10577
10578 =back
10579
10580 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10581
10582 =item OVERRIDING THE NAME OF THE PROGRAM
10583
10584 =item AUTHORS
10585
10586 =item SEE ALSO
10587
10588 =back
10589
10590 =head2 CGI::Cookie - Interface to Netscape Cookies
10591
10592 =over 4
10593
10594 =item SYNOPSIS
10595
10596 =item DESCRIPTION
10597
10598 =item USING CGI::Cookie
10599
10600 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10601
10602 =over 4
10603
10604 =item Creating New Cookies
10605
10606 =item Sending the Cookie to the Browser
10607
10608 =item Recovering Previous Cookies
10609
10610 =item Manipulating Cookies
10611
10612 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10613
10614 =back
10615
10616 =item AUTHOR INFORMATION
10617
10618 =item BUGS
10619
10620 =item SEE ALSO
10621
10622 =back
10623
10624 =head2 CGI::Fast - CGI Interface for Fast CGI
10625
10626 =over 4
10627
10628 =item SYNOPSIS
10629
10630 =item DESCRIPTION
10631
10632 =item OTHER PIECES OF THE PUZZLE
10633
10634 =item WRITING FASTCGI PERL SCRIPTS
10635
10636 =item INSTALLING FASTCGI SCRIPTS
10637
10638 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10639
10640 =item EXTERNAL FASTCGI SERVER INVOCATION
10641
10642 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10643
10644 =item CAVEATS
10645
10646 =item AUTHOR INFORMATION
10647
10648 =item BUGS
10649
10650 =item SEE ALSO
10651
10652 =back
10653
10654 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10655
10656 =over 4
10657
10658 =item SYNOPSIS
10659
10660 =item DESCRIPTION
10661
10662 =over 4
10663
10664 =item Tags that won't be formatted
10665
10666 =item Customizing the Indenting
10667
10668 =back
10669
10670 =item BUGS
10671
10672 =item AUTHOR
10673
10674 =item SEE ALSO
10675
10676 =back
10677
10678 =head2 CGI::Push - Simple Interface to Server Push
10679
10680 =over 4
10681
10682 =item SYNOPSIS
10683
10684 =item DESCRIPTION
10685
10686 =item USING CGI::Push
10687
10688 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10689
10690 =over 4
10691
10692 =item Heterogeneous Pages
10693
10694 =item Changing the Page Delay on the Fly
10695
10696 =back
10697
10698 =item INSTALLING CGI::Push SCRIPTS
10699
10700 =item AUTHOR INFORMATION
10701
10702 =item BUGS
10703
10704 =item SEE ALSO
10705
10706 =back
10707
10708 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10709
10710 =over 4
10711
10712 =item SYNOPSIS
10713
10714 =item ABSTRACT
10715
10716 =item DESCRIPTION
10717
10718 =item AUTHOR INFORMATION
10719
10720 =item BUGS
10721
10722 =item SEE ALSO
10723
10724 =back
10725
10726 =head2 CGI::Util - Internal utilities used by CGI module
10727
10728 =over 4
10729
10730 =item SYNOPSIS
10731
10732 =item DESCRIPTION
10733
10734 =item AUTHOR INFORMATION
10735
10736 =item SEE ALSO
10737
10738 =back
10739
10740 =head2 CPAN - query, download and build perl modules from CPAN sites
10741
10742 =over 4
10743
10744 =item SYNOPSIS
10745
10746 =item STATUS
10747
10748 =item DESCRIPTION
10749
10750 =over 4
10751
10752 =item Interactive Mode
10753
10754 Searching for authors, bundles, distribution files and modules, make, test,
10755 install, clean  modules or distributions, get, readme, look module or
10756 distribution, ls author, Signals
10757
10758 =item CPAN::Shell
10759
10760 =item autobundle
10761
10762 =item recompile
10763
10764 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10765
10766 =item Programmer's interface
10767
10768 expand($type,@things), expandany(@things), Programming Examples
10769
10770 =item Methods in the other Classes
10771
10772 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10773 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10774 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10775 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10776 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10777 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10778 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10779 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10780 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10781 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10782 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10783 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10784 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10785 CPAN::Distribution::look(), CPAN::Distribution::make(),
10786 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10787 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10788 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10789 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10790 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10791 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10792 CPAN::Module::description(), CPAN::Module::force($method,@args),
10793 CPAN::Module::get(), CPAN::Module::inst_file(),
10794 CPAN::Module::inst_version(), CPAN::Module::install(),
10795 CPAN::Module::look(), CPAN::Module::make(),
10796 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10797 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10798
10799 =item Cache Manager
10800
10801 =item Bundles
10802
10803 =item Prerequisites
10804
10805 =item Finding packages and VERSION
10806
10807 =item Debugging
10808
10809 =item Floppy, Zip, Offline Mode
10810
10811 =back
10812
10813 =item CONFIGURATION
10814
10815 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10816 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10817 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10818 [unshift|push|splice] E<lt>listE<gt>>
10819
10820 =over 4
10821
10822 =item Note on urllist parameter's format
10823
10824 =item urllist parameter has CD-ROM support
10825
10826 =back
10827
10828 =item SECURITY
10829
10830 =item EXPORT
10831
10832 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10833
10834 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10835
10836 =over 4
10837
10838 =item Three basic types of firewalls
10839
10840 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10841
10842 =item Configuring lynx or ncftp for going through a firewall
10843
10844 =back
10845
10846 =item FAQ
10847
10848 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10849
10850 =item BUGS
10851
10852 =item AUTHOR
10853
10854 =item TRANSLATIONS
10855
10856 =item SEE ALSO
10857
10858 =back
10859
10860 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10861
10862 =over 4
10863
10864 =item SYNOPSIS
10865
10866 =item DESCRIPTION
10867
10868 =back
10869
10870 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10871 module
10872
10873 =over 4
10874
10875 =item SYNOPSIS
10876
10877 =item DESCRIPTION
10878
10879 =item  SEE ALSO
10880
10881 =back
10882
10883 =head2 Carp, carp    - warn of errors (from perspective of caller)
10884
10885 =over 4
10886
10887 =item SYNOPSIS
10888
10889 =item DESCRIPTION
10890
10891 =over 4
10892
10893 =item Forcing a Stack Trace
10894
10895 =back
10896
10897 =item BUGS
10898
10899 =back
10900
10901 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10902
10903 =head2 Class::ISA -- report the search path for a class's ISA tree
10904
10905 =over 4
10906
10907 =item SYNOPSIS
10908
10909 =item DESCRIPTION
10910
10911 =item FUNCTIONS
10912
10913 the function Class::ISA::super_path($CLASS), the function
10914 Class::ISA::self_and_super_path($CLASS), the function
10915 Class::ISA::self_and_super_versions($CLASS)
10916
10917 =item CAUTIONARY NOTES
10918
10919 =item COPYRIGHT
10920
10921 =item AUTHOR
10922
10923 =back
10924
10925 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10926
10927 =over 4
10928
10929 =item SYNOPSIS
10930
10931 =item DESCRIPTION
10932
10933 =over 4
10934
10935 =item The C<struct()> function
10936
10937 =item Class Creation at Compile Time
10938
10939 =item Element Types and Accessor Methods
10940
10941 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10942 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10943
10944 =item Initializing with C<new>
10945
10946 =back
10947
10948 =item EXAMPLES
10949
10950 Example 1, Example 2, Example 3
10951
10952 =item Author and Modification History
10953
10954 =back
10955
10956 =head2 Config - access Perl configuration information
10957
10958 =over 4
10959
10960 =item SYNOPSIS
10961
10962 =item DESCRIPTION
10963
10964 myconfig(), config_sh(), config_re($regex), config_vars(@names)
10965
10966 =item EXAMPLE
10967
10968 =item WARNING
10969
10970 =item GLOSSARY
10971
10972 =over 4
10973
10974 =item _
10975
10976 C<_a>, C<_exe>, C<_o>
10977
10978 =item a
10979
10980 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10981 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10982 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10983 C<asctime_r_proto>, C<awk>
10984
10985 =item b
10986
10987 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10988
10989 =item c
10990
10991 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10992 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10993 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10994 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10995 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10996 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10997 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10998
10999 =item d
11000
11001 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11002 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11003 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11004 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11005 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11006 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11007 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11008 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11009 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11010 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11011 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11012 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11013 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11014 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11015 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11016 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11017 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11018 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11019 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11020 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11021 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11022 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11023 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11024 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11025 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11026 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11027 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11028 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11029 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11030 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11031 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11032 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11033 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11034 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11035 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11036 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11037 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11038 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11039 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11040 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11041 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11042 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11043 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11044 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11045 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11046 C<d_nanosleep>, C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>,
11047 C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
11048 C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
11049 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
11050 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
11051 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
11052 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
11053 C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>,
11054 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
11055 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
11056 C<d_random_r>, C<d_readdir64_r>, C<d_readdir>, C<d_readdir_r>,
11057 C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
11058 C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
11059 C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
11060 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
11061 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
11062 C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>,
11063 C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>,
11064 C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>,
11065 C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
11066 C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>,
11067 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
11068 C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>,
11069 C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>,
11070 C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>,
11071 C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>,
11072 C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>,
11073 C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>,
11074 C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
11075 C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
11076 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
11077 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
11078 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
11079 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
11080 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
11081 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
11082 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
11083 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
11084 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
11085 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
11086 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
11087 C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>,
11088 C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
11089 C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
11090 C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
11091 C<db_version_major>, C<db_version_minor>, C<db_version_patch>,
11092 C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
11093 C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11094
11095 =item e
11096
11097 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11098 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11099 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11100 C<expr>, C<extensions>, C<extras>
11101
11102 =item f
11103
11104 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11105 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11106 C<full_sed>
11107
11108 =item g
11109
11110 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11111 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11112 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11113 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11114 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11115 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11116 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11117 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11118 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11119 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11120
11121 =item h
11122
11123 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11124 C<html3dir>, C<html3direxp>
11125
11126 =item i
11127
11128 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11129 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11130 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11131 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11132 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11133 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11134 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11135 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11136 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11137 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11138 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11139 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11140 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11141 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11142 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11143 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11144 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11145 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11146 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11147 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11148 C<installprefixexp>, C<installprivlib>, C<installscript>,
11149 C<installsitearch>, C<installsitebin>, C<installsitehtml1>,
11150 C<installsitehtml3>, C<installsitelib>, C<installsiteman1>,
11151 C<installsiteman3>, C<installsitescript>, C<installstyle>,
11152 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11153 C<installvendorhtml1>, C<installvendorhtml3>, C<installvendorlib>,
11154 C<installvendorman1>, C<installvendorman3>, C<installvendorscript>,
11155 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11156
11157 =item k
11158
11159 C<known_extensions>, C<ksh>
11160
11161 =item l
11162
11163 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11164 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11165 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11166 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11167 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11168 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11169 C<lseektype>
11170
11171 =item m
11172
11173 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11174 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11175 C<man3direxp>, C<man3ext>
11176
11177 =item M
11178
11179 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
11180 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
11181
11182 =item n
11183
11184 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11185 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11186 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11187 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11188 C<nvsize>, C<nvtype>
11189
11190 =item o
11191
11192 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11193 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11194
11195 =item p
11196
11197 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11198 C<perl>, C<perl_patchlevel>
11199
11200 =item P
11201
11202 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11203 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11204 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
11205 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
11206
11207 =item q
11208
11209 C<quadkind>, C<quadtype>
11210
11211 =item r
11212
11213 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11214 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11215 C<rmail>, C<run>, C<runnm>
11216
11217 =item s
11218
11219 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11220 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11221 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11222 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11223 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11224 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11225 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11226 C<sitebinexp>, C<sitehtml1>, C<sitehtml1exp>, C<sitehtml3>,
11227 C<sitehtml3exp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteman1>,
11228 C<siteman1exp>, C<siteman3>, C<siteman3exp>, C<siteprefix>,
11229 C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, C<sizesize>,
11230 C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, C<socketlib>,
11231 C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, C<sPRId64>,
11232 C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, C<sPRIgldbl>,
11233 C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>,
11234 C<srand48_r_proto>, C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>,
11235 C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
11236 C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
11237 C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, C<submit>,
11238 C<subversion>, C<sysman>
11239
11240 =item t
11241
11242 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11243 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11244 C<ttyname_r_proto>
11245
11246 =item u
11247
11248 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11249 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11250 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11251 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11252 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11253 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11254 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11255 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11256 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11257 C<uvXUformat>
11258
11259 =item v
11260
11261 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11262 C<vendorhtml1>, C<vendorhtml1exp>, C<vendorhtml3>, C<vendorhtml3exp>,
11263 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorman1>,
11264 C<vendorman1exp>, C<vendorman3>, C<vendorman3exp>, C<vendorprefix>,
11265 C<vendorprefixexp>, C<vendorscript>, C<vendorscriptexp>, C<version>,
11266 C<version_patchlevel_string>, C<versiononly>, C<vi>, C<voidflags>
11267
11268 =item x
11269
11270 C<xlibpth>, C<xs_apiversion>
11271
11272 =item y
11273
11274 C<yacc>, C<yaccflags>
11275
11276 =item z
11277
11278 C<zcat>, C<zip>
11279
11280 =back
11281
11282 =item NOTE
11283
11284 =back
11285
11286 =head2 Cwd - get pathname of current working directory
11287
11288 =over 4
11289
11290 =item SYNOPSIS
11291
11292 =item DESCRIPTION
11293
11294 =over 4
11295
11296 =item getcwd and friends
11297
11298 getcwd, cwd, fastcwd, fastgetcwd
11299
11300 =item abs_path and friends
11301
11302 abs_path, realpath, fast_abs_path
11303
11304 =item $ENV{PWD}
11305
11306 =back
11307
11308 =item NOTES
11309
11310 =item SEE ALSO
11311
11312 =back
11313
11314 =head2 DB - programmatic interface to the Perl debugging API (draft,
11315 subject to
11316 change)
11317
11318 =over 4
11319
11320 =item SYNOPSIS
11321
11322 =item DESCRIPTION
11323
11324 =over 4
11325
11326 =item Global Variables
11327
11328  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
11329 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
11330 $DB::lineno
11331
11332 =item API Methods
11333
11334 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11335 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11336
11337 =item Client Callback Methods
11338
11339 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11340 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11341 CLIENT->output(LIST)
11342
11343 =back
11344
11345 =item BUGS
11346
11347 =item AUTHOR
11348
11349 =back
11350
11351 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11352
11353 =over 4
11354
11355 =item SYNOPSIS
11356
11357 =item DESCRIPTION
11358
11359 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11360
11361 =over 4
11362
11363 =item Using DB_File with Berkeley DB version 2 or greater
11364
11365 =item Interface to Berkeley DB
11366
11367 =item Opening a Berkeley DB Database File
11368
11369 =item Default Parameters
11370
11371 =item In Memory Databases
11372
11373 =back
11374
11375 =item DB_HASH
11376
11377 =over 4
11378
11379 =item A Simple Example
11380
11381 =back
11382
11383 =item DB_BTREE
11384
11385 =over 4
11386
11387 =item Changing the BTREE sort order
11388
11389 =item Handling Duplicate Keys
11390
11391 =item The get_dup() Method
11392
11393 =item The find_dup() Method
11394
11395 =item The del_dup() Method
11396
11397 =item Matching Partial Keys
11398
11399 =back
11400
11401 =item DB_RECNO
11402
11403 =over 4
11404
11405 =item The 'bval' Option
11406
11407 =item A Simple Example
11408
11409 =item Extra RECNO Methods
11410
11411 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11412 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11413 length, elements);>
11414
11415 =item Another Example
11416
11417 =back
11418
11419 =item THE API INTERFACE
11420
11421 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11422 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11423 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11424 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11425
11426 =item DBM FILTERS
11427
11428 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11429 B<filter_fetch_value>
11430
11431 =over 4
11432
11433 =item The Filter
11434
11435 =item An Example -- the NULL termination problem.
11436
11437 =item Another Example -- Key is a C int.
11438
11439 =back
11440
11441 =item HINTS AND TIPS
11442
11443 =over 4
11444
11445 =item Locking: The Trouble with fd
11446
11447 =item Safe ways to lock a database
11448
11449 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11450
11451 =item Sharing Databases With C Applications
11452
11453 =item The untie() Gotcha
11454
11455 =back
11456
11457 =item COMMON QUESTIONS
11458
11459 =over 4
11460
11461 =item Why is there Perl source in my database?
11462
11463 =item How do I store complex data structures with DB_File?
11464
11465 =item What does "Invalid Argument" mean?
11466
11467 =item What does "Bareword 'DB_File' not allowed" mean?
11468
11469 =back
11470
11471 =item REFERENCES
11472
11473 =item HISTORY
11474
11475 =item BUGS
11476
11477 =item AVAILABILITY
11478
11479 =item COPYRIGHT
11480
11481 =item SEE ALSO
11482
11483 =item AUTHOR
11484
11485 =back
11486
11487 =head2 Data::Dumper - stringified perl data structures, suitable for both
11488 printing and C<eval>
11489
11490 =over 4
11491
11492 =item SYNOPSIS
11493
11494 =item DESCRIPTION
11495
11496 =over 4
11497
11498 =item Methods
11499
11500 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11501 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11502 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11503 I<$OBJ>->Reset
11504
11505 =item Functions
11506
11507 Dumper(I<LIST>)
11508
11509 =item Configuration Variables or Methods
11510
11511 =item Exports
11512
11513 Dumper
11514
11515 =back
11516
11517 =item EXAMPLES
11518
11519 =item BUGS
11520
11521 =item AUTHOR
11522
11523 =item VERSION
11524
11525 =item SEE ALSO
11526
11527 =back
11528
11529 =head2 Devel::DProf - a Perl code profiler
11530
11531 =over 4
11532
11533 =item SYNOPSIS
11534
11535 =item DESCRIPTION
11536
11537 =item PROFILE FORMAT
11538
11539 =item AUTOLOAD
11540
11541 =item ENVIRONMENT
11542
11543 =item BUGS
11544
11545 =item SEE ALSO
11546
11547 =back
11548
11549 =head2 Devel::PPPort - Perl/Pollution/Portability
11550
11551 =over 4
11552
11553 =item SYNOPSIS
11554
11555 =item DESCRIPTION
11556
11557 =over 4
11558
11559 =item WriteFile
11560
11561 =back
11562
11563 =item ppport.h
11564
11565 =item AUTHOR
11566
11567 =item SEE ALSO
11568
11569 =back
11570
11571 =head2 Devel::Peek - A data debugging tool for the XS programmer
11572
11573 =over 4
11574
11575 =item SYNOPSIS
11576
11577 =item DESCRIPTION
11578
11579 =over 4
11580
11581 =item Runtime debugging
11582
11583 =item Memory footprint debugging
11584
11585 =back
11586
11587 =item EXAMPLES
11588
11589 =over 4
11590
11591 =item A simple scalar string
11592
11593 =item A simple scalar number
11594
11595 =item A simple scalar with an extra reference
11596
11597 =item A reference to a simple scalar
11598
11599 =item A reference to an array
11600
11601 =item A reference to a hash
11602
11603 =item Dumping a large array or hash
11604
11605 =item A reference to an SV which holds a C pointer
11606
11607 =item A reference to a subroutine
11608
11609 =back
11610
11611 =item EXPORTS
11612
11613 =item BUGS
11614
11615 =item AUTHOR
11616
11617 =item SEE ALSO
11618
11619 =back
11620
11621 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11622
11623 =over 4
11624
11625 =item SYNOPSIS
11626
11627 =item DESCRIPTION
11628
11629 =back
11630
11631 =head2 Digest:: - Modules that calculate message digests
11632
11633 =over 4
11634
11635 =item SYNOPSIS
11636
11637 =item DESCRIPTION
11638
11639 I<binary>, I<hex>, I<base64>
11640
11641 =item OO INTERFACE
11642
11643 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11644 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
11645 $ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
11646 $ctx->hexdigest, $ctx->b64digest
11647
11648 =item SEE ALSO
11649
11650 =item AUTHOR
11651
11652 =back
11653
11654 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11655
11656 =over 4
11657
11658 =item SYNOPSIS
11659
11660 =item DESCRIPTION
11661
11662 =item FUNCTIONS
11663
11664 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11665
11666 =item METHODS
11667
11668 $md5 = Digest::MD5->new, $md5->clone, $md5->reset, $md5->add($data,...),
11669 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11670
11671 =item EXAMPLES
11672
11673 =item SEE ALSO
11674
11675 =item COPYRIGHT
11676
11677 =item AUTHORS
11678
11679 =back
11680
11681 =head2 DirHandle - supply object methods for directory handles
11682
11683 =over 4
11684
11685 =item SYNOPSIS
11686
11687 =item DESCRIPTION
11688
11689 =item NOTES
11690
11691 =back
11692
11693 =head2 Dumpvalue - provides screen dump of Perl data.
11694
11695 =over 4
11696
11697 =item SYNOPSIS
11698
11699 =item DESCRIPTION
11700
11701 =over 4
11702
11703 =item Creation
11704
11705 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11706 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11707 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11708 stopDbSignal
11709
11710 =item Methods
11711
11712 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11713 compactDump, veryCompact, set, get
11714
11715 =back
11716
11717 =back
11718
11719 =head2 DynaLoader - Dynamically load C libraries into Perl code
11720
11721 =over 4
11722
11723 =item SYNOPSIS
11724
11725 =item DESCRIPTION
11726
11727 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11728 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11729 dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
11730 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11731 bootstrap()
11732
11733 =item AUTHOR
11734
11735 =back
11736
11737 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11738 Perl code
11739
11740 =over 4
11741
11742 =item SYNOPSIS
11743
11744 =item DESCRIPTION
11745
11746 =item AUTHOR
11747
11748 =back
11749
11750 =head2 Encode - character encodings
11751
11752 =over 4
11753
11754 =item SYNOPSIS
11755
11756 =over 4
11757
11758 =item Table of Contents
11759
11760 =back
11761
11762 =item DESCRIPTION
11763
11764 =over 4
11765
11766 =item TERMINOLOGY
11767
11768 =back
11769
11770 =item PERL ENCODING API
11771
11772 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11773 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11774 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11775 CHECK]);
11776
11777 =over 4
11778
11779 =item Listing available encodings
11780
11781 =item Defining Aliases
11782
11783 =back
11784
11785 =item Encoding via PerlIO
11786
11787 =item Handling Malformed Data
11788
11789 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11790 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11791 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11792 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11793 bitmask
11794
11795 =over 4
11796
11797 =item Unimplemented fallback schemes
11798
11799 =back
11800
11801 =item Defining Encodings
11802
11803 =item The UTF-8 flag
11804
11805 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11806
11807 =over 4
11808
11809 =item Messing with Perl's Internals
11810
11811 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11812
11813 =back
11814
11815 =item SEE ALSO
11816
11817 =item MAINTAINER
11818
11819 =back
11820
11821 =head2 Encode::Alias - alias definitions to encodings
11822
11823 =over 4
11824
11825 =item SYNOPSIS
11826
11827 =item DESCRIPTION
11828
11829 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11830 reference, e.g.:
11831
11832 =over 4
11833
11834 =item Alias overloading
11835
11836 =back
11837
11838 =item SEE ALSO
11839
11840 =back
11841
11842 =head2 Encode::Byte - Single Byte Encodings
11843
11844 =over 4
11845
11846 =item SYNOPSIS
11847
11848 =item ABSTRACT
11849
11850 =item DESCRIPTION
11851
11852 =item SEE ALSO
11853
11854 =back
11855
11856 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11857
11858 =head2 Encode::CN - China-based Chinese Encodings
11859
11860 =over 4
11861
11862 =item SYNOPSIS
11863
11864 =item DESCRIPTION
11865
11866 =item NOTES
11867
11868 =item BUGS
11869
11870 =item SEE ALSO
11871
11872 =back
11873
11874 =head2 Encode::CN::HZ -- internally used by Encode::CN
11875
11876 =head2 Encode::Config -- internally used by Encode
11877
11878 =head2 Encode::EBCDIC - EBCDIC Encodings
11879
11880 =over 4
11881
11882 =item SYNOPSIS
11883
11884 =item ABSTRACT
11885
11886 =item DESCRIPTION
11887
11888 =item SEE ALSO
11889
11890 =back
11891
11892 =head2 Encode::Encoding - Encode Implementation Base Class
11893
11894 =over 4
11895
11896 =item SYNOPSIS
11897
11898 =item DESCRIPTION
11899
11900 =over 4
11901
11902 =item Methods you should implement
11903
11904 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11905 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11906
11907 =item Other methods defined in Encode::Encodings
11908
11909 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11910
11911 =item Example: Encode::ROT13
11912
11913 =back
11914
11915 =item Why the heck Encode API is different?
11916
11917 =over 4
11918
11919 =item Compiled Encodings
11920
11921 =back
11922
11923 =item SEE ALSO
11924
11925 Scheme 1, Scheme 2, Other Schemes
11926
11927 =back
11928
11929 =head2 Encode::Guess -- Guesses encoding from data
11930
11931 =over 4
11932
11933 =item SYNOPSIS
11934
11935 =item ABSTRACT
11936
11937 =item DESCRIPTION
11938
11939 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11940 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11941 guess_encoding($data, [, I<list of suspects>])
11942
11943 =item CAVEATS
11944
11945 =item TO DO
11946
11947 =item SEE ALSO
11948
11949 =back
11950
11951 =head2 Encode::JP - Japanese Encodings
11952
11953 =over 4
11954
11955 =item SYNOPSIS
11956
11957 =item ABSTRACT
11958
11959 =item DESCRIPTION
11960
11961 =item Note on ISO-2022-JP(-1)?
11962
11963 =item BUGS
11964
11965 =item SEE ALSO
11966
11967 =back
11968
11969 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11970
11971 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11972
11973 =head2 Encode::KR - Korean Encodings
11974
11975 =over 4
11976
11977 =item SYNOPSIS
11978
11979 =item DESCRIPTION
11980
11981 =item BUGS
11982
11983 =item SEE ALSO
11984
11985 =back
11986
11987 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11988
11989 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11990
11991 =over 4
11992
11993 =item SYNOPSIS
11994
11995 =item ABSTRACT
11996
11997 =item DESCRIPTION
11998
11999 =item BUGS
12000
12001 =item SEE ALSO
12002
12003 =back
12004
12005 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12006
12007 =over 4
12008
12009 =item Overview
12010
12011 =item How does it work?
12012
12013 =item Line Buffering
12014
12015 =over 4
12016
12017 =item How can I tell whether my encoding fully supports PerlIO ?
12018
12019 =back
12020
12021 =item SEE ALSO
12022
12023 =back
12024
12025 =head2 Encode::Supported -- Encodings supported by Encode
12026
12027 =over 4
12028
12029 =item DESCRIPTION
12030
12031 =over 4
12032
12033 =item Encoding Names
12034
12035 =back
12036
12037 =item Supported Encodings
12038
12039 =over 4
12040
12041 =item Built-in Encodings
12042
12043 =item Encode::Unicode -- other Unicode encodings
12044
12045 =item Encode::Byte -- Extended ASCII
12046
12047 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12048 the Cyrillic world, gsm0338 - Hentai Latin 1
12049
12050 =item CJK: Chinese, Japanese, Korean (Multibyte)
12051
12052 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12053 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12054 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12055
12056 =item Miscellaneous encodings
12057
12058 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12059
12060 =back
12061
12062 =item Unsupported encodings
12063
12064   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12065 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12066 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12067 Various Mac encodings, (Mac) Indic encodings
12068
12069 =item Encoding vs. Charset -- terminology
12070
12071 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12072
12073 =over 4
12074
12075 =item Microsoft-related naming mess
12076
12077 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12078
12079 =back
12080
12081 =item Glossary
12082
12083 character repertoire, coded character set (CCS), character encoding scheme
12084 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12085 UTF-16
12086
12087 =item See Also
12088
12089 =item References
12090
12091 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12092 RFC, UC, Unicode Glossary
12093
12094 =over 4
12095
12096 =item Other Notable Sites
12097
12098 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12099 "Introduction to i18n"
12100
12101 =item Offline sources
12102
12103 C<CJKV Information Processing> by Ken Lunde
12104
12105 =back
12106
12107 =back
12108
12109 =head2 Encode::Symbol - Symbol Encodings
12110
12111 =over 4
12112
12113 =item SYNOPSIS
12114
12115 =item ABSTRACT
12116
12117 =item DESCRIPTION
12118
12119 =item SEE ALSO
12120
12121 =back
12122
12123 =head2 Encode::TW - Taiwan-based Chinese Encodings
12124
12125 =over 4
12126
12127 =item SYNOPSIS
12128
12129 =item DESCRIPTION
12130
12131 =item NOTES
12132
12133 =item BUGS
12134
12135 =item SEE ALSO
12136
12137 =back
12138
12139 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12140
12141 =over 4
12142
12143 =item SYNOPSIS
12144
12145 =item ABSTRACT
12146
12147 L<http://www.unicode.org/glossary/> says:, Quick Reference
12148
12149 =item Size, Endianness, and BOM
12150
12151 =over 4
12152
12153 =item by size
12154
12155 =item by endianness
12156
12157 BOM as integer when fetched in network byte order
12158
12159 =back
12160
12161 =item Surrogate Pairs
12162
12163 =item SEE ALSO
12164
12165 =back
12166
12167 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12168
12169 =over 4
12170
12171 =item SYNOPSIS
12172
12173 =item ABSTRACT
12174
12175 =item In Practice
12176
12177 =item SEE ALSO
12178
12179 =back
12180
12181 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12182 encodings
12183
12184 =over 4
12185
12186 =item SYNOPSIS
12187
12188 =item DESCRIPTION
12189
12190 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12191 reference, e.g.:
12192
12193 =over 4
12194
12195 =item Alias overloading
12196
12197 =back
12198
12199 =item SEE ALSO
12200
12201 =back
12202
12203 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12204 Internally used by Encode::??::ISO_2022_*
12205
12206 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12207 Encode::CN
12208
12209 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12210 Encode
12211
12212 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12213 Implementation Base Class
12214
12215 =over 4
12216
12217 =item SYNOPSIS
12218
12219 =item DESCRIPTION
12220
12221 =over 4
12222
12223 =item Methods you should implement
12224
12225 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12226 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12227
12228 =item Other methods defined in Encode::Encodings
12229
12230 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12231
12232 =item Example: Encode::ROT13
12233
12234 =back
12235
12236 =item Why the heck Encode API is different?
12237
12238 =over 4
12239
12240 =item Compiled Encodings
12241
12242 =back
12243
12244 =item SEE ALSO
12245
12246 Scheme 1, Scheme 2, Other Schemes
12247
12248 =back
12249
12250 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12251 data
12252
12253 =over 4
12254
12255 =item SYNOPSIS
12256
12257 =item ABSTRACT
12258
12259 =item DESCRIPTION
12260
12261 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12262 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12263 guess_encoding($data, [, I<list of suspects>])
12264
12265 =item CAVEATS
12266
12267 =item TO DO
12268
12269 =item SEE ALSO
12270
12271 =back
12272
12273 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12274 Encode::JP::2022_JP*
12275
12276 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12277 by Encode::JP
12278
12279 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12280 used by Encode::KR
12281
12282 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12283 and 'Q' header encoding
12284
12285 =over 4
12286
12287 =item SYNOPSIS
12288
12289 =item ABSTRACT
12290
12291 =item DESCRIPTION
12292
12293 =item BUGS
12294
12295 =item SEE ALSO
12296
12297 =back
12298
12299 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12300 on Encode and PerlIO
12301
12302 =over 4
12303
12304 =item Overview
12305
12306 =item How does it work?
12307
12308 =item Line Buffering
12309
12310 =over 4
12311
12312 =item How can I tell whether my encoding fully supports PerlIO ?
12313
12314 =back
12315
12316 =item SEE ALSO
12317
12318 =back
12319
12320 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12321 supported by Encode
12322
12323 =over 4
12324
12325 =item DESCRIPTION
12326
12327 =over 4
12328
12329 =item Encoding Names
12330
12331 =back
12332
12333 =item Supported Encodings
12334
12335 =over 4
12336
12337 =item Built-in Encodings
12338
12339 =item Encode::Unicode -- other Unicode encodings
12340
12341 =item Encode::Byte -- Extended ASCII
12342
12343 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12344 the Cyrillic world, gsm0338 - Hentai Latin 1
12345
12346 =item CJK: Chinese, Japanese, Korean (Multibyte)
12347
12348 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12349 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12350 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12351
12352 =item Miscellaneous encodings
12353
12354 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12355
12356 =back
12357
12358 =item Unsupported encodings
12359
12360   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12361 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12362 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12363 Various Mac encodings, (Mac) Indic encodings
12364
12365 =item Encoding vs. Charset -- terminology
12366
12367 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12368
12369 =over 4
12370
12371 =item Microsoft-related naming mess
12372
12373 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12374
12375 =back
12376
12377 =item Glossary
12378
12379 character repertoire, coded character set (CCS), character encoding scheme
12380 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12381 UTF-16
12382
12383 =item See Also
12384
12385 =item References
12386
12387 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12388 RFC, UC, Unicode Glossary
12389
12390 =over 4
12391
12392 =item Other Notable Sites
12393
12394 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12395 "Introduction to i18n"
12396
12397 =item Offline sources
12398
12399 C<CJKV Information Processing> by Ken Lunde
12400
12401 =back
12402
12403 =back
12404
12405 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12406 encoding
12407
12408 =over 4
12409
12410 =item SYNOPSIS
12411
12412 =item ABSTRACT
12413
12414 =item In Practice
12415
12416 =item SEE ALSO
12417
12418 =back
12419
12420 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12421
12422 =over 4
12423
12424 =item SYNOPSIS
12425
12426 =item ABSTRACT
12427
12428 =item Description
12429
12430 =over 4
12431
12432 =item Predefined Methods
12433
12434 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12435 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12436 $e-E<gt>bytes([$encoding])
12437
12438 =item Example: base64 transcoder
12439
12440 =item Operator Overloading
12441
12442 =back
12443
12444 =item SEE ALSO
12445
12446 =back
12447
12448 =head2 Encodencoding, encoding - allows you to write your script in
12449 non-ascii or non-utf8
12450
12451 =over 4
12452
12453 =item SYNOPSIS
12454
12455 =item ABSTRACT
12456
12457 =over 4
12458
12459 =item Literal Conversions
12460
12461 =item PerlIO layers for C<STD(IN|OUT)>
12462
12463 =back
12464
12465 =item FEATURES THAT REQUIRE 5.8.1
12466
12467 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12468
12469 =item USAGE
12470
12471 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12472 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12473
12474 =item The Filter Option
12475
12476 =over 4
12477
12478 =item Filter-related changes at Encode version 1.87
12479
12480 =back
12481
12482 =item CAVEATS
12483
12484 =over 4
12485
12486 =item NOT SCOPED
12487
12488 =item DO NOT MIX MULTIPLE ENCODINGS
12489
12490 =item tr/// with ranges
12491
12492 Legend of characters above
12493
12494 =back
12495
12496 =item EXAMPLE - Greekperl
12497
12498 =item KNOWN PROBLEMS
12499
12500 literals in regex that are longer than 127 bytes, EBCDIC, format
12501
12502 =item HISTORY
12503
12504 =item SEE ALSO
12505
12506 =back
12507
12508 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12509
12510 =over 4
12511
12512 =item SYNOPSIS
12513
12514 =item ABSTRACT
12515
12516 =item Description
12517
12518 =over 4
12519
12520 =item Predefined Methods
12521
12522 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12523 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12524 $e-E<gt>bytes([$encoding])
12525
12526 =item Example: base64 transcoder
12527
12528 =item Operator Overloading
12529
12530 =back
12531
12532 =item SEE ALSO
12533
12534 =back
12535
12536 =head2 English - use nice English (or awk) names for ugly punctuation
12537 variables
12538
12539 =over 4
12540
12541 =item SYNOPSIS
12542
12543 =item DESCRIPTION
12544
12545 =item PERFORMANCE
12546
12547 =back
12548
12549 =head2 Env - perl module that imports environment variables as scalars or
12550 arrays
12551
12552 =over 4
12553
12554 =item SYNOPSIS
12555
12556 =item DESCRIPTION
12557
12558 =item LIMITATIONS
12559
12560 =item AUTHOR
12561
12562 =back
12563
12564 =head2 Errno - System errno constants
12565
12566 =over 4
12567
12568 =item SYNOPSIS
12569
12570 =item DESCRIPTION
12571
12572 =item CAVEATS
12573
12574 =item AUTHOR
12575
12576 =item COPYRIGHT
12577
12578 =back
12579
12580 =head2 Exporter - Implements default import method for modules
12581
12582 =over 4
12583
12584 =item SYNOPSIS
12585
12586 =item DESCRIPTION
12587
12588 =over 4
12589
12590 =item How to Export
12591
12592 =item Selecting What To Export
12593
12594 =item How to Import
12595
12596 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12597
12598 =back
12599
12600 =item Advanced features
12601
12602 =over 4
12603
12604 =item Specialised Import Lists
12605
12606 =item Exporting without using Exporter's import method
12607
12608 =item Module Version Checking
12609
12610 =item Managing Unknown Symbols
12611
12612 =item Tag Handling Utility Functions
12613
12614 =item Generating combined tags
12615
12616 =item C<AUTOLOAD>ed Constants
12617
12618 =back
12619
12620 =back
12621
12622 =head2 Exporter::Heavy - Exporter guts
12623
12624 =over 4
12625
12626 =item SYNOPSIS
12627
12628 =item DESCRIPTION
12629
12630 =back
12631
12632 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12633 Makefiles etc.
12634
12635 =over 4
12636
12637 =item SYNOPSIS
12638
12639 =item DESCRIPTION
12640
12641 =back
12642
12643 cat
12644
12645 eqtime src dst
12646
12647 rm_rf files...
12648
12649 rm_f files...
12650
12651 touch files ..
12652
12653 mv source... destination
12654
12655 cp source... destination
12656
12657 chmod mode files..
12658
12659 mkpath directory..
12660
12661 test_f file
12662
12663 =over 4
12664
12665 =item BUGS
12666
12667 =item SEE ALSO
12668
12669 =item AUTHOR
12670
12671 =back
12672
12673 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12674
12675 =over 4
12676
12677 =item SYNOPSIS
12678
12679 =item DESCRIPTION
12680
12681 B<test_harness>
12682
12683 =back
12684
12685 B<pod2man>
12686
12687 B<warn_if_old_packlist>
12688
12689 B<perllocal_install>
12690
12691 B<uninstall>
12692
12693 =head2 ExtUtils::Constant - generate XS code to import C header constants
12694
12695 =over 4
12696
12697 =item SYNOPSIS
12698
12699 =item DESCRIPTION
12700
12701 =item USAGE
12702
12703 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12704
12705 =item FUNCTIONS
12706
12707 =back
12708
12709 C_stringify NAME
12710
12711 perl_stringify NAME
12712
12713 constant_types
12714
12715 memEQ_clause NAME, CHECKED_AT, INDENT
12716
12717 assign INDENT, TYPE, PRE, POST, VALUE..
12718
12719 return_clause
12720
12721 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12722
12723 params WHAT
12724
12725 dump_names
12726
12727 dogfood
12728
12729 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12730 def_post, utf8
12731
12732 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12733
12734 autoload PACKAGE, VERSION, AUTOLOADER
12735
12736 WriteMakefileSnippet
12737
12738 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12739 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12740
12741 =over 4
12742
12743 =item AUTHOR
12744
12745 =back
12746
12747 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12748
12749 =over 4
12750
12751 =item SYNOPSIS
12752
12753 =item DESCRIPTION
12754
12755 =item @EXPORT
12756
12757 =item FUNCTIONS
12758
12759 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12760 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12761
12762 =item EXAMPLES
12763
12764 =item SEE ALSO
12765
12766 =item AUTHOR
12767
12768 =back
12769
12770 =head2 ExtUtils::Install - install files from here to there
12771
12772 =over 4
12773
12774 =item SYNOPSIS
12775
12776 =item DESCRIPTION
12777
12778 =over 4
12779
12780 =item Functions
12781
12782 B<install>
12783
12784 =back
12785
12786 =back
12787
12788 B<install_default> I<DISCOURAGED>
12789
12790 B<uninstall>
12791
12792 B<pm_to_blib>
12793
12794 _autosplit
12795
12796 =over 4
12797
12798 =item ENVIRONMENT
12799
12800 B<PERL_INSTALL_ROOT>
12801
12802 =item AUTHOR
12803
12804 =item LICENSE
12805
12806 =back
12807
12808 =head2 ExtUtils::Installed - Inventory management of installed modules
12809
12810 =over 4
12811
12812 =item SYNOPSIS
12813
12814 =item DESCRIPTION
12815
12816 =item USAGE
12817
12818 =item FUNCTIONS
12819
12820 new(), modules(), files(), directories(), directory_tree(), validate(),
12821 packlist(), version()
12822
12823 =item EXAMPLE
12824
12825 =item AUTHOR
12826
12827 =back
12828
12829 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12830
12831 =over 4
12832
12833 =item SYNOPSIS
12834
12835 =item DESCRIPTION
12836
12837 For static extensions, For dynamic extensions at build/link time, For
12838 dynamic extensions at load time
12839
12840 =over 4
12841
12842 =item EXTRALIBS
12843
12844 =item LDLOADLIBS and LD_RUN_PATH
12845
12846 =item BSLOADLIBS
12847
12848 =back
12849
12850 =item PORTABILITY
12851
12852 =over 4
12853
12854 =item VMS implementation
12855
12856 =item Win32 implementation
12857
12858 =back
12859
12860 =item SEE ALSO
12861
12862 =back
12863
12864 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12865
12866 =over 4
12867
12868 =item SYNOPSIS
12869
12870 =item DESCRIPTION
12871
12872 =back
12873
12874 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12875
12876 =over 4
12877
12878 =item SYNOPSIS
12879
12880 =item DESCRIPTION
12881
12882 =item Inherently Cross-Platform Methods
12883
12884 os_flavor_is
12885
12886 =back
12887
12888 =over 4
12889
12890 =item File::Spec wrappers
12891
12892 catfile
12893
12894 =back
12895
12896 =over 4
12897
12898 =item Thought To Be Cross-Platform Methods
12899
12900 B<split_command>
12901
12902 =back
12903
12904 B<echo>
12905
12906 init_VERSION
12907
12908 wraplist
12909
12910 manifypods
12911
12912 manifypods_target
12913
12914 makemakerdflt_target
12915
12916 special_targets
12917
12918 POD2MAN_EXE_macro
12919
12920 test_via_harness
12921
12922 test_via_script
12923
12924 libscan
12925
12926 tool_autosplit
12927
12928 all_target
12929
12930 metafile_target
12931
12932 metafile_addtomanifest_target
12933
12934 =over 4
12935
12936 =item Abstract methods
12937
12938 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
12939 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
12940 platform_constants
12941
12942 =back
12943
12944 os_flavor
12945
12946 =over 4
12947
12948 =item AUTHOR
12949
12950 =back
12951
12952 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12953 ExtUtils::MakeMaker
12954
12955 =over 4
12956
12957 =item SYNOPSIS
12958
12959 =item DESCRIPTION
12960
12961 =back
12962
12963 os_flavor (o)
12964
12965 init_linker
12966
12967 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12968 ExtUtils::MakeMaker
12969
12970 =over 4
12971
12972 =item SYNOPSIS
12973
12974 =item DESCRIPTION
12975
12976 os_flavor (o)
12977
12978 =back
12979
12980 cflags (o)
12981
12982 replace_manpage_separator (o)
12983
12984 init_linker
12985
12986 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12987
12988 =over 4
12989
12990 =item SYNOPSIS
12991
12992 =item DESCRIPTION
12993
12994 =over 4
12995
12996 =item Overridden methods
12997
12998 os_flavor
12999
13000 =back
13001
13002 =back
13003
13004 B<replace_manpage_separator>
13005
13006 =over 4
13007
13008 =item AUTHOR
13009
13010 =item SEE ALSO
13011
13012 =back
13013
13014 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13015 ExtUtils::MakeMaker
13016
13017 =over 4
13018
13019 =item SYNOPSIS
13020
13021 =item DESCRIPTION
13022
13023 =back
13024
13025 maybe_command
13026
13027 guess_name
13028
13029 macify
13030
13031 patternify
13032
13033 init_main
13034
13035 init_others
13036
13037 init_platform, platform_constants
13038
13039 init_dirscan
13040
13041 init_VERSION (o)
13042
13043 special_targets (o)
13044
13045 static (o)
13046
13047 dlsyms (o)
13048
13049 dynamic (o)
13050
13051 clean (o)
13052
13053 clean_subdirs_target
13054
13055 realclean (o)
13056
13057 realclean_subdirs_target
13058
13059 rulez (o)
13060
13061 processPL (o)
13062
13063 os_flavor
13064
13065 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13066 ExtUtils::MakeMaker
13067
13068 =over 4
13069
13070 =item SYNOPSIS
13071
13072 =item DESCRIPTION
13073
13074 =back
13075
13076 os_flavor
13077
13078 init_platform (o), platform_constants
13079
13080 const_cccmd (o)
13081
13082 static_lib (o)
13083
13084 dynamic_lib (o)
13085
13086 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13087 ExtUtils::MakeMaker
13088
13089 =over 4
13090
13091 =item SYNOPSIS
13092
13093 =item DESCRIPTION
13094
13095 =item METHODS
13096
13097 init_dist (o)
13098
13099 =back
13100
13101 init_linker
13102
13103 os_flavor
13104
13105 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13106
13107 =over 4
13108
13109 =item SYNOPSIS
13110
13111 =item DESCRIPTION
13112
13113 =over 4
13114
13115 =item Overridden methods
13116
13117 os_flavor
13118
13119 =back
13120
13121 =back
13122
13123 B<replace_manpage_separator>
13124
13125 =over 4
13126
13127 =item AUTHOR
13128
13129 =item SEE ALSO
13130
13131 =back
13132
13133 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13134
13135 =over 4
13136
13137 =item SYNOPSIS
13138
13139 =item DESCRIPTION
13140
13141 =item METHODS
13142
13143 =back
13144
13145 =over 4
13146
13147 =item Methods
13148
13149 os_flavor (o)
13150
13151 =back
13152
13153 c_o (o)
13154
13155 cflags (o)
13156
13157 clean (o)
13158
13159 clean_subdirs_target
13160
13161 const_cccmd (o)
13162
13163 const_config (o)
13164
13165 const_loadlibs (o)
13166
13167 constants (o)
13168
13169 depend (o)
13170
13171 dir_target (o)
13172
13173 init_dist
13174
13175 dist (o)
13176
13177 dist_basics (o)
13178
13179 dist_ci (o)
13180
13181 dist_core (o)
13182
13183 B<dist_target>
13184
13185 B<tardist_target>
13186
13187 B<zipdist_target>
13188
13189 B<tarfile_target>
13190
13191 zipfile_target
13192
13193 uutardist_target
13194
13195 shdist_target
13196
13197 distdir
13198
13199 dist_test
13200
13201 dlsyms (o)
13202
13203 dynamic (o)
13204
13205 dynamic_bs (o)
13206
13207 dynamic_lib (o)
13208
13209 exescan
13210
13211 extliblist
13212
13213 find_perl
13214
13215 find_tests
13216
13217 =over 4
13218
13219 =item Methods to actually produce chunks of text for the Makefile
13220
13221 fixin
13222
13223 =back
13224
13225 force (o)
13226
13227 guess_name
13228
13229 has_link_code
13230
13231 init_dirscan
13232
13233 init_DIRFILESEP
13234
13235 init_main
13236
13237 init_others
13238
13239 init_INST
13240
13241 init_INSTALL
13242
13243 init_linker
13244
13245 init_lib2arch
13246
13247 init_PERL
13248
13249 init_platform (o), platform_constants (o)
13250
13251 init_PERM
13252
13253 init_xs
13254
13255 install (o)
13256
13257 installbin (o)
13258
13259 linkext (o)
13260
13261 lsdir
13262
13263 macro (o)
13264
13265 makeaperl (o)
13266
13267 makefile (o)
13268
13269 maybe_command
13270
13271 needs_linking (o)
13272
13273 nicetext
13274
13275 parse_abstract
13276
13277 parse_version
13278
13279 pasthru (o)
13280
13281 perl_script
13282
13283 perldepend (o)
13284
13285 perm_rw (o)
13286
13287 perm_rwx (o)
13288
13289 pm_to_blib
13290
13291 post_constants (o)
13292
13293 post_initialize (o)
13294
13295 postamble (o)
13296
13297 ppd
13298
13299 prefixify
13300
13301 processPL (o)
13302
13303 quote_paren
13304
13305 realclean (o)
13306
13307 realclean_subdirs_target
13308
13309 replace_manpage_separator
13310
13311 oneliner (o)
13312
13313 quote_literal
13314
13315 escape_newlines
13316
13317 max_exec_len
13318
13319 static (o)
13320
13321 static_lib (o)
13322
13323 staticmake (o)
13324
13325 subdir_x (o)
13326
13327 subdirs (o)
13328
13329 test (o)
13330
13331 test_via_harness (override)
13332
13333 test_via_script (override)
13334
13335 tools_other (o)
13336
13337 tool_xsubpp (o)
13338
13339 all_target
13340
13341 top_targets (o)
13342
13343 writedoc
13344
13345 xs_c (o)
13346
13347 xs_cpp (o)
13348
13349 xs_o (o)
13350
13351 =over 4
13352
13353 =item SEE ALSO
13354
13355 =back
13356
13357 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13358 ExtUtils::MakeMaker
13359
13360 =over 4
13361
13362 =item SYNOPSIS
13363
13364 =item DESCRIPTION
13365
13366 =over 4
13367
13368 =item Methods always loaded
13369
13370 wraplist
13371
13372 =back
13373
13374 =back
13375
13376 =over 4
13377
13378 =item Methods
13379
13380 guess_name (override)
13381
13382 =back
13383
13384 find_perl (override)
13385
13386 maybe_command (override)
13387
13388 perl_script (override)
13389
13390 replace_manpage_separator
13391
13392 init_DIRFILESEP
13393
13394 init_main (override)
13395
13396 init_others (override)
13397
13398 init_platform (override)
13399
13400 platform_constants
13401
13402 init_VERSION (override)
13403
13404 constants (override)
13405
13406 special_targets
13407
13408 cflags (override)
13409
13410 const_cccmd (override)
13411
13412 tool_sxubpp (override)
13413
13414 xsubpp_version (override)
13415
13416 tools_other (override)
13417
13418 init_dist (override)
13419
13420 c_o (override)
13421
13422 xs_c (override)
13423
13424 xs_o (override)
13425
13426 dlsyms (override)
13427
13428 dynamic_lib (override)
13429
13430 dynamic_bs (override)
13431
13432 static_lib (override)
13433
13434 processPL (override)
13435
13436 installbin (override)
13437
13438 subdir_x (override)
13439
13440 clean (override)
13441
13442 clean_subdirs_target
13443
13444 realclean (override)
13445
13446 zipfile_target (o), tarfile_target (o), shdist_target (o)
13447
13448 dist_test (override)
13449
13450 install (override)
13451
13452 perldepend (override)
13453
13454 makefile (override)
13455
13456 find_tests (override)
13457
13458 test (override)
13459
13460 makeaperl (override)
13461
13462 nicetext (override)
13463
13464 prefixify (override)
13465
13466 oneliner (o)
13467
13468 B<echo> (o)
13469
13470 quote_literal
13471
13472 escape_newlines
13473
13474 max_exec_len
13475
13476 init_linker (o)
13477
13478 eliminate_macros
13479
13480 fixpath
13481
13482 os_flavor
13483
13484 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13485 ExtUtils::MakeMaker
13486
13487 =over 4
13488
13489 =item SYNOPSIS
13490
13491 =item DESCRIPTION
13492
13493 =back
13494
13495 =over 4
13496
13497 =item Overridden methods
13498
13499 B<dlsyms>
13500
13501 =back
13502
13503 replace_manpage_separator
13504
13505 B<maybe_command>
13506
13507 B<find_tests>
13508
13509 B<init_DIRFILESEP>
13510
13511 B<init_others>
13512
13513 init_platform (o), platform_constants (o)
13514
13515 special_targets (o)
13516
13517 static_lib (o)
13518
13519 dynamic_lib (o)
13520
13521 clean
13522
13523 init_linker
13524
13525 perl_script
13526
13527 xs_o (o)
13528
13529 pasthru (o)
13530
13531 oneliner (o)
13532
13533 max_exec_len
13534
13535 os_flavor
13536
13537 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13538
13539 =over 4
13540
13541 =item SYNOPSIS
13542
13543 =item DESCRIPTION
13544
13545 =over 4
13546
13547 =item Overriden methods
13548
13549 dist_test
13550
13551 =back
13552
13553 =back
13554
13555 subdir_x
13556
13557 xs_c
13558
13559 xs_cpp
13560
13561 xs_o
13562
13563 clean_subdirs_target
13564
13565 realclean_subdirs_target
13566
13567 max_exec_len
13568
13569 os_flavor
13570
13571 =over 4
13572
13573 =item AUTHOR
13574
13575 =back
13576
13577 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13578
13579 =over 4
13580
13581 =item SYNOPSIS
13582
13583 =item DESCRIPTION
13584
13585 =back
13586
13587 =head2 ExtUtils::MakeMaker - Create a module Makefile
13588
13589 =over 4
13590
13591 =item SYNOPSIS
13592
13593 =item DESCRIPTION
13594
13595 =over 4
13596
13597 =item How To Write A Makefile.PL
13598
13599 =item Default Makefile Behaviour
13600
13601 =item make test
13602
13603 =item make testdb
13604
13605 =item make install
13606
13607 =item PREFIX and LIB attribute
13608
13609 =item AFS users
13610
13611 =item Static Linking of a new Perl Binary
13612
13613 =item Determination of Perl Library and Installation Locations
13614
13615 =item Which architecture dependent directory?
13616
13617 =item Using Attributes and Parameters
13618
13619 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13620 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13621 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13622 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13623 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13624 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13625 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13626 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13627 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13628 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13629 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13630 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
13631 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
13632 PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES,
13633 PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT,
13634 PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX,
13635 SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM,
13636 XS, XSOPT, XSPROTOARG, XS_VERSION
13637
13638 =item Additional lowercase attributes
13639
13640 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
13641 tool_autosplit
13642
13643 =item Overriding MakeMaker Methods
13644
13645 =item The End Of Cargo Cult Programming
13646
13647 C<<MAN3PODS => ' '>>
13648
13649 =item Hintsfile support
13650
13651 =item Distribution Support
13652
13653    make distcheck,    make skipcheck,    make distclean,    make manifest,
13654   make distdir,   make disttest,    make tardist,    make dist,    make
13655 uutardist,    make shdist,    make zipdist,    make ci
13656
13657 =item Disabling an extension
13658
13659 =item Other Handy Functions
13660
13661 prompt
13662
13663 =back
13664
13665 =item ENVIRONMENT
13666
13667 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13668
13669 =item SEE ALSO
13670
13671 =item AUTHORS
13672
13673 =item LICENSE
13674
13675 =back
13676
13677 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
13678 MakeMaker
13679
13680 =over 4
13681
13682 =item DESCRIPTION
13683
13684 =over 4
13685
13686 =item Philosophy and History
13687
13688 Why not just use <insert other build config tool here>?, What's
13689 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
13690 shell commands, easier to customize, cleaner internals, less cruft
13691
13692 =item Module Writing
13693
13694 How do I keep my $VERSION up to date without resetting it manually?
13695
13696 =item XS
13697
13698 How to I prevent "object version X.XX does not match bootstrap parameter
13699 Y.YY" errors?, How do I make two or more XS files coexist in the same
13700 directory?
13701
13702 =back
13703
13704 =item PATCHING
13705
13706 =item AUTHOR
13707
13708 =item SEE ALSO
13709
13710 =back
13711
13712 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
13713
13714 =over 4
13715
13716 =item SYNOPSIS
13717
13718 =item DESCRIPTION
13719
13720 =over 4
13721
13722 =item The Mantra
13723
13724 =item The Layout
13725
13726 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
13727 bin/
13728
13729 =back
13730
13731 =item SEE ALSO
13732
13733 =back
13734
13735 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
13736
13737 =over 4
13738
13739 =item SYNOPSIS
13740
13741 =item DESCRIPTION
13742
13743 =back
13744
13745 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
13746
13747 =over 4
13748
13749 =item SYNOPSIS
13750
13751 =item DESCRIPTION
13752
13753 =back
13754
13755 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13756
13757 =over 4
13758
13759 =item SYNOPSIS
13760
13761 =item DESCRIPTION
13762
13763 =over 4
13764
13765 =item Functions
13766
13767 mkmanifest
13768
13769 =back
13770
13771 =back
13772
13773 manifind
13774
13775 manicheck
13776
13777 filecheck
13778
13779 fullcheck
13780
13781 skipcheck
13782
13783 maniread
13784
13785 manicopy
13786
13787 maniadd
13788
13789 =over 4
13790
13791 =item MANIFEST
13792
13793 =item MANIFEST.SKIP
13794
13795 =item EXPORT_OK
13796
13797 =item GLOBAL VARIABLES
13798
13799 =back
13800
13801 =over 4
13802
13803 =item DIAGNOSTICS
13804
13805 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13806 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13807
13808 =item ENVIRONMENT
13809
13810 B<PERL_MM_MANIFEST_DEBUG>
13811
13812 =item SEE ALSO
13813
13814 =item AUTHOR
13815
13816 =back
13817
13818 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13819
13820 =over 4
13821
13822 =item SYNOPSIS
13823
13824 =item DESCRIPTION
13825
13826 =item SEE ALSO
13827
13828 =back
13829
13830 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13831
13832 =over 4
13833
13834 =item SYNOPSIS
13835
13836 =item DESCRIPTION
13837
13838 =back
13839
13840 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13841 extension
13842
13843 =over 4
13844
13845 =item SYNOPSIS
13846
13847 =item DESCRIPTION
13848
13849 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13850
13851 =item AUTHOR
13852
13853 =item REVISION
13854
13855 =back
13856
13857 =head2 ExtUtils::Packlist - manage .packlist files
13858
13859 =over 4
13860
13861 =item SYNOPSIS
13862
13863 =item DESCRIPTION
13864
13865 =item USAGE
13866
13867 =item FUNCTIONS
13868
13869 new(), read(), write(), validate(), packlist_file()
13870
13871 =item EXAMPLE
13872
13873 =item AUTHOR
13874
13875 =back
13876
13877 =head2 ExtUtils::testlib - add blib/* directories to @INC
13878
13879 =over 4
13880
13881 =item SYNOPSIS
13882
13883 =item DESCRIPTION
13884
13885 =back
13886
13887 =head2 Fatal - replace functions with equivalents which succeed or die
13888
13889 =over 4
13890
13891 =item SYNOPSIS
13892
13893 =item DESCRIPTION
13894
13895 =item AUTHOR
13896
13897 =back
13898
13899 =head2 Fcntl - load the C Fcntl.h defines
13900
13901 =over 4
13902
13903 =item SYNOPSIS
13904
13905 =item DESCRIPTION
13906
13907 =item NOTE
13908
13909 =item EXPORTED SYMBOLS
13910
13911 =back
13912
13913 =head2 File::Basename, fileparse - split a pathname into pieces
13914
13915 =over 4
13916
13917 =item SYNOPSIS
13918
13919 =item DESCRIPTION
13920
13921 fileparse_set_fstype, fileparse
13922
13923 =item EXAMPLES
13924
13925 C<basename>, C<dirname>
13926
13927 =back
13928
13929 =head2 File::CheckTree, validate - run many filetest checks on a tree
13930
13931 =over 4
13932
13933 =item SYNOPSIS
13934
13935 =item DESCRIPTION
13936
13937 =item AUTHOR
13938
13939 =item HISTORY
13940
13941 =back
13942
13943 =head2 File::Compare - Compare files or filehandles
13944
13945 =over 4
13946
13947 =item SYNOPSIS
13948
13949 =item DESCRIPTION
13950
13951 =item RETURN
13952
13953 =item AUTHOR
13954
13955 =back
13956
13957 =head2 File::Copy - Copy files or filehandles
13958
13959 =over 4
13960
13961 =item SYNOPSIS
13962
13963 =item DESCRIPTION
13964
13965 =over 4
13966
13967 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13968
13969 rmscopy($from,$to[,$date_flag])
13970
13971 =back
13972
13973 =item RETURN
13974
13975 =item NOTES
13976
13977 =item AUTHOR
13978
13979 =back
13980
13981 =head2 File::DosGlob - DOS like globbing and then some
13982
13983 =over 4
13984
13985 =item SYNOPSIS
13986
13987 =item DESCRIPTION
13988
13989 =item NOTES
13990
13991 =item EXPORTS (by request only)
13992
13993 =item BUGS
13994
13995 =item AUTHOR
13996
13997 =item HISTORY
13998
13999 =item SEE ALSO
14000
14001 =back
14002
14003 =head2 File::Find - Traverse a directory tree.
14004
14005 =over 4
14006
14007 =item SYNOPSIS
14008
14009 =item DESCRIPTION
14010
14011 B<find>, B<finddepth>
14012
14013 =over 4
14014
14015 =item %options
14016
14017 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14018 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14019 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14020
14021 =item The wanted function
14022
14023 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14024 filename within that directory, C<$File::Find::name> is the complete
14025 pathname to the file
14026
14027 =back
14028
14029 =item WARNINGS
14030
14031 =item CAVEAT
14032
14033 $dont_use_nlink, symlinks
14034
14035 =item NOTES
14036
14037 =item HISTORY
14038
14039 =back
14040
14041 =head2 File::Glob - Perl extension for BSD glob routine
14042
14043 =over 4
14044
14045 =item SYNOPSIS
14046
14047 =item DESCRIPTION
14048
14049 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14050 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14051 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14052
14053 =item DIAGNOSTICS
14054
14055 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14056
14057 =item NOTES
14058
14059 =item AUTHOR
14060
14061 =back
14062
14063 =head2 File::Path - create or remove directory trees
14064
14065 =over 4
14066
14067 =item SYNOPSIS
14068
14069 =item DESCRIPTION
14070
14071 =item DIAGNOSTICS
14072
14073 =item AUTHORS
14074
14075 =back
14076
14077 =head2 File::Spec - portably perform operations on file names
14078
14079 =over 4
14080
14081 =item SYNOPSIS
14082
14083 =item DESCRIPTION
14084
14085 =item METHODS
14086
14087 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14088 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14089 splitdir, catpath(), abs2rel, rel2abs()
14090
14091 =item SEE ALSO
14092
14093 =item AUTHORS
14094
14095 =back
14096
14097 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14098
14099 =over 4
14100
14101 =item SYNOPSIS
14102
14103 =item DESCRIPTION
14104
14105 =back
14106
14107 canonpath
14108
14109 file_name_is_absolute
14110
14111 tmpdir (override)
14112
14113 =head2 File::Spec::Epoc - methods for Epoc file specs
14114
14115 =over 4
14116
14117 =item SYNOPSIS
14118
14119 =item DESCRIPTION
14120
14121 canonpath()
14122
14123 =back
14124
14125 =over 4
14126
14127 =item SEE ALSO
14128
14129 =back
14130
14131 =head2 File::Spec::Functions - portably perform operations on file names
14132
14133 =over 4
14134
14135 =item SYNOPSIS
14136
14137 =item DESCRIPTION
14138
14139 =over 4
14140
14141 =item Exports
14142
14143 =back
14144
14145 =item SEE ALSO
14146
14147 =back
14148
14149 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14150
14151 =over 4
14152
14153 =item SYNOPSIS
14154
14155 =item DESCRIPTION
14156
14157 =item METHODS
14158
14159 canonpath
14160
14161 =back
14162
14163 catdir()
14164
14165 catfile
14166
14167 curdir
14168
14169 devnull
14170
14171 rootdir
14172
14173 tmpdir
14174
14175 updir
14176
14177 file_name_is_absolute
14178
14179 path
14180
14181 splitpath
14182
14183 splitdir
14184
14185 catpath
14186
14187 abs2rel
14188
14189 rel2abs
14190
14191 =over 4
14192
14193 =item AUTHORS
14194
14195 =item SEE ALSO
14196
14197 =back
14198
14199 tmpdir
14200
14201 canonpath
14202
14203 splitpath
14204
14205 splitdir
14206
14207 catpath
14208
14209 =head2 File::Spec::OS2 - methods for OS/2 file specs
14210
14211 =over 4
14212
14213 =item SYNOPSIS
14214
14215 =item DESCRIPTION
14216
14217 =back
14218
14219 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14220 modules
14221
14222 =over 4
14223
14224 =item SYNOPSIS
14225
14226 =item DESCRIPTION
14227
14228 =item METHODS
14229
14230 canonpath()
14231
14232 =back
14233
14234 catdir()
14235
14236 catfile
14237
14238 curdir
14239
14240 devnull
14241
14242 rootdir
14243
14244 tmpdir
14245
14246 updir
14247
14248 no_upwards
14249
14250 case_tolerant
14251
14252 file_name_is_absolute
14253
14254 path
14255
14256 join
14257
14258 splitpath
14259
14260 splitdir
14261
14262 catpath()
14263
14264 abs2rel
14265
14266 rel2abs()
14267
14268 =over 4
14269
14270 =item SEE ALSO
14271
14272 =back
14273
14274 =head2 File::Spec::VMS - methods for VMS file specs
14275
14276 =over 4
14277
14278 =item SYNOPSIS
14279
14280 =item DESCRIPTION
14281
14282 eliminate_macros
14283
14284 =back
14285
14286 fixpath
14287
14288 =over 4
14289
14290 =item Methods always loaded
14291
14292 canonpath (override)
14293
14294 =back
14295
14296 catdir
14297
14298 catfile
14299
14300 curdir (override)
14301
14302 devnull (override)
14303
14304 rootdir (override)
14305
14306 tmpdir (override)
14307
14308 updir (override)
14309
14310 case_tolerant (override)
14311
14312 path (override)
14313
14314 file_name_is_absolute (override)
14315
14316 splitpath (override)
14317
14318 splitdir (override)
14319
14320 catpath (override)
14321
14322 abs2rel (override)
14323
14324 rel2abs (override)
14325
14326 =over 4
14327
14328 =item SEE ALSO
14329
14330 =back
14331
14332 =head2 File::Spec::Win32 - methods for Win32 file specs
14333
14334 =over 4
14335
14336 =item SYNOPSIS
14337
14338 =item DESCRIPTION
14339
14340 devnull
14341
14342 =back
14343
14344 tmpdir
14345
14346 catfile
14347
14348 canonpath
14349
14350 splitpath
14351
14352 splitdir
14353
14354 catpath
14355
14356 =over 4
14357
14358 =item Note For File::Spec::Win32 Maintainers
14359
14360 =back
14361
14362 =over 4
14363
14364 =item SEE ALSO
14365
14366 =back
14367
14368 =head2 File::Temp - return name and handle of a temporary file safely
14369
14370 =over 4
14371
14372 =item PORTABILITY
14373
14374 =item SYNOPSIS
14375
14376 =item DESCRIPTION
14377
14378 =back
14379
14380 =over 4
14381
14382 =item FUNCTIONS
14383
14384 B<tempfile>
14385
14386 =back
14387
14388 B<tempdir>
14389
14390 =over 4
14391
14392 =item MKTEMP FUNCTIONS
14393
14394 B<mkstemp>
14395
14396 =back
14397
14398 B<mkstemps>
14399
14400 B<mkdtemp>
14401
14402 B<mktemp>
14403
14404 =over 4
14405
14406 =item POSIX FUNCTIONS
14407
14408 B<tmpnam>
14409
14410 =back
14411
14412 B<tmpfile>
14413
14414 =over 4
14415
14416 =item ADDITIONAL FUNCTIONS
14417
14418 B<tempnam>
14419
14420 =back
14421
14422 =over 4
14423
14424 =item UTILITY FUNCTIONS
14425
14426 B<unlink0>
14427
14428 =back
14429
14430 =over 4
14431
14432 =item PACKAGE VARIABLES
14433
14434 B<safe_level>, STANDARD, MEDIUM, HIGH
14435
14436 =back
14437
14438 TopSystemUID
14439
14440 =over 4
14441
14442 =item WARNING
14443
14444 =over 4
14445
14446 =item Temporary files and NFS
14447
14448 =back
14449
14450 =item HISTORY
14451
14452 =item SEE ALSO
14453
14454 =item AUTHOR
14455
14456 =back
14457
14458 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14459
14460 =over 4
14461
14462 =item SYNOPSIS
14463
14464 =item DESCRIPTION
14465
14466 =item BUGS
14467
14468 =item NOTE
14469
14470 =item AUTHOR
14471
14472 =back
14473
14474 =head2 FileCache - keep more files open than the system permits
14475
14476 =over 4
14477
14478 =item SYNOPSIS
14479
14480 =item DESCRIPTION
14481
14482 cacheout EXPR, cacheout MODE, EXPR
14483
14484 =item CAVEATS
14485
14486 =item BUGS
14487
14488 =back
14489
14490 =head2 FileHandle - supply object methods for filehandles
14491
14492 =over 4
14493
14494 =item SYNOPSIS
14495
14496 =item DESCRIPTION
14497
14498 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14499
14500 =item SEE ALSO
14501
14502 =back
14503
14504 =head2 Filter::Simple - Simplified source filtering
14505
14506 =over 4
14507
14508 =item SYNOPSIS
14509
14510 =item DESCRIPTION
14511
14512 =over 4
14513
14514 =item The Problem
14515
14516 =item A Solution
14517
14518 =item Disabling or changing <no> behaviour
14519
14520 =item All-in-one interface
14521
14522 =item Filtering only specific components of source code
14523
14524 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14525 C<"all">
14526
14527 =item Filtering only the code parts of source code
14528
14529 Most source code ceases to be grammatically correct when it is broken up
14530 into the pieces between string literals and regexes. So the C<'code'>
14531 component filter behaves slightly differently from the other partial
14532 filters
14533 described in the previous section.
14534
14535 =item Using Filter::Simple with an explicit C<import> subroutine
14536
14537 =item Using Filter::Simple and Exporter together
14538
14539 =item How it works
14540
14541 =back
14542
14543 =item AUTHOR
14544
14545 =item COPYRIGHT
14546
14547 =back
14548
14549 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14550
14551 =over 4
14552
14553 =item SYNOPSIS
14554
14555 =item DESCRIPTION
14556
14557 =over 4
14558
14559 =item B<use Filter::Util::Call>
14560
14561 =item B<import()>
14562
14563 =item B<filter() and anonymous sub>
14564
14565 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14566
14567 =back
14568
14569 =item EXAMPLES
14570
14571 =over 4
14572
14573 =item Example 1: A simple filter.
14574
14575 =item Example 2: Using the context
14576
14577 =item Example 3: Using the context within the filter
14578
14579 =item Example 4: Using filter_del
14580
14581 =back
14582
14583 =item Filter::Simple
14584
14585 =item AUTHOR
14586
14587 =item DATE
14588
14589 =back
14590
14591 =head2 FindBin - Locate directory of original perl script
14592
14593 =over 4
14594
14595 =item SYNOPSIS
14596
14597 =item DESCRIPTION
14598
14599 =item EXPORTABLE VARIABLES
14600
14601 =item KNOWN ISSUES
14602
14603 =item KNOWN BUGS
14604
14605 =item AUTHORS
14606
14607 =item COPYRIGHT
14608
14609 =back
14610
14611 =head2 GDBM_File - Perl5 access to the gdbm library.
14612
14613 =over 4
14614
14615 =item SYNOPSIS
14616
14617 =item DESCRIPTION
14618
14619 =item AVAILABILITY
14620
14621 =item BUGS
14622
14623 =item SEE ALSO
14624
14625 =back
14626
14627 =head2 Getopt::Long - Extended processing of command line options
14628
14629 =over 4
14630
14631 =item SYNOPSIS
14632
14633 =item DESCRIPTION
14634
14635 =item Command Line Options, an Introduction
14636
14637 =item Getting Started with Getopt::Long
14638
14639 =over 4
14640
14641 =item Simple options
14642
14643 =item A little bit less simple options
14644
14645 =item Mixing command line option with other arguments
14646
14647 =item Options with values
14648
14649 =item Options with multiple values
14650
14651 =item Options with hash values
14652
14653 =item User-defined subroutines to handle options
14654
14655 =item Options with multiple names
14656
14657 =item Case and abbreviations
14658
14659 =item Summary of Option Specifications
14660
14661 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
14662 + [ I<desttype> ]
14663
14664 =back
14665
14666 =item Advanced Possibilities
14667
14668 =over 4
14669
14670 =item Object oriented interface
14671
14672 =item Thread Safety
14673
14674 =item Documentation and help texts
14675
14676 =item Storing options in a hash
14677
14678 =item Bundling
14679
14680 =item The lonesome dash
14681
14682 =item Argument callback
14683
14684 =back
14685
14686 =item Configuring Getopt::Long
14687
14688 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
14689 require_order, permute, bundling (default: disabled), bundling_override
14690 (default: disabled), ignore_case  (default: enabled), ignore_case_always
14691 (default: disabled), auto_version (default:disabled), auto_help
14692 (default:disabled), pass_through (default: disabled), prefix,
14693 prefix_pattern, debug (default: disabled)
14694
14695 =item Exportable Methods
14696
14697 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
14698
14699 =item Return values and Errors
14700
14701 =item Legacy
14702
14703 =over 4
14704
14705 =item Default destinations
14706
14707 =item Alternative option starters
14708
14709 =item Configuration variables
14710
14711 =back
14712
14713 =item Trouble Shooting
14714
14715 =over 4
14716
14717 =item Warning: Ignoring '!' modifier for short option
14718
14719 =item GetOptions does not return a false result when an option is not
14720 supplied
14721
14722 =item GetOptions does not split the command line correctly
14723
14724 =item Undefined subroutine &main::GetOptions called
14725
14726 =item How do I put a "-?" option into a Getopt::Long?
14727
14728 =back
14729
14730 =item AUTHOR
14731
14732 =item COPYRIGHT AND DISCLAIMER
14733
14734 =back
14735
14736 =head2 Getopt::Std, getopt - Process single-character switches with switch
14737 clustering
14738
14739 =over 4
14740
14741 =item SYNOPSIS
14742
14743 =item DESCRIPTION
14744
14745 =item C<--help> and C<--version>
14746
14747 =back
14748
14749 =head2 Hash::Util - A selection of general-utility hash subroutines
14750
14751 =over 4
14752
14753 =item SYNOPSIS
14754
14755 =item DESCRIPTION
14756
14757 =over 4
14758
14759 =item Restricted hashes
14760
14761 lock_keys, unlock_keys
14762
14763 =back
14764
14765 =back
14766
14767 lock_value, unlock_value
14768
14769 B<lock_hash>, B<unlock_hash>
14770
14771 =over 4
14772
14773 =item CAVEATS
14774
14775 =item AUTHOR
14776
14777 =item SEE ALSO
14778
14779 =back
14780
14781 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14782 locale
14783
14784 =over 4
14785
14786 =item SYNOPSIS
14787
14788 =item DESCRIPTION
14789
14790 =back
14791
14792 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14793 tags
14794
14795 =over 4
14796
14797 =item SYNOPSIS
14798
14799 =item DESCRIPTION
14800
14801 =back
14802
14803 the function is_language_tag($lang1)
14804
14805 the function extract_language_tags($whatever)
14806
14807 the function same_language_tag($lang1, $lang2)
14808
14809 the function similarity_language_tag($lang1, $lang2)
14810
14811 the function is_dialect_of($lang1, $lang2)
14812
14813 the function super_languages($lang1)
14814
14815 the function locale2language_tag($locale_identifier)
14816
14817 the function encode_language_tag($lang1)
14818
14819 the function alternate_language_tags($lang1)
14820
14821 the function @langs = panic_languages(@accept_languages)
14822
14823 =over 4
14824
14825 =item ABOUT LOWERCASING
14826
14827 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14828
14829 =item SEE ALSO
14830
14831 =item COPYRIGHT
14832
14833 =item AUTHOR
14834
14835 =back
14836
14837 =head2 I18N::LangTags::List -- tags and names for human languages
14838
14839 =over 4
14840
14841 =item SYNOPSIS
14842
14843 =item DESCRIPTION
14844
14845 =item ABOUT LANGUAGE TAGS
14846
14847 =item LIST OF LANGUAGES
14848
14849 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14850 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14851 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14852 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14853 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14854 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14855 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14856 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14857 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14858 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14859 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14860 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14861 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14862 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14863 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14864 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14865 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14866 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14867 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14868 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14869 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14870 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14871 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14872 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14873 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14874 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14875 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14876 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14877 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14878 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14879 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14880 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14881 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14882 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14883 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14884 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14885 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14886 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14887 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14888 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14889 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14890 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14891 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14892 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14893 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14894 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14895 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14896 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14897 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14898 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14899 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14900 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14901 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14902 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14903 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14904 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14905 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14906 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14907 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14908 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14909 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14910 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14911 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14912 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14913 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14914 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14915 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14916 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14917 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14918 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14919 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14920 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14921 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14922 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14923 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14924 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14925 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14926 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14927 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14928 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14929 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14930 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14931 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14932 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14933 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14934 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14935 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14936 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14937 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14938 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14939 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14940 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14941 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14942 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14943 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14944 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14945 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14946 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14947 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14948 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14949 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14950 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14951 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14952 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14953 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14954 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14955 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14956 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14957 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14958 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14959 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14960 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14961 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14962 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14963 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14964 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14965 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14966 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14967 Zhuang, {zu} : Zulu, {zun} : Zuni
14968
14969 =item SEE ALSO
14970
14971 =item COPYRIGHT AND DISCLAIMER
14972
14973 =item AUTHOR
14974
14975 =back
14976
14977 =head2 I18N::Langinfo - query locale information
14978
14979 =over 4
14980
14981 =item SYNOPSIS
14982
14983 =item DESCRIPTION
14984
14985 =over 4
14986
14987 =item EXPORT
14988
14989 =back
14990
14991 =item SEE ALSO
14992
14993 =item AUTHOR
14994
14995 =item COPYRIGHT AND LICENSE
14996
14997 =back
14998
14999 =head2 IO - load various IO modules
15000
15001 =over 4
15002
15003 =item SYNOPSIS
15004
15005 =item DESCRIPTION
15006
15007 =item DEPRECATED
15008
15009 =back
15010
15011 =head2 IO::Dir - supply object methods for directory handles
15012
15013 =over 4
15014
15015 =item SYNOPSIS
15016
15017 =item DESCRIPTION
15018
15019 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15020 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15021
15022 =item SEE ALSO
15023
15024 =item AUTHOR
15025
15026 =item COPYRIGHT
15027
15028 =back
15029
15030 =head2 IO::File - supply object methods for filehandles
15031
15032 =over 4
15033
15034 =item SYNOPSIS
15035
15036 =item DESCRIPTION
15037
15038 =item CONSTRUCTOR
15039
15040 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15041
15042 =item METHODS
15043
15044 open( FILENAME [,MODE [,PERMS]] )
15045
15046 =item SEE ALSO
15047
15048 =item HISTORY
15049
15050 =back
15051
15052 =head2 IO::Handle - supply object methods for I/O handles
15053
15054 =over 4
15055
15056 =item SYNOPSIS
15057
15058 =item DESCRIPTION
15059
15060 =item CONSTRUCTOR
15061
15062 new (), new_from_fd ( FD, MODE )
15063
15064 =item METHODS
15065
15066 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15067 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15068 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15069 $io->blocking ( [ BOOL ] ), $io->untaint
15070
15071 =item NOTE
15072
15073 =item SEE ALSO
15074
15075 =item BUGS
15076
15077 =item HISTORY
15078
15079 =back
15080
15081 =head2 IO::Pipe - supply object methods for pipes
15082
15083 =over 4
15084
15085 =item SYNOPSIS
15086
15087 =item DESCRIPTION
15088
15089 =item CONSTRUCTOR
15090
15091 new ( [READER, WRITER] )
15092
15093 =item METHODS
15094
15095 reader ([ARGS]), writer ([ARGS]), handles ()
15096
15097 =item SEE ALSO
15098
15099 =item AUTHOR
15100
15101 =item COPYRIGHT
15102
15103 =back
15104
15105 =head2 IO::Poll - Object interface to system poll call
15106
15107 =over 4
15108
15109 =item SYNOPSIS
15110
15111 =item DESCRIPTION
15112
15113 =item METHODS
15114
15115 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15116 IO ), handles( [ EVENT_MASK ] )
15117
15118 =item SEE ALSO
15119
15120 =item AUTHOR
15121
15122 =item COPYRIGHT
15123
15124 =back
15125
15126 =head2 IO::Seekable - supply seek based methods for I/O objects
15127
15128 =over 4
15129
15130 =item SYNOPSIS
15131
15132 =item DESCRIPTION
15133
15134 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15135 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15136 $io->tell
15137
15138 =item SEE ALSO
15139
15140 =item HISTORY
15141
15142 =back
15143
15144 =head2 IO::Select - OO interface to the select system call
15145
15146 =over 4
15147
15148 =item SYNOPSIS
15149
15150 =item DESCRIPTION
15151
15152 =item CONSTRUCTOR
15153
15154 new ( [ HANDLES ] )
15155
15156 =item METHODS
15157
15158 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15159 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15160 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15161
15162 =item EXAMPLE
15163
15164 =item AUTHOR
15165
15166 =item COPYRIGHT
15167
15168 =back
15169
15170 =head2 IO::Socket - Object interface to socket communications
15171
15172 =over 4
15173
15174 =item SYNOPSIS
15175
15176 =item DESCRIPTION
15177
15178 =item CONSTRUCTOR
15179
15180 new ( [ARGS] )
15181
15182 =item METHODS
15183
15184 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15185 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15186
15187 =item SEE ALSO
15188
15189 =item AUTHOR
15190
15191 =item COPYRIGHT
15192
15193 =back
15194
15195 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15196
15197 =over 4
15198
15199 =item SYNOPSIS
15200
15201 =item DESCRIPTION
15202
15203 =item CONSTRUCTOR
15204
15205 new ( [ARGS] )
15206
15207 =over 4
15208
15209 =item METHODS
15210
15211 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15212 ()
15213
15214 =back
15215
15216 =item SEE ALSO
15217
15218 =item AUTHOR
15219
15220 =item COPYRIGHT
15221
15222 =back
15223
15224 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15225
15226 =over 4
15227
15228 =item SYNOPSIS
15229
15230 =item DESCRIPTION
15231
15232 =item CONSTRUCTOR
15233
15234 new ( [ARGS] )
15235
15236 =item METHODS
15237
15238 hostpath(), peerpath()
15239
15240 =item SEE ALSO
15241
15242 =item AUTHOR
15243
15244 =item COPYRIGHT
15245
15246 =back
15247
15248 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15249 handles
15250
15251 =over 4
15252
15253 =item SYNOPSIS
15254
15255 =item DESCRIPTION
15256
15257 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15258 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
15259
15260 =item SEE ALSO
15261
15262 =item AUTHOR
15263
15264 =item COPYRIGHT
15265
15266 =back
15267
15268 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15269
15270 =over 4
15271
15272 =item SYNOPSIS
15273
15274 =item DESCRIPTION
15275
15276 =item CONSTRUCTOR
15277
15278 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15279
15280 =item METHODS
15281
15282 open( FILENAME [,MODE [,PERMS]] )
15283
15284 =item SEE ALSO
15285
15286 =item HISTORY
15287
15288 =back
15289
15290 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15291 handles
15292
15293 =over 4
15294
15295 =item SYNOPSIS
15296
15297 =item DESCRIPTION
15298
15299 =item CONSTRUCTOR
15300
15301 new (), new_from_fd ( FD, MODE )
15302
15303 =item METHODS
15304
15305 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15306 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15307 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15308 $io->blocking ( [ BOOL ] ), $io->untaint
15309
15310 =item NOTE
15311
15312 =item SEE ALSO
15313
15314 =item BUGS
15315
15316 =item HISTORY
15317
15318 =back
15319
15320 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15321
15322 =over 4
15323
15324 =item SYNOPSIS
15325
15326 =item DESCRIPTION
15327
15328 =item CONSTRUCTOR
15329
15330 new ( [READER, WRITER] )
15331
15332 =item METHODS
15333
15334 reader ([ARGS]), writer ([ARGS]), handles ()
15335
15336 =item SEE ALSO
15337
15338 =item AUTHOR
15339
15340 =item COPYRIGHT
15341
15342 =back
15343
15344 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15345
15346 =over 4
15347
15348 =item SYNOPSIS
15349
15350 =item DESCRIPTION
15351
15352 =item METHODS
15353
15354 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15355 IO ), handles( [ EVENT_MASK ] )
15356
15357 =item SEE ALSO
15358
15359 =item AUTHOR
15360
15361 =item COPYRIGHT
15362
15363 =back
15364
15365 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15366 I/O objects
15367
15368 =over 4
15369
15370 =item SYNOPSIS
15371
15372 =item DESCRIPTION
15373
15374 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15375 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15376 $io->tell
15377
15378 =item SEE ALSO
15379
15380 =item HISTORY
15381
15382 =back
15383
15384 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15385 call
15386
15387 =over 4
15388
15389 =item SYNOPSIS
15390
15391 =item DESCRIPTION
15392
15393 =item CONSTRUCTOR
15394
15395 new ( [ HANDLES ] )
15396
15397 =item METHODS
15398
15399 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15400 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15401 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15402
15403 =item EXAMPLE
15404
15405 =item AUTHOR
15406
15407 =item COPYRIGHT
15408
15409 =back
15410
15411 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15412 communications
15413
15414 =over 4
15415
15416 =item SYNOPSIS
15417
15418 =item DESCRIPTION
15419
15420 =item CONSTRUCTOR
15421
15422 new ( [ARGS] )
15423
15424 =item METHODS
15425
15426 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15427 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15428
15429 =item SEE ALSO
15430
15431 =item AUTHOR
15432
15433 =item COPYRIGHT
15434
15435 =back
15436
15437 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15438 AF_INET domain sockets
15439
15440 =over 4
15441
15442 =item SYNOPSIS
15443
15444 =item DESCRIPTION
15445
15446 =item CONSTRUCTOR
15447
15448 new ( [ARGS] )
15449
15450 =over 4
15451
15452 =item METHODS
15453
15454 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15455 ()
15456
15457 =back
15458
15459 =item SEE ALSO
15460
15461 =item AUTHOR
15462
15463 =item COPYRIGHT
15464
15465 =back
15466
15467 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15468 AF_UNIX domain sockets
15469
15470 =over 4
15471
15472 =item SYNOPSIS
15473
15474 =item DESCRIPTION
15475
15476 =item CONSTRUCTOR
15477
15478 new ( [ARGS] )
15479
15480 =item METHODS
15481
15482 hostpath(), peerpath()
15483
15484 =item SEE ALSO
15485
15486 =item AUTHOR
15487
15488 =item COPYRIGHT
15489
15490 =back
15491
15492 =head2 IPC::Msg - SysV Msg IPC object class
15493
15494 =over 4
15495
15496 =item SYNOPSIS
15497
15498 =item DESCRIPTION
15499
15500 =item METHODS
15501
15502 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15503 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15504 FLAGS ] ), stat
15505
15506 =item SEE ALSO
15507
15508 =item AUTHOR
15509
15510 =item COPYRIGHT
15511
15512 =back
15513
15514 =head2 IPC::Open2, open2 - open a process for both reading and writing
15515
15516 =over 4
15517
15518 =item SYNOPSIS
15519
15520 =item DESCRIPTION
15521
15522 =item WARNING
15523
15524 =item SEE ALSO
15525
15526 =back
15527
15528 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15529 handling
15530
15531 =over 4
15532
15533 =item SYNOPSIS
15534
15535 =item DESCRIPTION
15536
15537 =item WARNING
15538
15539 =back
15540
15541 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15542
15543 =over 4
15544
15545 =item SYNOPSIS
15546
15547 =item DESCRIPTION
15548
15549 =item METHODS
15550
15551 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15552 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15553 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15554 , VALUE ), stat
15555
15556 =item SEE ALSO
15557
15558 =item AUTHOR
15559
15560 =item COPYRIGHT
15561
15562 =back
15563
15564 =head2 IPC::SysV - SysV IPC constants
15565
15566 =over 4
15567
15568 =item SYNOPSIS
15569
15570 =item DESCRIPTION
15571
15572 ftok( PATH, ID )
15573
15574 =item SEE ALSO
15575
15576 =item AUTHORS
15577
15578 =item COPYRIGHT
15579
15580 =back
15581
15582 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15583
15584 =over 4
15585
15586 =item SYNOPSIS
15587
15588 =item DESCRIPTION
15589
15590 =item METHODS
15591
15592 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15593 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15594 FLAGS ] ), stat
15595
15596 =item SEE ALSO
15597
15598 =item AUTHOR
15599
15600 =item COPYRIGHT
15601
15602 =back
15603
15604 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15605 class
15606
15607 =over 4
15608
15609 =item SYNOPSIS
15610
15611 =item DESCRIPTION
15612
15613 =item METHODS
15614
15615 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15616 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15617 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15618 , VALUE ), stat
15619
15620 =item SEE ALSO
15621
15622 =item AUTHOR
15623
15624 =item COPYRIGHT
15625
15626 =back
15627
15628 =head2 List::Util - A selection of general-utility list subroutines
15629
15630 =over 4
15631
15632 =item SYNOPSIS
15633
15634 =item DESCRIPTION
15635
15636 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15637 BLOCK LIST, shuffle LIST, sum LIST
15638
15639 =item KNOWN BUGS
15640
15641 =item SUGGESTED ADDITIONS
15642
15643 =item COPYRIGHT
15644
15645 =back
15646
15647 =head2 List::Utilib::List::Util, List::Util - A selection of
15648 general-utility list subroutines
15649
15650 =over 4
15651
15652 =item SYNOPSIS
15653
15654 =item DESCRIPTION
15655
15656 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15657 BLOCK LIST, shuffle LIST, sum LIST
15658
15659 =item KNOWN BUGS
15660
15661 =item SUGGESTED ADDITIONS
15662
15663 =item COPYRIGHT
15664
15665 =back
15666
15667 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
15668 general-utility scalar subroutines
15669
15670 =over 4
15671
15672 =item SYNOPSIS
15673
15674 =item DESCRIPTION
15675
15676 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
15677 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
15678 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
15679
15680 =item KNOWN BUGS
15681
15682 =item COPYRIGHT
15683
15684 =item BLATANT PLUG
15685
15686 =back
15687
15688 =head2 Locale::Constants - constants for Locale codes
15689
15690 =over 4
15691
15692 =item SYNOPSIS
15693
15694 =item DESCRIPTION
15695
15696 =item KNOWN BUGS AND LIMITATIONS
15697
15698 =item SEE ALSO
15699
15700 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
15701
15702 =item AUTHOR
15703
15704 =item COPYRIGHT
15705
15706 =back
15707
15708 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
15709
15710 =over 4
15711
15712 =item SYNOPSIS
15713
15714 =item DESCRIPTION
15715
15716 B<alpha-2>, B<alpha-3>, B<numeric>
15717
15718 =item CONVERSION ROUTINES
15719
15720 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
15721 country_code2code( CODE, CODESET, CODESET )
15722
15723 =item QUERY ROUTINES
15724
15725 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
15726
15727 =item SEMI-PRIVATE ROUTINES
15728
15729 =over 4
15730
15731 =item alias_code
15732
15733 =item rename_country
15734
15735 =back
15736
15737 =item EXAMPLES
15738
15739 =item DOMAIN NAMES
15740
15741 =item KNOWN BUGS AND LIMITATIONS
15742
15743 =item SEE ALSO
15744
15745 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
15746 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
15747 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
15748 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
15749
15750 =item AUTHOR
15751
15752 =item COPYRIGHT
15753
15754 =back
15755
15756 =head2 Locale::Currency - ISO three letter codes for currency
15757 identification (ISO 4217)
15758
15759 =over 4
15760
15761 =item SYNOPSIS
15762
15763 =item DESCRIPTION
15764
15765 XTS, XXX
15766
15767 =item CONVERSION ROUTINES
15768
15769 code2currency(), currency2code()
15770
15771 =item QUERY ROUTINES
15772
15773 C<all_currency_codes()>, C<all_currency_names()>
15774
15775 =item EXAMPLES
15776
15777 =item KNOWN BUGS AND LIMITATIONS
15778
15779 =item SEE ALSO
15780
15781 Locale::Country, Locale::Script, ISO 4217:1995,
15782 http://www.bsi-global.com/iso4217currency
15783
15784 =item AUTHOR
15785
15786 =item COPYRIGHT
15787
15788 =back
15789
15790 =head2 Locale::Language - ISO two letter codes for language identification
15791 (ISO 639)
15792
15793 =over 4
15794
15795 =item SYNOPSIS
15796
15797 =item DESCRIPTION
15798
15799 =item CONVERSION ROUTINES
15800
15801 code2language(), language2code()
15802
15803 =item QUERY ROUTINES
15804
15805 C<all_language_codes()>, C<all_language_names()>
15806
15807 =item EXAMPLES
15808
15809 =item KNOWN BUGS AND LIMITATIONS
15810
15811 =item SEE ALSO
15812
15813 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15814 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15815
15816 =item AUTHOR
15817
15818 =item COPYRIGHT
15819
15820 =back
15821
15822 =head2 Locale::Maketext - framework for localization
15823
15824 =over 4
15825
15826 =item SYNOPSIS
15827
15828 =item DESCRIPTION
15829
15830 =item QUICK OVERVIEW
15831
15832 =item METHODS
15833
15834 =over 4
15835
15836 =item Construction Methods
15837
15838 =item The "maketext" Method
15839
15840 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15841
15842 =item Utility Methods
15843
15844 $language->quant($number, $singular), $language->quant($number, $singular,
15845 $plural), $language->quant($number, $singular, $plural, $negative),
15846 $language->numf($number), $language->sprintf($format, @items),
15847 $language->language_tag(), $language->encoding()
15848
15849 =item Language Handle Attributes and Internals
15850
15851 =back
15852
15853 =item LANGUAGE CLASS HIERARCHIES
15854
15855 =item ENTRIES IN EACH LEXICON
15856
15857 =item BRACKET NOTATION
15858
15859 =item AUTO LEXICONS
15860
15861 =item CONTROLLING LOOKUP FAILURE
15862
15863 =item HOW TO USE MAKETEXT
15864
15865 =item SEE ALSO
15866
15867 =item COPYRIGHT AND DISCLAIMER
15868
15869 =item AUTHOR
15870
15871 =back
15872
15873 =head2 Locale::Maketext::TPJ13 -- article about software localization
15874
15875 =over 4
15876
15877 =item SYNOPSIS
15878
15879 =item DESCRIPTION
15880
15881 =item Localization and Perl: gettext breaks, Maketext fixes
15882
15883 =over 4
15884
15885 =item A Localization Horror Story: It Could Happen To You
15886
15887 =item The Linguistic View
15888
15889 =item Breaking gettext
15890
15891 =item Replacing gettext
15892
15893 =item Buzzwords: Abstraction and Encapsulation
15894
15895 =item Buzzword: Isomorphism
15896
15897 =item Buzzword: Inheritance
15898
15899 =item Buzzword: Concision
15900
15901 =item The Devil in the Details
15902
15903 =item The Proof in the Pudding: Localizing Web Sites
15904
15905 =item References
15906
15907 =back
15908
15909 =back
15910
15911 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15912
15913 =over 4
15914
15915 =item SYNOPSIS
15916
15917 =item DESCRIPTION
15918
15919 B<alpha-2>, B<alpha-3>, B<numeric>
15920
15921 =over 4
15922
15923 =item SPECIAL CODES
15924
15925 =back
15926
15927 =item CONVERSION ROUTINES
15928
15929 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15930 script_code2code( CODE, CODESET, CODESET )
15931
15932 =item QUERY ROUTINES
15933
15934 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15935
15936 =item EXAMPLES
15937
15938 =item KNOWN BUGS AND LIMITATIONS
15939
15940 =item SEE ALSO
15941
15942 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15943 http://www.evertype.com/standards/iso15924/
15944
15945 =item AUTHOR
15946
15947 =item COPYRIGHT
15948
15949 =back
15950
15951 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15952
15953 =over 4
15954
15955 =item SYNOPSIS
15956
15957 =item DESCRIPTION
15958
15959 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
15960
15961 =item DIAGNOSTICS
15962
15963 Premature end of base64 data, Premature padding of base64 data
15964
15965 =item EXAMPLES
15966
15967 =item COPYRIGHT
15968
15969 =back
15970
15971 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15972 of quoted-printable strings
15973
15974 =over 4
15975
15976 =item SYNOPSIS
15977
15978 =item DESCRIPTION
15979
15980 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
15981
15982 =item COPYRIGHT
15983
15984 =back
15985
15986 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15987 strings
15988
15989 =over 4
15990
15991 =item SYNOPSIS
15992
15993 =item DESCRIPTION
15994
15995 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
15996
15997 =item COPYRIGHT
15998
15999 =back
16000
16001 =head2 Math::BigFloat - Arbitrary size floating point math package
16002
16003 =over 4
16004
16005 =item SYNOPSIS
16006
16007 =item DESCRIPTION
16008
16009 =over 4
16010
16011 =item Canonical notation
16012
16013 =item Output
16014
16015 =item C<mantissa()>, C<exponent()> and C<parts()>
16016
16017 =item Accuracy vs. Precision
16018
16019 =item Rounding
16020
16021 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16022 ), fround  ( -$scale ) and fround ( 0 )
16023
16024 =back
16025
16026 =item EXAMPLES
16027
16028   # not ready yet
16029
16030 =item Autocreating constants
16031
16032 =over 4
16033
16034 =item Math library
16035
16036 =item Using Math::BigInt::Lite
16037
16038 =back
16039
16040 =item BUGS
16041
16042 =item CAVEAT
16043
16044 stringify, bstr(), bdiv, Modifying and =, bpow
16045
16046 =item LICENSE
16047
16048 =item AUTHORS
16049
16050 =back
16051
16052 =head2 Math::BigInt - Arbitrary size integer math package
16053
16054 =over 4
16055
16056 =item SYNOPSIS
16057
16058 =item DESCRIPTION
16059
16060 Canonical notation, Input, Output
16061
16062 =item METHODS
16063
16064 =over 4
16065
16066 =item config
16067
16068 =item accuracy
16069
16070 =item precision
16071
16072 =item brsft
16073
16074 =item new
16075
16076 =item bnan
16077
16078 =item bzero
16079
16080 =item binf
16081
16082 =item bone
16083
16084 =item is_one()/is_zero()/is_nan()/is_inf()
16085
16086 =item is_positive()/is_negative()
16087
16088         $x->is_positive();              # true if >= 0
16089         $x->is_negative();              # true if <  0
16090
16091 =item is_odd()/is_even()/is_int()
16092
16093 =item bcmp
16094
16095 =item bacmp
16096
16097 =item sign
16098
16099 =item bcmp
16100
16101 =item bneg
16102
16103 =item babs
16104
16105 =item bnorm
16106
16107 =item bnot
16108
16109 =item binc
16110
16111 =item bdec
16112
16113 =item badd
16114
16115 =item bsub
16116
16117 =item bmul
16118
16119 =item bdiv
16120
16121 =item bmod
16122
16123 =item bmodinv
16124
16125 =item bmodpow
16126
16127 =item bpow
16128
16129 =item blsft
16130
16131 =item brsft
16132
16133 =item band
16134
16135 =item bior
16136
16137 =item bxor
16138
16139 =item bnot
16140
16141 =item bsqrt
16142
16143 =item bfac
16144
16145 =item round
16146
16147 =item bround
16148
16149 =item bfround
16150
16151 =item bfloor
16152
16153 =item bceil
16154
16155 =item bgcd
16156
16157 =item blcm
16158
16159 =item exponent
16160
16161 =item mantissa
16162
16163 =item parts
16164
16165 =item copy
16166
16167 =item as_number
16168
16169 =item bsstr
16170
16171 =item as_hex
16172
16173 =item as_bin
16174
16175 =back
16176
16177 =item ACCURACY and PRECISION
16178
16179 =over 4
16180
16181 =item Precision P
16182
16183 =item Accuracy A
16184
16185 =item Fallback F
16186
16187 =item Rounding mode R
16188
16189 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16190 (significant digits), Setting/Accessing, Creating numbers, Usage,
16191 Precedence, Overriding globals, Local settings, Rounding, Default values,
16192 Remarks
16193
16194 =back
16195
16196 =item INTERNALS
16197
16198 =over 4
16199
16200 =item MATH LIBRARY
16201
16202 =item SIGN
16203
16204 =item mantissa(), exponent() and parts()
16205
16206 =back
16207
16208 =item EXAMPLES
16209
16210   use Math::BigInt;
16211
16212 =item Autocreating constants
16213
16214 =item PERFORMANCE
16215
16216 =over 4
16217
16218 =item Alternative math libraries
16219
16220 =item SUBCLASSING
16221
16222 =back
16223
16224 =item Subclassing Math::BigInt
16225
16226 =item UPGRADING
16227
16228 =over 4
16229
16230 =item Auto-upgrade
16231
16232 bsqrt(), div(), blog()
16233
16234 =back
16235
16236 =item BUGS
16237
16238 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
16239
16240 =item CAVEATS
16241
16242 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16243 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16244 types, bsqrt(), brsft()
16245
16246 =item LICENSE
16247
16248 =item SEE ALSO
16249
16250 =item AUTHORS
16251
16252 =back
16253
16254 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16255
16256 =over 4
16257
16258 =item SYNOPSIS
16259
16260 =item DESCRIPTION
16261
16262 =item EXPORT
16263
16264 =item WRAP YOUR OWN
16265
16266 =item LICENSE
16267
16268 This program is free software; you may redistribute it and/or modify it
16269 under
16270 the same terms as Perl itself.
16271
16272 =item AUTHORS
16273
16274 =item SEE ALSO
16275
16276 =back
16277
16278 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16279 scalars
16280
16281 =over 4
16282
16283 =item SYNOPSIS
16284
16285 =item DESCRIPTION
16286
16287 =item LICENSE
16288
16289 This program is free software; you may redistribute it and/or modify it
16290 under
16291 the same terms as Perl itself.
16292
16293 =item AUTHOR
16294
16295 =item SEE ALSO
16296
16297 =back
16298
16299 =head2 Math::BigRat - arbitrarily big rationales
16300
16301 =over 4
16302
16303 =item SYNOPSIS
16304
16305 =item DESCRIPTION
16306
16307 =over 4
16308
16309 =item MATH LIBRARY
16310
16311 =back
16312
16313 =item METHODS
16314
16315 =over 4
16316
16317 =item new()
16318
16319 =item numerator()
16320
16321 =item denominator()
16322
16323         $d = $x->denominator();
16324
16325 =item parts()
16326
16327 =item as_number()
16328
16329 =item bfac()
16330
16331 =item blog()
16332
16333 =item bround()/round()/bfround()
16334
16335 =item is_one()
16336
16337 =item is_zero()
16338
16339 =item is_positive()
16340
16341 =item is_negative()
16342
16343 =item is_int()
16344
16345 =item is_odd()
16346
16347 =item is_even()
16348
16349 =item bceil()
16350
16351 =item bfloor()
16352
16353         $x->bfloor();
16354
16355 =back
16356
16357 =item BUGS
16358
16359 inf handling (partial), NaN handling (partial), rounding (not implemented
16360 except for bceil/bfloor), $x ** $y where $y is not an integer
16361
16362 =item LICENSE
16363
16364 =item SEE ALSO
16365
16366 =item AUTHORS
16367
16368 =back
16369
16370 =head2 Math::Complex - complex numbers and associated mathematical
16371 functions
16372
16373 =over 4
16374
16375 =item SYNOPSIS
16376
16377 =item DESCRIPTION
16378
16379 =item OPERATIONS
16380
16381 =item CREATION
16382
16383 =item STRINGIFICATION
16384
16385 =over 4
16386
16387 =item CHANGED IN PERL 5.6
16388
16389 =back
16390
16391 =item USAGE
16392
16393 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16394
16395 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16396
16397 =item BUGS
16398
16399 =item AUTHORS
16400
16401 =back
16402
16403 =head2 Math::Trig - trigonometric functions
16404
16405 =over 4
16406
16407 =item SYNOPSIS
16408
16409 =item DESCRIPTION
16410
16411 =item TRIGONOMETRIC FUNCTIONS
16412
16413 B<tan>
16414
16415 =over 4
16416
16417 =item ERRORS DUE TO DIVISION BY ZERO
16418
16419 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16420
16421 =back
16422
16423 =item PLANE ANGLE CONVERSIONS
16424
16425 =item RADIAL COORDINATE CONVERSIONS
16426
16427 =over 4
16428
16429 =item COORDINATE SYSTEMS
16430
16431 =item 3-D ANGLE CONVERSIONS
16432
16433 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16434 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16435
16436 =back
16437
16438 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16439
16440 =item EXAMPLES
16441
16442 =over 4
16443
16444 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16445
16446 =back
16447
16448 =item BUGS
16449
16450 =item AUTHORS
16451
16452 =back
16453
16454 =head2 Memoize - Make functions faster by trading space for time
16455
16456 =over 4
16457
16458 =item SYNOPSIS
16459
16460 =item DESCRIPTION
16461
16462 =item DETAILS
16463
16464 =item OPTIONS
16465
16466 =over 4
16467
16468 =item INSTALL
16469
16470 =item NORMALIZER
16471
16472 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16473
16474 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16475
16476 =back
16477
16478 =item OTHER FACILITIES
16479
16480 =over 4
16481
16482 =item C<unmemoize>
16483
16484 =item C<flush_cache>
16485
16486 =back
16487
16488 =item CAVEATS
16489
16490 =item PERSISTENT CACHE SUPPORT
16491
16492 =item EXPIRATION SUPPORT
16493
16494 =item BUGS
16495
16496 =item MAILING LIST
16497
16498 =item AUTHOR
16499
16500 =item COPYRIGHT AND LICENSE
16501
16502 =item THANK YOU
16503
16504 =back
16505
16506 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16507 Storable use
16508
16509 =over 4
16510
16511 =item DESCRIPTION
16512
16513 =back
16514
16515 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16516 memoized values
16517
16518 =over 4
16519
16520 =item SYNOPSIS
16521
16522 =item DESCRIPTION
16523
16524 =item INTERFACE
16525
16526  TIEHASH,  EXISTS,  STORE
16527
16528 =item ALTERNATIVES
16529
16530 =item CAVEATS
16531
16532 =item AUTHOR
16533
16534 =item SEE ALSO
16535
16536 =back
16537
16538 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16539
16540 =over 4
16541
16542 =item DESCRIPTION
16543
16544 =back
16545
16546 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16547
16548 =over 4
16549
16550 =item DESCRIPTION
16551
16552 =back
16553
16554 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16555 Storable use
16556
16557 =over 4
16558
16559 =item DESCRIPTION
16560
16561 =back
16562
16563 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16564 Storable use
16565
16566 =over 4
16567
16568 =item DESCRIPTION
16569
16570 =back
16571
16572 =head2 Memoize::Storable - store Memoized data in Storable database
16573
16574 =over 4
16575
16576 =item DESCRIPTION
16577
16578 =back
16579
16580 =head2 NDBM_File - Tied access to ndbm files
16581
16582 =over 4
16583
16584 =item SYNOPSIS
16585
16586 =item DESCRIPTION
16587
16588 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16589
16590 =item DIAGNOSTICS
16591
16592 =over 4
16593
16594 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16595
16596 =back
16597
16598 =item BUGS AND WARNINGS
16599
16600 =back
16601
16602 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
16603
16604 =over 4
16605
16606 =item SYNOPSIS
16607
16608 =item DESCRIPTION
16609
16610 =over 4
16611
16612 =item Enforcing redispatch
16613
16614 =item Avoiding repetitions
16615
16616 =back
16617
16618 =item AUTHOR
16619
16620 =item BUGS AND IRRITATIONS
16621
16622 =item COPYRIGHT
16623
16624 =back
16625
16626 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
16627
16628 =over 4
16629
16630 =item SYNOPSIS
16631
16632 =item DESCRIPTION
16633
16634 =item USER METHODS
16635
16636 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
16637 dataend ()
16638
16639 =item CLASS METHODS
16640
16641 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
16642 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
16643 ungetline ( TEXT ), read_until_dot (), tied_fh ()
16644
16645 =item EXPORTS
16646
16647 =item AUTHOR
16648
16649 =item COPYRIGHT
16650
16651 =back
16652
16653 =head2 Net::Config - Local configuration data for libnet
16654
16655 =over 4
16656
16657 =item SYNOPSYS
16658
16659 =item DESCRIPTION
16660
16661 =item METHODS
16662
16663 requires_firewall HOST
16664
16665 =item NetConfig VALUES
16666
16667 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
16668 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
16669 ftp_int_pasive, local_netmask, test_hosts, test_exists
16670
16671 =back
16672
16673 =head2 Net::Domain - Attempt to evaluate the current host's internet name
16674 and domain
16675
16676 =over 4
16677
16678 =item SYNOPSIS
16679
16680 =item DESCRIPTION
16681
16682 hostfqdn (), hostname (), hostdomain ()
16683
16684 =item AUTHOR
16685
16686 =item COPYRIGHT
16687
16688 =back
16689
16690 =head2 Net::FTP - FTP Client class
16691
16692 =over 4
16693
16694 =item SYNOPSIS
16695
16696 =item DESCRIPTION
16697
16698 =item OVERVIEW
16699
16700 =item CONSTRUCTOR
16701
16702 new (HOST [,OPTIONS])
16703
16704 =item METHODS
16705
16706 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
16707 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
16708 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
16709 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
16710 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
16711 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
16712 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
16713 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
16714 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
16715 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
16716 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
16717 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
16718 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
16719
16720 =over 4
16721
16722 =item Methods for the adventurous
16723
16724 quot (CMD [,ARGS])
16725
16726 =back
16727
16728 =item THE dataconn CLASS
16729
16730 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
16731 bytes_read (), abort (), close ()
16732
16733 =item UNIMPLEMENTED
16734
16735 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
16736
16737 =item REPORTING BUGS
16738
16739 =item AUTHOR
16740
16741 =item SEE ALSO
16742
16743 =item USE EXAMPLES
16744
16745 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
16746
16747 =item CREDITS
16748
16749 =item COPYRIGHT
16750
16751 =back
16752
16753 =head2 Net::NNTP - NNTP Client class
16754
16755 =over 4
16756
16757 =item SYNOPSIS
16758
16759 =item DESCRIPTION
16760
16761 =item CONSTRUCTOR
16762
16763 new ( [ HOST ] [, OPTIONS ])
16764
16765 =item METHODS
16766
16767 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
16768 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
16769 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
16770 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
16771 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
16772 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
16773 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
16774
16775 =over 4
16776
16777 =item Extension methods
16778
16779 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
16780 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
16781 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
16782 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
16783 GROUP ] ), reader
16784
16785 =back
16786
16787 =item UNSUPPORTED
16788
16789 =item DEFINITIONS
16790
16791 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
16792
16793 =item SEE ALSO
16794
16795 =item AUTHOR
16796
16797 =item COPYRIGHT
16798
16799 =back
16800
16801 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
16802
16803 =over 4
16804
16805 =item SYNOPSIS
16806
16807 =item DESCRIPTION
16808
16809 =item EXAMPLES
16810
16811 =item CONSTRUCTOR
16812
16813 new ( [ HOST, ] [ OPTIONS ] )
16814
16815 =item METHODS
16816
16817 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16818 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16819 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16820 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16821
16822 =item NOTES
16823
16824 =item SEE ALSO
16825
16826 =item AUTHOR
16827
16828 =item COPYRIGHT
16829
16830 =back
16831
16832 =head2 Net::Ping - check a remote host for reachability
16833
16834 =over 4
16835
16836 =item SYNOPSIS
16837
16838 =item DESCRIPTION
16839
16840 =over 4
16841
16842 =item Functions
16843
16844 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device ]]]]);,
16845 $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
16846 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
16847 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
16848 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
16849 [, $timeout]);
16850
16851 =back
16852
16853 =item NOTES
16854
16855 =item INSTALL
16856
16857 =item BUGS
16858
16859 =item AUTHORS
16860
16861 =item COPYRIGHT
16862
16863 =back
16864
16865 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16866
16867 =over 4
16868
16869 =item SYNOPSIS
16870
16871 =item DESCRIPTION
16872
16873 =item EXAMPLES
16874
16875 =item CONSTRUCTOR
16876
16877 new Net::SMTP [ HOST, ] [ OPTIONS ]
16878
16879 =item METHODS
16880
16881 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16882 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16883 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16884 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16885 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16886 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16887 quit ()
16888
16889 =item ADDRESSES
16890
16891 =item SEE ALSO
16892
16893 =item AUTHOR
16894
16895 =item COPYRIGHT
16896
16897 =back
16898
16899 =head2 Net::Time - time and daytime network client interface
16900
16901 =over 4
16902
16903 =item SYNOPSIS
16904
16905 =item DESCRIPTION
16906
16907 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16908 PROTOCOL [, TIMEOUT]]])
16909
16910 =item AUTHOR
16911
16912 =item COPYRIGHT
16913
16914 =back
16915
16916 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16917 functions
16918
16919 =over 4
16920
16921 =item SYNOPSIS
16922
16923 =item DESCRIPTION
16924
16925 =item EXAMPLES
16926
16927 =item NOTE
16928
16929 =item AUTHOR
16930
16931 =back
16932
16933 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16934
16935 =over 4
16936
16937 =item DESCRIPTION
16938
16939 =over 4
16940
16941 =item Where to get this document
16942
16943 =item How to contribute to this document
16944
16945 =back
16946
16947 =item Author and Copyright Information
16948
16949 =over 4
16950
16951 =item Disclaimer
16952
16953 =back
16954
16955 =item Obtaining and installing libnet
16956
16957 =over 4
16958
16959 =item What is libnet ?
16960
16961 =item Which version of perl do I need ?
16962
16963 =item What other modules do I need ?
16964
16965 =item What machines support libnet ?
16966
16967 =item Where can I get the latest libnet release
16968
16969 =back
16970
16971 =item Using Net::FTP
16972
16973 =over 4
16974
16975 =item How do I download files from an FTP server ?
16976
16977 =item How do I transfer files in binary mode ?
16978
16979 =item How can I get the size of a file on a remote FTP server ?
16980
16981 =item How can I get the modification time of a file on a remote FTP server
16982 ?
16983
16984 =item How can I change the permissions of a file on a remote server ?
16985
16986 =item Can I do a reget operation like the ftp command ?
16987
16988 =item How do I get a directory listing from an FTP server ?
16989
16990 =item Changing directory to "" does not fail ?
16991
16992 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16993
16994 =item I am behind an FTP proxy firewall, but cannot access machines outside
16995 ?
16996
16997 =item My ftp proxy firewall does not listen on port 21
16998
16999 =item Is it possible to change the file permissions of a file on an FTP
17000 server ?
17001
17002 =item I have seen scripts call a method message, but cannot find it
17003 documented ?
17004
17005 =item Why does Net::FTP not implement mput and mget methods
17006
17007 =back
17008
17009 =item Using Net::SMTP
17010
17011 =over 4
17012
17013 =item Why can't the part of an Email address after the @ be used as the
17014 hostname ?
17015
17016 =item Why does Net::SMTP not do DNS MX lookups ?
17017
17018 =item The verify method always returns true ?
17019
17020 =back
17021
17022 =item Debugging scripts
17023
17024 =over 4
17025
17026 =item How can I debug my scripts that use Net::* modules ?
17027
17028 =back
17029
17030 =item AUTHOR AND COPYRIGHT
17031
17032 =back
17033
17034 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17035 functions
17036
17037 =over 4
17038
17039 =item SYNOPSIS
17040
17041 =item DESCRIPTION
17042
17043 =item EXAMPLES
17044
17045 =item NOTE
17046
17047 =item AUTHOR
17048
17049 =back
17050
17051 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17052 functions
17053
17054 =over 4
17055
17056 =item SYNOPSIS
17057
17058 =item DESCRIPTION
17059
17060 =item NOTE
17061
17062 =item AUTHOR
17063
17064 =back
17065
17066 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17067 functions
17068
17069 =over 4
17070
17071 =item SYNOPSIS
17072
17073 =item DESCRIPTION
17074
17075 =item EXAMPLES
17076
17077 =item NOTE
17078
17079 =item AUTHOR
17080
17081 =back
17082
17083 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17084
17085 =over 4
17086
17087 =item SYNOPSIS
17088
17089 =item DESCRIPTION
17090
17091 =item THE .netrc FILE
17092
17093 machine name, default, login name, password string, account string, macdef
17094 name
17095
17096 =item CONSTRUCTOR
17097
17098 lookup ( MACHINE [, LOGIN ])
17099
17100 =item METHODS
17101
17102 login (), password (), account (), lpa ()
17103
17104 =item AUTHOR
17105
17106 =item SEE ALSO
17107
17108 =item COPYRIGHT
17109
17110 =back
17111
17112 =head2 O - Generic interface to Perl Compiler backends
17113
17114 =over 4
17115
17116 =item SYNOPSIS
17117
17118 =item DESCRIPTION
17119
17120 =item CONVENTIONS
17121
17122 =item IMPLEMENTATION
17123
17124 =item BUGS
17125
17126 =item AUTHOR
17127
17128 =back
17129
17130 =head2 ODBM_File - Tied access to odbm files
17131
17132 =over 4
17133
17134 =item SYNOPSIS
17135
17136 =item DESCRIPTION
17137
17138 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17139
17140 =item DIAGNOSTICS
17141
17142 =over 4
17143
17144 =item C<odbm store returned -1, errno 22, key "..." at ...>
17145
17146 =back
17147
17148 =item BUGS AND WARNINGS
17149
17150 =back
17151
17152 =head2 Opcode - Disable named opcodes when compiling perl code
17153
17154 =over 4
17155
17156 =item SYNOPSIS
17157
17158 =item DESCRIPTION
17159
17160 =item NOTE
17161
17162 =item WARNING
17163
17164 =item Operator Names and Operator Lists
17165
17166 an operator name (opname), an operator tag name (optag), a negated opname
17167 or optag, an operator set (opset)
17168
17169 =item Opcode Functions
17170
17171 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17172 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17173 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17174 opdump (PAT)
17175
17176 =item Manipulating Opsets
17177
17178 =item TO DO (maybe)
17179
17180 =back
17181
17182 =over 4
17183
17184 =item Predefined Opcode Tags
17185
17186 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17187 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17188 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17189 :dangerous
17190
17191 =item SEE ALSO
17192
17193 =item AUTHORS
17194
17195 =back
17196
17197 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17198 compartments
17199
17200 =over 4
17201
17202 =item SYNOPSIS
17203
17204 =item DESCRIPTION
17205
17206 a new namespace, an operator mask
17207
17208 =item WARNING
17209
17210 =over 4
17211
17212 =item RECENT CHANGES
17213
17214 =item Methods in class Safe
17215
17216 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17217 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17218 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17219 root (NAMESPACE), mask (MASK)
17220
17221 =item Some Safety Issues
17222
17223 Memory, CPU, Snooping, Signals, State Changes
17224
17225 =item AUTHOR
17226
17227 =back
17228
17229 =back
17230
17231 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17232 compiling
17233
17234 =over 4
17235
17236 =item SYNOPSIS
17237
17238 =item DESCRIPTION
17239
17240 =item SEE ALSO
17241
17242 =back
17243
17244 =head2 POSIX - Perl interface to IEEE Std 1003.1
17245
17246 =over 4
17247
17248 =item SYNOPSIS
17249
17250 =item DESCRIPTION
17251
17252 =item NOTE
17253
17254 =item CAVEATS
17255
17256 =item FUNCTIONS
17257
17258 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17259 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17260 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17261 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17262 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17263 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17264 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17265 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17266 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17267 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17268 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17269 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17270 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17271 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17272 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17273 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17274 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17275 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17276 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17277 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17278 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17279 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17280 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17281 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17282 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17283 wctomb, write
17284
17285 =item CLASSES
17286
17287 =over 4
17288
17289 =item POSIX::SigAction
17290
17291 new, handler, mask, flags
17292
17293 =item POSIX::SigSet
17294
17295 new, addset, delset, emptyset, fillset, ismember
17296
17297 =item POSIX::Termios
17298
17299 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17300 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17301 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17302 field values, c_cflag field values, c_iflag field values, c_lflag field
17303 values, c_oflag field values
17304
17305 =back
17306
17307 =item PATHNAME CONSTANTS
17308
17309 Constants
17310
17311 =item POSIX CONSTANTS
17312
17313 Constants
17314
17315 =item SYSTEM CONFIGURATION
17316
17317 Constants
17318
17319 =item ERRNO
17320
17321 Constants
17322
17323 =item FCNTL
17324
17325 Constants
17326
17327 =item FLOAT
17328
17329 Constants
17330
17331 =item LIMITS
17332
17333 Constants
17334
17335 =item LOCALE
17336
17337 Constants
17338
17339 =item MATH
17340
17341 Constants
17342
17343 =item SIGNAL
17344
17345 Constants
17346
17347 =item STAT
17348
17349 Constants, Macros
17350
17351 =item STDLIB
17352
17353 Constants
17354
17355 =item STDIO
17356
17357 Constants
17358
17359 =item TIME
17360
17361 Constants
17362
17363 =item UNISTD
17364
17365 Constants
17366
17367 =item WAIT
17368
17369 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17370 WTERMSIG, WIFSTOPPED, WSTOPSIG
17371
17372 =back
17373
17374 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17375 name space
17376
17377 =over 4
17378
17379 =item SYNOPSIS
17380
17381 =item DESCRIPTION
17382
17383 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
17384
17385 =over 4
17386
17387 =item Custom Layers
17388
17389 :encoding, :via
17390
17391 =item Alternatives to raw
17392
17393 =item Defaults and how to override them
17394
17395 =item Querying the layers of filehandle
17396
17397 =back
17398
17399 =item AUTHOR
17400
17401 =item SEE ALSO
17402
17403 =back
17404
17405 =head2 PerlIO::encoding - encoding layer
17406
17407 =over 4
17408
17409 =item SYNOPSIS
17410
17411 =item DESCRIPTION
17412
17413 =item SEE ALSO
17414
17415 =back
17416
17417 =head2 PerlIO::scalar - support module for in-memory IO.
17418
17419 =over 4
17420
17421 =item SYNOPSIS
17422
17423 =item DESCRIPTION
17424
17425 =back
17426
17427 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17428
17429 =over 4
17430
17431 =item SYNOPSIS
17432
17433 =item DESCRIPTION
17434
17435 =item EXPECTED METHODS
17436
17437 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17438 $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
17439 $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
17440 $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
17441 $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
17442 $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
17443 $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
17444 $obj->EOF($fh)
17445
17446 =item EXAMPLES
17447
17448 =over 4
17449
17450 =item Example - a Hexadecimal Handle
17451
17452 =back
17453
17454 =back
17455
17456 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17457
17458 =over 4
17459
17460 =item SYNOPSIS
17461
17462 =item DESCRIPTION
17463
17464 =item SEE ALSO
17465
17466 =item COPYRIGHT
17467
17468 =back
17469
17470 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17471
17472 =over 4
17473
17474 =item SYNOPSIS
17475
17476 =item OPTIONS/ARGUMENTS
17477
17478 =over 4
17479
17480 =item podchecker()
17481
17482 B<-warnings> =E<gt> I<val>
17483
17484 =back
17485
17486 =item DESCRIPTION
17487
17488 =item DIAGNOSTICS
17489
17490 =over 4
17491
17492 =item Errors
17493
17494 empty =headn, =over on line I<N> without closing =back, =item without
17495 previous =over, =back without previous =over, No argument for =begin, =end
17496 without =begin, Nested =begin's, =for without formatter specification,
17497 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17498 interior-sequence "I<SEQ>", nested commands
17499 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17500 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17501 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17502 after =back
17503
17504 =item Warnings
17505
17506 multiple occurrence of link target I<name>, line containing nothing but
17507 whitespace in paragraph, file does not start with =head, previous =item has
17508 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17509 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17510 items in =over, No argument for =item, empty section in previous paragraph,
17511 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17512 level
17513
17514 =item Hyperlinks
17515
17516 ignoring leading/trailing whitespace in link, (section) in '$page'
17517 deprecated, alternative text/node '%s' contains non-escaped | or /
17518
17519 =back
17520
17521 =item RETURN VALUE
17522
17523 =item EXAMPLES
17524
17525 =item INTERFACE
17526
17527 =back
17528
17529 C<Pod::Checker-E<gt>new( %options )>
17530
17531 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17532 @args )>
17533
17534 C<$checker-E<gt>num_errors()>
17535
17536 C<$checker-E<gt>num_warnings()>
17537
17538 C<$checker-E<gt>name()>
17539
17540 C<$checker-E<gt>node()>
17541
17542 C<$checker-E<gt>idx()>
17543
17544 C<$checker-E<gt>hyperlink()>
17545
17546 =over 4
17547
17548 =item AUTHOR
17549
17550 =back
17551
17552 =head2 Pod::Find - find POD documents in directory trees
17553
17554 =over 4
17555
17556 =item SYNOPSIS
17557
17558 =item DESCRIPTION
17559
17560 =back
17561
17562 =over 4
17563
17564 =item C<pod_find( { %opts } , @directories )>
17565
17566 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17567 1>
17568
17569 =back
17570
17571 =over 4
17572
17573 =item C<simplify_name( $str )>
17574
17575 =back
17576
17577 =over 4
17578
17579 =item C<pod_where( { %opts }, $pod )>
17580
17581 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17582 1>
17583
17584 =back
17585
17586 =over 4
17587
17588 =item C<contains_pod( $file , $verbose )>
17589
17590 =back
17591
17592 =over 4
17593
17594 =item AUTHOR
17595
17596 =item SEE ALSO
17597
17598 =back
17599
17600 =head2 Pod::Html - module to convert pod files to HTML
17601
17602 =over 4
17603
17604 =item SYNOPSIS
17605
17606 =item DESCRIPTION
17607
17608 =item ARGUMENTS
17609
17610 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
17611 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
17612 title, verbose
17613
17614 =item EXAMPLE
17615
17616 =item ENVIRONMENT
17617
17618 =item AUTHOR
17619
17620 =item SEE ALSO
17621
17622 =item COPYRIGHT
17623
17624 =back
17625
17626 =head2 Pod::InputObjects - objects representing POD input paragraphs,
17627 commands, etc.
17628
17629 =over 4
17630
17631 =item SYNOPSIS
17632
17633 =item REQUIRES
17634
17635 =item EXPORTS
17636
17637 =item DESCRIPTION
17638
17639 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
17640 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
17641
17642 =back
17643
17644 =over 4
17645
17646 =item B<Pod::InputSource>
17647
17648 =back
17649
17650 =over 4
17651
17652 =item B<new()>
17653
17654 =back
17655
17656 =over 4
17657
17658 =item B<name()>
17659
17660 =back
17661
17662 =over 4
17663
17664 =item B<handle()>
17665
17666 =back
17667
17668 =over 4
17669
17670 =item B<was_cutting()>
17671
17672 =back
17673
17674 =over 4
17675
17676 =item B<Pod::Paragraph>
17677
17678 =back
17679
17680 =over 4
17681
17682 =item Pod::Paragraph-E<gt>B<new()>
17683
17684 =back
17685
17686 =over 4
17687
17688 =item $pod_para-E<gt>B<cmd_name()>
17689
17690 =back
17691
17692 =over 4
17693
17694 =item $pod_para-E<gt>B<text()>
17695
17696 =back
17697
17698 =over 4
17699
17700 =item $pod_para-E<gt>B<raw_text()>
17701
17702 =back
17703
17704 =over 4
17705
17706 =item $pod_para-E<gt>B<cmd_prefix()>
17707
17708 =back
17709
17710 =over 4
17711
17712 =item $pod_para-E<gt>B<cmd_separator()>
17713
17714 =back
17715
17716 =over 4
17717
17718 =item $pod_para-E<gt>B<parse_tree()>
17719
17720 =back
17721
17722 =over 4
17723
17724 =item $pod_para-E<gt>B<file_line()>
17725
17726 =back
17727
17728 =over 4
17729
17730 =item B<Pod::InteriorSequence>
17731
17732 =back
17733
17734 =over 4
17735
17736 =item Pod::InteriorSequence-E<gt>B<new()>
17737
17738 =back
17739
17740 =over 4
17741
17742 =item $pod_seq-E<gt>B<cmd_name()>
17743
17744 =back
17745
17746 =over 4
17747
17748 =item $pod_seq-E<gt>B<prepend()>
17749
17750 =back
17751
17752 =over 4
17753
17754 =item $pod_seq-E<gt>B<append()>
17755
17756 =back
17757
17758 =over 4
17759
17760 =item $pod_seq-E<gt>B<nested()>
17761
17762 =back
17763
17764 =over 4
17765
17766 =item $pod_seq-E<gt>B<raw_text()>
17767
17768 =back
17769
17770 =over 4
17771
17772 =item $pod_seq-E<gt>B<left_delimiter()>
17773
17774 =back
17775
17776 =over 4
17777
17778 =item $pod_seq-E<gt>B<right_delimiter()>
17779
17780 =back
17781
17782 =over 4
17783
17784 =item $pod_seq-E<gt>B<parse_tree()>
17785
17786 =back
17787
17788 =over 4
17789
17790 =item $pod_seq-E<gt>B<file_line()>
17791
17792 =back
17793
17794 =over 4
17795
17796 =item Pod::InteriorSequence::B<DESTROY()>
17797
17798 =back
17799
17800 =over 4
17801
17802 =item B<Pod::ParseTree>
17803
17804 =back
17805
17806 =over 4
17807
17808 =item Pod::ParseTree-E<gt>B<new()>
17809
17810 =back
17811
17812 =over 4
17813
17814 =item $ptree-E<gt>B<top()>
17815
17816 =back
17817
17818 =over 4
17819
17820 =item $ptree-E<gt>B<children()>
17821
17822 =back
17823
17824 =over 4
17825
17826 =item $ptree-E<gt>B<prepend()>
17827
17828 =back
17829
17830 =over 4
17831
17832 =item $ptree-E<gt>B<append()>
17833
17834 =back
17835
17836 =over 4
17837
17838 =item $ptree-E<gt>B<raw_text()>
17839
17840 =back
17841
17842 =over 4
17843
17844 =item Pod::ParseTree::B<DESTROY()>
17845
17846 =back
17847
17848 =over 4
17849
17850 =item SEE ALSO
17851
17852 =item AUTHOR
17853
17854 =back
17855
17856 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17857
17858 =over 4
17859
17860 =item SYNOPSIS
17861
17862 =item DESCRIPTION
17863
17864 =back
17865
17866 =over 4
17867
17868 =item OBJECT METHODS
17869
17870 C<initialize>
17871
17872 =back
17873
17874 =over 4
17875
17876 =item Data Accessors
17877
17878 B<AddPreamble>
17879
17880 =back
17881
17882 B<AddPostamble>
17883
17884 B<Head1Level>
17885
17886 B<Label>
17887
17888 B<LevelNoNum>
17889
17890 B<MakeIndex>
17891
17892 B<ReplaceNAMEwithSection>
17893
17894 B<StartWithNewPage>
17895
17896 B<TableOfContents>
17897
17898 B<UniqueLabels>
17899
17900 B<UserPreamble>
17901
17902 B<UserPostamble>
17903
17904 B<Lists>
17905
17906 =over 4
17907
17908 =item Subclassed methods
17909
17910 =back
17911
17912 B<begin_pod>
17913
17914 B<end_pod>
17915
17916 B<command>
17917
17918 B<verbatim>
17919
17920 B<textblock>
17921
17922 B<interior_sequence>
17923
17924 =over 4
17925
17926 =item List Methods
17927
17928 B<begin_list>
17929
17930 =back
17931
17932 B<end_list>
17933
17934 B<add_item>
17935
17936 =over 4
17937
17938 =item Methods for headings
17939
17940 B<head>
17941
17942 =back
17943
17944 =over 4
17945
17946 =item Internal methods
17947
17948 B<_output>
17949
17950 =back
17951
17952 B<_replace_special_chars>
17953
17954 B<_replace_special_chars_late>
17955
17956 B<_create_label>
17957
17958 B<_create_index>
17959
17960 B<_clean_latex_commands>
17961
17962 B<_split_delimited>
17963
17964 =over 4
17965
17966 =item NOTES
17967
17968 =item SEE ALSO
17969
17970 =item AUTHORS
17971
17972 =item COPYRIGHT
17973
17974 =item REVISION
17975
17976 =back
17977
17978 =head2 Pod::Man - Convert POD data to formatted *roff input
17979
17980 =over 4
17981
17982 =item SYNOPSIS
17983
17984 =item DESCRIPTION
17985
17986 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17987 release, section
17988
17989 =item DIAGNOSTICS
17990
17991 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17992 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17993 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17994 =back
17995
17996 =item BUGS
17997
17998 =item CAVEATS
17999
18000 =item SEE ALSO
18001
18002 =item AUTHOR
18003
18004 =item COPYRIGHT AND LICENSE
18005
18006 =back
18007
18008 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18009
18010 =over 4
18011
18012 =item SYNOPSIS
18013
18014 =item DESCRIPTION
18015
18016 =item SEE ALSO
18017
18018 =item AUTHOR
18019
18020 =item COPYRIGHT AND LICENSE
18021
18022 =back
18023
18024 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18025
18026 =over 4
18027
18028 =item SYNOPSIS
18029
18030 =item DESCRIPTION
18031
18032 =back
18033
18034 =over 4
18035
18036 =item Pod::List
18037
18038 Pod::List-E<gt>new()
18039
18040 =back
18041
18042 $list-E<gt>file()
18043
18044 $list-E<gt>start()
18045
18046 $list-E<gt>indent()
18047
18048 $list-E<gt>type()
18049
18050 $list-E<gt>rx()
18051
18052 $list-E<gt>item()
18053
18054 $list-E<gt>parent()
18055
18056 $list-E<gt>tag()
18057
18058 =over 4
18059
18060 =item Pod::Hyperlink
18061
18062 Pod::Hyperlink-E<gt>new()
18063
18064 =back
18065
18066 $link-E<gt>parse($string)
18067
18068 $link-E<gt>markup($string)
18069
18070 $link-E<gt>text()
18071
18072 $link-E<gt>warning()
18073
18074 $link-E<gt>file(), $link-E<gt>line()
18075
18076 $link-E<gt>page()
18077
18078 $link-E<gt>node()
18079
18080 $link-E<gt>alttext()
18081
18082 $link-E<gt>type()
18083
18084 $link-E<gt>link()
18085
18086 =over 4
18087
18088 =item Pod::Cache
18089
18090 Pod::Cache-E<gt>new()
18091
18092 =back
18093
18094 $cache-E<gt>item()
18095
18096 $cache-E<gt>find_page($name)
18097
18098 =over 4
18099
18100 =item Pod::Cache::Item
18101
18102 Pod::Cache::Item-E<gt>new()
18103
18104 =back
18105
18106 $cacheitem-E<gt>page()
18107
18108 $cacheitem-E<gt>description()
18109
18110 $cacheitem-E<gt>path()
18111
18112 $cacheitem-E<gt>file()
18113
18114 $cacheitem-E<gt>nodes()
18115
18116 $cacheitem-E<gt>find_node($name)
18117
18118 $cacheitem-E<gt>idx()
18119
18120 =over 4
18121
18122 =item AUTHOR
18123
18124 =item SEE ALSO
18125
18126 =back
18127
18128 =head2 Pod::Parser - base class for creating POD filters and translators
18129
18130 =over 4
18131
18132 =item SYNOPSIS
18133
18134 =item REQUIRES
18135
18136 =item EXPORTS
18137
18138 =item DESCRIPTION
18139
18140 =item QUICK OVERVIEW
18141
18142 =item PARSING OPTIONS
18143
18144 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18145 B<-warnings> (default: unset)
18146
18147 =back
18148
18149 =over 4
18150
18151 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18152
18153 =back
18154
18155 =over 4
18156
18157 =item B<command()>
18158
18159 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18160
18161 =back
18162
18163 =over 4
18164
18165 =item B<verbatim()>
18166
18167 C<$text>, C<$line_num>, C<$pod_para>
18168
18169 =back
18170
18171 =over 4
18172
18173 =item B<textblock()>
18174
18175 C<$text>, C<$line_num>, C<$pod_para>
18176
18177 =back
18178
18179 =over 4
18180
18181 =item B<interior_sequence()>
18182
18183 =back
18184
18185 =over 4
18186
18187 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18188
18189 =back
18190
18191 =over 4
18192
18193 =item B<new()>
18194
18195 =back
18196
18197 =over 4
18198
18199 =item B<initialize()>
18200
18201 =back
18202
18203 =over 4
18204
18205 =item B<begin_pod()>
18206
18207 =back
18208
18209 =over 4
18210
18211 =item B<begin_input()>
18212
18213 =back
18214
18215 =over 4
18216
18217 =item B<end_input()>
18218
18219 =back
18220
18221 =over 4
18222
18223 =item B<end_pod()>
18224
18225 =back
18226
18227 =over 4
18228
18229 =item B<preprocess_line()>
18230
18231 =back
18232
18233 =over 4
18234
18235 =item B<preprocess_paragraph()>
18236
18237 =back
18238
18239 =over 4
18240
18241 =item METHODS FOR PARSING AND PROCESSING
18242
18243 =back
18244
18245 =over 4
18246
18247 =item B<parse_text()>
18248
18249 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18250 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18251 I<code-ref>|I<method-name>
18252
18253 =back
18254
18255 =over 4
18256
18257 =item B<interpolate()>
18258
18259 =back
18260
18261 =over 4
18262
18263 =item B<parse_paragraph()>
18264
18265 =back
18266
18267 =over 4
18268
18269 =item B<parse_from_filehandle()>
18270
18271 =back
18272
18273 =over 4
18274
18275 =item B<parse_from_file()>
18276
18277 =back
18278
18279 =over 4
18280
18281 =item ACCESSOR METHODS
18282
18283 =back
18284
18285 =over 4
18286
18287 =item B<errorsub()>
18288
18289 =back
18290
18291 =over 4
18292
18293 =item B<cutting()>
18294
18295 =back
18296
18297 =over 4
18298
18299 =item B<parseopts()>
18300
18301 =back
18302
18303 =over 4
18304
18305 =item B<output_file()>
18306
18307 =back
18308
18309 =over 4
18310
18311 =item B<output_handle()>
18312
18313 =back
18314
18315 =over 4
18316
18317 =item B<input_file()>
18318
18319 =back
18320
18321 =over 4
18322
18323 =item B<input_handle()>
18324
18325 =back
18326
18327 =over 4
18328
18329 =item B<input_streams()>
18330
18331 =back
18332
18333 =over 4
18334
18335 =item B<top_stream()>
18336
18337 =back
18338
18339 =over 4
18340
18341 =item PRIVATE METHODS AND DATA
18342
18343 =back
18344
18345 =over 4
18346
18347 =item B<_push_input_stream()>
18348
18349 =back
18350
18351 =over 4
18352
18353 =item B<_pop_input_stream()>
18354
18355 =back
18356
18357 =over 4
18358
18359 =item TREE-BASED PARSING
18360
18361 =item SEE ALSO
18362
18363 =item AUTHOR
18364
18365 =back
18366
18367 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18368
18369 =over 4
18370
18371 =item SYNOPSIS
18372
18373 =item DESCRIPTION
18374
18375 =item SEE ALSO
18376
18377 =item COPYRIGHT AND DISCLAIMERS
18378
18379 =item AUTHOR
18380
18381 =back
18382
18383 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18384
18385 =over 4
18386
18387 =item SYNOPSIS
18388
18389 =item DESCRIPTION
18390
18391 =item CAVEAT
18392
18393 =item SEE ALSO
18394
18395 =item COPYRIGHT AND DISCLAIMERS
18396
18397 =item AUTHOR
18398
18399 =back
18400
18401 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18402
18403 =over 4
18404
18405 =item SYNOPSIS
18406
18407 =item DESCRIPTION
18408
18409 =item CAVEAT
18410
18411 =item SEE ALSO
18412
18413 =item COPYRIGHT AND DISCLAIMERS
18414
18415 =item AUTHOR
18416
18417 =back
18418
18419 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18420
18421 =over 4
18422
18423 =item SYNOPSIS
18424
18425 =item DESCRIPTION
18426
18427 =item SEE ALSO
18428
18429 =item COPYRIGHT AND DISCLAIMERS
18430
18431 =item AUTHOR
18432
18433 =back
18434
18435 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18436
18437 =over 4
18438
18439 =item SYNOPSIS
18440
18441 =item DESCRIPTION
18442
18443 =item SEE ALSO
18444
18445 =item COPYRIGHT AND DISCLAIMERS
18446
18447 =item AUTHOR
18448
18449 =back
18450
18451 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18452
18453 =over 4
18454
18455 =item SYNOPSIS
18456
18457 =item DESCRIPTION
18458
18459 =item CAVEAT
18460
18461 =item SEE ALSO
18462
18463 =item COPYRIGHT AND DISCLAIMERS
18464
18465 =item AUTHOR
18466
18467 =back
18468
18469 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18470
18471 =over 4
18472
18473 =item SYNOPSIS
18474
18475 =item DESCRIPTION
18476
18477 =item SEE ALSO
18478
18479 =item AUTHOR
18480
18481 =back
18482
18483 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18484
18485 =over 4
18486
18487 =item SYNOPSIS
18488
18489 =item DESCRIPTION
18490
18491 =item SEE ALSO
18492
18493 =item COPYRIGHT AND DISCLAIMERS
18494
18495 =item AUTHOR
18496
18497 =back
18498
18499 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18500
18501 =over 4
18502
18503 =item SYNOPSIS
18504
18505 =item DESCRIPTION
18506
18507 alt, indent, loose, sentence, width
18508
18509 =item DIAGNOSTICS
18510
18511 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18512 Unknown sequence: %s, Unmatched =back
18513
18514 =item RESTRICTIONS
18515
18516 =item NOTES
18517
18518 =item SEE ALSO
18519
18520 =item AUTHOR
18521
18522 =back
18523
18524 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18525
18526 =over 4
18527
18528 =item SYNOPSIS
18529
18530 =item DESCRIPTION
18531
18532 =over 4
18533
18534 =item EXPORT
18535
18536 =back
18537
18538 =item AUTHOR
18539
18540 =item SEE ALSO
18541
18542 =back
18543
18544 =head2 Pod::Select, podselect() - extract selected sections of POD from
18545 input
18546
18547 =over 4
18548
18549 =item SYNOPSIS
18550
18551 =item REQUIRES
18552
18553 =item EXPORTS
18554
18555 =item DESCRIPTION
18556
18557 =item SECTION SPECIFICATIONS
18558
18559 =item RANGE SPECIFICATIONS
18560
18561 =back
18562
18563 =over 4
18564
18565 =item OBJECT METHODS
18566
18567 =back
18568
18569 =over 4
18570
18571 =item B<curr_headings()>
18572
18573 =back
18574
18575 =over 4
18576
18577 =item B<select()>
18578
18579 =back
18580
18581 =over 4
18582
18583 =item B<add_selection()>
18584
18585 =back
18586
18587 =over 4
18588
18589 =item B<clear_selections()>
18590
18591 =back
18592
18593 =over 4
18594
18595 =item B<match_section()>
18596
18597 =back
18598
18599 =over 4
18600
18601 =item B<is_selected()>
18602
18603 =back
18604
18605 =over 4
18606
18607 =item EXPORTED FUNCTIONS
18608
18609 =back
18610
18611 =over 4
18612
18613 =item B<podselect()>
18614
18615 B<-output>, B<-sections>, B<-ranges>
18616
18617 =back
18618
18619 =over 4
18620
18621 =item PRIVATE METHODS AND DATA
18622
18623 =back
18624
18625 =over 4
18626
18627 =item B<_compile_section_spec()>
18628
18629 =back
18630
18631 =over 4
18632
18633 =item $self->{_SECTION_HEADINGS}
18634
18635 =back
18636
18637 =over 4
18638
18639 =item $self->{_SELECTED_SECTIONS}
18640
18641 =back
18642
18643 =over 4
18644
18645 =item SEE ALSO
18646
18647 =item AUTHOR
18648
18649 =back
18650
18651 =head2 Pod::Text - Convert POD data to formatted ASCII text
18652
18653 =over 4
18654
18655 =item SYNOPSIS
18656
18657 =item DESCRIPTION
18658
18659 alt, code, indent, loose, margin, quotes, sentence, width
18660
18661 =item DIAGNOSTICS
18662
18663 Bizarre space in item, Item called without tag, Can't open %s for reading:
18664 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
18665 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
18666 Unmatched =back
18667
18668 =item RESTRICTIONS
18669
18670 =item NOTES
18671
18672 =item SEE ALSO
18673
18674 =item AUTHOR
18675
18676 =item COPYRIGHT AND LICENSE
18677
18678 =back
18679
18680 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
18681
18682 =over 4
18683
18684 =item SYNOPSIS
18685
18686 =item DESCRIPTION
18687
18688 =item BUGS
18689
18690 =item SEE ALSO
18691
18692 =item AUTHOR
18693
18694 =item COPYRIGHT AND LICENSE
18695
18696 =back
18697
18698 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
18699 text
18700
18701 =over 4
18702
18703 =item SYNOPSIS
18704
18705 =item DESCRIPTION
18706
18707 =item BUGS
18708
18709 =item SEE ALSO
18710
18711 =item AUTHOR
18712
18713 =item COPYRIGHT AND LICENSE
18714
18715 =back
18716
18717 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
18718 escapes
18719
18720 =over 4
18721
18722 =item SYNOPSIS
18723
18724 =item DESCRIPTION
18725
18726 =item NOTES
18727
18728 =item SEE ALSO
18729
18730 =item AUTHOR
18731
18732 =item COPYRIGHT AND LICENSE
18733
18734 =back
18735
18736 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
18737 documentation
18738
18739 =over 4
18740
18741 =item SYNOPSIS
18742
18743 =item ARGUMENTS
18744
18745 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
18746 C<-pathlist>
18747
18748 =item DESCRIPTION
18749
18750 =item EXAMPLES
18751
18752 =over 4
18753
18754 =item Recommended Use
18755
18756 =back
18757
18758 =item CAVEATS
18759
18760 =item AUTHOR
18761
18762 =item ACKNOWLEDGEMENTS
18763
18764 =back
18765
18766 =head2 SDBM_File - Tied access to sdbm files
18767
18768 =over 4
18769
18770 =item SYNOPSIS
18771
18772 =item DESCRIPTION
18773
18774 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18775
18776 =item DIAGNOSTICS
18777
18778 =over 4
18779
18780 =item C<sdbm store returned -1, errno 22, key "..." at ...>
18781
18782 =back
18783
18784 =item BUGS AND WARNINGS
18785
18786 =back
18787
18788 =head2 Safe - Compile and execute code in restricted compartments
18789
18790 =over 4
18791
18792 =item SYNOPSIS
18793
18794 =item DESCRIPTION
18795
18796 a new namespace, an operator mask
18797
18798 =item WARNING
18799
18800 =over 4
18801
18802 =item RECENT CHANGES
18803
18804 =item Methods in class Safe
18805
18806 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18807 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18808 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18809 root (NAMESPACE), mask (MASK)
18810
18811 =item Some Safety Issues
18812
18813 Memory, CPU, Snooping, Signals, State Changes
18814
18815 =item AUTHOR
18816
18817 =back
18818
18819 =back
18820
18821 =head2 Scalar::Util - A selection of general-utility scalar subroutines
18822
18823 =over 4
18824
18825 =item SYNOPSIS
18826
18827 =item DESCRIPTION
18828
18829 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
18830 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
18831 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
18832
18833 =item KNOWN BUGS
18834
18835 =item COPYRIGHT
18836
18837 =item BLATANT PLUG
18838
18839 =back
18840
18841 =head2 Search::Dict, look - search for key in dictionary file
18842
18843 =over 4
18844
18845 =item SYNOPSIS
18846
18847 =item DESCRIPTION
18848
18849 =back
18850
18851 =head2 SelectSaver - save and restore selected file handle
18852
18853 =over 4
18854
18855 =item SYNOPSIS
18856
18857 =item DESCRIPTION
18858
18859 =back
18860
18861 =head2 SelfLoader - load functions only on demand
18862
18863 =over 4
18864
18865 =item SYNOPSIS
18866
18867 =item DESCRIPTION
18868
18869 =over 4
18870
18871 =item The __DATA__ token
18872
18873 =item SelfLoader autoloading
18874
18875 =item Autoloading and package lexicals
18876
18877 =item SelfLoader and AutoLoader
18878
18879 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
18880
18881 =item Classes and inherited methods.
18882
18883 =back
18884
18885 =item Multiple packages and fully qualified subroutine names
18886
18887 =back
18888
18889 =head2 Shell - run shell commands transparently within perl
18890
18891 =over 4
18892
18893 =item SYNOPSIS
18894
18895 =item DESCRIPTION
18896
18897 =over 4
18898
18899 =item OBJECT ORIENTED SYNTAX
18900
18901 =back
18902
18903 =item AUTHOR
18904
18905 =back
18906
18907 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
18908 socket.h defines and structure manipulators
18909
18910 =over 4
18911
18912 =item SYNOPSIS
18913
18914 =item DESCRIPTION
18915
18916 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
18917 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
18918 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
18919 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
18920 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
18921
18922 =back
18923
18924 =head2 Storable - persistence for Perl data structures
18925
18926 =over 4
18927
18928 =item SYNOPSIS
18929
18930 =item DESCRIPTION
18931
18932 =item MEMORY STORE
18933
18934 =item ADVISORY LOCKING
18935
18936 =item SPEED
18937
18938 =item CANONICAL REPRESENTATION
18939
18940 =item CODE REFERENCES
18941
18942 =item FORWARD COMPATIBILITY
18943
18944 utf8 data, restricted hashes, files from future versions of Storable
18945
18946 =item ERROR REPORTING
18947
18948 =item WIZARDS ONLY
18949
18950 =over 4
18951
18952 =item Hooks
18953
18954 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18955 I<serialized>, ..
18956
18957 =item Predicates
18958
18959 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18960 C<Storable::is_retrieving>
18961
18962 =item Recursion
18963
18964 =item Deep Cloning
18965
18966 =back
18967
18968 =item Storable magic
18969
18970 =item EXAMPLES
18971
18972 =item WARNING
18973
18974 =item BUGS
18975
18976 =over 4
18977
18978 =item 64 bit data in perl 5.6.0 and 5.6.1
18979
18980 =back
18981
18982 =item CREDITS
18983
18984 =item AUTHOR
18985
18986 =item SEE ALSO
18987
18988 =back
18989
18990 =head2 Switch - A switch statement for Perl
18991
18992 =over 4
18993
18994 =item VERSION
18995
18996 =item SYNOPSIS
18997
18998 =item BACKGROUND
18999
19000 =item DESCRIPTION
19001
19002 =over 4
19003
19004 =item Allowing fall-through
19005
19006 =item Automating fall-through
19007
19008 =item Alternative syntax
19009
19010 =item Higher-order Operations
19011
19012 =back
19013
19014 =item DEPENDENCIES
19015
19016 =item AUTHOR
19017
19018 =item BUGS
19019
19020 =item LIMITATION
19021
19022 =item COPYRIGHT
19023
19024 =back
19025
19026 =head2 Symbol - manipulate Perl symbols and their names
19027
19028 =over 4
19029
19030 =item SYNOPSIS
19031
19032 =item DESCRIPTION
19033
19034 =back
19035
19036 =head2 Sys::Hostname - Try every conceivable way to get hostname
19037
19038 =over 4
19039
19040 =item SYNOPSIS
19041
19042 =item DESCRIPTION
19043
19044 =item AUTHOR
19045
19046 =back
19047
19048 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19049 interface to the UNIX syslog(3) calls
19050
19051 =over 4
19052
19053 =item SYNOPSIS
19054
19055 =item DESCRIPTION
19056
19057 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19058 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19059 in 5.004_02), closelog
19060
19061 =item EXAMPLES
19062
19063 =item SEE ALSO
19064
19065 =item AUTHOR
19066
19067 =back
19068
19069 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19070 Perl interface to the UNIX syslog(3) calls
19071
19072 =over 4
19073
19074 =item SYNOPSIS
19075
19076 =item DESCRIPTION
19077
19078 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19079 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19080 in 5.004_02), closelog
19081
19082 =item EXAMPLES
19083
19084 =item SEE ALSO
19085
19086 =item AUTHOR
19087
19088 =back
19089
19090 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19091
19092 =over 4
19093
19094 =item SYNOPSIS
19095
19096 =item DESCRIPTION
19097
19098 =item DIAGNOSTICS
19099
19100 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19101 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19102 comma allowed after filehandle, No name for escape sequence %s
19103
19104 =item ENVIRONMENT
19105
19106 ANSI_COLORS_DISABLED
19107
19108 =item RESTRICTIONS
19109
19110 =item NOTES
19111
19112 =item SEE ALSO
19113
19114 =item AUTHORS
19115
19116 =item COPYRIGHT AND LICENSE
19117
19118 =back
19119
19120 =head2 Term::Cap - Perl termcap interface
19121
19122 =over 4
19123
19124 =item SYNOPSIS
19125
19126 =item DESCRIPTION
19127
19128 =over 4
19129
19130 =item METHODS
19131
19132 =back
19133
19134 =back
19135
19136 B<Tgetent>, OSPEED, TERM
19137
19138 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19139
19140 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19141
19142 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19143
19144 B<Trequire>
19145
19146 =over 4
19147
19148 =item EXAMPLES
19149
19150 =item COPYRIGHT AND LICENSE
19151
19152 =item AUTHOR
19153
19154 =item SEE ALSO
19155
19156 =back
19157
19158 =head2 Term::Complete - Perl word completion module
19159
19160 =over 4
19161
19162 =item SYNOPSIS
19163
19164 =item DESCRIPTION
19165
19166 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19167
19168 =item DIAGNOSTICS
19169
19170 =item BUGS
19171
19172 =item AUTHOR
19173
19174 =back
19175
19176 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19177 If no real package is found, substitutes stubs instead of basic functions.
19178
19179 =over 4
19180
19181 =item SYNOPSIS
19182
19183 =item DESCRIPTION
19184
19185 =item Minimal set of supported functions
19186
19187 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19188 C<findConsole>, Attribs, C<Features>
19189
19190 =item Additional supported functions
19191
19192 C<tkRunning>, C<ornaments>, C<newTTY>
19193
19194 =item EXPORTS
19195
19196 =item ENVIRONMENT
19197
19198 =item CAVEATS
19199
19200 =back
19201
19202 =head2 Test - provides a simple framework for writing test scripts
19203
19204 =over 4
19205
19206 =item SYNOPSIS
19207
19208 =item DESCRIPTION
19209
19210 =item QUICK START GUIDE
19211
19212 =over 4
19213
19214 =item Functions
19215
19216 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19217 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19218
19219 =back
19220
19221 =back
19222
19223 B<_to_value>
19224
19225 C<ok(...)>
19226
19227 C<skip(I<skip_if_true>, I<args...>)>
19228
19229 =over 4
19230
19231 =item TEST TYPES
19232
19233 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19234
19235 =item ONFAIL
19236
19237 =item BUGS and CAVEATS
19238
19239 =item NOTE
19240
19241 =item SEE ALSO
19242
19243 =item AUTHOR
19244
19245 =back
19246
19247 =head2 Test::Builder - Backend for building test libraries
19248
19249 =over 4
19250
19251 =item SYNOPSIS
19252
19253 =item DESCRIPTION
19254
19255 =over 4
19256
19257 =item Construction
19258
19259 B<new>
19260
19261 =back
19262
19263 =back
19264
19265 =over 4
19266
19267 =item Setting up tests
19268
19269 B<exported_to>
19270
19271 =back
19272
19273 B<plan>
19274
19275 B<expected_tests>
19276
19277 B<no_plan>
19278
19279 B<has_plan>
19280
19281 B<skip_all>
19282
19283 =over 4
19284
19285 =item Running tests
19286
19287 B<ok>
19288
19289 =back
19290
19291 B<is_eq>, B<is_num>
19292
19293 B<isnt_eq>, B<isnt_num>
19294
19295 B<like>, B<unlike>
19296
19297 B<maybe_regex>
19298
19299 B<cmp_ok>
19300
19301 B<BAILOUT>
19302
19303 B<skip>
19304
19305 B<todo_skip>
19306
19307 B<skip_rest>
19308
19309 =over 4
19310
19311 =item Test style
19312
19313 B<level>
19314
19315 =back
19316
19317 B<use_numbers>
19318
19319 B<no_header>, B<no_ending>
19320
19321 =over 4
19322
19323 =item Output
19324
19325 B<diag>
19326
19327 =back
19328
19329 B<_print>
19330
19331 B<output>, B<failure_output>, B<todo_output>
19332
19333 =over 4
19334
19335 =item Test Status and Info
19336
19337 B<current_test>
19338
19339 =back
19340
19341 B<summary>
19342
19343 B<details>
19344
19345 B<todo>
19346
19347 B<caller>
19348
19349 B<_sanity_check>
19350
19351 B<_whoa>
19352
19353 B<_my_exit>
19354
19355 =over 4
19356
19357 =item THREADS
19358
19359 =item EXAMPLES
19360
19361 =item SEE ALSO
19362
19363 =item AUTHORS
19364
19365 =item COPYRIGHT
19366
19367 =back
19368
19369 =head2 Test::Harness - run perl standard test scripts with statistics
19370
19371 =over 4
19372
19373 =item SYNOPSIS
19374
19375 =item DESCRIPTION
19376
19377 =over 4
19378
19379 =item The test script output
19380
19381 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19382 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19383 else>
19384
19385 =item Taint mode
19386
19387 =item Configuration variables.
19388
19389 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19390
19391 =item Failure
19392
19393 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19394 Failed>
19395
19396 =item Functions
19397
19398 B<runtests>
19399
19400 =back
19401
19402 =back
19403
19404 B<_all_ok>
19405
19406 B<_globdir>
19407
19408 B<_run_all_tests>
19409
19410 B<_mk_leader>
19411
19412 B<_leader_width>
19413
19414 =over 4
19415
19416 =item EXPORT
19417
19418 =item DIAGNOSTICS
19419
19420 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19421 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19422 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19423 %s>, C<FAILED--Further testing stopped: %s>
19424
19425 =item ENVIRONMENT
19426
19427 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19428 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19429 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19430
19431 =item EXAMPLE
19432
19433 =item SEE ALSO
19434
19435 =item AUTHORS
19436
19437 =item LICENSE
19438
19439 =item TODO
19440
19441 =item BUGS
19442
19443 =back
19444
19445 =head2 Test::Harness::Assert - simple assert
19446
19447 =over 4
19448
19449 =item SYNOPSIS
19450
19451 =item DESCRIPTION
19452
19453 =over 4
19454
19455 =item Functions
19456
19457 B<assert>
19458
19459 =back
19460
19461 =back
19462
19463 =over 4
19464
19465 =item AUTHOR
19466
19467 =item SEE ALSO
19468
19469 =back
19470
19471 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19472
19473 =over 4
19474
19475 =item SYNOPSIS
19476
19477 =item DESCRIPTION
19478
19479 =back
19480
19481 =head2 Test::Harness::Straps - detailed analysis of test results
19482
19483 =over 4
19484
19485 =item SYNOPSIS
19486
19487 =item DESCRIPTION
19488
19489 =over 4
19490
19491 =item Construction
19492
19493 B<new>
19494
19495 =back
19496
19497 =back
19498
19499 B<_init>
19500
19501 =over 4
19502
19503 =item Analysis
19504
19505 B<analyze>
19506
19507 =back
19508
19509 B<analyze_fh>
19510
19511 B<analyze_file>
19512
19513 B<_switches>
19514
19515 B<_INC2PERL5LIB>
19516
19517 B<_filtered_INC>
19518
19519 B<_restore_PERL5LIB>
19520
19521 =over 4
19522
19523 =item Parsing
19524
19525 B<_is_comment>
19526
19527 =back
19528
19529 B<_is_header>
19530
19531 B<_is_test>
19532
19533 B<_is_bail_out>
19534
19535 B<_reset_file_state>
19536
19537 =over 4
19538
19539 =item Results
19540
19541 B<_detailize>
19542
19543 =back
19544
19545 =over 4
19546
19547 =item EXAMPLES
19548
19549 =item AUTHOR
19550
19551 =item SEE ALSO
19552
19553 =back
19554
19555 =head2 Test::More - yet another framework for writing test scripts
19556
19557 =over 4
19558
19559 =item SYNOPSIS
19560
19561 =item DESCRIPTION
19562
19563 =over 4
19564
19565 =item I love it when a plan comes together
19566
19567 =back
19568
19569 =back
19570
19571 =over 4
19572
19573 =item Test names
19574
19575 =item I'm ok, you're not ok.
19576
19577 B<ok>
19578
19579 =back
19580
19581 B<is>, B<isnt>
19582
19583 B<like>
19584
19585 B<unlike>
19586
19587 B<cmp_ok>
19588
19589 B<can_ok>
19590
19591 B<isa_ok>
19592
19593 B<pass>, B<fail>
19594
19595 =over 4
19596
19597 =item Diagnostics
19598
19599 B<diag>
19600
19601 =back
19602
19603 =over 4
19604
19605 =item Module tests
19606
19607 B<use_ok>
19608
19609 =back
19610
19611 B<require_ok>
19612
19613 =over 4
19614
19615 =item Conditional tests
19616
19617 B<SKIP: BLOCK>
19618
19619 =back
19620
19621 B<TODO: BLOCK>, B<todo_skip>
19622
19623 When do I use SKIP vs. TODO?
19624
19625 =over 4
19626
19627 =item Comparison functions
19628
19629 B<is_deeply>
19630
19631 =back
19632
19633 B<eq_array>
19634
19635 B<eq_hash>
19636
19637 B<eq_set>
19638
19639 =over 4
19640
19641 =item Extending and Embedding Test::More
19642
19643 B<builder>
19644
19645 =back
19646
19647 =over 4
19648
19649 =item NOTES
19650
19651 =item BUGS and CAVEATS
19652
19653 Making your own ok(), The eq_* family has some caveats, Test::Harness
19654 upgrades
19655
19656 =item HISTORY
19657
19658 =item SEE ALSO
19659
19660 =item AUTHORS
19661
19662 =item COPYRIGHT
19663
19664 =back
19665
19666 =head2 Test::Simple - Basic utilities for writing tests.
19667
19668 =over 4
19669
19670 =item SYNOPSIS
19671
19672 =item DESCRIPTION
19673
19674 B<ok>
19675
19676 =back
19677
19678 =over 4
19679
19680 =item EXAMPLE
19681
19682 =item CAVEATS
19683
19684 =item NOTES
19685
19686 =item HISTORY
19687
19688 =item SEE ALSO
19689
19690 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
19691 L<Test::Harness>
19692
19693 =item AUTHORS
19694
19695 =item COPYRIGHT
19696
19697 =back
19698
19699 =head2 Test::Tutorial - A tutorial about writing really basic tests
19700
19701 =over 4
19702
19703 =item DESCRIPTION
19704
19705 =over 4
19706
19707 =item Nuts and bolts of testing.
19708
19709 =item Where to start?
19710
19711 =item Names
19712
19713 =item Test the manual
19714
19715 =item Sometimes the tests are wrong
19716
19717 =item Testing lots of values
19718
19719 =item Informative names
19720
19721 =item Skipping tests
19722
19723 =item Todo tests
19724
19725 =item Testing with taint mode.
19726
19727 =back
19728
19729 =item FOOTNOTES
19730
19731 =item AUTHORS
19732
19733 =item COPYRIGHT
19734
19735 =back
19736
19737 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
19738
19739 =over 4
19740
19741 =item SYNOPSIS
19742
19743 =item DESCRIPTION
19744
19745 =item EXAMPLE
19746
19747 =back
19748
19749 =head2 Text::Balanced - Extract delimited text sequences from strings.
19750
19751 =over 4
19752
19753 =item SYNOPSIS
19754
19755 =item DESCRIPTION
19756
19757 =over 4
19758
19759 =item General behaviour in list contexts
19760
19761 [0], [1], [2]
19762
19763 =item General behaviour in scalar and void contexts
19764
19765 =item A note about prefixes
19766
19767 =item C<extract_delimited>
19768
19769 =item C<extract_bracketed>
19770
19771 =item C<extract_tagged>
19772
19773 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
19774 [0], [1], [2], [3], [4], [5]
19775
19776 =item C<gen_extract_tagged>
19777
19778 =item C<extract_quotelike>
19779
19780 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
19781
19782 =item C<extract_quotelike> and "here documents"
19783
19784 [0], [1], [2], [3], [4], [5], [6], [7..10]
19785
19786 =item C<extract_codeblock>
19787
19788 =item C<extract_multiple>
19789
19790 =item C<gen_delimited_pat>
19791
19792 =back
19793
19794 =item DIAGNOSTICS
19795
19796  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
19797 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
19798 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
19799 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
19800 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
19801 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
19802 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
19803 after dereferencer>, C<Did not find expected opening bracket at %s>,
19804 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
19805 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
19806 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
19807 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
19808 tag>
19809
19810 =item AUTHOR
19811
19812 =item BUGS AND IRRITATIONS
19813
19814 =item COPYRIGHT
19815
19816 =back
19817
19818 =head2 Text::ParseWords - parse text into an array of tokens or array of
19819 arrays
19820
19821 =over 4
19822
19823 =item SYNOPSIS
19824
19825 =item DESCRIPTION
19826
19827 =item EXAMPLES
19828
19829 =item AUTHORS
19830
19831 =back
19832
19833 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
19834 by Knuth
19835
19836 =over 4
19837
19838 =item SYNOPSIS
19839
19840 =item DESCRIPTION
19841
19842 =item EXAMPLES
19843
19844 =item LIMITATIONS
19845
19846 =item AUTHOR
19847
19848 =back
19849
19850 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
19851 unexpand(1)
19852
19853 =over 4
19854
19855 =item SYNOPSIS
19856
19857 =item DESCRIPTION
19858
19859 =item BUGS
19860
19861 =item AUTHOR
19862
19863 =back
19864
19865 =head2 Text::Wrap - line wrapping to form simple paragraphs
19866
19867 =over 4
19868
19869 =item SYNOPSIS
19870
19871 =item DESCRIPTION
19872
19873 =item OVERRIDES
19874
19875 =item EXAMPLE
19876
19877 =item AUTHOR
19878
19879 =back
19880
19881 =head2 Thread - manipulate threads in Perl (for old code only)
19882
19883 =over 4
19884
19885 =item CAVEAT
19886
19887 =item SYNOPSIS
19888
19889 =item DESCRIPTION
19890
19891 =item FUNCTIONS
19892
19893 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
19894 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
19895 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
19896
19897 =item METHODS
19898
19899 join, eval, detach, equal, tid, flags, done
19900
19901 =item LIMITATIONS
19902
19903 =item SEE ALSO
19904
19905 =back
19906
19907 =head2 Thread::Queue - thread-safe queues
19908
19909 =over 4
19910
19911 =item SYNOPSIS
19912
19913 =item DESCRIPTION
19914
19915 =item FUNCTIONS AND METHODS
19916
19917 new, enqueue LIST, dequeue, dequeue_nb, pending
19918
19919 =item SEE ALSO
19920
19921 =back
19922
19923 =head2 Thread::Semaphore - thread-safe semaphores
19924
19925 =over 4
19926
19927 =item SYNOPSIS
19928
19929 =item DESCRIPTION
19930
19931 =item FUNCTIONS AND METHODS
19932
19933 new, new NUMBER, down, down NUMBER, up, up NUMBER
19934
19935 =back
19936
19937 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
19938 (for old code)
19939
19940 =over 4
19941
19942 =item CAVEAT
19943
19944 =item SYNOPSIS
19945
19946 =item DESCRIPTION
19947
19948 =item BUGS
19949
19950 =back
19951
19952 =head2 Thread::Specific - thread-specific keys
19953
19954 =over 4
19955
19956 =item SYNOPSIS
19957
19958 =item DESCRIPTION
19959
19960 =back
19961
19962 =head2 Tie::Array - base class for tied arrays
19963
19964 =over 4
19965
19966 =item SYNOPSIS
19967
19968 =item DESCRIPTION
19969
19970 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19971 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19972 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19973 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19974
19975 =item CAVEATS
19976
19977 =item AUTHOR
19978
19979 =back
19980
19981 =head2 Tie::File - Access the lines of a disk file via a Perl array
19982
19983 =over 4
19984
19985 =item SYNOPSIS
19986
19987 =item DESCRIPTION
19988
19989 =over 4
19990
19991 =item C<recsep>
19992
19993 =item C<autochomp>
19994
19995 =item C<mode>
19996
19997 =item C<memory>
19998
19999 =item C<dw_size>
20000
20001 =item Option Format
20002
20003 =back
20004
20005 =item Public Methods
20006
20007 =over 4
20008
20009 =item C<flock>
20010
20011 =item C<autochomp>
20012
20013 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20014
20015 =item C<offset>
20016
20017 =back
20018
20019 =item Tying to an already-opened filehandle
20020
20021 =item Deferred Writing
20022
20023 =over 4
20024
20025 =item Autodeferring
20026
20027 =back
20028
20029 =item CONCURRENT ACCESS TO FILES
20030
20031 =item CAVEATS
20032
20033 =item SUBCLASSING
20034
20035 =item WHAT ABOUT C<DB_File>?
20036
20037 =item AUTHOR
20038
20039 =item LICENSE
20040
20041 =item WARRANTY
20042
20043 =item THANKS
20044
20045 =item TODO
20046
20047 =back
20048
20049 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20050 handles
20051
20052 =over 4
20053
20054 =item SYNOPSIS
20055
20056 =item DESCRIPTION
20057
20058 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20059 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20060 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20061 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20062
20063 =item MORE INFORMATION
20064
20065 =item COMPATIBILITY
20066
20067 =back
20068
20069 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20070 tied hashes
20071
20072 =over 4
20073
20074 =item SYNOPSIS
20075
20076 =item DESCRIPTION
20077
20078 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20079 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20080
20081 =item Inheriting from B<Tie::StdHash>
20082
20083 =item Inheriting from B<Tie::ExtraHash>
20084
20085 =item C<UNTIE> and C<DESTROY>
20086
20087 =item MORE INFORMATION
20088
20089 =back
20090
20091 =head2 Tie::Memoize - add data to hash when needed
20092
20093 =over 4
20094
20095 =item SYNOPSIS
20096
20097 =item DESCRIPTION
20098
20099 =item Inheriting from B<Tie::Memoize>
20100
20101 =item EXAMPLE
20102
20103 =item BUGS
20104
20105 =item AUTHOR
20106
20107 =back
20108
20109 =head2 Tie::RefHash - use references as hash keys
20110
20111 =over 4
20112
20113 =item SYNOPSIS
20114
20115 =item DESCRIPTION
20116
20117 =item EXAMPLE
20118
20119 =item AUTHOR
20120
20121 =item VERSION
20122
20123 =item SEE ALSO
20124
20125 =back
20126
20127 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20128 scalars
20129
20130 =over 4
20131
20132 =item SYNOPSIS
20133
20134 =item DESCRIPTION
20135
20136 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20137
20138 =item MORE INFORMATION
20139
20140 =back
20141
20142 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20143
20144 =over 4
20145
20146 =item SYNOPSIS
20147
20148 =item DESCRIPTION
20149
20150 =item CAVEATS
20151
20152 =back
20153
20154 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20155 timers
20156
20157 =over 4
20158
20159 =item SYNOPSIS
20160
20161 =item DESCRIPTION
20162
20163 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20164 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20165 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
20166 getitimer ( $which )
20167
20168 =item EXAMPLES
20169
20170 =item C API
20171
20172 =item DIAGNOSTICS
20173
20174 =over 4
20175
20176 =item negative time not invented yet
20177
20178 =item internal error: useconds < 0 (unsigned ... signed ...)
20179
20180 =back
20181
20182 =item CAVEATS
20183
20184 =item AUTHORS
20185
20186 =item COPYRIGHT AND LICENSE
20187
20188 =back
20189
20190 =head2 Time::Local - efficiently compute time from local and GMT time
20191
20192 =over 4
20193
20194 =item SYNOPSIS
20195
20196 =item DESCRIPTION
20197
20198 =item IMPLEMENTATION
20199
20200 =item BUGS
20201
20202 =back
20203
20204 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20205 function
20206
20207 =over 4
20208
20209 =item SYNOPSIS
20210
20211 =item DESCRIPTION
20212
20213 =item NOTE
20214
20215 =item AUTHOR
20216
20217 =back
20218
20219 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20220 function
20221
20222 =over 4
20223
20224 =item SYNOPSIS
20225
20226 =item DESCRIPTION
20227
20228 =item NOTE
20229
20230 =item AUTHOR
20231
20232 =back
20233
20234 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20235
20236 =over 4
20237
20238 =item SYNOPSIS
20239
20240 =item DESCRIPTION
20241
20242 =item AUTHOR
20243
20244 =back
20245
20246 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20247
20248 =over 4
20249
20250 =item SYNOPSIS
20251
20252 =item DESCRIPTION
20253
20254 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20255 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20256 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20257
20258 =item EXPORTS
20259
20260 =back
20261
20262 =head2 Unicode::Collate - Unicode Collation Algorithm
20263
20264 =over 4
20265
20266 =item SYNOPSIS
20267
20268 =item DESCRIPTION
20269
20270 =over 4
20271
20272 =item Constructor and Tailoring
20273
20274 UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
20275 normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
20276 undefName, undefChar, katakana_before_hiragana, upper_before_lower
20277
20278 =item Methods for Collation
20279
20280 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20281 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20282 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20283 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20284 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20285 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20286 $Collator-E<gt>viewSortKey($string)>
20287
20288 =item Methods for Searching
20289
20290 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20291 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20292 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20293 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20294 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20295 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20296 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20297
20298 =item Other Methods
20299
20300 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
20301 Base_Unicode_Version
20302
20303 =item EXPORT
20304
20305 =item TODO
20306
20307 =item CAVEAT
20308
20309 =item Conformance Test
20310
20311 =back
20312
20313 =item AUTHOR
20314
20315 =item SEE ALSO
20316
20317 http://www.unicode.org/reports/tr10/,
20318 http://www.unicode.org/reports/tr10/allkeys.txt,
20319 http://www.unicode.org/reports/tr10/CollationTest.html
20320 http://www.unicode.org/reports/tr10/CollationTest.zip,
20321 http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
20322
20323 =back
20324
20325 =head2 Unicode::Normalize - Unicode Normalization Forms
20326
20327 =over 4
20328
20329 =item SYNOPSIS
20330
20331 =item DESCRIPTION
20332
20333 =over 4
20334
20335 =item Normalization Forms
20336
20337 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20338 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20339 C<$normalized_string = normalize($form_name, $string)>
20340
20341 =item Decomposition and Composition
20342
20343 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20344 decompose($string, $useCompatMapping)>, C<$reordered_string  =
20345 reorder($string)>, C<$composed_string   = compose($string)>
20346
20347 =item Quick Check
20348
20349 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20350 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20351 check($form_name, $string)>
20352
20353 =item Character Data
20354
20355 C<$canonical_decomposed = getCanon($codepoint)>,
20356 C<$compatibility_decomposed = getCompat($codepoint)>,
20357 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20358 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20359 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20360 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20361 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20362
20363 =item EXPORT
20364
20365 =back
20366
20367 =item AUTHOR
20368
20369 =item SEE ALSO
20370
20371 http://www.unicode.org/unicode/reports/tr15/,
20372 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
20373
20374 =back
20375
20376 =head2 Unicode::UCD - Unicode character database
20377
20378 =over 4
20379
20380 =item SYNOPSIS
20381
20382 =item DESCRIPTION
20383
20384 =back
20385
20386 =over 4
20387
20388 =item charinfo
20389
20390 =back
20391
20392 =over 4
20393
20394 =item charblock
20395
20396 =back
20397
20398 =over 4
20399
20400 =item charscript
20401
20402 =back
20403
20404 =over 4
20405
20406 =item charblocks
20407
20408 =back
20409
20410 =over 4
20411
20412 =item charscripts
20413
20414 =back
20415
20416 =over 4
20417
20418 =item Blocks versus Scripts
20419
20420 =item Matching Scripts and Blocks
20421
20422 =item Code Point Arguments
20423
20424 =item charinrange
20425
20426 =back
20427
20428 =over 4
20429
20430 =item compexcl
20431
20432 =back
20433
20434 =over 4
20435
20436 =item casefold
20437
20438 =back
20439
20440 =over 4
20441
20442 =item casespec
20443
20444 =back
20445
20446 =over 4
20447
20448 =item Unicode::UCD::UnicodeVersion
20449
20450 =back
20451
20452 =over 4
20453
20454 =item Implementation Note
20455
20456 =back
20457
20458 =over 4
20459
20460 =item BUGS
20461
20462 =item AUTHOR
20463
20464 =back
20465
20466 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20467 functions
20468
20469 =over 4
20470
20471 =item SYNOPSIS
20472
20473 =item DESCRIPTION
20474
20475 =item NOTE
20476
20477 =item AUTHOR
20478
20479 =back
20480
20481 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20482 functions
20483
20484 =over 4
20485
20486 =item SYNOPSIS
20487
20488 =item DESCRIPTION
20489
20490 =over 4
20491
20492 =item System Specifics
20493
20494 =back
20495
20496 =item NOTE
20497
20498 =item AUTHOR
20499
20500 =item HISTORY
20501
20502 March 18th, 2000
20503
20504 =back
20505
20506 =head2 Win32 - Interfaces to some Win32 API Functions
20507
20508 =over 4
20509
20510 =item DESCRIPTION
20511
20512 =over 4
20513
20514 =item Alphabetical Listing of Win32 Functions
20515
20516 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20517 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20518 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20519 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20520 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20521 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20522 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20523 Win32::GetOSVersion(), Win32::GetOSName(),
20524 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20525 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20526 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20527 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20528 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20529 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20530 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20531 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20532 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
20533 Win32::UnregisterServer(LIBRARYNAME)
20534
20535 =back
20536
20537 =back
20538
20539 =head2 XSLoader - Dynamically load C libraries into Perl code
20540
20541 =over 4
20542
20543 =item SYNOPSIS
20544
20545 =item DESCRIPTION
20546
20547 =item AUTHOR
20548
20549 =back
20550
20551 =head1 AUXILIARY DOCUMENTATION
20552
20553 Here should be listed all the extra programs' documentation, but they
20554 don't all have manual pages yet:
20555
20556 =over 4
20557
20558 =item a2p
20559
20560 =item s2p
20561
20562 =item find2perl
20563
20564 =item h2ph
20565
20566 =item c2ph
20567
20568 =item h2xs
20569
20570 =item xsubpp
20571
20572 =item pod2man
20573
20574 =item wrapsuid
20575
20576 =back
20577
20578 =head1 AUTHOR
20579
20580 Larry Wall <F<larry@wall.org>>, with the help of oodles
20581 of other folks.
20582