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