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